इस दस्तावेज़ में Android ओपन ऐक्सेसरी (एओए) प्रोटोकॉल में हुए बदलावों के बारे में बताया गया है शुरुआती रिलीज़ और सप्लीमेंट के तौर पर AOA 1.0 दस्तावेज़. एओएवी2 ये सुविधाएँ जोड़ता है:
- ऑडियो आउटपुट (Android 8.0 में बंद कर दिया गया है).
- एक या उससे ज़्यादा मैन्युअल इंटरफ़ेस डिवाइसों के तौर पर काम करने वाली ऐक्सेसरी के लिए सहायता (एचआईडी) को Android डिवाइस में भेजना चाहते हैं.
Android ऐप्लिकेशन डेवलपर के लिए उपलब्ध Android SDK API में कोई बदलाव नहीं हुआ है.
AOAv2 सहायता का पता लगाएं
यह पता करने के लिए कि कनेक्ट किया गया Android डिवाइस, ऐक्सेसरी के साथ काम करता है या नहीं और
इस्तेमाल किया जा सकने वाला प्रोटोकॉल वर्शन, ऐक्सेसरी को getProtocol() भेजना होगा
कमांड और परिणाम की जाँच करें. ऐसे Android डिवाइस जिनमें सिर्फ़ ये सुविधाएं काम करती हैं
AOAv1 में 1 को प्रोटोकॉल वर्शन के रूप में लौटाना चाहिए; वे डिवाइस जो
AOAv2 की अतिरिक्त सुविधाओं को काम करने में मदद करने के लिए, 2 को
प्रोटोकॉल वर्शन का इस्तेमाल करें. AOAv2, AOAv1 के साथ पुराने सिस्टम के साथ काम करता है. इसलिए, ऐक्सेसरी
ओरिजनल ऐक्सेसरी प्रोटोकॉल के हिसाब से डिज़ाइन किया गया, नए Android के साथ काम करता रहेगा
डिवाइस.
ऐक्सेसरी डेवलपमेंट किट 2011 का यह उदाहरण
सोर्स कोड
(<adk-src>/adk1/board/AndroidAccessory/AndroidAccessory.cpp)
लाइब्रेरी में इस प्रोटोकॉल जांच को दिखाया गया है:
bool AndroidAccessory::switchDevice(byte addr)
{
int protocol = getProtocol(addr);
if (protocol >= 1) {
Serial.print("device supports protocol 1 or higher\n");
} else {
Serial.print("could not read device protocol version\n");
return false;
}
sendString(addr, ACCESSORY_STRING_MANUFACTURER, manufacturer);
sendString(addr, ACCESSORY_STRING_MODEL, model);
sendString(addr, ACCESSORY_STRING_DESCRIPTION, description);
sendString(addr, ACCESSORY_STRING_VERSION, version);
sendString(addr, ACCESSORY_STRING_URI, uri);
sendString(addr, ACCESSORY_STRING_SERIAL, serial);
usb.ctrlReq(addr, 0, USB_SETUP_HOST_TO_DEVICE | USB_SETUP_TYPE_VENDOR |
USB_SETUP_RECIPIENT_DEVICE, ACCESSORY_START, 0, 0, 0, 0, NULL);
return true;
}
AOAv2 में यूएसबी इंटरफ़ेस के हर कॉम्बिनेशन के लिए नए यूएसबी प्रॉडक्ट आईडी शामिल किए गए हैं ऐक्सेसरी मोड में उपलब्ध है:
| वर्शन | प्रॉडक्ट आईडी | कम्यूनिकेशन से जुड़ी सेटिंग | ब्यौरा |
|---|---|---|---|
| एओएवी1 | 0x2D00 |
ऐक्सेसरी | यह Android ऐप्लिकेशन के साथ कम्यूनिकेट करने के लिए, दो बल्क एंडपॉइंट उपलब्ध कराता है. |
0x2D01 |
ऐक्सेसरी + adb | ऐक्सेसरी डेवलपमेंट के दौरान डीबग करने के लिए. तब उपलब्ध होता है, जब उपयोगकर्ता ने Android डिवाइस की सेटिंग में, यूएसबी डीबग करने की सुविधा चालू की है. | |
| एओएवी2 | 0x2D02 |
ऑडियो | Android डिवाइस से ऐक्सेसरी पर ऑडियो स्ट्रीम करने के लिए. |
0x2D03 |
ऑडियो + adb | ||
0x2D04 |
ऐक्सेसरी + ऑडियो | ||
0x2D05 |
ऐक्सेसरी + ऑडियो + adb |
AOAv1 में इस्तेमाल किए गए प्रॉडक्ट आईडी (0x2D00 और 0x2D01)
AOAv2 में समर्थित रहेगा.
ऑडियो की सुविधा
AOAv2 में Android डिवाइस के ऑडियो आउटपुट के लिए, 2 चैनल, 16-बिट वाले मानक USB ऑडियो क्लास इंटरफ़ेस के माध्यम से मौजूद एक्सेसरी 44100 किलोहर्ट्ज़ की बिट दर वाला PCM ऑडियो (इसके लिए, अतिरिक्त ऑडियो मोड जोड़े जा सकते हैं आने वाले समय में).
ऑडियो सहायता चालू करने के लिए, ऐक्सेसरी को एक नया यूएसबी कंट्रोल अनुरोध भेजना होगा:
**SET_AUDIO_MODE**
requestType: USB_DIR_OUT | USB_TYPE_VENDOR
request: 58
value: 0 for no audio (default),
1 for 2 channel, 16-bit PCM at 44100 KHz
index: 0
data none
इस निर्देश को
ऐक्सेसरी मोड में जाने के लिए ACCESSORY_START निर्देश.
एचआईडी सपोर्ट
AOAv2 ऐक्सेसरी को एक या उससे ज़्यादा यूएसबी ह्यूमन इंटरफ़ेस को रजिस्टर करने की अनुमति देता है Android डिवाइस वाले डिवाइस (एचआईडी). यह अप्रोच की दिशा को पलट देता है यूएसबी माउस और कीबोर्ड जैसे सामान्य यूएसबी एचआईडी डिवाइसों के लिए कम्यूनिकेशन. आम तौर पर, एचआईडी डिवाइस एक सहायक डिवाइस (जैसे, कीबोर्ड, माउस, मॉनिटर, वेबकैम वगैरह) होता है जो यूएसबी होस्ट से जुड़ा होता है (यानी कि एओए में यूएसबी होस्ट, एक या उससे ज़्यादा इनपुट के तौर पर काम कर सकता है. यूएसबी की मदद से काम करने वाले सहायक डिवाइस (जैसे, कीबोर्ड, माउस, मॉनिटर, वेबकैम वगैरह) को कनेक्ट करना.
एचआईडी सपोर्ट, स्टैंडर्ड एचआईडी इवेंट के लिए एक प्रॉक्सी है; यह लागू करने पर, इवेंट के कॉन्टेंट या उसके टाइप के बारे में कोई अनुमान नहीं लगाया जाता है और इसे इनपुट सिस्टम में भेज दिया जाता है, ताकि AOAv2 ऐक्सेसरी चालू की जा सके किसी भी एचआईडी डिवाइस की तरह काम करें, जैसे कि माउस, कीबोर्ड, गेम कंट्रोलर वगैरह. एचआईडी का इस्तेमाल किया जा सकता है बुनियादी फ़ंक्शन उपलब्ध कराने के लिए सहायता देना. जैसे, मीडिया पर चलाने/रोकने वाला बटन इस्तेमाल कर सकते हैं. इसके अलावा, कुछ सुविधाएं इस्तेमाल कर सकते हैं, जैसे कि माउस के साथ डॉकिंग स्टेशन और पूर्ण QWERTY कीबोर्ड.
AOAv2 नए यूएसबी कंट्रोल के अनुरोध जोड़ता है. इससे ऐक्सेसरी को इस तरह काम करने की अनुमति मिलती है: Android डिवाइस पर एक या उससे ज़्यादा एचआईडी इनपुट डिवाइस जोड़ने होंगे. एचआईडी सहायता हैंडल की जाती है यह पूरी तरह से एंडपॉइंट शून्य पर कंट्रोल अनुरोधों के ज़रिए होता है, इसलिए कोई नया यूएसबी इंटरफ़ेस नहीं की ज़रूरत नहीं है. कंट्रोल करने के ये चार नए अनुरोध हैं:
- ACCESSORY_रजिस्ट्रेंट_HID, नए एचआईडी डिवाइस को
Android डिवाइस. ऐक्सेसरी एक ऐसा आईडी देती है जिसका इस्तेमाल एचआईडी डिवाइस की पहचान करने के लिए किया जाता है
अन्य तीन कॉल. यह आईडी, यूएसबी के डिसकनेक्ट होने तक या
एचआईडी का रजिस्ट्रेशन रद्द करने के लिए ऐक्सेसरी,
ACCESSORY_UNREGISTER_HIDभेजती है डिवाइस. - ACCESSORY_UN गिने_HID, एचआईडी डिवाइस का रजिस्ट्रेशन रद्द करता है
पहले
ACCESSORY_REGISTER_HIDके साथ रजिस्टर था. - ACCESSORY_SET_HID_Reporting_DESC इसके लिए रिपोर्ट डिस्क्रिप्टर भेजता है
किसी एचआईडी डिवाइस को Android डिवाइस पर भेजना. इस अनुरोध का इस्तेमाल, यह बताने के लिए किया जाता है कि
एचआईडी डिवाइस की सुविधाएं और उन्हें किसी भी एचआईडी इवेंट की रिपोर्ट करने से पहले भेजना ज़रूरी है
Android डिवाइस पर. अगर रिपोर्ट डिस्क्रिप्टर अधिकतम
एंडपॉइंट ज़ीरो, मल्टीपल के लिए पैकेट साइज़
ACCESSORY_SET_HID_REPORT_DESCनिर्देश भेजे जाते हैं, ताकि पूरा डिस्क्रिप्टर शामिल करें. - ACCESSORY_SEND_HID_EVENT Android डिवाइस की ऐक्सेसरी.
कंट्रोल के नए अनुरोधों के लिए कोड की परिभाषाएं:
/* Control request for registering a HID device. * Upon registering, a unique ID is sent by the accessory in the * value parameter. This ID will be used for future commands for * the device * * requestType: USB_DIR_OUT | USB_TYPE_VENDOR * request: ACCESSORY_REGISTER_HID_DEVICE * value: Accessory assigned ID for the HID device * index: total length of the HID report descriptor * data none */ #define ACCESSORY_REGISTER_HID 54 /* Control request for unregistering a HID device. * * requestType: USB_DIR_OUT | USB_TYPE_VENDOR * request: ACCESSORY_REGISTER_HID * value: Accessory assigned ID for the HID device * index: 0 * data none */ #define ACCESSORY_UNREGISTER_HID 55 /* Control request for sending the HID report descriptor. * If the HID descriptor is longer than the endpoint zero max packet size, * the descriptor will be sent in multiple ACCESSORY_SET_HID_REPORT_DESC * commands. The data for the descriptor must be sent sequentially * if multiple packets are needed. * * requestType: USB_DIR_OUT | USB_TYPE_VENDOR * request: ACCESSORY_SET_HID_REPORT_DESC * value: Accessory assigned ID for the HID device * index: offset of data in descriptor * (needed when HID descriptor is too big for one packet) * data the HID report descriptor */ #define ACCESSORY_SET_HID_REPORT_DESC 56 /* Control request for sending HID events. * * requestType: USB_DIR_OUT | USB_TYPE_VENDOR * request: ACCESSORY_SEND_HID_EVENT * value: Accessory assigned ID for the HID device * index: 0 * data the HID report for the event */ #define ACCESSORY_SEND_HID_EVENT 57
AOAv1 के साथ इंटरऑपरेबिलिटी (दूसरे सिस्टम के साथ काम करना)
ओरिजनल प्रोटोकॉल (AOAv1) Android ऐप्लिकेशन को सीधे यूएसबी से कनेक्ट करने की सुविधा देता है USB पर होस्ट (ऐक्सेसरी). AOAv2 इस सुविधा को जारी रखता है और इसमें नई सुविधाएं जोड़ता है ताकि ऐक्सेसरी को खुद Android ऑपरेटिंग सिस्टम से कम्यूनिकेट करने की अनुमति मिल सके (खास तौर पर ऑडियो और इनपुट सिस्टम). AOAv2 का डिज़ाइन इसे ऐसी ऐक्सेसरी बनाई जा सकती है जिसमें नया ऑडियो और एचआईडी सपोर्ट इस्तेमाल किया जाता हो . Google Chrome के साथ नई सुविधाओं का इस्तेमाल करें जैसी थी.
AOAv2 को बिना Android ऐप्लिकेशन
आपके पास ऑडियो और एचआईडी का इस्तेमाल करने वाली ऐक्सेसरी (जैसे, ऑडियो डॉक) डिज़ाइन करने का विकल्प है का इस्तेमाल करता है, लेकिन Android डिवाइस पर किसी ऐप्लिकेशन से कम्यूनिकेट नहीं करता है. इसके लिए इन ऐक्सेसरी को ढूंढने के लिए, लोगों को डायलॉग बॉक्स प्रॉम्प्ट पाने की ज़रूरत नहीं है जोड़े गए नए ऐक्सेसरी को ऐसे Android ऐप्लिकेशन से जोड़ना जो बातचीत करें.
किसी ऐक्सेसरी के कनेक्ट होने के बाद, ऐसे डायलॉग बंद करने के लिए, ऐक्सेसरी बनाने वाली कंपनी और मॉडल का नाम, Android को न भेजने का विकल्प चुन सकती है डिवाइस. जब Android डिवाइस को ये स्ट्रिंग उपलब्ध नहीं कराई जाती हैं:
- सिस्टम, ऐक्सेसरी से कनेक्ट करने के लिए किसी ऐप्लिकेशन को ढूंढने की कोशिश नहीं करता.
- Android डिवाइस के यूएसबी में, ऐक्सेसरी वाला यूएसबी इंटरफ़ेस मौजूद नहीं है डिवाइस के ऐक्सेसरी मोड में जाने के बाद, उसे कॉन्फ़िगर करना.