Skip to main content

Регистрация и подключение

Что происходит от запуска ПО дрона до момента, когда дрон готов принять миссию.


1. До подключения к брокеру​

Установка ПО и получение сертификатов описаны в техническом руководстве по установке. Кратко:

  1. Оператор выпускает на платформе дистрибутив config.tar. Платформа резервирует под него идентификатор дрона (DRONE_ID); запрос на активацию нужно отправить в течение 45 дней.
  2. ПО дрона запрашивает одноразовый токен (POST /api/management/cert-enroll) и по нему получает TLS-сертификат для подключения к MQTT-брокеру.

2. Проверка регистрации и активация​

При запуске дрон спрашивает, зарегистрирован ли он на платформе. Если нет — отправляет запрос на активацию и ждёт, пока оператор подтвердит его в интерфейсе.

Топики: check_registration, registration_check_result, drone_request_init, drone_request_approve, drone_request_complete.

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

  • check_registration борт отправляет один раз и ждёт ответа до 30 с. Нет ответа — то же, что false: борт отправляет запрос на активацию.
  • На drone_request_init сервер сразу ничего не отвечает: ответом служит drone_request_approve после действия оператора. Борт отправляет drone_request_init один раз и ждёт подтверждения не дольше 5 минут; после этого запуск прерывается, и ПО нужно перезапустить.
  • После drone_request_complete борт снова спрашивает check_registration — раз в 5 с, пока не получит true, — и продолжает запуск, как зарегистрированный дрон.
  • drone_request_complete содержит только drone_id.
  • Отдельного сообщения об ошибке активации нет: если борт не смог разобрать drone_request_approve, drone_request_complete просто не приходит.
  • Если запрос по этому дрону уже подтверждён, повторный drone_request_init сразу получает drone_request_approve.
  • Повторный drone_request_init с тем же drone_id, организацией и MAC-адресом не создаёт новый запрос, а обновляет состав борта в существующем.
  • Если в запросе нет обязательных полей или дистрибутив не найден либо истёк, запрос на активацию не создаётся. Клиент получает событие AUTOSUPPORT_REQUEST_RESULT с ошибкой, дрону ничего не отправляется.
  • Созданный дрон получает статус offline — до первой телеметрии.

3. Выход на связь​

Отдельного сообщения «дрон готов» нет. Дрон считается на связи, когда сервер получает от него data со статусом online.

После ответа true на check_registration борт поднимает свои узлы по этапам. Телеметрия data начинает идти раньше конца запуска — со status: null, через ~2 с приходит online. Состав оборудования payload борт публикует примерно через 20 с после online, когда определит оборудование, а ещё через ~10 с — один раз запрашивает ссылки на видеопоток через stream_lost.

Что сервер делает при выходе дрона на связь (переход из offline или lost в online):

  • сообщает клиенту новый статус — событие DRONE_CHANGE_STATUS;
  • запрашивает параметры полётного контроллера — get_drone_params;
  • запускает приём видео с камер дрона — дрону приходит stream_url.

Конфигурация борта:

ЧтоКогдаТопики
Состав оборудованияДрон публикует при старте и при изменениях: камеры, место на SD-карте (проверка раз в 30 с), данные полётного контроллера, батарея; сервер отвечает конфигурацией оборудованияpayload → asset_config
Параметры полётного контроллераПосле payload и при выходе на связьget_drone_params → drone_params_data, при расхождении set_drone_params
Переменные пиновRetained, дрон получает при подключенииvariables_config → variables_config_status
ВидеопотокПри выходе на связь; дрон запрашивает ссылки один раз после стартаstream_url, stream_lost

Видеопоток с камеры запускается, когда борту известны и камера, и ссылка для неё; порядок прихода не важен. Ссылки борт хранит только в памяти: после перезапуска ПО он запрашивает их снова через stream_lost. Новая ссылка для камеры, поток которой уже идёт, применяется только после перезапуска потока. Если за 30 с после старта камеры не найдены, видеопотока и stream_lost нет до перезапуска ПО.

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


4. Присутствие на связи​

Отдельного heartbeat-топика нет: признак связи — сам поток data (раз в ~0,7 с).

СитуацияЧто делает серверЧто видит клиент
data не приходит 60 с, дрон был не на миссииСтатус offline, приём видео останавливаетсяDRONE_CHANGE_STATUS (offline)
data не приходит 60 с, дрон был на миссии (on mission)Статус lostDRONE_CHANGE_STATUS (lost)
data снова пришлаСтатус из data, далее как в разделе 3DRONE_CHANGE_STATUS

Сервер проверяет связь раз в минуту, поэтому от последней телеметрии до перехода в offline проходит от 60 до 120 с.

data идёт раз в 0,7 с в любом состоянии борта — на земле, в полёте, во время калибровки; поля без данных (координаты до захвата GPS, заряд до получения ёмкости батареи) передаются как null. Штатно телеметрия прерывается дольше чем на 60 с только при перезапуске ПО, в том числе при обновлении: запуск занимает от ~20 с до нескольких минут, и при перерыве дольше 60 с сервер ставит offline. Статуса «обновление ПО» борт не передаёт. Если связь пропала без разрыва соединения (например, пропал радиоканал), борт замечает это примерно через 90 с.

Заряд и работоспособность сервер считает по той же телеметрии и сообщает клиенту событиями DRONE_BATTERY_LEVEL_CHANGED и DRONE_CHANGE_HEALTH_STATUS. От них зависит, допустит ли сервер дрон к миссии.


5. Подключение через АРМ​

АРМ — приложение на ноутбуке оператора для работы с дронами без интернета. В режиме АРМ бортовой компьютер подключается к сети АРМ, и дрон появляется в интерфейсе АРМ. Активация дрона (раздел 2) и в этом режиме идёт через сервер, поэтому на время установки интернет нужен.

Что сервер знает о связке дрона с АРМ:

  • Дрон передаёт идентификатор своего АРМ в поле arm_device_id в drone_request_init и payload. Сервер сохраняет его; несуществующий идентификатор не сохраняется.
  • Статус АРМ «онлайн» или «офлайн» сервер не получает от АРМ, а вычисляет: АРМ онлайн, пока хотя бы один привязанный к нему дрон не в статусе offline, deleted или unlicensed.
  • Лицензия в license.json действует 45 дней с последней синхронизации. Сервер передаёт в ней только данные лицензий и дронов организации.
  • Дрон, привязанный к отозванному или удалённому АРМ, сервер не допускает к миссиям, но его телеметрию продолжает принимать.

Данные дронов — телеметрию, события миссий, фото — АРМ серверу не передаёт: от АРМ сервер принимает только регистрацию и синхронизацию. Сервер получает данные дрона, только когда дрон сам подключён к его MQTT-брокеру.