Регистрация и подключение
Что происходит от запуска ПО дрона до момента, когда дрон готов принять миссию.
1. До подключения к брокеру
Установка ПО и получение сертификатов описаны в техническом руководстве по установке. Кратко:
- Оператор выпускает на платформе дистрибутив
config.tar. Платформа резервирует под него идентификатор дрона (DRONE_ID); запрос на активацию нужно отправить в течение 45 дней. - ПО дрона запрашивает одноразовый токен (
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) | Статус lost | DRONE_CHANGE_STATUS (lost) |
data снова пришла | Статус из data, далее как в разделе 3 | DRONE_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-брокеру.