Conectar el simulador en línea de Raspberry Pi a Azure IoT Hub (Node.js)Connect Raspberry Pi online simulator to Azure IoT Hub (Node.js)

En este tutorial, empezará por aprender los principios básicos del uso del simulador en línea de Raspberry Pi.In this tutorial, you begin by learning the basics of working with Raspberry Pi online simulator. A continuación, aprenderá a conectar sin problemas el simulador Pi a la nube con Azure IoT Hub.You then learn how to seamlessly connect the Pi simulator to the cloud by using Azure IoT Hub.

Connect Raspberry Pi web simulator to Azure IoT Hub

Si tiene dispositivos físicos, visite Conectar Raspberry Pi a Azure IoT Hub para comenzar.If you have physical devices, visit Connect Raspberry Pi to Azure IoT Hub to get started.

Qué debe hacerWhat you do

  • Conozca los aspectos fundamentales del simulador en línea de Raspberry Pi.Learn the basics of Raspberry Pi online simulator.

  • Cree un Centro de IoT.Create an IoT hub.

  • Registre un dispositivo para Pi en IoT Hub.Register a device for Pi in your IoT hub.

  • Ejecuta una aplicación de ejemplo en PI para enviar datos de sensor simulados a IoT Hub.Run a sample application on Pi to send simulated sensor data to your IoT hub.

Conecte Raspberry Pi simulado al IoT Hub que ha creado.Connect simulated Raspberry Pi to an IoT hub that you create. A continuación, ejecute una aplicación de ejemplo con el simulador para generar datos de sensor.Then you run a sample application with the simulator to generate sensor data. Por último, envíe los datos del sensor a IoT Hub.Finally, you send the sensor data to your IoT hub.

Conocimientos que adquiriráWhat you learn

  • Cómo crear Azure IoT Hub y obtener la cadena de conexión del nuevo dispositivo.How to create an Azure IoT hub and get your new device connection string. Si no tiene ninguna cuenta de Azure, cree una cuenta de evaluación gratuita de Azure en solo unos minutos.If you don't have an Azure account, create a free Azure trial account in just a few minutes.

  • Cómo trabajar con el simulador en línea de Raspberry Pi.How to work with Raspberry Pi online simulator.

  • Cómo enviar los datos del sensor a IoT Hub.How to send sensor data to your IoT hub.

Introducción al simulador web de Raspberry PiOverview of Raspberry Pi web simulator

Haga clic en el botón para iniciar el simulador en línea de Raspberry Pi.Click the button to launch Raspberry Pi online simulator.

Hay tres áreas en el simulador web.There are three areas in the web simulator.

  1. Área de ensamblado: el circuito predeterminado es que Pi se conecta con un sensor BME280 y un LED.Assembly area - The default circuit is that a Pi connects with a BME280 sensor and an LED. Esta área está bloqueada en la versión preliminar por lo que actualmente no puede hacer ninguna personalización.The area is locked in preview version so currently you cannot do customization.

  2. Área de codificación: un editor de código en línea para codificar con Raspberry Pi.Coding area - An online code editor for you to code with Raspberry Pi. La aplicación de ejemplo predeterminada ayuda a recopilar datos de sensor desde el sensor BME280 y los envía a Azure IoT Hub.The default sample application helps to collect sensor data from BME280 sensor and sends to your Azure IoT Hub. La aplicación es totalmente compatible con dispositivos Pi reales.The application is fully compatible with real Pi devices.

  3. Ventana de consola integrada: muestra la salida del código.Integrated console window - It shows the output of your code. En la parte superior de esta ventana aparecen tres botones.At the top of this window, there are three buttons.

    • Run (Ejecutar): ejecute la aplicación en el área de codificación.Run - Run the application in the coding area.

    • Reset (Restablecer): restablezca el área de codificación a la aplicación de ejemplo predeterminada.Reset - Reset the coding area to the default sample application.

    • Fold/Expand (Plegar/expandir): al lado derecho hay un botón para plegar o expandir la ventana de consola.Fold/Expand - On the right side there is a button for you to fold/expand the console window.

Nota

El simulador web de Raspberry Pi ahora está disponible en versión preliminar.The Raspberry Pi web simulator is now available in preview version. Nos gustaría oír su voz en la sala de chat de Gitter.We'd like to hear your voice in the Gitter Chatroom. El código fuente es público en GitHub.The source code is public on GitHub.

Introducción al simulador en línea de Pi

Crear un centro de IoTCreate an IoT hub

En esta sección se describe cómo crear un centro de IoT mediante Azure Portal.This section describes how to create an IoT hub using the Azure portal.

  1. Inicie sesión en Azure Portal.Sign in to the 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.From the Azure homepage, select the + Create a resource button, and then enter IoT Hub in the Search the Marketplace field.

  3. Seleccione IoT Hub en los resultados de la búsqueda y, después, haga clic en Crear.Select IoT Hub from the search results, and then select Create.

  4. En la pestaña Datos básicos, complete los campos como se indica a continuación:On the Basics tab, complete the fields as follows:

    • Suscripción: seleccione la suscripción que quiera usar para el centro.Subscription: Select the subscription to use for your hub.

    • Grupo de recursos: seleccione un grupo de recursos o cree uno.Resource Group: Select a resource group or create a new one. Para crear uno, haga clic en Crear y escriba el nombre que quiera usar.To create a new one, select Create new and fill in the name you want to use. Para usar un grupo de recursos existente, selecciónelo.To use an existing resource group, select that resource group. Para más información, consulte Administración de grupos de recursos de Azure Resource Manager.For more information, see Manage Azure Resource Manager resource groups.

    • Región: seleccione la región a la que quiera asignar el centro.Region: Select the region in which you want your hub to be located. Seleccione la ubicación más cercana a la suya.Select the location closest to you. Algunas características, como los flujos de dispositivo de IoT Hub, solo están disponibles en regiones específicas.Some features, such as IoT Hub device streams, are only available in specific regions. Para ver estas características limitadas, debe seleccionar una de las regiones admitidas.For these limited features, you must select one of the supported regions.

    • Nombre de la instancia de IoT Hub: escriba el nombre del centro.IoT Hub Name: Enter a name for your hub. Este nombre debe ser único globalmente.This name must be globally unique. Si el nombre que escribe está disponible, aparece una marca de verificación verde.If the name you enter is available, a green check mark appears.

    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.Because the IoT hub will be publicly discoverable as a DNS endpoint, be sure to avoid entering any sensitive or personally identifiable information when you name it.

    Creación de un centro mediante Azure Portal

  5. Seleccione Siguiente: escala y tamaño para seguir creando el centro.Select Next: Size and scale to continue creating your hub.

    Configuración del tamaño y la escala de un nuevo centro de IoT mediante Azure Portal

    Puede aceptar la configuración predeterminada aquí.You can accept the default settings here. Si lo desea, puede modificar cualquiera de los siguientes campos:If desired, you can modify any of the following fields:

    • Plan de tarifa y escala: nivel seleccionado.Pricing and scale tier: Your selected tier. 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.You can choose from several tiers, depending on how many features you want and how many messages you send through your solution per day. El nivel gratis está pensado para la prueba y evaluación.The free tier is intended for testing and evaluation. Permite la conexión de 500 dispositivos con el centro de IoT y hasta 8000 mensajes al día.It allows 500 devices to be connected to the hub and up to 8,000 messages per day. Cada suscripción a Azure puede crear un centro de IoT en el nivel gratis.Each Azure subscription can create one IoT hub in the free tier.

      Si está trabajando con un inicio rápido de flujos de dispositivo de IoT Hub, seleccione el nivel gratuito.If you are working through a Quickstart for IoT Hub device streams, select the free tier.

    • Unidades de IoT Hub: El número de mensajes que se permiten por unidad al día depende del plan de tarifa del centro.IoT Hub units: The number of messages allowed per unit per day depends on your hub's pricing tier. Por ejemplo, si quiere que el Centro de IoT admita la entrada de 700 000 mensajes, seleccione dos unidades del nivel S1.For example, if you want the hub to support ingress of 700,000 messages, you choose two S1 tier units. Para más información sobre las demás opciones del nivel, consulte la sección Elección del nivel correcto de IoT Hub.For details about the other tier options, see Choosing the right IoT Hub tier.

    • Azure Security Center: Actívelo para agregar un nivel adicional de protección ante amenazas en IoT y en los dispositivos.Azure Security Center: Turn this on to add an extra layer of threat protection to IoT and your devices. Esta opción no está disponible para los centros de conectividad del nivel gratuito.This option is not available for hubs in the free tier. Para más información acerca de esta característica, consulte Azure Security Center para IoT.For more information about this feature, see Azure Security Center for 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.Advanced Settings > Device-to-cloud partitions: This property relates the device-to-cloud messages to the number of simultaneous readers of the messages. La mayoría de los centros solo necesitan cuatro particiones.Most hubs need only four partitions.

  6. Seleccione Siguiente: Etiquetas para pasar a la pantalla siguiente.Select Next: Tags to continue to the next screen.

    Las etiquetas son pares nombre-valor.Tags are name/value pairs. Puede asignar la misma etiqueta a varios recursos y grupos de recursos para clasificar los recursos y consolidar la facturación.You can assign the same tag to multiple resources and resource groups to categorize resources and consolidate billing. Para más información, consulte Uso de etiquetas para organizar los recursos de Azure.For more information, see Use tags to organize your Azure resources.

    Asignación de etiquetas para el centro mediante Azure Portal

  7. Seleccione Siguiente: Revisar y crear para revisar sus selecciones.Select Next: Review + create to review your choices. Verá algo parecido a esta pantalla, pero con los valores que ha seleccionado al crear el centro.You see something similar to this screen, but with the values you selected when creating the hub.

    Revisión de la información para crear el centro de IoT

  8. Seleccione Crear para crear un centro.Select Create to create your new hub. Esta operación tarda unos minutos.Creating the hub takes a few minutes.

Registro de un nuevo dispositivo en el centro de IoTRegister a new device in the IoT hub

En esta sección, creará una identidad de dispositivo en el registro de identidades del centro de IoT.In this section, you create a device identity in the identity registry in your IoT hub. No se puede conectar un dispositivo a un centro a menos que tenga una entrada en el registro de identidades.A device cannot connect to a hub unless it has an entry in the identity registry. Vea la guía para desarrolladores de IoT Hub para más información.For more information, see the IoT Hub developer guide.

  1. En el menú de navegación del centro de IoT, abra Dispositivos IoT y, después, seleccione Nuevo para agregar un dispositivo nuevo en el centro de IoT.In your IoT hub navigation menu, open IoT Devices, then select New to add a device in your IoT hub.

    Creación de la identidad del dispositivo en el portal

  2. En Crear un dispositivo, proporcione un nombre para el dispositivo nuevo, como IdDeMiDispositivo y seleccione Guardar.In Create a device, provide a name for your new device, such as myDeviceId, and select Save. Esta acción crea una nueva identidad de dispositivo para su centro de IoT.This action creates a device identity for your IoT hub.

    Agregar un nuevo dispositivo

    Importante

    El identificador del dispositivo puede estar visible en los registros recopilados para soporte técnico y solución de problemas del cliente, por tanto asegúrese de evitar cualquier información confidencial al darle el nombre.The device ID may be visible in the logs collected for customer support and troubleshooting, so make sure to avoid any sensitive information while naming it.

  3. Después de crear el dispositivo, ábralo desde la lista del panel Dispositivos de IoT.After the device is created, open the device from the list in the IoT devices pane. Copie la cadena de conexión principal para usarla después.Copy the Primary Connection String to use later.

    Cadena de conexión de dispositivo

Nota

El registro de identidades de IoT Hub solo almacena identidades de dispositivos para permitir el acceso seguro a IoT Hub.The IoT Hub identity registry only stores device identities to enable secure access to the IoT hub. Almacena las claves y los identificadores de dispositivo para usarlos como credenciales de seguridad, y un indicador de habilitado o deshabilitado que permite deshabilitar el acceso a un dispositivo individual.It stores device IDs and keys to use as security credentials, and an enabled/disabled flag that you can use to disable access for an individual device. Si la aplicación necesita almacenar otros metadatos específicos del dispositivo, debe usar un almacén específico de la aplicación.If your application needs to store other device-specific metadata, it should use an application-specific store. Consulte la guía de desarrolladores de IoT Hub para obtener más información.For more information, see IoT Hub developer guide.

Ejecución de una aplicación de ejemplo en el simulador web de PiRun a sample application on Pi web simulator

  1. En el área de codificación, asegúrese de trabajar en la aplicación de ejemplo predeterminada.In coding area, make sure you are working on the default sample application. Reemplace el marcador de posición de la línea 15 con la cadena de conexión del dispositivo de Azure IoT Hub.Replace the placeholder in Line 15 with the Azure IoT hub device connection string.

  2. Reemplazo de la cadena de conexión de dispositivo

  3. Seleccione Ejecutar o escriba npm start para ejecutar la aplicación.Select Run or type npm start to run the application.

Debería ver el resultado siguiente que muestra los datos de sensor y los mensajes que se envían a IoT Hub Resultado: datos de sensor enviados desde Raspberry Pi a IoT HubYou should see the following output that shows the sensor data and the messages that are sent to your IoT hub Output - sensor data sent from Raspberry Pi to your IoT hub

Lectura de los mensajes recibidos por IoT HubRead the messages received by your hub

Una forma de supervisar los mensajes que recibe el centro de IoT del dispositivo simulado consiste en usar Azure IoT Tools para Visual Studio Code.One way to monitor messages received by your IoT hub from the simulated device is to use the Azure IoT Tools for Visual Studio Code. Para más información, vea Uso de Azure IoT Tools para Visual Studio Code a fin de enviar y recibir mensajes entre el dispositivo e IoT Hub.To learn more, see Use Azure IoT Tools for Visual Studio Code to send and receive messages between your device and IoT Hub.

Para obtener más formas de procesar los datos enviados por el dispositivo, continúe con la sección siguiente.For more ways to process data sent by your device, continue on to the next section.

Pasos siguientesNext steps

Ha ejecutado una aplicación de ejemplo para recopilar datos de sensor y enviarlos a IoT Hub.You’ve run a sample application to collect sensor data and send it to your IoT hub.

Para continuar la introducción a Azure IoT Hub y explorar todos los escenarios de IoT con mayor detalle, consulte lo siguiente:To continue to get started with Azure IoT Hub and to explore all extended IoT scenarios, see the following: