Skip to main content

Сервер → Дрон

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

1. mission​

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

Отправка миссии на дрон. Сервер передаёт задание в одном из двух форматов — по ПО дрона:

  • версия 2 — если на дроне запущен релиз ПО бортового компьютера с «Версией сообщения миссии» 2 (раздел «ПО» платформы). Признак — поле version: 2. Команды, параметры и поля миссии — под ключами манифестов ПО дрона. Формат — в разделе «Версия 2»;
  • версия 1 — в остальных случаях. Поля version нет. Формат описан ниже.

Версию сервер определяет для каждого дрона отдельно в момент отправки: дроны одной миссии могут получить разные форматы.

Версия 1​

mission_iduuidrequired
ID миссии
paramsArray[Param]required
Массив параметров миссии
param_iduuidrequired
ID параметра
namestr
Имя параметра
typestrrequired
Тип данных параметра
point
float
boolean
valueMixed
Значение параметра. Тип должен соответствовать params[i].type
commandsArray[Command]required
Массив команд для последовательного выполнения. Одновременно выполняется только одна команда
command_iduuidrequired
ID команды
command_typestrrequired
Тип команды
move_to— Движение к заданной точке
land— Приземлиться
takeoff— Взлететь
coverage— Маршрут по области
by_path— Движение по маршруту
scan_area— Сканирование области
manual_control— Ручной контроль
speedfloat
Скорость полёта (м/с)
conffloat
Порог уверенности детекции (0.0–1.0)
rec_video_droneboolean
Запись видео на борту дрона
rec_video_dist_thresholdfloat
Порог дистанции для начала записи видео
obstacle_avoidanceboolean
Включить обход препятствий для этой команды
trackerboolean
Включить AI-детекцию для этой команды
tracker_camerastr
Камера для AI-трекинга объектов
orthophotoboolean
Создание ортофотоплана
orthophoto_camerastr
Камера для съёмки ортофотоплана
pointsArray[Point]required
Точки маршрута
latfloatrequired
Широта
longfloatrequired
Долгота
heightfloat
Высота полёта (м)
triggersArray[Trigger]
Массив триггеров для переключения между командами
conditionstrrequired
Условие переключения. Используются переменные из params
command_idstrrequired
ID целевой команды для переключения
priorityintrequired
Приоритет триггера. Меньшее значение — более высокий приоритет
negative_zonesArray[NegativeZone]required
Запретные зоны. Поле есть всегда, без зон — пустой массив. ПО, работающее с версией 1, поле игнорирует. Формат — как в версии 2
{
"topic": "10001_mission",
"message": {
"mission_id": "abc-123",
"params": [],
"commands": [
{
"command_id": "cmd-456",
"command_type": "move_to",
"speed": 5.0,
"conf": 0.8,
"rec_video_drone": true,
"rec_video_dist_threshold": 0.0,
"obstacle_avoidance": true,
"tracker": false,
"tracker_camera": "",
"orthophoto": false,
"orthophoto_camera": "",
"points": [
{
"lat": 55.751244,
"long": 37.618423,
"height": 50.0
},
{
"lat": 55.752,
"long": 37.619,
"height": 50.0
}
]
}
],
"triggers": [],
"negative_zones": []
}
}

Версия 2​

Команды и их параметры, поля миссии и типы триггеров задаются манифестами ПО дрона. Сервер передаёт значения под ключами манифестов, которые действовали на дроне в момент создания миссии.

versionintrequired
Версия формата. Всегда 2
mission_iduuidrequired
ID миссии
mission_fieldsobjectrequired
Поля миссии этого дрона под ключами манифестов полей миссии и ключи платформы
gpsbooleanrequired
Есть ли у дрона GPS в этой миссии
home_positionPoint
Точка старта. Только при gps: false и заданной точке
latfloatrequired
Широта
longfloatrequired
Долгота
negative_zonesArray[NegativeZone]required
Запретные зоны: сначала зоны миссии, затем зоны организации. Без зон — пустой массив
iduuidrequired
ID зоны. Борт возвращает его в mission_cancelled, если обойти зону нельзя
sourcestrrequired
Откуда зона
mission— Зона этой миссии
no_fly_zone— Постоянная зона организации
namestr
Название. Только если задано
pointsArray[Point]required
Контур: не меньше трёх точек, первая точка в конце не повторяется. Зона действует на всех высотах
commandsArray[Command]required
Команды дрона по шагам миссии, по порядку
command_iduuidrequired
ID команды
command_typestrrequired
Имя команды из манифеста команды (commandName), например move_to, by_path, coverage, takeoff, land
indexintrequired
Номер шага в миссии, с 0
geometrystrrequired
Что лежит в points
point— Одна точка
line— Линия по точкам
path— Маршрут, рассчитанный платформой (например, по области)
polygon— Контур области — маршрут строит борт
none— Без точек
pointsArray[Point]required
Точки, без высоты. При geometry: none — пустой массив
latfloatrequired
Широта
longfloatrequired
Долгота
paramsobjectrequired
Параметры команды под ключами манифеста команды: общие параметры шага и поверх них параметры дрона (height, speed, exec_time, камеры и т. д.)
paramsArrayrequired
Всегда пустой массив
triggersArray[Trigger]required
Триггеры миссии, в которых участвует этот дрон. Без триггеров — пустой массив
trigger_iduuidrequired
ID триггера. Борт возвращает его в trigger_fired, mission_cancelled и mission_rejected
trigger_typestrrequired
Тип триггера из манифеста триггера ПО дрона (triggerName), например battery_below
paramsobjectrequired
Параметры условия под ключами манифеста триггера: общие и поверх них параметры дрона
priorityintrequired
Приоритет триггера
from_command_iduuid
Первая команда дрона, с которой триггер действует. null — на всю миссию
to_command_iduuid
Последняя команда дрона, до которой триггер действует. null — на всю миссию
max_firesint
Сколько раз триггер может сработать. null — без ограничения
cooldown_sintrequired
Пауза между срабатываниями, с
actionobjectrequired
Что делает борт при срабатывании
typestrrequired
Действие
goto_step— Перейти к команде command_id
pause— Пауза миссии
return_home— Возврат к точке старта
land— Посадка на месте
finish— Завершить миссию
notify— Только сообщить в trigger_fired
control_action— Опубликовать topic с payload — как действие управления оператора
applystr
Когда выполнить действие. Нет у notify
immediate— Сразу
after_current_command— После окончания текущей команды
command_iduuid
Только у goto_step: команда этого дрона в целевом шаге
topicstr
Только у control_action: полный топик {DRONE_ID}_{суффикс}. null, если действия уже нет в манифесте
payloadstr
Только у control_action: значение строкой. У кнопки — её значение, по умолчанию true
{
"topic": "10001_mission",
"message": {
"version": 2,
"mission_id": "01939ba1-fd8a-7ed4-acb1-35791c03c70d",
"mission_fields": {
"gps": true
},
"negative_zones": [
{
"id": "0193a0c2-1b2c-7d3e-8f40-5a6b7c8d9e0f",
"source": "no_fly_zone",
"name": "Склад",
"points": [
{ "lat": 55.7510, "long": 37.6170 },
{ "lat": 55.7515, "long": 37.6180 },
{ "lat": 55.7505, "long": 37.6185 }
]
}
],
"commands": [
{
"command_id": "0193a0c2-2a3b-7c4d-9e5f-6a7b8c9d0e1f",
"command_type": "takeoff",
"index": 0,
"geometry": "none",
"points": [],
"params": { "height": 10, "speed": 2 }
},
{
"command_id": "0193a0c2-3b4c-7d5e-8f60-7a8b9c0d1e2f",
"command_type": "move_to",
"index": 1,
"geometry": "point",
"points": [{ "lat": 55.751244, "long": 37.618423 }],
"params": { "height": 20, "speed": 8, "exec_time": 5 }
},
{
"command_id": "0193a0c2-4c5d-7e6f-9a70-8b9c0d1e2f3a",
"command_type": "land",
"index": 2,
"geometry": "none",
"points": [],
"params": {}
}
],
"params": [],
"triggers": [
{
"trigger_id": "0193a0c2-5d6e-7f80-8b91-9c0d1e2f3a4b",
"trigger_type": "battery_below",
"params": { "threshold": 40 },
"priority": 0,
"from_command_id": null,
"to_command_id": null,
"max_fires": 1,
"cooldown_s": 0,
"action": { "type": "return_home", "apply": "immediate" }
}
]
}
}

Ключи в params команды, в mission_fields и в params триггера задают манифесты ПО дрона, поэтому набор зависит от ПО. Параметры, нужные только платформе для расчёта маршрута (scanning_density, paths_strictly_in_poly), борту не передаются: маршрут уже в points.

Ответы борта на задание версии 2: mission_received, mission_rejected, command_status, trigger_fired, mission_completed, mission_cancelled, mission_aborted.


2. pause_mission​


---

## 2. pause_mission \{#pause_mission}

<TopicTag category="mission-control" />

- **MQTT Topic:** `{DRONE_ID}_pause_mission`
- **QoS:** 1

Управление паузой текущей миссии. При активации дрон зависает на месте и ожидает команду возобновления. При снятии паузы также сбрасывается ручной режим (hand_mode).

<ApiSchema>
<Field name="message" type="str" required description="Команда управления паузой" values={[
{ value: "on", label: "Поставить на паузу (удерживать текущее положение)" },
{ value: "off", label: "Возобновить выполнение миссии" },
]} />
</ApiSchema>

