加载usbserial驱动后,为什么adb不可用了?

时间:2024-02-29 12:31:18

​某设备提供了USB串口功能,上位机(Host端)可以通过USB串口与之通信。对于Linux上位机,比如Ubuntu,自带usbserial驱动,当安装usbserial驱动后,上位机就会生成ttyUSBx(x=0~n)设备,通过ttyUSBx就能与设备端进行USB串口通信。

 

该设备不仅提供了USB串口,也同时提供了adb口的功能。实际应用中发现,将设备通过USB线连接到Ubuntu PC后,有生成adb口,adb能正常使用;但是串口驱动默认没有加载,手动insmod usbserial后,串口可以正常使用,但是adb口却不通了。

 

usbserial的使用方法可参考kernel document:Documentation/usb/usb-serial.txt

insmod usbserial vendor=0x#### product=0x####
####是vendor id和product id。

 

调查发现,Ubuntu加载usbserial驱动后,原来的adb口会被识别为USB串口,生成新的ttyUSBx设备,导致Ubuntu端的adb无法正常与设备端通信。从这个现象看,是Ubuntu端usbserial驱动错误地匹配了本来不应该属于它匹配的设备。具体情况如下。

 

成功执行adb shell后,加载usbserial驱动之前,在Ubuntu上执行 lsusb -t 指令得到的结果截取如下:

Bus 03.Port 1: Dev 1, Class=root_hub, Driver=xhci_hcd/10p, 480M

|__ Port 6: Dev 4, If 5, Class=Vendor Specific Class, Driver=, 480M

|__ Port 6: Dev 4, If 6, Class=Vendor Specific Class, Driver=usbfs, 480M

 

加载usbserial驱动之后,再次插拔USB,在Ubuntu上执行 lsusb -t 指令得到的结果截取如下:

Bus 03.Port 1: Dev 1, Class=root_hub, Driver=xhci_hcd/10p, 480M

|__ Port 6: Dev 4, If 5, Class=Vendor Specific Class, Driver=usbserial_generic, 480M

|__ Port 6: Dev 4, If 6, Class=Vendor Specific Class, Driver=usbserial_generic, 480M

 

If 5对应的是串口,If 6对应的是adb口;正常情况下,adb口匹配的驱动是usbfs ,异常情况下,adb口匹配的驱动是 usbserial_generic 。

 

为什么usbserial驱动会错误地匹配了本来不应该属于它匹配的设备呢?这个需要从源码码中去寻找答案(Linus名言:Read the fu*k source code  ^_^)。

 

代码路径在 drivers/usb/serial/*,关键代码如下,从match_flags可以看出,usb generic serial驱动是简单地通过vendor id和product id来匹配设备。

 

drivers/usb/serial/generic.c

int usb_serial_generic_register(void)
{
int retval = 0;

#ifdef CONFIG_USB_SERIAL_GENERIC
generic_device_ids[0].idVendor = vendor;
generic_device_ids[0].idProduct = product;
generic_device_ids[0].match_flags =
USB_DEVICE_ID_MATCH_VENDOR | USB_DEVICE_ID_MATCH_PRODUCT;

retval = usb_serial_register_drivers(serial_drivers,
"usbserial_generic", generic_device_ids);
#endif
return retval;
}

drivers/usb/serial/usb-serial.c

static int __init usb_serial_init(void)
{
int result;

usb_serial_tty_driver = alloc_tty_driver(USB_SERIAL_TTY_MINORS);
...
/* register the generic driver, if we should */
result = usb_serial_generic_register();

 

由于该设备的adb口和串口都是基于同样的USB设备,具有同样的vendor id和product id,那adb口被识别成串口,也就能理解了。

 

原因找到了,那有没有办法解决这个问题呢?

 

1)上位机先执行adb shell把adb口占住,再加载usbserial驱动,则adb口不会被重新匹配serial驱动;但是重新插拔USB后,又需要卸载usbserial驱动,再重复此过程。临时用用倒是可以。

 

2)修改usbserial驱动。在开发嵌入式产品时,一般上位机也是需要源码级开发的,在这种场景下修改usbserial驱动比较适用。

 

看看adb和generic串口的接口描述符信息。在Ubuntu上执行lsusb -v指令后得到的adb接口描述符如下:

    Interface Descriptor:

      bLength                 9

      bDescriptorType         4

      bInterfaceNumber        6

      bAlternateSetting       0

      bNumEndpoints           2

      bInterfaceClass       255 Vendor Specific Class

      bInterfaceSubClass     66

      bInterfaceProtocol      1

      iInterface             10 ADB Interface

 

usb generic串口的接口描述符如下:

    Interface Descriptor:

      bLength                 9

      bDescriptorType         4

      bInterfaceNumber        5

      bAlternateSetting       0

      bNumEndpoints           2

      bInterfaceClass       255 Vendor Specific Class

      bInterfaceSubClass     0

      bInterfaceProtocol      0

 

可以看到两者的 bInterfaceClass 是一样的,都是 Vendor Specific Class ,但是 bInterfaceSubClass 和 bInterfaceProtocol 不一样。所以可以考虑修改usbserial驱动的匹配规则,除了vendor id和product id之外,再加入按interface class和interface protocol联合匹配。

 

除了USB generic serial驱动外,还有一些厂商自定义的USB serial驱动,比如 drivers/usb/serial/option.c,该驱动就在probe函数里面设置了一些判断条件,避免匹配上不该匹配的设备,可用来参考。如下,代码注释得相当详细,不再赘述。

 

static int option_probe(struct usb_serial *serial,
            const struct usb_device_id *id)
{
    struct usb_interface_descriptor *iface_desc =
                &serial->interface->cur_altsetting->desc;
    unsigned long device_flags = id->driver_info;

    /* Never bind to the CD-Rom emulation interface    */
    if (iface_desc->bInterfaceClass == USB_CLASS_MASS_STORAGE)
        return -ENODEV;

    /*
     * Don\'t bind reserved interfaces (like network ones) which often have
     * the same class/subclass/protocol as the serial interfaces.  Look at
     * the Windows driver .INF files for reserved interface numbers.
     */
    if (device_flags & RSVD(iface_desc->bInterfaceNumber))
        return -ENODEV;

    /*
     * Allow matching on bNumEndpoints for devices whose interface numbers
     * can change (e.g. Quectel EP06).
     */
    if (device_flags & NUMEP2 && iface_desc->bNumEndpoints != 2)
        return -ENODEV;

    /* Store the device flags so we can use them during attach. */
    usb_set_serial_data(serial, (void *)device_flags);

    return 0;
}

 

欢迎关注我的公众号,一起交流。微信搜索“大鱼嵌入式”或者扫描下列二维码。