Instalación y uso de Azure IoT Explorer

Azure IoT Explorer es una herramienta gráfica para interactuar con dispositivos conectados a IoT Hub. Este artículo se centra en el uso de la herramienta para probar los dispositivos IoT Plug and Play. Después de instalar la herramienta en el equipo local, puede usarla para conectarse a un centro de conectividad. Puede usar la herramienta para ver la telemetría que envían los dispositivos, trabajar con propiedades del dispositivo e invocar comandos.

En este artículo aprenderá a:

• Instale y configure la herramienta Azure IoT Explorer.
• Use la herramienta para interactuar con los dispositivos IoT Plug and Play y probarlos.

Para obtener más información general sobre el uso de la herramienta, consulte el readme de GitHub.

Para usar la herramienta Azure IoT Explorer, necesita:

• Un centro de Azure IoT. Hay muchas maneras de agregar un centro de IoT a su suscripción de Azure, como Crear un centro de IoT mediante la CLI de Azure. Necesita la cadena de conexión de IoT Hub para ejecutar la herramienta Azure IoT Explorer. Si no tiene una suscripción a Azure, cree una cuenta gratuita antes de empezar.
• Un dispositivo registrado en su centro de IoT. Puede usar IoT Explorer para crear y administrar registros de dispositivos en ioT Hub.

Instalación de Azure IoT Explorer

Vaya a las versiones de Azure IoT Explorer y expanda la lista de recursos de la versión más reciente. Descargue e instale la versión más reciente de la aplicación. El paquete de instalación configura una manera de iniciar la aplicación en la plataforma. Por ejemplo, en Windows puede iniciar la aplicación desde el menú Inicio.

Uso de Azure IoT Explorer

Para un dispositivo, puede conectar su propio dispositivo o usar uno de los dispositivos simulados de ejemplo.

Conéctate a tu hub

La primera vez que ejecute Azure IoT Explorer, se le pedirá la cadena de conexión de IoT Hub. Después de agregar la cadena de conexión, seleccione Conectar. Puede usar la configuración de la herramienta para cambiar a otro centro de IoT mediante la actualización de la cadena de conexión.

La definición del modelo de un dispositivo IoT Plug and Play se almacena en el repositorio público, en el dispositivo conectado o en una carpeta local. De forma predeterminada, la herramienta busca la definición del modelo en el repositorio público y el dispositivo conectado. Puede agregar y quitar orígenes o configurar la prioridad de los orígenes en Configuración:

Para agregar un origen:

1. Vaya a Inicio/Configuración de IoT Plug and Play.
2. Seleccione Agregar y elija el origen, en un repositorio o carpeta local.

Para eliminar una fuente:

1. Vaya a Inicio/Configuración de IoT Plug and Play.
2. Busque el origen que desea quitar.
3. Seleccione X para quitarlo.

Cambie las prioridades de origen:

Puede arrastrar y colocar uno de los orígenes de definición de modelo en una clasificación diferente en la lista.

Ver dispositivos

Una vez que la herramienta se conecta al centro de IoT, muestra la página de lista Dispositivos que muestra las identidades de dispositivo registradas con ioT Hub. Puede seleccionar cualquier entrada de la lista para ver más información.

En la página Lista de dispositivos puede:

• Seleccione Nuevo para registrar un nuevo dispositivo con su hub. A continuación, escriba un identificador de dispositivo. Use la configuración predeterminada para generar automáticamente claves de autenticación y habilitar la conexión al centro.
• Seleccione un dispositivo y, a continuación, seleccione Eliminar para eliminar una identidad de dispositivo. Revise los detalles del dispositivo antes de completar esta acción para asegurarse de que está eliminando la identidad del dispositivo correcta.

Interacción con un dispositivo

En la página de lista Dispositivos , seleccione un valor en la columna Id. de dispositivo para ver la página de detalles del dispositivo registrado. Para cada dispositivo hay dos secciones: Dispositivo y Gemelo digital.

Dispositivo

En esta sección se incluyen las pestañas Identidad del dispositivo, Gemelo del dispositivo, Telemetría, Método directo, Mensaje de nube a dispositivo y Identidad del módulo.

• Puede ver y actualizar la información de identidad del dispositivo en la pestaña Identidad del dispositivo.
• Puede acceder a la información del dispositivo gemelo en la pestaña Dispositivo gemelo .
• Si un dispositivo está conectado y envía datos activamente, puede ver la telemetría en la pestaña Telemetría .
• Puede llamar a un método directo en el dispositivo desde la pestaña Método directo.
• Puede enviar un mensaje de nube a dispositivo en la pestaña Mensajes de nube a dispositivo .
• Puede acceder a la información del módulo gemelo .

Componentes de IoT Plug and Play

Si el dispositivo está conectado al centro usando un Identificador de modelo, la herramienta muestra la pestaña Componentes de IoT Plug and Play, donde se puede ver el Identificador de modelo.

Si el id. de modelo está disponible en uno de los orígenes configurados: repositorio público o carpeta local, se muestra la lista de componentes. Al seleccionar un componente se muestran las propiedades, comandos y telemetría disponibles.

En la página Componente , puede ver las propiedades de solo lectura, actualizar propiedades grabables, invocar comandos y ver los mensajes de telemetría generados por este componente.

Propiedades

Puede ver las propiedades de solo lectura definidas en una interfaz en la pestaña Propiedades (solo lectura). Puede actualizar las propiedades grabables definidas en una interfaz en la pestaña Propiedades (grabable):

1. Vaya a la pestaña Propiedades de (grabable).
2. Seleccione la propiedad que desea actualizar.
3. Escriba el nuevo valor de la propiedad .
4. Obtenga una vista previa de la carga que se enviará al dispositivo.
5. Envíe el cambio.

Después de enviar un cambio, puede realizar un seguimiento del estado de la actualización: sincronización, éxito o error. Una vez completada la sincronización, verá el nuevo valor de la propiedad en la columna Valor notificado . Si navega a otras páginas antes de que finalice la sincronización, la herramienta todavía le notifica cuando se complete la actualización. También puede usar el centro de notificaciones de la herramienta para ver el historial de notificaciones.

Órdenes

Para enviar un comando a un dispositivo, vaya a la pestaña Comandos :

1. Expanda el comando que desea desencadenar en la lista de comandos.
2. Escriba los valores necesarios para el comando.
3. Obtenga una vista previa de la carga que se enviará al dispositivo.
4. Envíe el comando .

Telemetría

Para ver la telemetría de la interfaz seleccionada, vaya a su pestaña Telemetría . Seleccione Iniciar para empezar a recibir telemetría.

Problemas conocidos

Para obtener una lista de las características de IoT compatibles con la versión más reciente de la herramienta, consulte Lista de características.