ধারণা ও উন্নয়নমানববিহীন ক্রীড়া · #bezpiLOTa · KAIROS DRONE AGENTনথিপত্র
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প্রোফাইল
01
Ground Agent কী

Radio link ও operator devices-এর bridge

Air side-এ Drone Agent ভিডিও encode করে radio stream পাঠায়। Compatible Wi‑Fi adapter-সহ Ground Agent monitor mode-এ WFB-ng packets গ্রহণ করে, FEC দিয়ে stream recover করে local network-এ প্রকাশ করে। Laptop বা phone AP/tether-এ যুক্ত হয়ে Mission Control খোলে।

Ground profile-এর flight controller দরকার নেই। Auto-detection receive adapter, FC-এর অনুপস্থিতি, OLED ও buttons-কে role signals হিসেবে ধরে। Explicit override /etc/kairos/config.yaml-এ থাকে।

02
প্রয়োজনীয় hardware

ন্যূনতম bench ও standalone field kit

পরিস্থিতিComponents
ন্যূনতম benchRaspberry Pi 4B 2 GB+; RTL8812EU USB adapter; 2× 5.8 GHz SMA antennas; USB-C data cable; স্থিতিশীল external power
Standalone fieldBench kit + 1.3″ SSD1306 I²C OLED; চার buttons; HDMI display; USB gamepad
Air sideDrone Agent SBC; WFB-ng TX adapter; camera; matching channel/key; telemetry/control চাইলে FC link
03
Installation

নতুন OS থেকে ground-station profile

01

OS flash করুন

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

02

Boot + SSH

Network যুক্ত করে hostname/IP খুঁজুন এবং SSH login করুন।

03

Radio যুক্ত করুন

Interface monitor mode-এ দেওয়ার আগে antennas-সহ RTL8812EU যুক্ত করুন।

04

USB যাচাই করুন

lsusb-তে Realtek device দেখা উচিত, সাধারণ ID 0bda:8812।

05

Generated install চালান

Flash Tool Ground Agent ও board বেছে বর্তমান KairOS command দেয়।

06

Role নিশ্চিত করুন

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 চালানো যাবে।
04
প্রত্যাশিত project state

Status-এ কোন services ও addresses দেখাবে

বিষয়KairOS target literal
প্রোফাইলground-station
সেবাসমূহkairos-supervisor, kairos-api, kairos-health, kairos-wfb-rx, kairos-hostapd
Access pointSSID KAIROS-GS-abc123
WFB channelউদাহরণে 161 / 5805 MHz
AP address10.0.0.1
05
আপনার devices যুক্ত করুন

Mission Control খোলার চার উপায়

01Field default

Wi‑Fi-এ laptop

SSID KAIROS-GS-abc123-এ যুক্ত হয়ে http://10.0.0.1:4000 খুলুন।

02তারযুক্ত

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

Phone বা tablet

Wi‑Fi AP-তে browser; KairOS Android app পৃথক track, বাধ্যতামূলক নয়।

Windows 10-এ native CDC-NCM-এর বদলে RNDIS driver লাগতে পারে। প্রতিটি path-এ operator বুঝবেন কোন interface ভিডিও, কোনটি telemetry বহন করে এবং কার command authority আছে।

06
Physical UI

OLED পাঁচটি state groups দেখায়

স্ক্রিনFields
লিংকWFB signal, FEC, packet loss ও bitrate
ড্রোনFC connection, armed state, mode, battery, GPS
GCSConnected clients ও ভিডিও streams
NetworkUplinks, IP addresses ও data usage
সিস্টেমCPU, RAM, temperature, disk ও uptime
নিয়ন্ত্রণঅল্প চাপদীর্ঘ চাপ
ওপরে / নিচেScreens-এ চলুন—
নির্বাচনDetails খুলুন / confirm করুনSetup mode-এ যান
পিছনেফিরুনConfirmation-সহ factory reset flow
07
Setup wizard

Radio, uplink ও local নিরাপত্তা

01

WFB channel

Air-side transmitter-এর একই channel বেছে নিন; channel ভিন্ন হলে ভিডিও থাকবে না।

02

বাহ্যিক Wi‑Fi

Update/cloud-এর optional client network, field AP-এর বদলি নয়।

03

Cloud account

Optional pairing/relay; এটি ছাড়াও local reception চলবে।

04

AP passphrase

লক্ষ্য image first boot-এ unique per-unit passphrase বানিয়ে local setup flow-তে operator-কে দেখায়।

09
সমস্যা সমাধান

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 দেখুন।
  • Planned fallback ছাড়া active flight-এ radio/control services restart করবেন না।