Дрон → Сервер
Топики для передачи данных и статусов от дрона к серверу.
1. data
Телеметрия- MQTT Topic:
{DRONE_ID}_data - QoS: 1
Периодическая публикация телеметрии дрона: координаты, высота, скорость, заряд и напряжение батареи, уровень заряда, по которому действует борт, оценка остатка полётного времени, курс, статус миссии и его причина, режим полётного контроллера, флаги режимов управления и значения переменных пинов. Публикуется по таймеру (~0.7 с).
positionPositionrequiredpointPointrequiredlatfloatrequiredlongfloatrequiredheightfloatdirectionintrequiredspeedfloatbattery_levelfloatrequiredbattery_voltagefloattime_remaining_sintheadingfloatrequiredstatusstrrequiredonline— В сети, готов к работеoffline— Не в сетиon mission— Выполняет миссиюtaking off— Взлетаетlanding— Совершает посадкуreturning— Возвращается на точку стартаpaused— Миссия на паузеemergency landing— Аварийная посадкаcalibration— Идёт калибровкаflight_modestrarmedbooleanbattery_statusstrok— Заряд выше порога низкого зарядаlow— Ниже low_percent — дрон возвращается на точку стартаcritical— Ниже critical_percent — дрон садится на местеunknown— Уровень ещё не определёнstatus_reasonstroperator— Команда оператораbattery_low— Низкий зарядbattery_critical— Критический зарядfc_failsafe— Failsafe полётного контроллераcritical_disarm— Команда critical_disarmbattery_idstrmission_iduuidrequiredcommand_iduuidrequiredtrackerbooleanrequiredtracker_camerastruse_hand_modebooleanrequiredobstacle_avoidancebooleanrequiredaimobjectcarintcustomobject{
"topic": "10001_data",
"message": {
"position": {
"point": {
"lat": 55.751244,
"long": 37.618423,
"height": 50.0
},
"direction": 180.0,
"speed": 5.2
},
"battery_level": 85.0,
"battery_voltage": 15.62,
"time_remaining_s": 1450,
"heading": 180.0,
"status": "on mission",
"flight_mode": "AUTO",
"armed": true,
"battery_status": "ok",
"status_reason": null,
"battery_id": "battery_0",
"mission_id": "01939ba1-fd8a-7ed4-acb1-35791c03c70d",
"command_id": "0193909e-e71c-7b38-8ed7-ab4d7aed7e1c",
"tracker": true,
"aim": null,
"use_hand_mode": false,
"obstacle_avoidance": true,
"tracker_camera": null,
"custom": { "water_level": 6.2, "water_valve": true }
}
}
Отдельного топика для значений переменных пинов нет — они идут в общем цикле телеметрии в поле
custom. Сервер сохраняет полученный словарь целиком, заменяя прежний; сообщение без custom
прежние значения на сервере не стирает. Состав переменных задаёт
variables_config.
Автономные переходы статусов
Набор значений status не менялся, но часть значений борт выставляет сам, без команды с
платформы — по уровню заряда или по реакции полётного контроллера на аварию.
status | По команде с платформы | Автономно, решением борта |
|---|---|---|
returning | Конец маршрута, cancel_mission с BACK_TO_START | Заряд опустился ниже порога низкого заряда (по умолчанию 30 %), либо battery-failsafe полётного контроллера, настроенного без действия |
landing | Конец маршрута, cancel_mission с ON_CURRENT_PLACE, land-миссия | Заряд опустился ниже порога критического заряда (по умолчанию 15 %) — в том числе прерывая уже идущий возврат |
emergency landing | Команда critical_disarm | Любая авария, на которую полётный контроллер отреагировал сам: автономный LAND/RTL, disarm, детекция падения, потеря тяги, EKF- или GPS-failsafe |
online | — | Выставляется после посадки в любом из сценариев выше, кроме emergency landing |
emergency landing удерживается до старта следующей миссии, перезапуска борта или команды
clear_emergency; после нового взлёта сменится на taking off.
Сопутствующие события по этим сценариям:
| Ситуация | mission_cancelled | mission_completed | Другое |
|---|---|---|---|
| Возврат или посадка по заряду во время миссии | да, reason: battery_low / battery_critical | нет | status_reason: battery_low / battery_critical |
Остановка оператором (cancel_mission) | да, reason: operator | нет | status_reason: operator |
emergency landing (critical_disarm или авария полётного контроллера) | нет | нет | mission_aborted |
| Миссия отклонена на земле из-за низкого заряда | нет | нет | mission_rejected; статус остаётся online |
Причину остановки сервер берёт из поля reason в mission_cancelled.
Если борт прислал mission_cancelled строкой без причины, сервер использует последнее непустое
значение status_reason за миссию: команда оператора даёт operator, решение борта по заряду —
battery_low или battery_critical.
Пороги заряда low_percent и critical_percent борт получает от платформы в
asset_config. Значения ниже 30 и 15 борт не применяет; без
конфигурации действуют 30 и 15.
2. mission_received
Миссии- MQTT Topic:
{DRONE_ID}_mission_received - QoS: 1
Подтверждение получения миссии дроном. Подтверждает приём задания, но не гарантирует взлёт: борт
может отклонить миссию на земле из-за низкого заряда — тогда он публикует
mission_rejected, статус в data остаётся online, а события
mission_completed и mission_cancelled не приходят.
Если в течение 10 секунд после mission_received не пришли ни mission_rejected, ни
mission_completed, ни mission_cancelled, а статус дрона остался online, сервер считает, что
дрон миссию не принял, и помечает её как не начатую.
messageuuidrequired{
"topic": "10001_mission_received",
"message": "01939ba1-fd8a-7ed4-acb1-35791c03c70d"
}
3. mission_completed
Миссии- MQTT Topic:
{DRONE_ID}_mission_completed - QoS: 1
Уведомление о завершении миссии.
messageuuidrequired{
"topic": "10001_mission_completed",
"message": "01939ba1-fd8a-7ed4-acb1-35791c03c70d"
}
4. mission_cancelled
Миссии- MQTT Topic:
{DRONE_ID}_mission_cancelled - QoS: 1
Дрон прекратил выполнение миссии — по команде cancel_mission
или по решению борта. Публикуется после посадки.
mission_iduuidrequiredreasonstrrequiredoperator— Команда cancel_missionbattery_low— Заряд ниже порога низкого зарядаbattery_critical— Заряд ниже порога критического зарядаno_fly_zone— Запретную зону обойти нельзя (задание версии 2)exec_time_exceeded— Истекло время на выполнение команды (exec_time, задание версии 2)trigger— Действие триггера завершило миссию (задание версии 2)no_fly_zone_iduuidtrigger_iduuid{
"topic": "10001_mission_cancelled",
"message": {
"mission_id": "01939ba1-fd8a-7ed4-acb1-35791c03c70d",
"reason": "operator"
}
}
Сервер принимает и прежний формат — строку с ID миссии, без причины. Тогда причину он берёт из
status_reason в data.
{
"topic": "10001_mission_cancelled",
"message": "01939ba1-fd8a-7ed4-acb1-35791c03c70d"
}
5. photo
Телеметрия- MQTT Topic:
{DRONE_ID}_photo - QoS: 1
Данные фото с детектируемым объектом. Включает изображение в Base64.
namestrrequiredidinttimedatetimerequiredphotoBase64requiredlatfloatrequiredlongfloatrequiredmission_iduuidcommand_iduuidВремя time без часового пояса сервер считает временем UTC.
{
"topic": "10001_photo",
"message": {
"name": "car",
"id": 1,
"time": "2025-08-09T18:31:42",
"photo": "/9j/4AAQSkZJRgABAD...",
"lat": 59.942,
"long": 30.3202
}
}
6. current_model_tracking
ML-модели- MQTT Topic:
{DRONE_ID}_current_model_tracking - QoS: 1
Информация о текущей активной и всех доступных ML-моделях на дроне.
current_modelstrrequiredavailable_modelsArray[str]required{
"topic": "10001_current_model_tracking",
"message": {
"current_model": "yolov8n.pt",
"available_models": [
"yolov8n.pt",
"yolov8s.pt",
"custom_model.pt"
]
}
}
7. result_delete
ML-модели- MQTT Topic:
{DRONE_ID}_result_delete - QoS: 1
Результат удаления ML-моделей. Массив объектов с результатом для каждого файла.
messageArray[object]requiredmodel_namestrrequiredstatus_codeintrequiredmessagestrrequired{
"topic": "10001_result_delete",
"message": [
{
"model_name": "old_model.pt",
"status_code": 200,
"message": "Deleted"
},
{
"model_name": "missing_model.pt",
"status_code": 500,
"message": "File not found"
}
]
}
8. objects_data
Телеметрия- MQTT Topic:
{DRONE_ID}_objects_data - QoS: 1
Метаданные детектируемого объекта без изображения. Передаётся при каждом обнаружении.
namestrrequiredidinttimedatetimerequiredpositionPositionrequiredpointPointrequiredlatfloatrequiredlongfloatrequiredheightfloatdirectionintrequiredspeedfloatdrone_pointPointrequiredlatfloatrequiredlongfloatrequiredmission_iduuidcommand_iduuidВремя time без часового пояса сервер считает временем UTC.
{
"topic": "10001_objects_data",
"message": {
"name": "car",
"id": 1,
"time": "2025-08-09T18:31:42",
"position": {
"point": {
"lat": 59.9397889,
"long": 149.18209,
"height": 200
},
"direction": 90,
"speed": 60
},
"drone_point": {
"lat": -35.364,
"long": 149.165
}
}
}
9. gimbal_data
Камера и подвес- MQTT Topic:
{DRONE_ID}_gimbal_data - QoS: 1
Текущие данные подвеса камеры для каждой подключённой камеры.
{camera_id}objectrequiredrollintrequiredpitchintrequiredyawintrequiredzoomintrequired{
"topic": "10001_gimbal_data",
"message": {
"camera_0": {
"roll": 0,
"pitch": -45,
"yaw": 180,
"zoom": 1
}
}
}
10. gimbal_auto_status
Камера и подвес- MQTT Topic:
{DRONE_ID}_gimbal_auto_status - QoS: 1
Статус автоматического сканирования подвеса.
camera_idstrrequiredstatusstrrequiredrunning— Автосканирование выполняетсяstart— Автосканирование запущеноstop— Автосканирование остановленоcurrent— Ответ на запрос текущего статусаtypestrrequiredsin— Синусоидальное движениеdynamic— Динамическое движениеnone— Не задан{
"topic": "10001_gimbal_auto_status",
"message": {
"camera_id": "camera_1",
"status": "running",
"type": "sin"
}
}
11. drone_params_data
Параметры дрона- MQTT Topic:
{DRONE_ID}_drone_params_data - QoS: 1
Ответ с запрошенными параметрами полётного контроллера (ArduPilot). Ключ — имя параметра, значение — текущее значение.
Из любого ответа сервер сохраняет батарейный набор (BATT_LOW_VOLT, BATT_CRT_VOLT, BATT_LOW_MAH,
BATT_CRT_MAH, BATT_ARM_VOLT, BATT_ARM_MAH, BATT_FS_LOW_ACT, BATT_FS_CRT_ACT, BATT_CAPACITY) —
новой записью только при изменении значений — и сверяет его с порогами заряда карточки батареи.
Остальные параметры не сохраняются.
messageobjectrequired{
"topic": "10001_drone_params_data",
"message": {
"WPNAV_SPEED": 500,
"WPNAV_SPEED_DN": 150
}
}
12. ardupilot_status
Телеметрия- MQTT Topic:
{DRONE_ID}_ardupilot_status - QoS: 1
Статусные сообщения от ArduPilot (предупреждения, ошибки, информация).
severityintrequired0— Emergency1— Alert2— Critical3— Error4— Warning5— Notice6— Infomessagestrrequired{
"topic": "10001_ardupilot_status",
"message": {
"severity": 4,
"message": "PreArm: GPS not healthy"
}
}
13. calibration_data
Калибровка- MQTT Topic:
{DRONE_ID}_calibration_data - QoS: 1
Данные о текущем состоянии калибровки сенсоров.
Сервер сохраняет шаги процедуры, пока дрон в статусе calibration: процедура начинается переходом
статуса в calibration и заканчивается выходом дрона из этого статуса. Сообщения вне процедуры
(ответы на get_calibration_data) не сохраняются. Итог процедуры — топик
calibration_result.
stepintrequired0— Reboot1— Accelerometer2— Magnetometer3— Otherparamintrequiredstatusintrequired0— False (не пройдена)1— True (пройдена)2— Running (выполняется)3— Rebooting (перезагрузка)4— NotStarted (не начата){
"topic": "10001_calibration_data",
"message": {
"step": 1,
"param": 75,
"status": 2
}
}
14. check_motors_data
Калибровка- MQTT Topic:
{DRONE_ID}_check_motors_data - QoS: 1
Данные проверки моторов — массив PWM-значений для каждого мотора.
messageArray[int]required{
"topic": "10001_check_motors_data",
"message": [1000, 1200, 1150, 1180, 1190]
}
15. download_info
ML-модели- MQTT Topic:
{DRONE_ID}_download_info - QoS: 1
Прогресс загрузки файла ML-модели на дрон.
statusstrrequirednone— Загрузка не начатаprogress— Загрузка в процессеcomplete— Загрузка завершенаerror— Ошибка загрузкиmodel_namestrrequiredprogress_percentintmessagestr{
"topic": "10001_download_info",
"message": {
"status": "progress",
"model_name": "yolov8n.pt",
"progress_percent": 45
}
}
16. mag_fitness
Калибровка- MQTT Topic:
{DRONE_ID}_mag_fitness - QoS: 1
Данные калибровки магнитометра (компаса). Полётный контроллер присылает значение один раз по
завершении калибровки компаса. Сервер записывает его в последнюю процедуру калибровки; основной
источник итога — calibration_result, этот топик остаётся страховкой.
compass_idintrequiredfitnessfloatrequired{
"topic": "10001_mag_fitness",
"message": {
"compass_id": 0,
"fitness": 0.95
}
}
17. stream_lost
Камера и подвес- MQTT Topic:
{DRONE_ID}_stream_lost - QoS: 1
Уведомление о потере URL видеопотока. Сервер должен отправить актуальный URL через stream_url.
messagebooleanrequiredtrue— URL видеопотока потерян, требуется повторная отправка{
"topic": "10001_stream_lost",
"message": true
}
18. payload
Телеметрия- MQTT Topic:
{DRONE_ID}_payload - QoS: 1
Полный статус оборудования дрона: камеры, SD-карта, прошивка, контроллер, состояние связи.
Борт публикует payload при каждом старте стека, поэтому сервер использует его как запрос
конфигурации: в ответ на каждое сообщение отправляет asset_config
и запрашивает батарейный набор параметров полётного контроллера через
get_drone_params.
camerasobjectcamera_<index>objectidstrmodelstrserial_numberstrconnection_typestrusb— USBethernet— Ethernetdistortion_modelstrbarrel— Barrelpincushion— Pincushiontangential— Tangentialthin_prism— Thin Prismsd_cardobjectidstrmodelstrserial_numberstrtotal_capacityfloatfree_capacityfloatused_capacityfloatmedia_capacityfloatbatteriesobjectbattery_<index>objectidstrmodelstrcell_count_detectedintcapacity_mah_fcintservosobjectservo_<index>objectidstrmodelstrboard_computerobjectmodelstrfirmwareobjectnamestrversionstrsoftwareobject<product>objectrelease_iduuidrequiredflight_controllerobjectmodelstrsensorsArray[str]batterystrconnectivityobjecttelemetrystrwifibooleansignal_levelfloat{
"topic": "10001_payload",
"message": {
"cameras": {
"camera_0": {
"id": "3f1c2a9e-8c7b-4a55-9f21-1a9d6f2c8c11",
"model": "Sony IMX477",
"serial_number": "CAM-477-883920",
"connection_type": "usb",
"distortion_model": "barrel"
},
"camera_1": {
"id": "7d2a91bc-11aa-4c33-9f88-91c2b7d3aa55",
"model": "Sony IMX219",
"serial_number": "CAM-219-552110",
"connection_type": "usb",
"distortion_model": "barrel"
}
},
"sd_card": {
"id": "c9a11234-77dd-4a22-bc11-9911ffcc8822",
"model": "SanDisk Extreme 128GB",
"serial_number": "SD-128-AX99211",
"total_capacity": 128.0,
"free_capacity": 84.2,
"used_capacity": 43.8,
"media_capacity": 120.5
},
"batteries": {
"battery_0": {
"id": "b1a7c3d2-88aa-4f55-9b11-123456789abc",
"model": "Tattu 6S 16000mAh",
"cell_count_detected": 6,
"capacity_mah_fc": 32000
},
"battery_1": {
"id": "d9f8a2c1-55bb-4e77-aa99-998877665544",
"model": "Tattu 6S 16000mAh (spare)"
}
},
"servos": {
"servo_0": {
"id": "s1c2d3e4-aaaa-bbbb-cccc-111122223333",
"model": "Hitec HS-7954SH"
},
"servo_1": {
"id": "s9f8e7d6-1111-2222-3333-444455556666",
"model": "KST DS215MG"
}
},
"board_computer": {
"model": "NVIDIA Jetson Xavier NX"
},
"firmware": {
"name": "ArduPilot",
"version": "4.5.7"
},
"software": {
"wheelies-core": {
"release_id": "0193f1a2-7b38-7c4e-9a1d-2f3e4d5c6b7a"
}
},
"flight_controller": {
"model": "Cube Orange+",
"sensors": [
"accelerometer",
"gyroscope",
"magnetometer",
"barometer"
],
"battery": "6S LiPo monitoring enabled"
},
"connectivity": {
"telemetry": "SiK Radio 915MHz",
"wifi": true,
"signal_level": 0.82
}
}
}
Сервер обновляет модели плат только по присланным разделам: без flight_controller модель
полётного контроллера не меняется, без board_computer — модель бортового компьютера. При
изменении любой из двух моделей сервер пересобирает и отправляет
variables_config: модель платы входит в
board_model.
По блоку software сервер сверяет ПО дрона. В блоке перечисляются все продукты, запущенные на
дроне, а не только изменившиеся:
- релиз из блока, который уже есть у дрона, получает статус «Запущено»;
- релиз, которого у дрона нет, добавляется со статусом «Запущено»;
- ПО дрона, релиза которого нет в блоке, получает статус «Удалено».
Если блока software нет или он пустой ({}), ПО дрона не меняется. От запущенных релизов
зависит формат задания mission.
19. drone_request_init
Регистрация- MQTT Topic:
drone_request_init(без DRONE_ID) - QoS: 1
Инициация процесса регистрации нового дрона в системе. Состав оборудования и ПО
дрон передаёт в объекте payload — его структура совпадает с сообщением топика
payload.
При одобрении заявки сервер сохраняет у созданного дрона модели бортового компьютера и
полётного контроллера и отправляет дрону первую
variables_config.
organization_idstrrequireddrone_idstrrequiredpublic_keystrmac_addressstrrequiredpayloadobjectarm_device_idstrcamerasobjectcamera_<index>objectidstrmodelstrserial_numberstrconnection_typestrusb— USBethernet— Ethernetdistortion_modelstrbarrel— Barrelpincushion— Pincushiontangential— Tangentialthin_prism— Thin Prismsd_cardobjectidstrmodelstrserial_numberstrtotal_capacityfloatfree_capacityfloatused_capacityfloatmedia_capacityfloatbatteriesobjectbattery_<index>objectidstrmodelstrcell_count_detectedintcapacity_mah_fcintservosobjectservo_<index>objectidstrmodelstrboard_computerobjectmodelstrfirmwareobjectnamestrversionstrsoftwareobject<product>objectrelease_iduuidrequiredflight_controllerobjectmodelstrsensorsArray[str]batterystrconnectivityobjecttelemetrystrwifibooleansignal_levelfloat{
"topic": "drone_request_init",
"message": {
"organization_id": "org-001",
"drone_id": "10001",
"public_key": "MIIBIjANBgkqhki...",
"mac_address": "AA:BB:CC:DD:EE:FF",
"payload": {
"cameras": {
"camera_0": {
"id": "3f1c2a9e-8c7b-4a55-9f21-1a9d6f2c8c11",
"model": "Sony IMX477",
"serial_number": "CAM-ALM-477-883920",
"connection_type": "usb",
"distortion_model": "barrel"
}
},
"sd_card": {
"id": "f11a22bb-3344-5566-7788-99aabbccdde1",
"model": "SanDisk Extreme 128GB",
"serial_number": "SD-128-AX99211",
"total_capacity": 128.0,
"free_capacity": 86.5,
"used_capacity": 41.5,
"media_capacity": 128.0
},
"batteries": {
"battery_0": {
"id": "b1c2d3e4-aaaa-bbbb-cccc-111122223333",
"model": "Tattu 6S 16000mAh LiPo",
"cell_count_detected": 6,
"capacity_mah_fc": 16000
}
},
"servos": {
"servo_0": {
"id": "s1112222-aaaa-bbbb-cccc-000011112222",
"model": "Hitec HS-7954SH"
}
},
"board_computer": {
"model": "NVIDIA Jetson Xavier NX"
},
"firmware": {
"name": "ArduPilot",
"version": "4.5.7"
},
"software": {
"wheelies-core": {
"release_id": "0193f1a2-7b38-7c4e-9a1d-2f3e4d5c6b7a"
}
},
"flight_controller": {
"model": "Cube Orange+",
"sensors": ["accelerometer", "gyroscope", "magnetometer", "barometer"],
"battery": "6S LiPo monitoring enabled"
},
"connectivity": {
"telemetry": "SiK Radio 915MHz",
"wifi": true,
"signal_level": 0.78
}
}
}
}
20. drone_request_complete
Регистрация- MQTT Topic:
drone_request_complete(без DRONE_ID) - QoS: 1
Подтверждение завершения регистрации. Дрон публикует его после получения drone_request_approve. Сервер переводит одобренную заявку дрона в статус «завершена».
Топик — drone_request_complete, без косой черты в начале: /drone_request_complete для MQTT — другой топик, сервер его не получает, и заявка остаётся в статусе «одобрена».
drone_idstrrequired{
"topic": "drone_request_complete",
"message": {
"drone_id": "10001"
}
}
21. follow_info_publisher
Слежение за объектами- MQTT Topic:
{DRONE_ID}_follow_info_publisher - QoS: 1
Информация о текущем состоянии трекинга объекта камерой.
track_idstrrequiredclass_namestrrequiredstatusstrrequiredtracking— Активное слежение за объектомlost— Объект потерянerror— Ошибка трекингаstop— Слежение остановленоnone— Трекинг не активенerror_codestrzoom_statusstrrequiredenable— Автозум активенdisenable— Автозум выключенzoom_meanfloatrequired{
"topic": "10001_follow_info_publisher",
"message": {
"track_id": "42",
"class_name": "car",
"status": "tracking",
"zoom_status": "enable",
"zoom_mean": 5.0
}
}
22. drone_strike_status
Слежение за объектами- MQTT Topic:
{DRONE_ID}_drone_strike_status - QoS: 1
Текущий статус тарана объекта дроном.
track_idstrrequiredclass_namestrrequiredstatusstrrequirednone— Таран не активенstrike— Таран выполняетсяlost— Объект потерян, таран прерван{
"topic": "10001_drone_strike_status",
"message": {
"track_id": "5",
"class_name": "car",
"status": "strike"
}
}
23. drone_follow_status
Слежение за объектами- MQTT Topic:
{DRONE_ID}_drone_follow_status - QoS: 1
Текущий статус следования дрона за объектом.
track_idstrrequiredclass_namestrrequiredstatusstrrequirednone— Следование не активноtracking— Дрон следует за объектомlost— Объект потерян, следование прервано{
"topic": "10001_drone_follow_status",
"message": {
"track_id": "3",
"class_name": "person",
"status": "tracking"
}
}
24. check_registration
Регистрация- MQTT Topic:
check_registration(без DRONE_ID) - QoS: 1
Запрос на проверку регистрации дрона в системе.
messagestrrequired{
"topic": "check_registration",
"message": "10001"
}
25. actual_objects_data
Запрос состояния- MQTT Topic:
{DRONE_ID}_actual_objects_data - QoS: 1
Список актуальных детектируемых объектов, сгруппированных по классам. Каждому классу соответствует массив ID объектов.
objectsobjectrequired{
"topic": "10001_actual_objects_data",
"message": {
"objects": {
"car": [101, 102, 103],
"person": [201, 202]
}
}
}
26. create_orthophoto_request
Ортофото- MQTT Topic:
{DRONE_ID}_create_orthophoto_request - QoS: 1
Запрос дрона на построение ортофотоплана по снятым снимкам. Сервер отвечает через create_orthophoto адресом и токеном для загрузки снимков; ортофотоплан строится на сервере.
request_idstrrequired{
"topic": "10001_create_orthophoto_request",
"message": {
"request_id": "ortho-001"
}
}
27. transferring_info
ML-модели- MQTT Topic:
{DRONE_ID}_transferring_info - QoS: 1
Статус конвертации ML-модели из формата .pt в формат .engine (TensorRT) на дроне. При успешном завершении имя модели меняет расширение с .pt на .engine.
statusstrrequirednone— Нет активного процесса конвертацииstarted— Конвертация начата (инициализация)transferring— Конвертация в процессеcompleted— Конвертация завершена успешноstopped— Конвертация отмененаerror— Ошибка конвертацииmodel_namestrrequiredmessagestrprogress_percentintНет активного процесса:
{
"topic": "10001_transferring_info",
"message": {
"status": "none",
"model_name": "none",
"progress_percent": 0
}
}
Конвертация начата:
{
"topic": "10001_transferring_info",
"message": {
"status": "started",
"model_name": "yolov8s.pt",
"progress_percent": 0
}
}
Конвертация в процессе:
{
"topic": "10001_transferring_info",
"message": {
"status": "transferring",
"model_name": "yolov8s.pt",
"progress_percent": 50
}
}
Конвертация завершена успешно:
{
"topic": "10001_transferring_info",
"message": {
"status": "completed",
"model_name": "yolov8s.engine",
"progress_percent": 100
}
}
Конвертация отменена:
{
"topic": "10001_transferring_info",
"message": {
"status": "stopped",
"model_name": "yolov8s.pt",
"progress_percent": 0
}
}
Ошибка при конвертации:
{
"topic": "10001_transferring_info",
"message": {
"status": "error",
"model_name": "yolov8s.pt",
"message": "Model yolov8s.pt not found",
"progress_percent": 0
}
}
28. download_audio_info
Робот- MQTT Topic:
{DRONE_ID}_download_audio_info - QoS: 1
Прогресс и статус загрузки аудиофайла на робота в рамках голосового пайплайна.
statusstrrequiredprogress— Загрузка в процессеcomplete— Загрузка завершенаerror— Ошибка загрузкиmodel_namestrrequiredprogress_percentintmessagestrЗагрузка в процессе:
{
"topic": "10001_download_audio_info",
"message": {
"status": "progress",
"model_name": "123434.wav",
"progress_percent": 45
}
}
Загрузка завершена:
{
"topic": "10001_download_audio_info",
"message": {
"status": "complete",
"model_name": "123434.wav",
"message": "Audio loaded successfully"
}
}
Ошибка загрузки:
{
"topic": "10001_download_audio_info",
"message": {
"status": "error",
"model_name": "123434.wav",
"message": "ConnectionError / Timeout / ..."
}
}
29. STT_result
Робот- MQTT Topic:
{DRONE_ID}_STT_result - QoS: 1
Результат распознавания речи (Speech-to-Text). После успешной загрузки аудио робот запускает голосовой пайплайн, первый этап которого — распознавание речи (Whisper).
messagestrrequired{
"topic": "10001_STT_result",
"message": {
"message": "Привет, как дела?"
}
}
30. LLM_answer
Робот- MQTT Topic:
{DRONE_ID}_LLM_answer - QoS: 1
Ответ языковой модели (LLM). Второй этап голосового пайплайна — генерация ответа языковой моделью (Qwen) на основе распознанного текста.
messagestrrequired{
"topic": "10001_LLM_answer",
"message": {
"message": "Привет! У меня всё отлично, спасибо что спросил."
}
}
31. lep_status
ЛЭП- MQTT Topic:
{DRONE_ID}_lep_status - QoS: 1
Агрегированный статус режима полёта вдоль ЛЭП и инспекции столбов. Публикуется при изменении состояния любой подсистемы ЛЭП, а также в ответ на lep_control с action: "current".
lep_enabledbooleanrequiredfollowingbooleanrequiredfollow_statusstrrequiredidle— Режим ЛЭП не активенsearching— Столбы не обнаружены, ожиданиеfollowing— Активный полёт вдоль линии столбовapproaching— Приближение к столбу — замедлениеlost— Провод потерян (автоматическое отключение ЛЭП)stop— Полёт приостановленerror— Внутренняя ошибка (зарезервировано)pole_inspector_enabledbooleanrequiredpole_inspector_statusstrrequiredinactive— Инспекция столбов не активнаsearching— Камера направлена вниз, ожидание обнаружения столбаtracking— Столб обнаружен, отслеживается в кадреbraking— Столб приближается к центру кадра — дрон замедляетсяphotographing— Дрон зависает, идёт серия из 3 фотоresetting— Фото сделаны, ожидание следующего столбаpole_countintrequiredlep_placement_activebooleanrequiredlep_placement_statestrrequiredidle— Постановка не активнаdetecting— Поиск двух столбов на гимбал-камереready— Два столба найдены, дрон зависает, ожидание placement_startaligning— Выравнивание между столбами + поворот headingdescending— Снижение до целевой высотыcomplete— Постановка завершена (нода автоматически выключается)Всё выключено (ответ на current при неактивном режиме):
{
"topic": "10001_lep_status",
"message": {
"lep_enabled": false,
"following": false,
"follow_status": "idle",
"pole_inspector_enabled": false,
"pole_inspector_status": "inactive",
"pole_count": 0,
"lep_placement_active": false,
"lep_placement_state": "idle"
}
}
Постановка — поиск столбов:
{
"topic": "10001_lep_status",
"message": {
"lep_enabled": false,
"following": false,
"follow_status": "idle",
"pole_inspector_enabled": false,
"pole_inspector_status": "inactive",
"pole_count": 0,
"lep_placement_active": true,
"lep_placement_state": "detecting"
}
}
Постановка — столбы найдены, ожидание placement_start:
{
"topic": "10001_lep_status",
"message": {
"lep_enabled": false,
"following": false,
"follow_status": "idle",
"pole_inspector_enabled": false,
"pole_inspector_status": "inactive",
"pole_count": 0,
"lep_placement_active": true,
"lep_placement_state": "ready"
}
}
Полёт вдоль ЛЭП + инспекция активны:
{
"topic": "10001_lep_status",
"message": {
"lep_enabled": true,
"following": true,
"follow_status": "following",
"pole_inspector_enabled": true,
"pole_inspector_status": "searching",
"pole_count": 0,
"lep_placement_active": false,
"lep_placement_state": "idle"
}
}
Полёт + инспекция, приближение к столбу:
{
"topic": "10001_lep_status",
"message": {
"lep_enabled": true,
"following": true,
"follow_status": "approaching",
"pole_inspector_enabled": true,
"pole_inspector_status": "braking",
"pole_count": 2,
"lep_placement_active": false,
"lep_placement_state": "idle"
}
}
Столб потерян (автоматическое выключение):
{
"topic": "10001_lep_status",
"message": {
"lep_enabled": false,
"following": false,
"follow_status": "lost",
"pole_inspector_enabled": false,
"pole_inspector_status": "inactive",
"pole_count": 0,
"lep_placement_active": false,
"lep_placement_state": "idle"
}
}
32. update_software_status
ПО- MQTT Topic:
{DRONE_ID}_update_software_status - QoS: 1
Результат обновления программного обеспечения на дроне: как успешное завершение, так и неудача.
installation_idstringrequiredstatusstringrequiredok— Обновление успешно завершеноerror— Не удалось обновитьversionstringreasonstringsoftware_release_idstring{
"topic": "10001_update_software_status",
"message": {
"installation_id": "8f4d3c21-6f5d-4a31-bd93-12c3f0f7a8d1",
"software_release_id": "9d8c7b6a-5e4f-3a2b-1c0d-fedcba987654",
"version": "2.5.1",
"status": "ok"
}
}
{
"topic": "10001_update_software_status",
"message": {
"installation_id": "8f4d3c21-6f5d-4a31-bd93-12c3f0f7a8d1",
"version": "2.5.1",
"status": "error",
"reason": "Недостаточно места на диске"
}
}
Переменная пина — запись на платформе, связывающая код переменной с пином платы дрона.
Выходная переменная (direction: "out") — управляющее воздействие, входная ("in") — показание
датчика. Платформа передаёт борту полный набор активных переменных (variables_config), значения
выходных переменных (pin_var_{code}), борт подтверждает применение и возвращает значения в
телеметрии (data.custom).
33. get_variables_config
Переменные пинов- MQTT Topic:
{DRONE_ID}_get_variables_config - QoS: 1
Запрос конфигурации переменных пинов — актуального набора переменных, например после перезагрузки борта без постоянного хранилища. Полей нет, сообщение пустое.
{
"topic": "10001_get_variables_config",
"message": {}
}
В ответ сервер публикует variables_config — всегда,
даже если набор не менялся, с прежним config_version. После переподключения к брокеру борт и так
получает последнюю конфигурацию: она retained.
34. variables_config_status
Переменные пинов- MQTT Topic:
{DRONE_ID}_variables_config_status - QoS: 1
Результат применения конфигурации переменных
variables_config: успех или отказ с перечнем
непринятых переменных.
config_versionintrequiredresultstrrequiredapplied— Конфигурация применена целикомrejected— Конфигурация отклонена целиком, борт остался на прежнем маппингеrejectedArray[object]codestrrequiredreasonstrrequiredpin_reserved— Пин занят прошивкойpin_not_found— Нет такого пинаconnection_not_supported— Пин не поддерживает тип подключенияduplicate_pin— Два активных назначения на один пинtype_mismatch— Значение не соответствует типуinvalid_config— Сообщение не разобраноmessagestrtsintrequiredОтказ:
{
"topic": "10001_variables_config_status",
"message": {
"config_version": 7,
"result": "rejected",
"rejected": [
{
"code": "water_valve",
"reason": "pin_reserved",
"message": "Пин 5 занят прошивкой (SERVO5_FUNCTION)"
}
],
"ts": 1758700005
}
}
Успех:
{
"topic": "10001_variables_config_status",
"message": {
"config_version": 7,
"result": "applied",
"ts": 1758700005
}
}
Сервер сохраняет ответ, только если config_version равна текущей версии конфигурации дрона;
ответ на устаревшую версию отбрасывается.
35. variables_status
Переменные пинов- MQTT Topic:
{DRONE_ID}_variables_status - QoS: 1
Результат воздействия по переменной пина — по значению из
pin_var_{code}: успех или отказ с причиной. Один топик на
дрон, ответ связан с запросом по request_id.
request_iduuidrequiredcodestrrequiredresultstrrequiredapplied— Борт установил значение на выходеrejected— Борт не установил значениеreasonstrunknown_code— Переменной нет в конфигурации бортаstale_config— config_version не совпадает с применённойexpired— Истёк срок действия командыtype_mismatch— Значение не того типаout_of_range— Значение вне границresource_busy— Пин или шина заняты другой операциейhardware_error— Сбой оборудованияtsintrequired{
"topic": "10001_variables_status",
"message": {
"request_id": "8f3c2b1a-4d5e-4f60-9a7b-1c2d3e4f5a6b",
"code": "water_valve",
"result": "rejected",
"reason": "stale_config",
"ts": 1758700001
}
}
Особенности:
- Борт отправляет ответ после каждой попытки применить воздействие, независимо от результата; так подтверждаются и разовые действия без состояния.
appliedзначит только «значение установлено на выходе», а не «механизм сработал»: физический результат виден по датчику вdata.custom.- Сервер пишет ответ в журнал действий с переменными.
36. mission_rejected
Миссии- MQTT Topic:
{DRONE_ID}_mission_rejected - QoS: 1
Отказ дрона от полученной миссии до взлёта. Борт на земле с уровнем заряда low или critical
отклоняет взлётные миссии (посадочные выполняет). Задание версии 2 борт отклоняет и тогда, когда
не может его выполнить: нет параметра, поля или оборудования, команда или поле не поддерживается.
Публикуется после mission_received.
mission_iduuidrequiredreasonstrrequiredbattery_low— Уровень заряда lowbattery_critical— Уровень заряда criticalmissing_command_param— У команды нет обязательного параметра (command_id, param_key)missing_mission_field— Нет обязательного поля миссии (param_key)missing_equipment— У дрона нет нужного оборудованияno_fly_zones_check_failed— Не удалось проверить маршрут по запретным зонамtrigger_unsupported— Триггер не поддерживается (trigger_id)unsupported_command— Команда не поддерживается (command_id)unsupported_mission_field— Поле миссии не поддерживается (param_key)invalid_command— Команда задана неверно (command_id)battery_levelfloatcommand_iduuidparam_keystrtrigger_iduuiddetailstr{
"topic": "10001_mission_rejected",
"message": {
"mission_id": "01939ba1-fd8a-7ed4-acb1-35791c03c70d",
"reason": "battery_low",
"battery_level": 29.5
}
}
Сервер помечает миссию как не начатую, сохраняет причину и уведомляет пользователей организации.
Если mission_rejected не пришёл, срабатывает страховочный таймаут из
mission_received.
37. mission_aborted
Миссии- MQTT Topic:
{DRONE_ID}_mission_aborted - QoS: 1
Миссия прервана: дрон перешёл в emergency landing во время выполнения или в контроллере миссии
на борту произошла внутренняя ошибка. В этом случае борт не публикует ни mission_completed, ни
mission_cancelled — топик единственный сигнал о том, что миссия закончилась.
mission_iduuidrequiredreasonstrrequiredcritical_disarm— Команда critical_disarmfc_emergency— Авария, на которую сам отреагировал полётный контроллерinternal_error— Внутренняя ошибка контроллера миссии; текст ошибки — в detaildetailstr{
"topic": "10001_mission_aborted",
"message": {
"mission_id": "01939ba1-fd8a-7ed4-acb1-35791c03c70d",
"reason": "fc_emergency",
"detail": "Crash: Disarming"
}
}
Сервер закрывает участие дрона в миссии, сохраняет причину и уведомляет пользователей организации.
Когда завершены команды всех дронов миссии, она получает статус aborted, а запись полёта дрона —
статус critical. Если топик не пришёл, сервер распознаёт аварию по статусу emergency landing
в data.
38. calibration_result
Калибровка- MQTT Topic:
{DRONE_ID}_calibration_result - QoS: 1
Итог процедуры калибровки одним сообщением. Борт кэширует последний отчёт о калибровке компаса до
перезапуска ноды и публикует итог по завершении процедуры. Основной источник итога для сервера;
mag_fitness остаётся страховкой.
outcomestrrequiredmag_fitnessfloatcompass_idint{
"topic": "10001_calibration_result",
"message": {
"outcome": "success",
"mag_fitness": 3.1,
"compass_id": 0
}
}
Сервер записывает итог в последнюю процедуру калибровки дрона; при повторной калибровке компаса внутри процедуры значение перезаписывается.
39. cancel_rejected
Миссии- MQTT Topic:
{DRONE_ID}_cancel_rejected - QoS: 1
Борт не применил cancel_mission и сообщает почему.
mission_iduuidrequiredactive_mission_iduuidreasonstrno_active_mission— Дрон не выполняет миссию — остановка не требуетсяmission_mismatch— Дрон выполняет другую миссию — команда не примененаfinal_landing— Маршрут пройден, дрон садится в точке старта{
"topic": "10001_cancel_rejected",
"message": {
"mission_id": "01939ba1-fd8a-7ed4-acb1-35791c03c70d",
"active_mission_id": null,
"reason": "no_active_mission"
}
}
Сервер показывает оператору причину у дрона на странице миссии. При no_active_mission и
mission_mismatch оператор может закрыть участие дрона кнопкой «Закрыть без подтверждения
дрона». При final_landing сервер ждёт mission_completed. Если reason
нет, сервер определяет причину по active_mission_id.
40. command_status
Миссии- MQTT Topic:
{DRONE_ID}_command_status - QoS: 1
Начало и окончание каждой команды задания версии 2.
mission_iduuidrequiredcommand_iduuidrequiredstatusstrrequiredstarted— Команда начатаcompleted— Команда выполненаskipped— Команда пропущенаinterrupted— Команда прерванаtsnumberrequired{
"topic": "10001_command_status",
"message": {
"mission_id": "01939ba1-fd8a-7ed4-acb1-35791c03c70d",
"command_id": "0193a0c2-3b4c-7d5e-8f60-7a8b9c0d1e2f",
"status": "started",
"ts": 1762671600
}
}
Сервер показывает статус команды на странице миссии. Сообщение о команде другой миссии, другой
попытки или уже закрытого участия дрона сервер пропускает. Переход назад по триггеру
(goto_step) возвращает выполненную команду в выполнение.
41. trigger_fired
Миссии- MQTT Topic:
{DRONE_ID}_trigger_fired - QoS: 1
Борт выполнил действие триггера из задания версии 2.
mission_iduuidrequiredtrigger_iduuidrequiredcommand_iduuidactionstrrequiredvaluesobjectfired_tsnumberrequiredtsnumberrequired{
"topic": "10001_trigger_fired",
"message": {
"mission_id": "01939ba1-fd8a-7ed4-acb1-35791c03c70d",
"trigger_id": "0193a0c2-5d6e-7f80-8b91-9c0d1e2f3a4b",
"command_id": "0193a0c2-3b4c-7d5e-8f60-7a8b9c0d1e2f",
"action": "return_home",
"values": { "battery_level": 39 },
"fired_ts": 1762671900,
"ts": 1762671901
}
}
Сервер записывает срабатывание в журнал миссии. О действиях return_home, land, pause,
finish и notify он уведомляет пользователей организации.