Para todos los emprendedores y desarrolladores de IoT que buscan un camino rápido para construir y desplegar productos conectados por celular, el Notecard es una gran opción.
Este producto funciona con cualquier dispositivo, desde microcontroladores de 8 bits hasta los últimos microprocesadores y computadoras de placa única.
Sigue esta guía para conectar tu Notecard y visualizar y crear fácilmente tu propia aplicación con Ubidots.
Requisitos
Proyecto Notehub con al menos un Notecard enviando lecturas de sensores a intervalos regulares.
Este tutorial asume que ya has completado el Tutorial de Sensores para capturar datos de sensores, y guardarlos en un Notefile llamado sensors.qo
y enviar esos datos a través del Notecard a Notehub; o, que ya has creado tu propia aplicación con datos de sensores y estás listo para conectar tu aplicación a Ubidots.
1. Crear un Router de Ubidots
Una Ruta es una API externa, o ubicación del Servidor, donde las Notas serán reenviadas para un Dispositivo o Flota al recibirlas. Las Rutas se definen en Notehub para un Proyecto y pueden dirigirse a una sola Flota o a todos los dispositivos en un Proyecto. Un Proyecto puede tener múltiples rutas definidas y activas al mismo tiempo. Antes de crear una Ruta, asegúrate de que los datos que deseas enrutar estén disponibles en Notehub, navegando a la vista de Eventos.
Paso 1: Para enviar datos a tu Ubidots desde Notehub, necesitarás tu token de cuenta de Ubidots. Ve a tu cuenta de Ubidots y haz clic en tu perfil, elige la opción Credenciales de API, y copia tu token predeterminado para los siguientes pasos.
Paso 2: De vuelta en Notehub, abre el panel de control de Rutas y haz clic en el botón Agregar Ruta.
Paso 3: Dale un nombre a la Ruta, mantén el Tipo de Ruta predeterminado (Solicitud/Respuesta HTTP/HTTPS General), y elige agregar Encabezados Adicionales. Agrega un nombre de encabezado de X-Auth-Token
con un valor del token predeterminado que copiaste anteriormente.
Paso 4: Para la URL de Ruta, ingresa https://industrial.api.ubidots.com/api/v1.6/devices/[device]
, esta parte de la URL: [device]
te permite identificar el DeviceUID de NoteHUB y crear un nuevo dispositivo en Ubidots nombrado con el mismo DeviceUID.
Notehub proporciona mucha información en cada solicitud de Ruta. Puede que desees reducir lo que envías a Ubidots o transformar la carga útil para adherirse a un formato esperado por la API de Ubidots. De cualquier manera, Notehub admite dar forma a los datos enviados a una Ruta utilizando datos JSON.
Paso 5: En el menú desplegable de Notefiles, elige "Seleccionar Notefiles" e ingresa el nombre del notefile a monitorear. Luego, en la opción Transformar JSON, selecciona Expresión JSONata
e ingresa la siguiente expresión.
{"temperature":{"value": body.temp , "timestamp": when * 1000}}
Paso 6: Haz clic en Guardar y navega de vuelta a tu panel de control de Ubidots. Si todo está conectado correctamente, la visualización de datos predeterminada se actualizará con las lecturas de temperatura y humedad enviadas desde Notehub.
2. Visualización de datos / Creación de Dashboard
Ahora es el momento de construir tu propio panel de control para comenzar a monitorear los datos de tus dispositivos.
Ve a la sección Dashboard (Datos -> Dashboard) de tu cuenta de Ubidots.
Selecciona el ícono más (+) ubicado en la parte superior derecha de la página, luego selecciona los tipos de widget que deseas mostrar en tu Dashboard de Ubidots.
Puedes personalizar tus Dashboards y aplicaciones en solo unos clics, consulta las siguientes guías para aprender cómo: