Administración de dispositivos individuales en la aplicación de Azure IoT Central
En este artículo se describe cómo puede administrar dispositivos en la aplicación de Azure IoT Central. Puede:
- Usar la página Devices (Dispositivos) para ver, agregar y eliminar los dispositivos conectados a una aplicación de Azure IoT Central.
- Mantenga actualizados los metadatos del dispositivo cambiando los valores almacenados en las propiedades del dispositivo desde sus vistas.
- Controlar el comportamiento de los dispositivos mediante la actualización de una configuración en un dispositivo específico desde sus vistas.
Para obtener información sobre cómo administrar dispositivos de forma masiva, consulte Administración de dispositivos de forma masiva en Azure IoT Central.
Para obtener información sobre cómo administrar dispositivos mediante la API REST de IoT Central, consulte Uso de la API REST de IoT Central para administrar dispositivos.
Visualización de los dispositivos
Para ver un dispositivo determinado:
Elija Dispositivos en el panel izquierdo. Aquí puede ver una lista de las plantillas de dispositivo y una lista de todos los dispositivos a los que puede acceder su organización.
Elija una plantilla.
En el panel derecho de la página Dispositivos, verá una lista de los dispositivos creados con esa plantilla a los que puede acceder su organización:
Elija un dispositivo para ver la página de detalles de ese dispositivo.
Sugerencia
Puede usar la herramienta de filtro de esta página para ver los dispositivos de una organización específica.
Supervisión de los dispositivos
Use la página Dispositivos para supervisar y administrar los dispositivos.
El siguiente vídeo le guía a través del proceso de supervisión del estado de conectividad del dispositivo:
Valores de estado del dispositivo
Cada dispositivo tiene un único valor de estado en la interfaz de usuario. El estado del dispositivo puede ser uno de los siguientes:
Primero, el estado del dispositivo es Registrado. Este estado significa que el dispositivo se ha creado en IoT Central y tiene un identificador. El dispositivo está registrado cuando:
- Se agrega un nuevo dispositivo real en la página Dispositivos.
- Se agrega un conjunto de dispositivos mediante Importar en la página Dispositivos.
El estado del dispositivo cambia a Aprovisionado cuando un dispositivo registrado completa el paso de aprovisionamiento mediante el Servicio de Aprovisionamiento de Dispositivos (DPS). Para completar el proceso de aprovisionamiento, el dispositivo necesita el Id. de dispositivo que se utilizó para registrar el dispositivo, una clave SAS o un certificado X.509 y el ámbito de Id.. Una vez que el DPS aprovisiona el dispositivo, éste puede conectarse a su aplicación IoT Central y comenzar a enviar datos.
Los dispositivos bloqueados tienen un estado de Bloqueado. Un operador puede bloquear y desbloquear dispositivos. Cuando están bloqueados, no pueden enviar datos a la aplicación de IoT Central. Un operador debe desbloquear el dispositivo antes de que pueda reanudar el envío de datos. Cuando un operador desbloquea un dispositivo, el estado vuelve a su valor anterior, Registrado o Aprovisionado.
Si el estado del dispositivo es Esperando aprobación, significa que la opción Auto aprobar está deshabilitada en la página Grupos de conexión de dispositivos. Un operador debe aprobar explícitamente un dispositivo antes de que pueda aprovisionarse y enviar datos. Los dispositivos no registrados manualmente en la página Dispositivos, pero conectados con credenciales válidas tienen el estado de dispositivo En espera de aprobación. Los operadores pueden aprobar estos dispositivos desde la página Dispositivos mediante el botón Aprobar.
La siguiente tabla muestra cómo el valor de estado de un dispositivo en la interfaz de usuario se corresponde con los valores utilizados por la API REST para interactuar con los dispositivos:
| Estado de la Interfaz de usuario del dispositivo | Notas | Obtener API REST |
|---|---|---|
| A la espera de aprobación | La opción de aprobación automática está deshabilitada en el grupo de conexión de dispositivos y el dispositivo no se ha agregado a través de la interfaz de usuario. Un usuario debe aprobar manualmente el dispositivo a través de la interfaz de usuario antes de poder utilizarlo. |
Provisioned: false Enabled: false |
| Registered | Se ha aprobado un dispositivo de forma automática o manual. | Provisioned: false Enabled: true |
| aprovisionado | El dispositivo se ha aprovisionado y puede conectarse a su aplicación IoT Central. | Provisioned: true Enabled: true |
| Bloqueado | El dispositivo no puede conectarse a su aplicación IoT Central. Puede bloquear un dispositivo que se encuentre en cualquiera de los otros estados. | Provisioned: depende de Waiting for approval/Registered/Provisioned status Enabled: false |
Un dispositivo también puede tener el estado Sin asignar. Este estado no se muestra en el campo Estado del dispositivo de la interfaz de usuario, sino en el campo Plantilla de dispositivo de la interfaz de usuario. Sin embargo, puede filtrar la lista de dispositivos para los dispositivos con el estado Sin asignar. Si el estado del dispositivo es Sin asignar, el dispositivo que se conecta a IoT Central no está asignado a una plantilla de dispositivo. Esta situación suele darse en los escenarios siguientes:
- Se agrega un conjunto de dispositivos mediante la opción Import (Importar) de la página Devices (Dispositivos) sin especificar la plantilla de dispositivo.
- Se registró un dispositivo manualmente en la página Devices (Dispositivos) sin especificar la plantilla de dispositivo. Después, el dispositivo se conecta con credenciales válidas.
Un operador puede asignar un dispositivo a una plantilla de dispositivo desde la página Dispositivos utilizando el botón Migrar.
Estado de conexión del dispositivo
Cuando un dispositivo o dispositivo perimetral se conecta mediante el protocolo MQTT, se generan eventos conectados y desconectados para el dispositivo. El dispositivo no envía estos eventos, IoT Central los genera internamente.
En el diagrama siguiente se muestra cómo, cuando se conecta un dispositivo, la conexión se registra al final de una ventana de tiempo. Si se producen varios eventos de conexión y desconexión, IoT Central registra el más cercano al final de la ventana de tiempo. Por ejemplo, si un dispositivo se desconecta y se vuelve a conectar dentro de la ventana de tiempo, IoT Central registra el evento de conexión. Actualmente, la ventana de tiempo es de aproximadamente un minuto.
Vea el vídeo siguiente para obtener más información sobre cómo supervisar el estado de conexión de un dispositivo:
Puede incluir eventos de conexión y desconexión en Exportación de datos de IoT a destinos en la nube mediante Blob Storage. Para más información, consulte Reacción a eventos de IoT Hub > Limitaciones de los eventos de dispositivo conectado y dispositivo desconectado.
Agregar un dispositivo
Para agregar un dispositivo real a una aplicación de Azure IoT Central:
Elija Dispositivos en el panel izquierdo.
Elija la plantilla de dispositivo desde la que va a crear un dispositivo.
Elija + Nuevo.
Escriba un nombre de dispositivo y un identificador, o bien acepte el valor predeterminado. La longitud máxima del nombre de un dispositivo es de 148 caracteres. La longitud máxima del identificador de un dispositivo es de 128 caracteres.
Cambie el botón de alternancia SimulatedOn (Activado) u Off (Desactivado). Un dispositivo real hace referencia a un dispositivo físico que se conecta a la aplicación de Azure IoT Central. Un dispositivo simulado tiene datos de ejemplo generados por Azure IoT Central, que los pone a su disposición.
Si la aplicación usa organizaciones, elija la organización a la que pertenece el dispositivo.
Sugerencia
Puede establecer una organización predeterminada para que aparezca en la lista desplegable de la organización.
Seleccione Crear.
El dispositivo aparece ahora en la lista de dispositivos de esta plantilla. Selecciónelo para ver su página de detalles, que contiene todas las vistas del dispositivo.
Obtención de información de conexión del dispositivo
Cuando un dispositivo se aprovisiona y se conecta a IoT Central, necesita información de conexión de la aplicación de IoT Central:
- El ámbito de identificador que identifica la aplicación en DPS.
- El Id. de dispositivo que se usó para registrar el dispositivo.
- Una clave SAS o un certificado X.509.
Para establecer estos valores:
Elija Dispositivos en el panel izquierdo.
Para ver los detalles del dispositivo, haga clic en el dispositivo en la lista de dispositivos.
Seleccione Conectar para ver la información de conexión. El código QR codifica un documento JSON que incluye el ámbito de identificador, el identificador de dispositivo y la clave principal derivados del grupo de conexiones de dispositivos SAS-IoT-Devices predeterminado.
Nota:
Si el tipo de autenticación es Firma de acceso compartido, las claves que se muestran se derivan del grupo de conexiones de dispositivos SAS-IoT-Devices predeterminado.
Cambio de organización
Para trasladar un dispositivo a otra organización, debe tener acceso a las organizaciones de origen y de destino. Para trasladar un dispositivo:
Elija Dispositivos en el panel izquierdo.
Seleccione el dispositivo que se trasladará en la lista de dispositivos.
Seleccione Administrar dispositivo y Organización en el menú desplegable.
Seleccione la nueva organización para el dispositivo:
Seleccione Guardar.
Migración de dispositivos a una plantilla
Si para registrar dispositivos inicia la importación en All devices (Todos los dispositivos), los dispositivos se crean sin asociación con ninguna plantilla. Los dispositivos deben estar asignados a una plantilla para explorar los datos y otros detalles sobre ellos. Siga estos pasos para asignar dispositivos a una plantilla:
Elija Dispositivos en el panel izquierdo.
Elija All devices (Todos los servicios) en el panel izquierdo.
Seleccione los dispositivos unassigned (no asignados) que quiera asignar a una plantilla:
Seleccione Migrate (Migrar):
Elija la plantilla en la lista de plantillas disponibles y seleccione Migrate (Migrar).
Los dispositivos seleccionados están asignados a la plantilla de dispositivo que eligió.
Eliminar un dispositivo
Para eliminar ya sea un dispositivo real o simulado de la aplicación de Azure IoT Central:
Elija Dispositivos en el panel izquierdo.
Elija la plantilla de dispositivo del dispositivo que desea eliminar.
Use las herramientas de filtro para filtrar y buscar los dispositivos. Active la casilla situada junto al dispositivo que desea eliminar.
Elija Borrar. Puede realizar un seguimiento del estado de esta eliminación en el panel Operaciones de dispositivo.
Cambio de una propiedad
Las propiedades de la nube son los metadatos de dispositivo asociados al dispositivo, como la ciudad y el número de serie. Las propiedades de la nube solo existen en la aplicación IoT Central y no se sincronizan con sus dispositivos. Las propiedades que se pueden escribir controlan el comportamiento de un dispositivo y permiten establecer el estado de un dispositivo de forma remota, por ejemplo, estableciendo la temperatura objetivo de un dispositivo de termostato. Las propiedades del dispositivo las establece el dispositivo y son de solo lectura en IoT Central. Puede ver y actualizar las propiedades en las vistas de Detalles del dispositivo.
Elija Dispositivos en el panel izquierdo.
Elija la plantilla de dispositivo del dispositivo cuyas propiedades desea modificar y seleccione el dispositivo de destino.
Elija la vista que contiene las propiedades del dispositivo. Esta vista le permite especificar valores y seleccionar Guardar en la parte superior de la página. Aquí verá las propiedades del dispositivo y sus valores actuales. Tanto las propiedades de la nube como las propiedades que se pueden escribir tienen campos editables, mientras que las propiedades del dispositivo son de solo lectura. En el caso de las propiedades que se pueden escribir, puede ver su estado de sincronización en la parte inferior del campo.
Modifique las propiedades con los valores que necesite. Puede modificar varias propiedades a la vez y actualizarlas todas al mismo tiempo.
Elija Guardar. Si guardó las propiedades que se pueden escribir, los valores se envían al dispositivo. Cuando el dispositivo confirma el cambio de la propiedad que se puede escribir, el estado vuelve a synced (sincronizado). Si guardó una propiedad de la nube, el valor se actualiza.