¿Cómo integrar un Arduino con Onesait Platform (Un ejemplo de Arduino para POST y GET de datos desde una API)
Introducción
Arduino sigue siendo una plataforma electrónica relevante de código abierto basada en hardware y software fácil de usar. Con la intención de ser el primer paso para cualquier persona interesada en construir proyectos interactivos con dispositivos de hardware, Arduino proporciona herramientas tanto de hardware como de software para hacerlo posible.
Cómo conectar el Arduino con Platforma
Esta guía te mostrará un rápido ejemplo de cómo conectar tu Placa Arduino a la Plataforma. El ejemplo asume que tienes una placa Arduino con conexión WiFi operativa. Nuestra configuración inicial incluía una placa LOLIN32 (basada en ESP32) de WEMOS.
El ejemplo tiene una ontología asociada registrada en nuestra instancia pública de CloudLab, ArduinoFrame. Esta es una Ontología simple con dos campos String, device (para diferenciar dispositivos) y value (un valor generado aleatoriamente que será reemplazado con la salida de tu sensor).
Para permitir un fácil acceso a la Ontología, se define una interfaz API mediante el módulo de gestión API Manager. Este API se adjunta a la ontología y se definen dos operaciones:
Una operación POST, que permite a los clientes insertar remotamente los datos de ArduinoFrame.
Una operación GET personalizada, con una consulta embebida que devuelve las últimas cinco medidas insertadas en la Ontología.
Puedes comprobarlo tú mismo, ya que es una API pública, en este enlace.
Tanto la ontología como la API permiten que cualquier dispositivo autorizado se conecte a la plataforma. Por tanto, es hora de desarrollar el cliente de Arduino.
Desarrollo ejemplo
En el lado Arduino, se utilizan tres librerías:
Después de configurar las credenciales de WiFi durante la fase de configuración, verás un mensaje de "WiFi conectado".
Entonces podrás contactar con la antigua API. En este ejemplo, la placa primero realiza una operación POST, después recupera los últimos datos llamando a la operación GET personalizada:
Analizando el código, puedes ver que ambas operaciones siguen patrones parecidos. En primer lugar, se debe proporcionar la URL de la API a la librería, Después, se necesitan dos cabeceras para procesar las peticiones HTTP (Content-Type y X-OP-APIKEY), con el token de usuario de la plataforma. Este token está disponible para su usuario en este enlace.
Ahora sólo tienes que subir el código a tu placa y habilitar la salida serial para seguir el progreso del ejemplo:
Para verificarlo, también puedes consultar los valores de la ontología en la Herramienta de Consulta de Repositorios de la Plataforma.:
¡Y COINCIDEN! Inténtalo tú mismo y mándanos cualquier pregunta que tengas a support@onesaitplatform.com