ربط جهازك الأول

إدخال أجهزتك إلى SensoCAN يتم في ثلاث خطوات: أنشئ الجهاز، وأضف مستشعراً، ثم وجّه البرنامج الثابت (firmware) لديك إلى بيانات الاعتماد التي تمنحها لك المنصة.

إنشاء الجهاز

انتقل إلى الأجهزة ← إضافة جهاز. عنوان الصفحة إنشاء جهاز، وتفتح بملاحظة تشير إلى أن معرّف UUID وموضوع MQTT (topic) يُنشآن لك تلقائياً عند الحفظ.

املأ المعلومات الأساسية:

• اسم الجهاز: مطلوب. حروف وأرقام ومسافات وشرطات سفلية وشرطات فقط.
• فئة الجهاز: قياسي للأجهزة التي تقيس بنفسها، وبوابة للوحدة التي تنقل قراءات منارات BLE. لا تتغير الفئة بعد إنشاء الجهاز.
• الموقع: اختياري، ويستحق التعبئة: قائمة الأجهزة تبحث فيه، ويمكن أن تتضمنه رسائل التنبيه.
• مهلة انقطاع الاتصال: المدة التي يجوز أن يبقى فيها هذا الجهاز صامتاً قبل أن يضعه SensoCAN في حالة غير متصل. اتركه فارغاً لاعتماد القيمة الافتراضية، أو اضبطه على مدة أطول قليلاً من فاصل الإبلاغ في برنامجك الثابت.

ضمن مصدر الطاقة، اختر طاقة مباشرة، أو بطارية مع نوع البطارية المطابق للخلايا التي ركّبتها؛ هذا ما يحوّل الجهد المُبلَّغ إلى نسبة مئوية لمستوى البطارية.

يمكن تأجيل مستلمي الإشعارات وإعدادات الإشعارات؛ يشرحهما دليل الأجهزة. اختر إنشاء جهاز.

صفحة إنشاء جهاز: بطاقة المعلومات الأساسية وفيها اسم الجهاز، وفئة الجهاز مضبوطة على قياسي، والموقع ومهلة انقطاع الاتصال معبأان، وبطاقة مصدر الطاقة أسفلها مضبوطة على بطارية مع اختيار نوع البطارية.

إضافة مستشعر

افتح الجهاز الجديد من القائمة. بطاقة المستشعرات في الأسفل: اختر إضافة مستشعر.

• اسم المستشعر: مطلوب، وفريد على هذا الجهاز.
• نوع المستشعر: حرارة أو رطوبة أو ضغط أو تيار أو باب أو مياه. لا يمكن تغيير هذا لاحقاً، فاختر النوع المطابق لما يقيسه الجهاز.

لا يحمل الجهاز القياسي سوى مستشعر واحد من كل نوع؛ والبوابات مستثناة من ذلك. يُنشئ الحفظ ملفاً تعريفياً معبأً بالقيم الافتراضية للنوع: الحدود، وهوامش الحساسية، وساعات العمل، وتضبطها لاحقاً في صفحة المستشعر نفسه. راجع المستشعرات.

جمع بيانات الاعتماد

كل ما يحتاجه برنامجك الثابت موجود في صفحة الجهاز: معرّف الجهاز (UUID) وموضوع MQTT، ولكل منهما زر نسخ، في بطاقة معلومات الجهاز؛ واسم مستخدم MQTT وكلمة المرور خلف بيانات اعتماد MQTT؛ ورمز الوصول خلف عرض الرمز؛ ومعرّفات كل مستشعر في صفحة المستشعر نفسه.

بجوار موضوع MQTT يوجد أمثلة حمولة MQTT: مواضيع وحمولات بيانات (payload) جاهزة، معبأة بالمعرّفات الحقيقية لهذا الجهاز، لقراءة مفردة، ولإرسال مجمّع (bulk)، ولدفعة تشمل عدة مستشعرات، ولرسالة بطارية فقط. انسخ منها بدل الكتابة يدوياً.

بطاقة معلومات الجهاز على جهاز أُنشئ حديثاً: معرّف الجهاز UUID وزر نسخه، وشارة حالة الجهاز وتظهر غير متصل، وموضوع MQTT مع زر نسخه وزر أمثلة حمولة MQTT، وزرَّا عرض الرمز وبيانات اعتماد MQTT.

رمز الوصول وكلمة مرور MQTT سرّان

من يملك رمز الوصول أو كلمة مرور MQTT يستطيع إرسال قراءات باسم هذا الجهاز. إعادة إنشاء رمز الوصول تسري فوراً؛ أما كلمة مرور MQTT فتُنشأ مرة واحدة ولا يمكن تغييرها من الواجهة، فتواصل مع دعم SensoCAN إذا لزم تغييرها.

إرسال أول قراءة

مواصفة الحمولة واحدة أياً كان البروتوكول الذي تستخدمه، وتجدها في اربط أجهزتك: اقرأ تلك الصفحة تالياً، ثم اتبع MQTT أو HTTP API.

ابدأ بطلب HTTP واحد

طلب HTTP يردّ عليك بما حدث لكل قراءة فيه، أما النشر عبر MQTT فلا يفعل ذلك. أرسل قراءة واحدة عبر HTTP أولاً واقرأ الاستجابة، ثم انتقل إلى MQTT إن كانت تلك وجهتك.

مراقبة وصولها

اترك صفحة الجهاز مفتوحة. عند معالجة أول رسالة:

• تتحول شارة حالة الجهاز إلى متصل، وتعرض الصفحة شارة مباشر ما دام التحديث في الوقت الفعلي متصلاً.
• يعرض آخر اتصال وقت وصول الرسالة، ويتجدد مع كل رسالة بعدها.
• في بطاقة المستشعرات، تظهر القيمة الحالية للمستشعر مع وحدتها، موسومة بشارة مباشر، إلى جانب آخر تحديث.

افتح المستشعر نفسه لترى الصورة كاملة: عدّاد، وشارة تبيّن إن كانت القيمة ضمن الحدود أو خارجها، وعلامات تبويب البيانات الحية والتاريخية والمجمعة.

بطاقة المستشعرات بعد وصول أول القراءات: صف مستشعر واحد يعرض اسمه ونوعه والقيمة الحالية مع وحدتها وشارة مباشر ووقت آخر تحديث.

إذا لم يظهر شيء

• تحقق من سلسلة القواعد أولاً. لا تُحفظ القراءات إلا إذا وصلت إلى خطوة حفظ في السلسلة المطبَّقة على الجهاز. تحذّرك بطاقة تعيينات سلسلة القواعد باللون الأحمر عندما لا تنطبق أي سلسلة أو تكون الافتراضية غير نشطة، ومع ذلك يظل برنامجك الثابت يتلقى ردّاً بأن قراءاته قُبلت. راجع سلاسل القواعد.
• تحقق من المستشعر الذي خاطبته. يجب أن يكون موجوداً على هذا الجهاز.
• تحقق من بيانات الاعتماد. إعادة إنشاء رمز الوصول تعني إعادة كتابة البرنامج الثابت على الجهاز.

وعندما تتوقف القراءات، يُوسم الجهاز بأنه غير متصل بعد أن يبقى صامتاً مدة أطول من مهلة انقطاع الاتصال المحددة له. يجري هذا الفحص كل بضع دقائق، فتوقّع تأخراً قصيراً.

إذا كانت لديك بوابة BLE

أنشئ الجهاز بفئة بوابة بدلاً من ذلك، فيظهر حقل إضافي لمعرّف العميل الذي ستتصل به. البوابة لا تقيس شيئاً بنفسها: تسجّل أنت المنارات التي تنقل قراءاتها، واحدة تلو الأخرى أو باستيراد ملف CSV، وينشئ SensoCAN المستشعرات التي تبلّغ عنها كل منارة. ويحمل مربع حوار بيانات اعتماد MQTT الخاص بها قيم التهيئة التي تُدخلها في بوابات BLE المدعومة. يشرح دليل البوابات والمنارات هذا المسار.

من يرى هذا الجهاز

الجهاز الذي أنشأته للتو يراه مالك المؤسسة وحده، ولا يراه أحد غيره حتى يُسنَد إلى أشخاص، مهما كان الدور الذي يحملونه. يشرح ذلك دعوة فريقك.