ملاحظات في تصميم بروتوكولات الأجهزة عبر BLE وUSB
باختصار: دوّنوا بروتوكول الجهاز قبل بناء أي من الطرفين: الربط بوسيلة النقل، وصيغة الإطار، وأنواع الرسائل، والإصدارات، ورموز الأخطاء، ومهل الانتظار. أبقوا بروتوكول التطبيق مستقلًا عن BLE أو USB حتى يمكن اختباره عبر كبل تسلسلي. وجود مواصفة مشتركة وأداة اختبار على جهة المضيف يتيح لفريقَي البرامج الثابتة والتطبيق العمل بالتوازي واكتشاف نقاط الخلاف مبكرًا.
1.0 أين تتعثر بروتوكولات الأجهزة
معظم مشكلات البروتوكولات لا تتعلق بـ BLE أو USB في حد ذاتهما، بل بواجهة لم تُدوَّن قط. يختار مهندس البرامج الثابتة ترتيبًا للبايتات، ويستنتجه مطوّر التطبيق من سجل، ثم يتباعد الطرفان. وبحلول الإصدار الثاني من البرامج الثابتة لا يعرف أحد أي الطرفين على صواب، ويعطّل تحديثٌ إصدار التطبيق المنشور أصلًا في المتجر، ويتطلب الإصلاح إصدارًا منسقًا على الجانبين.
تغطي المواصفة وسائل النقل والإطار وجدول الرسائل وجدول الأخطاء ومهل الانتظار. اكتبوها قبل أول التقاط بأداة التنصت (sniffer)، لا بعده.
2.0 الطبقات
نقسّم البروتوكول إلى طبقات ليُختبر كل منها على حدة:
| الطبقة | المسؤولية | تتغير عندما |
|---|---|---|
| النقل | نقل البايتات: خصائص BLE GATT، وUSB CDC-ACM، وتقارير USB HID، وUART | يتغير العتاد أو نظام التشغيل |
| التأطير | حدود الرسائل، والطول، وفحص السلامة، والرقم التسلسلي | نادرًا |
| الرسائل | أنواع الأوامر والاستجابات، وترميز الحمولة، ورموز الأخطاء | تُضاف ميزات جديدة |
| التطبيق | ما يفعله الجهاز بالأمر | يتغير سلوك المنتج |
ينبغي ألا تعرف طبقتا التأطير والرسائل وسيلة النقل التي تحتهما. بذلك يمكن تشغيل البروتوكول نفسه عبر UART على منضدة العمل، وعبر محوّل USB إلى تسلسلي في اختبار الإنتاج، وعبر BLE في المنتج.
3.0 اختيار وسيلة النقل
| الحاجة | BLE | USB 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 الإصدارات والتوافق
دوّنوا قاعدة التوافق. قاعدتنا:
- يُبلغ الجهاز عن إصدار البروتوكول وأعلام الميزات ردًا على أمر “hello” أو “get info”، وشكل هذا الأمر لا يتغير أبدًا.
- تُضاف الحقول الجديدة اختيارية، ويتجاهل القارئ الحقول التي لا يفهمها.
- حذف حقل أو تغيير معناه يتطلب إصدارًا رئيسيًا جديدًا، ويواصل التطبيق دعم الإصدار الرئيسي السابق لمدة موثّقة.
- تذكر ملاحظات إصدار البرامج الثابتة والتطبيق إصدارات البروتوكول المدعومة.
6.0 الأخطاء ومهل الانتظار والحالة
لكل أمر استجابة واحدة بالضبط: نجاح مع بيانات، أو رمز خطأ من جدول موثّق. أصناف الأخطاء المعتادة: إطار تالف، وأمر غير معروف، ومعامل غير صالح، ومشغول، وغير مسموح في الحالة الراهنة، وعطل داخلي. مكان الجدول في المواصفة، لا في الشيفرة وحدها.
ومهل الانتظار جزء من البروتوكول أيضًا. حدّدوا أقصى زمن استجابة لكل صنف من الأوامر، وما يفعله المضيف عند انقضاء المهلة (إعادة المحاولة بالرقم التسلسلي نفسه أو التوقف)، والمدة التي ينتظرها الجهاز بقية رسالة متعددة الأجزاء قبل أن يتخلص منها.
أما العمليات الطويلة، مثل تحديث البرامج الثابتة أو المعايرة، فينبغي أن تردّ فورًا بـ “مقبول” ثم تُبلغ عن التقدم في صورة أحداث، بدل حجز الاستجابة.
7.0 اعتبارات الأمان
يحمي الاقتران والربط (bonding) في BLE الوصلة، لكنهما لا يحددان ما يُسمح للطرف المصادَق عليه بفعله. اسردوا الأوامر التي تغيّر الحالة، والأوامر التي تحتاج إلى جلسة مخوّلة، والأوامر التي يمكن إتاحتها بأمان لأي مضيف متصل. وينبغي تعطيل أوامر المصنع وتصحيح الأخطاء أو قفلها في البرامج الثابتة للإنتاج، وأن تذكر المواصفة كيف يتم ذلك.
8.0 أداة الاختبار
نكتب أداة صغيرة على جهة المضيف، بلغة Python ما لم يفرض المشروع غيرها، تتحدث البروتوكول عبر منفذ تسلسلي. ولها ثلاث وظائف: تتيح لمهندس البرامج الثابتة تجربة الأوامر قبل وجود أي تطبيق، وتشغّل اختبارات انحدار مؤتمتة في CI على لوحة فوق منضدة العمل، وتمنح فريق التطبيق تنفيذًا مرجعيًا للمقارنة. ومن خلال اختبار محلل الإطارات بمدخلات تالفة (fuzzing) بالأداة نفسها، يمكن كشف فئة من الأعطال لا يصل إليها الاستخدام العادي أبدًا.
9.0 التسليم
- مواصفة البروتوكول: وسائل النقل، والإطار، وجدول الرسائل، وجدول الأخطاء، ومهل الانتظار، وقواعد الإصدارات.
- جدول GATT أو واصفات USB.
- أداة اختبار المضيف ونصوصها البرمجية.
- جلسة نموذجية ملتقطة لكل أمر.
تصف صفحة البرامج الثابتة المدمجة جانب الجهاز من هذا العمل، وتتناول صفحة الويب والسحابة وإدارة الأجهزة التطبيقات والأنظمة الخلفية التي تتواصل مع الأجهزة. ولمراجعة بروتوكول قائم، ابدؤوا من نموذج حدثونا عن مشروعكم.
المراجع
- Bluetooth Core Specification: https://www.bluetooth.com/specifications/specs/core-specification/
- Bluetooth Assigned Numbers: https://www.bluetooth.com/specifications/assigned-numbers/
- USB Class Definitions for Communication Devices 1.2: https://www.usb.org/document-library/class-definitions-communication-devices-12
- USB Device Class Definition for HID: https://www.usb.org/hid
الأسئلة الشائعة
هل نستخدم ملف تعريف BLE قياسيًا أم خدمة مخصصة؟
استخدموا الخدمة القياسية حين تناسب البيانات، مثل Battery أو Device Information، لأن الأدوات العامة وأنظمة التشغيل تفهمها. أما الميزات الخاصة بالمنتج فتحتاج إلى خدمة مخصصة. وخدمة واحدة على شكل قناة رسائل تُبقي هذا الجزء المخصص ثابتًا مع إضافة الميزات.
أي ترميز نختار للحمولة؟
اختاروا وفق ميزانية الذاكرة الوميضية وذاكرة RAM في الجهاز، ووفق عدد مرات تغيّر البروتوكول المتوقع. البنى الثابتة تناسب مجموعات الأوامر الصغيرة المستقرة. أما TLV أو CBOR فتكلّف شيفرة أكثر، لكنها تتيح إضافة حقول دون تعطيل التطبيقات الأقدم.
كيف تظل التطبيقات القديمة تعمل بعد تحديث البرامج الثابتة؟
اجعلوا أمر الاستعلام عن الإصدار ثابتًا لا يتغير، وأضيفوا الحقول اختيارية، واجعلوا القارئ يتجاهل الحقول غير المعروفة. التغييرات الكاسرة للتوافق تذهب إلى إصدار رئيسي جديد، ويُدعم الإصدار القديم لمدة تُدوَّن في ملاحظات الإصدار لدى الطرفين.
هل يمكن تشغيل البروتوكول نفسه عبر BLE وUSB؟
لهذا السبب تحديدًا نُبقي التأطير والرسائل مستقلة عن وسيلة النقل. لا يتغير إلا محوّل النقل. ويتيح ذلك أيضًا أن تستخدم أدوات اختبار المصنع والاستعادة كبلًا بينما يستخدم تطبيق المنتج BLE.
متى يُكتب البروتوكول؟
قبل أن يبدأ العمل الفعلي على البرامج الثابتة والتطبيق. يمكن أن تكون المسودة الأولى قصيرة: وسائل النقل، والإطار، وخمسة أو ستة أوامر، وجدول الأخطاء. بعدها تتغير عبر المراجعة لا عبر تصحيح الأخطاء.