
1. USB协议栈到底解决了什么问题做嵌入式或者内核开发的朋友迟早会碰到USB。你插一个U盘到Linux机器上系统自动识别、挂载、弹出文件管理器这一套动作行云流水背后其实是一条相当长的链路在协同工作。这条链路就是Linux USB协议栈。我刚接触USB子系统的时候最大的困惑是为什么一个简单的“插U盘”动作内核里要牵扯出十几层结构体、好几个子系统、一堆回调函数后来啃了挺长时间代码才慢慢理解——USB协议栈本质上解决的是**“主机如何用一套统一的框架去管理形态千差万别的外设”**这个问题。USB设备种类太多了键盘、鼠标、摄像头、网卡、串口转换器、存储设备每种设备的通信方式、数据格式、速率要求都不一样。如果每来一种设备就写一套驱动内核早就爆炸了。所以USB协议栈的设计目标就是把共性抽出来做成框架把差异留给驱动去填。这篇文章我打算从整体架构讲到具体实现把Linux USB协议栈的骨架拆开来看。适合谁读如果你正在写USB设备驱动、调试USB设备枚举问题、或者单纯想搞明白lsusb背后发生了什么那这篇内容应该能帮到你。我会尽量用大白话把关键机制讲清楚同时给出可以直接参考的代码路径和调试方法。2. 整体架构从硬件到用户空间的分层设计2.1 五层结构一览Linux USB协议栈从下到上大致可以分成这么几层层级名称核心职责关键代码位置1USB主机控制器驱动操作硬件寄存器收发数据包drivers/usb/host/2USB核心层设备管理、驱动匹配、URB调度drivers/usb/core/3USB设备驱动针对具体设备类型的功能实现drivers/usb/class/、drivers/usb/storage/等4类驱动/子系统将USB设备接入标准子系统drivers/usb/class/、drivers/usb/net/等5用户空间接口sysfs、usbfs、字符设备/sys/bus/usb/、/dev/bus/usb/这个分层不是随便切的。最下面的主机控制器驱动HCD负责跟硬件打交道比如xHCI、EHCI、OHCI、UHCI这些。它们把不同硬件平台的差异屏蔽掉向上提供统一的接口。USB核心层是整座大厦的承重墙它管理所有USB设备、总线、配置、接口、端点同时负责驱动的注册和匹配。设备驱动层就是具体干活的比如usb-storage负责U盘usbhid负责键盘鼠标。2.2 为什么这样分层我一开始觉得这个分层有点过度设计后来自己写了一个USB转串口驱动才明白分层是为了让每一层只关心自己的事。主机控制器驱动不需要知道上面插的是U盘还是摄像头它只管把URBUSB Request Block发出去、收回来。USB核心层不需要知道具体设备怎么工作它只管枚举、匹配驱动、管理生命周期。设备驱动不需要关心底层是xHCI还是EHCI它只管调用usb_submit_urb()提交请求。这种设计带来的直接好处是换一个主机控制器上面的驱动完全不用改。比如从EHCI换到xHCIusb-storage驱动一行代码都不用动。同样加一种新USB设备也只需要写一个新的设备驱动核心层和HCD都不用碰。2.3 关键数据结构的关系理解USB协议栈有几个结构体必须搞清楚它们之间的关系struct usb_device代表一个USB设备是核心层管理设备的基本单位。struct usb_interface代表设备的一个接口。一个USB设备可以有多个接口比如一个复合设备同时有音频接口和HID接口。struct usb_host_config代表设备的配置。一个设备可以有多个配置但同一时间只能激活一个。struct usb_host_endpoint代表端点是数据传输的通道。每个接口可以有多个端点。struct urbUSB Request Block是USB数据传输的载体。所有数据收发都通过URB完成。它们的关系可以这样理解一个usb_device包含一个或多个usb_host_config每个配置包含一个或多个usb_interface每个接口包含一个或多个usb_host_endpoint。驱动绑定的是usb_interface而不是整个设备。这一点很关键很多初学者会搞混。3. 设备枚举插上USB设备后内核做了什么3.1 枚举的完整流程插上USB设备的那一刻内核会经历一系列标准动作这个过程叫枚举。我把它拆成几个关键步骤端口检测主机控制器检测到端口电平变化知道有设备插入。端口复位HCD对端口进行复位设备进入Default状态。分配地址主机通过控制传输给设备分配一个唯一地址1~127。读取设备描述符先读8字节获取端点0的最大包长再读完整的18字节设备描述符。读取配置描述符获取设备的配置信息包括接口数、端点信息等。选择配置主机发送SET_CONFIGURATION请求激活一个配置。驱动匹配核心层根据设备/接口的VID、PID、类代码等信息匹配已注册的驱动。整个过程走的是控制传输端点0是默认的控制端点所有设备都必须支持。3.2 描述符体系详解USB描述符是枚举过程中最核心的数据。设备通过描述符告诉主机“我是什么、我能干什么”。主要描述符类型有设备描述符包含VID、PID、设备类、协议、端点0最大包长、配置数量等。配置描述符包含配置值、接口数量、供电方式、最大功耗等。接口描述符包含接口号、备用设置、端点数量、接口类、子类、协议等。端点描述符包含端点地址、属性控制/中断/批量/等时、最大包长、轮询间隔等。字符串描述符提供厂商名、产品名、序列号等可读信息。这些描述符在代码里对应include/uapi/linux/usb/ch9.h中的结构体定义。我调试的时候经常用lsusb -v把描述符全部打印出来对照代码看理解会快很多。3.3 实操用lsusb和sysfs观察枚举结果# 查看所有USB设备的基本信息 lsusb # 查看某个设备的完整描述符 lsusb -v -d 0781:5567 # 通过sysfs查看设备树 ls /sys/bus/usb/devices/ # 输出类似1-1 1-1:1.0 usb1 usb2 ... # 查看某个设备的详细信息 cat /sys/bus/usb/devices/1-1/idVendor cat /sys/bus/usb/devices/1-1/idProduct cat /sys/bus/usb/devices/1-1/manufacturer cat /sys/bus/usb/devices/1-1/product1-1这种命名规则表示总线1上的第1个端口。1-1:1.0表示该设备的第1个接口的第0号备用设置。这个命名规则在调试多设备系统时特别有用能快速定位物理连接关系。注意lsusb -v需要root权限才能看到完整的描述符信息普通用户只能看到设备列表。4. URB机制USB数据传输的核心载体4.1 URB是什么URB全称USB Request Block是USB协议栈里数据传输的基本单位。你可以把它理解成一张“快递单”驱动填好收件地址端点、货物内容数据缓冲区、运输方式传输类型然后交给核心层去派送。核心层把URB交给HCDHCD再通过硬件把数据发出去。URB的结构体定义在include/linux/usb.h里字段非常多但常用的就那么几个struct urb { struct usb_device *dev; // 目标设备 unsigned int pipe; // 端点管道包含端点地址和传输类型 int status; // 传输完成后的状态 unsigned int transfer_flags; // 传输标志 void *transfer_buffer; // 数据缓冲区 u32 transfer_buffer_length; // 数据长度 u32 actual_length; // 实际传输长度 void *context; // 完成回调的上下文 usb_complete_t complete; // 完成回调函数 // ... 其他字段 };4.2 四种传输类型USB定义了四种传输类型每种对应不同的应用场景传输类型特点典型用途端点方向控制传输可靠、有保证、用于配置枚举、类请求双向中断传输周期性、低延迟、数据量小键盘、鼠标单向批量传输可靠、无带宽保证、数据量大U盘、打印机单向等时传输实时、有带宽保证、不重传音频、视频单向选择哪种传输类型取决于设备的功能需求。比如U盘用批量传输因为要保证数据正确性但可以容忍延迟。摄像头用等时传输因为视频流不能等丢几帧没关系。4.3 URB的完整生命周期一个URB从创建到销毁经历这几个阶段分配usb_alloc_urb()分配URB结构体。填充根据传输类型用usb_fill_bulk_urb()、usb_fill_int_urb()等函数填充字段。提交usb_submit_urb()把URB提交给核心层。传输HCD从队列里取出URB通过硬件完成数据传输。完成回调传输结束后HCD调用URB的complete回调函数。释放usb_free_urb()释放URB。这里有个容易踩的坑完成回调是在中断上下文里执行的所以回调函数里不能做耗时操作不能睡眠。如果需要处理大量数据应该在回调里唤醒一个工作队列或者tasklet。4.4 实操写一个简单的URB提交示例#include linux/module.h #include linux/usb.h #include linux/slab.h static void my_complete(struct urb *urb) { if (urb-status 0) { pr_info(transfer completed, actual length: %u\n, urb-actual_length); } else { pr_err(transfer failed, status: %d\n, urb-status); } } static int my_send_data(struct usb_device *udev, unsigned int ep) { struct urb *urb; char *buf; int ret; urb usb_alloc_urb(0, GFP_KERNEL); if (!urb) return -ENOMEM; buf kmalloc(64, GFP_KERNEL); if (!buf) { usb_free_urb(urb); return -ENOMEM; } memcpy(buf, hello usb, 10); usb_fill_bulk_urb(urb, udev, usb_sndbulkpipe(udev, ep), buf, 10, my_complete, NULL); ret usb_submit_urb(urb, GFP_KERNEL); if (ret) { pr_err(submit urb failed: %d\n, ret); kfree(buf); usb_free_urb(urb); return ret; } return 0; }这段代码展示了URB的基本用法。实际驱动里通常会在probe函数里分配URB在disconnect里释放中间根据需要反复提交。提示usb_submit_urb的第二个参数是GFP标志。如果在原子上下文比如中断处理里提交URB必须用GFP_ATOMIC。5. 驱动匹配机制核心层如何找到对的驱动5.1 匹配的三种方式USB核心层匹配驱动主要看三个东西设备ID表驱动注册时提供一个usb_device_id数组里面列出支持的VID/PID组合。类代码匹配如果设备ID表里有USB_DEVICE_INFO宏核心层会根据设备类、子类、协议来匹配。接口类匹配对于标准类设备如HID、存储、音频核心层会根据接口描述符里的类代码匹配对应的类驱动。匹配的入口在drivers/usb/core/driver.c的usb_device_match()函数。它先尝试匹配接口驱动如果没找到再尝试匹配设备驱动。5.2 编写设备ID表static const struct usb_device_id my_usb_ids[] { { USB_DEVICE(0x1234, 0x5678) }, // 匹配特定VID/PID { USB_DEVICE_VER(0x1234, 0x5678, 0x0100, 0x0100) }, // 匹配版本 { USB_INTERFACE_INFO(USB_CLASS_HID, 0, 0) }, // 匹配HID类 { } // 结束标记 }; MODULE_DEVICE_TABLE(usb, my_usb_ids);MODULE_DEVICE_TABLE这个宏很重要它会把设备ID表导出到模块信息里这样用户空间工具如udev就能知道这个模块支持哪些设备实现自动加载。5.3 probe和disconnect的职责驱动的probe函数在匹配成功后调用主要做这几件事检查设备是否真的可用有些设备ID表匹配了但实际功能可能不支持。分配驱动私有数据结构。初始化端点、URB、工作队列等资源。向子系统注册比如注册为input设备、网络设备、块设备。保存usb_interface的私有数据指针。disconnect函数在设备拔出或驱动卸载时调用负责反向清理向子系统注销。取消所有已提交的URB。释放所有分配的资源。等待所有回调完成。注意disconnect里必须先usb_kill_urb()或usb_poison_urb()取消URB再释放资源。否则回调可能在资源释放后执行导致use-after-free。6. 常见问题与排查技巧实录6.1 设备识别不了怎么办这是最常见的问题。排查思路从下往上走排查步骤命令/方法判断依据1. 硬件连接dmesgtail2. 端口状态cat /sys/bus/usb/devices/usb1/1-1/port_status看端口是否检测到连接3. 枚举日志dmesggrep usb4. 描述符读取lsusb -v看描述符是否完整5. 驱动匹配ls /sys/bus/usb/drivers/看设备是否绑定了驱动如果dmesg里连“new device”都没有那大概率是硬件问题或者HCD驱动没加载。如果有“new device”但枚举失败通常是描述符有问题或者供电不足。6.2 传输超时怎么排查URB传输超时urb-status会是-ETIMEDOUT。常见原因端点地址错了检查usb_sndbulkpipe()或usb_rcvbulkpipe()的参数。设备没准备好有些设备需要先发送特定命令才能开始传输。缓冲区问题DMA缓冲区没有正确映射或者用了栈上的缓冲区。带宽不足等时传输特别容易遇到需要调整轮询间隔。我遇到过一次批量传输超时查了半天发现是端点方向搞反了。usb_sndbulkpipe用于发送主机到设备usb_rcvbulkpipe用于接收设备到主机。这个错误很隐蔽因为提交URB不会报错只有传输完成时才返回错误。6.3 驱动加载了但probe没调用这种情况通常是设备ID表没匹配上。检查方法# 查看设备实际使用的驱动 ls -l /sys/bus/usb/devices/1-1:1.0/driver # 查看驱动支持的设备列表 cat /sys/bus/usb/drivers/my_driver/new_id如果driver链接指向的不是你的驱动说明匹配失败。可以用echo往new_id里写VID/PID手动触发匹配echo 1234 5678 /sys/bus/usb/drivers/my_driver/new_id6.4 独家避坑经验坑一在probe里做耗时操作。probe是在USB核心层的上下文里调用的如果probe里做太多耗时操作比如等待设备响应会阻塞整个枚举流程。正确的做法是把耗时操作放到工作队列里异步执行。坑二忘记处理-EPROTO错误。USB传输过程中设备可能会返回-EPROTO协议错误。有些驱动只处理-ETIMEDOUT遇到-EPROTO就崩溃了。实际上-EPROTO通常意味着设备端有问题驱动应该优雅地处理而不是直接报错退出。坑三URB重复提交。同一个URB在完成之前不能再次提交。如果驱动逻辑里没有检查URB状态就重复提交会导致内核警告甚至崩溃。正确的做法是在完成回调里重新提交或者用标志位控制。坑四忽略电源管理。USB设备支持运行时电源管理runtime PM。如果驱动没有正确处理autosuspend设备可能会在传输过程中被挂起导致传输失败。建议在probe里调用usb_enable_autosuspend()并在传输前调用usb_autopm_get_interface()。7. 从零写一个USB驱动完整实操流程7.1 驱动骨架搭建一个最小的USB驱动包含这几部分#include linux/module.h #include linux/usb.h #include linux/slab.h #define DRIVER_NAME my_usb_driver struct my_dev { struct usb_device *udev; struct usb_interface *intf; struct urb *rx_urb; char *rx_buf; }; static int my_probe(struct usb_interface *intf, const struct usb_device_id *id) { struct my_dev *dev; struct usb_endpoint_descriptor *ep; int ret; dev kzalloc(sizeof(*dev), GFP_KERNEL); if (!dev) return -ENOMEM; dev-udev interface_to_usbdev(intf); dev-intf intf; /* 查找批量输入端点 */ ret usb_find_common_endpoints(intf-cur_altsetting, NULL, NULL, ep, NULL); if (ret) { dev_err(intf-dev, no bulk endpoint found\n); goto err_free; } dev-rx_buf kmalloc(512, GFP_KERNEL); if (!dev-rx_buf) { ret -ENOMEM; goto err_free; } dev-rx_urb usb_alloc_urb(0, GFP_KERNEL); if (!dev-rx_urb) { ret -ENOMEM; goto err_buf; } usb_fill_bulk_urb(dev-rx_urb, dev-udev, usb_rcvbulkpipe(dev-udev, ep-bEndpointAddress), dev-rx_buf, 512, my_rx_complete, dev); usb_set_intfdata(intf, dev); ret usb_submit_urb(dev-rx_urb, GFP_KERNEL); if (ret) { dev_err(intf-dev, submit rx urb failed: %d\n, ret); goto err_urb; } dev_info(intf-dev, my_usb_driver probed\n); return 0; err_urb: usb_free_urb(dev-rx_urb); err_buf: kfree(dev-rx_buf); err_free: kfree(dev); return ret; } static void my_disconnect(struct usb_interface *intf) { struct my_dev *dev usb_get_intfdata(intf); usb_kill_urb(dev-rx_urb); usb_free_urb(dev-rx_urb); kfree(dev-rx_buf); kfree(dev); usb_set_intfdata(intf, NULL); dev_info(intf-dev, my_usb_driver disconnected\n); } static const struct usb_device_id my_ids[] { { USB_DEVICE(0x1234, 0x5678) }, { } }; MODULE_DEVICE_TABLE(usb, my_ids); static struct usb_driver my_driver { .name DRIVER_NAME, .id_table my_ids, .probe my_probe, .disconnect my_disconnect, }; module_usb_driver(my_driver); MODULE_LICENSE(GPL); MODULE_AUTHOR(Your Name); MODULE_DESCRIPTION(A minimal USB driver example);7.2 编译和加载obj-m my_usb_driver.o KDIR : /lib/modules/$(shell uname -r)/build PWD : $(shell pwd) all: make -C $(KDIR) M$(PWD) modules clean: make -C $(KDIR) M$(PWD) clean编译后加载make sudo insmod my_usb_driver.ko dmesg | tail -20如果设备ID匹配上了应该能看到probe的日志。如果没看到检查lsusb确认VID/PID是否正确。7.3 调试技巧动态调试在drivers/usb/core/里打开CONFIG_USB_DEBUG可以看到详细的枚举日志。usbmon抓USB数据包的神器。加载usbmon模块后用tcpdump -i usbmon1就能抓到总线上的数据。ftrace跟踪usb_submit_urb和usb_complete_urb的调用分析URB的生命周期。# 使用usbmon抓包 sudo modprobe usbmon sudo tcpdump -i usbmon1 -w usb.pcap # 然后用wireshark打开usb.pcap分析提示usbmon抓到的数据包格式和网络包类似但协议解析需要专门的USB解析器。Wireshark内置了USB解析功能可以直接看到描述符、控制传输、批量传输的内容。8. 类驱动与子系统集成8.1 USB存储驱动的工作方式usb-storage是最典型的类驱动。它的工作流程是匹配到USB存储设备接口类代码为USB_CLASS_MASS_STORAGE。创建一个SCSI主机适配器scsi_host。把USB批量传输封装成SCSI命令。向SCSI子系统注册让上层看到的是一个标准的SCSI磁盘。这样设计的好处是USB存储设备对上层来说就是一个SCSI磁盘不需要为USB存储单独写文件系统或块设备驱动。SCSI子系统已经有一套完整的块设备管理机制直接复用就行。8.2 HID驱动与输入子系统usbhid驱动负责键盘、鼠标等HID设备。它把USB中断传输收到的数据解析成输入事件然后通过input_report_key()、input_report_rel()等函数上报给输入子系统。输入子系统再分发给用户空间的evdev接口。这种集成方式让USB键盘和PS/2键盘在用户空间看起来完全一样应用程序不需要关心底层是USB还是PS/2。8.3 网络设备驱动USB网卡驱动如asix、r8152把USB批量传输封装成网络数据包通过netdev接口注册到网络子系统。上层看到的就是一个标准的以太网接口可以用ifconfig、ip等命令管理。9. 性能优化与调试进阶9.1 提高批量传输吞吐量批量传输的吞吐量受几个因素影响URB大小URB的transfer_buffer_length越大单次传输的数据越多但延迟也越大。通常设置成端点最大包长的整数倍。URB数量同时提交多个URBURB流水线可以掩盖传输延迟。比如提交4个URB一个在传输时其他在排队。DMA映射使用usb_alloc_coherent()分配DMA一致性缓冲区避免每次传输都做DMA映射。我实测下来把URB大小从512字节提高到16KB同时提交4个URBU盘读写速度能提升30%以上。9.2 减少中断传输延迟中断传输的延迟主要取决于轮询间隔bInterval。对于HID设备通常设置成1~10ms。如果对延迟敏感可以适当减小轮询间隔但会增加总线负载。9.3 用perf分析USB性能# 跟踪usb_submit_urb的调用次数和耗时 sudo perf probe --add usb_submit_urb sudo perf record -e probe:usb_submit_urb -a sleep 10 sudo perf report这个命令可以统计一段时间内URB提交的频率和分布帮助定位性能瓶颈。10. 我踩过的那些坑写USB驱动这几年踩过的坑真不少。有一次调试一个USB转串口设备枚举正常驱动也probe成功了但就是收不到数据。查了两天最后发现是端点描述符里的wMaxPacketSize字段被设备厂商填错了实际能收64字节描述符里写的是8字节。这种硬件层面的坑只能靠抓包和对比分析来定位。还有一次驱动在x86上跑得好好的换到ARM平台上就各种超时。后来发现是DMA缓存一致性问题ARM平台需要显式调用dma_sync_single_for_cpu()来同步缓存。这个坑让我深刻理解了为什么USB驱动里到处是DMA相关的API。最坑的一次是电源管理。设备在空闲时被自动挂起然后应用层发数据时驱动直接提交URB结果因为设备还在挂起状态传输一直失败。正确的做法是在提交URB前调用usb_autopm_get_interface()传输完成后调用usb_autopm_put_interface()。这个细节在文档里写得很隐蔽但实际项目中非常关键。如果你也在写USB驱动我的建议是先把usbmon用熟再把ftrace用熟最后把电源管理搞清楚。这三样东西掌握了大部分USB问题都能自己解决。