QUICKSTART / GROUND AGENT

#bezpiLOTa Ground Agent проектируется как соседний полевой компонент в profile ground-station: принимает WFB-ng, выдаёт Wi‑Fi AP и USB tether, поддерживает HDMI kiosk и показывает состояние на OLED с физическими кнопками.

PLANNED

Ground Agent не является продуктом KairOS; общий протокол взаимодействия и ground profile требуют отдельной сборки и проверки экосистемы.

Репозиторий KairOS ↗

WFB-NGradio receive

4client paths

OLEDoptional physical UI

GROUNDprofile

На этой странице +

WHAT IS GROUND AGENT

Мост между radio link и операторскими устройствами

На air side Drone Agent кодирует video и передаёт radio stream. Ground Agent с совместимым Wi‑Fi adapter работает в monitor mode, принимает WFB-ng packets, восстанавливает stream с FEC и публикует его в локальную сеть. Laptop или phone подключается к AP/tether и открывает Mission Control.

Ground profile не требует flight controller. Auto-detection использует наличие receive adapter, отсутствие FC, OLED и buttons как сигналы роли. Явный override хранится в /etc/kairos/config.yaml.

HARDWARE YOU NEED

Минимальный стенд и автономный полевой комплект

Сценарий	Компоненты
Bench minimum	Raspberry Pi 4B 2 GB+; RTL8812EU USB adapter; 2× 5.8 GHz SMA antennas; USB-C data cable; stable external power
Standalone field	Bench комплект + 1.3″ SSD1306 I²C OLED; four buttons; HDMI display; USB gamepad
Air side	Drone Agent SBC; WFB-ng TX adapter; camera; matching channel/key; FC link при необходимости telemetry/control

INSTALLATION

От свежей ОС до ground-station profile

Flash OS

Pi 4B: Raspberry Pi OS Lite Bookworm 64-bit. Radxa: vendor Debian/Ubuntu image.

Boot + SSH

Подключите network, найдите hostname/IP и войдите по SSH.

Attach radio

Подключите RTL8812EU с антеннами до перевода interface в monitor mode.

Verify USB

lsusb должен показать Realtek device, типовой ID 0bda:8812.

Run generated install

Flash Tool выбирает Ground Agent и board, затем выдаёт актуальную KairOS command.

Confirm role

Проверьте profile ground-station и enabled receive/AP/tether services.

bashЦелевой login и проверка адаптера

ssh pi@kairos-ground.local
# или
ssh pi@192.168.1.XX

lsusb | grep -i realtek

Целевой интерфейс KairOS: команда становится исполнимой только после выпуска соответствующего компонента.

bashVerify agent and services

kairos status

Целевой интерфейс KairOS: команда становится исполнимой только после выпуска соответствующего компонента.

EXPECTED PROJECT STATE

Какие сервисы и адреса должен показать status

Item	Целевой литерал KairOS
Profile	ground-station
Services	kairos-supervisor, kairos-api, kairos-health, kairos-wfb-rx, kairos-hostapd
Access point	SSID KAIROS-GS-abc123
WFB channel	161 / 5805 MHz в примере
AP address	10.0.0.1

CONNECT YOUR DEVICES

Четыре способа открыть Mission Control

01FIELD DEFAULT

Laptop over Wi‑Fi

Подключиться к SSID KAIROS-GS-abc123 и открыть http://10.0.0.1:4000.

02WIRED

Laptop over USB

CDC-NCM tether, открыть http://192.168.7.1:4000; macOS Sonoma+, Windows 11 и Linux native.

03NO LAPTOP

HDMI kiosk

Chromium kiosk на подключённом display; USB gamepad остаётся у Ground Agent.

04MOBILE

Phone or tablet

Browser по Wi‑Fi AP; KairOS Android app — отдельный track и не обязательна.

Windows 10 может потребовать RNDIS driver вместо native CDC-NCM. На любом пути оператор должен понимать, какой интерфейс несёт video, какой — telemetry и какой обладает command authority.

PHYSICAL UI

OLED показывает пять групп состояния

Экран	Поля
Link	WFB signal, FEC, packet loss, bitrate
Drone	FC connection, armed, mode, battery, GPS
GCS	Connected clients и video streams
Net	Uplinks, IP addresses и data usage
System	CPU, RAM, temperature, disk, uptime

Control	Short press	Long press
Up / Down	Navigate screens	—
Select	Open detail / confirm	Enter setup mode
Back	Return	Confirmed factory reset flow

SETUP WIZARD

Radio, uplink и локальная безопасность

WFB channel

Выберите тот же channel, что у air-side transmitter; различие каналов означает отсутствие video.

External Wi‑Fi

Optional client network для update/cloud, не заменяющий field AP.

Cloud account

Optional pairing/relay; local receive продолжает работать без него.

AP passphrase

Целевой образ создаёт уникальную per-unit passphrase при первом запуске и показывает её оператору через локальный setup flow.

UPLINK MATRIX

Пять сетевых путей с наблюдаемым failover

Uplink	Роль
Wi‑Fi AP	Локальные operator clients
Wi‑Fi client	Внешняя сеть и optional cloud
Ethernet	Проводной LAN/backhaul
USB tether	Прямой data path к laptop
SIM7600G-H 4G	Optional cellular backhaul

Целевой контур предусматривает priority failover, health checks и настраиваемый лимит мобильного трафика. Порядок путей, metering и failover должны быть протестированы и доступны оператору как явное состояние, а не скрытая автоматика.

TROUBLESHOOTING

AP, WFB и USB tether диагностируются отдельно

bashWi-Fi AP

sudo systemctl status kairos-hostapd
iwconfig

Целевой интерфейс KairOS: команда становится исполнимой только после выпуска соответствующего компонента.

bashWFB receive and monitor mode

journalctl -u kairos-wfb -n 30 --no-pager
iwconfig wlan1

Целевой интерфейс KairOS: команда становится исполнимой только после выпуска соответствующего компонента.

bashUSB gadget

ls /sys/kernel/config/usb_gadget/kairos-ncm 2>/dev/null
sudo systemctl restart kairos-usb-gadget-setup

Целевой интерфейс KairOS: команда становится исполнимой только после выпуска соответствующего компонента.

Если AP отсутствует, проверьте hostapd и конфликт interface roles.
Если video отсутствует, сверяйте channel, keys, monitor mode и air-side TX before browser debugging.
Если USB tether не появляется, проверьте cable data lines, gadget config и client OS driver.
Не перезапускайте radio/control services во время активного полёта без предусмотренного fallback.