Inicio rápido: Control de un dispositivo conectado a IoT Hub

El inicio rápido usa dos aplicaciones .NET escritas anteriormente:

• Una aplicación de dispositivo simulado que responde a métodos directos que se llaman desde una aplicación de servicio. Para recibir las llamadas de método directo, esta aplicación se conecta a un punto de conexión específico del dispositivo en IoT Hub.

• Una aplicación de servicio que llama a los métodos directos en el dispositivo simulado. Para llamar a un método directo en un dispositivo, esta aplicación se conecta a un punto de conexión de servicio en IoT Hub.

Requisitos previos

• Una cuenta de Azure con una suscripción activa. cree una de forma gratuita.

• Las dos aplicaciones de ejemplo que se ejecutan en este inicio rápido se escriben con C#. Se necesita el SDK de .NET Core 3.1, o cualquier versión superior, en su máquina de desarrollo.

  Puede descargar el SDK de .NET Core para varias plataformas desde .NET.

  Puede verificar la versión actual de C# en el equipo de desarrollo con el comando siguiente:

  dotnet --version
  

• Si aún no lo ha hecho, descargue los ejemplos de C# de Azure IoT de https://github.com/Azure-Samples/azure-iot-samples-csharp/archive/main.zip y extraiga el archivo ZIP.

• Asegúrese de que está abierto el puerto 8883 del firewall. En el dispositivo de ejemplo de este inicio rápido se usa el protocolo MQTT, que se comunica mediante el puerto 8883. Este puerto puede estar bloqueado en algunos entornos de red corporativos y educativos. Para más información y para saber cómo solucionar este problema, consulte el artículo sobre la conexión a IoT Hub (MQTT).

• Use el entorno de Bash en Azure Cloud Shell.

  

• Si lo prefiere, instale la CLI de Azure para ejecutar sus comandos de referencia.

  • Si usa una instalación local, inicie sesión en la CLI de Azure mediante el comando az login. Siga los pasos que se muestran en el terminal para completar el proceso de autenticación. Para ver otras opciones de inicio de sesión, consulte Inicio de sesión con la CLI de Azure.

  • Cuando se le solicite, instale las extensiones de la CLI de Azure la primera vez que la use. Para más información sobre las extensiones, consulte Uso de extensiones con la CLI de Azure.

  • Ejecute az version para buscar cuál es la versión y las bibliotecas dependientes que están instaladas. Para realizar la actualización a la versión más reciente, ejecute az upgrade.

Crear un centro de IoT

Si ha completado el anterior Quickstart: Send telemetry from a device to an IoT hub (Inicio rápido: enviar datos de telemetría desde un dispositivo a IoT Hub), puede omitir este paso.

En esta sección se describe cómo crear un centro de IoT mediante Azure Portal.

1. Inicie sesión en Azure Portal.

2. En la página de inicio de Azure, seleccione + Crear un recurso y, después, escriba IoT Hub en el campo Buscar en Marketplace.

3. Seleccione IoT Hub en los resultados de la búsqueda y, después, haga clic en Crear.

4. En la pestaña Datos básicos, complete los campos como se indica a continuación:

   • Suscripción: seleccione la suscripción que quiera usar para el centro.

   • Grupo de recursos: seleccione un grupo de recursos o cree uno. Para crear uno, haga clic en Crear y escriba el nombre que quiera usar. Para usar un grupo de recursos existente, selecciónelo. Para más información, consulte Administración de grupos de recursos de Azure Resource Manager.

   • Región: seleccione la región a la que quiera asignar el centro. Seleccione la ubicación más cercana a la suya. Algunas características, como los flujos de dispositivo de IoT Hub, solo están disponibles en regiones específicas. Para ver estas características limitadas, debe seleccionar una de las regiones admitidas.

   • Nombre de la instancia de IoT Hub: escriba el nombre del centro. Este nombre debe ser globalmente único y tener una longitud que oscile entre 3 y 50 caracteres alfanuméricos. El nombre también puede incluir el carácter de guion ('-').

   Importante

   Como el centro de IoT se podrá detectar públicamente como un punto de conexión de DNS, asegúrese de que no incluye información de identificación personal ni información confidencial al asignarle un nombre.

   

5. Seleccione Siguiente: Redes para continuar con la creación del centro.

   Elija los puntos de conexión que los dispositivos puedan usar para conectar a su instancia de IoT Hub. Puede seleccionar la configuración predeterminada Punto de conexión público (todas las redes) o elegir Punto de conexión público (intervalos de IP seleccionados) o Punto de conexión privado. Acepte la configuración predeterminada para este ejemplo.

   .

6. Seleccione Siguiente: Administración para continuar con la creación del centro.

   

   Puede aceptar la configuración predeterminada aquí. Si lo desea, puede modificar cualquiera de los siguientes campos:

   • Plan de tarifa y escala: nivel seleccionado. Puede elegir entre varios niveles, en función del número de características que desee, y del número de mensajes que envíe al día a través de su solución. El nivel gratis está pensado para la prueba y evaluación. Permite la conexión de 500 dispositivos con el centro de IoT y hasta 8000 mensajes al día. Cada suscripción a Azure puede crear un centro de IoT en el nivel gratis.

     Si está trabajando con un inicio rápido de flujos de dispositivo de IoT Hub, seleccione el nivel gratuito.

   • Unidades de IoT Hub: El número de mensajes que se permiten por unidad al día depende del plan de tarifa del centro. Por ejemplo, si quiere que el Centro de IoT admita la entrada de 700 000 mensajes, seleccione dos unidades del nivel S1. Para más información sobre las demás opciones del nivel, consulte la sección Elección del nivel correcto de IoT Hub.

   • Defender para IoT Actívelo para agregar un nivel adicional de protección ante amenazas en IoT y en los dispositivos. Esta opción no está disponible para los centros de conectividad del nivel gratuito. Para obtener más información acerca de esta característica, consulte Microsoft Defender para IoT.

   • Configuración avanzada > Particiones del dispositivo a la nube: esta propiedad relaciona los mensajes del dispositivo a la nube con el número de lectores simultáneos de los mensajes. La mayoría de los centros solo necesitan cuatro particiones.

