Skip to main content

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 передаются открытым текстом.

Формат зашифрованного сообщения:

contentstrrequired
Исходное JSON-сообщение, зашифрованное AES-256-CBC ключом aes_key, дополнение PKCS#7, в hex
ivstrrequired
Вектор инициализации: 16 случайных байт, новый для каждого сообщения, в hex
signaturestrrequired
Подпись строки content: RSA-SHA256 (PKCS#1 v1.5) закрытым ключом отправителя, в hex

Отправка. Дрон шифрует сообщение ключом aes_key и подписывает content своим закрытым ключом. Сервер подписывает свои сообщения своим закрытым ключом.

Приём. Получатель проверяет подпись открытым ключом отправителя, затем расшифровывает content. Сообщение без обёртки или с неверной подписью не обрабатывается.

Дрон без открытого ключа обменивается с сервером открытым текстом в формате, описанном у каждого топика.

Типы данных​

Point​

latfloatrequired
Широта
longfloatrequired
Долгота
heightfloat
Высота полёта (м)

Position​

pointPointrequired
Координаты
latfloatrequired
Широта
longfloatrequired
Долгота
heightfloat
Высота (м)
directionintrequired
Направление движения (0–360°)
speedfloat
Скорость (м/с)

Все топики​

79 из 79 топиков
ТопикНаправлениеКатегорияОписание
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Дрон → СерверПеременные пиновРезультат воздействия по переменной пина