CONCEITO E DESENVOLVIMENTODESPORTO NÃO TRIPULADO · #bezpiLOTa · KAIROS DRONE AGENTDocumentação
#bezpiLOTa→Drone Agent→Configuração e estado
KairOS / DRONE AGENT / 02

O agente disponibiliza uma aplicação web de configuração orientada a móveis pela rede local e um painel de estado apenas de leitura por SSH. Ambas as interfaces, Mission Control e o acesso a partir de Android leem o mesmo objeto de estado, oferecendo ao operador uma visão coerente.

PREVISTO

O modelo de configuração local está definido como contrato previsto; a compilação KairOS e os endereços dos serviços exigem verificação.

Repositório KairOS ↗
LOCALvia principal
01objeto de estado comum
05superfícies de acesso
READ-ONLYmodo de terminal
01
APLICAÇÃO WEB DE CONFIGURAÇÃO

Um único fluxo de configuração orientado a móveis

O próprio agente serve a aplicação web, aberta a partir de telefone, tablet ou portátil. O cenário local principal não precisa de Internet nem conta na nuvem. O assistente guia desde a identificação do dispositivo até à transferência da ligação para Mission Control.

01

Identificação

Nome do dispositivo, papel, perfil da placa, versão do agente e progresso geral de integração inicial.

02

MAVLink

Estado do FC, firmware, caminho série, velocidade de transmissão, heartbeat e URL WebSocket.

03

Vídeo

Câmara ou recetor, URL WHEP, gravação, débito, formato e estado da ligação.

04

Rede

Ponto de acesso, LAN, partilha USB, mDNS, Ethernet, cliente Wi-Fi e modem celular.

05

Acesso remoto

Token opcional do túnel na nuvem, estado do túnel e URL publicados.

06

Sistema

Serviços, registos, versão, resumo de suporte e ações de recuperação com confirmação.

Configuração do agente: ligação MAVLink a ArduCopter, porta série, Wi-Fi e LTE, portas de rede, restrições geográficas e mapa da missão.
INTERFACE / EXEMPLO VISUALParâmetros do agente no navegador

O ecrã combina estado MAVLink, porta série detetada, configurações de rede e restrições da área de trabalho. Estes grupos correspondem às etapas de configuração do dispositivo.

02
PAINEL DE ESTADO

O terminal não altera deliberadamente a configuração ativa

O comando kairos abre um painel compacto com papel, versão, estado do FC, vídeo, ligação e nuvem, além do URL local de configuração. As alterações são feitas na aplicação web com campos e confirmações explícitos. Esta abordagem apenas de leitura reduz o risco de comandos acidentais durante suporte remoto.

textPainel de estado previsto KairOS
kairos

  KairOS Drone Agent  ·  drone  ·  v0.1.0-dev
  ─────────────────────────────────────
  FC      connected   ArduPilot 4.5
  Video   streaming   1080p30  H.264
  Link    healthy     -51 dBm
  Cloud   local mode  relay off
  ─────────────────────────────────────
  Setup   http://<board-ip>:8080
Interface prevista KairOS: o comando só será executável após o lançamento do componente correspondente.
ComandoFinalidade
kairosAbrir o painel apenas de leitura e mostrar URL locais
kairos statusMostrar configuração, MAVLink, vídeo, rede e serviços de forma compacta
kairos status --jsonDevolver dados de estado para scripts e suporte
kairos updateProcurar e instalar uma versão publicada KairOS
kairos uninstallRemover o agente KairOS do sistema
03
PRIMEIRO OS CAMINHOS LOCAIS

Cinco vias de acesso; a nuvem é secundária

EndereçoFinalidade
http://<board-ip>:8080Aplicação web de configuração e estado por LAN
http://<hostname>.local:8080mDNS na mesma rede
http://192.168.4.1:8080Ponto de acesso do agente antes de configurar a rede externa
ws://<board-ip>:8765Retransmissor WebSocket de MAVLink em bruto
http://<board-ip>:8889/<cam>/whepVídeo WebRTC por WHEP

A via prioritária é o IP da placa, a partilha USB ou o ponto de acesso. mDNS é prático, mas depende do sistema operativo do cliente e da rede local. O túnel na nuvem só é ativado para acesso remoto; retransmissão desligada no modo local é um estado normal, não um erro.

04
UMA FONTE DE VERDADE

Objeto de estado comum a todas as interfaces

  • A aplicação web mostra toda a integração inicial e as alterações permitidas.
  • A CLI fornece um resumo seguro apenas de leitura e JSON para suporte.
  • Mission Control usa os mesmos campos ao adicionar e diagnosticar um nó.
  • Android ou outro mecanismo de transferência abre o mesmo URL local, sem criar configuração separada.
  • O resumo de suporte reúne versão, perfil, serviços, rede, MAVLink e vídeo sem revelar segredos.
Estado do agente no GCS: câmara, Raspberry Pi 5, arquitetura aarch64, ligação ao FC e gráficos de CPU, memória e disco.
INTERFACE / EXEMPLO VISUALResumo de estado no GCS

Placa, versão, ligação ao FC e recursos do sistema surgem numa visão geral junto à câmara — exemplo de interface do operador para o objeto de estado partilhado.