Quickstart / Ground Agent

#bezpiLOTa Ground Agent ground-station profile में अलग field component के रूप में बनाया जा रहा है: WFB-ng प्राप्त करता है, Wi‑Fi AP और USB tether देता है, HDMI kiosk support करता है तथा physical buttons वाले OLED पर status दिखाता है।

नियोजित

Ground Agent KairOS का उत्पाद नहीं है; shared interaction protocol और ground profile के लिए ecosystem का अलग build और verification आवश्यक है।

KairOS repository ↗

WFB-NGRadio reception

4Client paths

OLEDवैकल्पिक physical UI

GROUNDप्रोफ़ाइल

इस पृष्ठ पर +

Ground Agent क्या है

Radio link और operator devices के बीच bridge

Air side पर Drone Agent वीडियो encode करके radio stream भेजता है। संगत Wi‑Fi adapter वाला Ground Agent monitor mode में WFB-ng packets प्राप्त करता है, FEC से stream recover करके local network में प्रकाशित करता है। Laptop या फ़ोन AP/tether से जुड़कर Mission Control खोलता है।

Ground profile को flight controller नहीं चाहिए। Auto-detection receive adapter, FC का अभाव, OLED और buttons को role संकेत मानता है। Explicit override /etc/kairos/config.yaml में रहता है।

आवश्यक hardware

न्यूनतम bench और standalone field kit

परिदृश्य	Components
न्यूनतम bench	Raspberry Pi 4B 2 GB+; RTL8812EU USB adapter; 2× 5.8 GHz SMA antennas; USB-C data cable; स्थिर बाहरी power
स्वतंत्र field उपयोग	Bench kit + 1.3″ SSD1306 I²C OLED; चार buttons; HDMI display; USB gamepad
वाहन की ओर	Drone Agent SBC; WFB-ng TX adapter; camera; matching channel/key; telemetry/control चाहिए तो FC link

Installation

नए OS से ground-station profile तक

OS flash करें

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

Boot + SSH

Network जोड़ें, hostname/IP खोजें और SSH login करें।

Radio जोड़ें

Interface monitor mode में करने से पहले antennas सहित RTL8812EU जोड़ें।

USB जाँचें

lsusb में Realtek device दिखना चाहिए, सामान्य ID 0bda:8812।

Generated installer चलाएँ

Flash Tool Ground Agent और board चुनकर current KairOS command देता है।

Role confirm करें

Ground-station profile और enabled receive/AP/tether services जाँचें।

bashलक्षित login और adapter जाँच

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

lsusb | grep -i realtek

KairOS का लक्षित interface: संबंधित component के release के बाद ही command चलाने योग्य होगी।

bashAgent और services जाँचें

kairos status

KairOS का लक्षित interface: संबंधित component के release के बाद ही command चलाने योग्य होगी।

अपेक्षित project state

Status में कौन सी services और addresses दिखने चाहिए

मद	KairOS target literal
प्रोफ़ाइल	ground-station
सेवाएँ	kairos-supervisor, kairos-api, kairos-health, kairos-wfb-rx, kairos-hostapd
Access point	SSID KAIROS-GS-abc123
WFB चैनल	उदाहरण में 161 / 5805 MHz
AP का पता	10.0.0.1

अपने devices जोड़ें

Mission Control खोलने के चार तरीके

01फील्ड का default

Wi‑Fi पर laptop

SSID KAIROS-GS-abc123 से जुड़कर http://10.0.0.1:4000 खोलें।

02Wired

USB पर laptop

CDC-NCM tether, http://192.168.7.1:4000 खोलें; macOS Sonoma+, Windows 11 और Linux में native support।

03Laptop की आवश्यकता नहीं

HDMI kiosk

जुड़े display पर Chromium kiosk; USB gamepad Ground Agent के पास रहता है।

04Mobile

फ़ोन या tablet

Wi‑Fi AP पर browser; KairOS Android app अलग track है और अनिवार्य नहीं।

Windows 10 में native CDC-NCM के बजाय RNDIS driver की आवश्यकता हो सकती है। हर path पर operator को समझना चाहिए कि कौन सा interface वीडियो, कौन telemetry ले जाता है और किसके पास command authority है।

Physical UI

OLED status के पाँच समूह दिखाता है

Screen	Fields
लिंक	WFB signal, FEC, packet loss और bitrate
ड्रोन	FC connection, armed स्थिति, mode, battery, GPS
GCS	Connected clients और वीडियो streams
Network	Uplinks, IP addresses और data usage
सिस्टम	CPU, RAM, temperature, disk और uptime

नियंत्रण	थोड़ा दबाएँ	देर तक दबाएँ
ऊपर / नीचे	Screens में जाएँ	—
चुनें	Details खोलें / confirm करें	Setup mode खोलें
पीछे	वापस	Confirmation वाला factory reset flow

Setup wizard

Radio, uplink और local सुरक्षा

WFB चैनल

Air-side transmitter वाला ही channel चुनें; अलग channels होने पर वीडियो नहीं मिलेगा।

बाहरी Wi‑Fi

Update/cloud के लिए optional client network, जो field AP की जगह नहीं लेता।

Cloud खाता

Optional pairing/relay; इसके बिना local reception चलता रहता है।

AP पासफ़्रेज़

लक्षित image पहली boot पर unique per-unit passphrase बनाकर local setup flow में operator को दिखाती है।

Uplink matrix

दिखाई देने वाले failover के साथ पाँच network paths

Uplink	भूमिका
Wi‑Fi AP	स्थानीय operator clients
Wi‑Fi client	बाहरी network और optional cloud
Ethernet	Wired LAN/backhaul
USB tether	Laptop तक direct data path
SIM7600G-H 4G	वैकल्पिक cellular backhaul

लक्षित प्रणाली में priority failover, health checks और mobile traffic की configurable limit है। Path order, metering और failover tested होने चाहिए तथा operator को स्पष्ट state के रूप में दिखने चाहिए, hidden automation के रूप में नहीं।

समस्या निवारण

AP, WFB और USB tether अलग diagnose किए जाते हैं

bashWi-Fi AP

sudo systemctl status kairos-hostapd
iwconfig

KairOS का लक्षित interface: संबंधित component के release के बाद ही command चलाने योग्य होगी।

bashWFB reception और monitor mode

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

KairOS का लक्षित interface: संबंधित component के release के बाद ही command चलाने योग्य होगी।

bashUSB gadget

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

KairOS का लक्षित interface: संबंधित component के release के बाद ही command चलाने योग्य होगी।

AP न हो तो hostapd और interface role conflicts जाँचें।
वीडियो न हो तो browser debugging से पहले channel, keys, monitor mode और air-side TX मिलाएँ।
USB tether न दिखे तो cable data lines, gadget config और client OS driver जाँचें।
नियोजित fallback के बिना active flight में radio/control services restart न करें।