Skip to main content

Дрон → Сервер

Топики для передачи данных и статусов от дрона к серверу.

1. data​

Телеметрия
  • MQTT Topic: {DRONE_ID}_data
  • QoS: 1

Периодическая публикация телеметрии дрона: координаты, высота, скорость, заряд и напряжение батареи, уровень заряда, по которому действует борт, оценка остатка полётного времени, курс, статус миссии и его причина, режим полётного контроллера, флаги режимов управления и значения переменных пинов. Публикуется по таймеру (~0.7 с).

positionPositionrequired
Позиция дрона
pointPointrequired
Координаты
latfloatrequired
Широта
longfloatrequired
Долгота
heightfloat
Высота (м)
directionintrequired
Направление движения (0–360°)
speedfloat
Скорость (м/с)
battery_levelfloatrequired
Заряд батареи (0–100%), рассчитан по напряжению на борту (null если недоступен)
battery_voltagefloat
Напряжение батареи (В), null если недоступно
time_remaining_sint
Оценка оставшегося полётного времени (с). null, если ток мал (дрон на земле) или оценка недоступна
headingfloatrequired
Курс/направление камеры (0–360°)
statusstrrequired
Текущий статус дрона
online— В сети, готов к работе
offline— Не в сети
on mission— Выполняет миссию
taking off— Взлетает
landing— Совершает посадку
returning— Возвращается на точку старта
paused— Миссия на паузе
emergency landing— Аварийная посадка
calibration— Идёт калибровка
flight_modestr
Фактический режим полётного контроллера ArduPilot: STABILIZE, GUIDED, AUTO, RTL, LAND, BRAKE и др. Отражает реальный режим независимо от status. null до связи с полётным контроллером
armedboolean
Моторы взведены. false на земле после посадки
battery_statusstr
Уровень заряда, по которому борт реально действует: возвращается домой, садится на месте, отклоняет взлётную миссию. Снимается с гистерезисом 3 п. п.: `low → ok` при заряде ≥ low_percent + 3. Сервер использует его в допуске к миссии вместо сравнения battery_level с порогом
ok— Заряд выше порога низкого заряда
low— Ниже low_percent — дрон возвращается на точку старта
critical— Ниже critical_percent — дрон садится на месте
unknown— Уровень ещё не определён
status_reasonstr
Причина текущего returning, landing или emergency landing. null, если статус выставлен не по этим причинам. Сервер использует её при расчёте статуса полёта
operator— Команда оператора
battery_low— Низкий заряд
battery_critical— Критический заряд
fc_failsafe— Failsafe полётного контроллера
critical_disarm— Команда critical_disarm
battery_idstr
Ключ записи батареи из asset_config, к которой относятся battery_level и battery_voltage. Фактически всегда battery_0
mission_iduuidrequired
ID текущей миссии
command_iduuidrequired
ID выполняемой команды
trackerbooleanrequired
AI-детекция активна
tracker_camerastr
Идентификатор активной камеры трекинга (null если не выбрана)
use_hand_modebooleanrequired
Ручной режим управления активен
obstacle_avoidancebooleanrequired
Обход препятствий активен
aimobject
Цель во время тарана (null если нет цели)
carint
ID целевого объекта
customobject
Значения переменных пинов: «код переменной → значение в её `data_type`». Входные переменные — показания датчиков; выходные — текущее состояние, только у переменных с `has_state: true`. Переменная, значение которой недоступно, не передаётся — ключа нет
{
"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_cancelledmission_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
ID полученной миссии
{
"topic": "10001_mission_received",
"message": "01939ba1-fd8a-7ed4-acb1-35791c03c70d"
}

3. mission_completed​

Миссии
  • MQTT Topic: {DRONE_ID}_mission_completed
  • QoS: 1

Уведомление о завершении миссии.

messageuuidrequired
ID завершённой миссии
{
"topic": "10001_mission_completed",
"message": "01939ba1-fd8a-7ed4-acb1-35791c03c70d"
}

4. mission_cancelled​

Миссии
  • MQTT Topic: {DRONE_ID}_mission_cancelled
  • QoS: 1

Дрон прекратил выполнение миссии — по команде cancel_mission или по решению борта. Публикуется после посадки.

mission_iduuidrequired
ID прекращённой миссии
reasonstrrequired
Почему борт прекратил выполнение
operator— Команда cancel_mission
battery_low— Заряд ниже порога низкого заряда
battery_critical— Заряд ниже порога критического заряда
no_fly_zone— Запретную зону обойти нельзя (задание версии 2)
exec_time_exceeded— Истекло время на выполнение команды (exec_time, задание версии 2)
trigger— Действие триггера завершило миссию (задание версии 2)
no_fly_zone_iduuid
Только при reason: no_fly_zone — id зоны из negative_zones
trigger_iduuid
Только при reason: trigger — id триггера из задания
{
"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.

namestrrequired
Класс детектируемого объекта (например, car, person)
idint
ID детектируемого объекта
timedatetimerequired
Время детекции в формате YYYY-MM-DDThh:mm:ss
photoBase64required
Изображение объекта в формате Base64
latfloatrequired
Широта координаты дрона в момент съёмки
longfloatrequired
Долгота координаты дрона в момент съёмки
mission_iduuid
Миссия, при выполнении которой сделан снимок. Нет поля — сервер берёт миссию из последней data
command_iduuid
Команда миссии, при выполнении которой сделан снимок. Нет поля — сервер берёт команду из последней data

Время 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_modelstrrequired
Имя файла текущей активной модели
available_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]required
Результаты удаления
model_namestrrequired
Имя файла модели
status_codeintrequired
HTTP-код результата (200 — успех, 500 — ошибка)
messagestrrequired
Текстовое описание результата
{
"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

Метаданные детектируемого объекта без изображения. Передаётся при каждом обнаружении.

namestrrequired
Класс объекта (например, car, person)
idint
ID объекта в рамках текущей сессии
timedatetimerequired
Время детекции в формате YYYY-MM-DDThh:mm:ss
positionPositionrequired
Позиция обнаруженного объекта
pointPointrequired
Координаты объекта
latfloatrequired
Широта
longfloatrequired
Долгота
heightfloat
Высота (м)
directionintrequired
Направление движения объекта (0–360°)
speedfloat
Скорость объекта (м/с)
drone_pointPointrequired
Координаты дрона в момент детекции
latfloatrequired
Широта дрона
longfloatrequired
Долгота дрона
mission_iduuid
Миссия, при выполнении которой найден объект. Нет поля — сервер берёт миссию из последней data
command_iduuid
Команда миссии, при выполнении которой найден объект. Нет поля — сервер берёт команду из последней data

Время 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}objectrequired
Параметры подвеса камеры
rollintrequired
Крен
pitchintrequired
Тангаж
yawintrequired
Рыскание
zoomintrequired
Текущее значение зума
{
"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_idstrrequired
ID камеры
statusstrrequired
Текущий статус автосканирования
running— Автосканирование выполняется
start— Автосканирование запущено
stop— Автосканирование остановлено
current— Ответ на запрос текущего статуса
typestrrequired
Тип сканирования
sin— Синусоидальное движение
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 (предупреждения, ошибки, информация).

severityintrequired
Уровень важности сообщения
0— Emergency
1— Alert
2— Critical
3— Error
4— Warning
5— Notice
6— Info
messagestrrequired
Текст сообщения от ArduPilot
{
"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.

stepintrequired
Текущий этап калибровки
0— Reboot
1— Accelerometer
2— Magnetometer
3— Other
paramintrequired
Прогресс или параметр текущего этапа
statusintrequired
Общий статус калибровки
0— 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
Массив из 5 целых чисел: общий газ и PWM моторов 1–4 (в порядке тестирования: 1, 4, 2, 3)
{
"topic": "10001_check_motors_data",
"message": [1000, 1200, 1150, 1180, 1190]
}

15. download_info​

ML-модели
  • MQTT Topic: {DRONE_ID}_download_info
  • QoS: 1

Прогресс загрузки файла ML-модели на дрон.

statusstrrequired
Статус загрузки
none— Загрузка не начата
progress— Загрузка в процессе
complete— Загрузка завершена
error— Ошибка загрузки
model_namestrrequired
Имя файла загружаемой модели
progress_percentint
Процент загрузки (0–100, только при status=progress)
messagestr
Текст ошибки (только при status=error)
{
"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_idintrequired
ID компаса (0, 1, 2)
fitnessfloatrequired
Невязка подгонки калибровки компаса: чем меньше, тем лучше. Значение выше COMPASS_CAL_FIT × 2 считается неудачной калибровкой
{
"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.

messagebooleanrequired
Уведомление о потере потока
true— URL видеопотока потерян, требуется повторная отправка
{
"topic": "10001_stream_lost",
"message": true
}

18. payload​

Телеметрия
  • MQTT Topic: {DRONE_ID}_payload
  • QoS: 1

Полный статус оборудования дрона: камеры, SD-карта, прошивка, контроллер, состояние связи.

Борт публикует payload при каждом старте стека, поэтому сервер использует его как запрос конфигурации: в ответ на каждое сообщение отправляет asset_config и запрашивает батарейный набор параметров полётного контроллера через get_drone_params.

camerasobject
Список подключенных камер
camera_<index>object
Камера (key = short_id)
idstr
UUID камеры
modelstr
Модель камеры
serial_numberstr
Серийный номер
connection_typestr
Тип подключения
usb— USB
ethernet— Ethernet
distortion_modelstr
Модель дисторсии
barrel— Barrel
pincushion— Pincushion
tangential— Tangential
thin_prism— Thin Prism
sd_cardobject
Карта памяти
idstr
UUID карты памяти
modelstr
Модель
serial_numberstr
Серийный номер
total_capacityfloat
Общий объём (GB)
free_capacityfloat
Свободно (GB)
used_capacityfloat
Занято (GB)
media_capacityfloat
Занято медиа (фото/видео)
batteriesobject
Список батарей
battery_<index>object
Батарея (key = short_id)
idstr
UUID батареи
modelstr
Модель батареи
cell_count_detectedint
Число ячеек по собственному автоопределению борта: выводится из напряжения один раз при первом сообщении батареи. Значением из asset_config не затирается. null — борт своего мнения не имеет. Сервер сверяет его с числом ячеек карточки батареи
capacity_mah_fcint
Значение параметра BATT_CAPACITY полётного контроллера (мА·ч) — настройка, а не измерение. При расхождении с ёмкостью карточки сервер записывает ёмкость карточки в BATT_CAPACITY через set_drone_params
servosobject
Список сервоприводов
servo_<index>object
Серво (key = short_id)
idstr
UUID сервопривода
modelstr
Модель
board_computerobject
Бортовой компьютер
modelstr
Модель (Jetson / Raspberry Pi и т.д.). Сервер сохраняет её у дрона строкой, как прислал борт, пустая строка стирает значение; используется в `variables_config.board_model`
firmwareobject
Прошивка
namestr
Название (ArduPilot / PX4)
versionstr
Версия прошивки
softwareobject
Программные продукты платформы, запущенные на дроне: имя продукта → релиз
<product>object
Программный продукт (key = имя продукта)
release_iduuidrequired
ID релиза на платформе
flight_controllerobject
Полетный контроллер
modelstr
Модель (Cube Orange+, Pixhawk). Сервер сохраняет её у дрона строкой, как прислал борт, пустая строка стирает значение; используется в `variables_config.board_model`
sensorsArray[str]
Сенсоры
batterystr
Состояние/питание
connectivityobject
Связь и телеметрия
telemetrystr
Канал телеметрии
wifiboolean
Wi-Fi доступность
signal_levelfloat
Уровень сигнала (0..1)
{
"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_idstrrequired
ID организации-владельца
drone_idstrrequired
ID дрона
public_keystr
Открытый ключ дрона, RSA 2048, PEM (SPKI). Им сервер шифрует aes_key в drone_request_approve. Если ключ не передан или передана пустая строка, сервер не передаёт дрону aes_key и обменивается с ним без шифрования
mac_addressstrrequired
MAC-адрес дрона
payloadobject
Оборудование и ПО дрона — структура топика payload. Необязателен: без него заявка создаётся с пустым составом, а если заявка уже есть, непустой payload из повторного сообщения дописывается в неё
arm_device_idstr
ID АРМ, к которому привязан дрон. Если такого АРМ нет на платформе, сервер его не сохраняет
camerasobject
Список подключенных камер
camera_<index>object
Камера (key = short_id)
idstr
UUID камеры
modelstr
Модель камеры
serial_numberstr
Серийный номер
connection_typestr
Тип подключения
usb— USB
ethernet— Ethernet
distortion_modelstr
Модель дисторсии
barrel— Barrel
pincushion— Pincushion
tangential— Tangential
thin_prism— Thin Prism
sd_cardobject
Карта памяти
idstr
UUID карты памяти
modelstr
Модель
serial_numberstr
Серийный номер
total_capacityfloat
Общий объём (GB)
free_capacityfloat
Свободно (GB)
used_capacityfloat
Занято (GB)
media_capacityfloat
Занято медиа (фото/видео)
batteriesobject
Список батарей
battery_<index>object
Батарея (key = short_id)
idstr
UUID батареи
modelstr
Модель батареи
cell_count_detectedint
Число ячеек по автоопределению борта — как в payload
capacity_mah_fcint
Значение BATT_CAPACITY полётного контроллера — как в payload
servosobject
Список сервоприводов
servo_<index>object
Серво (key = short_id)
idstr
UUID сервопривода
modelstr
Модель
board_computerobject
Бортовой компьютер
modelstr
Модель бортового компьютера. При одобрении заявки сервер сохраняет её у дрона
firmwareobject
Прошивка
namestr
Название (ArduPilot / PX4)
versionstr
Версия прошивки
softwareobject
Программные продукты, загруженные на дрон: имя продукта → идентификатор релиза
<product>object
Программный продукт (key = имя продукта)
release_iduuidrequired
ID релиза из wheelies_config.json
flight_controllerobject
Полетный контроллер
modelstr
Модель контроллера. При одобрении заявки сервер сохраняет её у дрона
sensorsArray[str]
Сенсоры
batterystr
Состояние/питание
connectivityobject
Связь и телеметрия
telemetrystr
Канал телеметрии
wifiboolean
Wi-Fi доступность
signal_levelfloat
Уровень сигнала (0..1)
{
"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
ID дрона
{
"topic": "drone_request_complete",
"message": {
"drone_id": "10001"
}
}

21. follow_info_publisher​

Слежение за объектами
  • MQTT Topic: {DRONE_ID}_follow_info_publisher
  • QoS: 1

Информация о текущем состоянии трекинга объекта камерой.

track_idstrrequired
ID отслеживаемого объекта или none при отсутствии цели
class_namestrrequired
Класс объекта или none при отсутствии цели
statusstrrequired
Статус трекинга
tracking— Активное слежение за объектом
lost— Объект потерян
error— Ошибка трекинга
stop— Слежение остановлено
none— Трекинг не активен
error_codestr
Код ошибки (только при status=error)
zoom_statusstrrequired
Состояние автозума
enable— Автозум активен
disenable— Автозум выключен
zoom_meanfloatrequired
Текущее среднее значение зума (1.0–15.0)
{
"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_idstrrequired
ID целевого объекта
class_namestrrequired
Класс объекта
statusstrrequired
Статус тарана
none— Таран не активен
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_idstrrequired
ID целевого объекта
class_namestrrequired
Класс объекта
statusstrrequired
Статус следования
none— Следование не активно
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
ID дрона для проверки регистрации
{
"topic": "check_registration",
"message": "10001"
}

25. actual_objects_data​

Запрос состояния
  • MQTT Topic: {DRONE_ID}_actual_objects_data
  • QoS: 1

Список актуальных детектируемых объектов, сгруппированных по классам. Каждому классу соответствует массив ID объектов.

objectsobjectrequired
Объект, где ключ — класс объекта, значение — массив ID объектов этого класса
{
"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
Уникальный ID запроса
{
"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.

statusstrrequired
Статус конвертации
none— Нет активного процесса конвертации
started— Конвертация начата (инициализация)
transferring— Конвертация в процессе
completed— Конвертация завершена успешно
stopped— Конвертация отменена
error— Ошибка конвертации
model_namestrrequired
Имя модели. При status=completed расширение меняется с .pt на .engine. При остальных статусах — исходное имя файла. Значение none при status=none
messagestr
Текст ошибки (только при status=error)
progress_percentint
Процент выполнения конвертации (0–100)

Нет активного процесса:

{
"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

Прогресс и статус загрузки аудиофайла на робота в рамках голосового пайплайна.

statusstrrequired
Статус загрузки
progress— Загрузка в процессе
complete— Загрузка завершена
error— Ошибка загрузки
model_namestrrequired
Имя загружаемого аудиофайла
progress_percentint
Процент загрузки (0–100, только при status=progress)
messagestr
Сообщение (при status=complete или status=error)

Загрузка в процессе:

{
"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_enabledbooleanrequired
Активированы ли ноды детекции и управления полётом вдоль ЛЭП
followingbooleanrequired
Идёт ли полёт вдоль проводов
follow_statusstrrequired
Детальный статус полёта
idle— Режим ЛЭП не активен
searching— Столбы не обнаружены, ожидание
following— Активный полёт вдоль линии столбов
approaching— Приближение к столбу — замедление
lost— Провод потерян (автоматическое отключение ЛЭП)
stop— Полёт приостановлен
error— Внутренняя ошибка (зарезервировано)
pole_inspector_enabledbooleanrequired
Активирована ли инспекция столбов
pole_inspector_statusstrrequired
Статус инспекции столбов
inactive— Инспекция столбов не активна
searching— Камера направлена вниз, ожидание обнаружения столба
tracking— Столб обнаружен, отслеживается в кадре
braking— Столб приближается к центру кадра — дрон замедляется
photographing— Дрон зависает, идёт серия из 3 фото
resetting— Фото сделаны, ожидание следующего столба
pole_countintrequired
Количество сфотографированных столбов
lep_placement_activebooleanrequired
Активна ли постановка дрона над ЛЭП
lep_placement_statestrrequired
Статус постановки
idle— Постановка не активна
detecting— Поиск двух столбов на гимбал-камере
ready— Два столба найдены, дрон зависает, ожидание placement_start
aligning— Выравнивание между столбами + поворот heading
descending— Снижение до целевой высоты
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_idstringrequired
Идентификатор операции установки из таблицы `software_installation`. Сообщение с неизвестным идентификатором, а также сообщение по установке не в статусе `started`, сервер игнорирует
statusstringrequired
Статус операции установки
ok— Обновление успешно завершено
error— Не удалось обновить
versionstring
Версия ПО, установленная в ходе обновления. Формат: `major.minor.patch`. Обязательна при `status: ok`: сервер сравнивает её с версией релиза из установки, и при несовпадении или отсутствии считает обновление неудачным
reasonstring
Причина неудачи. Учитывается только когда обновление признано неудачным, сохраняется в `software_installation.error_message`
software_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_versionintrequired
Версия из полученной `variables_config`
resultstrrequired
Результат применения
applied— Конфигурация применена целиком
rejected— Конфигурация отклонена целиком, борт остался на прежнем маппинге
rejectedArray[object]
При `rejected`: все непринятые переменные сразу, а не первая
codestrrequired
Код переменной
reasonstrrequired
Машиночитаемая причина. Рекомендуемые значения — перечень не закреплён в коде сервера, сервер сохраняет значение как есть
pin_reserved— Пин занят прошивкой
pin_not_found— Нет такого пина
connection_not_supported— Пин не поддерживает тип подключения
duplicate_pin— Два активных назначения на один пин
type_mismatch— Значение не соответствует типу
invalid_config— Сообщение не разобрано
messagestr
Пояснение для человека — пользователь увидит его как есть
tsintrequired
Время ответа, Unix-время в секундах

Отказ:

{
"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_iduuidrequired
`request_id` из `pin_var_{code}`
codestrrequired
Код переменной — дублирует переменную явно
resultstrrequired
Результат воздействия
applied— Борт установил значение на выходе
rejected— Борт не установил значение
reasonstr
При `rejected`: причина
unknown_code— Переменной нет в конфигурации борта
stale_config— config_version не совпадает с применённой
expired— Истёк срок действия команды
type_mismatch— Значение не того типа
out_of_range— Значение вне границ
resource_busy— Пин или шина заняты другой операцией
hardware_error— Сбой оборудования
tsintrequired
Время ответа, Unix-время в секундах
{
"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_iduuidrequired
ID отклонённой миссии
reasonstrrequired
Причина отказа
battery_low— Уровень заряда low
battery_critical— Уровень заряда critical
missing_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_levelfloat
Заряд батареи на момент отказа (0–100 %). У причин по заряду
command_iduuid
Команда задания, к которой относится отказ
param_keystr
Ключ параметра команды или поля миссии
trigger_iduuid
Триггер задания, к которому относится отказ
detailstr
Подробность словами борта. Сервер показывает её оператору в итоге участия дрона
{
"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_iduuidrequired
ID прерванной миссии
reasonstrrequired
Причина прерывания
critical_disarm— Команда critical_disarm
fc_emergency— Авария, на которую сам отреагировал полётный контроллер
internal_error— Внутренняя ошибка контроллера миссии; текст ошибки — в detail
detailstr
Подробность от борта, например текст сообщения полётного контроллера. null, если нет
{
"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 остаётся страховкой.

outcomestrrequired
Чем закончилась процедура. Перечень значений с бортом не согласован, сервер сохраняет строку как есть
mag_fitnessfloat
Невязка калибровки компаса — как fitness в mag_fitness. null, если компас не калибровался
compass_idint
ID компаса, к которому относится mag_fitness
{
"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_iduuidrequired
ID миссии из cancel_mission
active_mission_iduuid
ID миссии, которую дрон выполняет сейчас. null, если миссии нет
reasonstr
Почему остановка не применена
no_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_iduuidrequired
ID миссии
command_iduuidrequired
ID команды из задания
statusstrrequired
Состояние команды
started— Команда начата
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_iduuidrequired
ID миссии
trigger_iduuidrequired
ID триггера из задания
command_iduuid
Команда, которая выполнялась при срабатывании
actionstrrequired
Выполненное действие — action.type из задания
valuesobject
Значения, при которых сработало условие, — по манифесту триггера
fired_tsnumberrequired
Когда сработало условие
tsnumberrequired
Когда выполнено действие
{
"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 он уведомляет пользователей организации.