Consola SenseCAP con Node-RED Guía Rápida
SenseCAP K1100 - El Kit Prototipo de Sensores representa a Seeed Studio concentrando la esencia de la comunicación LoRa® en productos de tecnología e inteligencia de borde, para facilitar al máximo el despliegue y dominio de aplicaciones LoRa® e IoT.
Actualizable a Sensores Industriales
Con el controlador SenseCAP S2110 y el registrador de datos S2100, puedes convertir fácilmente el Grove en un sensor LoRaWAN®. Seeed no solo te ayuda con el prototipado, sino que también te ofrece la posibilidad de expandir tu proyecto con la serie SenseCAP de robustos sensores industriales.
La carcasa IP66, configuración por Bluetooth, compatibilidad con la red global LoRaWAN®, batería integrada de 19 Ah y el potente soporte desde la APP hacen del SenseCAP S210x la mejor opción para aplicaciones industriales. La serie incluye sensores para humedad del suelo, temperatura y humedad del aire, intensidad luminosa, CO2, CE y una estación meteorológica 8 en 1. Prueba el último SenseCAP S210x para tu próximo proyecto industrial exitoso.
Node-RED es una herramienta de programación para conectar dispositivos de hardware, APIs y servicios en línea de formas nuevas e interesantes.
Proporciona un editor basado en navegador que facilita el armado de flujos usando la amplia gama de nodos en la paleta, que pueden desplegarse en su entorno de ejecución con un solo clic.
Para facilitar a nuestros usuarios la conexión de datos desde la plataforma SenseCAP a diversas otras plataformas PaaS para un procesamiento de datos más profundo, haremos una serie de tutoriales para SenseCAP & Node-RED.
Este tutorial, el primero de la serie, te guiará en la instalación y uso de Node-RED y cómo llamar a la API backend de SenseCAP para conectar con Node-RED.
Instalar Node.js®
Para instalar Node-RED localmente necesitarás una versión soportada de Node.js.
Descarga la última versión LTS 14.x de Node.js desde la página oficial Node.js. Esta te ofrecerá la mejor versión para tu sistema.
Ejecuta el archivo MSI descargado. Instalar Node.js requiere derechos de administrador local; si no eres administrador local, te pedirá la contraseña de administrador al instalar. Acepta los valores por defecto durante la instalación. Al finalizar, cierra cualquier terminal abierta y ábrela de nuevo para que se actualicen las variables de entorno.
Si usas una computadora que no tiene ningún entorno de programación instalado, recomendamos marcar la casilla para instalar las herramientas necesarias durante la instalación de Node.js, esto te ahorrará muchos problemas posteriores.
La forma más sencilla de instalar Node-RED es usando la herramienta de gestión de paquetes de Node, npm. Sin embargo, no recomendamos instalar Node-RED con npm 1.x, sino actualizar a la última versión npm 2.x.
En Windows (requiere Windows 10 o superior), usa el atajo Win+R, escribe cmd en la ventana emergente para abrir la terminal y ejecuta el siguiente comando.
Si usas MacOS o Linux, ejecuta el siguiente comando en la terminal y añade sudo al inicio si no eres usuario root.
npm install -g [email protected]
Una vez instalado, abre una ventana de comandos y ejecuta el siguiente comando para asegurarte de que Node.js y npm están instalados correctamente.
node --version && npm --version
Deberías recibir una salida similar a:
> v16.17.0
> 2.15.12
Instalar Node-RED
Instalar Node-RED como módulo global añade el comando node-red a la ruta de tu sistema. Ejecuta lo siguiente en la ventana de comandos:
npm install -g --unsafe-perm node-red
Si Node-RED está instalado como paquete npm global, ejecuta directamente el comando node-red:
node-red
Esto mostrará el registro (log) de Node-RED en la terminal. Debes mantener la terminal abierta para que Node-RED siga funcionando.
Esto te permitirá ver el editor de Node-RED en http://localhost:1880.
Obtener la API de SenseCAP
Antes de continuar con esta sección, asegúrate de haber vinculado tu dispositivo K1100 en la consola SenseCAP.
Inicia sesión en la consola SenseCAP. En la barra desplegable a la derecha del nombre de usuario en la parte superior del tablero, encontrarás la Información de la Organización, por favor selecciónala.
En la página de Información de la Organización, puedes ver el ID de la Organización, que puedes anotar primero y lo usaremos en los pasos posteriores.
Luego, también necesitamos obtener la clave API para SenseCAP. Por favor, haz clic en Seguridad -> Claves de acceso API en el lado izquierdo del tablero. Luego crea una Clave de Acceso.
Haz clic en el ID de API que creaste y obtendrás sus Claves de acceso API, por favor anótalas por ahora, las usaremos en los pasos posteriores.
Crear un Nodo HTTP
La ventana del editor consta de cuatro componentes:
- El encabezado en la parte superior, que contiene el botón de desplegar, el menú principal y, si la autenticación de usuario está habilitada, el menú de usuario.
- La paleta a la izquierda, que contiene los nodos disponibles para usar.
- El espacio de trabajo principal en el centro, donde se crean los flujos.
- La barra lateral a la derecha.
Sigue los enlaces anteriores para aprender más sobre cada componente.
En este ejemplo, te mostraremos cómo usar nodos MQTT para mostrar los valores del sensor recibidos por SenseCAP. Antes de eso, aprendamos a entender los nodos que usaremos más en el futuro.
Nodo http
Nodo http in
El nodo http in se puede usar para crear servicios web.
Arrastra el nodo al espacio de trabajo y haz doble clic en él para acceder a la página de configuración del nodo.
Aquí, necesitamos establecer una URL para el servicio web que has creado, de modo que puedas acceder a la página web creada a través de la dirección http://localhost:1880/<URL>.
Nodo http response
El nodo http response envía la respuesta de vuelta a la solicitud recibida desde el nodo de entrada HTTP.
Generalmente, no es necesario configurarlo por separado, simplemente arrástralo directamente al espacio de trabajo para usarlo.
Nodo template
El nodo template puede establecer propiedades basadas en la plantilla proporcionada.
Usaremos este nodo y un lenguaje HTML sencillo para completar la configuración del contenido que se mostrará en nuestra página web.
Por ejemplo, queremos mostrar "¡Hola Mundo!".
<h1>Hello World!</h1>
Finalmente, conectamos el http in al template, y conectamos el template al http response. Luego haz clic en el botón deploy en la esquina superior derecha, para que se cree una página web sencilla, que es el paso básico de operación de Node-RED.
En este ejemplo, creamos una URL para datos del sensor, así que después del despliegue, podemos ingresar http://localhost:1880/sensor_data en la barra de direcciones del navegador para acceder a la página que acabamos de crear.
Crear un nodo MQTT
En esta sección, describiremos cómo obtener la información de datos de SenseCAP a través del nodo MQTT.
Nodo debug
Muestra las propiedades seleccionadas del mensaje en la pestaña lateral de depuración y, opcionalmente, en el registro de ejecución. Por defecto muestra msg.payload, pero puede configurarse para mostrar cualquier propiedad, el mensaje completo o el resultado de una expresión JSONata.
Nodo mqtt
Se conecta a un broker MQTT y se suscribe a mensajes del tema especificado.
Paso 1. Agrega un nuevo nodo mqtt-broker.
Arrastra un nodo mqtt in, haz doble clic para entrar en la página de configuración, luego haz clic en el botón de editar junto a Add new mqtt-broker.
La configuración del mqtt-broker debe llenarse de la siguiente manera:
- Servidor: openstream.api.sensecap.seeed.cc
- Puerto: 1883
- Protocolo: MQTT V3.1.1
- Client ID: El formato es
org-<Organization ID>-<Random ID><Organization ID>Tu ID de organización. Lo obtuvimos en Obtener la API de SenseCAP.<Random ID>Usa un número o letra minúscula generado aleatoriamente por ti.
Luego llenamos el campo de opciones Security con Usuario y Contraseña.
- Usuario: El formato es
org-<Organization ID><Organization ID>Tu ID de organización. Lo obtuvimos en Obtener la API de SenseCAP.
- Contraseña: Llena con la Access API keys que obtuvimos en Obtener la API de SenseCAP.
Finalmente, haz clic en el botón Add en la esquina superior derecha para regresar a la página de configuración del nodo mqtt in.
- Topic: Configurar un tópico con un formato específico determina el tipo de dispositivo y tipo de dato que se va a recibir.
Formato del tópico: /device_sensor_data/<OrgID>/<DeviceEUI>/<Channel>/<Reserved>/<MeasurementID>
| OrgID | ID de tu organización. Lo hemos obtenido en la Obtención de la API de SenseCAP. |
| DevEUI | Identificación única de los dispositivos sensores. Esta información se encuentra en la etiqueta en la parte trasera del Grove - Wio E5, así como en el dispositivo de la consola SenseCAP. |
| Channel | Interfaz física en el dispositivo a la que está conectado el sensor. Para el kit K1100, el valor predeterminado aquí es 1. |
| Reserved | Campos reservados. |
| MeasurementID | ID del valor medido. Este ID se puede encontrar en la sección de IDs de medición de la documentación de SenseCAP |
El contenido de este tutorial solo aplica para el kit K1100, por lo que por favor consulta el contenido dentro del LoraWAN Dev Kit para el ID del valor medido y no utilices otros IDs.
Por ejemplo, si quiero obtener datos del sensor para los valores de luz enviados por Wio Terminal, entonces la información del Topic que debo llenar es:
/device_sensor_data/424324324324324/2CF7F1C043200002/1/+/4193
El campo <OrgID> es obligatorio, "+" significa que este campo no tiene filtro y puede coincidir con todos. Así que, "/ + / + / + / +" significa escuchar todos los <DeviceEUI>, <Channel>, <Reserved>, <MeasurementID>.
Si quieres escuchar todos los mensajes, entonces el Topic debe ser:
/device_sensor_data/424324324324324/+/+/+/+
Paso 2. Añadir nodo de depuración
Luego podemos agregar nodos de depuración para facilitar la comprobación de que todo está funcionando.
Paso 3. Encender el Wio Terminal y comenzar a enviar datos a SenseCAP.
Hacemos clic en el botón Deploy y si todo está configurado correctamente podrás ver el nodo mqtt in mostrando que está conectado. Una vez que el Wio Terminal se encienda y comience a funcionar y a enviar datos a SenseCAP, verás los datos ya desplegados en la ventana de depuración.
Soporte Técnico y Discusión de Producto
¡Gracias por elegir nuestros productos! Estamos aquí para brindarte diferentes tipos de soporte para asegurar que tu experiencia con nuestros productos sea lo más fluida posible. Ofrecemos varios canales de comunicación para adaptarnos a distintas preferencias y necesidades.