CONCEPTO Y DESARROLLODEPORTE NO TRIPULADO · #bezpiLOTa · KAIROS DRONE AGENTDocumentación
#bezpiLOTa→Drone Agent→Configuración y estado
KairOS / DRONE AGENT / 02

El agente ofrece una aplicación web de configuración orientada a móviles por la red local y un panel de estado de solo lectura por SSH. Ambas interfaces, Mission Control y el acceso desde Android leen un mismo objeto de estado, por lo que el operador ve información coherente.

PREVISTO

El modelo de configuración local está definido como contrato previsto; la compilación de KairOS y las direcciones de los servicios requieren verificación.

Repositorio de KairOS ↗
LOCALvía principal
01objeto de estado compartido
05superficies de acceso
READ-ONLYmodo de terminal
01
APLICACIÓN WEB DE CONFIGURACIÓN

Un único flujo de configuración orientado a móviles

El propio agente sirve la aplicación web, que se abre desde un teléfono, tableta o portátil. El escenario local básico no necesita Internet ni cuenta en la nube. El asistente guía desde la identificación del dispositivo hasta el traspaso de la conexión a Mission Control.

01

Identificación

Nombre del dispositivo, rol, perfil de placa, versión del agente y progreso general de incorporación.

02

MAVLink

Estado del FC, firmware, ruta serie, velocidad de transmisión, heartbeat y URL WebSocket.

03

Vídeo

Cámara o receptor, URL WHEP, grabación, tasa de bits, formato y estado del enlace.

04

Red

Punto de acceso, LAN, conexión compartida USB, mDNS, Ethernet, cliente Wi-Fi y módem celular.

05

Acceso remoto

Token opcional de túnel en la nube, estado del túnel y URL publicadas.

06

Sistema

Servicios, registros, versión, resumen de soporte y acciones de recuperación con confirmación.

Configuración del agente: conexión MAVLink a ArduCopter, puerto serie, Wi-Fi y LTE, puertos de red, restricciones geográficas y mapa de misión.
INTERFAZ / EJEMPLO VISUALParámetros del agente en el navegador

La pantalla reúne estado MAVLink, puerto serie detectado, parámetros de red y límites de la zona de trabajo. Estos grupos corresponden a los pasos de configuración del dispositivo.

02
PANEL DE ESTADO

El terminal no modifica deliberadamente la configuración activa

El comando kairos abre un panel compacto que muestra rol, versión, estado del FC, vídeo, enlace y nube, además de la URL local de configuración. Los cambios se realizan en la aplicación web con campos y confirmaciones explícitos. Este enfoque de solo lectura reduce el riesgo de comandos accidentales durante el soporte remoto.

textPanel de estado previsto de 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
Interfaz prevista de KairOS: el comando solo será ejecutable cuando se publique el componente correspondiente.
ComandoFinalidad
kairosAbrir el panel de solo lectura y mostrar las URL locales
kairos statusMostrar de forma compacta configuración, MAVLink, vídeo, red y servicios
kairos status --jsonDevolver datos de estado para scripts y soporte
kairos updateBuscar e instalar una versión publicada de KairOS
kairos uninstallEliminar el agente KairOS del sistema
03
PRIMERO LAS VÍAS LOCALES

Cinco vías de acceso; la nube es secundaria

DirecciónFinalidad
http://<board-ip>:8080Aplicación web de configuración y estado por LAN
http://<hostname>.local:8080mDNS en la misma red
http://192.168.4.1:8080Punto de acceso del agente antes de configurar una red externa
ws://<board-ip>:8765Retransmisor WebSocket de MAVLink sin procesar
http://<board-ip>:8889/<cam>/whepVídeo WebRTC mediante WHEP

La vía preferente es la IP de la placa, la conexión compartida USB o el punto de acceso. mDNS resulta práctico, pero depende del sistema operativo del cliente y de la red local. El túnel en la nube se activa solo para acceso remoto; un retransmisor desactivado en modo local es un estado normal, no un error.

04
UNA FUENTE DE VERDAD

Objeto de estado compartido por todas las interfaces

  • La aplicación web de configuración muestra la incorporación completa y los cambios autorizados.
  • La CLI ofrece un resumen seguro de solo lectura y JSON para soporte.
  • Mission Control utiliza los mismos campos para añadir y diagnosticar nodos.
  • Android u otro mecanismo de traspaso abre la misma URL local, sin crear una configuración independiente.
  • El resumen de soporte reúne versión, perfil, servicios, red, MAVLink y vídeo sin revelar secretos.
Estado del agente en GCS: cámara, Raspberry Pi 5, arquitectura aarch64, conexión con el FC y gráficas de CPU, memoria y disco.
INTERFAZ / EJEMPLO VISUALResumen de estado en el GCS

Placa, versión, conexión con el FC y recursos del sistema se muestran junto a la cámara: ejemplo de interfaz del operador para un objeto de estado compartido.