Linux系统中USB驱动程序的工作流程详解

1.usb主机
在linux驱动中，usb驱动处于最底层的是usb主机控制器硬件，在其之上运行的是usb主机控制器驱动，主机控制器之上为usb核心层，再上层为usb设备驱动层（插入主机上的u盘、鼠标、usb转串口等设备驱动）。

因此，在主机侧的层次结构中，要实现的usb驱动包括两类：usb主机控制器驱动和usb设备驱动，前者控制插入其中的usb设备，后者控制usb设备如何与主机通信。linux内核usb核心负责usb驱动管理和协议处理的主要工作。主机控制器驱动和设备驱动之间的usb核心非常重要，其功能包括：通过定义一些数据结构、宏和功能函数，向上为设备驱动提供编程接口，向下为usb主机控制器驱动提供编程接口；通过全局变量维护整个系统的usb设备信息；完成设备热插拔控制、总线数据传输控制等。

2.usb设备
linux内核中usb设备侧驱动程序分为3个层次：udc驱动程序、gadget api和gadget驱动程序。udc驱动程序直接访问硬件，控制usb设备和主机间的底层通信，向上层提供与硬件相关操作的回调函数。当前gadget api是udc驱动程序回调函数的简单包装。gadget驱动程序具体控制usb设备功能的实现，使设备表现出“网络连接”、“打印机”或“usb mass storage”等特性，它使用gadget api控制udc实现上述功能。gadget api把下层的udc驱动程序和上层的gadget驱动程序隔离开，使得在linux系统中编写usb设备侧驱动程序时能够把功能的实现和底层通信分离。

3.层次
在usb设备组织结构中，从上到下分为设备（device）、配置（config）、接口（interface）和端点（endpoint）四个层次。usb设备程序绑定到接口上。
对于这四个层次的简单描述如下：
（1）设备通常具有一个或多个的配置
（2）配置经常具有一个或多个的接口
（3）接口没有或具有一个以上的端点

4.端点
usb通信最基本的形式是通过端点（usb端点分中断（interrupt)、批量(bulk)、等时(iso)、控制(control)四种，每种用途不同），usb端点只能往一个方向传送数据，从主机到设备或者从设备到主机，端点可以看作是单向的管道（pipe）。驱动程序把驱动程序对象注册到usb子系统中，稍后再使用制造商和设备标识来判断是否已经安装了硬件。usb核心使用一个列表（是一个包含制造商id和设备号id的一个结构体）来判断对于一个设备该使用哪一个驱动程序，热插拨脚本使用它来确定当一个特定的设备插入到系统时该自动执行哪一个驱动程序的probe。

5. 数据结构
（1）usb设备：对应数据结构struct usb_device
（2）配置：struct usb_host_config （任一时刻，只能有一个配置生效）
（3）usb接口：struct usb_interface （usb 核心将其传递给usb设备驱动，并由usb设备驱动负责后续的控制。一个usb接口代表一个基本功能，每个usb驱动控制一个接口。所以一个物理上的硬件设备可能需要 一个以上的驱动程序。）
（4）端点: struct usb_host_endpoint ，它所包含的真实端点信息在另一个结构中：struct usb_endpoint_descriptor（端点描述符，包含所有的usb特定数据）。

6. usb端点分类
usb 通讯的最基本形式是通过一个称为端点的东西。一个usb端点只能向一个方向传输数据（从主机到设备(称为输出端点)或者从设备到主机(称为输入端点)）。端点可被看作一个单向的管道。
usb 端点有 4 种不同类型, 分别具有不同的数据传送方式：
（1）控制control
控制端点被用来控制对usb设备的不同部分访问. 通常用作配置设备、获取设备信息、发送命令到设备或获取设备状态报告。这些端点通常较小。每个 usb 设备都有一个控制端点称为"端点 0", 被 usb 核心用来在插入时配置设备。usb协议保证总有足够的带宽留给控制端点传送数据到设备.
（2）中断interrupt
每当 usb 主机向设备请求数据时，中断端点以固定的速率传送小量的数据。此为usb 键盘和鼠标的主要的数据传送方法。它还用以传送数据到usb设备来控制设备。通常不用来传送大量数据。usb协议保证总有足够的带宽留给中断端点传送数据到设备.
（3）批量bulk
批量端点用以传送大量数据。这些端点通常比中断端点大得多. 它们普遍用于不能有任何数据丢失的情况。usb 协议不保证传输在特定时间范围内完成。如果总线上没有足够的空间来发送整个bulk包，它被分为多个包进行传输。这些端点普遍用于打印机、usb mass storage和usb网络设备上。
（4）等时isochronous
等时端点也批量传送大量数据, 但是这个数据不被保证能送达。这些端点用在可以处理数据丢失的设备中，并且更多依赖于保持持续的数据流。如音频和视频设备等等。
控制和批量端点用于异步数据传送，而中断和等时端点是周期性的。这意味着这些端点被设置来在固定的时间连续传送数据，usb 核心为它们保留了相应的带宽。

