Bàn thí nghiệm
Mỗi bài học mở ra một node telemetry: một ESP32-C3 với cảm biến BME280 trên I2C (SDA GPIO 8, SCL GPIO 9) và thẻ microSD trên SPI (SCK 4, MISO 5, MOSI 6, CS 7). Đám mây là mạng mô phỏng của Mokxi: các lệnh upload gửi đến
api.mokxi, có trạng thái và nội dung được đặt trong bảng Đám mây (phần kiểm tra của các bài học sẽ đặt giúp bạn để cố tình tạo mất mạng), và
echo.mokxi trả về payload nguyên byte từng byte. Xem
WiFi trong Mokxi.
Học khóa học tại /learn/path/iot-data-pipelines trên /learn.
Các bài học
- Thiết kế telemetry. Id thiết bị, số thứ tự không bao giờ dùng lại, dấu thời gian uptime và đơn vị trong mọi tên; một ngày đo tốn bao nhiêu.
- Payload JSON. Tài liệu ArduinoJson, đối tượng và mảng lồng nhau, số thập phân chính xác, đo trước khi gửi, khóa ngắn, và phản hồi được phân tích với mọi lỗi được kiểm tra.
- Gộp batch. Nhiều lần đo mỗi request, mỗi lần giữ nguyên seq, và một batch được giữ nguyên khi post thất bại.
- Backoff. Backoff luỹ thừa đến mức trần với full jitter, đặt lại khi thành công, và không thử lại với 4xx.
- Hàng đợi offline. Các lần đọc được nối thêm vào tệp JSON Lines trên thẻ trước khi gửi, tải lên cái cũ nhất trước, chỉ đánh dấu đã gửi sau mã 2xx, và số thứ tự sống sót qua lần khởi động lại.
- Danh tính thiết bị. Id từ tệp cấu hình hoặc MAC, API key không đặt trong code, một Idempotency-Key cho mỗi lần upload, và dừng lại khi key bị từ chối.
- Boss: node telemetry đáng tin cậy. Tất cả kết hợp lại, vượt qua mất mạng, khởi động lại và key bị từ chối.
Mỗi sketch làm gì
| Sketch | Công dụng |
|---|---|
dptelem |
Gửi các lần đo với id, seq, uptime và đơn vị, kiểm tra lại với bản echo. |
dpjson |
Xây dựng, đo và post payload ArduinoJson, phân tích phản hồi. |
dpbatch |
Gộp các lần đo thành một mảng JSON cho mỗi request. |
dpbackoff |
Thử lại với backoff luỹ thừa, mức trần và full jitter. |
dpqueue |
Hàng đợi trên thẻ SD sống sót qua mất mạng và khởi động lại. |
dpident |
Danh tính từ thẻ hoặc MAC, API key, Idempotency-Key. |
dpnode |
Node telemetry đáng tin cậy. |
Giới hạn thật
- Mạng được mô phỏng: không có sóng radio và không có internet thật.
api.mokxitrả lời theo những gì bảng Cloud ghi; nó không lưu các lần đo hay loại trùng theo Idempotency-Key, nên các bài học giải thích phía máy chủ thay vì cho thấy nó. - HTTP client ở đây không trả về response headers, nên
Retry-Afterđược giải thích chứ không đọc được. - Thẻ dùng tên tệp 8.3 (QUEUE.TXT, SEQ.TXT, SENT.TXT, CONFIG.TXT), và File của SD.h không có
readStringUntil(), nên các sketch phải tự đọc từng dòng.