Gestión de DJI
Admin → DJI (/admin/dji) es la superficie de control a nivel org para
cada dock DJI (Dock 1, Dock 2, Dock 3) emparejado a la org. Es
intencionalmente estrecha — emparejamiento, estado, debug, firmware, HMS, áreas
de vuelo y licencias solamente. Todo el mando y control (tareas de vuelo, streams
en vivo, pilotaje DRC, reconocimiento IA) ocurre a nivel de misión; una
aeronave emparejada aparece dentro de una misión como un peer TACLINK dji-dock-{sn}
y se comporta como cualquier otro drone.
Requiere admin o superadmin.
Layout
Dos paneles — lista de docks a la izquierda, pestañas de detalle del dock seleccionado a la
derecha. La cabecera muestra {onlineDockCount}/{totalDocks} online, un botón Emparejar
nuevo dock, y un toggle Demo dock que añade una entrada falsa
DEMO-DOCK-001 para que puedas hacer clic sin hardware.
Cada fila: punto de estado, nombre + modelo, batería %, viento (m/s), temperatura
(°C), insignia de aeronave (modelo + modo de vuelo) si está emparejada, y una insignia In Operation cuando está asignada a una misión.
Pestañas en el detalle del dock
Seis pestañas, de izquierda a derecha.
Resumen
- Tarjeta del dock — SN, modelo, estado, código de modo, versión de firmware, lat/lng,
y el enlace de operación asignada (hasta
/operations/:id). Desemparejar de la org se sitúa aquí detrás de un paso de confirmación. - Cuadrícula de telemetría ambiental — temperatura, humedad, viento, lluvia,
estado de cubierta, drone-en-dock, batería %, cargando, calidad de red (0–5),
almacenamiento usado/total. Proyecciones de Firestore del último frame MQTT
osd. - Resumen de aeronave — modo de vuelo, rumbo, velocidad, altitud, distancia al home, viento, batería %, tiempo de vuelo restante, potencia RTH, satélites GPS, satélites RTK y estado de fix. Solo lectura; para volar, abre la operación asignada.
Firmware
- Versión de firmware del dock y — si está emparejada — versión de firmware de la aeronave.
- Barra de progreso en vivo mientras
dock.firmwareUpgrade.statusesté establecido (pending, downloading, upgrading, done). - Botón Comprobar actualizaciones — dispara la petición MQTT
firmware_upgrade. El dock responde con una versión ofrecida y el usuario confirma.
Debug
Una pared de botones que envían comandos de debug MQTT al topic services del
dock — cover_open/close/force_close, drone_open/close,
device_reboot, supplement_light_*, charge_*, debug_mode_*,
alarm_state_switch, air_conditioner_mode_switch,
battery_maintenance_switch, battery_store_mode_switch, putter_*,
drone_format, device_format, sdr_workmode_switch, sim_slot_switch,
esim_activate, esim_operator_switch, rtk_calibration.
Debajo de la cuadrícula se sitúa la sección Log remoto — marca uno o más módulos (dock, aircraft, RC, gimbal, flight-control), Solicitar archivos de log, marca lo que quieras, luego Subir logs seleccionados. El progreso se transmite en vivo; un botón Cancelar aborta una subida en curso.
HMS
Lista de solo lectura de alertas activas del Health Monitoring System para el dock +
aeronave seleccionados. Cada fila muestra nivel (INFO / WARNING / CRITICAL / FATAL),
título (búsqueda localizada de código HMS) y timestamp. Los workflows y webhooks alert.hms
consumen el mismo stream subyacente.
Flight Areas (próximamente)
Pestaña placeholder para definir áreas de vuelo aprobadas por dock. Se entrega con la próxima release de integración del SDK de DJI.
Licencias (FlySafe)
Lista las licencias de desbloqueo DJI instaladas en el dock o la aeronave. El radio de
dominio elige Aircraft (0) o Dock (3). Columnas: ID de licencia, nombre,
expira. Los checkboxes controlan enable por licencia.
Empujar nueva licencia abre un formulario pequeño — URL del archivo de licencia más
huella MD5 — y envía una petición MQTT fly_zone_license_update. El
dock descarga, verifica la huella e instala.
Emparejar un nuevo dock
Emparejar nuevo dock abre un modal con tres pestañas.
- Código de emparejamiento (recomendado) — establece una etiqueta opcional, ventana de validez
(1–168 h, por defecto 24) y usos máximos (1–50, por defecto 1). Haz clic en Generar
código — ARGUS escribe
/organizations/{orgId}/pairingCodes/{code}y renderiza código + QR. En el dock, ARGUS Dock App → Emparejar con código. La tabla Códigos activos lista los códigos en vivo con historial de redención y un botón Revocar. - Manual — pega un SN de dock y un SN de aeronave. Escribe el emparejamiento
directamente bajo
/organizations/{orgId}/docks/{sn}sin handshake. Úsalo solo cuando controles los certs MQTT fuera de banda. - Reclamar — introduce el token de reclamación de fábrica enviado con un dock preconfigurado. Equivalente a la redención de código de emparejamiento pero iniciada desde la web.
Documento de estado del dock
La fuente de verdad para cada fila es
/organizations/{orgId}/docks/{sn}. Subcolecciones:
telemetry/latest (pestaña Environment), aircraft/latest,
hmsAlerts/{id}, commands/{id} (historial de comandos con issuedBy,
status, response), logs/{requestId} (peticiones y subidas de logs remotos).
Los códigos de emparejamiento viven a nivel de org.
El inspector de tráfico MQTT (aspiracional) es un sniffer de topic crudo en la
pestaña de debug que imprime los últimos N payloads services / osd / events.
Se entrega en 2026-Q3.
Desemparejar vs. reenlazar
- Desemparejar de la org — confirmado por popover, elimina el documento
docks/{sn}, revoca los certificados MQTT y emiteadmin.dji.dock.unpairedal log de auditoría. El dock vuelve al estado de emparejamiento de fábrica y puede ser emparejado a cualquier org de nuevo. - Reenlazar (aspiracional) — mantiene los certs MQTT del dock pero mueve la referencia de la org. Útil para intercambios de servicio sin una visita de campo.