Meja kerja
Setiap pelajaran membuka satu node telemetri: sebuah ESP32-C3 dengan sensor BME280 di I2C (SDA GPIO 8, SCL GPIO 9) dan kartu microSD di SPI (SCK 4, MISO 5, MOSI 6, CS 7). Cloud-nya adalah jaringan simulasi milik Mokxi: upload dikirim ke
api.mokxi, yang status dan body-nya diatur di panel Cloud (pemeriksaan pelajaran mengaturnya untukmu agar kamu bisa sengaja membuat gangguan), dan
echo.mokxi mengembalikan payload apa adanya, byte demi byte. Lihat
WiFi di Mokxi.
Ikuti kursusnya di /learn/path/iot-data-pipelines di /learn.
Pelajarannya
- Desain telemetri. Id perangkat, nomor urut yang tidak pernah dipakai ulang, timestamp uptime dan satuan di setiap nama; berapa biaya satu hari penuh data pengukuran.
- Payload JSON. Dokumen ArduinoJson, objek dan array bersarang, angka desimal yang presisi, mengukur sebelum mengirim, kunci yang singkat, dan balasan yang di-parse dengan setiap kegagalan diperiksa.
- Penggabungan (batching). Banyak pengukuran per permintaan, masing-masing tetap menyimpan seq-nya, dan satu batch tetap utuh saat post gagal.
- Backoff. Backoff eksponensial sampai batas maksimum dengan full jitter, reset saat sukses, dan tanpa retry untuk 4xx.
- Antrian offline. Pengukuran ditambahkan ke file JSON Lines di kartu sebelum dikirim, diupload dari yang paling lama, ditandai terkirim hanya setelah 2xx, dan nomor urut yang tetap bertahan setelah reboot.
- Identitas perangkat. Id dari file konfigurasi atau MAC, API key yang tidak dimasukkan ke kode, satu Idempotency-Key per upload, dan berhenti saat key ditolak.
- Boss: node telemetri yang andal. Semuanya digabung, melewati gangguan jaringan, reboot, dan key yang ditolak.
Apa yang dilakukan setiap sketch
| Sketch | Fungsinya |
|---|---|
dptelem |
Mengirim pengukuran dengan id, seq, uptime dan satuan, diperiksa terhadap echo. |
dpjson |
Mengompilasi, mengukur dan mem-post payload ArduinoJson, meng-parse balasannya. |
dpbatch |
Menggabungkan pengukuran menjadi satu array JSON per permintaan. |
dpbackoff |
Retry dengan backoff eksponensial, batas maksimum, dan full jitter. |
dpqueue |
Antrian di kartu SD yang bertahan dari gangguan jaringan dan reboot. |
dpident |
Identitas dari kartu atau MAC, sebuah API key, dan Idempotency-Key. |
dpnode |
Node telemetri yang andal. |
Keterbatasan yang jujur
- Jaringannya disimulasikan: tanpa radio dan tanpa internet sungguhan.
api.mokximenjawab sesuai isi panel Cloud; ia tidak menyimpan pengukuran atau menduplikasi berdasarkan Idempotency-Key, jadi pelajaran menjelaskan sisi server alih-alih menunjukkannya. - Klien HTTP di sini tidak mengembalikan header respons, jadi
Retry-Afterdijelaskan, tidak dibaca. - Kartu memakai nama file 8.3 (QUEUE.TXT, SEQ.TXT, SENT.TXT, CONFIG.TXT), dan File dari SD.h tidak punya
readStringUntil(), jadi sketch membaca barisnya secara manual.