Выполнение миссии
От создания миссии оператором до её завершения на борту.
1. Создание миссии
Отдельной команды «старт» нет: миссия запускается при создании (POST /mission) либо в
запланированное время.
- Оператор создаёт миссию в интерфейсе, клиент вызывает
POST /mission. - Сервер проверяет каждого дрона: на связи (
online), лицензия есть, не в ремонте и без критической неисправности, заряд не низкий, нет другой миссии на это время. Если проверка не пройдена, миссия не создаётся, клиент получает ошибку. - Сервер создаёт миссию и её команды. На каждый шаг миссии и каждого дрона — своя команда со своим
command_id. - Если время старта не задано или уже наступило, сервер сразу отправляет миссию дронам. Иначе ждёт
времени старта, повторяет проверку дронов и при неудаче помечает миссию как не начатую — клиент
получает событие
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 через прокси |
| Возврат или посадка по заряду, failsafe | mission_cancelled; причина — status_reason в data до посадки | Итог «не завершено» с причиной | mission_cancelled через прокси |
Авария, critical_disarm | mission_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
борт отклоняет — активной миссии у него нет; посадить дрон можно миссией посадки.