Saltearse al contenido
ARGUS User Manual

DJI Cloud API — visión general

ARGUS se integra con DJI Dock 1 / 2 / 3 a través de la API oficial DJI Cloud. Tras la vinculación, la aeronave de un dock se comporta como cualquier otro dron en la operación: aparece en el tile de flota, se muestra en los streams TACLINK + DOCKS, puede volarse manualmente mediante DRC, aplica el geofence, sube medios y recibe envíos de firmware.

Arquitectura

Cooperan cuatro servicios:

  • argus-dji — nuestro bridge MQTT en Node.js. Se conecta a un broker MQTT EMQX, gestiona todos los topics MQTT de DJI (thing/product/{sn}/osd, /state, /events, /requests, /services, /services_reply), traduce entre los mensajes Thing-Model de DJI y las representaciones internas de ARGUS, escribe el estado a Firestore y publica telemetría + vídeo como participantes TACLINK.
  • argus-api — nuestra superficie REST en Node.js. La webapp llama a argus-api; argus-api escribe documentos de comando en Firestore; argus-dji escucha los comandos y publica MQTT.
  • Firestore — almacén autoritativo de estado para dji_docks/{sn}, dji_aircraft/{sn}, dji_flight_tasks/{id}, dji_media/{id} y dji_commands/{id}.
  • EMQX — el broker MQTT al que se conectan los docks. Alojado por ARGUS.

Páginas de funcionalidades

FuncionalidadPágina
Vincular un dock a tu organizaciónVinculación
Estado del dock + controles en consolaTile del dock
Ingreso de vídeo autoaprovisionadoAuto-stream
Envío de misiones WPML-KMZTareas de vuelo
Control manual en tiempo realDRC
Cadena multi-dock de largo alcanceRelay multi-dock
Sincronización de polígonos → aplicación a nivel de aeronaveGeofence / no-fly
Licencias de desbloqueo DJI FlySafeFlySafe
Subida de binarios de firmware + envíoFirmware
Extracción de logs de diagnósticoLogs remotos
Fotos / vídeos / PPK-RTKMedios
Detecciones de IA en la aeronaveDetecciones de IA

Configuración de organización requerida

Antes de poder vincular tu primer dock, un admin de la organización necesita:

  • DJI App ID / App Key / App License — obtenidos del DJI Developer Center tras registrar tu organización una app Cloud-API.
  • Endpoint + credenciales de EMQX — por defecto ARGUS aprovisiona un EMQX compartido. Las organizaciones con requisitos de cumplimiento pueden aprovisionar un broker dedicado.
  • Un asiento de licencia libre en la cuota de docks DJI de tu organización.

Los tres se encuentran en Admin → Organización → Integraciones → DJI.

Modelos de dock soportados

  • Dock 1 — probado de extremo a extremo. Limitado por la superficie Dock-1 de la API DJI Cloud (sin DRC, menos campos de telemetría).
  • Dock 2 — soporte completo incluyendo DRC + auto-stream.
  • Dock 3 — soporte completo + funcionalidades específicas de Dock-3 (visión nocturna, foco, altavoz, detección de IA en la aeronave).

Ciclo de vida de extremo a extremo

  1. El admin vincula un dock (flujo de código QR).
  2. El dock se conecta a EMQX y envía la topología vía update_topo.
  3. argus-dji lo recibe y escribe dji_docks/{sn} + dji_aircraft/{sn}.
  4. El operador asigna el dock a una misión → se establece dji_docks/{sn}.missionId.
  5. El piloto automático de auto-stream aprovisiona ingreso WHIP y publica live_start_push al dock.
  6. El dock envía H.264 a la sala TACLINK.
  7. El operador vuela mediante DRC o envía una misión WPML.
  8. El dock sube medios durante / después del vuelo.
  9. Misión finalizada → el auto-stream se desmantela y se elimina el ingreso.

Relacionado