الدروس ولعبة التعلّم

من الجهاز إلى السحابة: بيانات قياس تصمد

أوصل كل قراءة إلى الخادم مرة واحدة وبالترتيب رغم الانقطاعات وإعادات التشغيل: أرقام تسلسلية، وتجميع في دفعات، وتراجع تدريجي، وقائمة انتظار على بطاقة SD ورفع لا يكرر الأثر.

المنضدة

كل درس يفتح عقدة قياس واحدة: لوحة 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.

الدروس

  1. تصميم بيانات القياس. معرّف جهاز، ورقم تسلسلي لا يُعاد استخدامه أبدًا، وطابع زمني لمدة التشغيل، ووحدات قياس في كل اسم؛ وكم يكلف يوم من القراءات.
  2. حمولات JSON. مستندات ArduinoJson، وكائنات ومصفوفات متداخلة، وكسور عشرية دقيقة، والقياس قبل الإرسال، ومفاتيح قصيرة، ورد يُحلَّل مع فحص كل فشل محتمل.
  3. التجميع في دفعات. قراءات كثيرة في كل طلب، تحتفظ كل منها برقمها التسلسلي، وتُبقى الدفعة كاملة عند فشل الإرسال.
  4. التراجع التدريجي. تراجع أُسّي حتى حد أقصى مع عشوائية كاملة، وإعادة ضبط عند النجاح، ولا إعادة محاولة مع 4xx.
  5. قائمة انتظار دون اتصال. قراءات تُضاف إلى ملف JSON Lines على البطاقة قبل الإرسال، وتُرفع الأقدم أولًا، ولا تُعلَّم كمُرسلة إلا بعد 2xx، ورقم تسلسلي يصمد أمام إعادة التشغيل.
  6. هوية الجهاز. معرّف من ملف إعدادات أو من عنوان MAC، ومفتاح API يُبقى خارج الكود، ومفتاح Idempotency-Key لكل رفع، وتوقف عند رفض المفتاح.
  7. الزعيم: عقدة قياس موثوقة. كل ذلك مجتمعًا، عبر انقطاع، وإعادة تشغيل، ومفتاح مرفوض.

ماذا يفعل كل كود

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()، لذا تقرأ الأكواد الأسطر يدويًا.

الروابط اللاسلكية: nRF24 وESP-NOW.