Skip to main content

Выполнение миссии

От создания миссии оператором до её завершения на борту.


1. Создание миссии​

Отдельной команды «старт» нет: миссия запускается при создании (POST /mission) либо в запланированное время.

  1. Оператор создаёт миссию в интерфейсе, клиент вызывает POST /mission.
  2. Сервер проверяет каждого дрона: на связи (online), лицензия есть, не в ремонте и без критической неисправности, заряд не низкий, нет другой миссии на это время. Если проверка не пройдена, миссия не создаётся, клиент получает ошибку.
  3. Сервер создаёт миссию и её команды. На каждый шаг миссии и каждого дрона — своя команда со своим command_id.
  4. Если время старта не задано или уже наступило, сервер сразу отправляет миссию дронам. Иначе ждёт времени старта, повторяет проверку дронов и при неудаче помечает миссию как не начатую — клиент получает событие MISSION_NOT_START.

2. Доставка и приём​

Топики: mission, mission_received, mission_rejected.

  • 10 секунд отсчитываются от mission_received. Если за это время статус в data сменился с online (дрон начал взлёт), проверка снимается.
  • Борт начинает выполнение сразу после mission_received, отдельной команды «старт» нет. Статус taking off приходит через доли секунды: он означает начало подготовки — режим, взведение моторов, взлёт, набор высоты. Если моторы не взводятся (нет GPS-фикса, не пройдены предполётные проверки полётного контроллера), борт повторяет попытку раз в секунду, статус остаётся taking off; причину видно в ardupilot_status (PreArm: ...).
  • mission_rejected всегда приходит после mission_received, а не вместо него.
  • Миссия, пришедшая во время калибровки (status = calibration), ждёт её окончания; mission_received приходит только тогда.
  • Новая mission, пока выполняется другая, борт игнорирует без ответа; идентификаторы текущей миссии в data не меняются.
  • После калибровки акселерометра борт не отвечает на mission ничем, пока ПО не перезапустят.
  • Если mission_received пришёл по миссии, участие дрона в которой уже закрыто (оператор остановил её раньше), сервер сразу отправляет cancel_mission.
  • Миссия «всё или ничего»: отказ одного дрона останавливает миссию для всех её дронов.

3. Полёт​

Во время полёта борт публикует data раз в ~0,7 с и события по мере их появления.

  • Клиент получает data и события миссии напрямую через прокси — так страница миссии обновляется без задержки на обработку сервером. Сохранённые сервером данные (статусы, итог миссии) клиент перезапрашивает через REST.
  • На странице миссии клиент учитывает только data с mission_id этой миссии.
  • Фото и обнаруженные объекты сами не содержат mission_id и command_id: сервер берёт их из последней полученной data. Борт отправляет их не раньше чем через 1 с после обнаружения; поле time — момент обнаружения в UTC, без суффикса Z.

Топики: data, objects_data, photo, get_current_data, create_orthophoto_request, create_orthophoto.


4. Идентификатор команды​

command_id создаёт сервер — по одному на каждый шаг миссии и каждого дрона. Дрону он приходит один раз, в mission (commands[].command_id). Обратно он возвращается только в поле command_id топика data: отдельного события «команда началась» или «команда выполнена» нет.

Для чего платформа использует command_id из data:

ГдеКак
Клиент, страница миссииПодсвечивает активный шаг миссии. Идентификатор, которого нет среди команд миссии, и null клиент пропускает — остаётся предыдущий активный шаг
Сервер, данные о выполненииТрек, время и дистанция полёта по каждой команде собираются из телеметрии с этим command_id
Сервер, привязка событийФото, обнаруженные объекты, сообщения полётного контроллера привязываются к команде из последней data

Что борт передаёт сейчас:

  • борт выполняет все команды из commands как один маршрут: точки всех команд подряд, а скорость и остальные параметры — последней команды списка. Границ команд борт не различает;
  • с момента mission_received — mission_id этой миссии и command_id последней команды списка, в том числе на взлёте, на возврате и на посадке;
  • после завершения миссии (mission_completed, mission_cancelled, mission_aborted) значения не очищаются и остаются до следующей принятой миссии; отклонённая или проигнорированная mission их не меняет; после перезапуска борта — null;
  • triggers из mission борт не выполняет.

Границей выполнения команды служат события миссии и переход статуса в online, а не смена command_id.

Согласовано

Борт передаёт в command_id идентификатор выполняемой команды, а не последней в списке. Это нужно, когда у дрона в миссии несколько шагов подряд.


5. Завершение​

ИсходЧто публикует бортЧто делает серверЧто получает клиент
Маршрут выполненmission_completed после посадкиКоманды выполнены, итог дрона «выполнено»mission_completed через прокси
Остановка операторомmission_cancelled после посадкиИтог дрона «остановлено»mission_cancelled через прокси
Возврат или посадка по заряду, failsafemission_cancelled; причина — status_reason в data до посадкиИтог «не завершено» с причинойmission_cancelled через прокси
Авария, critical_disarmmission_aborted; статус emergency landingИтог «аварийно прервано», дрон помечается неисправнымMISSION_ABORTED, DRONE_CHANGE_HEALTH_STATUS
Отказ на землеmission_rejectedМиссия не начатаMISSION_NOT_ACCEPTED

Топики: mission_completed, mission_cancelled, mission_aborted, mission_rejected.

  • Событие и data со статусом online приходят разными путями, их порядок не гарантирован. Завершение фиксируется по событию.
  • Итог миссии в целом считается, когда закрыты команды всех её дронов, по худшему из исходов: «аварийно прервано», затем «остановлено», «не завершено», «выполнено».
Согласовано

mission_cancelled передаётся как JSON { "mission_id": "...", "reason": "operator" | "battery_low" | "battery_critical" }. Сервер принимает и прежний формат — строку с идентификатором миссии.

Миссия «только взлёт»​

Миссия из одной точки без координат завершается, как только дрон набрал высоту: борт сразу публикует mission_completed, статус становится online, и дрон висит в воздухе без активной миссии. В этом состоянии cancel_mission не действует; посадить дрон можно миссией посадки (одна точка с height = 0).


6. Потеря связи и перезапуск борта​

Обрыв связи с брокером. Миссию выполняет сам борт, поэтому без связи она продолжается. После восстановления связи data идёт со следующего пакета с текущим статусом и прежними mission_id и command_id. События за время обрыва не повторяются: если миссия закончилась без связи, сервер увидит status = online, armed = false с идентификаторами этой миссии, но без mission_completed или mission_cancelled. Команды сервера, отправленные во время обрыва, борт тоже не получит.

Перезапуск ПО борта в полёте. Полётный контроллер долетает загруженный маршрут и зависает над последней точкой: возврат на точку старта командует ПО борта, а оно перезапустилось. Состояние миссии не сохраняется, событий по прерванной миссии нет. После запуска борт публикует data со статусом online, armed = true, flight_mode = AUTO и mission_id, command_id = null. Реакция на низкий и критический заряд и аварии полётного контроллера при этом работает. cancel_mission борт отклоняет — активной миссии у него нет; посадить дрон можно миссией посадки.