ملاحظات في تصميم بروتوكولات الأجهزة عبر BLE وUSB

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

مخطط طبقات لبروتوكول جهاز: يتواصل تطبيق الهاتف أو الحاسوب عبر مكتبة البروتوكول مع محوّل نقل لـ BLE GATT أو USB CDC أو HID، يصل إلى مشغّل النقل في الجهاز، ثم محلل الإطارات، ثم موزّع الأوامر، ثم تطبيق الجهاز. وتتصل أداة اختبار المضيف عند طبقة الإطار.
الشكل 1. طبقات البروتوكول. وسيلة النقل تتغير، أما طبقتا الإطار والرسائل فلا.

1.0 أين تتعثر بروتوكولات الأجهزة

معظم مشكلات البروتوكولات لا تتعلق بـ BLE أو USB في حد ذاتهما، بل بواجهة لم تُدوَّن قط. يختار مهندس البرامج الثابتة ترتيبًا للبايتات، ويستنتجه مطوّر التطبيق من سجل، ثم يتباعد الطرفان. وبحلول الإصدار الثاني من البرامج الثابتة لا يعرف أحد أي الطرفين على صواب، ويعطّل تحديثٌ إصدار التطبيق المنشور أصلًا في المتجر، ويتطلب الإصلاح إصدارًا منسقًا على الجانبين.

تغطي المواصفة وسائل النقل والإطار وجدول الرسائل وجدول الأخطاء ومهل الانتظار. اكتبوها قبل أول التقاط بأداة التنصت (sniffer)، لا بعده.

2.0 الطبقات

نقسّم البروتوكول إلى طبقات ليُختبر كل منها على حدة:

الطبقةالمسؤوليةتتغير عندما
النقلنقل البايتات: خصائص BLE GATT، وUSB CDC-ACM، وتقارير USB HID، وUARTيتغير العتاد أو نظام التشغيل
التأطيرحدود الرسائل، والطول، وفحص السلامة، والرقم التسلسلينادرًا
الرسائلأنواع الأوامر والاستجابات، وترميز الحمولة، ورموز الأخطاءتُضاف ميزات جديدة
التطبيقما يفعله الجهاز بالأمريتغير سلوك المنتج

ينبغي ألا تعرف طبقتا التأطير والرسائل وسيلة النقل التي تحتهما. بذلك يمكن تشغيل البروتوكول نفسه عبر UART على منضدة العمل، وعبر محوّل USB إلى تسلسلي في اختبار الإنتاج، وعبر BLE في المنتج.

3.0 اختيار وسيلة النقل

الحاجةBLEUSB CDC-ACM (منفذ تسلسلي افتراضي)USB HID
اتصال لاسلكي بالهاتفملائم بطبيعتهلا ينطبقلا ينطبق
دون مشغّل على أنظمة سطح المكتبيحتاج إلى حزمة بلوتوث النظاممشغّل مدمج في Windows 10 وما بعده وmacOS وLinuxدون مشغّل
الوصول من المتصفحWeb Bluetooth حيث يتوفر الدعمWeb Serial حيث يتوفر الدعمWebHID حيث يتوفر الدعم
معدل النقلمحدود بفاصل الاتصال وMTUأعلىمحدود بحجم التقرير والاستطلاع
الطاقةمصمَّم للاستهلاك المنخفضيمكن للجهاز سحب الطاقة من الناقل أثناء الاتصالمثل CDC

يختلف دعم Web Bluetooth وWeb Serial وWebHID باختلاف المتصفح والمنصة، فتحققوا من الدعم الحالي في متصفحات مستخدميكم قبل الاعتماد عليها. وكثير من المنتجات تستخدم الاثنين: BLE لتطبيق الهاتف، وUSB للإعداد واختبار المصنع والاستعادة.

3.1 الربط بـ BLE GATT

نهجان شائعان:

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

حين يعرض الجهاز أكثر من بضع قيم نستخدم قناة رسائل، ونُبقي الخدمات القياسية (Device Information وBattery) خصائص مستقلة كي تظل الأدوات العامة تعمل. تحتاج الخدمات المخصصة إلى معرّفات UUID بطول 128 بت، أما القياسية فمدرجة في قائمة الأرقام المخصصة لدى Bluetooth SIG.

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

3.2 الربط بـ USB

يظهر CDC-ACM للمضيف منفذًا تسلسليًا، ويناسب بروتوكول تدفق بايتات مع تأطير. أما HID فيقدّم تقارير ثابتة الحجم ويعمل دون مشغّلات، وهذا مفيد على حواسيب الشركات المقيّدة، وفي هذه الحالة تقسّم طبقة التأطير الرسائل على عدة تقارير. وتنشر USB-IF مواصفتَي الفئتين.

4.0 الإطار

صيغة الإطار التي نبدأ منها:

الحقلالحجمملاحظات
علامة البداية أو بادئة الطول1–2 بايتبادئة طول على BLE/HID، وتحديد على نمط COBS أو SLIP في تدفقات البايتات
إصدار البروتوكول1 بايتالإصدار الرئيسي لصيغة الإطار
الرقم التسلسلي1–2 بايتيطابق الاستجابات بالطلبات ويكشف الفقد
نوع الرسالة1–2 بايتأمر، استجابة، حدث، خطأ
طول الحمولة2 بايتصريح، حتى لو كان لوسيلة النقل طولها الخاص
الحمولةمتغيريُختار الترميز لكل مشروع (بنى ثابتة، TLV، CBOR، protobuf)
فحص السلامة2–4 بايتCRC في تدفقات البايتات، ويمكن حذفه حيث تفحص وسيلة النقل أصلًا

ترميز الحمولة موازنة بين حجم الشيفرة على الجهاز والمرونة. البنى الثابتة بترتيب little-endian هي الأصغر والأصعب تطويرًا. أما TLV أو CBOR فتتيح إضافة حقول اختيارية دون تعطيل القرّاء القدامى.

5.0 الإصدارات والتوافق

دوّنوا قاعدة التوافق. قاعدتنا:

  1. يُبلغ الجهاز عن إصدار البروتوكول وأعلام الميزات ردًا على أمر “hello” أو “get info”، وشكل هذا الأمر لا يتغير أبدًا.
  2. تُضاف الحقول الجديدة اختيارية، ويتجاهل القارئ الحقول التي لا يفهمها.
  3. حذف حقل أو تغيير معناه يتطلب إصدارًا رئيسيًا جديدًا، ويواصل التطبيق دعم الإصدار الرئيسي السابق لمدة موثّقة.
  4. تذكر ملاحظات إصدار البرامج الثابتة والتطبيق إصدارات البروتوكول المدعومة.

6.0 الأخطاء ومهل الانتظار والحالة

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

ومهل الانتظار جزء من البروتوكول أيضًا. حدّدوا أقصى زمن استجابة لكل صنف من الأوامر، وما يفعله المضيف عند انقضاء المهلة (إعادة المحاولة بالرقم التسلسلي نفسه أو التوقف)، والمدة التي ينتظرها الجهاز بقية رسالة متعددة الأجزاء قبل أن يتخلص منها.

أما العمليات الطويلة، مثل تحديث البرامج الثابتة أو المعايرة، فينبغي أن تردّ فورًا بـ “مقبول” ثم تُبلغ عن التقدم في صورة أحداث، بدل حجز الاستجابة.

7.0 اعتبارات الأمان

يحمي الاقتران والربط (bonding) في BLE الوصلة، لكنهما لا يحددان ما يُسمح للطرف المصادَق عليه بفعله. اسردوا الأوامر التي تغيّر الحالة، والأوامر التي تحتاج إلى جلسة مخوّلة، والأوامر التي يمكن إتاحتها بأمان لأي مضيف متصل. وينبغي تعطيل أوامر المصنع وتصحيح الأخطاء أو قفلها في البرامج الثابتة للإنتاج، وأن تذكر المواصفة كيف يتم ذلك.

8.0 أداة الاختبار

نكتب أداة صغيرة على جهة المضيف، بلغة Python ما لم يفرض المشروع غيرها، تتحدث البروتوكول عبر منفذ تسلسلي. ولها ثلاث وظائف: تتيح لمهندس البرامج الثابتة تجربة الأوامر قبل وجود أي تطبيق، وتشغّل اختبارات انحدار مؤتمتة في CI على لوحة فوق منضدة العمل، وتمنح فريق التطبيق تنفيذًا مرجعيًا للمقارنة. ومن خلال اختبار محلل الإطارات بمدخلات تالفة (fuzzing) بالأداة نفسها، يمكن كشف فئة من الأعطال لا يصل إليها الاستخدام العادي أبدًا.

9.0 التسليم

  • مواصفة البروتوكول: وسائل النقل، والإطار، وجدول الرسائل، وجدول الأخطاء، ومهل الانتظار، وقواعد الإصدارات.
  • جدول GATT أو واصفات USB.
  • أداة اختبار المضيف ونصوصها البرمجية.
  • جلسة نموذجية ملتقطة لكل أمر.

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

المراجع

الأسئلة الشائعة

هل نستخدم ملف تعريف BLE قياسيًا أم خدمة مخصصة؟

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

أي ترميز نختار للحمولة؟

اختاروا وفق ميزانية الذاكرة الوميضية وذاكرة RAM في الجهاز، ووفق عدد مرات تغيّر البروتوكول المتوقع. البنى الثابتة تناسب مجموعات الأوامر الصغيرة المستقرة. أما TLV أو CBOR فتكلّف شيفرة أكثر، لكنها تتيح إضافة حقول دون تعطيل التطبيقات الأقدم.

كيف تظل التطبيقات القديمة تعمل بعد تحديث البرامج الثابتة؟

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

هل يمكن تشغيل البروتوكول نفسه عبر BLE وUSB؟

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

متى يُكتب البروتوكول؟

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