WebUSB के लिए डिवाइस बनाना

WebUSB API का पूरा फ़ायदा पाने के लिए, कोई डिवाइस बनाएं.

Reilly Grant

इस लेख में, WebUSB API का पूरा फ़ायदा पाने के लिए, डिवाइस बनाने का तरीका बताया गया है. एपीआई के बारे में खास जानकारी पाने के लिए, वेब पर यूएसबी डिवाइसों को ऐक्सेस करना लेख पढ़ें.

बैकग्राउंड

यूनिवर्सल सीरियल बस (यूएसबी), सहायक डिवाइसों (जैसे, कीबोर्ड, माउस, मॉनिटर, वेबकैम वगैरह) को डेस्कटॉप और मोबाइल कंप्यूटिंग डिवाइसों से जोड़ने का सबसे आम इंटरफ़ेस बन गया है. यूएसबी की खास बातों में, बस की इलेक्ट्रिकल विशेषताओं और किसी डिवाइस के साथ कम्यूनिकेट करने के लिए सामान्य मॉडल के साथ-साथ, डिवाइस क्लास की खास बातों का एक सेट भी शामिल होता है. ये डिवाइस के खास क्लास के लिए सामान्य मॉडल हैं, जैसे कि स्टोरेज, ऑडियो, वीडियो, नेटवर्किंग वगैरह. इन्हें डिवाइस मैन्युफ़ैक्चरर लागू कर सकते हैं. डिवाइस क्लास की इन खास बातों का फ़ायदा यह है कि ऑपरेटिंग सिस्टम का कोई वेंडर, क्लास की खास बातों (एक "क्लास ड्राइवर") के आधार पर एक ड्राइवर लागू कर सकता है. साथ ही, उस क्लास को लागू करने वाले किसी भी डिवाइस पर काम करेगा. यह एक बेहतरीन बदलाव था, क्योंकि इससे हर मैन्युफ़ैक्चरर को अपने डिवाइस के लिए ड्राइवर लिखने की ज़रूरत नहीं पड़ती थी.

हालांकि, कुछ डिवाइस इनमें से किसी डिवाइस क्लास में नहीं आते. इसके बजाय, मैन्युफ़ैक्चरर अपने डिवाइस को वेंडर से जुड़ी क्लास लागू करने के लिए लेबल कर सकता है. इस मामले में, ऑपरेटिंग सिस्टम यह चुनता है कि किस डिवाइस ड्राइवर को लोड करना है. यह विकल्प, वेंडर के ड्राइवर पैकेज में दी गई जानकारी के आधार पर चुना जाता है. आम तौर पर, यह वेंडर और प्रॉडक्ट आईडी का एक सेट होता है. इन आईडी से, वेंडर के हिसाब से प्रोटोकॉल लागू करने में मदद मिलती है.

यूएसबी की एक और सुविधा यह है कि डिवाइस अपने कनेक्ट किए गए होस्ट को कई इंटरफ़ेस दे सकते हैं. हर इंटरफ़ेस, स्टैंडर्ड क्लास या वेंडर-स्पेसिफ़िक क्लास में से किसी एक को लागू कर सकता है. जब कोई ऑपरेटिंग सिस्टम, डिवाइस को मैनेज करने के लिए सही ड्राइवर चुनता है, तो हर इंटरफ़ेस पर किसी अलग ड्राइवर का दावा किया जा सकता है. उदाहरण के लिए, यूएसबी वेबकैम आम तौर पर दो इंटरफ़ेस उपलब्ध कराता है. पहला, कैमरे के लिए यूएसबी वीडियो क्लास और दूसरा, माइक्रोफ़ोन के लिए यूएसबी ऑडियो क्लास. ऑपरेटिंग सिस्टम, एक "वेबकैम ड्राइवर" नहीं लोड करता, बल्कि अलग-अलग वीडियो और ऑडियो क्लास के ड्राइवर लोड करता है. ये ड्राइवर, डिवाइस के अलग-अलग फ़ंक्शन की ज़िम्मेदारी लेते हैं. इंटरफ़ेस क्लास का यह कॉम्पोज़िशन, ज़्यादा सुविधाएं देता है.

एपीआई के बारे में बुनियादी जानकारी

कई स्टैंडर्ड यूएसबी क्लास के लिए, वेब एपीआई उपलब्ध होते हैं. उदाहरण के लिए, कोई पेज getUserMedia() का इस्तेमाल करके, वीडियो क्लास डिवाइस से वीडियो कैप्चर कर सकता है. इसके अलावा, KeyboardEvents या PointerEvents को सुनकर या Gamepad या WebHID एपीआई का इस्तेमाल करके, किसी मानव इंटरफ़ेस (एचआईडी) क्लास डिवाइस से इनपुट इवेंट भी पा सकता है. जिस तरह सभी डिवाइसों पर स्टैंडर्ड क्लास की परिभाषा लागू नहीं होती, उसी तरह सभी डिवाइसों पर वे सुविधाएं भी लागू नहीं होतीं जो मौजूदा वेब प्लैटफ़ॉर्म एपीआई से जुड़ी होती हैं. ऐसे में, WebUSB API इस अंतर को भर सकता है. इसके लिए, यह साइटों को वेंडर के हिसाब से इंटरफ़ेस पर दावा करने का तरीका उपलब्ध कराता है. साथ ही, साइटों को अपने पेज से सीधे तौर पर इसकी सहायता लागू करने की सुविधा देता है.

किसी डिवाइस को WebUSB के ज़रिए ऐक्सेस करने के लिए, अलग-अलग प्लैटफ़ॉर्म पर अलग-अलग ज़रूरी शर्तें होती हैं. इसकी वजह यह है कि ऑपरेटिंग सिस्टम, यूएसबी डिवाइसों को अलग-अलग तरीके से मैनेज करते हैं. हालांकि, बुनियादी तौर पर यह ज़रूरी है कि डिवाइस में पहले से ही उस इंटरफ़ेस के लिए ड्राइवर मौजूद न हो जिसे पेज को कंट्रोल करना है. यह ओएस वेंडर से मिला सामान्य क्लास ड्राइवर हो सकता है या वेंडर से मिला डिवाइस ड्राइवर हो सकता है. यूएसबी डिवाइस में कई इंटरफ़ेस हो सकते हैं और हर इंटरफ़ेस का अपना ड्राइवर हो सकता है. इसलिए, ऐसा डिवाइस बनाया जा सकता है जिसके लिए कुछ इंटरफ़ेस पर ड्राइवर ने दावा किया हो और कुछ पर ब्राउज़र से ऐक्सेस किया जा सकता हो.

उदाहरण के लिए, कोई हाई-एंड यूएसबी कीबोर्ड, एचआईडी क्लास इंटरफ़ेस दे सकता है. इस पर ऑपरेटिंग सिस्टम का इनपुट सबसिस्टम दावा करेगा. साथ ही, वेंडर के हिसाब से एक इंटरफ़ेस भी होगा, जो कॉन्फ़िगरेशन टूल के इस्तेमाल के लिए WebUSB के लिए उपलब्ध रहेगा. इस टूल को मैन्युफ़ैक्चरर की वेबसाइट पर उपलब्ध कराया जा सकता है. इससे उपयोगकर्ता, प्लैटफ़ॉर्म के हिसाब से किसी भी सॉफ़्टवेयर को इंस्टॉल किए बिना, डिवाइस के काम करने के तरीके में बदलाव कर सकता है. जैसे, मैक्रो बटन और लाइटिंग इफ़ेक्ट. ऐसे डिवाइस का कॉन्फ़िगरेशन डिस्क्रिप्टर कुछ ऐसा दिखेगा:

कॉन्फ़िगरेशन डिस्क्रिप्टर में कई डिस्क्रिप्टर होते हैं. इन्हें एक साथ जोड़ा जाता है. हर फ़ील्ड bLength और bDescriptorType फ़ील्ड से शुरू होता है, ताकि उन्हें पहचाना जा सके. पहला इंटरफ़ेस एक एचआईडी इंटरफ़ेस है, जिसमें एचआईडी डिस्क्रिप्टर और एक एंडपॉइंट होता है. इसका इस्तेमाल ऑपरेटिंग सिस्टम में इनपुट इवेंट भेजने के लिए किया जाता है. दूसरा इंटरफ़ेस, वेंडर के हिसाब से बनाया गया इंटरफ़ेस होता है. इसमें दो एंडपॉइंट होते हैं. इनका इस्तेमाल, डिवाइस को निर्देश भेजने और जवाब पाने के लिए किया जा सकता है.

