Licencias de desbloqueo DJI FlySafe

El sistema FlySafe de DJI controla los desbloqueos de espacio aéreo restringido — zonas de autorización cerca de aeropuertos, zonas limitadas en altitud y zonas de no-fly temporales. Sin la licencia correcta instalada, la aeronave rechaza despegar dentro de esos polígonos o aplica un tope duro de altitud. ARGUS expone el ciclo de vida completo de las licencias en Admin → Gestión DJI → Licencias.

Ver licencias instaladas

Abre Admin → Gestión DJI.
Elige el dock en la lista de la izquierda.
Cambia a la pestaña Licencias en el panel de detalle.
Elige el dominio — Aircraft (0) o Dock (3). La mayoría de desbloqueos aplican a la aeronave; las licencias de dominio de dock existen para funcionalidades SDK específicas.
Haz clic en Refrescar. ARGUS llama a POST /api/dji/docks/{sn}/flysafe/licenses con el dominio seleccionado, el bridge pregunta al dock por su lista actualmente instalada y la tabla se puebla cuando el dock responde.

El campo de dominio es obligatorio en el firmware moderno de dock — una petición vacía es rechazada silenciosamente. ARGUS siempre pasa uno.

Columnas de licencia

Cada fila de la tabla muestra:

Columna	Descripción
Id	Id numérico de licencia asignado por DJI — el handle usado para habilitar/deshabilitar.
Nombre	Etiqueta orientada al operador (normalmente la zona de espacio aéreo, p. ej. `CTR Aeropuerto BCN`).
Tipo	`Custom Unlock`, `Self Unlock`, o `Education Unlock` — establecido cuando la licencia fue emitida por DJI.
Válido desde / hasta	Marcas de tiempo de inicio y fin. Una licencia fuera de su ventana aparece en gris.
Area ref	El id de zona DJI al que aplica la licencia.
Habilitado	Toggle — envía el servicio MQTT `unlock_license_switch` al cambiar.
Dominio	Aircraft (0) o Dock (3).

Habilitar / deshabilitar una licencia

Conmuta el checkbox de cualquier fila. ARGUS llama a POST /api/dji/docks/{sn}/flysafe/switch con {licenseId, enable}. argus-dji publica el servicio unlock_license_switch sobre MQTT; el dock empuja el estado conmutado a la aeronave. La tabla se auto-refresca tras un segundo para que la UI refleje el estado confirmado por el dock en lugar de un flip local optimista (que divergiría en caso de fallo).

Deshabilitar una licencia no la elimina — el archivo permanece en la aeronave, sólo inerte hasta que se vuelva a habilitar.

Subir una nueva licencia

Haz clic en Enviar nueva licencia. El formulario inline se expande.
URL del archivo — pega una URL al archivo de licencia firmado descargado del portal FlySafe de DJI. Extensión típica .dat o .zip dependiendo del tipo de zona.
Fingerprint — la cadena hex MD5 del archivo. El dock la usa para verificar la descarga contra manipulación o corrupción.
Haz clic en Enviar. ARGUS llama a POST /api/dji/docks/{sn}/flysafe/update; argus-dji publica unlock_license_update con {file: {url, fingerprint}}. El dock obtiene el archivo, verifica el MD5 y lo instala a la aeronave la próxima vez que la aeronave esté presente en la bahía.

Tras ~2 s la lista de licencias se auto-refresca para que la licencia recién instalada aparezca.

Aspiracional: una ruta de subida de primera clase — eliges un archivo, ARGUS calcula el MD5 del lado del cliente, sube a S3, entrega la URL presigned + fingerprint al dock — está planificada. El formulario actual basado en URL asume que has alojado el archivo en otro sitio.

Filtro de dominio

El radio de dominio (Aircraft / Dock) en la parte superior de la pestaña controla qué lista se le pide reportar al dock. Cambiar de dominio requiere un nuevo clic en Refrescar — el dock sólo reporta un dominio por consulta. En la práctica la mayoría de operadores dejan esto en Aircraft; las licencias de dominio de dock son raras y normalmente conciernen desbloqueos de payload PSDK.

Refrescar

El botón Refrescar vuelve a emitir la consulta de lista. Útil tras:

Una licencia expira y quieres que la fila aparezca en gris.
La aeronave vuelve de vuelo (el dock sólo lista licencias confirmadas como instaladas en la aeronave, así que una licencia recién enviada no aparecerá hasta tras la siguiente presencia de la aeronave).
Un push al portal DJI FlySafe que emitiste externamente — el dock no emite actualizaciones de licencia no solicitadas.

Solución de problemas

Lista vacía tras refrescar. El dock devolvió [] — o la aeronave no tiene licencias para el dominio seleccionado, o el campo de dominio fue rechazado por un firmware antiguo. Prueba el otro dominio; confirma firmware de dock ≥ 03.00 (Dock 2) o ≥ 04.00 (Dock 3).
El toggle vuelve atrás. El dock confirmó el switch pero la aeronave lo rechazó — normalmente porque la ventana de la licencia ha expirado. El refresco de un segundo muestra el estado autoritativo.
El push falla silenciosamente. El fingerprint no coincidió con el archivo descargado. Los logs del dock DJI registran el desajuste pero ARGUS sólo ve el timeout — vuelve a calcular el MD5 y reintenta.

Relacionado

Vinculación — el paso prerrequisito; los docks sin vincular no tienen superficie de licencia.
Geofence / no-fly — aplicación basada en polígonos ARGUS, separada de DJI FlySafe.
Firmware — el otro pipeline de push del lado admin.