Saltearse al contenido
ARGUS User Manual

Vincular un dock DJI

ARGUS vincula docks DJI a tu organización mediante un flujo único de código QR ejecutado en la pantalla del operador local del dock. El código lleva todo lo que el dock necesita para registrarse contra el broker MQTT de tu organización y aprovisionar sus registros Firestore — sin configuración manual en el dock.

Prerrequisitos

Antes de generar un código de vinculación, un admin de la organización debe tener estos tres campos rellenados en Admin → Organización → Integraciones → DJI:

  • DJI App Id, App Key, App License — emitidos por el DJI Developer Center cuando tu organización registra una app Cloud-API. Sin ellos, el dock puede entregarte una sesión TACLINK perfectamente válida pero rechazará iniciar cualquier misión de vuelo.
  • Un asiento de licencia libre en la cuota de docks DJI de tu organización. Las cuotas agotadas aparecen como “License exhausted” en la pantalla del dock en el momento del canje — el propio código aún se imprime.

El host, puerto y credenciales EMQX del broker MQTT los rellena ARGUS automáticamente y se exponen como sólo lectura en la pestaña Configuración manual como referencia.

Generar un código de vinculación

  1. Ve a Admin → Gestión DJI y haz clic en Vincular nuevo dock.
  2. El modal se abre en la pestaña Código de vinculación. Rellena los campos opcionales:
    • Etiqueta — un nombre legible mostrado en la tabla de códigos (por ejemplo, Dock A del techo).
    • Válido por (horas) — TTL, por defecto 24 h, máximo 168 h.
    • Usos máximos — por defecto 1. Aumenta esto para un lote de aprovisionamiento.
  3. Haz clic en Generar código. ARGUS llama a POST /api/dji/pairing-codes, recibe una cadena legible ABCD-1234 más un qrPayload JSON, y renderiza un QR de 320 píxeles en el modal.
  4. Saca una foto del QR con el móvil, camina hasta el dock y escanéalo en la UI del operador del dock (Ajustes → Plataforma cloud → Escanear QR).
  5. El dock valida el código, escribe su registro y reinicia. Esto tarda 60–90 s.
  6. La fila de la tabla Códigos activos pasa de sin canjes a una línea de canje que muestra la serie y deviceType del dock. Cuando el dock vuelve en línea, su fila aparece en Admin → DJI → Docks con un punto de estado verde.

Un código de vinculación puede reclamar tanto el dock como su aeronave en un único escaneo cuando usos máximos ≥ 2.

Estado del dock vinculado

Una vez vinculado, un dock está:

  • Visible en la lista de docks del admin para esta organización (y sólo esta).
  • Asignable a una misión desde la vista de operaciones. La asignación establece dji_docks/{sn}.missionId y argus-dji se une automáticamente a la sala TACLINK de la operación como participante dji-dock-{sn}.
  • Con auto-stream cuando está asignado — el piloto automático de auto-stream aprovisiona un ingreso WHIP y publica live_start_push al dock, de modo que el tile del operador muestra vídeo en segundos tras la asignación.

Consulta Tile del dock para la superficie del lado del operador y Auto-stream para el flujo de ingreso.

Regenerar o revocar

La tabla Códigos activos lista todos los códigos no expirados. Cada fila muestra TTL, historial de canjes y un botón Revocar. La revocación es inmediata — un escaneo contra un código revocado falla con Código no encontrado en el dock.

Para cambiar un dock a una organización diferente, primero haz clic en Desvincular de organización en el panel de resumen del dock (esto limpia orgId en su documento Firestore), y luego haz que la organización receptora genere un código nuevo. Un dock puede estar vinculado a exactamente una organización ARGUS a la vez.

Configuración manual (avanzado)

La pestaña Configuración manual del modal de vinculación expone el host, puerto, usuario, contraseña MQTT crudos y las tres claves DJI para copiar y pegar en DJI Pilot 2 o Assistant 2. Úsalo sólo cuando la pantalla del dock no pueda escanear un QR (poca luz, fallo de cámara). Cada fila tiene un botón de copia individual; Copiar todo empaqueta el conjunto en un bloque del portapapeles.

Reclamar existente

Si un dock ya está publicando telemetría pero nunca se le asignó un orgId (por ejemplo, un banco de pruebas pre-prod que saltó el flujo QR), abre la pestaña Reclamar existente, introduce el SN del dock y opcionalmente el SN de la aeronave, y haz clic en Reclamar. Esto estampa orgId sobre el documento Firestore in situ.

Solución de problemas

  • El dock sigue offline tras la vinculación. El dock se reinició pero falló al reconectarse a EMQX. Verifica la red del dock en la pantalla física; confirma que el puerto MQTT no esté bloqueado por un firewall de sitio.
  • Código expirado. El TTL caducó antes del escaneo. Genera un código nuevo.
  • Licencia agotada. Cuota de organización llena — contacta al soporte de ARGUS para aumentar el número de asientos, o primero desvincula un dock no utilizado.
  • El escaneo reportó éxito pero no aparece ninguna fila de dock. Espera 2 minutos; la primera publicación update_topo del dock puede retrasarse respecto a su arranque. Si sigue faltando, verifica Admin → DJI → Códigos activos para la línea de canje — si está presente, argus-dji recibió telemetría pero la escritura en Firestore falló (contacta al soporte).

Relacionado

  • Tile del dock — tile del operador por dock tras la vinculación.
  • Auto-stream — ingreso de vídeo cuando un dock está asignado a una misión.
  • FlySafe — gestión de licencias de desbloqueo en un dock vinculado.