КОНЦЕПЦИЯ И РАЗРАБОТКАБЕСПИЛОТНЫЙ СПОРТ · #bezpiLOTa · KAIROS DRONE AGENTДокументация
#bezpiLOTa→Getting Started→Your First Flight
FIRST STEPS / FIRST FLIGHT

Это протокол будущей валидации: подключение FC, pre-flight checklist, проверка input и failsafe, короткий ручной полёт, посадка и разбор telemetry. На текущем этапе KairOS допускает только SITL и стенд без пропеллеров.

SIMULATION ONLY

KairOS не прошёл лётную валидацию и не предназначен для управления реальным аппаратом на текущем этапе.

Репозиторий KairOS ↗
09обязательных этапов
8+рекомендованных GPS satellites
80%+battery before flight
VLOSвизуальный контроль
01
SIMULATION / PROPS OFF

Что вы сделаете и чего эта инструкция не гарантирует

Цель — зафиксировать полный операторский цикл: connection, pre-flight, input verification, arm, takeoff, короткий manual flight, landing и post-flight review. До собственной аппаратной и лётной валидации последовательность выполняется только в SITL или на стенде без пропеллеров.

02
BEFORE YOU START

Аппарат, калибровки и оборудование

  • Механически исправный и ранее проверенный airframe; крепёж, arms, landing gear и payload зафиксированы.
  • Flight controller с ArduPilot, PX4, Betaflight или iNav; точная firmware/version проверена.
  • Accelerometer, compass, gyro и RC/gamepad mapping откалиброваны; orientation FC соответствует установке.
  • Пропеллеры правильного типа и направления установлены только после bench‑проверок без props.
  • Полностью заряженный flight battery и отдельное стабильное питание companion electronics.
  • USB direct либо Wi‑Fi/4G/field link через Drone Agent; Mission Control открыт и понятен оператору.
  • Gamepad или keyboard; Xbox‑style controller выбран целевым профилем для Web Gamepad API.
  • Открытая разрешённая площадка без людей, животных, транспорта, проводов, аэропортов и ограниченных зон.
03
STEP 01

Подключите FC и дождитесь подтверждённого handshake

01BENCH

Direct USB

Подключите data cable, откройте http://localhost:4000, нажмите Connect, выберите serial port и дождитесь heartbeat/capabilities/parameters.

02FIELD

Field network

Включите аппарат; Agent должен стартовать сам. Подключите laptop к той же LAN, USB tether или Ground Agent AP и выберите найденный node либо введите IP/mDNS.

  • Top bar показывает firmware family, vehicle type и version.
  • Connection status становится зелёным только после живой telemetry, а не после одного socket open.
  • Целевой handshake занимает 2–5 секунд; timeout диагностируется, а не маскируется повторным Arm.
  • Перед дальнейшими действиями убедитесь, что selected node — именно текущий аппарат.
04
STEP 02

Пройдите pre-flight без единой красной ошибки

ПроверкаЧто ожидается
GPS3D Fix или лучше; 8+ satellites как целевой минимум для field validation; HDOP <2; RTK state, если используется
BatteryСоответствует полному напряжению pack — например, около 25.2 V для 6S; >80%; current около 0 A на земле
AttitudeArtificial horizon level, roll/pitch реагируют в правильную сторону
InputRC/gamepad channels двигаются правильно; throttle minimum; trims centered
ModeStabilize или Altitude Hold для первого полёта; не Auto, Guided или Loiter как стартовый неизвестный режим
PreArmВсе failures устранены; не обходить checks только ради взлёта

Для планирования RC и compass calibration закладывается 2–3 минуты, но важен не таймер, а корректный результат. Если horizon наклонён, compass показывает variance, GPS не фиксирует position или battery telemetry сомнительна, тест откладывается.

Предполётная проверка: карта запретной зоны, ветер и порывы, энергетический риск, чек-лист и недоступный запуск миссии.
ИНТЕРФЕЙС / ВИЗУАЛЬНЫЙ ПРИМЕРЧек-лист с видимыми причинами остановки

Погодный риск и запретная зона на иллюстрации не позволяют завершить pre-flight. Проверки батареи, GPS и связи остаются частью того же чек-листа.

05
STEP 03

Проверьте управление до Arm

InputДействие
Left stick verticalThrottle
Left stick horizontalYaw
Right stick verticalPitch
Right stick horizontalRoll
Keyboard W / SPitch
Keyboard A / DRoll
Arrow Up / DownThrottle
Arrow Left / RightYaw

Gamepad должен определиться в Flight Control tab; иногда его нужно «разбудить» кнопкой. Целевой контур KairOS отправляет MANUAL_CONTROL MAVLink с частотой 50 Hz. Проверьте PILOT_THR_BHV, RC override policy, dead zones и направление каждого axis. Bluetooth может добавить latency; USB предпочтительнее для первого теста.

06
STEP 04

Arm только с безопасной дистанции и явным подтверждением

01

Clear area

Все люди находятся за безопасной границей; аппарат направлен предсказуемо; оператор видит его полностью.

02

Confirm mode + throttle

Stabilize/AltHold выбран осознанно, throttle minimum, sticks neutral.

03

Arm

Нажмите Arm и подтвердите действие. UI ждёт ACK/heartbeat и показывает ARMED.

04

Observe motors

Idle spin зависит от MOT_SPIN_ARM. Любой неправильный motor direction, vibration или неожиданный throttle — немедленный disarm.

