Bài học và trò chơi học tập

Thiết bị lên đám mây: telemetry bền bỉ

Đưa mọi số đo về server đúng một lần và đúng thứ tự qua các gián đoạn và khởi động lại: số thứ tự, gom lô, backoff, một hàng đợi trên SD và việc nạp có thể lặp lại an toàn.

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

  1. 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.
  2. 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.
  3. 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.
  4. 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.
  5. 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.
  6. 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.
  7. 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.mokxi trả 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.

Liên kết không dây: nRF24 và ESP-NOW.