7. Seleccione Siguiente: Etiquetas para pasar a la pantalla siguiente.

   Las etiquetas son pares nombre-valor. Puede asignar la misma etiqueta a varios recursos y grupos de recursos para clasificar los recursos y consolidar la facturación. En este documento, no va a agregar ninguna etiqueta. Para más información, consulte Uso de etiquetas para organizar los recursos de Azure.

   

8. Seleccione Siguiente: Revisar y crear para revisar sus selecciones. Verá algo parecido a esta pantalla, pero con los valores que ha seleccionado al crear el centro.

   .

9. Seleccione Crear para iniciar la implementación del nuevo centro. La implementación estará en curso unos minutos mientras se crea el centro. Una vez que la implementación finalice, haga clic en Ir al recurso para abrir el nuevo centro.

Registrar un dispositivo

Si ha completado el anterior Quickstart: Send telemetry from a device to an IoT hub (Inicio rápido: enviar datos de telemetría desde un dispositivo a IoT Hub), puede omitir este paso.

Debe registrar un dispositivo con IoT Hub antes de poder conectarlo. En esta guía de inicio rápido, usará Azure Cloud Shell para registrar un dispositivo simulado.

1. Ejecute los siguientes comandos en Azure Cloud Shell para crear la identidad del dispositivo.

   YourIoTHubName: reemplace este marcador de posición por el nombre elegido para el centro de IoT.

   MyDotnetDevice: es el nombre del dispositivo que se va a registrar. Se recomienda usar MyDotnetDevice como se muestra. Si elige otro nombre distinto para el dispositivo, tendrá que usarlo en todo el artículo y actualizar el nombre del dispositivo en las aplicaciones de ejemplo antes de ejecutarlas.

   az iot hub device-identity create \
     --hub-name {YourIoTHubName} --device-id MyDotnetDevice
   

2. Ejecute los siguientes comandos en Azure Cloud Shell para obtener la cadena de conexión del dispositivo que acaba de registrar:

   YourIoTHubName: reemplace este marcador de posición por el nombre elegido para el centro de IoT.

   az iot hub device-identity connection-string show \
     --hub-name {YourIoTHubName} \
     --device-id MyDotnetDevice \
     --output table
   

   Anote la cadena de conexión del dispositivo, que se parecerá a esta:

   HostName={YourIoTHubName}.azure-devices.net;DeviceId=MyNodeDevice;SharedAccessKey={YourSharedAccessKey}

   Usará este valor más adelante en este inicio rápido.

Recuperación de la cadena de conexión de servicio

También necesita una cadena de conexión de servicio de IoT Hub para permitir que la aplicación de servicio se conecte al centro y recupere los mensajes. El comando siguiente recupera la cadena de conexión del servicio de su instancia de IoT Hub:

az iot hub connection-string show --policy-name service --hub-name {YourIoTHubName} --output table

Anote la cadena de conexión del servicio, que se parecerá a esta:

HostName={YourIoTHubName}.azure-devices.net;SharedAccessKeyName=service;SharedAccessKey={YourSharedAccessKey}

Usará este valor más adelante en este inicio rápido. Esta cadena de conexión del servicio no es la que anotó en el paso anterior.

Escuchas para llamadas de método directo

La aplicación del dispositivo simulado se conecta a un punto de conexión específico del dispositivo en IoT Hub, envía los datos de telemetría simulados y escucha llamadas de método directo desde el centro. En este inicio rápido, la llamada de método directo desde el centro indica al dispositivo que debe cambiar el intervalo en el que envía los datos de telemetría. El dispositivo simulado envía una confirmación al centro después de que ejecuta el método directo.

1. En una ventana de terminal local, vaya a la carpeta raíz del proyecto de C# de muestra. Luego, vaya a la carpeta iot-hub\Quickstarts\SimulatedDeviceWithCommand.

2. En la ventana de terminal local, ejecute los comandos siguientes para instalar los paquetes necesarios para la aplicación de dispositivo simulado:

   dotnet restore
   

3. En la ventana de terminal local, ejecute el siguiente comando para compilar la aplicación de dispositivo simulado y ejecutarla, pero sustituya {DeviceConnectionString} por la cadena de conexión del dispositivo que anotó anteriormente:

   dotnet run -- {DeviceConnectionString}
   

   La siguiente captura de pantalla muestra la salida en la que la aplicación de dispositivo simulado envía datos de telemetría a IoT Hub:

   

Llamar al método directo

La aplicación de servicio se conecta a un punto de conexión de servicio en IoT Hub. La aplicación realiza llamadas de método directo a un dispositivo con IoT Hub y escucha las confirmaciones. Las aplicación de servicio de IoT Hub habitualmente se ejecutan en la nube.

1. En otra ventana de terminal local, vaya a la carpeta raíz del proyecto de C# de muestra. A continuación, vaya a la carpeta iot-hub\Quickstarts\InvokeDeviceMethod.

2. En la ventana de terminal local, ejecute los comandos siguientes para instalar las bibliotecas necesarias para la aplicación de servicio:

   dotnet restore
   

3. En la ventana de terminal local, ejecute el siguiente comando para compilar la aplicación de servicio y ejecutarla, pero sustituya {ServiceConnectionString} por la cadena de conexión del servicio que anotó anteriormente:

   dotnet run -- {ServiceConnectionString}
   

   En la siguiente captura de pantalla se muestra la salida en la que la aplicación realiza una llamada de método directo al dispositivo y recibe una confirmación:

   

   Después de ejecutar la aplicación de servicio, verá un mensaje en la ventana de consola que ejecuta el dispositivo simulado y cambiará la velocidad a la que envía mensajes:

   

En este inicio rápido se usan dos aplicaciones Java: una aplicación de un dispositivo simulado que responde a métodos directos llamados desde una aplicación de back-end y una aplicación de servicio que llama al método directo en el dispositivo simulado.

Prerrequisitos

• Una cuenta de Azure con una suscripción activa. cree una de forma gratuita.

• Java SE Development Kit 8. En el artículo Soporte técnico de Java a largo plazo para Azure y Azure Stack, en la sección Soporte técnico a largo plazo, seleccione Java 8.

  Puede verificar la versión actual de Java en el equipo de desarrollo con el comando siguiente:

  java -version
  

• Apache Maven 3.

  Puede verificar la versión actual de Maven en el equipo de desarrollo con el comando siguiente:

  mvn --version
  

• Un proyecto en Java de ejemplo.

• El puerto 8883 abierto en el firewall. En el dispositivo de ejemplo de este inicio rápido se usa el protocolo MQTT, que se comunica mediante el puerto 8883. Este puerto puede estar bloqueado en algunos entornos de red corporativos y educativos. Para más información y para saber cómo solucionar este problema, consulte el artículo sobre la conexión a IoT Hub (MQTT).

• Use el entorno de Bash en Azure Cloud Shell.

  

• Si lo prefiere, instale la CLI de Azure para ejecutar sus comandos de referencia.

  • Si usa una instalación local, inicie sesión en la CLI de Azure mediante el comando az login. Siga los pasos que se muestran en el terminal para completar el proceso de autenticación. Para ver otras opciones de inicio de sesión, consulte Inicio de sesión con la CLI de Azure.

  • Cuando se le solicite, instale las extensiones de la CLI de Azure la primera vez que la use. Para más información sobre las extensiones, consulte Uso de extensiones con la CLI de Azure.

  • Ejecute az version para buscar cuál es la versión y las bibliotecas dependientes que están instaladas. Para realizar la actualización a la versión más reciente, ejecute az upgrade.

Crear un centro de IoT

Si ha completado el anterior Quickstart: Send telemetry from a device to an IoT hub (Inicio rápido: enviar datos de telemetría desde un dispositivo a IoT Hub), puede omitir este paso.

En esta sección se describe cómo crear un centro de IoT mediante Azure Portal.

1. Inicie sesión en Azure Portal.

2. En la página de inicio de Azure, seleccione + Crear un recurso y, después, escriba IoT Hub en el campo Buscar en Marketplace.

3. Seleccione IoT Hub en los resultados de la búsqueda y, después, haga clic en Crear.

4. En la pestaña Datos básicos, complete los campos como se indica a continuación:

   • Suscripción: seleccione la suscripción que quiera usar para el centro.

   • Grupo de recursos: seleccione un grupo de recursos o cree uno. Para crear uno, haga clic en Crear y escriba el nombre que quiera usar. Para usar un grupo de recursos existente, selecciónelo. Para más información, consulte Administración de grupos de recursos de Azure Resource Manager.

   • Región: seleccione la región a la que quiera asignar el centro. Seleccione la ubicación más cercana a la suya. Algunas características, como los flujos de dispositivo de IoT Hub, solo están disponibles en regiones específicas. Para ver estas características limitadas, debe seleccionar una de las regiones admitidas.

   • Nombre de la instancia de IoT Hub: escriba el nombre del centro. Este nombre debe ser globalmente único y tener una longitud que oscile entre 3 y 50 caracteres alfanuméricos. El nombre también puede incluir el carácter de guion ('-').

   Importante

   Como el centro de IoT se podrá detectar públicamente como un punto de conexión de DNS, asegúrese de que no incluye información de identificación personal ni información confidencial al asignarle un nombre.

   

5. Seleccione Siguiente: Redes para continuar con la creación del centro.

   Elija los puntos de conexión que los dispositivos puedan usar para conectar a su instancia de IoT Hub. Puede seleccionar la configuración predeterminada Punto de conexión público (todas las redes) o elegir Punto de conexión público (intervalos de IP seleccionados) o Punto de conexión privado. Acepte la configuración predeterminada para este ejemplo.

   .

6. Seleccione Siguiente: Administración para continuar con la creación del centro.

   

   Puede aceptar la configuración predeterminada aquí. Si lo desea, puede modificar cualquiera de los siguientes campos:

   • Plan de tarifa y escala: nivel seleccionado. Puede elegir entre varios niveles, en función del número de características que desee, y del número de mensajes que envíe al día a través de su solución. El nivel gratis está pensado para la prueba y evaluación. Permite la conexión de 500 dispositivos con el centro de IoT y hasta 8000 mensajes al día. Cada suscripción a Azure puede crear un centro de IoT en el nivel gratis.

     Si está trabajando con un inicio rápido de flujos de dispositivo de IoT Hub, seleccione el nivel gratuito.

   • Unidades de IoT Hub: El número de mensajes que se permiten por unidad al día depende del plan de tarifa del centro. Por ejemplo, si quiere que el Centro de IoT admita la entrada de 700 000 mensajes, seleccione dos unidades del nivel S1. Para más información sobre las demás opciones del nivel, consulte la sección Elección del nivel correcto de IoT Hub.

   • Defender para IoT Actívelo para agregar un nivel adicional de protección ante amenazas en IoT y en los dispositivos. Esta opción no está disponible para los centros de conectividad del nivel gratuito. Para obtener más información acerca de esta característica, consulte Microsoft Defender para IoT.

   • Configuración avanzada > Particiones del dispositivo a la nube: esta propiedad relaciona los mensajes del dispositivo a la nube con el número de lectores simultáneos de los mensajes. La mayoría de los centros solo necesitan cuatro particiones.

7. Seleccione Siguiente: Etiquetas para pasar a la pantalla siguiente.

   Las etiquetas son pares nombre-valor. Puede asignar la misma etiqueta a varios recursos y grupos de recursos para clasificar los recursos y consolidar la facturación. En este documento, no va a agregar ninguna etiqueta. Para más información, consulte Uso de etiquetas para organizar los recursos de Azure.

   

8. Seleccione Siguiente: Revisar y crear para revisar sus selecciones. Verá algo parecido a esta pantalla, pero con los valores que ha seleccionado al crear el centro.

   .

9. Seleccione Crear para iniciar la implementación del nuevo centro. La implementación estará en curso unos minutos mientras se crea el centro. Una vez que la implementación finalice, haga clic en Ir al recurso para abrir el nuevo centro.

Registrar un dispositivo

Si ha completado el anterior Quickstart: Send telemetry from a device to an IoT hub (Inicio rápido: enviar datos de telemetría desde un dispositivo a IoT Hub), puede omitir este paso.

Debe registrar un dispositivo con IoT Hub antes de poder conectarlo. En esta guía de inicio rápido, usará Azure Cloud Shell para registrar un dispositivo simulado.

1. Ejecute los siguientes comandos en Azure Cloud Shell para crear la identidad del dispositivo.

   YourIoTHubName: reemplace este marcador de posición por el nombre elegido para el centro de IoT.

   MyJavaDevice: es el nombre del dispositivo que se va a registrar. Se recomienda usar MyJavaDevice como se muestra. Si elige otro nombre distinto para el dispositivo, tendrá que usarlo en todo el artículo y actualizar el nombre del dispositivo en las aplicaciones de ejemplo antes de ejecutarlas.

   az iot hub device-identity create \
     --hub-name {YourIoTHubName} --device-id MyJavaDevice
   

2. Ejecute los siguientes comandos en Azure Cloud Shell para obtener la cadena de conexión del dispositivo que acaba de registrar:

   YourIoTHubName: reemplace este marcador de posición por el nombre elegido para el centro de IoT.

   az iot hub device-identity connection-string show\
     --hub-name {YourIoTHubName} \
     --device-id MyJavaDevice \
     --output table
   

   Anote la cadena de conexión del dispositivo, que se parecerá a esta:

   HostName={YourIoTHubName}.azure-devices.net;DeviceId=MyNodeDevice;SharedAccessKey={YourSharedAccessKey}

   Usará este valor más adelante en este inicio rápido.

Recuperación de la cadena de conexión de servicio

También necesita una cadena de conexión de servicio para permitir que la aplicación back-end se conecte a IoT Hub y recupere los mensajes. El comando siguiente recupera la cadena de conexión del servicio de su instancia de IoT Hub:

YourIoTHubName: reemplace este marcador de posición por el nombre elegido para el centro de IoT.

az iot hub connection-string show --policy-name service --name {YourIoTHubName} --output table

Anote la cadena de conexión del servicio, que se parecerá a esta:

HostName={YourIoTHubName}.azure-devices.net;SharedAccessKeyName=service;SharedAccessKey={YourSharedAccessKey}

Usará este valor más adelante en este inicio rápido. Esta cadena de conexión del servicio no es la que anotó en el paso anterior.

Escuchas para llamadas de método directo

La aplicación del dispositivo simulado se conecta a un punto de conexión específico del dispositivo en IoT Hub, envía los datos de telemetría simulados y escucha llamadas de método directo desde el centro. En este inicio rápido, la llamada de método directo desde el centro indica al dispositivo que debe cambiar el intervalo en el que envía los datos de telemetría. El dispositivo simulado envía una confirmación al centro después de que ejecuta el método directo.

1. En una ventana de terminal local, vaya a la carpeta raíz del proyecto de Java de ejemplo. A continuación, vaya a la carpeta iot-hub\Quickstarts\simulated-device-2.

2. Abra el archivo src/main/java/com/microsoft/docs/iothub/samples/SimulatedDevice.java en el editor de texto de su elección.

   Reemplace el valor de la variable connString por la cadena de conexión del dispositivo que anotó anteriormente. A continuación, guarde los cambios realizados en SimulatedDevice.java.

3. En la ventana de terminal local, ejecute los comandos siguientes para instalar las bibliotecas necesarias y compile la aplicación de dispositivo simulado:

   mvn clean package
   

4. En la ventana de terminal local, ejecute los comandos siguientes para ejecutar la aplicación de dispositivo simulado:

   java -jar target/simulated-device-2-1.0.0-with-deps.jar
   

   La siguiente captura de pantalla muestra la salida en la que la aplicación de dispositivo simulado envía datos de telemetría a IoT Hub:

   

Llamar al método directo

La aplicación back-end se conecta a un punto de conexión de servicio en IoT Hub. La aplicación realiza llamadas de método directo a un dispositivo con IoT Hub y escucha las confirmaciones. Normalmente, una aplicación back-end de IoT Hub se ejecuta en la nube.

1. En otra ventana de terminal local, vaya a la carpeta raíz del proyecto de Java de ejemplo. A continuación, vaya a la carpeta iot-hub\Quickstarts\back-end-application.

2. Abra el archivo src/main/java/com/microsoft/docs/iothub/samples/BackEndApplication.java en el editor de texto que prefiera.

   Reemplace el valor de la variable iotHubConnectionString por la cadena de conexión del servicio que anotó anteriormente. Luego, guarde los cambios en el archivo BackEndApplication.java.

3. En la ventana de terminal local, ejecute los comandos siguientes para instalar las bibliotecas necesarias y compile la aplicación back-end:

   mvn clean package
   

4. En la ventana de terminal local, ejecute los comandos siguientes para ejecutar la aplicación back-end:

   java -jar target/back-end-application-1.0.0-with-deps.jar
   

   En la siguiente captura de pantalla se muestra la salida en la que la aplicación realiza una llamada de método directo al dispositivo y recibe una confirmación:

   

   Después de ejecutar la aplicación back-end, verá un mensaje en la ventana de consola que ejecuta el dispositivo simulado y cambiará la velocidad a la que envía mensajes:

   

En este inicio rápido se usan dos aplicaciones de Node.js: una aplicación de un dispositivo simulado que responde a métodos directos llamados desde una aplicación de back-end y una aplicación de back-end que llama a los métodos directos en el dispositivo simulado.

Prerrequisitos

• Una cuenta de Azure con una suscripción activa. cree una de forma gratuita.

• Node.js 10+.

  Puede verificar la versión actual de Node.js en el equipo de desarrollo con el comando siguiente:

  node --version
  

• Un proyecto de Node.js de ejemplo.

• El puerto 8883 abierto en el firewall. En el dispositivo de ejemplo de este inicio rápido se usa el protocolo MQTT, que se comunica mediante el puerto 8883. Este puerto puede estar bloqueado en algunos entornos de red corporativos y educativos. Para más información y para saber cómo solucionar este problema, consulte el artículo sobre la conexión a IoT Hub (MQTT).

• Use el entorno de Bash en Azure Cloud Shell.

  

• Si lo prefiere, instale la CLI de Azure para ejecutar sus comandos de referencia.

  • Si usa una instalación local, inicie sesión en la CLI de Azure mediante el comando az login. Siga los pasos que se muestran en el terminal para completar el proceso de autenticación. Para ver otras opciones de inicio de sesión, consulte Inicio de sesión con la CLI de Azure.

  • Cuando se le solicite, instale las extensiones de la CLI de Azure la primera vez que la use. Para más información sobre las extensiones, consulte Uso de extensiones con la CLI de Azure.

  • Ejecute az version para buscar cuál es la versión y las bibliotecas dependientes que están instaladas. Para realizar la actualización a la versión más reciente, ejecute az upgrade.

Crear un centro de IoT

Si ha completado el anterior Quickstart: Send telemetry from a device to an IoT hub (Inicio rápido: enviar datos de telemetría desde un dispositivo a IoT Hub), puede omitir este paso.

En esta sección se describe cómo crear un centro de IoT mediante Azure Portal.

1. Inicie sesión en Azure Portal.

2. En la página de inicio de Azure, seleccione + Crear un recurso y, después, escriba IoT Hub en el campo Buscar en Marketplace.

3. Seleccione IoT Hub en los resultados de la búsqueda y, después, haga clic en Crear.

4. En la pestaña Datos básicos, complete los campos como se indica a continuación:

   • Suscripción: seleccione la suscripción que quiera usar para el centro.

   • Grupo de recursos: seleccione un grupo de recursos o cree uno. Para crear uno, haga clic en Crear y escriba el nombre que quiera usar. Para usar un grupo de recursos existente, selecciónelo. Para más información, consulte Administración de grupos de recursos de Azure Resource Manager.

   • Región: seleccione la región a la que quiera asignar el centro. Seleccione la ubicación más cercana a la suya. Algunas características, como los flujos de dispositivo de IoT Hub, solo están disponibles en regiones específicas. Para ver estas características limitadas, debe seleccionar una de las regiones admitidas.

   • Nombre de la instancia de IoT Hub: escriba el nombre del centro. Este nombre debe ser globalmente único y tener una longitud que oscile entre 3 y 50 caracteres alfanuméricos. El nombre también puede incluir el carácter de guion ('-').

   Importante

   Como el centro de IoT se podrá detectar públicamente como un punto de conexión de DNS, asegúrese de que no incluye información de identificación personal ni información confidencial al asignarle un nombre.

   

5. Seleccione Siguiente: Redes para continuar con la creación del centro.

   Elija los puntos de conexión que los dispositivos puedan usar para conectar a su instancia de IoT Hub. Puede seleccionar la configuración predeterminada Punto de conexión público (todas las redes) o elegir Punto de conexión público (intervalos de IP seleccionados) o Punto de conexión privado. Acepte la configuración predeterminada para este ejemplo.

   .

6. Seleccione Siguiente: Administración para continuar con la creación del centro.

   

   Puede aceptar la configuración predeterminada aquí. Si lo desea, puede modificar cualquiera de los siguientes campos:

   • Plan de tarifa y escala: nivel seleccionado. Puede elegir entre varios niveles, en función del número de características que desee, y del número de mensajes que envíe al día a través de su solución. El nivel gratis está pensado para la prueba y evaluación. Permite la conexión de 500 dispositivos con el centro de IoT y hasta 8000 mensajes al día. Cada suscripción a Azure puede crear un centro de IoT en el nivel gratis.

     Si está trabajando con un inicio rápido de flujos de dispositivo de IoT Hub, seleccione el nivel gratuito.

   • Unidades de IoT Hub: El número de mensajes que se permiten por unidad al día depende del plan de tarifa del centro. Por ejemplo, si quiere que el Centro de IoT admita la entrada de 700 000 mensajes, seleccione dos unidades del nivel S1. Para más información sobre las demás opciones del nivel, consulte la sección Elección del nivel correcto de IoT Hub.

   • Defender para IoT Actívelo para agregar un nivel adicional de protección ante amenazas en IoT y en los dispositivos. Esta opción no está disponible para los centros de conectividad del nivel gratuito. Para obtener más información acerca de esta característica, consulte Microsoft Defender para IoT.

   • Configuración avanzada > Particiones del dispositivo a la nube: esta propiedad relaciona los mensajes del dispositivo a la nube con el número de lectores simultáneos de los mensajes. La mayoría de los centros solo necesitan cuatro particiones.

7. Seleccione Siguiente: Etiquetas para pasar a la pantalla siguiente.

   Las etiquetas son pares nombre-valor. Puede asignar la misma etiqueta a varios recursos y grupos de recursos para clasificar los recursos y consolidar la facturación. En este documento, no va a agregar ninguna etiqueta. Para más información, consulte Uso de etiquetas para organizar los recursos de Azure.

   

8. Seleccione Siguiente: Revisar y crear para revisar sus selecciones. Verá algo parecido a esta pantalla, pero con los valores que ha seleccionado al crear el centro.

   .

9. Seleccione Crear para iniciar la implementación del nuevo centro. La implementación estará en curso unos minutos mientras se crea el centro. Una vez que la implementación finalice, haga clic en Ir al recurso para abrir el nuevo centro.

Registrar un dispositivo

Si ha completado el anterior Quickstart: Send telemetry from a device to an IoT hub (Inicio rápido: enviar datos de telemetría desde un dispositivo a IoT Hub), puede omitir este paso.

Debe registrar un dispositivo con IoT Hub antes de poder conectarlo. En esta guía de inicio rápido, usará Azure Cloud Shell para registrar un dispositivo simulado.

1. Ejecute los siguientes comandos en Azure Cloud Shell para crear la identidad del dispositivo.

   YourIoTHubName: reemplace este marcador de posición por el nombre elegido para el centro de IoT.

   MyNodeDevice: es el nombre del dispositivo que se va a registrar. Se recomienda usar MyNodeDevice como se muestra. Si elige otro nombre distinto para el dispositivo, tendrá que usarlo en todo el artículo y actualizar el nombre del dispositivo en las aplicaciones de ejemplo antes de ejecutarlas.

   az iot hub device-identity create \
     --hub-name {YourIoTHubName} --device-id MyNodeDevice
   

2. Ejecute los siguientes comandos en Azure Cloud Shell para obtener la cadena de conexión del dispositivo que acaba de registrar:

   YourIoTHubName: reemplace este marcador de posición por el nombre elegido para el centro de IoT.

   az iot hub device-identity connection-string show \
     --hub-name {YourIoTHubName} \
     --device-id MyNodeDevice \
     --output table
   

   Anote la cadena de conexión del dispositivo, que se parecerá a esta:

   HostName={YourIoTHubName}.azure-devices.net;DeviceId=MyNodeDevice;SharedAccessKey={YourSharedAccessKey}

   Usará este valor más adelante en este inicio rápido.

3. También necesita una cadena de conexión de servicio para permitir que la aplicación back-end se conecte a IoT Hub y recupere los mensajes. El comando siguiente recupera la cadena de conexión del servicio de su instancia de IoT Hub:

   YourIoTHubName: reemplace este marcador de posición por el nombre elegido para el centro de IoT.

   az iot hub connection-string show \
     --policy-name service --name {YourIoTHubName} --output table
   
   

   Anote la cadena de conexión del servicio, que se parecerá a esta:

   HostName={YourIoTHubName}.azure-devices.net;SharedAccessKeyName=service;SharedAccessKey={YourSharedAccessKey}

   Usará este valor más adelante en este inicio rápido. Esta cadena de conexión del servicio no es la que anotó en el paso anterior.

Escuchas para llamadas de método directo

La aplicación del dispositivo simulado se conecta a un punto de conexión específico del dispositivo en IoT Hub, envía los datos de telemetría simulados y escucha llamadas de método directo desde el centro. En este inicio rápido, la llamada de método directo desde el centro indica al dispositivo que debe cambiar el intervalo en el que envía los datos de telemetría. El dispositivo simulado envía una confirmación al centro después de que ejecuta el método directo.

1. En una ventana de terminal local, vaya a la carpeta raíz del proyecto de Node.js de ejemplo. A continuación, vaya a la carpeta iot-hub\Quickstarts\simulated-device-2.

2. Abra el archivo SimulatedDevice.js en el editor de texto de su elección.

   Reemplace el valor de la variable connectionString por la cadena de conexión del dispositivo que anotó anteriormente. Luego, guarde los cambios realizados en SimulatedDevice.js.

3. En la ventana de terminal local, ejecute los comandos siguientes para instalar las bibliotecas necesarias y ejecute la aplicación de dispositivo simulado:

   npm install
   node SimulatedDevice.js
   

   La siguiente captura de pantalla muestra la salida en la que la aplicación de dispositivo simulado envía datos de telemetría a IoT Hub:

   

Llamar al método directo

La aplicación back-end se conecta a un punto de conexión de servicio en IoT Hub. La aplicación realiza llamadas de método directo a un dispositivo con IoT Hub y escucha las confirmaciones. Normalmente, una aplicación back-end de IoT Hub se ejecuta en la nube.

1. En otra ventana de terminal local, vaya a la carpeta raíz del proyecto de Node.js de ejemplo. A continuación, vaya a la carpeta iot-hub\Quickstarts\back-end-application.

2. Abra el archivo BackEndApplication.js en el editor de texto de su elección.

   Reemplace el valor de la variable connectionString por la cadena de conexión del servicio que anotó anteriormente. Luego, guarde los cambios en el archivo BackEndApplication.js.

3. En la ventana de terminal local, ejecute los comandos siguientes para instalar las bibliotecas necesarias y ejecute la aplicación back-end:

   npm install
   node BackEndApplication.js
   

   En la siguiente captura de pantalla se muestra la salida en la que la aplicación realiza una llamada de método directo al dispositivo y recibe una confirmación:

   

   Después de ejecutar la aplicación back-end, verá un mensaje en la ventana de consola que ejecuta el dispositivo simulado y cambiará la velocidad a la que envía mensajes:

   

En este inicio rápido se usan dos aplicaciones de Python: una aplicación de un dispositivo simulado que responde a métodos directos llamados desde una aplicación de back-end y una aplicación de back-end que llama a los métodos directos en el dispositivo simulado.

Prerrequisitos

• Una cuenta de Azure con una suscripción activa. cree una de forma gratuita.

• Python 3.7+. Para obtener información acerca de otras versiones de Python compatibles, consulte el tema acerca de las características de los dispositivos IoT de Azure.

• Un proyecto de Python de ejemplo de GitHub. Descargue o clone los ejemplos mediante el botón Código del repositorio de GitHub.

• El puerto 8883 abierto en el firewall. En el dispositivo de ejemplo de este inicio rápido se usa el protocolo MQTT, que se comunica mediante el puerto 8883. Este puerto puede estar bloqueado en algunos entornos de red corporativos y educativos. Para más información y para saber cómo solucionar este problema, consulte el artículo sobre la conexión a IoT Hub (MQTT).

• Use el entorno de Bash en Azure Cloud Shell.

  

• Si lo prefiere, instale la CLI de Azure para ejecutar sus comandos de referencia.

  • Si usa una instalación local, inicie sesión en la CLI de Azure mediante el comando az login. Siga los pasos que se muestran en el terminal para completar el proceso de autenticación. Para ver otras opciones de inicio de sesión, consulte Inicio de sesión con la CLI de Azure.

  • Cuando se le solicite, instale las extensiones de la CLI de Azure la primera vez que la use. Para más información sobre las extensiones, consulte Uso de extensiones con la CLI de Azure.

  • Ejecute az version para buscar cuál es la versión y las bibliotecas dependientes que están instaladas. Para realizar la actualización a la versión más reciente, ejecute az upgrade.

Crear un centro de IoT

Si ha completado el anterior Quickstart: Send telemetry from a device to an IoT hub (Inicio rápido: enviar datos de telemetría desde un dispositivo a IoT Hub), puede omitir este paso.

En esta sección se describe cómo crear un centro de IoT mediante Azure Portal.

1. Inicie sesión en Azure Portal.

2. En la página de inicio de Azure, seleccione + Crear un recurso y, después, escriba IoT Hub en el campo Buscar en Marketplace.

3. Seleccione IoT Hub en los resultados de la búsqueda y, después, haga clic en Crear.

4. En la pestaña Datos básicos, complete los campos como se indica a continuación:

   • Suscripción: seleccione la suscripción que quiera usar para el centro.

   • Grupo de recursos: seleccione un grupo de recursos o cree uno. Para crear uno, haga clic en Crear y escriba el nombre que quiera usar. Para usar un grupo de recursos existente, selecciónelo. Para más información, consulte Administración de grupos de recursos de Azure Resource Manager.

   • Región: seleccione la región a la que quiera asignar el centro. Seleccione la ubicación más cercana a la suya. Algunas características, como los flujos de dispositivo de IoT Hub, solo están disponibles en regiones específicas. Para ver estas características limitadas, debe seleccionar una de las regiones admitidas.

   • Nombre de la instancia de IoT Hub: escriba el nombre del centro. Este nombre debe ser globalmente único y tener una longitud que oscile entre 3 y 50 caracteres alfanuméricos. El nombre también puede incluir el carácter de guion ('-').

   Importante

   Como el centro de IoT se podrá detectar públicamente como un punto de conexión de DNS, asegúrese de que no incluye información de identificación personal ni información confidencial al asignarle un nombre.

   

5. Seleccione Siguiente: Redes para continuar con la creación del centro.

   Elija los puntos de conexión que los dispositivos puedan usar para conectar a su instancia de IoT Hub. Puede seleccionar la configuración predeterminada Punto de conexión público (todas las redes) o elegir Punto de conexión público (intervalos de IP seleccionados) o Punto de conexión privado. Acepte la configuración predeterminada para este ejemplo.

   .

6. Seleccione Siguiente: Administración para continuar con la creación del centro.

   

   Puede aceptar la configuración predeterminada aquí. Si lo desea, puede modificar cualquiera de los siguientes campos:

   • Plan de tarifa y escala: nivel seleccionado. Puede elegir entre varios niveles, en función del número de características que desee, y del número de mensajes que envíe al día a través de su solución. El nivel gratis está pensado para la prueba y evaluación. Permite la conexión de 500 dispositivos con el centro de IoT y hasta 8000 mensajes al día. Cada suscripción a Azure puede crear un centro de IoT en el nivel gratis.

     Si está trabajando con un inicio rápido de flujos de dispositivo de IoT Hub, seleccione el nivel gratuito.

   • Unidades de IoT Hub: El número de mensajes que se permiten por unidad al día depende del plan de tarifa del centro. Por ejemplo, si quiere que el Centro de IoT admita la entrada de 700 000 mensajes, seleccione dos unidades del nivel S1. Para más información sobre las demás opciones del nivel, consulte la sección Elección del nivel correcto de IoT Hub.

   • Defender para IoT Actívelo para agregar un nivel adicional de protección ante amenazas en IoT y en los dispositivos. Esta opción no está disponible para los centros de conectividad del nivel gratuito. Para obtener más información acerca de esta característica, consulte Microsoft Defender para IoT.

   • Configuración avanzada > Particiones del dispositivo a la nube: esta propiedad relaciona los mensajes del dispositivo a la nube con el número de lectores simultáneos de los mensajes. La mayoría de los centros solo necesitan cuatro particiones.

