Lecciones y el juego de aprendizaje

Del dispositivo a la nube: telemetría que sobrevive

Logra que cada lectura llegue al servidor una sola vez y en orden, a través de cortes y reinicios: números de secuencia, agrupamiento en lotes, retroceso exponencial, una cola en SD y cargas idempotentes.

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

  1. 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.
  2. 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.
  3. Agrupamiento. Varias lecturas por solicitud, cada una conservando su seq, y un lote que se mantiene completo cuando el post falla.
  4. Reintentos. Retroceso exponencial hasta un tope con jitter total, un reinicio tras el éxito y sin reintentos ante un 4xx.
  5. 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.
  6. 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.
  7. 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.mokxi responde 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-After se 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.

Enlaces inalámbricos: nRF24 y ESP-NOW.