المنضدة
كل درس يفتح عقدة قياس واحدة: لوحة ESP32-C3 مع حساس BME280 على I2C (SDA على GPIO 8 وSCL على GPIO 9) وبطاقة microSD على SPI (SCK 4 وMISO 5 وMOSI 6 وCS 7). السحابة هي شبكة Mokxi المحاكاة: تُرفع البيانات إلى
api.mokxi، التي تُضبط حالتها ومحتواها في السحابة لوحة (تضبطها لك تحققات الدروس لتتسبب بانقطاعات عن قصد)، و
echo.mokxi يعيد الحمولة بايتًا ببايت. انظر
WiFi في Mokxi.
خذ الدورة على /learn/path/iot-data-pipelines على /learn.
الدروس
- تصميم بيانات القياس. معرّف جهاز، ورقم تسلسلي لا يُعاد استخدامه أبدًا، وطابع زمني لمدة التشغيل، ووحدات قياس في كل اسم؛ وكم يكلف يوم من القراءات.
- حمولات JSON. مستندات ArduinoJson، وكائنات ومصفوفات متداخلة، وكسور عشرية دقيقة، والقياس قبل الإرسال، ومفاتيح قصيرة، ورد يُحلَّل مع فحص كل فشل محتمل.
- التجميع في دفعات. قراءات كثيرة في كل طلب، تحتفظ كل منها برقمها التسلسلي، وتُبقى الدفعة كاملة عند فشل الإرسال.
- التراجع التدريجي. تراجع أُسّي حتى حد أقصى مع عشوائية كاملة، وإعادة ضبط عند النجاح، ولا إعادة محاولة مع 4xx.
- قائمة انتظار دون اتصال. قراءات تُضاف إلى ملف JSON Lines على البطاقة قبل الإرسال، وتُرفع الأقدم أولًا، ولا تُعلَّم كمُرسلة إلا بعد 2xx، ورقم تسلسلي يصمد أمام إعادة التشغيل.
- هوية الجهاز. معرّف من ملف إعدادات أو من عنوان MAC، ومفتاح API يُبقى خارج الكود، ومفتاح Idempotency-Key لكل رفع، وتوقف عند رفض المفتاح.
- الزعيم: عقدة قياس موثوقة. كل ذلك مجتمعًا، عبر انقطاع، وإعادة تشغيل، ومفتاح مرفوض.
ماذا يفعل كل كود
| Sketch | ماذا تفعل |
|---|---|
dptelem |
يرسل قراءات بمعرّف ورقم تسلسلي ومدة تشغيل ووحدات، مفحوصة مقابل الصدى. |
dpjson |
يبني ويقيس ويرسل حمولة ArduinoJson، ويحلل الرد. |
dpbatch |
يجمع القراءات في مصفوفة JSON واحدة لكل طلب. |
dpbackoff |
يعيد المحاولة بتراجع أُسّي وحد أقصى وعشوائية كاملة. |
dpqueue |
قائمة انتظار على بطاقة SD تصمد أمام الانقطاعات وإعادة التشغيل. |
dpident |
هوية من البطاقة أو من عنوان MAC، ومفتاح API، ومفتاح Idempotency-Key. |
dpnode |
عقدة القياس الموثوقة. |
حدود صريحة
- الشبكة محاكاة: لا راديو ولا إنترنت حقيقي.
api.mokxiيجيب بما تقوله لوحة Cloud؛ فهو لا يخزن القراءات ولا يزيل التكرار بمفتاح Idempotency-Key، لذا تشرح الدروس نصف الخادم بدلًا من عرضه. - عميل HTTP هنا لا يعيد ترويسات الاستجابة، لذا يُشرح
Retry-Afterولا يُقرأ. - البطاقة تستخدم أسماء ملفات بصيغة 8.3 (QUEUE.TXT وSEQ.TXT وSENT.TXT وCONFIG.TXT)، وكائن File في SD.h لا يملك
readStringUntil()، لذا تقرأ الأكواد الأسطر يدويًا.