Uso de Azure IoT Tools para Visual Studio Code para la administración de dispositivos de Azure IoT Hub

Diagrama integral

En este artículo, aprenderá a usar Azure IoT Tools para Visual Studio Code con distintas opciones de administración en la máquina de desarrollo. Azure IoT Tools es una útil extensión de Visual Studio Code que facilita la administración de IoT Hub y el desarrollo de aplicaciones de IoT. Incluye opciones de administración que puede usar para realizar varias tareas.

Nota

Las características descritas en este artículo solo están disponibles en el nivel estándar de IoT Hub. Para más información sobre los niveles Básico y Estándar o Gratis de IoT Hub, consulte el artículo sobre cómo elegir el nivel de IoT Hub correcto.

Opción de administración Tarea
Métodos directos Hacer que un dispositivo actúe, por ejemplo, para iniciar o detener el envío de mensajes o reiniciar el dispositivo.
Leer dispositivo gemelo Obtener el estado notificado de un dispositivo. Por ejemplo, el dispositivo informa de que el LED está parpadeando.
Actualizar dispositivo gemelo Poner un dispositivo en determinados estados, como establecer un indicador LED en verde o establecer el intervalo de envío de telemetría en 30 minutos.
Mensajes de nube a dispositivo Enviar notificaciones a un dispositivo. Por ejemplo, "Es muy probable que llueva hoy. No olvide traerse un paraguas".

Para obtener una explicación más detallada acerca de las diferencias y orientación sobre el uso de estas opciones, consulte la Guía de comunicación de dispositivo a nube y la Guía de comunicación de nube a dispositivo.

Los dispositivos gemelos son documentos JSON que almacenan información sobre el estado de los dispositivos (metadatos, configuraciones y condiciones). IoT Hub conserva un dispositivo gemelo por cada dispositivo que se conecta a él. Para más información acerca de los dispositivos gemelos, consulte Introducción a los dispositivos gemelos.

Nota

En este artículo se usa el módulo Az de PowerShell, que es el módulo de PowerShell que se recomienda para interactuar con Azure. Para empezar a trabajar con el módulo Az de PowerShell, consulte Instalación de Azure PowerShell. Para más información sobre cómo migrar al módulo Az de PowerShell, consulte Migración de Azure PowerShell de AzureRM a Az.

Requisitos previos

  • Una suscripción de Azure activa.
  • Un centro de Azure IoT en su suscripción.
  • Visual Studio Code
  • Azure IoT Tools para VS Code o copie esta dirección URL y péguela en una ventana del explorador:vscode:extension/vsciot-vscode.azure-iot-tools.

Iniciar sesión para acceder a IoT Hub

  1. En la vista Explorador de VS Code, expanda la sección Azure IoT Hub Devices (Dispositivos de Azure IoT Hub) en la esquina inferior izquierda.

  2. Haga clic en Select IoT Hub (Seleccionar IoT Hub) en el menú contextual.

  3. Se mostrará una ventana emergente en la esquina inferior derecha que le permite iniciar sesión en Azure por primera vez.

  4. Después de iniciar sesión, se mostrará la lista de suscripciones de Azure y luego podrá seleccionar la suscripción de Azure e IoT Hub.

  5. En unos segundos, aparecerá la lista de dispositivos en la pestaña Azure IoT Hub Devices (Dispositivos de Azure IoT Hub).

    Nota

    También puede completar la configuración seleccionando Set IoT Hub Connection String (Establecer cadena de conexión de IoT Hub). Escriba la cadena de conexión de la directiva iothubowner del centro de IoT al que se conecta el dispositivo IoT en la ventana emergente.

Métodos directos

  1. Haga clic con el botón derecho en el dispositivo y seleccione Invoke Direct Method (Invocar método directo).

  2. Escriba el nombre del método y la carga en el cuadro de entrada.

  3. Se mostrarán los resultados en la vista SALIDA > Azure IoT Hub.

Leer dispositivo gemelo

  1. Haga clic con el botón derecho en el dispositivo y seleccione Editar dispositivo gemelo.

  2. Se abrirá un archivo azure-iot-device-twin.json con el contenido del dispositivo gemelo.

Actualizar dispositivo gemelo

  1. Realice algunas modificaciones de etiquetas o en el campo properties.desired.

  2. Haga clic con el botón derecho en el archivo azure-iot-device-twin.json.

  3. Seleccione Update Device Twin (Actualizar dispositivo gemelo) para actualizar el dispositivo gemelo.

Envío de mensajes de nube a dispositivo

Para enviar un mensaje desde el IoT Hub al dispositivo, siga estos pasos:

  1. Haga clic con el botón derecho en el dispositivo y seleccione Send C2D Message to Device (Enviar mensaje de C2D al dispositivo).

  2. Escriba el mensaje en el cuadro de entrada.

  3. Se mostrarán los resultados en la vista SALIDA > Azure IoT Hub.

Pasos siguientes

Ha aprendido a usar la extensión Azure IoT Tools para Visual Studio Code con diversas opciones de administración.

Para continuar la introducción a Azure IoT Hub y explorar todos los escenarios de IoT con mayor detalle, consulte lo siguiente: