Android USB aksesuarları, Android Açık Aksesuar'a (AOA) uygun olmalıdır. Protokol, aksesuarın aksesuarla olan iletişimi nasıl algıladığını ve kurduğunu tanımlayan Android destekli bir cihaz. Aksesuarlar şu adımları uygulamalıdır:
- Bağlı bir cihazı bekleyin ve algılayın.
- Cihazın aksesuar modu desteğini belirleyin.
- Cihazı aksesuar modunda başlatmayı deneyin (gerekirse).
- Cihaz AOA'yı destekliyorsa cihazla iletişim kurun.
Aşağıdaki bölümlerde bu adımların nasıl uygulanacağı açıklanmaktadır.
Bağlanmayı bekle ve algıla cihazlar
Aksesuarlar, bağlı Android destekli cihazları sürekli olarak kontrol etmelidir. Bir cihaz bağlandığında aksesuarın, cihazın bağlı olup olmadığını belirlemesi gerekir. aksesuar modunu destekler.
Aksesuar modu desteğini belirleme
Not: Aksesuarları bağlamak için USB üzerinden hata ayıklama gerekmez ancak Geliştirme sırasında ADB gerekli olabilir. Ayrıntılar için bkz. Hata ayıklamayla ilgili dikkat edilmesi gereken noktalar
Android destekli bir cihaz bağlandığında üç durumdan birinde olabilir:
- Android aksesuar modunu destekler ve zaten aksesuar modundadır.
- Android aksesuar modunu destekler, ancak aksesuar modunda değildir.
- Android aksesuar modunu desteklemiyor.
İlk bağlantı sırasında aksesuar sürümü, tedarikçi firma kimliğini,
ve bağlı cihazın USB cihaz tanımlayıcısının ürün kimliği. Tedarikçi firma kimliği
Google'ın kimliğiyle (0x18D1
) eşleşmelidir. Cihaz zaten
aksesuar modundaysa ürün kimliği 0x2D00
veya
0x2D01
ve aksesuar şu işlemleri yapabilir:
ekibinizin ihtiyaçlarını
kendi iletişimini kullanarak toplu aktarım uç noktaları aracılığıyla cihaza
protokolü (cihazın aksesuar modunda başlatılması gerekmez).
Not: 0x2D00
şu alan için ayrıldı:
Aksesuar modunu destekleyen Android destekli cihazlar. 0x2D01
aksesuar modunu ve Android Hata Ayıklama'yı destekleyen cihazlar için ayrılmıştır
İki toplu uç noktaya sahip ikinci bir arayüz sunan köprü (ADB) protokolü
belirtin. Aşağıdaki durumlarda aksesuar uygulamasında hata ayıklamak için bu uç noktaları kullanabilirsiniz:
aksesuarın bir bilgisayarda simülasyonunu yapıyorsunuz. Genel olarak
arayüzü üzerinden çalışır.
USB cihaz tanımlayıcısındaki sürüm, tedarikçi kimliği veya ürün kimliği beklenen değerlerle eşleştiğinden aksesuar, cihazın desteklenip desteklenmediğini belirleyemez Android aksesuar modu. Aksesuarın cihazı şu sürede başlatmayı denemesi gerekir: aksesuar modunu (aşağıda ayrıntılı olarak açıklanmıştır) etkinleştirin.
Anahtar noktası: USB aksesuarı ilk el sıkışmadan sonra bir üstbilgi gönder. Bu üstbilgide üretici, model ve sürümünü değil. Sürüm isteğe bağlı bir alan olsa da yalnızca sürümle eşleşiyor ancak aksesuar sürüm göndermiyor, Android cihazlar Android 10 ve önceki sürümlerde çalışan bir hata, bahsedeceğim.
Aksesuarda başlamayı dene mod
Sürüm, tedarikçi firma ve ürün kimlikleri, Android destekli bir modundaysa aksesuar, cihazın desteklenip desteklenmediğini belirleyemez (ancak yoksa) aksesuar modunda olup olmadığını veya cihaz aksesuar modunu desteklemiyorsa: Bu aksesuar modunu destekleyen (aksesuarda olmayan) modu) önce cihaz üreticisi tedarikçi firma ve ürün kimliklerini raporlayın yerine AOA tedarikçi ve ürün kimliklerinin kullanılmasını öneririz.
Aksesuarın, şu özellikleri belirlemek için cihazı aksesuar modunda başlatmayı denemesi gerekir: Cihaz bu modu destekliyorsa:
- Cihazın aşağıdaki özelliklere sahip olup olmadığını belirlemek için bir 51 denetim isteği ("Protokol Al") gönder:
Android aksesuar protokolünü destekler. Cihaz, protokolü destekliyorsa
desteklenen protokol sürümünü temsil eden sıfır dışında bir sayı döndürür.
Kontrol isteği, aşağıdaki özelliklere sahip uç nokta 0'da:
requestType: USB_DIR_IN | USB_TYPE_VENDOR request: 51 value: 0 index: 0 data: protocol version number (16 bits little endian sent from the device to the accessory)
- Cihaz desteklenen bir protokol sürümü döndürürse bir kontrol isteği gönderin
tanımlayıcı dize bilgisi içerir. Bu bilgiler,
uygun bir uygulama belirler (veya bir uygulamayı
Uygun bir uygulama yoksa kullanıcının URL'si). Kontrol
isteği, aşağıdakine sahip uç nokta 0'da (her dize kimliği için)
özellikler:
requestType: USB_DIR_OUT | USB_TYPE_VENDOR request: 52 value: 0 index: string ID data zero terminated UTF8 string sent from accessory to device
Maksimum 256 bayt boyutunda olmak üzere aşağıdaki dize kimlikleri desteklenir (
\0
ile sıfır sonlandırılmış olmalıdır).manufacturer name: 0 model name: 1 description: 2 version: 3 URI: 4 serial number: 5
- Cihazın aksesuar modunda başlatılmasını istemek için bir kontrol isteği gönderin. İlgili içeriği oluşturmak için kullanılan
kontrol isteği, aşağıdaki özelliklere sahip uç nokta 0'da:
requestType: USB_DIR_OUT | USB_TYPE_VENDOR request: 53 value: 0 index: 0 data: none
Bu adımları tamamladıktan sonra aksesuar, bağlı USB'nin yüklenmesini beklemelidir. tanıtıp aksesuar modunda kendisini otobüste yeniden tanıtması bağlı cihazlar. Algoritma aksesuar modu desteğini belirler doğru olması gereken tedarikçi ve ürün kimliklerini kontrol ederek (örneğin, cihaz üreticisinin kimlikleri yerine Google'ın tedarikçi firma ve ürün kimliklerine ekleyerek Cihaz başarıyla aksesuar moduna geçti. Kimlikler ve sürüm doğruysa bir sonraki aşamaya cihazla iletişimde ne olur?
Not: AOA şu anda desteklenmemektedir. aynı anda AOA ve MTP bağlantıları. AOA'dan MTP'ye geçmek için aksesuar önce USB cihazının bağlantısını kesmelidir (fiziksel olarak veya eşdeğer şekilde) ve daha sonra MTP kullanarak yeniden bağlanmayı deneyin.
Herhangi bir adım başarısız olursa aksesuar, cihazın desteklemediğini belirler Android aksesuar modu ve sonraki cihazın bağlanmasını bekliyor.
Müşterinizle ve paydaşlarınızla cihaz
Aksesuar, aksesuar modunda Android destekli bir cihaz algılarsa almak için cihaz arayüzünü ve uç nokta tanımlayıcılarını sorgulayabilir. toplu uç noktalar da dahil edilir.
Arayüzlerin ve toplu uç noktaların sayısı ürün kimliğine bağlıdır. Şu ürün kimliğine sahip Android destekli cihaz:
0x2D00
, giriş için iki toplu uç nokta bulunan bir arayüze ve çıktı iletişimi.0x2D01
, her biri için iki toplu uç nokta içeren iki arayüze sahiptir giriş ve çıkış iletişimi. İlk arayüzde, standart ve ikinci arayüz ADB iletişimini gerçekleştirir. Bir arayüzünde ilk toplu giriş ve çıkış uç noktalarını bulun, cihaz yapılandırmasınıSET_CONFIGURATION
ile 1 olarak ayarlayın (0x09
) cihaz isteğinde bulunabilir, ardından uç noktaları kullanarak iletişim kurabilirsiniz.