Skip to main content

Жизненный цикл дрона

Раздел описывает, в каком порядке дрон, сервер и веб-интерфейс обмениваются сообщениями: от первого запуска ПО дрона до завершения миссии. Поля каждого топика здесь не повторяются — они описаны в 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-сессия на борту не используется.