ESTE ARTÍCULO FUE DEPRIMIDO EL 5 DE ENERO DE 2023.

POR FAVOR, CONSULTE LA NUEVA VERSIÓN "Conectando Azure IoT Hub con Ubidots. Parte I: Enviando datos desde IoT Hub a Ubidots"

Ubidots tiene muchas características preconstruidas diseñadas para llevarte más rápido al mercado, incluyendo una interfaz de usuario que está lista para ser presentada a tus clientes finales. Si los requisitos de tu proyecto exigen una capa adicional de backend, entonces Microsoft Azure IoT ofrece herramientas adicionales para impulsar tu proyecto, incluyendo:

Antes de comenzar con Azure, te recomendamos que consultes la "Introducción del desarrollador a Azure IoT." Consulta esta referencia para la documentación de Azure.

En este artículo, mostraremos cómo se puede construir una solución IoT trabajando con la integración de recursos de Azure y Ubidots. Simularemos un dispositivo usando node.js como ejemplo. Recomendamos seguir todo este tutorial utilizando esta simulación y luego aplicar el conocimiento adquirido para conectar tu propio dispositivo a Azure.

La plataforma Azure es un servicio de computación en la nube creado por Microsoft para construir, probar, implementar y gestionar aplicaciones y servicios a través de una red global de centros de datos gestionados por Microsoft. Similar a muchos de los entornos de desarrollo que ya existen, Azure comienza con un panel de control que se adapta a tu trabajo y estilo, manteniéndote al tanto de las cosas que más importan al fijarlas en el panel de control.

Para comenzar la integración, tenemos que crear un "Grupo de recursos"; el grupo de recursos proporciona una forma de monitorear, controlar el acceso, aprovisionar y gestionar la facturación para colecciones de activos que son necesarios para ejecutar una aplicación.

1.- Selecciona el ícono que se muestra en la imagen a continuación para crear el grupo de recursos:

2.- Presiona "agregar" para abrir el generador de grupos de recursos. A continuación, debes asignar un nombre al grupo de recursos, seleccionar la suscripción y la ubicación. Por favor, asigna "ubidots" como nombre; si deseas visualizar tus grupos de recursos en tu panel de control, selecciona "Fijar en el panel de control":

3.- Una vez que hayas creado el grupo de recursos, necesitas completar el proceso en la página siguiente haciendo clic en "Crear recursos". Para una mirada más profunda a los recursos, consulta este enlace a los recursos de Microsoft.
​

El primer recurso que tenemos que agregar es el IoT Hub; el Azure IoT Hub es un servicio completamente gestionado que ayuda a habilitar comunicaciones bidireccionales confiables y seguras con dispositivos IoT.

1.- Busca "IoT Hub" dentro de la barra de búsqueda, luego selecciona la opción IoT Hub para abrir las opciones de creación.

En la siguiente ventana selecciona "Crear" para crear el IoT Hub:

2.- Una vez que se haya creado y abierto el generador de IoT Hub, asigna un nombre y establece los precios, unidades, grupo de recursos y ubicación de tu IoT Hub. Asegúrate de que el grupo de recursos seleccionado sea el que acabas de crear.

Consejo Profesional: consulta el siguiente enlace para la terminología específica de la configuración de Azure IoT Hub.

4.- Una vez que se haya creado el IoT Hub, copia el nombre de host y guárdalo en un bloc de notas separado para más tarde. El nombre de host crea una cadena de conexión que se comunica con tu IoT Hub. Consulta a continuación dónde identificar el nombre de host en tu Hub.

5.- A continuación, en el panel izquierdo de tu hub, encontrarás las categorías y propiedades de tu aplicación.

1.- Abre tu IoT Hub y haz clic en "Explorador de Dispositivos" en el panel izquierdo.

Dentro de la ventana del Explorador de Dispositivos, haz clic en "Agregar" para agregar un dispositivo a tu IoT Hub; el Explorador de Dispositivos se ejecuta en tu máquina local y se conecta a tu IoT Hub en Azure. Se comunica con estos endpoints de IoT Hub.
​

2.- Después de seleccionar "+Agregar" (mostrado arriba), asigna los parámetros a continuación:

Consejo Profesional: Recomendamos usar la misma nomenclatura que este tutorial hasta que te sientas más cómodo asignando identificadores personalizados a tu IoT Hub. Una vez que te sientas más cómodo, siéntete libre de ajustar tu aplicación según sea necesario.

