#bezpiLOTa Ground Agent é concebido como um componente de campo adjacente com o perfil ground-station: recebe WFB-ng, disponibiliza AP Wi-Fi e partilha USB, suporta um quiosque HDMI e mostra o estado num OLED com botões físicos.
Ground Agent não é um produto KairOS; o protocolo de interação partilhado e o perfil terrestre exigem uma compilação e validação separadas do ecossistema.
Repositório KairOS ↗Nesta página +
Uma ponte entre a ligação de rádio e os dispositivos do operador
A bordo, Drone Agent codifica vídeo e transmite o fluxo de rádio. Ground Agent utiliza um adaptador Wi-Fi compatível em modo monitor, recebe pacotes WFB-ng, reconstrói o fluxo com FEC e publica-o na rede local. Um portátil ou telefone liga-se ao AP/partilha e abre Mission Control.
O perfil terrestre não exige controlador de voo. A deteção automática utiliza um adaptador de receção, ausência de FC, OLED e botões como sinais do papel. Uma seleção explícita é guardada em /etc/kairos/config.yaml.
Conjuntos mínimos de bancada e de campo autónomo
| Cenário | Componentes |
|---|---|
| Mínimo de bancada | Raspberry Pi 4B 2 GB+; adaptador USB RTL8812EU; 2 antenas SMA de 5,8 GHz; cabo de dados USB-C; alimentação externa estável |
| Campo autónomo | Conjunto de bancada + OLED SSD1306 I²C de 1,3″; quatro botões; ecrã HDMI; comando de jogo USB |
| A bordo | SBC com Drone Agent; adaptador WFB-ng TX; câmara; canal/chave correspondentes; ligação ao FC se forem necessários telemetria/controlo |
De um sistema operativo novo ao perfil ground-station
Grave o sistema operativo
Pi 4B: Raspberry Pi OS Lite Bookworm de 64 bits. Radxa: imagem Debian/Ubuntu do fabricante.
Arranque + SSH
Ligue a rede, encontre o nome de anfitrião/IP e inicie sessão por SSH.
Ligue o rádio
Ligue o RTL8812EU com antenas antes de colocar a interface em modo monitor.
Verifique USB
lsusb deverá mostrar um dispositivo Realtek, normalmente com ID 0bda:8812.
Execute a instalação gerada
Flash Tool seleciona Ground Agent e a placa, depois fornece o comando KairOS atual.
Confirme o papel
Verifique o perfil ground-station e os serviços de receção/AP/partilha ativados.
ssh pi@kairos-ground.local
# или
ssh pi@192.168.1.XX
lsusb | grep -i realtekkairos statusServiços e endereços que o estado deverá mostrar
| Item | Identificador KairOS previsto |
|---|---|
| Perfil | ground-station |
| Serviços | kairos-supervisor, kairos-api, kairos-health, kairos-wfb-rx, kairos-hostapd |
| Ponto de acesso | SSID KAIROS-GS-abc123 |
| Canal WFB | 161 / 5805 MHz no exemplo |
| Endereço do AP | 10.0.0.1 |
Quatro formas de abrir Mission Control
Portátil por Wi‑Fi
Ligue-se ao SSID KAIROS-GS-abc123 e abra http://10.0.0.1:4000.
Portátil por USB
Partilha CDC-NCM, abra http://192.168.7.1:4000; suporte nativo em macOS Sonoma+, Windows 11 e Linux.
Quiosque HDMI
Chromium em modo quiosque num ecrã ligado; o comando de jogo USB permanece ligado ao Ground Agent.
Telefone ou tablet
Navegador por AP Wi-Fi; a aplicação KairOS para Android é uma linha separada e opcional.
Windows 10 pode exigir um controlador RNDIS em vez de CDC-NCM nativo. Em todos os caminhos, o operador deve compreender qual a interface que transporta vídeo, qual transporta telemetria e qual detém autoridade de comando.
O OLED mostra cinco grupos de estado
| Ecrã | Campos |
|---|---|
| Ligação | Sinal WFB, FEC, perda de pacotes, débito |
| Drone | Ligação ao FC, armado, modo, bateria, GPS |
| GCS | Clientes ligados e fluxos de vídeo |
| Rede | Ligações de saída, endereços IP e utilização de dados |
| Sistema | CPU, RAM, temperatura, disco, tempo de funcionamento |
| Controlo | Pressão breve | Pressão prolongada |
|---|---|---|
| Cima / Baixo | Navegar entre ecrãs | — |
| Selecionar | Abrir detalhes / confirmar | Entrar no modo de configuração |
| Voltar | Regressar | Procedimento confirmado de reposição de fábrica |
Rádio, ligação de saída e segurança local
Canal WFB
Selecione o mesmo canal do transmissor a bordo; canais diferentes significam ausência de vídeo.
Wi‑Fi externo
Rede cliente opcional para atualizações/nuvem, sem substituir o AP de campo.
Conta na nuvem
Emparelhamento/retransmissão opcionais; a receção local continua sem eles.
Palavra-passe do AP
A imagem prevista cria uma palavra-passe única por unidade no primeiro arranque e apresenta-a ao operador através da configuração local.
Cinco caminhos de rede com comutação de reserva observável
| Ligação de saída | Papel |
|---|---|
| AP Wi‑Fi | Clientes locais do operador |
| Cliente Wi‑Fi | Rede externa e nuvem opcional |
| Ethernet | LAN/ligação de retorno com fios |
| Partilha USB | Caminho direto de dados para um portátil |
| SIM7600G-H 4G | Ligação de retorno celular opcional |
O sistema previsto disponibiliza comutação por prioridades, verificações de saúde e um limite configurável de dados móveis. A ordem dos caminhos, medição de consumo e comutação devem ser testadas e visíveis ao operador como estado explícito, em vez de automação oculta.
Diagnostique AP, WFB e partilha USB separadamente
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- Se o AP não aparecer, verifique hostapd e conflitos nos papéis das interfaces.
- Se não houver vídeo, compare o canal, chaves, modo monitor e TX a bordo antes de depurar o navegador.
- Se a partilha USB não aparecer, verifique as linhas de dados do cabo, configuração do gadget e controlador do sistema operativo cliente.
- Não reinicie serviços de rádio/controlo durante um voo ativo sem a alternativa de contingência prevista.