#bezpiLOTa Ground Agent se diseña como componente de campo asociado con perfil ground-station: recibe WFB-ng, ofrece punto de acceso Wi-Fi y conexión compartida USB, admite quiosco HDMI y muestra estado en OLED con botones físicos.
Ground Agent no es un producto de KairOS; el protocolo común de interacción y el perfil terrestre requieren una compilación y verificación específicas del ecosistema.
Repositorio de KairOS ↗En esta página +
Puente entre el enlace de radio y los dispositivos del operador
A bordo, Drone Agent codifica el vídeo y transmite el flujo de radio. Ground Agent, con un adaptador Wi-Fi compatible en modo monitor, recibe paquetes WFB-ng, reconstruye el flujo con FEC y lo publica en la red local. El portátil o teléfono se conecta al punto de acceso o conexión compartida y abre Mission Control.
El perfil terrestre no necesita controlador de vuelo. La detección automática usa como indicios del rol la presencia de adaptador receptor, la ausencia de FC, OLED y botones. La selección explícita se guarda en /etc/kairos/config.yaml.
Banco mínimo y equipo de campo autónomo
| Escenario | Componentes |
|---|---|
| Mínimo de banco | Raspberry Pi 4B de 2 GB o más; adaptador USB RTL8812EU; 2 antenas SMA de 5,8 GHz; cable USB-C de datos; alimentación externa estable |
| Campo autónomo | Equipo de banco + OLED SSD1306 I²C de 1,3 pulgadas; cuatro botones; pantalla HDMI; mando USB |
| Lado aéreo | SBC Drone Agent; adaptador WFB-ng TX; cámara; canal/clave coincidentes; enlace FC si se requiere telemetría o control |
De un sistema operativo nuevo al perfil ground-station
Grabar el sistema operativo
Pi 4B: Raspberry Pi OS Lite Bookworm de 64 bits. Radxa: imagen Debian/Ubuntu del fabricante.
Arranque + SSH
Conecte la red, localice el nombre de host/IP e inicie sesión por SSH.
Conectar la radio
Conecte el RTL8812EU con sus antenas antes de poner la interfaz en modo monitor.
Verificar USB
lsusb debe mostrar un dispositivo Realtek, habitualmente con ID 0bda:8812.
Ejecutar la instalación generada
La herramienta de flasheo selecciona Ground Agent y la placa y después proporciona el comando actual de KairOS.
Confirmar rol
Compruebe el perfil ground-station y los servicios activos de recepción, punto de acceso y conexión compartida.
ssh pi@kairos-ground.local
# или
ssh pi@192.168.1.XX
lsusb | grep -i realtekkairos statusQué servicios y direcciones debe mostrar el estado
| Elemento | Literal previsto de KairOS |
|---|---|
| Perfil | ground-station |
| Servicios | kairos-supervisor, kairos-api, kairos-health, kairos-wfb-rx, kairos-hostapd |
| Punto de acceso | SSID KAIROS-GS-abc123 |
| Canal WFB | 161 / 5805 MHz en el ejemplo |
| Dirección del punto de acceso | 10.0.0.1 |
Cuatro formas de abrir Mission Control
Portátil por Wi-Fi
Conectarse al SSID KAIROS-GS-abc123 y abrir http://10.0.0.1:4000.
Portátil por USB
Conexión compartida CDC-NCM; abrir http://192.168.7.1:4000; soporte nativo en macOS Sonoma+, Windows 11 y Linux.
Quiosco HDMI
Quiosco Chromium en la pantalla conectada; el mando USB permanece en Ground Agent.
Teléfono o tableta
Navegador por punto de acceso Wi-Fi; la aplicación Android KairOS es una línea independiente y no es obligatoria.
Windows 10 puede requerir un controlador RNDIS en lugar de CDC-NCM nativo. En cualquier vía, el operador debe saber qué interfaz transporta vídeo, cuál telemetría y cuál tiene autoridad de mando.
OLED muestra cinco grupos de estado
| Pantalla | Campos |
|---|---|
| Enlace | Señal WFB, FEC, pérdida de paquetes y tasa de bits |
| Dron | Conexión del FC, armado, modo, batería y GPS |
| GCS | Clientes conectados y flujos de vídeo |
| Red | Enlaces ascendentes, direcciones IP y uso de datos |
| Sistema | CPU, RAM, temperatura, disco y tiempo activo |
| Control | Pulsación corta | Pulsación larga |
|---|---|---|
| Arriba / Abajo | Navegar por pantallas | — |
| Seleccionar | Abrir detalle / confirmar | Entrar en modo de configuración |
| Atrás | Volver | Flujo confirmado de restablecimiento de fábrica |
Radio, enlace ascendente y seguridad local
Canal WFB
Elija el mismo canal que el transmisor a bordo; canales distintos significan ausencia de vídeo.
Wi-Fi externa
Red cliente opcional para actualizaciones y nube, sin sustituir el punto de acceso de campo.
Cuenta en la nube
Emparejamiento y retransmisión opcionales; la recepción local sigue funcionando sin ellos.
Contraseña del punto de acceso
La imagen prevista crea una contraseña única por unidad en el primer arranque y la muestra al operador mediante el flujo de configuración local.
Cinco vías de red con conmutación observable
| Enlace ascendente | Rol |
|---|---|
| Punto de acceso Wi-Fi | Clientes locales del operador |
| Cliente Wi-Fi | Red externa y nube opcional |
| Ethernet | LAN troncal por cable |
| Conexión compartida USB | Ruta directa de datos al portátil |
| SIM7600G-H 4G | Enlace troncal celular opcional |
El sistema previsto contempla conmutación por prioridades, comprobaciones de salud y límite configurable de tráfico móvil. El orden de las vías, la medición y la conmutación deben probarse y mostrarse al operador como estado explícito, no como automatismo oculto.
Diagnosticar por separado punto de acceso, WFB y conexión compartida 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 no aparece el punto de acceso, compruebe hostapd y conflictos entre roles de interfaz.
- Si falta vídeo, compruebe canal, claves, modo monitor y transmisor a bordo antes de depurar el navegador.
- Si no aparece la conexión compartida USB, compruebe líneas de datos del cable, configuración gadget y controlador del sistema cliente.
- No reinicie servicios de radio o control durante un vuelo activo sin una alternativa prevista.