Android 开放配件 1.0

Android USB 配件必须遵循 Android 开放配件 (AOA) 协议,该协议规定了配件如何检测 Android 设备并与其建立通信。配件应执行以下步骤:

  1. 等待设备连接并对其进行检测。
  2. 确定设备是否支持配件模式。
  3. 尝试以配件模式启动设备(如需要)。
  4. 如果设备支持 AOA,则与该设备建立通信。

以下部分介绍了如何执行上述步骤。

等待设备连接并对其进行检测

配件应该不间断地检查是否连接了 Android 设备。设备成功连接后,配件应该确定设备是否支持配件模式。

确定是否支持配件模式

注意:连接配件不需要 USB 调试,但在开发过程中可能需要 ADB。如需了解详情,请参阅调试注意事项

当 Android 设备成功连接后,它可能处于以下三种状态之一:

  • 支持 Android 配件模式,并且已处于配件模式。
  • 支持 Android 配件模式,但是未处于配件模式。
  • 不支持 Android 配件模式。

在初次连接时,配件应该检查所连接设备的 USB 设备描述符的版本、供应商 ID 和产品 ID。供应商 ID 应与 Google 的 ID (0x18D1) 相符。如果设备已经处于配件模式,产品 ID 应为 0x2D000x2D01,配件可以使用自己的通信协议通过批量传输端点与设备建立通信(不需要以配件模式启动设备)。

注意0x2D00 是为支持配件模式的 Android 设备预留的产品 ID。0x2D01 则是为同时支持配件模式和 Android 调试桥 (ADB) 协议的设备预留的产品 ID,这类设备提供了第二个接口(具有两个批量端点,用于 ADB 通信)。如果您在计算机上模拟配件,可以使用这些端点调试配件应用。一般来说,不要使用该接口,除非配件在设备上实现了到 ADB 的直通通信。

如果发现 USB 设备描述符中的版本、供应商 ID 或产品 ID 与期望值不符,则配件无法确定设备是否支持 Android 配件模式。配件应尝试以配件模式启动设备(详见下文)以确定设备是否支持配件模式。

要点:USB 配件必须在初始握手后发送头文件。头文件中包含制造商、型号和版本。虽然版本是一个可选字段,但如果安装了仅版本匹配的 Android 应用而配件没有发送版本,搭载 Android 10 及更低版本的 Android 设备就会因系统进程中抛出的异常而重新启动。

尝试以配件模式启动

如果版本、供应商 ID 和产品 ID 与处于配件模式下的 Android 设备不对应,配件就无法确定设备是支持(但未处于)配件模式,还是不支持配件模式。发生这种情况是因为支持配件模式(但未处于配件模式下)的设备首先报告的是设备制造商的供应商 ID 和产品 ID,而不是 AOA 供应商 ID 和产品 ID。

配件应尝试以配件模式启动设备,以确定设备是否支持该模式:

  1. 发送 51 控制请求(“获取协议”)以确定设备是否支持 Android 配件协议。如果设备支持协议,则返回一个非零数字,代表所支持的协议版本。该控制请求为端点 0 上的请求,具有以下特征:
    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)
    
  2. 如果设备返回所支持的协议版本,则向设备发送含标识字符串信息的控制请求。该信息让设备可以确定适合配件的应用(如果没有适合配件的应用,则向用户呈现一个网址)。该控制请求为端点 0 上的请求(适用每个字符串 ID),具有以下特征:
    requestType:    USB_DIR_OUT | USB_TYPE_VENDOR
    request:        52
    value:          0
    index:          string ID
    data            zero terminated UTF8 string sent from accessory to device
    

    支持以下字符串 ID,并且每个字符串的最大大小为 256 个字节(必须以零结束,以 \0 结尾)。

    manufacturer name:  0
    model name:         1
    description:        2
    version:            3
    URI:                4
    serial number:      5
    
  3. 发送控制请求,要求设备以配件模式启动。该控制请求为端点 0 上的请求,具有以下特征:
    requestType:    USB_DIR_OUT | USB_TYPE_VENDOR
    request:        53
    value:          0
    index:          0
    data:           none
    

完成这些步骤后,配件应等待所连接的 USB 设备在配件模式下将其自身重新接入总线,然后重新枚举所连接的设备。该算法通过检查供应商 ID 和产品 ID 来确定设备是否支持配件模式,如果设备成功切换到配件模式,那么供应商 ID 和产品 ID 就应该是正确的(例如,与 Google 的供应商 ID 和产品 ID 而不是设备制造商的 ID 相对应)。如果 ID 和版本正确无误,配件会进而与设备建立通信

注意:AOA 当前不支持同时进行 AOA 连接和 MTP 连接。如需从 AOA 切换到 MTP,配件必须首先与 USB 设备断开连接(断开物理连接或以电气等效的方式断开),然后使用 MTP 重新连接 USB 设备。

如果有任意步骤失败,配件则确定设备不支持 Android 配件模式,并等待下一个设备连接。

与设备建立通信

如果配件检测到配件模式下的 Android 设备,则配件可以查询设备接口和端点描述符,以获取用于与设备进行通信的批量端点。

接口和批量端点的数量取决于产品 ID。具有以下产品 ID 的 Android 设备所具备的接口情况:

  • 0x2D00 有一个接口,该接口有两个批量端点,用于输入和输出通信。
  • 0x2D01 有两个接口,每个接口有两个批量端点,用于输入和输出通信。第一个接口处理标准通信,第二个接口则处理 ADB 通信。如需使用接口,请找到第一个批量输入和输出端点,使用 SET_CONFIGURATION (0x09) 设备请求将设备配置的值设为 1,然后使用端点进行通信。