Сервер → Дрон
Топики для передачи команд и данных от сервера к дрону.
1. mission
Миссии- MQTT Topic:
{DRONE_ID}_mission - QoS: 1
Отправка миссии на дрон. Сервер передаёт задание в одном из двух форматов — по ПО дрона:
- версия 2 — если на дроне запущен релиз ПО бортового компьютера с «Версией сообщения
миссии» 2 (раздел «ПО» платформы). Признак — поле
version: 2. Команды, параметры и поля миссии — под ключами манифестов ПО дрона. Формат — в разделе «Версия 2»; - версия 1 — в остальных случаях. Поля
versionнет. Формат описан ниже.
Версию сервер определяет для каждого дрона отдельно в момент отправки: дроны одной миссии могут получить разные форматы.
Версия 1
mission_iduuidrequiredparamsArray[Param]requiredparam_iduuidrequirednamestrtypestrrequiredpointfloatbooleanvalueMixedcommandsArray[Command]requiredcommand_iduuidrequiredcommand_typestrrequiredmove_to— Движение к заданной точкеland— Приземлитьсяtakeoff— Взлететьcoverage— Маршрут по областиby_path— Движение по маршрутуscan_area— Сканирование областиmanual_control— Ручной контрольspeedfloatconffloatrec_video_dronebooleanrec_video_dist_thresholdfloatobstacle_avoidancebooleantrackerbooleantracker_camerastrorthophotobooleanorthophoto_camerastrpointsArray[Point]requiredlatfloatrequiredlongfloatrequiredheightfloattriggersArray[Trigger]conditionstrrequiredcommand_idstrrequiredpriorityintrequirednegative_zonesArray[NegativeZone]required{
"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
Команды и их параметры, поля миссии и типы триггеров задаются манифестами ПО дрона. Сервер передаёт значения под ключами манифестов, которые действовали на дроне в момент создания миссии.
versionintrequiredmission_iduuidrequiredmission_fieldsobjectrequiredgpsbooleanrequiredhome_positionPointlatfloatrequiredlongfloatrequirednegative_zonesArray[NegativeZone]requirediduuidrequiredsourcestrrequiredmission— Зона этой миссииno_fly_zone— Постоянная зона организацииnamestrpointsArray[Point]requiredcommandsArray[Command]requiredcommand_iduuidrequiredcommand_typestrrequiredindexintrequiredgeometrystrrequiredpoint— Одна точкаline— Линия по точкамpath— Маршрут, рассчитанный платформой (например, по области)polygon— Контур области — маршрут строит бортnone— Без точекpointsArray[Point]requiredlatfloatrequiredlongfloatrequiredparamsobjectrequiredparamsArrayrequiredtriggersArray[Trigger]requiredtrigger_iduuidrequiredtrigger_typestrrequiredparamsobjectrequiredpriorityintrequiredfrom_command_iduuidto_command_iduuidmax_firesintcooldown_sintrequiredactionobjectrequiredtypestrrequiredgoto_step— Перейти к команде command_idpause— Пауза миссииreturn_home— Возврат к точке стартаland— Посадка на местеfinish— Завершить миссиюnotify— Только сообщить в trigger_firedcontrol_action— Опубликовать topic с payload — как действие управления оператораapplystrimmediate— Сразуafter_current_command— После окончания текущей командыcommand_iduuidtopicstrpayloadstr{
"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_iduuidrequiredtypestrrequiredBACK_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.
messagestrrequiredtrue— Ручной режимfalse— Автоматический режим{
"topic": "10001_use_hand_mode",
"message": "true"
}
5. gimbal_control
Камера и подвес- MQTT Topic:
{DRONE_ID}_gimbal_control - QoS: 1
Ручное управление подвесом камеры. Устанавливает значения roll, pitch, yaw и zoom для указанной камеры. Если активен автоматический режим, он автоматически отключается.
messageobjectrequired{camera_id}objectrequiredrollintrequiredpitchintrequiredyawintrequiredzoomintrequired0— Без зума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
messagebooleanrequiredtrue— Запросить текущие данныеfalse— Нет действия{
"topic": "10001_get_current_data",
"message": true
}
7. gimbal_auto_control
Камера и подвес- MQTT Topic:
{DRONE_ID}_gimbal_auto_control - QoS: 1
Управление автоматическим сканированием подвеса камеры.
statusstrrequiredstart— Запустить автосканированиеstop— Остановить автосканированиеcurrent— Запросить текущий статусtypestrrequiredsin— Синусоидальное движениеdynamic— Динамическое движениеnone— Без типа (для current/stop)camera_idstr{
"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).
messagestrrequireddirectionstrrequiredforward— Вперёдback— Назадleft— Влевоright— Вправоforward_left— Вперёд-влевоforward_right— Вперёд-вправоback_left— Назад-влевоback_right— Назад-вправоup— Вверхdown— Внизstop— Остановкаcenter— Нейтральное положение (зависание)intensityintrequired{
"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.
Используется только в экстренных ситуациях. Дрон немедленно теряет тягу и падает.
messagebooleanrequiredtrue— Немедленно отключить моторы{
"topic": "10001_critical_disarm",
"message": true
}
10. obstacle_avoidance
Управление полётом- MQTT Topic:
{DRONE_ID}_obstacle_avoidance - QoS: 1
Включение/выключение системы обхода препятствий. При включении активируется obstacle_detector, drone_controller начинает реагировать на команды уклонения. Значение флага отображается в телеметрии (поле obstacle_avoidance).
messagebooleanrequiredtrue— Включить обход препятствийfalse— Выключить обход препятствий{
"topic": "10001_obstacle_avoidance",
"message": true
}
11. sim_gps
Управление полётом- MQTT Topic:
{DRONE_ID}_sim_gps - QoS: 1
Симуляция GPS-координат для тестирования.
latfloatrequiredlongfloatrequiredaltfloatrequired{
"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{
"topic": "10001_camera_tracking",
"message": "camera_front"
}
13. tracker
Камера и подвес- MQTT Topic:
{DRONE_ID}_tracker - QoS: 1
Глобальное включение или выключение AI-детекции объектов на видеопотоке.
messagebooleanrequiredtrue— Включить AI-детекциюfalse— Выключить AI-детекцию{
"topic": "10001_tracker",
"message": true
}
14. set_model_name
ML-модели- MQTT Topic:
{DRONE_ID}_set_model_name - QoS: 1
Установка активной ML-модели для детекции объектов.
messagestrrequired{
"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
Запрос текущих данных калибровки сенсоров дрона.
messagebooleanrequiredtrue— Запросить данные калибровки{
"topic": "10001_get_calibration_data",
"message": true
}
18. set_calibration
Калибровка- MQTT Topic:
{DRONE_ID}_set_calibration - QoS: 1
Запуск этапа калибровки датчиков дрона. При запуске калибровки акселерометра отключаются основные модули и активируется нода калибровки.
stepintrequired0— Reboot1— Accelerometer2— Magnetometer3— Otherparamintrequired{
"topic": "10001_set_calibration",
"message": {
"step": 1,
"param": 0
}
}
19. get_check_motors
Калибровка- MQTT Topic:
{DRONE_ID}_get_check_motors - QoS: 1
Запрос текущих данных проверки моторов.
messagebooleanrequiredtrue— Запросить данные моторов{
"topic": "10001_get_check_motors",
"message": true
}
20. set_check_motors
Калибровка- MQTT Topic:
{DRONE_ID}_set_check_motors - QoS: 1
Запуск проверки моторов с указанным PWM-значением.
idintrequired0— Все моторы1–4— Конкретный моторvalueintrequired{
"topic": "10001_set_check_motors",
"message": {
"id": 0,
"value": 1200
}
}
21. stream_url
Камера и подвес- MQTT Topic:
{DRONE_ID}_stream_url - QoS: 1
Передача URL видеопотока на дрон для конкретной камеры.
camera_idstrrequiredprovider_urlstrrequired{
"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_keystrrequiredaes_keystrДрон передал 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..."
}
}
23. send_file_link
ML-модели- MQTT Topic:
{DRONE_ID}_send_file_link - QoS: 1
Отправка ссылки для загрузки ML-модели на дрон. Опционально может содержать ссылку на файл с классами.
file_namestrrequiredfile_linkstrrequiredclasses_file_linkstr | nulltokenstrrequiredС файлом классов:
{
"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
Управление слежением камеры за объектом (трекинг).
statusstrrequiredstart— Начать слежениеstop— Прекратить слежениеcurrent— Запросить текущий статусtrack_idstrrequiredclass_namestrrequiredzoom_statusstrenable— Автозум включёнdisenable— Автозум выключенzoom_meanfloat{
"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
Управление тараном объекта дроном.
statusstrrequiredstart— Начать таранstop— Прекратить таранtrack_idstrrequiredclass_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), если он был активен.
statusstrrequiredstart— Начать следованиеstop— Прекратить следованиеtrack_idstrrequiredclass_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
Отправка результата проверки регистрации дрона в системе.
messagebooleanrequiredtrue— Регистрация подтверждена, дрон продолжает запускfalse— Регистрация не подтверждена, запускается процесс регистрации{
"topic": "10001_registration_check_result",
"message": true
}
29. create_orthophoto
Ортофото- MQTT Topic:
{DRONE_ID}_create_orthophoto - QoS: 1
Ответ сервера на create_orthophoto_request. Содержит адрес и токен, по которым дрон загружает снимки для построения ортофотоплана. Ортофотоплан строится на сервере и дрону не возвращается.
request_idstrrequiredurlstrrequiredtokenstrrequired{
"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) на дроне. Поддерживает запрос текущего статуса, запуск и остановку конвертации.
statusstrrequiredcurrent— Запросить текущий статус конвертацииstart— Начать конвертацию моделиstop— Остановить конвертацию моделиmodel_namestrЗапрос текущего статуса:
{
"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
Команда сброса сервопривода. Активирует механизм сброса груза (серво возвращается в исходное положение).
messagestrrequiredtrue— Выполнить сброс серво{
"topic": "10001_drop_servo",
"message": "true"
}
32. send_audio_link
Робот- MQTT Topic:
{DRONE_ID}_send_audio_link - QoS: 1
Отправка ссылки на аудиофайл для голосового пайплайна робота. Робот скачивает файл и запускает цепочку обработки: распознавание речи (Whisper) → генерация ответа (LLM) → синтез речи (TTS) → воспроизведение. Также используется для запроса текущего состояния при перезагрузке страницы.
file_namestrfile_linkstrtokenstrstatusstrcurrent— Запросить текущее состояние всех топиков голосового пайплайнаОтправка аудиофайла:
{
"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
Управление полётом вдоль ЛЭП и инспекцией столбов. Включает постановку дрона над линией, запуск/остановку полёта вдоль столбов и запрос текущего состояния.
actionstrrequiredcurrent— Запрос текущего статуса всех подсистем ЛЭП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.
camerasobjectcamera_<index>objectidstrhorizontal_fovfloatmounting_typestrzoom_typestrzoom_ratiointresolution_xintresolution_yintsd_cardobjectidstrbatteriesobjectbattery_0objectcapacity_mahintcell_countintchemical_compositionstrliPo— LiPoliHv— LiHVliIon— Li-Ionlow_percentintcritical_percentintservosobjectservo_<index>objectidstr{
"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_idstringrequiredupdated_software_release_idstringrequiredtarget_software_release_idstringrequiredimage_tagstringrequired{
"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_versionintrequiredvariablesArray[object]requiredcodestrrequireddirectionstrrequiredin— Входная — показание датчикаout— Выходная — управляющее воздействиеdata_typestrrequiredbooleannumberstringenumconnected_tostrrequiredfc— Полётный контроллерbc— Бортовой компьютерboard_modelstrportstrconnection_typestrrequiredpwm— PWMi2c— I2Cuart— UARTcan— CANpinsobjectrequiredbusstrdevice_addressstrdefault_valueboolean | number | strhas_statebooleanparamsobjectunitstrminnumbermaxnumberenum_valuesArray[str]{
"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_iduuidrequiredconfig_versionintrequiredtsintrequiredexpires_atintrequiredvalueboolean | number | strrequired{
"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 до старта следующей миссии, а платформа не допускает такой
дрон к миссии. Команда снимает это состояние без перезапуска бортового компьютера.
messagebooleanrequiredtrue— Снять аварийное состояние{
"topic": "10001_clear_emergency",
"message": true
}
Поведение борта:
- если дрон на земле и моторы заглушены — снимает флаги аварии и публикует статус
onlineвdata; - в полёте команда игнорируется.
Сервер отправляет команду, когда пользователь подтверждает исправность дрона после происшествия, если дрон на связи, и отдельным действием «Сбросить аварийное состояние на борту».