Управление во время полёта
Как команды оператора доходят до дрона и как платформа узнаёт, что борт их выполнил.
Каналы
| Действие оператора | Путь | Топик дрону | Подтверждение от борта |
|---|---|---|---|
| Пауза / продолжение | REST PUT /command/pause/{id}, PUT /command/resume/{id} → сервер | pause_mission on / off | status = paused в data и обратный переход |
| Остановка миссии | REST PUT /mission/cancel/{id}, PUT /mission/cancel-for-drone/{droneId} → сервер | cancel_mission | returning / landing с status_reason = operator, затем mission_cancelled |
| Аварийное отключение моторов | Клиент публикует напрямую через прокси, автора фиксирует POST /drone/{id}/critical-disarm | critical_disarm | emergency landing, mission_aborted |
| Снятие аварийного статуса | REST PUT /drone/{id}/confirm-serviceable или POST /drone/{id}/clear-emergency → сервер | clear_emergency | статус online в data |
| Значение переменной пина | REST POST /variable/{id}/value → сервер | pin_var_{code} с request_id | variables_status с тем же request_id |
| Ручной режим, джойстик, подвес, слежение, ЛЭП, параметры, калибровка | Клиент публикует напрямую через прокси | use_hand_mode, joy_control, gimbal_*, tracker, follow_*, lep_control и др. | Ответные топики борта, клиент читает их через прокси |
Команды, которые клиент публикует напрямую, сервер не обрабатывает и не сохраняет — исключение
critical_disarm, на который сервер тоже подписан.
Пауза
- Продолжить можно только команду, которую сервер уже отметил как приостановленную, то есть после
status = pausedот борта. use_hand_modetrueтоже ставит миссию на паузу: для сервера это тот же переход вpaused.- Отдельного события паузы нет: поле
pauseвdataи топикmission_on_pauseборт не передаёт.
Остановка
cancel_missionне содержитmission_id: борт отменяет ту миссию, которую выполняет. Поэтому сервер не отправляет его, если дрон уже взял другую миссию.- Без активной миссии борт команду игнорирует и ничего не публикует.
cancel_mission, пришедшая на паузе, снимает паузу и выполняет отмену.- Если подтверждение от борта не пришло, оператор может закрыть участие дрона без него —
POST /mission/finish/{id}илиPOST /mission/finish/{id}/drone/{droneId}.
cancel_missionпередаётся как JSON{ "mission_id": "...", "type": "BACK_TO_START" }; строка без скобок по-прежнему принимается.- Если команда не применена, борт отвечает новым топиком
{DRONE_ID}_cancel_rejected{ "mission_id", "active_mission_id", "reason" }, гдеreason—no_active_mission,mission_mismatchилиfinal_landing. - Отмена, пришедшая на финальной посадке после выполненного маршрута, игнорируется; миссия
завершается
mission_completed. - Сервер повторяет
cancel_mission, если за 10 с не увидел реакции вdata. - О внутренней ошибке контроллера миссии борт сообщает отдельным событием с
mission_idи причинойinternal_error.
Аварийное отключение моторов
Так же сервер реагирует на аварию, которую полётный контроллер обработал сам: статус
emergency landing с status_reason = fc_failsafe и mission_aborted с причиной fc_emergency.
clear_emergency борт выполняет только на земле с выключенными моторами.
Прямое управление
Так же работают ручной режим и джойстик, слежение и удар по объекту, ЛЭП, обход препятствий, выбор камеры и модели детекции, калибровка, проверка моторов, параметры полётного контроллера, а также действия, которые задаёт манифест релиза ПО дрона. Корреляции запроса и ответа у этих команд нет: клиент ждёт ответный топик ограниченное время.