usb驱动开发6之端点描述符

学到这里不容易，先说一段故事吧。

二兄弟住一大楼的第80层，某深夜回家忘看通知（内容今夜停电）。

兄弟俩背着沉重的大背包，在楼底下商量一下，决定一鼓作气，爬楼梯回家。两人抖擞精神，开始爬楼。爬到20楼的时候，开始觉得背包很重了。两人商量，决定把背包存在20楼，到时候再回过头来取。卸下了背包，两个人觉得很轻松，说说笑笑地继续往上爬。

爬到40楼的时候，两人已经很累了，就开始互相抱怨指责。哥哥说：你为什么不看通知啊？弟弟说：我忘了看通知这件事，你怎么不提醒我昵？两个人就这样吵吵闹闹，一路吵到60层。

到了这时候，两人实在疲惫不堪，终于懒得吵了，觉得还是应该安安静静地继续爬楼。当他们终于爬完了最后20层，来到了家门口的时候，两个人互相一看，不约而同想起了一件事：钥匙忘在20楼了，在背包里。

其实，这说的就是人的一生。（故事来源 于丹 《论生与死》）

在struct usb_host_interface结构体，我们把struct usb_host_endpoint *endpoint成员忽略了，下面就看这个结构体。

struct usb_host_endpoint {

struct usb_endpoint_descriptor desc;

struct list_head urb_list;

void *hcpriv;

struct ep_device *ep_dev; /* For sysfs info */

unsigned char *extra; /* Extra descriptors */

int extralen;

};

按照我们做事的原则：避重就轻。先不分析usb_interface_descriptor结构体成员，咱们先分析其他简单的。

urb_list表示端点要处理的urb队列。urb是什么？urb可是usb通信的主角，它包含了执行urb传输所需要的所有信息，若要进行usb通信，就得创建一个urb，并且为它赋好值（专业点就是初始化），交给咱们的usb core，它会找到合适的host controller，从而进行具体的数据传输。设备中的每个端点都可以处理一个urb队列，可以理解为urb是内核里对usb传输数据的封装（或者抽象）。基于urb特殊性，会有专题来分析它。

hcpriv，这是提供给HCD（host controller driver）用的。比如等时端点会在里边儿放一个ehci_iso_stream，什么意思？郑板桥告诉我们要难得糊涂，以后会明白的。

ep_dev，这个字段是供sysfs用的。好奇的话可以去/sys下看一看

[root@localhost ep_00]# pwd

/sys/bus/usb/devices/usb1/ep_00

[root@localhost ep_00]# ls

bEndpointAddress bmAttributes direction subsystem wMaxPacketSize

bInterval dev interval type

bLength device power uevent

[root@localhost ep_00]#

ep_00端点目录下的这些文件从哪儿来的？就是在usb_create_ep_files函数里使用ep_dev创建的。

extra和 extralen，有关一些额外扩展的描述符的，和struct usb_host_interface里差不多，只是这里的是针对端点的，如果你请求从设备里获得描述符信息，它们会跟在标准的端点描述符后面返回给你。

再回头看看desc的结构体struct usb_endpoint_descriptor定义

/* USB_DT_ENDPOINT: Endpoint descriptor */

struct usb_endpoint_descriptor {

__u8 bLength;

__u8 bDescriptorType;

__u8 bEndpointAddress;

__u8 bmAttributes;

__le16 wMaxPacketSize;

__u8 bInterval;

/* NOTE: these two are _only_ in audio endpoints. */

/* use USB_DT_ENDPOINT*_SIZE in bLength, not sizeof. */

__u8 bRefresh;

__u8 bSynchAddress;

} __attribute__ ((packed));

这个结构与spec Table 9.13是一一对应的，0号端点仍然保持着它特殊的地位，它没有自己的端点描述符。

bLength，描述符的字节长度。数一下，前边儿有7个字节，后边儿又多了两个字节__u8 bRefresh; __u8 bSynchAddress;那是针对音频设备扩展的，不用管它

bDescriptorType，描述符类型，这里对于端点就是USB_DT_ENDPOINT，0x05，紧接在usb_endpoint_descriptor结构体定义后面。还记得对于接口描述符类型是什么吗？对，值为USB_DT_INTERFACE，也就是0x04。

bEndpointAddress，这个字段描述的信息挺多的，比如这个端点是输入端点还是输出端点，这个端点的地址，以及这个端点的端点号。它的bits 0~3表示的就是端点号，你使用0x0f和它相与就可以得到端点号。不过，开发内核的同志想的都很周到，定义好了一个掩码USB_ENDPOINT_NUMBER_MASK，它的值就是0x0f，当然，这是为了让咱们更容易去读他们的代码，也为了以后的扩展。另外，它的bit 8表示方向，输入还是输出，同样有掩码USB_ENDPOINT_DIR_MASK，值为0x80，将它和bEndpointAddress相与，并结合USB_DIR_IN和USB_DIR_OUT作判断就可以得到端点的方向。使用下面两个定义值表示端点传输方向：

#define USB_DIR_OUT 0 /* to device */

#define USB_DIR_IN 0x80 /* to host */

bmAttributes，属性，总共8位，其中bit1和bit0 共同称为Transfer Type,即传输类型， 00 表示控制，01 表示等时，10 表示批量，11 表示中断。前面的端点号还有端点方向都有配对儿的掩码，这里当然也有，就在struct usb_endpoint_descriptor定义的下面。

/*

* USB types, the second of three bRequestType fields

*/

#define USB_TYPE_MASK (0x03 << 5)

#define USB_TYPE_STANDARD (0x00 << 5)

#define USB_TYPE_CLASS (0x01 << 5)

#define USB_TYPE_VENDOR (0x02 << 5)

#define USB_TYPE_RESERVED (0x03 << 5)

wMaxPacketSize，端点一次可以处理的最大字节数。如果你发送的数据量大于端点的这个值，也会分成多次一次一次来传输。友情提醒一下，这个字段还是有点门道的，对不同的传输类型也有不同的要求，以后可以再说。

bInterval， USB是轮询式的总线，这个值表达了端点一种美好的期待，希望主机轮询自己的时间间隔，但实际上批准不批准是host的事。不同的传输类型bInterval也有不同的意义，以后碰到各个实际的传输类型也可以再说。