एमुलेटर यूएसबी पासथ्रू इंटीग्रेशन गाइड

यह आलेख वर्णन करता है कि दो बाह्य उपकरणों (ब्लूटूथ और वाई-फाई) को AAOS एमुलेटर से कैसे जोड़ा जाए। इस प्रक्रिया में, ड्राइवर समर्थन के लिए विशिष्ट तीन क्षेत्र प्रमुख हैं:

  • अतिथि कर्नेल
  • अतिथि एंड्रॉइड
  • लिनक्स होस्ट

सबसे पहले, आप अतिथि कर्नेल में प्रासंगिक यूएसबी ड्राइवरों को संकलित और सक्षम करें। इसके बाद, गेस्ट एंड्रॉइड को ड्राइवर लाने के लिए सही एचएएल और सेवाओं का चयन करना होगा। अंत में, लिनक्स होस्ट को USB ड्राइवर तक पहुंच प्राप्त करनी होगी और फिर इसे QEMU में स्थानांतरित करना होगा।

डोंगल का परीक्षण किया गया

निम्नलिखित डोंगल का परीक्षण किया गया:

अन्य डोंगल काम कर सकते हैं, हालाँकि, किसी अन्य का परीक्षण नहीं किया गया।

मूल यूएसबी समर्थन

QEMU USB को एम्यूलेटर तक पास करने के विकल्पों के साथ आता है। AAOS सिस्टम छवि पहले से ही कनेक्टेड फ़ोन को संभालती है। विवरण के लिए, एंड्रॉइड ओपन एक्सेसरी (एओए) देखें।

चूँकि AOA कनेक्शन स्थापित करने पर फ़ोन vendorID और productID के लिए मान बदलता है, इसलिए नया USB इंटरफ़ेस (साथ ही मूल USB इंटरफ़ेस) डिवाइस को तब देखता है जब फ़ोन AOA मोड में होता है।

AOA मोड से पहले और बाद में vendorID और productID के मान निर्धारित करने के लिए, lsusb उपयोग करें:

# Note Vendor ID and Product ID of your phone
$ lsusb
Bus 001 Device 079: ID 18d1:4ee1 Google Inc. Nexus/Pixel Device (MTP)
# Start up an emulator!
$ ./emulator @AVD_NAME -no-snapshot -qemu -device usb-ehci,id=ehci -device usb-host,bus=ehci.0,vendorid=0x18d1,productid=0x4ee1 -device usb-host,bus=ehci.0,vendorid=0x18d1,productid=0x2d00

वैकल्पिक रूप से, भौतिक पोर्ट को QEMU को पास करें:

# First plug something into the interested USB port and note the Bus and Device number.
$ lsusb
Bus 001 Device 012: ID 0bda:c820 Realtek Semiconductor Corp. 802.11ac NIC
# Now figure out where the Port number is.
$ lsusb -t
/:  Bus 01.Port 1: Dev 1, Class=root_hub, Driver=xhci_hcd/12p, 480M
    |__ Port 4: Dev 12, If 1, Class=Wireless, Driver=btusb, 480M
    |__ Port 4: Dev 12, If 2, Class=Vendor Specific Class, Driver=, 480M
    |__ Port 4: Dev 12, If 0, Class=Wireless, Driver=btusb, 480M
# Launch the emulator
 ./emulator @AVD_NAME -no-snapshot -qemu -device usb-ehci,id=ehci -device usb-host,bus=ehci.0,hostbus=1,hostport=4
# Now, whatever you plug into the emulator, USB passthrough will happen on the fly.

एएओएस सिस्टम छवि फोन को पहचानती है, इसे एओए मोड में डालती है, और एओए मोड चलने पर इसे फिर से पहचानती है।

USB पासथ्रू का समर्थन करने के लिए, पुष्टि करें कि आप एम्यूलेटर 30.5.0 का उपयोग कर रहे हैं:

# Check for the emulator version
$ emulator --version

एम्यूलेटर 30.5.0 में ASUS डोंगल समर्थन की गति अनुकूलता को संबोधित करने के लिए एक libusb अपग्रेड और अस्थायी समाधान शामिल है:

ब्लूटूथ समर्थन

ब्लूटूथ पासथ्रू का समर्थन करने के लिए, Google ने ASUS USB-BT400 USB एडाप्टर USBBT400 और Auscomer द्वारा USB वाई-फाई ब्लूटूथ एडाप्टर का परीक्षण किया।

सबसे पहले, आपको डोंगल के लिए कर्नेल समर्थन जोड़ना होगा। एंड्रॉइड ब्लूटूथ स्टैक को समझने के लिए, ब्लूटूथ देखें। एचआईडीएल के लिए, एमुलेटर सिम्युलेटेड कार्यान्वयन का उपयोग करता है। इसलिए, इसे मूल लिनक्स कार्यान्वयन के साथ बदलें।

अतिथि कर्नेल

USB ब्लूटूथ डोंगल का समर्थन करने के लिए:

  1. लापता btusb.ko अपने कर्नेल में जोड़ें:

    --- a/goldfish_defconfig.fragment
    +++ b/goldfish_defconfig.fragment
    @@ -1,6 +1,7 @@
     # CONFIG_CRYPTO_DEV_VIRTIO is not set
     CONFIG_BLK_DEV_MD=m
    +CONFIG_BT_HCIBTUSB=m
     CONFIG_CPUFREQ_DUMMY=m
    

अतिथि एंड्रॉइड

  1. vendor.mk फ़ाइल में, लिनक्स मूल एचआईडीएल और कई अनुमतियां शामिल करें:

    PRODUCT_PACKAGES += \
        android.hardware.bluetooth@1.1-service.btlinux
    PRODUCT_COPY_FILES += \ frameworks/native/data/etc/android.hardware.usb.host.xml:$(TARGET_COPY_OUT_VENDOR)/etc/permissions/android.hardware.usb.host.xml
    
  2. HIDL को स्विच करने के लिए एक-तरफ़ा पथ प्रॉपर्टी बनाएं, जैसे कि यह Linux मूल HIDL कार्यान्वयन का उपयोग करता हो:

    selinux/common/domain.te
    
    get_prop(domain, qemu_prop)
    +get_prop(domain, vendor_build_prop)
    
    selinux/common/property_contexts
    
    qemu.cmdline            u:object_r:qemu_cmdline:s0
    +qemu.preferred.bt.service u:object_r:qemu_prop:s0
    
  3. जब भी कोई संपत्ति qemu.preferred.bt.service को passthrough पर सेट किया जाता है, तो आप HIDL कार्यान्वयन को बंद कर देंगे:

    service btlinux-1.1 /vendor/bin/hw/android.hardware.bluetooth@1.1-service.btlinux
      class hal
      user bluetooth
      group bluetooth net_admin net_bt_admin
      capabilities NET_ADMIN NET_RAW SYS_NICE
      disabled
    
    on property:qemu.preferred.bt.service=passthrough
      stop vendor.bluetooth-1-1
      start btlinux-1.1
    
  4. पूर्ण सुविधाएँ प्राप्त करने के लिए ब्लूटूथ कॉन्फ़िगरेशन फ़ाइल जोड़ें, जैसे कि वास्तविक USB डिवाइस पर:

    hal/bluetooth/bdroid_buildcfg.h
    
    #ifndef _BDROID_BUILDCFG_H
    #define _BDROID_BUILDCFG_H
    #define BTM_DEF_LOCAL_NAME "gCar Emulator"
    #define BTA_AV_SINK_INCLUDED TRUE
    /* Handsfree device */
    #define BTA_DM_COD {0x26, 0x04, 0x08}
    #endif
    
  5. यह निर्धारित करने के लिए कि कॉन्फ़िगरेशन फ़ाइल कहाँ सहेजी गई है, BoardConfig.mk फ़ाइल को संशोधित करें:

    BoardConfig.mk
    
    # Bluetooth
    BOARD_HAVE_BLUETOOTH := true
    BOARD_BLUETOOTH_BDROID_BUILDCFG_INCLUDE_DIR := vendor/auto/embedded/hal/bluetooth
    

लिनक्स होस्ट

लिनक्स होस्ट पर:

  1. उपयोगकर्ता प्रक्रिया (जैसे QEMU) को पढ़ने/लिखने की अनुमति देने के लिए udev सेटिंग्स को अपडेट करें:

    $ echo 'SUBSYSTEM=="usb", ATTRS{idVendor}=="0b05", ATTRS{idProduct}=="17cb", MODE="0666", GROUP="plugdev"' | sudo tee /etc/udev/rules.d/99-mynew.rules >/dev/null
    $ sudo udevadm control --reload
    $ sudo udevadm trigger
    
  2. एमुलेटर चलाने के लिए, निम्नलिखित कमांड लाइन पैरामीटर सेट करें:

    # Start up an emulator!
    $ ./emulator @AVD_NAME -no-snapshot -prop qemu.preferred.bt.service=passthrough -qemu -device usb-ehci,id=ehci -device usb-host,bus=ehci.0,vendorid=0x0b05,productid=0x17cb
    # Start Bluetooth Passthrough
    

वाई-फ़ाई समर्थन

दोहरे ब्लूटूथ और वाई-फ़ाई को मान्य करने के लिए, Google ने USB वाई-फ़ाई ब्लूटूथ एडाप्टर के साथ परीक्षण किया।

अतिथि कर्नेल

यह विशेष USB डोंगल RTL8821CU चिप का उपयोग करता है, जिसे मेनलाइन कर्नेल अपस्ट्रीम अभी तक समर्थन नहीं करता है। आप 8821cu पर एक नव विकसित कर्नेल मॉड्यूल पा सकते हैं।

फिर, चेंजलिस्ट 1575108 में, बाहरी कर्नेल मॉड्यूल को संकलित करने के लिए गोल्डफिश कर्नेल स्रोत में एकीकृत किया गया था।

अंत में, कर्नेल मॉड्यूल संकलित होता है लेकिन कुछ सीएफआई क्रैश के साथ। इसे ठीक करने के लिए आपको कोड को मैन्युअल रूप से पैच करना होगा। विवरण के लिए, एंड्रॉइड कर्नेल में कंट्रोल फ्लो इंटीग्रिटी देखें।

CONFIG_CFI_PERMISSIVE को सक्षम करना और पहले शेष स्टैक को डीबग करने के साथ आगे बढ़ना सहायक हो सकता है:

--- a/goldfish_defconfig.fragment
+++ b/goldfish_defconfig.fragment
@@ -1,6 +1,7 @@
 CONFIG_CFI_CLANG=m
+CONFIG_CFI_PERMISSIVE=m

किसी भी स्थिति में, सीएफआई क्रैश का उचित समाधान देखने के लिए चेंजलिस्ट 1575109 पर जाएं।

अतिथि एंड्रॉइड

वाई-फ़ाई स्टैक के बारे में अधिक जानने के लिए, वाई-फ़ाई अवलोकन देखें। एम्यूलेटर वाई-फाई को काम करने के लिए सेटिंग्स के साथ आता है।

लिनक्स होस्ट

लिनक्स होस्ट पर, आपको उपयोगकर्ता प्रक्रिया (उदाहरण के लिए, QEMU) को पढ़ने/लिखने की अनुमति सक्षम करने के लिए udev सेटिंग्स को अपडेट करना होगा।

# /lib/udev/rules.d/40-usb_modeswitch.rules
$ ATTR{idVendor}=="0bda", ATTR{idProduct}=="1a2b", RUN+="usb_modeswitch '/%k'"
$ echo 'SUBSYSTEM=="usb", ATTRS{idVendor}=="0bda", ATTRS{idProduct}=="c820", MODE="0666", GROUP="plugdev"' | sudo tee /etc/udev/rules.d/99-mynew2.rules >/dev/null
$ sudo udevadm control --reload
$ sudo udevadm trigger

डोंगल को QEMU तक पहुंचाने के लिए:

# Start up an emulator!
$ ./emulator @AVD_NAME -no-snapshot -qemu -device usb-ehci,id=ehci -device usb-host,bus=ehci.0,vendorid=0x0bda,productid=0xc820

पोर्ट चेंजलिस्ट

निम्नलिखित चेंजलिस्ट को पोर्ट करें: