एंड्रॉइड ओपन एक्सेसरी प्रोटोकॉल 2.0

यह दस्तावेज़ अपनी प्रारंभिक रिलीज़ के बाद से Android Open Accessory (AOA) प्रोटोकॉल में परिवर्तन का वर्णन करता है और AOA 1.0 प्रलेखन को पूरक करता है। AOAv2 निम्नलिखित विशेषताएं जोड़ता है:

  • ऑडियो आउटपुट (Android 8.0 में पदावनत)।
  • एंड्रॉइड डिवाइस के लिए एक या अधिक मानव इंटरफ़ेस डिवाइस (HID) के रूप में सहायक अभिनय के लिए समर्थन।

Android एप्लिकेशन डेवलपर्स के लिए उपलब्ध Android SDK API अपरिवर्तित हैं।

AOAv2 समर्थन का पता लगाना

यह निर्धारित करने के लिए कि कनेक्टेड एंड्रॉइड डिवाइस सहायक उपकरण और समर्थित प्रोटोकॉल संस्करण का समर्थन करता है, एक गौण को getProtocol() कमांड भेजना होगा और परिणाम की जांच करनी होगी। AOAv1 में केवल feautures का समर्थन करने वाले Android उपकरणों को प्रोटोकॉल संस्करण के रूप में 1 वापस करना होगा; एओएवी 2 में अतिरिक्त फ़ॉटरेस का समर्थन करने वाले उपकरणों को प्रोटोकॉल संस्करण के रूप में 2 लौटना चाहिए। एओएवी 2 एओएवी 1 के साथ पिछड़ा-संगत है, इसलिए मूल गौण प्रोटोकॉल के लिए डिज़ाइन किए गए सहायक उपकरण नए मोबाइल उपकरणों के साथ काम करना जारी रखते हैं।

एक्सेसरी डेवलपमेंट किट 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;
}

एओएवी 2 में एक्सेसरी मोड में उपलब्ध यूएसबी इंटरफेस के प्रत्येक संयोजन के लिए नए यूएसबी उत्पाद आईडी शामिल हैं:

संस्करण उत्पाद आइ डि संचार विवरण
AOAv1 0x2D00 सहायक Android एप्लिकेशन के साथ संचार करने के लिए दो बल्क एंडपॉइंट प्रदान करता है।
0x2D01 गौण + अदब गौण विकास के दौरान डिबगिंग उद्देश्यों के लिए। केवल तभी उपलब्ध होगा जब उपयोगकर्ता ने Android डिवाइस सेटिंग्स में USB डीबगिंग को सक्षम किया हो।
AOAv2 0x2D02 ऑडियो एंड्रॉइड डिवाइस से एक एक्सेसरी में ऑडियो स्ट्रीमिंग के लिए।
0x2D03 ऑडियो + अदब
0x2D04 गौण + ऑडियो
0x2D05 गौण + ऑडियो + अदब

AOAv1 ( 0x2D00 और 0x2D01 ) में उपयोग की जाने वाली उत्पाद आईडी 0x2D01 में समर्थित हैं।

ऑडियो समर्थन

AOAv2 में एंड्रॉइड डिवाइस से ऑडियो एक्सेसरी के लिए 2 चैनल में सक्षम एक मानक USB ऑडियो क्लास इंटरफेस के माध्यम से सहायक उपकरण शामिल हैं, 44100 Khz की थोड़ी दर के साथ 16-बिट PCM ऑडियो (अतिरिक्त ऑडियो मोड भविष्य में जोड़े जा सकते हैं)।

ऑडियो समर्थन को सक्षम करने के लिए, सहायक को एक नया USB नियंत्रण अनुरोध भेजना होगा:

**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 डिवाइस के साथ एक या अधिक USB मानव इंटरफ़ेस डिवाइस (HID) को पंजीकृत करने की अनुमति देता है। यह दृष्टिकोण विशिष्ट USB HID उपकरणों जैसे USB चूहों और कीबोर्ड के लिए संचार की दिशा को उलट देता है। आम तौर पर, छिपाई डिवाइस एक USB होस्ट (यानी एक व्यक्तिगत कंप्यूटर) से जुड़ा परिधीय है, लेकिन AOA में USB होस्ट USB परिधीय में एक या अधिक इनपुट डिवाइस के रूप में कार्य कर सकता है।

छिपाई समर्थन मानक छिपाई घटनाओं के लिए एक प्रॉक्सी है; कार्यान्वयन सामग्री या प्रकार की घटनाओं के बारे में कोई धारणा नहीं बनाता है और बस इसे इनपुट सिस्टम से गुजरता है, एओएवी 2 एक्सेसरी को किसी भी छिपाई डिवाइस (माउस, कीबोर्ड, गेम कंट्रोलर, आदि) के रूप में कार्य करने में सक्षम बनाता है। आप बुनियादी कार्यक्षमता प्रदान करने के लिए HID समर्थन का उपयोग कर सकते हैं, जैसे कि मीडिया डॉक पर प्ले / पॉज़ बटन, या माउस और पूर्ण QWERTY कीबोर्ड के साथ डॉकिंग स्टेशन जैसे उन्नत कार्यक्षमता के लिए।

AOAv2 नए USB नियंत्रण अनुरोध जोड़ता है जो एक्सेसरी को एंड्रॉइड डिवाइस पर एक या अधिक HID इनपुट डिवाइस के रूप में कार्य करने की अनुमति देता है। छिपाई समर्थन पूरी तरह से समापन बिंदु शून्य पर नियंत्रण अनुरोधों के माध्यम से नियंत्रित किया जाता है, इसलिए किसी नए यूएसबी इंटरफ़ेस की आवश्यकता नहीं है। चार नए नियंत्रण अनुरोध हैं:

  • ACCESSORY_REGISTER_HID Android डिवाइस के साथ एक नया HID डिवाइस पंजीकृत करता है। एक्सेसरी अन्य तीन कॉलों के लिए HID डिवाइस की पहचान करने के लिए उपयोग की जाने वाली आईडी प्रदान करती है। यह आईडी तब तक मान्य है जब तक कि USB डिस्कनेक्ट नहीं हो जाता या जब तक कि एक्सेस एक्सेस HESS डिवाइस को अपंजीकृत करने के लिए ACCESSORY_UNREGISTER_HID भेजता है।
  • ACCESSORY_UNREGISTER_HID पहले से छिपाए गए डिवाइस को ACCESSORY_REGISTER_HID साथ पंजीकृत करता है।
  • ACCESSORY_SET_HID_REPORT_DESC Android डिवाइस के लिए एक HID डिवाइस के लिए एक रिपोर्ट विवरणक भेजता है। यह अनुरोध HID डिवाइस की क्षमताओं का वर्णन करने के लिए उपयोग किया जाता है और Android डिवाइस पर किसी भी HID ईवेंट की रिपोर्ट करने से पहले भेजा जाना चाहिए। यदि रिपोर्ट विवरणक समापन बिंदु शून्य के लिए अधिकतम पैकेट आकार से बड़ा है, तो पूरे विवरणक को स्थानांतरित करने के लिए कई ACCESSORY_SET_HID_REPORT_DESC आदेश भेजे जाते हैं।
  • ACCESSORY_SEND_HID_EVENT एंड्रॉइड डिवाइस के एक्सेसरी से इनपुट ईवेंट भेजता है।

नए नियंत्रण अनुरोधों के लिए कोड परिभाषाएँ हैं:

/* 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 पर सीधे USB होस्ट (एक्सेसरी) के साथ संवाद करने के लिए सहायता प्रदान करता है। AOAv2 इस समर्थन को जारी रखता है और गौण Android ऑपरेटिंग सिस्टम (विशेष रूप से ऑडियो और इनपुट सिस्टम) के साथ संचार करने की अनुमति देने के लिए नई सुविधाएँ जोड़ता है। एओएवी 2 का डिज़ाइन एक सहायक उपकरण का निर्माण करना संभव बनाता है जो मूल सुविधा सेट के अलावा नए ऑडियो और छिपाई समर्थन का उपयोग करता है। बस मूल सुविधाओं के साथ नई सुविधाओं का उपयोग करें।

एंड्रॉइड ऐप के बिना AOAv2 कनेक्ट करना

आप एक एक्सेसरी (जैसे ऑडियो डॉक) डिज़ाइन कर सकते हैं जो ऑडियो और HID समर्थन का उपयोग करता है लेकिन Android डिवाइस पर किसी एप्लिकेशन के साथ संवाद नहीं करता है। इन सामानों के लिए, उपयोगकर्ताओं को एक Android एप्लिकेशन के साथ नए संलग्न एक्सेसरी को खोजने और संबद्ध करने के लिए संवाद संकेत प्राप्त करने की आवश्यकता नहीं है जो इसके साथ संवाद कर सकते हैं।

एक एक्सेसरी कनेक्ट होने के बाद ऐसे संवादों को दबाने के लिए, एक्सेसरी एंड्रॉइड डिवाइस पर निर्माता और मॉडल के नाम नहीं भेजना चुन सकती है। जब ये तार Android डिवाइस को प्रदान नहीं किए जाते हैं:

  • प्रणाली गौण के साथ संवाद करने के लिए एक आवेदन खोजने का प्रयास नहीं करती है।
  • एक्सेसरी मोड में प्रवेश करने के बाद एक्सेसरी यूएसबी इंटरफ़ेस एंड्रॉइड डिवाइस यूएसबी कॉन्फ़िगरेशन में मौजूद नहीं है।