7. Seleccione Siguiente: Etiquetas para pasar a la pantalla siguiente.

   Las etiquetas son pares nombre-valor. Puede asignar la misma etiqueta a varios recursos y grupos de recursos para clasificar los recursos y consolidar la facturación. En este documento, no va a agregar ninguna etiqueta. Para más información, consulte Uso de etiquetas para organizar los recursos de Azure.

   

8. Seleccione Siguiente: Revisar y crear para revisar sus selecciones. Verá algo parecido a esta pantalla, pero con los valores que ha seleccionado al crear el centro.

   .

9. Seleccione Crear para iniciar la implementación del nuevo centro. La implementación estará en curso unos minutos mientras se crea el centro. Una vez que la implementación finalice, haga clic en Ir al recurso para abrir el nuevo centro.

Registrar un dispositivo

Si ha completado el anterior Quickstart: Send telemetry from a device to an IoT hub (Inicio rápido: enviar datos de telemetría desde un dispositivo a IoT Hub), puede omitir este paso.

Debe registrar un dispositivo con IoT Hub antes de poder conectarlo. En esta guía de inicio rápido, usará Azure Cloud Shell para registrar un dispositivo simulado.

1. Ejecute los siguientes comandos en Azure Cloud Shell para crear la identidad del dispositivo.

   YourIoTHubName: reemplace este marcador de posición por el nombre elegido para el centro de IoT.

   MyPythonDevice: es el nombre del dispositivo que se va a registrar. Se recomienda usar MyPythonDevice como se muestra. Si elige otro nombre distinto para el dispositivo, tendrá que usarlo en todo el artículo y actualizar el nombre del dispositivo en las aplicaciones de ejemplo antes de ejecutarlas.

   az iot hub device-identity create --hub-name {YourIoTHubName} --device-id MyPythonDevice
   

2. Ejecute los siguientes comandos en Azure Cloud Shell para obtener la cadena de conexión del dispositivo que acaba de registrar:

   YourIoTHubName: reemplace este marcador de posición por el nombre elegido para el centro de IoT.

   az iot hub device-identity connection-string show --hub-name {YourIoTHubName} --device-id MyPythonDevice --output table
   

   Anote la cadena de conexión del dispositivo, que se parecerá a esta:

   HostName={YourIoTHubName}.azure-devices.net;DeviceId=MyNodeDevice;SharedAccessKey={YourSharedAccessKey}

   Usará este valor más adelante en este inicio rápido.

3. También necesita una cadena de conexión de servicio para permitir que la aplicación back-end se conecte a IoT Hub y recupere los mensajes. El comando siguiente recupera la cadena de conexión del servicio de su instancia de IoT Hub:

   YourIoTHubName: reemplace este marcador de posición por el nombre elegido para el centro de IoT.

   az iot hub connection-string show \
     --policy-name service \
     --hub-name {YourIoTHubName} \
     --output table
   

   Anote la cadena de conexión del servicio, que se parecerá a esta:

   HostName={YourIoTHubName}.azure-devices.net;SharedAccessKeyName=service;SharedAccessKey={YourSharedAccessKey}

   Usará este valor más adelante en este inicio rápido. Esta cadena de conexión del servicio no es la que anotó en el paso anterior.

Escuchas para llamadas de método directo

La aplicación del dispositivo simulado se conecta a un punto de conexión específico del dispositivo en IoT Hub, envía los datos de telemetría simulados y escucha llamadas de método directo desde el centro. En este inicio rápido, la llamada de método directo desde el centro indica al dispositivo que debe cambiar el intervalo en el que envía los datos de telemetría. El dispositivo simulado envía una confirmación al centro después de que ejecuta el método directo.

1. En una ventana de terminal local, vaya a la carpeta raíz del proyecto de Python de muestra. A continuación, vaya a la carpeta iot-hub\Quickstarts\simulated-device-2.

2. Abra el archivo SimulatedDevice.py en el editor de texto de su elección.

   Reemplace el valor de la variable CONNECTION_STRING por la cadena de conexión del dispositivo que anotó anteriormente. Luego, guarde los cambios realizados en SimulatedDevice.py.

3. En la ventana de terminal local, ejecute los comandos siguientes para instalar las bibliotecas necesarias para la aplicación de dispositivo simulado:

   pip install azure-iot-device
   

4. En la ventana de terminal local, ejecute los comandos siguientes para ejecutar la aplicación de dispositivo simulado:

   python SimulatedDevice.py
   

   La siguiente captura de pantalla muestra la salida en la que la aplicación de dispositivo simulado envía datos de telemetría a IoT Hub:

   

Llamar al método directo

La aplicación back-end se conecta a un punto de conexión de servicio en IoT Hub. La aplicación realiza llamadas de método directo a un dispositivo con IoT Hub y escucha las confirmaciones. Normalmente, una aplicación back-end de IoT Hub se ejecuta en la nube.

1. En otra ventana de terminal local, vaya a la carpeta raíz del proyecto de Python de muestra. A continuación, vaya a la carpeta iot-hub\Quickstarts\back-end-application.

2. Abra el archivo BackEndApplication.py en el editor de texto de su elección.

   Reemplace el valor de la variable CONNECTION_STRING por la cadena de conexión del servicio que anotó anteriormente. Luego, guarde los cambios en el archivo BackEndApplication.py.

3. En la ventana de terminal local, ejecute los comandos siguientes para instalar las bibliotecas necesarias para la aplicación de dispositivo simulado:

   pip install azure-iot-hub
   

4. En la ventana de terminal local, ejecute los comandos siguientes para ejecutar la aplicación back-end:

   python BackEndApplication.py
   

   En la siguiente captura de pantalla se muestra la salida en la que la aplicación realiza una llamada de método directo al dispositivo y recibe una confirmación:

   

   Después de ejecutar la aplicación back-end, verá un mensaje en la ventana de consola que ejecuta el dispositivo simulado y cambiará la velocidad a la que envía mensajes: