Crear un medidor IoT web con Arduino, Yaler e IFTTT

Componentes y suministros

	Arduino Yun	×	1
	Servo (Tower Pro MG996R)	×	1
	Tuercas y tornillos M3	×	3
	Madera contrachapada de 4 mm	×	1

Herramientas y máquinas necesarias

Cortadora láser

Pistola de silicona caliente

Teléfono Android o iOS

Aplicaciones y servicios en línea

Servicio IFTTT Maker

Acerca de este proyecto

(Fuente: Instructables)

Cómo construir un medidor IoT basado en Arduino con API REST y conectarlo a la plataforma IFTTT.com mediante el servicio de relé Yaler.net.

Lo emocionante: con el Canal Maker, IFTTT soporta Webhooks personalizados para integrar proyectos IoT DIY. ¡Se esperaba desde 2011!

Inspirado en WhereDial, un clásico del IoT DIY, el medidor IoT muestra la ubicación actual de su propietario, similar al reloj Weasley de Harry Potter.

El diseño y código son genéricos y pueden usarse para mostrar, por ejemplo, condiciones meteorológicas. La lógica reside en la nube; el medidor es solo un servo con API.

Descargas (para Arduino Uno)

• Librería Yaler para Arduino: YalerEthernetServer.zip
• Código para Arduino Uno: IoTGaugeWebService.ino

* Soy fundador de Yaler.
** Zapier, otra plataforma de integración, siempre soportó Webhooks personalizados.

Paso 1: Corte láser y ensamblaje del medidor IoT

Producción de las piezas

• Descarga los archivos de diseño del medidor IoT
• Corta con láser el diseño en madera contrachapada de 4 mm
• Graba los nombres de ubicaciones (o lo que necesites), o escríbelos con rotulador

Ensamblaje del medidor IoT

• Añade el shield Ethernet al Arduino (para el Uno)
• Atornilla el Arduino a la placa base (observa su orientación)
• Coloca la placa frontal grande en el servo, luego la pequeña
• Inserta la placa base en ambas placas frontales, asegurando la alineación
• Pega los indicadores a la placa frontal, orientándolos correctamente
• Usa cables jumper para conectar el servo al pin 9, 5V y GND del Arduino (o shield)
• Añade la aguja del reloj (calibrar después)

Paso 2: Subir el código del servicio web del medidor IoT

Servicio web simple

Controlar el medidor IoT es sencillo. Un servicio web (API REST) escucha peticiones entrantes y ajusta la posición del servo. El medidor es un servo "tonto". Mantener la lógica en la nube permite cambiar el "cerebro" luego, por ejemplo, para mostrar el clima en lugar de la ubicación.

Acceso remoto al Arduino

Para que el servicio en la nube de IFTTT acceda al medidor, la API REST del Arduino debe ser accesible y direccionable desde la web. Los expertos podrían añadir una excepción en su firewall o router. Para simplificar, usaremos un servicio de relé.

Instalación en Arduino Uno (para Yun, ver abajo)

• Instala la librería YalerEthernetServer.zip como se muestra en yaler.net/arduino
• Descarga el código IoTGaugeWebService.ino para Arduino Uno
• Asegúrate de usar una dirección MAC única
• Reemplaza RELAY_DOMAIN con tu dominio de relé (regístrate para una cuenta de prueba gratis en Yaler.net)
• Sube el código a tu Arduino Uno

Instalación en Arduino Yun (para Uno, ver arriba)

• Instala YalerTunnel y habilita el acceso web como se muestra en yaler.net/arduino-yun
• Descarga el código IoTGaugeMailboxApi.ino para Arduino Yun
• Sube el código a tu Arduino Yun

¿Por qué el código del Yun difiere del del Uno?

El Yun proporciona una API REST integrada llamada "mailbox". Para hacer esta API accesible desde la web, usamos el demonio Linux YalerTunnel (que también soporta cifrado SSL, a diferencia del Uno). Aprovechando lo existente simplificas tu código.

La API mailbox del Yun no es perfecta (ni estrictamente RESTful, permite GET para cambiar valores), pero se basa en un script en el lado Linux del Yun, usando menos memoria en el lado Arduino.

* Si no quieres usar un servicio de relé, simplemente elimínalo y (para el Uno) descomenta el servidor local.

Paso 3: Probar el servicio web del Arduino con Curl

Instalación de la herramienta Curl

• Descarga e instala Curl desde curl.haxx.se
• Abre una terminal y prueba: $ curl -v https://google.com/