WebUSB डिस्क्रिप्टर

WebUSB, फ़र्मवेयर में बदलाव किए बिना कई डिवाइसों के साथ काम कर सकता है. हालांकि, डिवाइस को खास डिस्क्रिप्टर के साथ मार्क करके, अतिरिक्त सुविधाएं चालू की जा सकती हैं. इससे, WebUSB के साथ काम करने की जानकारी मिलती है. उदाहरण के लिए, आपके पास लैंडिंग पेज का ऐसा यूआरएल तय करने का विकल्प होता है जिस पर ब्राउज़र, डिवाइस के प्लग इन होने पर उपयोगकर्ता को भेज सकता है.

बाइनरी डिवाइस ऑब्जेक्ट स्टोर (बीओएस) एक ऐसा कॉन्सेप्ट है जिसे यूएसबी 3.0 में पेश किया गया था. हालांकि, इसे वर्शन 2.1 के हिस्से के तौर पर, यूएसबी 2.0 डिवाइसों में भी बैकपोर्ट किया गया है. WebUSB के साथ काम करने की सुविधा का एलान करने के लिए, BOS डिस्क्रिप्टर में प्लैटफ़ॉर्म की क्षमता का यह डिस्क्रिप्टर शामिल करें:

प्लैटफ़ॉर्म की क्षमता वाले यूयूआईडी से, इसे WebUSB प्लैटफ़ॉर्म की क्षमता के बारे में जानकारी देने वाले एलिमेंट के तौर पर पहचाना जाता है. इससे, डिवाइस के बारे में बुनियादी जानकारी मिलती है. ब्राउज़र को डिवाइस के बारे में ज़्यादा जानकारी फ़ेच करने के लिए, bVendorCode वैल्यू का इस्तेमाल करके डिवाइस के लिए दूसरे अनुरोध जारी किए जाते हैं. फ़िलहाल, सिर्फ़ एक अनुरोध तय किया गया है, वह है GET_URL, जो यूआरएल डिस्क्रिप्टर दिखाता है. ये स्ट्रिंग डिस्क्रिप्टर से मिलते-जुलते हैं, लेकिन इन्हें यूआरएल को कम से कम बाइट में एन्कोड करने के लिए डिज़ाइन किया गया है. "https://google.com" का यूआरएल डिस्क्रिप्टर ऐसा दिखेगा:

जब आपका डिवाइस पहली बार ब्राउज़र में प्लग इन किया जाता है, तो यह स्टैंडर्ड GET_DESCRIPTOR कंट्रोल ट्रांसफ़र जारी करके, BOS डिस्क्रिप्टर को पढ़ता है:

यह अनुरोध आम तौर पर दो बार किया जाता है. पहली बार में ज़रूरत के मुताबिक wLength है, ताकि होस्ट बड़े ट्रांसफ़र के बिना, wTotalLength फ़ील्ड की वैल्यू का पता लगा सके. इसके बाद, डिस्क्रिप्टर की पूरी लंबाई पता होने पर, यह फिर से अनुरोध करता है.

अगर WebUSB प्लैटफ़ॉर्म की क्षमता के ब्यौरे में iLandingPage फ़ील्ड को शून्य से ज़्यादा वैल्यू पर सेट किया गया है, तो ब्राउज़र WebUSB के लिए खास GET_URL अनुरोध करता है. इसके लिए, वह प्लैटफ़ॉर्म की क्षमता के ब्यौरे से bVendorCode वैल्यू पर सेट किए गए bRequest और iLandingPage वैल्यू पर सेट किए गए wValue के साथ कंट्रोल ट्रांसफ़र जारी करता है. GET_URL (0x02) के लिए अनुरोध कोड, wIndex में जाता है:

एक बार फिर, यह अनुरोध दो बार जारी किया जा सकता है, ताकि सबसे पहले यह जांच की जा सके कि डिस्क्रिप्टर की लंबाई कितनी है.

प्लैटफ़ॉर्म के हिसाब से ध्यान रखने वाली बातें

WebUSB API, यूएसबी डिवाइसों को ऐक्सेस करने के लिए एक जैसा इंटरफ़ेस उपलब्ध कराने की कोशिश करता है. हालांकि, डेवलपर को ऐप्लिकेशन पर लागू होने वाली ज़रूरी शर्तों के बारे में पता होना चाहिए. जैसे, डिवाइसों को ऐक्सेस करने के लिए वेब ब्राउज़र की ज़रूरी शर्तें.

macOS

macOS के लिए, कुछ खास करने की ज़रूरत नहीं है. WebUSB का इस्तेमाल करने वाली वेबसाइट, डिवाइस से कनेक्ट कर सकती है. साथ ही, ऐसे इंटरफ़ेस पर दावा कर सकती है जिन पर कर्नेल ड्राइवर या दूसरे ऐप्लिकेशन ने दावा न किया हो.

Linux

Linux, macOS की तरह ही है. हालांकि, ज़्यादातर डिस्ट्रिब्यूशन में डिफ़ॉल्ट रूप से, उपयोगकर्ता खातों को यूएसबी डिवाइसों को खोलने की अनुमति नहीं दी जाती. 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 के मुकाबले ज़्यादा डिवाइस ऐक्सेस किए जा सकेंगे, क्योंकि डिफ़ॉल्ट रूप से कम ड्राइवर शामिल होते हैं. एक अहम चूक, जैसे कि यूएसबी सीडीसी-एसीएम क्लास आम तौर पर यूएसबी-टू-सीरियल अडैप्टर से लागू की जाती है, क्योंकि Android SDK में सीरियल डिवाइस से संपर्क करने के लिए कोई एपीआई नहीं होता.

ChromeOS

ChromeOS भी Linux पर आधारित है. साथ ही, इसके लिए सिस्टम कॉन्फ़िगरेशन में किसी तरह का बदलाव करने की ज़रूरत नहीं होती. permission_broker सेवा, यूएसबी डिवाइसों के ऐक्सेस को कंट्रोल करती है. साथ ही, जब तक कम से कम एक ऐसा इंटरफ़ेस मौजूद रहेगा जिस पर दावा नहीं किया गया है, तब तक ब्राउज़र को इन डिवाइसों को ऐक्सेस करने की अनुमति देगी.

Windows

Windows ड्राइवर मॉडल में एक और ज़रूरी शर्त शामिल की गई है. ऊपर बताए गए प्लैटफ़ॉर्म के मुकाबले, उपयोगकर्ता के ऐप्लिकेशन से यूएसबी डिवाइस को खोलने की सुविधा डिफ़ॉल्ट रूप से उपलब्ध नहीं होती. भले ही, कोई ड्राइवर लोड न किया गया हो. इसके बजाय, एक खास ड्राइवर, WinUSB है. डिवाइस को ऐक्सेस करने के लिए, ऐप्लिकेशन के इंटरफ़ेस को उपलब्ध कराने के लिए इसे लोड करना ज़रूरी है. ऐसा करने के लिए, सिस्टम पर इंस्टॉल की गई कस्टम ड्राइवर की जानकारी वाली फ़ाइल (INF) का इस्तेमाल किया जा सकता है. इसके अलावा, डिवाइस के फ़र्मवेयर में बदलाव करके भी ऐसा किया जा सकता है, ताकि गिनती के दौरान Microsoft OS के साथ काम करने की जानकारी देने वाले डिस्क्रिप्टर दिए जा सकें.

ड्राइवर की जानकारी वाली फ़ाइल (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 API की मदद से उसे ढूंढ सके और उससे कनेक्ट कर सके. रैंडम जीयूआईडी जनरेट करने के लिए, New-Guid PowerShell cmdlet या किसी ऑनलाइन टूल का इस्तेमाल करें.

डेवलपमेंट के मकसद से Zadig टूल, यूएसबी इंटरफ़ेस के लिए लोड किए गए ड्राइवर को WinUSB ड्राइवर से बदल सकता है.

Microsoft OS के साथ काम करने की जानकारी देने वाले डिस्क्रिप्टर

ऊपर दिया गया INF फ़ाइल का तरीका मुश्किल है, क्योंकि इसके लिए हर उपयोगकर्ता की मशीन को पहले से कॉन्फ़िगर करना ज़रूरी है. Windows 8.1 और उसके बाद के वर्शन में, कस्टम यूएसबी डिस्क्रिप्टर का इस्तेमाल करके, एक और विकल्प उपलब्ध है. ये डिस्क्रिप्टर, डिवाइस को पहली बार प्लग इन करने पर, Windows ऑपरेटिंग सिस्टम को ऐसी जानकारी देते हैं जो आम तौर पर INF फ़ाइल में शामिल होती है.

WebUSB डिस्क्रिप्टर सेट अप करने के बाद, Microsoft के ओएस के साथ काम करने वाले डिस्क्रिप्टर को भी आसानी से जोड़ा जा सकता है. सबसे पहले, इस अतिरिक्त प्लैटफ़ॉर्म की क्षमता वाले डिस्क्रिप्टर की मदद से, BOS डिस्क्रिप्टर को बढ़ाएं. इसकी जानकारी देने के लिए, wTotalLength और bNumDeviceCaps को ज़रूर अपडेट करें.

WebUSB डिस्क्रिप्टर की तरह ही, आपको एक bRequest वैल्यू चुननी होगी, ताकि इन डिस्क्रिप्टर से जुड़े कंट्रोल ट्रांसफ़र का इस्तेमाल किया जा सके. इस उदाहरण में, मैंने 0x02 चुना है. 0x07, wIndex में डाला गया, डिवाइस से Microsoft OS 2.0 डिस्क्रिप्टर सेट को वापस पाने का निर्देश है.

किसी यूएसबी डिवाइस में कई फ़ंक्शन हो सकते हैं. इसलिए, डिस्क्रिप्टर सेट के पहले हिस्से में बताया जाता है कि उसके बाद की प्रॉपर्टी किस फ़ंक्शन से जुड़ी हैं. यहां दिए गए उदाहरण में, कॉम्पोज़िट डिवाइस के इंटरफ़ेस 1 को कॉन्फ़िगर किया गया है. डिस्क्रिप्टर, ओएस को इस इंटरफ़ेस के बारे में दो अहम जानकारी देता है. काम करने वाले डिवाइस का आईडी डिस्क्रिप्टर, Windows को बताता है कि यह डिवाइस WinUSB ड्राइवर के साथ काम करता है. रजिस्ट्री प्रॉपर्टी डिस्क्रिप्टर, ऊपर दिए गए INF के उदाहरण में दिए गए [Dev_AddReg] सेक्शन की तरह ही काम करता है. इसमें इस फ़ंक्शन को डिवाइस इंटरफ़ेस जीयूआईडी (ग्लोबली यूनीक आइडेंटिफ़ायर) असाइन करने के लिए, रजिस्ट्री प्रॉपर्टी सेट की जाती है.

Windows, इस जानकारी के लिए डिवाइस से सिर्फ़ एक बार क्वेरी करेगा. अगर डिवाइस, मान्य डिस्क्रिप्टर के साथ जवाब नहीं देता है, तो अगली बार डिवाइस कनेक्ट होने पर, यह फिर से नहीं पूछेगा. Microsoft ने यूएसबी डिवाइस की रजिस्ट्री एंट्री की सूची उपलब्ध कराई है. इसमें, किसी डिवाइस की जानकारी देते समय बनाई गई रजिस्ट्री एंट्री के बारे में बताया गया है. जांच करते समय, किसी डिवाइस के लिए बनाई गई एंट्री मिटाएं, ताकि Windows डिस्क्रिप्टर को फिर से पढ़ने की कोशिश कर सके.

ज़्यादा जानकारी के लिए, इन डिस्क्रिप्टर का इस्तेमाल करने के तरीके के बारे में Microsoft की ब्लॉग पोस्ट देखें.

उदाहरण

WebUSB के बारे में जानकारी रखने वाले डिवाइसों को लागू करने वाले कोड का उदाहरण, इन प्रोजेक्ट में देखा जा सकता है. इनमें WebUSB और Microsoft OS, दोनों डिस्क्रिप्टर शामिल हैं:

• WebLight
• WebUSB Arduino लाइब्रेरी