7. endpoint

c/c++ code复制内容到剪贴板

1. struct usb_host_endpoint{   
2.     struct usb_endpoint_descriptor desc;//端点描述符   
3.     struct list_head urb_list;//此端点的urb对列，由usb核心维护   
4.     void *hcpriv;   
5.     struct ep_device *ep_dev; /* for sysfs info */  
6.     unsigned char*extra;/* extra descriptors */  
7.     int extralen;   
8.     int enabled;   
9. };  

当调用usb设备驱动调用usb_submit_urb提交urb请求时，将调用int usb_hcd_link_urb_to_ep(struct usb_hcd *hcd, struct urb *urb)把此urb增加到urb_list的尾巴上。(hcd: host controller driver,对应数据结构struct usb_hcd )

8. urb
所有usb通讯均为请求-->响应模式，usb设备不会主动向host发送数据。写数据：usb设备驱动发送urb请求给usb设备，usb设备不需要回数据。读数据：usb设备驱动发送urb请求给usb设备，usb设备需要回数据。
usb 设备驱动通过urb和所有的 usb 设备通讯。urb用 struct urb 结构描述（include/linux/usb.h ）。
urb 以一种异步的方式同一个特定usb设备的特定端点发送或接受数据。一个 usb 设备驱动可根据驱动的需要，分配多个 urb 给一个端点或重用单个 urb 给多个不同的端点。设备中的每个端点都处理一个 urb 队列, 所以多个 urb 可在队列清空之前被发送到相同的端点。
一个 urb 的典型生命循环如下:
（1）被创建；
（2）被分配给一个特定 usb 设备的特定端点；
（3）被提交给 usb 核心；
（4）被 usb 核心提交给特定设备的特定 usb 主机控制器驱动；
（5）被 usb 主机控制器驱动处理, 并传送到设备；
（6）以上操作完成后，usb主机控制器驱动通知 usb 设备驱动。
urb 也可被提交它的驱动在任何时间取消；如果设备被移除，urb 可以被usb核心取消。urb 被动态创建并包含一个内部引用计数，使它们可以在最后一个用户释放它们时被自动释放。

8.1 提交 urb
一旦 urb 被正确地创建并初始化, 它就可以提交给 usb 核心以发送出到 usb 设备. 这通过调用函数sb_submit_urb 实现.
int usb_submit_urb(struct urb *urb, gfp_t mem_flags);
参数：
struct urb *urb :指向被提交的 urb 的指针
gfp_t mem_flags :使用传递给 kmalloc 调用同样的参数, 用来告诉 usb 核心如何及时分配内存缓冲
因为函数 usb_submit_urb 可被在任何时候被调用(包括从一个中断上下文), mem_flags 变量必须正确设置. 根据 usb_submit_urb 被调用的时间,只有 3 个有效值可用:
gfp_atomic
只要满足以下条件,就应当使用此值:
1) 调用者处于一个 urb 结束处理例程,中断处理例程,底半部,tasklet或者一个定时器回调函数.
2) 调用者持有自旋锁或者读写锁. 注意如果正持有一个信号量, 这个值不必要.
3) current->state 不是 task_running. 除非驱动已自己改变 current 状态,否则状态应该一直是task_running .
gfp_noio
驱动处于块 i/o 处理过程中. 它还应当用在所有的存储类型的错误处理过程中.
gfp_kernel
所有不属于之前提到的其他情况
在 urb 被成功提交给 usb 核心之后, 直到结束处理例程函数被调用前,都不能访问 urb 结构的任何成员

8.2 urb结束处理例程
如果 usb_submit_urb 被成功调用, 并把对 urb 的控制权传递给 usb 核心, 函数返回 0; 否则返回一个负的错误代码. 如果函数调用成功, 当 urb 被结束的时候结束处理例程会被调用一次.当这个函数被调用时, usb 核心就完成了这个urb, 并将它的控制权返回给设备驱动.
只有3 种结束urb并调用结束处理例程的情况:
(1)urb 被成功发送给设备, 且设备返回正确的确认.如果这样, urb 中的status变量被设置为 0.
(2)发生错误, 错误值记录在 urb 结构中的 status 变量.
(3)urb 从 usb 核心unlink. 这发生在要么当驱动通过调用 usb_unlink_urb 或者 usb_kill_urb告知 usb 核心取消一个已提交的 urb,或者在一个 urb 已经被提交给它时设备从系统中去除.

9. 探测和断开
在 struct usb_driver 结构中, 有 2 个 usb 核心在适当的时候调用的函数：
(1)当设备插入时, 如果 usb 核心认为这个驱动可以处理(usb核心使用一个列表（是一个包含制造商id和设备号id的一个结构体）来判断对于一个设备该使用哪一个驱动程序)，则调用探测（probe）函数，探测函数检查传递给它的设备信息, 并判断驱动是否真正合适这个设备.
(2)由于某些原因，设备被移除或驱动不再控制设备时，调用断开（disconnect）函数，做适当清理.
探测和断开回调函数都在usb集线器内核线程上下文中被调用, 因此它们休眠是合法的. 为了缩短 usb 探测时间，大部分工作尽可能在设备打开时完成.这是因为 usb 核心是在一个线程中处理 usb 设备的添加和移除, 因此任何慢设备驱动都可能使 usb 设备探测时间变长。

9.1探测函数分析
在探测回调函数中, usb设备驱动应当初始化它可能用来管理 usb 设备的所有本地结构并保存所有需要的设备信息到本地结构, 因为在此时做这些通常更容易.为了和设备通讯，usb 驱动通常要探测设备的端点地址和缓冲大小.     

ps：linux usb驱动相关细节知识补充
1. 在usb_fill_bulk_urb,usb_fill_int_urb，usb_fill_control_urb都需要指定回调函数，当此urb请求完成时，usb core回调用此函数。
注意：urb 回调函数是在中断上下文运行, 因此它不应做任何内存分配, 持有任何信号量, 或任何可导致进程休眠的事情. 如果从回调中提交 urb 并需要分配新内存块, 需使用 gfp_atomic 标志来告知 usb 核心不要休眠.

2. urb封装函数：
（1）int usb_bulk_msg(struct usb_device *usb_dev,unsigned int pipe,void*data, int len, int*actual_length,int timeout)
功能：创建批量 urb 并发送到指定的设备, 接着在返回之前等待完成.
参数：
  struct usb_device *usb_dev :目标 usb 设备指针
  unsigned int pipe :目标 usb 设备的特定端点. 必须使用特定的宏创建.
  void *data :如果是 out 端点, 指向要发送到设备的数据的指针. 如果是 in 端点, 这是从设备读取的数据的缓冲区指针.
  int len : data 参数指向的缓冲的长度
  int *actual_length :指向函数放置真实字节数的指针,根据端点方向,这些字节要么是被发送到设备的,要么是从设备中读取的.
  int timeout :时钟嘀哒数, 应等待的时间. 如果为 0, 函数永远等待操作完成.
返回值：成功返回0,actual_length 参数包含被传送或从设备中读取的字节数.否则返回负的错误值.

（2）int usb_control_msg(struct usb_device*dev, unsigned int pipe, __u8 request,__u8 requesttype, __u16 value, __u16 index,void *data, __u16 size,int timeout)
功能：创建控制 urb 并发送到指定的设备, 接着在返回之前等待完成.
参数：
  struct usb_device *usb_dev :目标 usb 设备指针
  unsigned int pipe :目标 usb 设备的特定端点. 必须使用特定的宏创建.
  __u8 request :控制消息的 usb 请求值.
  __u8 requesttype :控制消息的 usb 请求类型.
  __u16 value :控制消息的 usb 消息值.
  __u16 index :控制消息的 usb 消息索引值.
  void *data :如果是 out 端点, 指向要发送到设备的数据的指针. 如果是 in 端点, 这是从设备读取的数据的缓冲区指针.
  __u16 size : data 参数指向的缓冲的长度
  int timeout :时钟嘀哒数, 应等待的时间. 如果为 0, 函数永远等待操作完成.
返回值：成功返回被传送到或从设备读取的字节数.否则返回负的错误值.

（3）int usb_interrupt_msg(struct usb_device*usb_dev, unsigned int pipe,void *data,int len, int *actual_length,int timeout)
功能：创建中断 urb 并发送到指定的设备, 接着在返回之前等待完成.其实就是usb_bulk_msg的包装,所有参数和usb_bulk_msg一样使用