Habilitar la API del Arduino Yun (omitir para el Uno)

• Alimenta el Yun, espera un poco, visita https://arduino.local/
• Inicia sesión y haz clic en Configurar
• Desplázate y configura el acceso a la API REST como Abierto
• Haz clic en Configurar y reiniciar

Probar el medidor IoT con Curl

• Asegúrate de que el Arduino está alimentado y conectado a Internet
• Establece la posición del servo a 3 (o cualquier posición de 1 a 5) con:
  $ curl -vX POST https://RELAY_DOMAIN.try.yaler.io/mailbox/pos/3
  (Reemplaza RELAY_DOMAIN con tu dominio de relé)
• Verifica que el servo movió la aguja a la posición deseada (ajusta si es necesario)
• Debes recibir una respuesta como HTTP/1.1 200 OK
• Si recibes HTTP/1.1 504, el Arduino no está en línea o hay un error tipográfico

¿Por qué probar tu API con Curl?

Curl es un cliente HTTP estándar. Los navegadores son buenos para probar GET, y hay herramientas online para PUT y POST. Pero a veces el navegador añade "magia" como seguir redirecciones. Para asegurar que un cliente básico o un Webhook de terceros (como el de IFTTT) pueda acceder a tu API, Curl es ideal.

* Para el Uno, POST /mailbox/pos/3 funciona igual que PUT /servo?pos=3 porque el código que parsea la petición es bastante tolerante.

Paso 4: Conectar el Arduino al canal Maker de IFTTT

Crear una nueva receta IFTTT (o saltar para añadir una existente)

IFTTT permite crear recetas conectando un disparador a una acción.

1. Visita ifttt.com/myrecipes/personal/new (regístrate si no lo has hecho)
2. Para elegir un canal de disparo, busca "Android Device" o "iOS Location" y selecciona el icono
3. Elige un disparador, ej. Se conecta a una red WiFi específica (para Android)
4. Ingresa el nombre de la red o ubicación
5. Para el canal de acción, busca Maker y selecciónalo
6. Selecciona la acción Hacer una petición web
7. Ingresa la URL: https://RELAY_DOMAIN.try.yaler.io/mailbox/pos/3 (reemplaza RELAY_DOMAIN)
8. Método: POST
9. Content Type: application/x-www-form-urlencoded
10. Body: déjalo vacío

Añadir una receta IFTTT existente

IFTTT permite publicar recetas. Aquí hay dos para controlar tu medidor IoT:

• Abre la receta "IoT Gauge position from Android WiFi location"
• O la receta "IoT Gauge position from iOS location"
• O busca recetas "IoT Gauge" en ifttt.com/recipes/search?q=IoT+Gauge
• Haz clic en Añadir para instanciar la receta
• Ingresa el nombre de red WiFi o ubicación (lo que pida la receta)
• Reemplaza RELAY_DOMAIN en la URL con tu dominio de relé
• Adapta el parámetro pos en la URL de 1 a 5 según tu ubicación
• Añade otra instancia por cada ubicación

* Parece que IFTTT aún no añade recetas del canal Maker a los resultados de búsqueda.

Paso 5: Crear un botón Do de IFTTT para el medidor IoT

Apps Do de IFTTT

IFTTT ofrece apps Do para iOS y Android que permiten disparar acciones manualmente. Útiles para probar otras recetas.

A diferencia de las recetas normales, las de Do no pueden (¿todavía?) compartirse ni hacerse públicas. Debes crearlas desde cero.

Crear un nuevo botón Do de IFTTT

1. Descarga la app Do Button para Android o iPhone en ifttt.com/products/do/button
2. Completa las pantallas introductorias obligatorias
3. Usa el icono pequeño en la esquina inferior derecha para ver la lista de recetas
4. Toca el signo +, luego Canales y busca Maker
5. Selecciona la acción Hacer una petición web
6. URL: https://RELAY_DOMAIN.try.yaler.io/mailbox/pos/3 (reemplaza RELAY_DOMAIN)
7. Método: POST
8. Content Type: application/x-www-form-urlencoded
9. Body: déjalo vacío
10. Toca Añadir para crear el botón
11. Una vez creado, edita la receta online en ifttt.com/myrecipes/do

¡Eso es todo! Gracias por leer, y avísame si tienes preguntas o sugerencias.

Código

Repositorio en Bitbucket

Piezas personalizadas y cajas

IoT_Gauge.zip

Esquemáticos