El banco de trabajo
Cada lección abre un nodo de telemetría: un ESP32-C3 con un sensor BME280 en I2C (SDA GPIO 8, SCL GPIO 9) y una tarjeta microSD en SPI (SCK 4, MISO 5, MOSI 6, CS 7). La nube es la red simulada de Mokxi: las cargas van a
api.mokxi, cuyo estado y cuerpo se configuran en el panel Nube (las verificaciones de las lecciones los ajustan para que provoques caídas a propósito), y
echo.mokxi devuelve un payload byte por byte. Consulta
WiFi en Mokxi.
Toma el curso en /learn/path/iot-data-pipelines en /learn.
Las lecciones
- Diseño de la telemetría. Un id de dispositivo, un número de secuencia que nunca se reutiliza, una marca de tiempo de tiempo activo y unidades en cada nombre; cuánto cuesta un día de lecturas.
- Payloads JSON. Documentos de ArduinoJson, objetos y arreglos anidados, decimales exactos, medir antes de enviar, claves cortas y una respuesta analizada con cada fallo verificado.
- Agrupamiento. Varias lecturas por solicitud, cada una conservando su seq, y un lote que se mantiene completo cuando el post falla.
- Reintentos. Retroceso exponencial hasta un tope con jitter total, un reinicio tras el éxito y sin reintentos ante un 4xx.
- Una cola sin conexión. Lecturas agregadas a un archivo JSON Lines en la tarjeta antes de enviar, cargadas primero las más antiguas, marcadas como enviadas solo tras un 2xx, y un número de secuencia que sobrevive a un reinicio.
- Identidad del dispositivo. Un id de un archivo de configuración o de la MAC, una clave de API fuera del código, una Idempotency-Key por carga y una detención ante una clave rechazada.
- Reto final: un nodo de telemetría confiable. Todo junto, atravesando una caída, un reinicio y una clave rechazada.
Qué hace cada sketch
| Sketch | Qué hace |
|---|---|
dptelem |
Envía lecturas con id, seq, tiempo activo y unidades, verificadas contra el eco. |
dpjson |
Construye, mide y publica un payload de ArduinoJson, analiza la respuesta. |
dpbatch |
Agrupa lecturas en un arreglo JSON por solicitud. |
dpbackoff |
Reintenta con retroceso exponencial, un tope y jitter total. |
dpqueue |
Una cola en tarjeta SD que sobrevive a caídas y reinicios. |
dpident |
Identidad desde la tarjeta o la MAC, una clave de API, una Idempotency-Key. |
dpnode |
El nodo de telemetría confiable. |
Límites honestos
- La red es simulada: sin radio ni internet real.
api.mokxiresponde lo que dice el panel Nube; no almacena lecturas ni deduplica por Idempotency-Key, así que las lecciones explican la parte del servidor en lugar de mostrarla. - El cliente HTTP de aquí no devuelve encabezados de respuesta, así que
Retry-Afterse explica, no se lee. - La tarjeta usa nombres de archivo 8.3 (QUEUE.TXT, SEQ.TXT, SENT.TXT, CONFIG.TXT) y el File de SD.h no tiene
readStringUntil(), así que los sketches leen líneas a mano.