学到这里不容易,先说一段故事吧。
二兄弟住一大楼的第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也有不同的意义,以后碰到各个实际的传输类型也可以再说。