إنشاء جهاز لـ WebUSB

يمكنك تصميم جهاز لتحقيق الاستفادة الكاملة من WebUSB API.

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

الخلفية

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

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

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

أساسيات واجهة برمجة التطبيقات

وتتضمن العديد من فئات USB العادية واجهات برمجة تطبيقات Web API. على سبيل المثال، بإمكان الصفحة التقاط فيديو من جهاز لفصل الفيديو باستخدام getUserMedia() أو تلقّي أحداث الإدخال من جهاز فئة واجهة بشرية (HID) من خلال الاستماع أحداث KeyboardEvents أو PointerEvents أو باستخدام لوحة التحكّم أو WebHID API. وكما هو الحال في بعض الأجهزة، لا يتم تنفيذ تعريف موحّد للفئة، على أجهزة تنفيذ ميزات تتوافق مع واجهات برمجة تطبيقات النظام الأساسي للويب الحالية. فعندما يمكن لواجهة WebUSB API سد هذه الفجوة من خلال توفير وسيلة للمواقع للمطالبة بواجهة خاصة بالمورّد وتنفيذ الدعم لها من داخل صفحتهم.

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

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

يتكوّن واصف الإعدادات من عدة وسائل وصف متسلسلة. يبدأ كل منها بالحقلين bLength وbDescriptorType بحيث يمكن تحديدها. الواجهة الأولى هي واجهة HID لها واجهة واصف HID ونقطة نهاية واحدة تُستخدم لتسليم أحداث الإدخال إلى نظام التشغيل. أما الواجهة الثانية فهي واجهة مخصصة للبائع نقاط النهاية التي يمكن استخدامها لإرسال الأوامر إلى الجهاز وتلقي الردود في المقابل.

أدوات وصف WebUSB

يمكن استخدام WebUSB مع العديد من الأجهزة بدون إجراء تعديلات على البرامج الثابتة، تم تفعيل وظائف إضافية من خلال وضع علامة على الجهاز باستخدام واصفات تشير إلى دعم WebUSB. على سبيل المثال، يمكنك تحديد عنوان URL للصفحة المقصودة الذي يمكن للمتصفّح أن يوجِّه المستخدم إليه عندما يكون جهازك توصيله.

مخزن الكائنات الثنائية (BOS) هو مفهوم تم تقديمه في USB 3.0 ولكنه له أيضًا إلى أجهزة USB 2.0 كجزء من الإصدار 2.1. التعريف ليبدأ دعم WebUSB متضمنًا إمكانات النظام الأساسي التالية الواصف في واصف BOS:

معرّف المستخدم الفريد (UUID) لإمكانات النظام الأساسي يعتبر قدرة على النظام الأساسي WebUSB الذي يوفّر معلومات أساسية حول الجهاز. بالنسبة إلى المتصفّح لاسترجاع مزيد من المعلومات عن الجهاز الذي يستخدم قيمة bVendorCode وإصدار طلبات إضافية للجهاز. الطلب الوحيد المحدد حاليًا هو GET_URL التي تعرض واصف عنوان URL. هذه تشبه السلسلة واصفات البيانات لكنها مصممة لترميز عناوين URL بأقل عدد من وحدات البايت. عنوان URL واصف الدالة "https://google.com" على النحو التالي:

عندما يتم توصيل جهازك لأول مرة، يقرأ المتصفح واصف BOS من خلال إصدار عملية نقل التحكم العادية في GET_DESCRIPTOR:

يتم عادةً تقديم هذا الطلب مرّتين، أول مرة باستخدام wLength كبير بما يكفي بحيث يعرف المضيف قيمة الحقل wTotalLength بدون الالتزام بعملية نقل كبيرة ثم مرة أخرى عندما يكون البعد الكامل للواصف المعروفة.

إذا تم ضبط الحقل iLandingPage في واصف إمكانية النظام الأساسي WebUSB على قيمة غير صفرية، ثم ينفِّذ المتصفِّح طلب GET_URL الخاص بـ WebUSB من خلال إصدار نقل تحكّم مع ضبط bRequest على القيمة bVendorCode من واصف إمكانية النظام الأساسي وتم ضبط wValue على iLandingPage يدخل رمز الطلب الخاص بـ GET_URL (0x02) في wIndex:

ومرة أخرى، قد يتم إصدار هذا الطلب مرتين للتحقيق في الأمر للمرة الأولى. للواصف قيد القراءة.

الاعتبارات الخاصة بنظام التشغيل

تحاول واجهة برمجة تطبيقات WebUSB API توفير واجهة متسقة للوصول إلى. يجب أن يظل مطورو أجهزة USB على دراية بالمتطلبات المفروضة على تطبيقات مثل متطلبات متصفحات الويب للوصول إلى الأجهزة.

نظام التشغيل Mac

ما مِن إجراءات خاصة ضرورية لنظام التشغيل macOS. يمكن لموقع إلكتروني يستخدم WebUSB الاتصال بـ الجهاز والمطالبة بأي واجهات لم تتم المطالبة بها بواسطة برنامج تشغيل kernel أو لتطبيق آخر.

Linux

يشبه Linux نظام التشغيل macOS ولكن معظم التوزيعات لا تُعد إعدادًا للمستخدم بشكل تلقائي حسابات لديها إذن بفتح أجهزة USB. برنامج خفي للنظام يسمى udev عبارة عن المسئول عن تحديد المستخدم والمجموعة المسموح لهم بالوصول إلى الجهاز. قاعدة على هذا النحو إلى نقل ملكية جهاز يتوافق مع المورد المعني معرّفات المنتجات إلى مجموعة plugdev، وهي مجموعة مشترَكة للمستخدمين الذين لديهم إذن الوصول للأجهزة الملحقة:

SUBSYSTEM=="usb", ATTR{idVendor}=="XXXX", ATTR{idProduct}=="XXXX", GROUP="plugdev"

استبدل XXXX بمعرِّفات المنتجات والمورّدين السداسية العشرية لجهازك. مثلاً: سيكون ATTR{idVendor}=="18d1", ATTR{idProduct}=="4e11" مطابقًا لجهاز Nexus One هاتفك. يجب كتابتها بدون استخدام "0x" المعتاد البادئة وجميع الأحرف الصغيرة من أجل التعرف عليه بشكل صحيح. للعثور على معرفات جهازك، شغّل سطر الأوامر الأداة lsusb.

يجب وضع هذه القاعدة في ملف في دليل /etc/udev/rules.d و سيتم تفعيل هذه الميزة فور توصيل الجهاز بمصدر طاقة. لا داعي لإعادة التشغيل udev.

Android

يعتمد نظام Android الأساسي على Linux ولكنه لا يتطلب أي تعديل تهيئة النظام. بشكل تلقائي، أي جهاز لا يحتوي على برنامج تشغيل مدمج إلى نظام التشغيل متاحة للمتصفح. يجب أن يكون المطورين غير أن المستخدمين سيواجهون خطوة إضافية عند الاتصال الجهاز. بعد أن يختار أحد المستخدمين جهازًا استجابةً لمكالمة requestDevice()، سيعرض Android طلبًا يسألك ما إذا كنت تريد السماح بذلك Chrome للوصول إليها. يظهر هذا الطلب مرة أخرى أيضًا في حال عودة مستخدم إلى موقع إلكتروني. لديه إذن للاتصال بأحد الأجهزة ويجري مكالمات موقع الويب open()

بالإضافة إلى ذلك، سيُتاح الوصول إلى المزيد من الأجهزة على نظام التشغيل Android مقارنة بأجهزة الكمبيوتر التي تعمل بنظام Linux نظرًا لتضمين عدد أقل من برامج التشغيل بشكل افتراضي. يعد الحذف البارز، على سبيل المثال، هل فئة USB CDC-ACM التي يتم تنفيذها عادةً بواسطة محوّلات USB إلى تسلسلية؟ لا توجد واجهة برمجة تطبيقات في حزمة تطوير البرامج (SDK) لنظام التشغيل Android للاتصال بجهاز تسلسلي.

ChromeOS

يعتمد نظام التشغيل ChromeOS على نظام التشغيل Linux أيضًا ولا يتطلّب أي تعديل إلى تهيئة النظام. تتحكم خدمة إذن_بروكر في الوصول إلى جهاز USB Google وسيسمح للمتصفّح بالوصول إليها ما دام هناك واجهة واحدة لم تتم المطالبة بها.

Windows

يقدم طراز برنامج تشغيل Windows متطلبات إضافية. وعلى عكس الأنظمة الأساسية التي تفوق قدرتها على فتح جهاز USB من تطبيق مستخدم لا الافتراضي، حتى إذا لم يتم تحميل برنامج التشغيل. بدلاً من ذلك، هناك مخطط برنامج التشغيل، WinUSB، الذي يجب تحميله لتوفير الواجهة التطبيقات التي تستخدمها للوصول إلى الجهاز. يمكن القيام بذلك باستخدام إما نمط ملف معلومات برنامج التشغيل (INF) المثبّت على النظام أو عن طريق تعديل الجهاز البرامج الثابتة لتقديم أدوات وصف التوافق مع نظام التشغيل Microsoft أثناء التعداد.

ملف معلومات برنامج التشغيل (INF)

ملف معلومات برنامج التشغيل يخبر نظام Windows بما يجب فعله عند مواجهة جهاز لأول مرة. نظرًا لأن نظام المستخدم يتضمن برنامج تشغيل WinUSB بالفعل كل ما يلزم هو أن يربط ملف INF بمعرِّف المنتج باستخدام قاعدة التثبيت الجديدة هذه. الملف أدناه هو مثال أساسي. حفظه في بالامتداد .inf، غيِّر الأقسام التي تم وضع علامة "X" عليها، ثم على اليسار وانقر عليه واختر "تثبيت" من قائمة السياقات.

[Version]
Signature   = "$Windows NT$"
Class       = USBDevice
ClassGUID   = {88BAE032-5A81-49f0-BC3D-A4FF138216D6}
Provider    = %ManufacturerName%
CatalogFile = WinUSBInstallation.cat
DriverVer   = 09/04/2012,13.54.20.543

; ========== Manufacturer/Models sections ===========

[Manufacturer]
%ManufacturerName% = Standard,NTx86,NTia64,NTamd64

[Standard.NTx86]
%USB\MyCustomDevice.DeviceDesc% = USB_Install,USB\VID_XXXX&PID_XXXX

[Standard.NTia64]
%USB\MyCustomDevice.DeviceDesc% = USB_Install,USB\VID_XXXX&PID_XXXX

[Standard.NTamd64]
%USB\MyCustomDevice.DeviceDesc% = USB_Install,USB\VID_XXXX&PID_XXXX

; ========== Class definition ===========

[ClassInstall32]
AddReg = ClassInstall_AddReg

[ClassInstall_AddReg]
HKR,,,,%ClassName%
HKR,,NoInstallClass,,1
HKR,,IconPath,%REG_MULTI_SZ%,"%systemroot%\system32\setupapi.dll,-20"
HKR,,LowerLogoVersion,,5.2

; =================== Installation ===================

[USB_Install]
Include = winusb.inf
Needs   = WINUSB.NT

[USB_Install.Services]
Include = winusb.inf
Needs   = WINUSB.NT.Services

[USB_Install.HW]
AddReg = Dev_AddReg

[Dev_AddReg]
HKR,,DeviceInterfaceGUIDs,0x10000,"{XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX}"

; =================== Strings ===================

[Strings]
ManufacturerName              = "Your Company Name Here"
ClassName                     = "Your Company Devices"
USB\MyCustomDevice.DeviceDesc = "Your Device Name Here"

يضبط القسم [Dev_AddReg] مجموعة DeviceInterfaceGUIDs الخاص بك. يجب أن تتضمن كل واجهة جهاز معرف GUID حتى يمكن للتطبيق العثور عليها والاتصال بها من خلال واجهة برمجة تطبيقات Windows. استخدام New-Guid PowerShell cmdlet أو أداة على الإنترنت لإنشاء معرّف فريد عالمي (GUID) عشوائي.

لأغراض التطوير، توفر أداة Zadig واجهة سهلة استبدال برنامج التشغيل المحمّل لواجهة USB ببرنامج تشغيل WinUSB.

أدوات وصف التوافق مع نظام التشغيل Microsoft

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

بعد إعداد أدوات وصف WebUSB، يمكنك بسهولة إضافة نظام تشغيل Microsoft واصفات التوافق أيضًا. عليك أولاً توسيع واصف BOS باستخدام هذا واصف إمكانية النظام الأساسي الإضافي. يجب تحديث "wTotalLength" وbNumDeviceCaps لحساب ذلك.

وكما هي الحال مع أدوات وصف WebUSB، عليك اختيار قيمة bRequest لتستخدمها. التحكم في عمليات النقل المتعلقة بهذه الأوصاف. في هذا المثال، اخترت 0x02 0x07، الذي تم وضعه في wIndex، هو الأمر لاسترداد نظام التشغيل Microsoft 2.0 الواصف تم ضبطه من الجهاز.

يمكن أن يكون لجهاز USB عدة وظائف، وبالتالي فإن الجزء الأول من الواصف مجموعة تصف الوظيفة المرتبطة بالخصائص التالية. تشير رسالة الأشكال البيانية في المثال أدناه تهيئ الواجهة 1 للجهاز المركب. يعطي الواصف نظام التشغيل اثنين من المعلومات المهمة حول هذه الواجهة. النموذج المتوافق يخبر واصف المعرّف نظام التشغيل Windows بأنّ هذا الجهاز متوافق مع WinUSB السائق. يعمل واصف ملكية السجل بشكل مشابه القسم [Dev_AddReg] من مثال INF أعلاه، ضبط موقع إلكتروني في قاعدة بيانات المسجّلين على عيِّن لهذه الدالة معرف GUID لواجهة الجهاز.

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

للحصول على مزيد من المعلومات، يمكنك الاطّلاع على مشاركة مدونة Microsoft حول كيفية استخدام هذه واصفات البيانات.

أمثلة

مثال على رمز برمجي ينفِّذ أجهزة متوافقة مع WebUSB والتي تتضمّن كلاً من WebUSB يمكن العثور على واصفات البيانات واصفات Microsoft OS في المشاريع التالية:

• WebLight
• مكتبة WebUSB Arduino