前面struct usb_interface里表示接口设置的struct usb_host_interface被有意的飘过了,咱们在这节主要讲讲这个结构体,同样在include/linux/usb.h文件里定义。
/* host-side wrapper for one interface setting's parsed descriptors */
struct usb_host_interface {
struct usb_interface_descriptor desc;
/* array of desc.bNumEndpoint endpoints associated with this
* interface setting. these will be in no particular order.
*/
struct usb_host_endpoint *endpoint;
char *string; /* iInterface string, if present */
unsigned char *extra; /* Extra descriptors */
int extralen;
};
和前面分析一下,我们先略过usb_interface_descriptor结构体的分析,大餐总是喜欢最后吃。
endpoint,一个数组,表示这个设置所使用到端点。
string,用来保存从设备里取出来的字符串描述符信息的,既然字符串描述符可有可无,那这里的指针也有可能为空了。
xtra,extralen,关于额外的描述符。除了前面提到的四大描述符还有字符串描述符外,还有为一组设备也就是一类设备定义的描述符,和厂商为设备特别定义的描述符,extra指的就是它们,extralen表示它们的长度。
desc,接口的描述符。前面看了端点描述符,现在又有了接口描述符,那么什么叫描述符呢?实际上,usb的描述符是一个带有预定义格式的数据结构,里面保存了usb设备的各种属性还有相关信息,姓甚名谁啊,哪儿生产的啊等等,我们可以通过向设备请求获得它们的内容来深刻的了解感知一个usb设备。主要有四种usb描述符,设备描述符,配置描述符,接口描述符和端点描述符,协议里规定一个usb设备是必须支持这四大描述符的,当然也有其它一些设备为了显得个性些支持其特有描述符,但这四大描述符是一个都不能少的。
这些描述符放哪儿?当然是在设备里。usb设备里都会有一个叫EEPROM的东东,没错,就是放在它那儿,它就是用来存储设备本身信息的,EEPROM就是电可擦写的可编程ROM,它与Flash虽说都是要电擦除的,但它可以按字节擦除,Flash只能一次擦除一个block,所以如果要改动比较少的数据的话,使用它还是比较合适的,但是世界上没有完美的东西,此物成本相对Flash比较高,所以一般来说usb设备里只拿它来存储一些本身特有的信息,要想存储数据,还是用Flash吧。
具体到接口描述符,它当然就是描述接口本身的信息的。一个接口可以有多个设置,使用不同的设置,描述接口的信息会有些不同,所以接口描述符并没有放在struct usb_interface结构里,而是放在表示接口设置的struct usb_host_interface结构里。定义在include/linux/usb/ch9.h文件里:
/* USB_DT_INTERFACE: Interface descriptor */
struct usb_interface_descriptor {
__u8 bLength;
__u8 bDescriptorType;
__u8 bInterfaceNumber;
__u8 bAlternateSetting;
__u8 bNumEndpoints;
__u8 bInterfaceClass;
__u8 bInterfaceSubClass;
__u8 bInterfaceProtocol;
__u8 iInterface;
} __attribute__ ((packed));
再次强调一下,浏览ch9.h文件里的内容一定要同时对照协议规范去看。__attribute__意思就是告诉编译器,这个结构的元素都是1字节对齐的,不要再添加填充位了。因为这个结构和spec里的Table 9.12是完全一致的,包括字段的长度,如果不给编译器这么个暗示,编译器就会依据你平台的类型在结构的每个元素之间添加一定的填充位,如果你拿这个添加了填充位的结构去向设备请求描述符,你想想会是什么结果。
bLength,描述符的字节长度。协议里规定,每个描述符必须以一个字节打头来表明描述符的长度。接口描述符的bLength应该是9没错,ch9.h文件里紧挨着接口描述符的定义就定义了这个长度。
#define USB_DT_INTERFACE_SIZE 9
bDescriptorType,描述符的类型。各种描述符的类型都在ch9.h文件里有定义,对应spec Table 9.5。对于接口描述符来说,值为USB_DT_INTERFACE,也就是0x04。
#define USB_DT_INTERFACE 0x04
bInterfaceNumber,接口号。每个配置可以包含多个接口,这个值就是它们的索引值。
bAlternateSetting,接口使用的是哪个可选设置。协议里规定,接口默认使用的设置总为0号设置。
bNumEndpoints,接口拥有的端点数量。这里并不包括端点0,端点0是所有的设备都必须提供的,所以这里就没必要多此一举的包括它了。
bInterfaceClass, bInterfaceSubClass, bInterfaceProtocol。这个世界上有许许多多的usb设备,它们各有各的特点,为了区分它们, usb协议规范把usb设备分成了很多类,然而每个类又分成子类。这很好理解,比如我们一个大学,先是分成很多个学院,然后每个学院又被分为很多个系,然后可能每个系下边又分了各个专业。usb协议也是如此,首先每个Device或Interface属于一个Class,然后Class下面又分了SubClass,完了SubClass下面又按各种设备所遵循的不同的通信协议继续细分。usb协议里边为每一种Class,每一种SubClass,每一种Protocol定义一个数值,比如mass storage 的Class就是0x08,hub的Class就是0x09。
iInterface,接口对应的字符串描述符的索引值。除了前面提到的四大描述符,还有字符串描述符,不过那四大描述符是每个设备必须支持的,这个字符串描述符却是可有可无的。
现在总结下怎么分析描述符?一是对照usb协议规范第九章(非常重要,读个十遍吧先),二是采用避重就轻(从小到大)顺序慢慢分析源码,当然你也可以先去看设备描述符,不过我第一次就是这么做的,后来发现很多看着看着就模糊了。所以,从小处着手,相信我们会有突破!!!