Gestión de dispositivos

Compara la última prueba de velocidad de internet de una instalación con lo que necesitan sus dispositivos. network devuelve la velocidad de descarga y de subida en Mbps y, para pantallas, cámaras (grabación más transmisión en vivo) y sistemas de altavoces conectados vistos en las últimas 24 horas: la cantidad de dispositivos, el ancho de banda que necesita cada uno y si la conexión es suficiente. Úsalo para diagnosticar dispositivos lentos o que se desconectan, o antes de agregar dispositivos. Pasa facilityIds para comprobar varias instalaciones.

Acciones:

• network: Comprobación del ancho de banda de la red.

Todos los dispositivos registrados en una instalación: pantallas, cámaras en la nube, cámaras de red, Edge Processors de IA, botones de Duress, controladores de puerta, agentes de IA y sensores IoT. Úsalo para solucionar problemas, auditar el equipamiento o encontrar el ID de un dispositivo.

Cada dispositivo tiene su tipo, modelo, IDs (deviceUuid; deviceID para las pantallas; deviceSerialNumber para los botones de Duress), ubicación, datos de red (IP, Wi-Fi o Ethernet, SSID, canal, redes cercanas; metadata.networkStats tiene el puerto del switch PoE), estado (temperatura de la CPU, memoria, tiempo de actividad) y metadata.updated, la última señal de actividad en ms Unix. Desconectado significa sin señal de actividad durante 5 minutos; un dispositivo desconectado durante más de 7 días con un gemelo en línea (mismo equipo, nombre o ubicación) probablemente se reemplazó. Las filas networkCamera son transmisiones que extrae el Edge Processor de edgeProcessorUUID; su deviceUuid (que empieza por ep_) no puede recibir comandos. Las credenciales de las URL de transmisión se muestran como : a menos que se defina includeCredentials. Recomienda Ethernet por cable en lugar de Wi-Fi.

Relacionado: cctv_cameras_read y cctv_cameras_write (cámaras), cctv_edge_processors_write (Edge Processors), device_inventory_write (cambiar el nombre, configurar, mover), device_send_command (control), device_health_read (ancho de banda).

Acciones:

• list: Mostrar los dispositivos. Dispositivos de la instalación, filtrados por tipo o nombre. Con facilityIds, cada instalación devuelve su primera página.

Cambia un dispositivo registrado en una instalación. rename_screen y configure_screen cambian una pantalla (identifícala por el deviceID de device_inventory_read); para los grupos, las etiquetas o el modo de visualización de una pantalla, usa las herramientas de pantallas. move mueve una pantalla, una cámara en la nube, un botón de Duress, un controlador de puerta, un agente de IA o un Edge Processor de IA a otra instalación de la misma organización.

Acciones:

• rename_screen: Cambiar el nombre de una pantalla. Se aplica de inmediato, también en pantallas desconectadas o al final de su vida útil. Requiere deviceID, displayName.
• configure_screen: Cambiar la configuración de hardware de una pantalla. Solo cambia la configuración que pases. Se envía al dispositivo y puede reiniciar su pantalla. A las pantallas desconectadas y al final de su vida útil (estado 409) solo se les puede cambiar el nombre. Requiere deviceID. Pide confirmación.
• move: Mover un dispositivo a otra instalación. facilityId es donde está el dispositivo ahora; también necesitas acceso a la de destino. Mover un Edge Processor mueve sus cámaras de red; para mover cámaras de red individuales, usa cctv_edge_processors_write transfer_cameras. Requiere targetFacilityId, deviceType. Pide confirmación.

Envía un comando en vivo a un dispositivo o a todos los dispositivos de una instalación: reiniciar, encender o apagar la pantalla, reiniciar el navegador, mostrar un mensaje, cargar una página, instalar actualizaciones o reiniciar la alimentación de un puerto PoE. Los dispositivos en línea actúan en segundos; los desconectados nunca lo reciben. Cada comando pide confirmación primero.

Apunta a un dispositivo con uuid (su deviceUuid de device_inventory_read) o a todos con broadcast: true. Pasa facilityIds para ejecutarlo en varias instalaciones. Las pantallas aceptan todos los comandos; las cámaras aceptan rebootDevice y unlockUpdates. Las cámaras de red (deviceUuid que empieza por ep_) no pueden recibir comandos; apunta a su Edge Processor (edgeProcessorUUID) o reinicia la alimentación de su puerto PoE.

Para recuperar una cámara PoE desconectada, lee su metadata.networkStats (switchID, sw_port) en device_inventory_read y luego envía powerCyclePort a cualquier dispositivo en línea de la instalación con los argumentos {switchID, switchPort}. Ese dispositivo le pide al controlador de red de la instalación que corte y restablezca la alimentación del puerto.