Skip to main content

Solución de problemas de nodos

Use esta página cuando un nodo esté visible en el estado, pero las herramientas del nodo fallen.

Escalera de comandos

Luego ejecute comprobaciones específicas del nodo:
Señales saludables:
  • El nodo está conectado y emparejado para el rol node.
  • nodes describe incluye la capacidad que usted está invocando.
  • Las aprobaciones de exec muestran el modo/lista de permitidos esperados.

Requisitos de primer plano

canvas.*, camera.* y screen.* son solo de primer plano en nodos iOS/Android. Comprobación y solución rápidas:
Si ve NODE_BACKGROUND_UNAVAILABLE, lleve la app del nodo al primer plano y vuelva a intentarlo.

Matriz de permisos

Emparejamiento versus aprobaciones

Estas son puertas diferentes:
  1. Emparejamiento del dispositivo: ¿puede este nodo conectarse al Gateway?
  2. Aprobaciones de exec: ¿puede este nodo ejecutar un comando de shell específico?
Comprobaciones rápidas:
Si falta el emparejamiento, apruebe primero el dispositivo del nodo. Si el emparejamiento está bien pero falla system.run, corrija las aprobaciones/lista de permitidos de exec.

Códigos de error comunes del nodo

  • NODE_BACKGROUND_UNAVAILABLE → la app está en segundo plano; llévela al primer plano.
  • CAMERA_DISABLED → el interruptor de cámara está deshabilitado en la configuración del nodo.
  • *_PERMISSION_REQUIRED → permiso del SO ausente/denegado.
  • LOCATION_DISABLED → el modo de ubicación está desactivado.
  • LOCATION_PERMISSION_REQUIRED → el modo de ubicación solicitado no está concedido.
  • LOCATION_BACKGROUND_UNAVAILABLE → la app está en segundo plano, pero solo existe el permiso Mientras se usa.
  • SYSTEM_RUN_DENIED: approval required → la solicitud de exec necesita aprobación explícita.
  • SYSTEM_RUN_DENIED: allowlist miss → el comando está bloqueado por el modo de lista de permitidos.

Bucle de recuperación rápida

Si aún está atascado:
  • Vuelva a aprobar el emparejamiento del dispositivo.
  • Reabra la app del nodo (primer plano).
  • Vuelva a conceder los permisos del SO.
  • Recree/ajuste la política de aprobaciones de exec.
Relacionado: