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.

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.Log in to the Azure portal.

  2. Elija + Crear un recurso y, a continuación, Internet de las cosas.Choose +Create a resource, then choose Internet of Things.

  3. Haga clic en Centro de Iot en la lista de la derecha.Click Iot Hub from the list on the right. Verá la primera pantalla para crear un centro de IoT.You see the first screen for creating an IoT hub.

    Captura de pantalla donde se muestra cómo crear un hub en Azure Portal

    Rellene los campos.Fill in the fields.

    Subscription (Suscripción): seleccione la suscripción que se usará con su centro de IoT.Subscription: Select the subscription to use for your IoT hub.

    Resource Group (Grupo de recursos): puede crear un grupo de recursos o usar uno ya existente.Resource Group: You can create a new resource group or use an existing one. Para crear uno, haga clic en Create new (Crear) y escriba el nombre que quiere usar.To create a new one, click Create new and fill in the name you want to use. Para usar un grupo de recursos existente, haga clic en Use existing (Usar existente) y seleccione el grupo de recursos de la lista desplegable.To use an existing resource group, click Use existing and select the resource group from the dropdown list. Para más información, consulte Administración de los recursos de Azure a través del Portal.For more information, see Use resource groups to manage your Azure resources.

    Region (Región): es la región en la que quiere ubicar el centro.Region: This is the region in which you want your hub to be located. Seleccione la ubicación más cercana a usted en la lista desplegable.Select the location closest to you from the dropdown list.

    IoT Hub Name (Nombre del centro de IoT): escriba el nombre del centro de IoT.IoT Hub Name: Put in the name for your IoT 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

    IoT Hub puede detectarse públicamente como un punto de conexión DNS, por tanto, procure evitar cualquier información confidencial al darle el nombre.The IoT hub will be publicly discoverable as a DNS endpoint, so make sure to avoid any sensitive information while naming it.

  4. Haga clic en Next: Size and scale (Siguiente: tamaño y escala) para seguir con la creación del centro de IoT.Click Next: Size and scale to continue creating your IoT hub.

    Captura de pantalla que muestra la configuración de tamaño y escala de un nuevo centro de IoT mediante Azure Portal

    En esta pantalla, puede aceptar los valores predeterminados y hacer clic en Review + create (Revisar y crear) en la parte inferior.On this screen, you can take the defaults and just click Review + create at the bottom.

    Pricing and scale tier (Nivel de precios y de escala): puede elegir entre varios niveles, en función del número de características que quiera y el número de mensajes que envíe mediante su solución al día.Pricing and scale tier: 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 IoT hub and up to 8,000 messages per day. Cada suscripción a Azure puede crear una instancia de IoT Hub en el nivel gratis.Each Azure subscription can create one IoT Hub in the free tier.

    IoT Hub units (Unidades de IoT Hub): el número de mensajes que se permiten por unidad y por 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 desea que el Centro de IoT admita la entrada de 700 000 mensajes, elija dos unidades del nivel de S1.For example, if you want the IoT 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.

    Advanced / Device-to-cloud partitions (Particiones avanzadas/de dispositivo a nube): esta propiedad relaciona los mensajes del dispositivo a la nube con el número de lectores simultáneos de los mensajes.Advanced / 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 de IoT solo necesitan cuatro particiones.Most IoT hubs only need four partitions.

  5. Haga clic en Review + create (Revisar y crear) para revisar sus selecciones.Click Review + create to review your choices. Verá algo parecido a esta pantalla.You see something similar to this screen.

    Captura de pantalla de revisión de la información para crear el centro de IoT

  6. Haga clic en Create (Crear) para crear el centro de IoT.Click Create to create your new IoT hub. Esta operación tarda unos minutos.Creating the hub takes a few minutes.

Recuperación de la cadena de conexión del centro de IoTRetrieve connection string for IoT hub

Una vez creado el centro, puede recuperar la cadena de conexión del centro.After your hub has been created, retrieve the connection string for the hub. Se utiliza para conectar dispositivos y aplicaciones al centro.This is used to connect devices and applications to your hub.

  1. Haga clic en el centro para ver el panel de IoT Hub con la configuración y otros elementos.Click on your hub to see the IoT Hub pane with Settings, and so on. Haga clic en Directivas de acceso compartido.Click Shared access policies.

  2. En Directivas de acceso compartido, seleccione la directiva iothubowner.In Shared access policies, select the iothubowner policy.

  3. En Claves de acceso compartido, copie Cadena de conexión: clave principal para su uso posterior.Under Shared access keys, copy the Connection string -- primary key to be used later.

    Recuperación de la cadena de conexión

    Para más información, consulte Control de acceso en la "Guía del desarrollador de Azure IoT Hub".For more information, see Access control in the "IoT Hub developer guide."

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 IoT Hub a menos que tenga una entrada en el registro de identidades.A device cannot connect to IoT hub unless it has an entry in the identity registry. Para más información, consulte la sección "Registro de identidades" de la Guía para desarrolladores de IoT HubFor more information, see the "Identity registry" section of the IoT Hub developer guide

  1. En el menú de navegación del centro de IoT, abra Dispositivos IoT y, a continuación, haga clic en Agregar para registrar un dispositivo en el centro de IoT.In your IoT hub navigation menu, open IoT Devices, then click Add to register a new device in your IoT hub.

    Creación de la identidad del dispositivo en el portal

  2. Proporcione un nombre para el dispositivo nuevo, como myDeviceId, y haga clic en Guardar.Provide a name for your new device, such as myDeviceId, and click Save. Esta acción crea una nueva identidad de dispositivo para su instancia de IoT Hub.This action creates a new 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 el valor de Cadena de conexión: clave principal para usarlo más adelante.Copy the Connection string---primary key 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 al centro de IoT.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. Reemplazo de la cadena de conexión de dispositivoReplace the device connection string

  2. Haga clic en Ejecutar o escriba npm start para ejecutar la aplicación.Click 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

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: