Linux那些事儿 之 戏说USB(13)接口是设备的接口(二)

前面struct usb_interface里表示接口设置的struct usb_host_interface就被有意无意的飘过了，咱们在这里看看它的真面目，同样在include/linux/usb.h文件里定义。

struct usb_host_interface {
	struct usb_interface_descriptor	desc;

	int extralen;
	unsigned char *extra;   /* Extra descriptors */

	/* 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 */
};

desc，接口的描述符。什么叫描述符？usb的描述符是一个带有预定义格式的数据结构，里面保存了usb设备的各种属性还有相关信息，姓甚名谁啊，哪儿生产的啊等等，我们可以通过向设备请求获得它们的内容来深刻的了解感知一个usb设备。主要有四种usb描述符，设备描述符，配置描述符，接口描述符和端点描述符，协议里规定一个usb设备是必须支持这四大描述符的，当然也有其它一些描述符来让设备可以显得个性些，但这四大描述符是一个都不能少的。

这些描述符放哪儿？描述符就在设备里，等着主机去拿。具体在哪儿？usb设备里都会有一个叫EEPROM的东东，没错，就是放在它那儿，它就是用来存储设备本身信息的。你应该还会记得EEPROM就是电可擦写的可编程ROM，它与Flash虽说都是要电擦除的，但它可以按字节擦除，Flash只能一次擦除一个block，所以如果要改动比较少的数据的话，使用它还是比较合适的，但是世界上没有完美的东西，此物成本相对Flash比较高，所以一般来说usb设备里只拿它来存储一些本身特有的信息，要想存储数据，还是用Flash吧。

具体到接口描述符，它当然就是描述接口本身的信息的。一个接口可以有多个设置，使用不同的设置，描述接口的信息会有些不同，所以接口描述符并没有放在struct usb_interface结构里，而是放在表示接口设置的struct usb_host_interface结构里。struct usb_interface_descriptor定义在/include/uapi/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));

看到了__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。

bInterfaceNumber，接口号。每个配置可以包含多个接口，这个值就是它们的索引值。
bAlternateSetting，接口使用的是哪个可选设置。协议里规定，接口默认使用的设置总为0号设置。
bNumEndpoints，接口拥有的端点数量。这里并不包括端点0，端点0是所有的设备都必须提供的，所以这里就没必要多此一举的包括它了。
bInterfaceClass，bInterfaceSubClass，bInterfaceProtocol。这个世界上有许许多多的usb设备，它们各有各的特点，为了区分它们，usb规范，或者说usb协议，把usb设备分成了很多类，然而每个类又分成子类，这很好理解，我们一个大学也是如此，先是分成很多个学院，然后每个学院又被分为很多个系，然后可能每个系下边又分了各个专业，usb协议也是这样干的，首先每个Device或Interface属于一个Class，然后Class下面又分了SubClass，完了SubClass下面又按各种设备所遵循的不同的通信协议继续细分。usb协议里边为每一种Class，每一种SubClass，每一种Protocol定义一个数值，比如mass storage 的Class就是0x08，hub的Class就是0x09。

iInterface，接口对应的字符串描述符的索引值。疑？这里怎么又跳出来一个叫字符串描述符的东东？你没看错我也没说错，除了前面提到的四大描述符，是还有字符串描述符，不过那四大描述符是每个设备必须支持的，这个字符串描述符却是可有可无的，有了你欢喜我也欢喜，没有也不是什么问题。使用lsusb命令看一下

localhost:/usr/src/linux/drivers/usb/core # lsusb
Bus 001 Device 013: ID 04b4:1081 Cypress Semiconductor Corp.
Bus 001 Device 001: ID 0000:0000

第一行里显示的是我手边儿的Cypress USB开发板，看里面的Cypress Semiconductor Corp.，这么一长串的东东从哪里来？是不是应该从设备里来？设备的那几个标准描述符，整个描述符的大小也不一定放得下这么一长串，所以，一些设备专门准备了一些字符串描述符（string descriptor），就用来记这些长串的东西。字符串描述符主要就是提供一些设备接口相关的描述性信息，比如厂商的名字，产品序列号等等。字符串描述符当然可以有多个，这里的索引值就是用来区分它们的。

说过了接口描述符，回到struct usb_host_interface，endpoint，一个数组，表示这个设置所使用到端点。至于端点的结构struct usb_host_endpoint，天这么热，让它先一边儿凉快凉快吧，咱们先看完struct usb_host_interface再去说它。

string，用来保存从设备里取出来的字符串描述符信息的，既然字符串描述符可有可无，那这里的指针也有可能为空了。

extra，extralen，关于额外的描述符。除了前面提到的四大描述符还有字符串描述符外，还有为一组设备也就是一类设备定义的描述符，和厂商为设备特别定义的描述符，extra指的就是它们，extralen表示它们的长度。比如上海规定了，社保必须得交多少多少，公积金多少多少，有个最低的比例，有地儿觉得太少，给你多交些，叫补充什么金的，还有些地儿，觉得补充都不过瘾，像公务员........