Жизненный цикл дрона
Раздел описывает, в каком порядке дрон, сервер и веб-интерфейс обмениваются сообщениями: от первого запуска ПО дрона до завершения миссии. Поля каждого топика здесь не повторяются — они описаны в API Server-Drone v3.0; в тексте имя топика ведёт на его описание.
Поведение платформы и борта на API v3.0. Изменения, которые уже согласованы с командой ПО дрона, но ещё не вошли в описание v3.0, отмечены блоком «Согласовано».
Участники
| Участник | Что это | Как общается |
|---|---|---|
| Дрон | ПО на бортовом компьютере дрона | MQTT: публикует события и телеметрию, подписан на команды |
| Сервер | Платформа Wheelies: MQTT-брокер и обработка сообщений | MQTT с дроном, REST и WebSocket с клиентом |
| Клиент | Веб-интерфейс платформы, которым пользуется оператор | REST API (Management API) и WebSocket |
| АРМ | Приложение на ноутбуке оператора для работы с дронами без интернета (АРМ) | С дроном — по локальной сети; с сервером — по HTTPS, когда есть интернет |
Все топики дрона имеют вид {DRONE_ID}_{topic_name}, где DRONE_ID — идентификатор дрона на
платформе. Без префикса публикуются только check_registration, drone_request_init и
drone_request_complete.
Дрон работает с платформой в одном из двух режимов, их выбирают при установке ПО дрона (пункт меню «Режим подключения»):
- Онлайн-платформа — дрон подключается к MQTT-брокеру сервера через интернет. Этот режим описан в разделе целиком.
- АРМ — дрон подключается к АРМ по локальной сети, интернет после установки не нужен. Как АРМ связан с сервером — в разделе Подключение через АРМ.
У клиента два пути к дрону:
- Через сервер. Клиент вызывает REST, сервер проверяет условия, меняет свои данные и сам публикует команду дрону. Так работают создание миссии, пауза, остановка, снятие аварийного статуса.
- Напрямую через прокси. Клиент подписывается на топики дрона и публикует команды через
WebSocket-прокси сервера. Сервер проверяет только доступ пользователя к дрону и передаёт сообщение
брокеру как есть. Так работают телеметрия на странице миссии, джойстик, подвес, слежение,
critical_disarm. Для борта такие команды неотличимы от команд сервера.
Фазы
| Фаза | Страница | Основные топики |
|---|---|---|
| Проверка регистрации, активация | Регистрация и подключение | check_registration, drone_request_init, drone_request_approve, drone_request_complete |
| Выход на связь, конфигурация борта | Регистрация и подключение | data, payload, asset_config, get_drone_params, variables_config, stream_url |
| Доставка миссии и старт | Выполнение миссии | mission, mission_received, mission_rejected |
| Полёт | Выполнение миссии | data, photo, objects_data, create_orthophoto_request |
| Завершение | Выполнение миссии | mission_completed, mission_cancelled, mission_aborted |
| Управление оператором | Управление во время полёта | pause_mission, cancel_mission, critical_disarm, clear_emergency, joy_control и др. |
Статус дрона
Статус дрон передаёт в поле status топика data.
Статусы offline и lost дрон не передаёт — их ставит сервер, когда телеметрия перестаёт приходить
(см. Присутствие на связи). Других значений, кроме
показанных на схеме, борт тоже не передаёт. Пока запуск ПО не закончен, data уже идёт со
status: null — сервер такой пакет на статус не применяет.
emergency landing держится до новой миссии, перезапуска борта или
clear_emergency. Кто и по какой причине
переводит дрон в returning, landing и emergency landing, описано в топике
data (поле status_reason).
Идентификаторы
| Идентификатор | Кто создаёт | Где передаётся |
|---|---|---|
DRONE_ID | Платформа резервирует при выпуске дистрибутива (конфигурации) ПО дрона | Префикс всех топиков, поле drone_id в регистрации |
mission_id | Сервер при создании миссии | mission; обратно — в data и в событиях mission_* |
command_id | Сервер: отдельный для каждого шага миссии и каждого дрона | mission, commands[].command_id; обратно — только в data |
Как сервер и клиент используют command_id и какой идентификатор борт передаёт на каждом этапе —
в разделе Идентификатор команды.
Доставка сообщений
- Порядок прихода события (
mission_cancelled,mission_abortedи др.) и очередногоdataне гарантирован: события борт публикует сразу, телеметрию — раз в ~0,7 с. Решения о завершении принимаются по событиям, а статус вdataслужит подтверждением. - Борт подключается к брокеру с
clean_session = true. Команды, опубликованные, пока дрон не на связи, ему не доставляются. Retained-топики —asset_configиvariables_config— борт получает при каждом подключении. - Все сообщения борт публикует с QoS 0 и без retain, подписки борта — тоже QoS 0. Очереди на борту
нет: всё, что борт отправил во время обрыва связи, включая события
mission_*, теряется и повторно не приходит. - Last Will борт не использует: о потере связи сервер узнаёт только по отсутствию
data. - Когда на борту перезапускается процесс MQTT-моста (после сбоя или после регистрации), борт может
повторно опубликовать последние события:
check_registration,drone_request_complete,payload,mission_*,cancel_rejected. Сервер обрабатывает события так, чтобы повтор не менял закрытое участие дрона в миссии.
Сервер повторяет cancel_mission, если за 10 с не увидел реакции в data, и при восстановлении связи
с дроном. Постоянная MQTT-сессия на борту не используется.