Una vez que hayas agregado todos los parámetros, presiona "Salvar."

3.- Después de que se haya creado el dispositivo, abre el Explorador de Dispositivos, selecciona el dispositivo en la parte inferior izquierda y copia la "Cadena de conexión - clave primaria" a tu bloc de notas separado. Al igual que con los identificadores anteriores, esta información será valiosa más adelante.

Ahora que has terminado la configuración de gestión de dispositivos en el portal de Azure de Microsoft, ahora puedes configurar un dispositivo real o simulado para verificar la comunicación D2C (dispositivo a nube).

1.- Para configurar tu dispositivo, instala los SDK de dispositivos de Azure IoT necesarios para tu dispositivo IoT elegido, ve a la documentación de Microsoft para descargar los SDK apropiados.

NOTA: Si no tienes un dispositivo IoT, no te preocupes, ya que este tutorial te guiará a través de una simulación de dispositivo usando node.js. Si deseas usar un dispositivo simulado, sigue los pasos en el enlace proporcionado a continuación y regresa a este tutorial una vez completado.

Ahora que has habilitado la aplicación de dispositivo simulado para enviar mensajes de dispositivo a nube con tu IoT Hub, ahora puedes escalar tu solución IoT.
​

El segundo recurso que tenemos que agregar es el Service Bus. Cuando dos o más partes quieren intercambiar información, necesitan un facilitador de comunicación. Service Bus es un mecanismo de comunicación intermediado o de terceros. Siguiendo la documentación de Microsoft, el Service Bus es un servicio en la nube multi-inquilino. Cada usuario, como un desarrollador de aplicaciones, crea un espacio de nombres, luego define los mecanismos de comunicación necesarios dentro de ese espacio de nombres.

1.- Agrega un nuevo recurso en tu grupo de recursos previamente creado llamado "ubidots." Esto te llevará a una ubicación de búsqueda donde buscarás el recurso "Service Bus."

2.- Busca "Service Bus" dentro de la barra de búsqueda, luego selecciona la opción Service Bus para abrir el aviso de parámetros en el siguiente paso.

3.- Una vez que se abra el generador de Service Bus, asigna un nombre y establece los precios, suscripción, grupo de recursos y ubicación de tu IoT Hub. Asegúrate de que el grupo de recursos seleccionado sea el que se creó previamente.

Una vez que hayas asignado la información requerida, "Crea" tu Espacio de Nombres.

4.- A continuación, dentro del Service Bus presiona "+ Cola" para establecer la comunicación de datos entre el IoT Hub y una "Aplicación Lógica" que se agregará más adelante en este tutorial.

Asigna un nombre para la cola y luego haz clic en "crear" usando los parámetros apropiados de tu cola.

5.- Desde la pestaña de Recursos, abre la cola del bus de servicio y luego haz clic en Políticas de acceso compartido > + Agregar.

6.- A continuación, ingresa un nombre para la política, marca Gestionar, y luego haz clic en "Crear".

La opción de endpoints y rutas contiene muchas características, pero con este tutorial la utilizaremos para integrarnos con otros servicios, como la aplicación lógica. Cuando IoT Hub recibe un mensaje, primero verifica si hay una ruta personalizada (endpoint con una regla de enrutamiento) disponible que coincida con una regla dada. Si hay una coincidencia, enviará el mensaje a ese endpoint y no al Event Hub predeterminado.

1.- Abre tu IoT Hub, haz clic en Endpoint, luego presiona "+ Agregar"

2.- En el generador de endpoints asigna los parámetros a continuación:

Para finalizar, haz clic en "OK":

3.- Ahora vamos a agregar una regla de enrutamiento. En tu IoT Hub, haz clic en Rutas, luego presiona "+ Agregar".

4.- En el generador de rutas, asigna los parámetros a continuación:

Para finalizar, haz clic en "Guardar"

El tercer recurso que tenemos que crear es la Aplicación Lógica; las aplicaciones lógicas proporcionan una forma de simplificar integraciones y flujos de trabajo en la nube.

1.- Agrega un nuevo recurso en tu grupo de recursos previamente creado llamado "ubidots"

2.- Busca "Aplicación Lógica" dentro de la barra de búsqueda, luego selecciona la opción Aplicación Lógica para abrir y crear la opción.

3.- Una vez que se abra el generador de Aplicaciones Lógicas, debes asignar un nombre y establecer los precios, suscripción, grupo de recursos y ubicación. Asegúrate de que el grupo de recursos seleccionado sea el que se creó previamente y que la ubicación sea la misma que la del IoT Hub.

Para finalizar, simplemente haz clic en "crear".

4.- Desde la pestaña de Recursos, selecciona la aplicación lógica para abrir el Diseñador de Aplicaciones Lógicas.

En el Diseñador de Aplicaciones Lógicas, desplázate hacia abajo y haz clic en Aplicación Lógica en Blanco:

5.- Busca y selecciona "Service Bus":

Luego, actívalo con el desencadenador específico titulado: "Service Bus - Cuando uno o más mensajes llegan a una cola (completar automáticamente)"

6.- A continuación, ingresa un nombre de conexión y selecciona el servicio de bus creado previamente:

Luego "Crea" tu acción.

Una vez que hayas creado la conexión del bus de servicio, selecciona la cola que se creó recientemente e ingresa 175 para el conteo máximo de mensajes. Optamos por 175 para este tutorial, pero si se necesita un conteo de mensajes mayor o menor en tu aplicación, ajústalo adecuadamente.

Luego, haz clic en el botón "Guardar" para guardar estos cambios.

1.- Crea una solicitud HTTP para enviar datos a Ubidots. Trabajando desde el Diseñador de Aplicaciones Lógicas del paso anterior, crea toda la solicitud HTTP seleccionando "+ Nuevo Paso".

En el clic Nuevo paso > Agregar una acción, busca "HTTP" dentro de la barra de búsqueda como puedes ver a continuación, luego selecciona la opción HTTP:

Selecciona la primera opción "HTTP - HTTP":

Ahora debes asignar los parámetros necesarios para hacer la solicitud HTTP a Ubidots.

NOTA: Si no sabes cómo obtener tu TOKEN de Ubidots, consulta este artículo Cómo obtener tu TOKEN de Ubidots. Para más documentación sobre la referencia de la API de Ubidots haz clic aquí.

Una vez que tus parámetros estén ingresados y sean precisos, "Guarda" y "Ejecuta" tu Aplicación Lógica.

Como se mencionó anteriormente, decidimos usar un dispositivo simulado usando node.js. Recomendamos comenzar con la guía a continuación y el código a continuación que sirve como práctica antes de la configuración de tu dispositivo real:

1.- Una vez que hayas terminado la configuración de simulación del dispositivo anterior y seas capaz de manejar datos con tu IoT Hub, modifica el código llamado "SimulatedDevice.js" con el código a continuación. Recuerda asignar la cadena de conexión del dispositivo guardada de tu bloc de notas en el código a continuación.

Nota: Si estás trabajando con un dispositivo en vivo, por favor utiliza los SDK de tu dispositivo elegido con este enlace.

Una vez que hayas modificado el código con el nuevo, ejecuta tu nuevo código en la terminal de tu computadora usando el siguiente comando: node SimulatedDevice.js .Deberías ver la respuesta a continuación en tu terminal, si es exitoso.

Ahora estás enviando valores de temperatura y humedad a Azure, por favor ve a la Aplicación lógica para visualizar los mensajes recibidos y el estado de la solicitud HTTP a Ubidots.

2.- En la vista general de la aplicación lógica podrás monitorear y verificar el historial de ejecución y desencadenadores de tu aplicación lógica. Para aprender más sobre el estado de tu aplicación lógica o el historial de ejecución y desencadenadores, consulta solucionar problemas de tu aplicación lógica.

Al seleccionar un mensaje de tu historial de ejecución, puedes verificar la ENTRADA y la SALIDA de la solicitud HTTP a Ubidots:

Como puedes ver arriba, el código de estado de la salida es 200 lo que significa Ok – Solicitud exitosa.

3.- Para visualizar los datos recibidos en Ubidots, ve a tu cuenta de Ubidots y selecciona la sección de dispositivos. Aquí verás un nuevo dispositivo llamado "azure".

Esta guía nos introduce al mundo de Azure IoT que proporciona muchos recursos y características para tus soluciones de Internet de las Cosas.

En este tutorial aprendimos cómo enviar datos desde Azure a Ubidots. Para lograr una comunicación bidireccional, por favor consulta nuestro próximo artículo para ver cómo enviar datos desde Ubidots a Azure IoT, donde también aprenderás cómo almacenar los datos recibidos de Ubidots en un almacenamiento de datos SQL en el camino.

Feliz Hacking :)