#bezpiLOTa Ground Agent dirancang sebagai komponen lapangan terkait menggunakan profil ground-station: menerima WFB-ng, menyediakan AP Wi-Fi dan tethering USB, mendukung kios HDMI, serta menampilkan status pada OLED dengan tombol fisik.
Ground Agent bukan produk KairOS; protokol interaksi bersama dan profil darat memerlukan build serta validasi ekosistem tersendiri.
Repositori KairOS ↗Pada halaman ini +
Jembatan antara tautan radio dan perangkat operator
Di sisi udara, Drone Agent mengodekan video dan memancarkan aliran radio. Ground Agent menggunakan adaptor Wi-Fi kompatibel dalam mode monitor, menerima paket WFB-ng, merekonstruksi aliran dengan FEC, lalu memublikasikannya ke jaringan lokal. Laptop atau ponsel terhubung ke AP/tether dan membuka Mission Control.
Profil darat tidak memerlukan pengendali penerbangan. Deteksi otomatis menggunakan adaptor penerima, ketiadaan FC, OLED, dan tombol sebagai petunjuk peran. Penggantian eksplisit disimpan dalam /etc/kairos/config.yaml.
Perangkat meja minimal dan perangkat lapangan mandiri
| Skenario | Komponen |
|---|---|
| Minimum untuk meja uji | Raspberry Pi 4B 2 GB+; adaptor USB RTL8812EU; 2× antena SMA 5,8 GHz; kabel data USB-C; daya eksternal stabil |
| Lapangan mandiri | Perangkat meja + OLED I²C SSD1306 1,3″; empat tombol; layar HDMI; gamepad USB |
| Sisi udara | SBC Drone Agent; adaptor TX WFB-ng; kamera; kanal/kunci yang sesuai; tautan FC jika telemetri/kendali diperlukan |
Dari OS baru ke profil ground-station
Tulis image OS
Pi 4B: Raspberry Pi OS Lite Bookworm 64-bit. Radxa: image Debian/Ubuntu dari vendor.
Boot + SSH
Hubungkan jaringan, temukan nama host/IP, lalu masuk melalui SSH.
Pasang radio
Hubungkan RTL8812EU beserta antena sebelum mengalihkan antarmuka ke mode monitor.
Verifikasi USB
lsusb seharusnya menampilkan perangkat Realtek, biasanya ID 0bda:8812.
Jalankan instalasi yang dihasilkan
Flash Tool memilih Ground Agent dan papan, lalu menyediakan perintah KairOS terkini.
Konfirmasi peran
Periksa profil ground-station dan layanan penerima/AP/tether yang aktif.
ssh pi@kairos-ground.local
# или
ssh pi@192.168.1.XX
lsusb | grep -i realtekkairos statusLayanan dan alamat yang seharusnya ditampilkan status
| Item | Literal KairOS yang ditargetkan |
|---|---|
| Profil | ground-station |
| Layanan | kairos-supervisor, kairos-api, kairos-health, kairos-wfb-rx, kairos-hostapd |
| Titik akses | SSID KAIROS-GS-abc123 |
| Kanal WFB | 161 / 5805 MHz dalam contoh |
| Alamat AP | 10.0.0.1 |
Empat cara membuka Mission Control
Laptop melalui Wi-Fi
Hubungkan ke SSID KAIROS-GS-abc123 dan buka http://10.0.0.1:4000.
Laptop melalui USB
Tethering CDC-NCM, buka http://192.168.7.1:4000; dukungan natif pada macOS Sonoma+, Windows 11, dan Linux.
Kios HDMI
Kios Chromium pada layar yang terhubung; gamepad USB tetap tersambung ke Ground Agent.
Ponsel atau tablet
Peramban melalui AP Wi-Fi; aplikasi Android KairOS merupakan jalur pengembangan terpisah dan bersifat opsional.
Windows 10 mungkin memerlukan driver RNDIS sebagai pengganti CDC-NCM natif. Pada setiap jalur, operator harus memahami antarmuka yang membawa video, yang membawa telemetri, dan yang memegang kewenangan perintah.
OLED menampilkan lima kelompok status
| Layar | Isian |
|---|---|
| Tautan | Sinyal WFB, FEC, kehilangan paket, bitrate |
| Drone | Koneksi FC, armed, mode, baterai, GPS |
| GCS | Klien yang terhubung dan aliran video |
| Jaringan | Uplink, alamat IP, dan penggunaan data |
| Sistem | CPU, RAM, suhu, disk, waktu aktif |
| Kendali | Tekan singkat | Tekan lama |
|---|---|---|
| Atas / Bawah | Berpindah layar | — |
| Pilih | Buka detail / konfirmasi | Masuk ke mode konfigurasi |
| Kembali | Kembali | Alur reset pabrik dengan konfirmasi |
Radio, uplink, dan keamanan lokal
Kanal WFB
Pilih kanal yang sama dengan pemancar sisi udara; kanal berbeda berarti tidak ada video.
Wi-Fi eksternal
Jaringan klien opsional untuk pembaruan/cloud, tanpa menggantikan AP lapangan.
Akun cloud
Pemasangan/relai opsional; penerimaan lokal berlanjut tanpanya.
Frasa sandi AP
Image yang ditargetkan membuat frasa sandi unik per unit pada boot pertama dan menampilkannya kepada operator melalui alur konfigurasi lokal.
Lima jalur jaringan dengan failover yang dapat dipantau
| Uplink | Peran |
|---|---|
| AP Wi-Fi | Klien operator lokal |
| Klien Wi-Fi | Jaringan eksternal dan cloud opsional |
| Ethernet | LAN/backhaul berkabel |
| Tether USB | Jalur data langsung ke laptop |
| SIM7600G-H 4G | Backhaul seluler opsional |
Sistem yang ditargetkan menyediakan failover berdasarkan prioritas, pemeriksaan kesehatan, dan batas data seluler yang dapat dikonfigurasi. Urutan jalur, pengukuran penggunaan, dan failover harus diuji dan terlihat oleh operator sebagai keadaan eksplisit, bukan otomatisasi tersembunyi.
Diagnosis AP, WFB, dan tethering USB secara terpisah
sudo systemctl status kairos-hostapd
iwconfigjournalctl -u kairos-wfb -n 30 --no-pager
iwconfig wlan1ls /sys/kernel/config/usb_gadget/kairos-ncm 2>/dev/null
sudo systemctl restart kairos-usb-gadget-setup- Jika AP tidak muncul, periksa hostapd dan konflik peran antarmuka.
- Jika video tidak muncul, bandingkan kanal, kunci, mode monitor, dan TX sisi udara sebelum men-debug peramban.
- Jika tethering USB tidak muncul, periksa jalur data kabel, konfigurasi gadget, dan driver OS klien.
- Jangan memulai ulang layanan radio/kendali selama penerbangan aktif tanpa jalur cadangan yang ditetapkan.