Guia de integração da passagem USB do emulador

Esta página descreve como conectar dois periféricos (Bluetooth e Wi-Fi) ao emulador AAOS. Nesse processo, três áreas específicas para o suporte ao motorista são fundamentais:

  • Kernel convidado
  • Android convidado
  • Host do Linux

Primeiro, você compila e ativa os drivers USB relevantes no kernel convidado. Em seguida, o Android convidado precisa selecionar a HAL e os serviços corretos para abrir a motoristas. Por fim, o host do Linux deve ter acesso ao driver USB e Depois, transfira-o para o QEMU.

Dongles testados

Os dongles a seguir foram testados:

Outros dongles podem funcionar, mas nenhum outro foi testado.

Suporte nativo a USB

O QEMU vem com opções para passar o USB para o emulador. A imagem do sistema AAOS já lida com um telefone conectado. Para mais detalhes, consulte Android Open Accessory (AOA).

Como o telefone muda os valores de vendorID e productID que estabelece uma conexão AOA, a nova interface USB (assim como o interface USB) vê o dispositivo quando o telefone está no modo AOA.

Determinar os valores de vendorID e productID antes e depois da AOA use 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

Como alternativa, passe a porta física para o 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.

A imagem do sistema AAOS reconhece o smartphone, coloca-o no modo AOA e reconhece novamente quando o modo AOA estiver em execução.

Para oferecer suporte à passagem USB, confirme se você está usando o emulador 30.5.0:

# Check for the emulator version
$ emulator --version

O emulador 30.5.0 inclui um upgrade de libusb e uma solução alternativa temporária para Aborde a compatibilidade de velocidade do suporte a dongle da ASUS:

Suporte a Bluetooth

Para oferecer suporte à passagem Bluetooth, o Google testou Adaptador USB ASUS USB-BT400 USBBT400 e o adaptador USB Wi-Fi Bluetooth da Auscomer.

Primeiro, você precisa adicionar suporte ao kernel para o dongle. Para entender o Android pilha de Bluetooth, consulte Bluetooth. Para HIDL, o emulador usa uma implementação simulada. Portanto, mude para com uma implementação nativa do Linux.

Kernel convidado

Para oferecer suporte a um dongle USB Bluetooth:

  1. Adicione o btusb.ko ausente ao kernel:

    --- 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
    

Android convidado

  1. No arquivo vendor.mk, inclua o HIDL nativo do Linux e vários :

    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. Crie uma propriedade de caminho unidirecional para trocar o HIDL de modo que use um Implementação do HIDL nativo do Linux:

    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. Sempre que uma propriedade qemu.preferred.bt.service for definida como passthrough, você vai trocar a implementação do 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. Adicione um arquivo de configuração Bluetooth para ter acesso a todos os recursos, como um dispositivo USB real:

    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. Modifique o arquivo BoardConfig.mk para determinar onde o arquivo de configuração é salvo:

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

Host do Linux

No host do Linux:

  1. Atualize as configurações de udev para permitir que o processo do usuário (por exemplo, QEMU) tenha Permissões de leitura/gravação:

    $ 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. Para executar o emulador, defina os seguintes parâmetros de linha de comando:

    # 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
    

Compatibilidade com Wi-Fi

Para validar o Bluetooth duplo e o Wi-Fi, o Google testou usando o Wi-Fi USB Adaptador Bluetooth.

Kernel convidado

Este dongle USB usa o chip RTL8821CU, que o kernel upstream ainda não suporta. É possível encontrar um kernel recém-desenvolvido em 8821cu.

Então, em lista de mudanças 1575108, os módulos externos do kernel foram integrados ao kernel goldfish fonte para compilá-lo.

Por fim, o módulo do kernel é compilado, mas com algumas falhas de CFI. Você precisa e corrigir o problema manualmente. Para mais detalhes, consulte Integridade do fluxo de controle no kernel do Android.

Pode ser útil ativar CONFIG_CFI_PERMISSIVE e continuar com depurar o restante da pilha primeiro:

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

De qualquer forma, acesse lista de mudanças 1575109 para ver a correção adequada para as falhas da CFI.

Android convidado

Para saber mais sobre o conjunto de redes Wi-Fi, consulte Visão geral do Wi-Fi. O emulador vem com as configurações para fazer o Wi-Fi funcionar.

Host do Linux

No host do Linux, atualize as configurações do udev para ativar o processo do usuário. (por exemplo, QEMU) para ter permissões de leitura/gravação.

# /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

Para passar o dongle para o 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

Listas de mudanças de portas

Faça a portabilidade das seguintes listas de mudanças: