#bezpiLOTa Ground Agent est un composant voisin de terrain au profil ground-station : réception WFB-ng, point d’accès Wi-Fi, partage USB, kiosque HDMI et état sur OLED avec boutons physiques.
Ground Agent n’est pas un produit KairOS ; protocole commun et profil sol exigent une compilation et une validation distinctes de l’écosystème.
Dépôt KairOS ↗Sur cette page +
Un pont entre liaison radio et appareils opérateur
À bord, Drone Agent encode la vidéo et émet le flux radio. Ground Agent utilise un adaptateur Wi-Fi compatible en mode moniteur, reçoit les paquets WFB-ng, reconstruit le flux par FEC et le publie sur le réseau local. Ordinateur ou téléphone rejoint AP/partage et ouvre Mission Control.
Le profil sol ne nécessite pas de FC. La détection exploite adaptateur récepteur, absence de FC, OLED et boutons comme indices. Un choix explicite est conservé dans /etc/kairos/config.yaml.
Kit de banc minimal et kit de terrain autonome
| Scénario | Composants |
|---|---|
| Minimum au banc | Raspberry Pi 4B 2 Go+ ; adaptateur USB RTL8812EU ; 2 antennes SMA 5,8 GHz ; câble USB-C de données ; alimentation externe stable |
| Terrain autonome | Kit de banc + OLED I²C SSD1306 1,3″ ; quatre boutons ; écran HDMI ; manette USB |
| Côté embarqué | SBC Drone Agent ; adaptateur WFB-ng TX ; caméra ; canal/clé concordants ; liaison FC si télémétrie/commande nécessaire |
D’un OS neuf au profil ground-station
Flasher l’OS
Pi 4B : Raspberry Pi OS Lite Bookworm 64 bits. Radxa : image Debian/Ubuntu constructeur.
Démarrage et SSH
Connectez le réseau, trouvez hôte/IP et connectez-vous par SSH.
Raccorder la radio
Raccordez RTL8812EU avec antennes avant de passer l’interface en mode moniteur.
Vérifier USB
lsusb doit montrer un périphérique Realtek, généralement ID 0bda:8812.
Lancer l’installation générée
Flash Tool choisit Ground Agent et la carte puis fournit la commande KairOS actuelle.
Confirmer le rôle
Vérifiez le profil ground-station et les services réception/AP/partage activés.
ssh pi@kairos-ground.local
# или
ssh pi@192.168.1.XX
lsusb | grep -i realtekkairos statusServices et adresses attendus dans l’état
| Élément | Littéral cible KairOS |
|---|---|
| Profil | ground-station |
| Services | kairos-supervisor, kairos-api, kairos-health, kairos-wfb-rx, kairos-hostapd |
| Point d’accès | SSID KAIROS-GS-abc123 |
| Canal WFB | 161 / 5805 MHz dans l’exemple |
| Adresse AP | 10.0.0.1 |
Quatre façons d’ouvrir Mission Control
Ordinateur par Wi-Fi
Connectez-vous au SSID KAIROS-GS-abc123 et ouvrez http://10.0.0.1:4000.
Ordinateur par USB
Partage CDC-NCM, ouvrir http://192.168.7.1:4000 ; prise en charge native macOS Sonoma+, Windows 11 et Linux.
Kiosque HDMI
Kiosque Chromium sur écran connecté ; la manette USB reste sur Ground Agent.
Téléphone ou tablette
Navigateur par AP Wi-Fi ; l’application Android KairOS est une piste distincte facultative.
Windows 10 peut exiger un pilote RNDIS plutôt que CDC-NCM natif. L’opérateur doit toujours savoir quelle interface porte vidéo, télémétrie et autorité de commande.
L’OLED présente cinq groupes d’état
| Écran | Champs |
|---|---|
| Liaison | Signal WFB, FEC, pertes de paquets, débit |
| Drone | Connexion FC, armement, mode, batterie, GPS |
| GCS | Clients connectés et flux vidéo |
| Réseau | Liaisons montantes, adresses IP et consommation de données |
| Système | CPU, RAM, température, disque, durée de fonctionnement |
| Commande | Appui court | Appui long |
|---|---|---|
| Haut / Bas | Parcourir les écrans | — |
| Sélectionner | Ouvrir le détail / confirmer | Entrer en configuration |
| Retour | Revenir | Réinitialisation d’usine confirmée |
Radio, liaison montante et sécurité locale
Canal WFB
Choisissez le même canal que l’émetteur embarqué ; des canaux différents signifient absence de vidéo.
Wi-Fi externe
Réseau client facultatif pour mises à jour/cloud, sans remplacer l’AP de terrain.
Compte cloud
Appairage/relais facultatif ; la réception locale fonctionne sans lui.
Phrase secrète AP
L’image cible crée une phrase secrète unique par appareil au premier démarrage et la montre à l’opérateur dans la configuration locale.
Cinq chemins réseau avec basculement observable
| Liaison montante | Rôle |
|---|---|
| Point d’accès Wi-Fi | Clients opérateur locaux |
| Client Wi-Fi | Réseau externe et cloud facultatif |
| Ethernet | LAN/liaison de collecte filaire |
| Partage USB | Chemin direct vers un ordinateur |
| SIM7600G-H 4G | Liaison cellulaire de collecte facultative |
La cible prévoit basculement prioritaire, contrôles de santé et limite mobile réglable. Ordre, comptage et basculement doivent être testés et visibles comme état explicite, pas comme automatisation cachée.
Diagnostiquer séparément AP, WFB et partage USB
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- Si l’AP manque, vérifiez hostapd et les conflits de rôles d’interface.
- Sans vidéo, comparez canal, clés, mode moniteur et TX embarqué avant le navigateur.
- Sans partage USB, vérifiez lignes de données du câble, configuration gadget et pilote du système client.
- Ne redémarrez pas les services radio/commande en vol actif sans repli prévu.