API Server-Drone v3.0
API интеграции MQTT-топиков между сервером и дроном проекта Wheelies.
Протокол: MQTT
Формат данных: JSON
Формат топика: {DRONE_ID}_{topic_name}
Шифрование сообщений
Обмен с дроном шифруется, если дрон при регистрации передал свой открытый ключ.
Ключи. Дрон хранит пару ключей RSA 2048; закрытый ключ не покидает дрон.
Открытый ключ дрон передаёт в drone_request_init.
В drone_request_approve сервер
присылает свой открытый ключ и ключ AES-256, зашифрованный открытым ключом дрона.
Дрон сохраняет оба ключа так, чтобы они пережили перезапуск и обновление ПО.
Какие топики шифруются. Все топики вида {DRONE_ID}_{topic_name} — в обе
стороны. Топики регистрации без {DRONE_ID} (check_registration,
drone_request_init, drone_request_complete) и
drone_request_approve передаются открытым
текстом.
Формат зашифрованного сообщения:
contentstrrequiredivstrrequiredsignaturestrrequiredОтправка. Дрон шифрует сообщение ключом aes_key и подписывает content
своим закрытым ключом. Сервер подписывает свои сообщения своим закрытым ключом.
Приём. Получатель проверяет подпись открытым ключом отправителя, затем
расшифровывает content. Сообщение без обёртки или с неверной подписью не
обрабатывается.
Дрон без открытого ключа обменивается с сервером открытым текстом в формате, описанном у каждого топика.
Типы данных
Point
latfloatrequiredlongfloatrequiredheightfloatPosition
pointPointrequiredlatfloatrequiredlongfloatrequiredheightfloatdirectionintrequiredspeedfloatВсе топики
| Топик | Направление | Категория | Описание |
|---|---|---|---|
mission | Сервер → Дрон | Миссии | Отправка миссии на дрон |
pause_mission | Сервер → Дрон | Миссии | Управление паузой миссии |
cancel_mission | Сервер → Дрон | Миссии | Остановка миссии оператором или платформой |
use_hand_mode | Сервер → Дрон | Управление полётом | Ручной/автоматический режим |
gimbal_control | Сервер → Дрон | Камера и подвес | Управление подвесом камеры |
get_current_data | Сервер → Дрон | Запрос состояния | Запрос текущего состояния |
gimbal_auto_control | Сервер → Дрон | Камера и подвес | Автосканирование подвеса |
joy_control | Сервер → Дрон | Управление полётом | Команды джойстика |
critical_disarm | Сервер → Дрон | Управление полётом | Экстренное отключение моторов |
clear_emergency | Сервер → Дрон | Управление полётом | Сброс аварийного состояния на борту |
obstacle_avoidance | Сервер → Дрон | Управление полётом | Обход препятствий |
sim_gps | Сервер → Дрон | Управление полётом | Симуляция GPS-координат |
tracker | Сервер → Дрон | Камера и подвес | AI-детекция на видеопотоке |
camera_tracking | Сервер → Дрон | Камера и подвес | Выбор камеры трекинга |
set_model_name | Сервер → Дрон | ML-модели | Установка активной модели |
get_drone_params | Сервер → Дрон | Параметры дрона | Запрос параметров ArduPilot |
set_drone_params | Сервер → Дрон | Параметры дрона | Установка параметров ArduPilot |
get_calibration_data | Сервер → Дрон | Калибровка | Запрос данных калибровки |
set_calibration | Сервер → Дрон | Калибровка | Запуск калибровки |
get_check_motors | Сервер → Дрон | Калибровка | Запрос данных моторов |
set_check_motors | Сервер → Дрон | Калибровка | Проверка моторов |
stream_url | Сервер → Дрон | Камера и подвес | URL видеопотока |
drone_request_approve | Сервер → Дрон | Регистрация | Подтверждение регистрации |
send_file_link | Сервер → Дрон | ML-модели | Загрузка ML-модели |
delete_model | Сервер → Дрон | ML-модели | Удаление модели |
follow_track_object | Сервер → Дрон | Слежение за объектами | Слежение камеры за объектом |
drone_strike_object | Сервер → Дрон | Слежение за объектами | Таран объекта |
drone_follow_object | Сервер → Дрон | Слежение за объектами | Следование дрона за объектом |
registration_check_result | Сервер → Дрон | Регистрация | Результат проверки регистрации |
create_orthophoto | Сервер → Дрон | Ортофото | Адрес загрузки снимков для ортофотоплана |
transferring_to_tensorRT | Сервер → Дрон | ML-модели | Конвертация модели в TensorRT |
drop_servo | Сервер → Дрон | Сброс | Сброс сервопривода |
data | Дрон → Сервер | Телеметрия | Телеметрия дрона, режим полётного контроллера, уровень заряда по решению борта, статус и значения переменных пинов |
mission_received | Дрон → Сервер | Миссии | Подтверждение получения миссии |
mission_completed | Дрон → Сервер | Миссии | Завершение миссии |
mission_cancelled | Дрон → Сервер | Миссии | Дрон прекратил выполнение миссии по команде или решению борта |
mission_rejected | Дрон → Сервер | Миссии | Отказ дрона от миссии до взлёта |
mission_aborted | Дрон → Сервер | Миссии | Миссия прервана: авария или внутренняя ошибка борта |
cancel_rejected | Дрон → Сервер | Миссии | Отказ борта применить cancel_mission |
command_status | Дрон → Сервер | Миссии | Начало и окончание команды задания версии 2 |
trigger_fired | Дрон → Сервер | Миссии | Борт выполнил действие триггера миссии |
photo | Дрон → Сервер | Телеметрия | Фото с детектируемым объектом |
current_model_tracking | Дрон → Сервер | ML-модели | Текущая активная модель |
result_delete | Дрон → Сервер | ML-модели | Результат удаления модели |
objects_data | Дрон → Сервер | Телеметрия | Метаданные детектируемого объекта |
gimbal_data | Дрон → Сервер | Камера и подвес | Данные подвеса камеры |
gimbal_auto_status | Дрон → Сервер | Камера и подвес | Статус автосканирования |
drone_params_data | Дрон → Сервер | Параметры дрона | Параметры ArduPilot |
ardupilot_status | Дрон → Сервер | Телеметрия | Статусные сообщения ArduPilot |
calibration_data | Дрон → Сервер | Калибровка | Данные калибровки |
check_motors_data | Дрон → Сервер | Калибровка | Данные проверки моторов |
download_info | Дрон → Сервер | ML-модели | Прогресс загрузки модели |
mag_fitness | Дрон → Сервер | Калибровка | Калибровка магнитометра |
calibration_result | Дрон → Сервер | Калибровка | Итог процедуры калибровки |
stream_lost | Дрон → Сервер | Камера и подвес | Потеря видеопотока |
payload | Дрон → Сервер | Телеметрия | Статус оборудования |
drone_request_init | Дрон → Сервер | Регистрация | Инициация регистрации |
drone_request_complete | Дрон → Сервер | Регистрация | Завершение регистрации |
follow_info_publisher | Дрон → Сервер | Слежение за объектами | Статус трекинга камерой |
drone_strike_status | Дрон → Сервер | Слежение за объектами | Статус тарана |
drone_follow_status | Дрон → Сервер | Слежение за объектами | Статус следования |
check_registration | Дрон → Сервер | Регистрация | Проверка регистрации |
actual_objects_data | Дрон → Сервер | Запрос состояния | Список детектируемых объектов |
create_orthophoto_request | Дрон → Сервер | Ортофото | Запрос создания ортофотоплана |
transferring_info | Дрон → Сервер | ML-модели | Статус конвертации модели |
send_audio_link | Сервер → Дрон | Робот | Отправка аудиофайла на робота |
download_audio_info | Дрон → Сервер | Робот | Прогресс загрузки аудио |
STT_result | Дрон → Сервер | Робот | Результат распознавания речи |
LLM_answer | Дрон → Сервер | Робот | Ответ языковой модели |
lep_control | Сервер → Дрон | ЛЭП | Управление полётом вдоль ЛЭП и инспекцией столбов |
lep_status | Дрон → Сервер | ЛЭП | Статус полёта вдоль ЛЭП и инспекции столбов |
asset_config | Сервер → Дрон | Телеметрия | Конфигурация аппаратных компонентов дрона, характеристики и пороги заряда системы питания |
update_software | Сервер → Дрон | ПО | Команда обновления программного обеспечения |
update_software_status | Дрон → Сервер | ПО | Результат обновления ПО |
variables_config | Сервер → Дрон | Переменные пинов | Конфигурация переменных пинов дрона |
pin_var_{code} | Сервер → Дрон | Переменные пинов | Значение выходной переменной пина |
get_variables_config | Дрон → Сервер | Переменные пинов | Запрос конфигурации переменных пинов |
variables_config_status | Дрон → Сервер | Переменные пинов | Результат применения конфигурации переменных |
variables_status | Дрон → Сервер | Переменные пинов | Результат воздействия по переменной пина |