```json
{
"topic": "10001_pause_mission",
"message": "on"
}

3. cancel_mission​

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

Остановка миссии оператором или платформой.

Сервер передаёт ID миссии, которую нужно остановить. Борт останавливает только её; если дрон не выполняет миссию, выполняет другую или уже садится в точке старта после маршрута, борт отвечает cancel_rejected.

mission_iduuidrequired
ID миссии, которую нужно остановить
typestrrequired
Способ завершения миссии
BACK_TO_START— Возврат на точку старта (RTL)
ON_CURRENT_PLACE— Посадка на текущем месте (LAND)
{
"topic": "10001_cancel_mission",
"message": {
"mission_id": "01939ba1-fd8a-7ed4-acb1-35791c03c70d",
"type": "BACK_TO_START"
}
}

Без ID миссии сервер отправляет прежний формат — строку со способом завершения. Борт поддерживает оба формата.

{
"topic": "10001_cancel_mission",
"message": "BACK_TO_START"
}

Приём остановки борт подтверждает в data: status — returning или landing, status_reason — operator. Если за 10 секунд этого нет, сервер повторяет команду один раз. После посадки борт присылает mission_cancelled.


4. use_hand_mode​

Управление полётом
  • MQTT Topic: {DRONE_ID}_use_hand_mode
  • QoS: 1

Управление ручным режимом движения дрона. При активации миссия ставится на паузу, включается приём команд джойстика через joy_control, отключается обработка obstacle avoidance.

messagestrrequired
Режим управления
true— Ручной режим
false— Автоматический режим
{
"topic": "10001_use_hand_mode",
"message": "true"
}

5. gimbal_control​

Камера и подвес
  • MQTT Topic: {DRONE_ID}_gimbal_control
  • QoS: 1

Ручное управление подвесом камеры. Устанавливает значения roll, pitch, yaw и zoom для указанной камеры. Если активен автоматический режим, он автоматически отключается.

messageobjectrequired
Объект, где ключ — ID камеры, значение — параметры подвеса
{camera_id}objectrequired
Параметры подвеса для конкретной камеры
rollintrequired
Крен (1100–1900, центр 1500)
pitchintrequired
Тангаж (1100–1900, центр 1500)
yawintrequired
Рыскание (1100–1900, центр 1500)
zoomintrequired
Зум
0— Без зума
1+— Увеличение (максимальный зум задается характеристиками камеры)
{
"topic": "10001_gimbal_control",
"message": {
"camera_0": {
"roll": 0,
"pitch": -45,
"yaw": 180,
"zoom": 1
}
}
}

6. get_current_data​

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

Запрос текущего состояния всех модулей дрона. При получении true каждый подписанный модуль публикует своё текущее состояние: детекции, данные подвеса, статус слежения, статус удара.

Подписанные модули:

  • gimbal_data
  • drone_strike_status
  • drone_follow_status
  • actual_objects_data
  • download_info
  • transferring_info
  • current_model_tracking
messagebooleanrequired
Команда запроса
true— Запросить текущие данные
false— Нет действия
{
"topic": "10001_get_current_data",
"message": true
}

7. gimbal_auto_control​

Камера и подвес
  • MQTT Topic: {DRONE_ID}_gimbal_auto_control
  • QoS: 1

Управление автоматическим сканированием подвеса камеры.

statusstrrequired
Действие
start— Запустить автосканирование
stop— Остановить автосканирование
current— Запросить текущий статус
typestrrequired
Тип сканирования
sin— Синусоидальное движение
dynamic— Динамическое движение
none— Без типа (для current/stop)
camera_idstr
ID камеры для сканирования
{
"topic": "10001_gimbal_auto_control",
"message": {
"status": "start",
"type": "sin",
"camera_id": "camera_0"
}
}

8. joy_control​

Управление полётом
  • MQTT Topic: {DRONE_ID}_joy_control
  • QoS: 1

Команды джойстика для ручного управления дроном. Обрабатываются только при активном ручном режиме (use_hand_mode = true). Каждая команда состоит из направления и интенсивности (1–3).

messagestrrequired
Команда в формате direction_intensity
directionstrrequired
Направление движения
forward— Вперёд
back— Назад
left— Влево
right— Вправо
forward_left— Вперёд-влево
forward_right— Вперёд-вправо
back_left— Назад-влево
back_right— Назад-вправо
up— Вверх
down— Вниз
stop— Остановка
center— Нейтральное положение (зависание)
intensityintrequired
Интенсивность движения (1–3)
{
"topic": "10001_joy_control",
"message": "forward_2"
}

9. critical_disarm​

Управление полётом
  • MQTT Topic: {DRONE_ID}_critical_disarm
  • QoS: 1

Экстренное выключение моторов дрона. При получении true немедленно отправляется MAVLink-команда принудительного отключения, текущая миссия отменяется.

Команду публикует интерфейс оператора напрямую. Сервер подписан на этот же топик: фиксирует факт отправки с привязкой к миссии и переводит статус работоспособности дрона в critical. Автор команды в payload не передаётся. Борт после команды удерживает emergency landing и сообщает mission_aborted с причиной critical_disarm; снять состояние можно командой clear_emergency.

danger

Используется только в экстренных ситуациях. Дрон немедленно теряет тягу и падает.

messagebooleanrequired
Команда аварийного отключения
true— Немедленно отключить моторы
{
"topic": "10001_critical_disarm",
"message": true
}

10. obstacle_avoidance​

Управление полётом
  • MQTT Topic: {DRONE_ID}_obstacle_avoidance
  • QoS: 1

Включение/выключение системы обхода препятствий. При включении активируется obstacle_detector, drone_controller начинает реагировать на команды уклонения. Значение флага отображается в телеметрии (поле obstacle_avoidance).

messagebooleanrequired
Режим обхода препятствий
true— Включить обход препятствий
false— Выключить обход препятствий
{
"topic": "10001_obstacle_avoidance",
"message": true
}

11. sim_gps​

Управление полётом
  • MQTT Topic: {DRONE_ID}_sim_gps
  • QoS: 1

Симуляция GPS-координат для тестирования.

latfloatrequired
Широта
longfloatrequired
Долгота
altfloatrequired
Высота (м)
{
"topic": "10001_sim_gps",
"message": {
"lat": 55.75,
"long": 37.61,
"alt": 100
}
}

12. camera_tracking​

Камера и подвес
  • MQTT Topic: {DRONE_ID}_camera_tracking
  • QoS: 1

Выбор камеры, используемой для AI-трекинга объектов.

messagestrrequired
Идентификатор камеры для трекинга (например, camera_front, camera_0)
{
"topic": "10001_camera_tracking",
"message": "camera_front"
}

13. tracker​

Камера и подвес
  • MQTT Topic: {DRONE_ID}_tracker
  • QoS: 1

Глобальное включение или выключение AI-детекции объектов на видеопотоке.

messagebooleanrequired
Режим AI-детекции
true— Включить AI-детекцию
false— Выключить AI-детекцию
{
"topic": "10001_tracker",
"message": true
}

14. set_model_name​

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

Установка активной ML-модели для детекции объектов.

messagestrrequired
Имя файла модели (например, yolov8n.pt)
{
"topic": "10001_set_model_name",
"message": "yolov8n.pt"
}

15. get_drone_params​

Параметры дрона
  • MQTT Topic: {DRONE_ID}_get_drone_params
  • 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) в ответ на каждый payload и при выходе дрона на связь после offline или lost.

messageArray[str]required
Список имён запрашиваемых параметров
{
"topic": "10001_get_drone_params",
"message": [
"WPNAV_SPEED",
"WPNAV_SPEED_DN"
]
}

16. set_drone_params​

Параметры дрона
  • MQTT Topic: {DRONE_ID}_set_drone_params
  • QoS: 1

Установка значений параметров полётного контроллера (ArduPilot) дрона.

Помимо команд из редактора параметров, сервер сам записывает BATT_CAPACITY, когда он расходится с ёмкостью карточки батареи: при изменении карточки и при получении capacity_mah_fc в payload.

messageobjectrequired
Объект с параметрами: ключ — имя параметра, значение — новое значение
{
"topic": "10001_set_drone_params",
"message": {
"WPNAV_SPEED": 500,
"WPNAV_SPEED_DN": 150
}
}

17. get_calibration_data​

Калибровка
  • MQTT Topic: {DRONE_ID}_get_calibration_data
  • QoS: 1

Запрос текущих данных калибровки сенсоров дрона.

messagebooleanrequired
Команда запроса
true— Запросить данные калибровки
{
"topic": "10001_get_calibration_data",
"message": true
}

18. set_calibration​

Калибровка
  • MQTT Topic: {DRONE_ID}_set_calibration
  • QoS: 1

Запуск этапа калибровки датчиков дрона. При запуске калибровки акселерометра отключаются основные модули и активируется нода калибровки.

stepintrequired
Этап калибровки
0— Reboot
1— Accelerometer
2— Magnetometer
3— Other
paramintrequired
Параметр/ориентация (зависит от step). Accel: 0–6, Mag: 0–2, Other: 1–3, Reboot: 0–2
{
"topic": "10001_set_calibration",
"message": {
"step": 1,
"param": 0
}
}

19. get_check_motors​

Калибровка
  • MQTT Topic: {DRONE_ID}_get_check_motors
  • QoS: 1

Запрос текущих данных проверки моторов.

messagebooleanrequired
Команда запроса
true— Запросить данные моторов
{
"topic": "10001_get_check_motors",
"message": true
}

20. set_check_motors​

Калибровка
  • MQTT Topic: {DRONE_ID}_set_check_motors
  • QoS: 1

Запуск проверки моторов с указанным PWM-значением.

idintrequired
ID мотора
0— Все моторы
1–4— Конкретный мотор
valueintrequired
PWM-значение для проверки
{
"topic": "10001_set_check_motors",
"message": {
"id": 0,
"value": 1200
}
}

21. stream_url​

Камера и подвес
  • MQTT Topic: {DRONE_ID}_stream_url
  • QoS: 1

Передача URL видеопотока на дрон для конкретной камеры.

camera_idstrrequired
Идентификатор камеры
provider_urlstrrequired
URL видеопотока (RTSP/RTMP)
{
"topic": "10001_stream_url",
"message": {
"camera_id": "camera_0",
"provider_url": "rtsp://192.168.1.100:8554/stream"
}
}

22. drone_request_approve​

Регистрация
  • MQTT Topic: {DRONE_ID}_drone_request_approve
  • QoS: 1

Подтверждение запроса регистрации дрона. Приходит после одобрения заявки и в ответ на повторный drone_request_init уже одобренной заявки. Передаёт ключи для обмена с шифрованием — см. Шифрование сообщений.

public_keystrrequired
Открытый ключ сервера. Им дрон проверяет подпись сообщений сервера
aes_keystr
Ключ AES-256 для обмена с дроном, зашифрованный открытым ключом дрона из drone_request_init (RSA-OAEP, SHA-256), в base64. После расшифровки закрытым ключом дрона — hex-строка ключа (32 байта). Есть, только если дрон передал public_key

Дрон передал public_key:

{
"topic": "10001_drone_request_approve",
"message": {
"public_key": "MIIBIjANBgkqhki...",
"aes_key": "Q2lwaGVydGV4dC1leGFtcGxl..."
}
}

Дрон не передал public_key — обмен без шифрования:

{
"topic": "10001_drone_request_approve",
"message": {
"public_key": "MIIBIjANBgkqhki..."
}
}

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

Отправка ссылки для загрузки ML-модели на дрон. Опционально может содержать ссылку на файл с классами.

file_namestrrequired
Имя файла модели
file_linkstrrequired
URL для скачивания файла модели
classes_file_linkstr | null
URL для скачивания файла с классами (в формате .txt или .yaml). null — если файл классов не передаётся
tokenstrrequired
Токен авторизации для доступа к файлам

С файлом классов:

{
"topic": "10001_send_file_link",
"message": {
"file_name": "019cb80a-fb28-72e0-94a6-c50c5d9e79a5.rknn",
"file_link": "https://wheelies.ru/api/files/static/application/00c643de-7f97-4cfe-a37f-939cd82ee3ba.rknn",
"classes_file_link": "https://wheelies.ru/api/files/static/text/67f4e943-ebb0-4fba-ad7c-8dee8d8130e9.txt",
"token": "eyJhbGciOiJIUzI1..."
}
}

Без файла классов:

{
"topic": "10001_send_file_link",
"message": {
"file_name": "019c9faa-7880-738c-a301-3d4b3b27f770.pt",
"file_link": "https://dev.wheelies.ru/api/files/static/application/f4a5373a-968e-41ed-b774-8022f9c74b8f.pt",
"classes_file_link": null,
"token": "eyJhbGciOiJ..."
}
}

24. delete_model​

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

Удаление ML-моделей с дрона. Сообщение — массив имён файлов для удаления.

messageArray[str]required
Список имён файлов моделей для удаления
{
"topic": "10001_delete_model",
"message": [
"model_v1.pt",
"model_v2.pt"
]
}

25. follow_track_object​

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

Управление слежением камеры за объектом (трекинг).

statusstrrequired
Действие
start— Начать слежение
stop— Прекратить слежение
current— Запросить текущий статус
track_idstrrequired
ID отслеживаемого объекта
class_namestrrequired
Класс объекта (например, car, person)
zoom_statusstr
Режим автозума
enable— Автозум включён
disenable— Автозум выключен
zoom_meanfloat
Целевое среднее значение зума (1.0–15.0)
{
"topic": "10001_follow_track_object",
"message": {
"status": "start",
"track_id": "42",
"class_name": "car",
"zoom_status": "enable",
"zoom_mean": 5.0
}
}

26. drone_strike_object​

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

Управление тараном объекта дроном.

statusstrrequired
Действие
start— Начать таран
stop— Прекратить таран
track_idstrrequired
ID объекта для тарана
class_namestrrequired
Класс объекта
{
"topic": "10001_drone_strike_object",
"message": {
"status": "start",
"track_id": "42",
"class_name": "car"
}
}

27. drone_follow_object​

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

Управление следованием дрона за объектом. Дрон физически перемещается за целью, удерживая дистанцию. При запуске автоматически останавливается режим тарана (drone_strike_object), если он был активен.

statusstrrequired
Действие
start— Начать следование
stop— Прекратить следование
track_idstrrequired
ID объекта
class_namestrrequired
Класс объекта
{
"topic": "10001_drone_follow_object",
"message": {
"status": "start",
"track_id": "42",
"class_name": "person"
}
}

28. registration_check_result​

Регистрация
  • MQTT Topic: {DRONE_ID}_registration_check_result
  • QoS: 1

Отправка результата проверки регистрации дрона в системе.

messagebooleanrequired
Результат проверки
true— Регистрация подтверждена, дрон продолжает запуск
false— Регистрация не подтверждена, запускается процесс регистрации
{
"topic": "10001_registration_check_result",
"message": true
}

29. create_orthophoto​

Ортофото
  • MQTT Topic: {DRONE_ID}_create_orthophoto
  • QoS: 1

Ответ сервера на create_orthophoto_request. Содержит адрес и токен, по которым дрон загружает снимки для построения ортофотоплана. Ортофотоплан строится на сервере и дрону не возвращается.

request_idstrrequired
ID запроса из `create_orthophoto_request`
urlstrrequired
Адрес загрузки снимков: `POST` `multipart/form-data`, поле `file` — zip-архив снимков; необязательные поля `mission_id` и `command_id` — миссия и команда, при выполнении которой сделаны снимки
tokenstrrequired
Токен дрона для авторизации запроса загрузки. Передаётся без префикса, дрон отправляет его в заголовке `Authorization: Bearer <token>`
{
"topic": "10001_create_orthophoto",
"message": {
"request_id": "ortho-001",
"url": "https://example.com/api/map/orthophotoplan/from-drone",
"token": "eyJhbGciOi..."
}
}

Без mission_id и command_id ортофотоплан строится вне миссии (notMission), в режиме «3D и 2D».


30. transferring_to_tensorRT​

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

Управление конвертацией ML-модели из формата .pt в формат .engine (TensorRT) на дроне. Поддерживает запрос текущего статуса, запуск и остановку конвертации.

statusstrrequired
Действие
current— Запросить текущий статус конвертации
start— Начать конвертацию модели
stop— Остановить конвертацию модели
model_namestr
Имя файла модели (обязательно при status=start и status=stop)

Запрос текущего статуса:

{
"topic": "10001_transferring_to_tensorRT",
"message": {
"status": "current"
}
}

Запуск конвертации:

{
"topic": "10001_transferring_to_tensorRT",
"message": {
"status": "start",
"model_name": "yolov8s.pt"
}
}

Остановка конвертации:

{
"topic": "10001_transferring_to_tensorRT",
"message": {
"status": "stop",
"model_name": "yolov8s.pt"
}
}

31. drop_servo​

Сброс
  • MQTT Topic: {DRONE_ID}_drop_servo
  • QoS: 1

Команда сброса сервопривода. Активирует механизм сброса груза (серво возвращается в исходное положение).

messagestrrequired
Команда сброса сервопривода
true— Выполнить сброс серво
{
"topic": "10001_drop_servo",
"message": "true"
}

Робот
  • MQTT Topic: {DRONE_ID}_send_audio_link
  • QoS: 1

Отправка ссылки на аудиофайл для голосового пайплайна робота. Робот скачивает файл и запускает цепочку обработки: распознавание речи (Whisper) → генерация ответа (LLM) → синтез речи (TTS) → воспроизведение. Также используется для запроса текущего состояния при перезагрузке страницы.

file_namestr
Имя аудиофайла
file_linkstr
URL для скачивания аудиофайла
tokenstr
Токен авторизации для доступа к файлу
statusstr
Запрос текущего состояния
current— Запросить текущее состояние всех топиков голосового пайплайна

Отправка аудиофайла:

{
"topic": "10001_send_audio_link",
"message": {
"file_name": "123434.wav",
"file_link": "https://dev.wheelies.ru/audio/123434.wav",
"token": "abc12345"
}
}

Запрос текущего состояния:

{
"topic": "10001_send_audio_link",
"message": {
"status": "current"
}
}

33. lep_control​

ЛЭП
  • MQTT Topic: {DRONE_ID}_lep_control
  • QoS: 1

Управление полётом вдоль ЛЭП и инспекцией столбов. Включает постановку дрона над линией, запуск/остановку полёта вдоль столбов и запрос текущего состояния.

actionstrrequired
Команда управления
current— Запрос текущего статуса всех подсистем ЛЭП
placement_enable— Включить постановку дрона над ЛЭП (поиск 2 столбов гимбал-камерой)
placement_start— Начать постановку (выравнивание, центрирование, снижение)
placement_stop— Остановить постановку (дрон зависает, возврат в состояние ready)
placement_disable— Выключить постановку (деактивация lep_placement)
enable— Включить полёт вдоль ЛЭП + инспекцию столбов
disable— Выключить полёт вдоль ЛЭП (деактивация всех нод ЛЭП)

Запрос текущего статуса:

{
"topic": "10001_lep_control",
"message": {
"action": "current"
}
}

Включить постановку:

{
"topic": "10001_lep_control",
"message": {
"action": "placement_enable"
}
}

Начать постановку:

{
"topic": "10001_lep_control",
"message": {
"action": "placement_start"
}
}

Остановить постановку:

{
"topic": "10001_lep_control",
"message": {
"action": "placement_stop"
}
}

Выключить постановку:

{
"topic": "10001_lep_control",
"message": {
"action": "placement_disable"
}
}

Включить полёт вдоль ЛЭП + инспекцию:

{
"topic": "10001_lep_control",
"message": {
"action": "enable"
}
}

Выключить полёт вдоль ЛЭП:

{
"topic": "10001_lep_control",
"message": {
"action": "disable"
}
}

34. asset_config​

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

Отправка конфигурации аппаратных компонентов с сервера на дрон, включая характеристики и пороги заряда системы питания.

Когда отправляется:

  • в ответ на каждый payload — борт публикует его при каждом старте стека;
  • при изменении оборудования дрона, характеристик или порогов батареи, а также модели батареи, установленной на дроне.

Сообщение retained и каждый раз отправляется целиком: брокер отдаёт борту последнюю конфигурацию при переподключении, даже если сервер в этот момент недоступен.

Значения из asset_config заменяют собственные источники борта — BATT_CAPACITY, автоопределение числа ячеек, состав по умолчанию и пороги 30 / 15.

camerasobject
Список камер
camera_<index>object
Камера (key = short_id)
idstr
UUID камеры
horizontal_fovfloat
Горизонтальный угол обзора (FOV)
mounting_typestr
Тип крепления (fixed/gimbal/etc.)
zoom_typestr
Тип зума (digital/optical)
zoom_ratioint
Кратность зума
resolution_xint
Разрешение по X
resolution_yint
Разрешение по Y
sd_cardobject
Конфигурация SD-карты
idstr
UUID карты памяти
batteriesobject
Система питания дрона. Пустой объект, если батарей нет или у батарей дрона различаются число ячеек или химический состав — тогда борт работает по собственным источникам
battery_0object
Единственная запись — вся система питания: полётный контроллер измеряет батареи, включённые параллельно, как один источник. Записи с другими ключами борт пропускает
capacity_mahint
Ёмкость (мА·ч) — сумма по всем батареям дрона. null, если ёмкость хотя бы одной неизвестна
cell_countint
Число ячеек одного пакета, не суммируется
chemical_compositionstr
Химический состав, общий для батарей. Сопоставление с написанием борта выполняет борт
liPo— LiPo
liHv— LiHV
liIon— Li-Ion
low_percentint
Порог низкого заряда, %: при нём дрон возвращается на точку старта. 30–99, по умолчанию 30. Не передаётся, если пара порогов некорректна
critical_percentint
Порог критического заряда, %: при нём дрон садится на месте. 15–98 и ниже low_percent, по умолчанию 15. Не передаётся вместе с low_percent
servosobject
Список сервоприводов
servo_<index>object
Серво (key = short_id)
idstr
UUID сервопривода
{
"topic": "10001_asset_config",
"message": {
"cameras": {
"camera_0": {
"id": "c2a11d4f-9b88-4a12-8f21-77a9d1c3b101",
"horizontal_fov": 82.5,
"mounting_type": "gimbal",
"zoom_type": "optical",
"zoom_ratio": 3,
"resolution_x": 4056,
"resolution_y": 3040
},
"camera_1": {
"id": "a91c22fe-11aa-4c77-9d88-88bb33cc44dd",
"horizontal_fov": 120.0,
"mounting_type": "fixed",
"zoom_type": "digital",
"zoom_ratio": 2,
"resolution_x": 1920,
"resolution_y": 1080
}
},

"sd_card": {
"id": "f11a22bb-3344-5566-7788-99aabbccdde1"
},

"batteries": {
"battery_0": {
"capacity_mah": 32000,
"cell_count": 6,
"chemical_composition": "liPo",
"low_percent": 35,
"critical_percent": 15
}
},

"servos": {
"servo_0": {
"id": "s1112222-aaaa-bbbb-cccc-000011112222"
},
"servo_1": {
"id": "s3334444-aaaa-bbbb-cccc-999988887777"
}
}
}
}

35. update_software​

ПО
  • MQTT Topic: {DRONE_ID}_update_software
  • QoS: 1

Отправка команды обновления программного обеспечения на дрон.

installation_idstringrequired
Идентификатор операции установки из таблицы `software_installation`
updated_software_release_idstringrequired
Идентификатор текущего релиза обновляемого ПО
target_software_release_idstringrequired
Идентификатор релиза новой версии ПО, которая должна быть установлена
image_tagstringrequired
Тег Docker-образа в формате `{companion_computer_model}-{target_version}`
{
"topic": "10001_update_software",
"message": {
"installation_id": "8f4d3c21-6f5d-4a31-bd93-12c3f0f7a8d1",
"updated_software_release_id": "f2c7b8e9-1a2b-4c3d-8e9f-123456789abc",
"target_software_release_id": "9d8c7b6a-5e4f-3a2b-1c0d-fedcba987654",
"image_tag": "jetson-2.5.1"
}
}

Переменная пина — запись на платформе, связывающая код переменной с пином платы дрона. Выходная переменная (direction: "out") — управляющее воздействие, входная ("in") — показание датчика. Платформа передаёт борту полный набор активных переменных (variables_config), значения выходных переменных (pin_var_{code}), борт подтверждает применение и возвращает значения в телеметрии (data.custom).

36. variables_config​

Переменные пинов
  • MQTT Topic: {DRONE_ID}_variables_config
  • QoS: 1, retained

Конфигурация переменных пинов дрона: полный актуальный набор активных переменных. Борт заменяет свой маппинг «код → пин» целиком и отвечает в variables_config_status.

config_versionintrequired
Версия набора переменных дрона. Растёт на единицу только при изменении содержимого `variables`; повторная отправка того же набора сохраняет номер
variablesArray[object]required
Активные неудалённые переменные дрона, по возрастанию `code`. Пустой массив — переменных нет
codestrrequired
Код переменной, уникален в рамках дрона. Суффикс топика `pin_var_{code}` и ключ в `data.custom`
directionstrrequired
Направление переменной
in— Входная — показание датчика
out— Выходная — управляющее воздействие
data_typestrrequired
Тип данных значения
boolean
number
string
enum
connected_tostrrequired
Плата, к которой подключена переменная
fc— Полётный контроллер
bc— Бортовой компьютер
board_modelstr
Модель платы из `connected_to`: при `fc` — модель полётного контроллера, при `bc` — бортового компьютера, как их прислал дрон в `payload` / `drone_request_init`. Нет, если модель неизвестна
portstr
Обозначение порта на плате по её документации, например `AUX`, `GPIO40`
connection_typestrrequired
Тип подключения
pwm— PWM
i2c— I2C
uart— UART
can— CAN
pinsobjectrequired
Номера пинов: `pwm` — `pin`; `i2c` — `sda`, `scl`; `uart` и `can` — `rx`, `tx`. Целые неотрицательные, попарно различные
busstr
Только `i2c` и `can`: идентификатор шины — для I2C на Linux обычно `i2c-1`, для CAN — имя интерфейса
device_addressstr
Только `i2c` и `can`: адрес устройства на шине, например `0x48`
default_valueboolean | number | str
Значение по умолчанию в типе `data_type`: `false`, а не строка с текстом false
has_stateboolean
Только `out`: борт возвращает состояние переменной в `data.custom`. Если не задано на платформе — `true` для всех элементов управления, кроме кнопки
paramsobject
Только `out`: настроечные параметры воздействия «код параметра → значение», одинаковы для всех нажатий. Передаются только параметры с заданным значением
unitstr
Единица измерения
minnumber
Только `out`: нижняя граница значения
maxnumber
Только `out`: верхняя граница значения, если задана числом. Граница из значения другой переменной на борт не передаётся
enum_valuesArray[str]
Только при `data_type: enum`: допустимые значения
{
"topic": "10001_variables_config",
"message": {
"config_version": 7,
"variables": [
{
"code": "water_level",
"direction": "in",
"data_type": "number",
"connected_to": "bc",
"board_model": "Jetson Orin Nano",
"port": "GPIO40",
"connection_type": "i2c",
"pins": { "sda": 3, "scl": 5 },
"bus": "i2c-1",
"device_address": "0x48",
"unit": "l"
},
{
"code": "water_valve",
"direction": "out",
"data_type": "boolean",
"connected_to": "fc",
"board_model": "Pixhawk 6C",
"port": "AUX",
"connection_type": "pwm",
"pins": { "pin": 5 },
"default_value": false,
"has_state": true,
"params": { "volume_l": 4, "pressure_bar": 2 }
}
]
}
}

Когда сервер отправляет конфигурацию:

  • при создании дрона и одобрении заявки на регистрацию;
  • после создания, изменения, удаления, восстановления, активации, деактивации и сброса к значениям модели любой переменной дрона;
  • при смене модели бортового компьютера или полётного контроллера в payload;
  • перед каждой отправкой значения в pin_var_{code};
  • в ответ на get_variables_config.

Особенности:

  • Конфигурация публикуется, только если содержимое изменилось. Исключение — ответ на get_variables_config: он публикуется всегда, с прежним номером версии.
  • Неактивные и удалённые переменные в набор не попадают, признака активности в элементе нет.
  • Переменная, значение по умолчанию которой не приводится к data_type, в набор не попадает.
  • Пустые поля не передаются — ключ отсутствует, а не приходит с null.
  • Борт игнорирует неизвестные поля: контракт расширяется без новой прошивки.
  • Конфигурация применяется целиком или отклоняется целиком, частичного применения нет. Борт отбрасывает сообщение с config_version меньше уже применённой.
  • Для i2c и can устройство адресуется парой bus + device_address, port и pins — справочные. Формат записи port, bus и device_address окончательно согласуется после стендовых проверок.

37. pin_var_{code}​

Переменные пинов
  • MQTT Topic: {DRONE_ID}_pin_var_{code}, например 10001_pin_var_water_valve; борт подписывается по шаблону {DRONE_ID}_pin_var_{code}
  • QoS: 1

Значение выходной переменной пина. Борт находит переменную по суффиксу топика в применённой конфигурации variables_config и подаёт значение на её пин.

request_iduuidrequired
Идентификатор запроса: по нему борт отвечает в `variables_status` и распознаёт повторную доставку
config_versionintrequired
Версия конфигурации, по которой сформирована команда. Не совпадает с применённой на борту — отказ `stale_config`
tsintrequired
Время формирования команды, Unix-время в секундах
expires_atintrequired
Момент, после которого команду исполнять нельзя, Unix-время в секундах. Сейчас `ts + 30`
valueboolean | number | strrequired
Значение в типе `data_type` переменной; у `enum` — одно из `enum_values`
{
"topic": "10001_pin_var_water_valve",
"message": {
"request_id": "8f3c2b1a-4d5e-4f60-9a7b-1c2d3e4f5a6b",
"config_version": 7,
"ts": 1758700000,
"expires_at": 1758700030,
"value": true
}
}

Особенности:

  • Перед отправкой сервер проверяет: переменная активна и выходная, значение в её типе и в числовых границах min / max.
  • params в сообщении не передаётся: настроечные параметры приходят в variables_config.
  • Тип данных и единица измерения в сообщении не передаются — борт знает их по коду из конфигурации.
  • Борт отклоняет просроченную команду (expired) по собственному времени и не исполняет повторно команду с уже обработанным request_id, отвечая прежним результатом.
  • Результат воздействия борт возвращает в variables_status.
  • Ранее существовавшей публикации строкового значения в pin_var_{code} с интерфейса больше нет: значение всегда приходит JSON-объектом указанного формата.

38. clear_emergency​

Управление полётом
  • MQTT Topic: {DRONE_ID}_clear_emergency
  • QoS: 1

Сброс аварийного состояния на борту. После critical_disarm или аварии полётного контроллера борт удерживает статус emergency landing до старта следующей миссии, а платформа не допускает такой дрон к миссии. Команда снимает это состояние без перезапуска бортового компьютера.

messagebooleanrequired
Команда сброса
true— Снять аварийное состояние
{
"topic": "10001_clear_emergency",
"message": true
}

Поведение борта:

  • если дрон на земле и моторы заглушены — снимает флаги аварии и публикует статус online в data;
  • в полёте команда игнорируется.

Сервер отправляет команду, когда пользователь подтверждает исправность дрона после происшествия, если дрон на связи, и отдельным действием «Сбросить аварийное состояние на борту».