يتفاعل مستشعر 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-Configuration"، احصل على المعلومات التالية:

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

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

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

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

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

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

باستخدام جهاز مثل حساس نيوبول أو جهاز آخر يدعم MQTT، قم بضبطه للاتصال بوسيط MQTTأكينزا. التعليمات التالية تفترض أنك تستخدم جامع بيانات 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