A bancada
Cada aula abre um nó de telemetria: um ESP32-C3 com um sensor BME280 em I2C (SDA GPIO 8, SCL GPIO 9) e um cartão microSD em SPI (SCK 4, MISO 5, MOSI 6, CS 7). A nuvem é a rede simulada do Mokxi: os uploads vão para
api.mokxi, cujo status e corpo são definidos no Nuvem (as verificações das aulas os definem para você provocar quedas de propósito), e
echo.mokxi devolve o payload byte a byte. Veja
WiFi no Mokxi.
Faça o curso em /learn/path/iot-data-pipelines no /learn.
As aulas
- Design de telemetria. Um id de dispositivo, um número de sequência nunca reutilizado, um carimbo de tempo de atividade e unidades em cada nome; quanto custa um dia de leituras.
- Payloads JSON. Documentos ArduinoJson, objetos e arrays aninhados, casas decimais exatas, medir antes de enviar, chaves curtas e uma resposta analisada com cada falha verificada.
- Agrupamento. Várias leituras por requisição, cada uma mantendo seu seq, e um lote mantido inteiro quando o post falha.
- Backoff. Backoff exponencial até um limite com jitter total, reinício após sucesso e nenhuma nova tentativa em um 4xx.
- Uma fila offline. Leituras anexadas a um arquivo JSON Lines no cartão antes do envio, com upload do mais antigo primeiro, marcadas como enviadas só depois de um 2xx, e um número de sequência que sobrevive a uma reinicialização.
- Identidade do dispositivo. Um id de um arquivo de configuração ou do MAC, uma chave de API mantida fora do código, uma Idempotency-Key por upload e uma parada em chave recusada.
- Chefe: um nó de telemetria confiável. Tudo junto, passando por uma queda, uma reinicialização e uma chave recusada.
O que cada sketch faz
| Sketch | O que faz |
|---|---|
dptelem |
Envia leituras com id, seq, tempo de atividade e unidades, conferidas contra o eco. |
dpjson |
Compila, mede e posta um payload ArduinoJson, analisa a resposta. |
dpbatch |
Agrupa leituras em um array JSON por requisição. |
dpbackoff |
Tenta de novo com backoff exponencial, um limite e jitter total. |
dpqueue |
Uma fila no cartão SD que sobrevive a quedas e reinicializações. |
dpident |
Identidade do cartão ou do MAC, uma chave de API, uma Idempotency-Key. |
dpnode |
O nó de telemetria confiável. |
Limites honestos
- A rede é simulada: sem rádio e sem internet de verdade.
api.mokxiresponde o que o painel Cloud diz; ele não armazena leituras nem deduplica por Idempotency-Key, então as aulas explicam a parte do servidor em vez de mostrá-la. - O cliente HTTP daqui não devolve cabeçalhos de resposta, então
Retry-Afteré explicado, não lido. - O cartão usa nomes de arquivo 8.3 (QUEUE.TXT, SEQ.TXT, SENT.TXT, CONFIG.TXT), e o File da SD.h não tem
readStringUntil(), então os sketches leem as linhas manualmente.