Типичный отказЧто исправить
Need 3D FixДождаться GPS в открытом месте или выбрать разрешённый non-GPS test только при полном понимании режима
Battery failsafeПроверить charge, voltage/current sensor, cell count и threshold
Compass varianceУдалить interference, откалибровать, проверить orientation
Gyros inconsistentОставить аппарат неподвижным и дать sensors прогреться около 30 секунд
07
STEP 05

Поднимитесь на 2–3 метра и остановитесь

В будущей полевой валидации throttle увеличивается медленно; hover point часто находится в диапазоне 40–60%, но зависит от аппарата. В Altitude Hold/Loiter centered throttle удерживает altitude, выше центра задаёт climb, ниже — descent. Режим выбирается по firmware‑спецификации и результатам предварительных тестов.

01

Lift cleanly

Не тяните аппарат вдоль земли; плавно пройдите ground effect и поднимитесь.

02

Hold 2–3 m

Остановите climb, проверьте drift, oscillation, vibration и response.

03

Abort early

При любом непредсказуемом behavior мягко приземлитесь; не продолжайте ради прохождения инструкции.

08
STEP 06

Короткие команды, постоянный мониторинг

  • Pitch — движение вперёд/назад; Roll — влево/вправо; Yaw — разворот; Throttle — vertical control согласно mode.
  • Следите за altitude, ground speed, battery voltage и sag, distance from home, flight mode и link state.
  • Выполняйте один небольшой input за раз и возвращайтесь к hover, чтобы проверить response.
  • Loiter может служить режимом удержания position/altitude, но только при исправных GPS/EKF и заранее проверенном mode switch.
  • Не переключайтесь в Auto/Guided и не тестируйте geofence/failsafe впервые на малой площадке.
Видеокабина #bezpilOta GCS: изображение с камеры, HUD, мини-карта, батарея, GPS, прогресс миссии и полётные команды.
ИНТЕРФЕЙС / ВИЗУАЛЬНЫЙ ПРИМЕРПостоянный мониторинг в видеокабине

Камера, курс, высота, скорость, батарея и GPS остаются в поле зрения вместе с командами паузы, посадки и возврата.

09
STEP 07

Понимайте, что удерживает каждый режим

ModeЦелевое поведениеТребования
StabilizeПолное manual control с auto-level attitudeЗнакомый operator input
Altitude HoldУдерживает altitude около centered throttleBarometer и корректная throttle behavior
LoiterУдерживает position и altitudeGPS/EKF health
PosHoldFirmware‑зависимый режим удержания с accelerometer-oriented управлениемНе считать универсально безопасным без firmware-specific проверки
10
STEP 08

Приземлитесь предсказуемым выбранным способом

СпособПолный flow
Manual descentСнижаться примерно 0.5–1 m/s; после касания throttle minimum около 2 s; auto-disarm зависит от настроенного DISARM_DELAY
Land modeFC выполняет controlled descent и disarm после touchdown; оператор остаётся готов переключить mode
RTLClimb к configured altitude, return home и land; требует проверенных GPS, home, altitude и path

После остановки propellers UI должен показать DISARMED. Если auto-disarm не произошёл, используйте Disarm только после физического touchdown и уверенности, что аппарат не попытается восстановить thrust.

11
STEP 09

Разберите telemetry и логи до следующего полёта

  • Откройте map track и сравните фактическую траекторию с командами оператора.
  • Проверьте altitude, mode changes, GPS, EKF, vibration, current draw, link events и failsafe messages.
  • ArduPilot хранит onboard .bin logs; скачайте их через log browser или USB и сохраните вместе с configuration snapshot.
  • Для ArduPilot используйте firmware.ardupilot.org и firmware‑specific analysis; KairOS не заменяет документацию производителя FC.
  • Battery ниже примерно 3.5 V/cell под нагрузкой может указывать на aging или избыточный sag; сравнивайте с характеристиками pack.
  • Если возник failsafe или warning, следующий полёт сокращается или отменяется до объяснения причины.
12
COMMON FIRST-FLIGHT ISSUES

Диагностика симптома, а не маскировка

СимптомПроверки
Drift в одну сторонуCompass interference/calibration, FC orientation, level calibration, trim
Oscillation или vibrationProps/motors/frame, vibration logs, PID; Autotune только в безопасном отдельном сценарии
Gamepad lagChrome/Edge, USB вместо Bluetooth, frame rate, browser tab focus
Frozen/black videoAgent video service, transport selection, camera device and format
Check firmwareЦелевые minimums: ArduPilot 4.0+, PX4 1.12+, Betaflight 4.3+, iNav 7.0+; фактическую поддержку нужно проверить
bashЦелевая диагностика video service
kairos status
journalctl -u kairos-video -n 20 --no-pager
Целевой интерфейс KairOS: команда становится исполнимой только после выпуска соответствующего компонента.
13
SAFETY REMINDERS

Минимум, который нельзя пропустить

  • Arm только на безопасной дистанции от людей и объектов.
  • Первые полёты короткие и низкие; сложность увеличивается постепенно.
  • Сохраняйте visual line of sight и ситуационную осведомлённость.
  • Знайте, что происходит при RC loss, GCS loss, battery low и GPS/EKF failure.
  • Летайте в открытой разрешённой зоне вдали от аэропортов, restricted airspace и crowds.
  • Проверяйте действующие местные правила перед каждым flight session.
  • Оператор остаётся ответственным даже при использовании automated modes и KairOS UI.