Blues Wireless App Accelerators son potentes componentes de software preconstruidos diseñados para agilizar el desarrollo de IoT. Al aprovechar estos aceleradores, los desarrolladores pueden prototipar y desplegar aplicaciones rápidamente, reduciendo el tiempo de lanzamiento al mercado.
Blues Wireless App Accelerators simplifican la comunicación de dispositivo a nube, permitiendo una integración fluida con plataformas de IoT como Ubidots. Cuando se combinan con el entorno fácil de usar de Ubidots para la visualización y gestión de datos, los desarrolladores pueden crear rápidamente soluciones de IoT de extremo a extremo, desde la conectividad del dispositivo hasta información procesable, con un esfuerzo mínimo y complejidad reducida.
Esta guía trata sobre el Acelerador de Aplicaciones de Blues Wireless 18-temperature-and-humidity-monitor. Consulta el enlace del repositorio para obtener más información sobre este proyecto.
Requisitos
Adaptador de CA a USB (fuente de alimentación)
Cable USB-A a micro USB
Visual Studio Code con la extensión PlatformIO
Una cuenta activa de Ubidots
Tabla de contenido
1. Configurar el hardware
Ensamble la Notecard al Notecarrier-F quitando el tornillo del receptáculo de montaje en el Notecarrier-F. Coloque la Notecard en la ranura M.2 del Notecarrier. Una vez insertada, presione suavemente hasta que la Notecard esté completamente insertada. Vuelva a insertar el tornillo, asegurándose de no apretarlo demasiado.
Asegure ambos cables de la antena a su correspondiente conector.
Conecte la Notecard a su PC a través de un cable USB-A a micro USB. El puerto USB en la Notecard está etiquetado como NOTECARD USB.
Vaya a dev.blues.io.
Haga clic en el botón USB, luego en USB Notecard, y luego seleccione el puerto al que está conectado su Notecarrier.
Si está en un Mac, seleccione
Notecard (cu.usbmodemNOTE1)oNotecard (tty.usbmodemNOTE1).En Windows, la opción aparecerá como
USB Serial Device (COMx).En Linux, la opción aparecerá como
Notecard (ttyACM0).
Valide la comunicación serial emitiendo la siguiente solicitud en la terminal del navegador:
{"req" : "card.version"} Debería verse algo así:
Conecte el Swan al Notecarrier, alineando los pines macho del Swan con los pines hembra del Notecarrier.
Conecte un extremo del cable Qwiic a uno de los puertos Qwiic del Notecarrier y el otro extremo a uno de los puertos Qwiic en la placa de expansión BME280.
Al final, toda la configuración debería verse así:
2. Crear un proyecto en Notehub y vincularlo a la Notecard
Navegue hasta el Tablero de Proyectos de Notehub.
Haga clic en "Crear Proyecto" en la esquina superior derecha del tablero. En la tarjeta de Nuevo Proyecto, dé un nombre a su proyecto y ProductUID. Una vez hecho, haga clic en el botón Crear Proyecto.
Consejo Profesional de Blues: El ProductUID debe ser globalmente único. Para reducir colisiones, Notehub antepone un espacio de nombres generado basado en el correo electrónico de su cuenta, por ejemplo com.your-company.your-name:. Ingrese cualquier identificador que desee en el campo a la derecha.
Tome nota de su ProductUID. Este identificador es utilizado por Notehub para asociar su Notecard con su proyecto.
Asocie la Notecard a este proyecto particular emitiendo la siguiente solicitud en la terminal del navegador. Su salida debería ser un objeto JSON vacío.
{"req":"hub.set", "product":"com.your-company.your-name:your_product"}Verifique la validez de la configuración de la Notecard realizando una sincronización manual con Notehub y enviando solicitudes de estado de sincronización a la Notecard. Para hacerlo, haga la siguiente solicitud en la terminal del navegador. Si todo ha sido configurado correctamente, esto debería devolver un objeto JSON vacío.
{"req":"hub.sync"}3. Configuración del firmware
Dirígete al repositorio de Blues Wireless App Accelerators y clónalo.
Navegue hasta la carpeta "18-temperature-and-humidity-monitor"
Lanza VSCode.
Haga clic en el icono de PlatformIO en el lado izquierdo y abra la carpeta
firmware/arduinode este proyecto. Acceso Rápido > PIO Home > Abrir > Abrir Proyecto.Abra el archivo
src/main.cpp. Descomente la siguiente línea y reemplacecom.your-company:your-product-namecon su ProductUID de Configuración de Notehub.
#define PRODUCT_UID "com.your-company:your-product-name"
Haga clic en el icono de PlatformIO en el lado izquierdo nuevamente y haga clic en "Construir" bajo Tareas del Proyecto → bw_swan_r5 → General. Debería ver "ÉXITO" en el panel de salida de la terminal.
Presione y mantenga presionado el botón etiquetado como "BOOT" en el Swan, y, mientras mantiene presionado BOOT, presione y suelte el botón etiquetado como "RST", y finalmente suelte el botón BOOT. El Swan ahora está listo para ser programado.
Haga clic en "Subir" bajo Tareas del Proyecto → bw_swan_r5 → General. Debería ver "ÉXITO" en el panel de salida de la terminal.
En este punto, el firmware del Swan debería estar en funcionamiento y debería comenzar a ver eventos aparecer en Notehub bajo la vista de "Eventos" de su proyecto.
4. Crear la Ruta a Ubidots
En el menú del lado izquierdo, haga clic en el menú Rutas y luego en Crear Ruta.
Dé a esta ruta un nombre.
En el campo URL* establezca el siguiente valor.
https://industrial.api.ubidots.com/api/v1.6/devices/[device]
La parte [devices] en la URL es un marcador de posición que captura el identificador de los dispositivos en Notehub, que tiene este formato: dev:xxxxxxxxx. Donde "xxxxxx" es un identificador único en Notehub. Teniendo eso en cuenta, esta ruta enviará los datos del evento a un Dispositivo en Ubidots cuyo Etiqueta del Dispositivo sea algo como dev:xxxxxxxxx.
Agregue el token de autenticación como se muestra a continuación y establezca su valor en el Token de cuenta de Ubidots que desea usar para esta aplicación.
Desplácese hacia abajo hasta la sección Datos en la misma página y seleccione Expresión JSONata del menú desplegable en la opción Transformar Datos.
Pegue la siguiente Expresión JSONata en el campo de texto:
{ "temperature": $.body.temperature.value ? {"value": $.body.temperature.value, "status": $.body.temperature.status, "timestamp" : $.when} : {"value" : $.body.temperature, "timestamp" : $.when}, "humidity": $.body.humidity.value ? {"value": $.body.humidity.value, "status": $.body.humidity.status, "timestamp" : $.when} : {"value" : $.body.humidity, "timestamp" : $.when} }
Desplácese hacia arriba hasta la parte superior de la página y haga clic en el botón Aplicar Cambios.
Una vez hecho esto, debería ver un nuevo dispositivo creado en su sección de Dispositivos:
5. Comentarios, sugerencias y artículos relacionados
No dude en publicar preguntas o sugerencias en nuestro portal comunitario, o contáctenos a través de support@ubidots.com.
Otros usuarios también encontraron útil...