يتفاعل مستشعر NiuBoL مع منصة akenza.io عبر بروتوكول MQTT

تتطلب عملية التكامل مع منصة akenza.io عبر بروتوكول MQTT إكمال خطوات مثل تكوين الجهاز، إنشاء تدفق البيانات، تسجيل الجهاز، وتنفيذ الكود. فيما يلي دليل مفصل، استنادا إلى وثائق أكينزا الرسمية وميزات بروتوكول MQTT، يشرح كيفية تحقيق التكامل خطوة بخطوة.

الخطوة 1: إنشاء حساب akenza.io

1. تسجيل حساب:

- قم بزيارة صفحة التسجيل فيhttps://akenza.ioوأنشئ حسابا. إذا كان لديك حساب بالفعل، قم بتسجيل الدخول مباشرة.

- بعد تسجيل الدخول، سيتم توجيهك إلى لوحة تحكم منصة akenza.

2. فهم المنصة:

- تدعم منصة أكينزا بروتوكول MQTT وتستخدم إكليبس موسكيتو كوسيط MQTT. تعمل المنصة كوسيط، وتعمل الأجهزة كعملاء MQTT.

الخطوة 2: إنشاء تدفق بيانات MQTT

يحدد تدفق البيانات كيفية تواصل الأجهزة مع منصة أكينزا عبر MQTT.

1. التنقل إلى تدفق البيانات:

- في لوحة تحكم أكينزا، انقر على "تدفق البيانات" في القائمة اليسرى.

- انقر على زر "إنشاء تدفق البيانات".

2. اختر MQTT الاتصال:

- في نوع الاتصال، اختر "توصيل جهاز عبر MQTT".

- نوع الجهاز: اختر "تمرير" لاستقبال صيغ البيانات الخام (يوصى بتنسيق JSON).

- موصل الإخراج: اختر وجهة التخزين للبيانات، مثل قاعدة بيانات akenza (قاعدة البيانات الافتراضية) أو الموصلات المدعومة الأخرى مثل InfluxDB أو Webhook.

3. توليد سر (المفتاح):

- بعد إنشاء تدفق البيانات، يقوم النظام تلقائيا بإنشاء سر (مفتاح) للمصادقة على الجهاز.

- تسجيل هذا السر، حيث سيستخدم في هيكل الموضوع MQTT واتصال الجهاز.

4. حفظ تدفق البيانات:

- بعد تأكيد الإعدادات، انقر على "إنشاء" لحفظ تدفق البيانات.

الخطوة 3: تسجيل جهاز

1. التنقل إلى مساحة العمل:

- في القائمة اليسرى، اضغط على "مساحة العمل".

- اضغط على زر "إنشاء جهاز".

2. املأ معلومات الجهاز:

- اسم الجهاز: سم جهازك، مثل "حساس الطقس" أو "حساس التربة".

- الوصف (اختياري): أضف وصفا للجهاز.

- الوسوم/الحقول المخصصة (اختياري): إضافة علامات أو حقول مخصصة للتصنيف.

- تدفق البيانات: اختر تدفق البيانات MQTT الذي تم إنشاؤه في الخطوة السابقة.

3. توليد معرف الجهاز:

- انقر على "توليد معرف" لإنشاء معرف فريد للجهاز.

4. التسجيل الكامل:

- انقر على "إنشاء الجهاز" لإكمال تسجيل الجهاز.

- بعد التسجيل، ابحث عن الجهاز في قائمة الأجهزة وانقر لدخول صفحة تفاصيل الجهاز.

5. الحصول على تكوين واجهة برمجة التطبيقات:

- في صفحة تفاصيل الجهاز تحت تبويب "تكوين API"، احصل على المعلومات التالية:

-MQTT مضيف وسيط: عادة mqtt.akenza.io.

-MQTT اسم المستخدم: اسم المستخدم.

- كلمة MQTT: كلمة مرور.

- موضوع الاتصال: /up/{secret}/id/{deviceId}.

- موضوع التحميل (اختياري): /down/{secret}/id/{deviceId}.

الخطوة 4: قم بتكوين الجهاز للاتصال ب MQTT

باستخدام جهاز مثل حساس Niubol أو جهاز آخر يدعم MQTT، قم بإعداده للاتصال بوسيط MQTT Akenza. تفترض التعليمات التالية أنك تستخدم جامع البيانات Niubol.

الخطوة 5: التحقق من البيانات

1. عرض سجلات الرسائل:

- في مساحة عمل منصة أكينزا، ابحث عن جهازك واذهب إلى صفحة تفاصيل جهازه.

- تحت تبويب "سجلات الرسائل"، عرض بيانات الإرسال المرسلة من الجهاز.

- يجب أن تظهر البيانات بصيغة JSON، مثل{"sensor":"temperature","value":25.5}.

2. تصور البيانات:

- في تبويب Dashboard Builder، عرض مؤشرات الأداء الرئيسية ومخططات البيانات التاريخية للجهاز.

- إذا تم تكوين موضوع التنزيل (downlink)، يمكنك اختبار إرسال الأوامر إلى الجهاز.

الخطوة 6: تفعيل TLS (اختياري)

لتعزيز الأمان، ينصح باستخدام تشفير TLS:

1. استخدم المنفذ 8883 بدلا من 1883 للاتصالات المشفرة.

ملاحظات:

1. طرق المصادقة:

- يدعم أكينزا طريقتين للمصادقة:

- أسرار الربط الصاعد: استخدم مفتاحا مشتركا ككلمة مرور MQTT.

- JWT: استخدم المفتاح الخاص للجهاز لإنشاء JWT ككلمة مرور (أكثر أمانا، يتطلب إعدادات إضافية).

- اختيار نوع المصادقة عند إنشاء تدفق البيانات.

2. هيكل الموضوع:

- تنسيق موضوع الوصلة: /up/{secret}/id/{deviceId}.

- تنسيق موضوع الرابط الهابط: /down/{secret}/id/{deviceId}.

- التأكد من تطابق المواضيع مع تكوين الجهاز.

3. استكشاف الأخطاء:

- إذا فشل الاتصال، تحقق ع:

- تأكد من صحة اسم المستخدم MQTT وكلمة المرور والموضوع.

- التحقق من أن اتصال الشبكة مستقر (شبكة Wi-Fi أو شبكة خلوية).

- التأكد من أن المنافذ غير محجوبة بجدار حماية (1883 أو 8883).

- استخدم شاشة تسلسلية أو سجلات لعرض رموز الخطأ.

4. الصيغ المدعومة:

- يقبل Akenza رسائل MQTT منسقة بنظام JSON، لذا تأكد من أن البيانات المرسلة من الجهاز بالصيغة الصحيحة.

مصادر مرجعية:

- التوثيق الرسمي لأكينزا:MQTT الاتصال:

https://docs.akenza.io/akenza.io/get-started/your-data-flow/device-connector/mqtt

- درس تعليمي: كيفية دمج جهاز أردوينو عبر MQTT على أكينزا:

https://docs.akenza.io/akenza.io/tutorials/add-devices/how-to-integrate-an-arduino-device-via-mqtt-on-akenza