Skip to main content

Управление во время полёта

Как команды оператора доходят до дрона и как платформа узнаёт, что борт их выполнил.


Каналы​

Действие оператораПутьТопик дронуПодтверждение от борта
Пауза / продолжениеREST PUT /command/pause/{id}, PUT /command/resume/{id} → серверpause_mission on / offstatus = paused в data и обратный переход
Остановка миссииREST PUT /mission/cancel/{id}, PUT /mission/cancel-for-drone/{droneId} → серверcancel_missionreturning / landing с status_reason = operator, затем mission_cancelled
Аварийное отключение моторовКлиент публикует напрямую через прокси, автора фиксирует POST /drone/{id}/critical-disarmcritical_disarmemergency 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_idvariables_status с тем же request_id
Ручной режим, джойстик, подвес, слежение, ЛЭП, параметры, калибровкаКлиент публикует напрямую через проксиuse_hand_mode, joy_control, gimbal_*, tracker, follow_*, lep_control и др.Ответные топики борта, клиент читает их через прокси

Команды, которые клиент публикует напрямую, сервер не обрабатывает и не сохраняет — исключение critical_disarm, на который сервер тоже подписан.


Пауза​

  • Продолжить можно только команду, которую сервер уже отметил как приостановленную, то есть после status = paused от борта.
  • use_hand_mode true тоже ставит миссию на паузу: для сервера это тот же переход в 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 борт выполняет только на земле с выключенными моторами.


Прямое управление​

Так же работают ручной режим и джойстик, слежение и удар по объекту, ЛЭП, обход препятствий, выбор камеры и модели детекции, калибровка, проверка моторов, параметры полётного контроллера, а также действия, которые задаёт манифест релиза ПО дрона. Корреляции запроса и ответа у этих команд нет: клиент ждёт ответный топик ограниченное время.