Linux那些事儿 之 戏说USB(16)配置

接着看usb设备的配置吧，在include/linux/usb.h里定义

struct usb_host_config {
	struct usb_config_descriptor	desc;

	char *string;		/* iConfiguration string, if present */

	/* List of any Interface Association Descriptors in this
	 * configuration. */
	struct usb_interface_assoc_descriptor *intf_assoc[USB_MAXIADS];

	/* the interfaces associated with this configuration,
	 * stored in no particular order */
	struct usb_interface *interface[USB_MAXINTERFACES];

	/* Interface information available even when this is not the
	 * active configuration */
	struct usb_interface_cache *intf_cache[USB_MAXINTERFACES];

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

desc，四大描述符里最后的一个终于出现了，同样是在它们的老巢include/uapi/linux/usb/ch9.h里定义

struct usb_config_descriptor {
	__u8  bLength;
	__u8  bDescriptorType;

	__le16 wTotalLength;
	__u8  bNumInterfaces;
	__u8  bConfigurationValue;
	__u8  iConfiguration;
	__u8  bmAttributes;
	__u8  bMaxPower;
} __attribute__ ((packed));

#define USB_DT_CONFIG_SIZE		9

bLength，描述符的长度，值为USB_DT_CONFIG_SIZE。
bDescriptorType，描述符的类型，值为USB_DT_CONFIG，0x02。这么说对不对？按照前面接口描述符、端点描述符和设备描述符的习惯来说，应该是没问题。但是，生活总是会在我们已经习惯它的时候来个转折，这里的值却并不仅仅可以为USB_DT_CONFIG，还可以为USB_DT_OTHER_SPEED_CONFIG，0x07。这里说的OTHER_SPEED_CONFIG描述符描述的是高速设备操作在低速或全速模式时的配置信息，和配置描述符的结构完全相同，区别只是描述符的类型不同，是只有名字不同的孪生兄弟。
wTotalLength，使用GET_DESCRIPTOR请求从设备里获得配置描述符信息时，返回的数据长度，也就是说对包括配置描述符、接口描述符、端点描述符，class-或vendor-specific描述符在内的所有描述符算了个总帐。
bNumInterfaces，这个配置包含的接口数目。
bConfigurationValue，对于拥有多个配置的幸运设备来说，可以拿这个值为参数，使用SET_CONFIGURATION请求来改变正在被使用的 USB配置，bConfigurationValue就指明了将要激活哪个配置。咱们的设备虽然可以有多个配置，但同一时间却也只能有一个配置被激活。捎带着提一下，SET_CONFIGURATION请求也是标准的设备请求之一，专门用来设置设备的配置。
iConfiguration，描述配置信息的字符串描述符的索引值。
bmAttributes，这个字段表征了配置的一些特点，比如bit 6为1表示self-powered，bit 5为1表示这个配置支持远程唤醒。另外，它的bit 7必须为1，为什么？协议里就这么说的，我也不知道，这个世界上并不是什么事情都找得到原因的。ch9.h里有几个相关的定义

/* from config descriptor bmAttributes */
#define USB_CONFIG_ATT_ONE		(1 << 7)	/* must be set */
#define USB_CONFIG_ATT_SELFPOWER	(1 << 6)	/* self powered */
#define USB_CONFIG_ATT_WAKEUP		(1 << 5)	/* can wakeup */
#define USB_CONFIG_ATT_BATTERY		(1 << 4)	/* battery powered */

bMaxPower，设备正常运转时，从总线那里分得的最大电流值，以2mA为单位。设备可以使用这个字段向hub表明自己需要的的电流，但如果设备需求过于旺盛，请求的超出了hub所能给予的，hub就会直接拒绝，不会心软。还记得struct usb_device结构里的bus_mA吗？它就表示hub所能够给予的。Alan Stern大侠告诉我们
(c->desc.bMaxPower * 2) is what the device requests and udev->bus_mA is what the hub makes available.
到此为止，四大标准描述符已经全部登场亮相了，还是回到struct usb_host_config结构的string，这个字符串保存了配置描述符iConfiguration字段对应的字符串描述符信息。
interface[USB_MAXINTERFACES]，配置所包含的接口。注释里说的很明确，这个数组的顺序未必是按照配置里接口号的顺序，所以你要想得到某个接口号对应的struct usb_interface结构对象，就必须使用drivers/usb/usb.c里定义的 usb_ifnum_to_if 函数。

struct usb_interface *usb_ifnum_to_if(const struct usb_device *dev,
				      unsigned ifnum)
{
	struct usb_host_config *config = dev->actconfig;
	int i;

	if (!config)
		return NULL;
	for (i = 0; i < config->desc.bNumInterfaces; i++)
		if (config->interface[i]->altsetting[0]
				.desc.bInterfaceNumber == ifnum)
			return config->interface[i];

	return NULL;
}
EXPORT_SYMBOL_GPL(usb_ifnum_to_if);

这个函数的道理很简单，就是拿你指定的接口号，和当前配置的每一个接口可选设置0里的接口描述符的bInterfaceNumber字段做比较，相等了，那个接口就是你要寻找的，都不相等，那对不起，不能满足你的要求，虽然它已经尽力了。
如果你看了协议，可能会在9.6.5里看到，请求配置描述符时，配置里的所有接口描述符是按照顺序一个一个返回的。那为什么这里又明确说明，让咱们不要期待它就会是接口号的顺序那？其实很久很久以前这里并不是这么说地，它就说这个数组是按照0..desc.bNumInterfaces的顺序，但同时又说需要通过usb_ifnum_to_if 函数来获得指定接口号的接口对象，Alan Stern大侠质疑了这种有些矛盾的说法，于是David Brownell大侠就把它改成现在这个样子了，为什么改？因为协议归协议，厂商归厂商，有些厂商就是有不遵守协议的癖好，它非要先返回接口1再返回接口0，你也没辙，所以就不得不增加usb_ifnum_to_if函数。
USB_MAXINTERFACES是include/linux/usb.h里定义的一个宏，值为32，不要说不够用，谁见过有很多接口的设备？

/* this maximum is arbitrary */
#define USB_MAXINTERFACES	32

intf_cache[USB_MAXINTERFACES]，cache是什么？缓存。答对了。这是个struct usb_interface_cache对象的结构数组，usb_interface，usb接口，cache，缓存，所以usb_interface_cache就是usb接口的缓存。缓存些什么？看看include/linux/usb/usb.h里的定义

struct usb_interface_cache {
	unsigned num_altsetting;	/* number of alternate settings */
	struct kref ref;		/* reference counter */

	/* variable-length array of alternate settings for this interface,
	 * stored in no particular order */
	struct usb_host_interface altsetting[0];
};

altsetting[0]是一个可变长数组，按需分配的那种，你对设备说GET_DESCRIPTOR的时候，内核就根据返回的每个接口可选设置的数目分配给intf_cache数组相应的空间，有多少需要多少分配多少，在咱们还在为拥有一套房而奋斗终生的时候，这里已经提前步入了共产主义。
为什么要缓存这些东东？设备的配置会变，此时这个配置可能还在使用，彼时它可能就在等待。这就叫此一时彼一时。为了在配置被取代之后仍然能够获取它的一些信息，就把日后可能会需要的一些东东放在了intf_cache数组的struct usb_interface_cache对象里。谁会需要？这么说吧，你通过sysfs这个窗口只能看到设备当前配置的一些信息，即使是这个配置下面的接口，也只能看到接口正在使用的那个可选设置的信息，可是你希望能够看到更多的，怎么办，窗户太小了，可以趴门口看，usbfs就是这个门，里面显示有你的系统中所有usb设备的可选配置和端点信息，它就是利用intf_cache这个数组里缓存的东东实现的。
extra，extralen，有关额外扩展的描述符的，和struct usb_host_interface里的差不多，只是这里的是针对配置的，如果你使用GET_DESCRIPTOR请求从设备里获得配置描述符信息，它们会紧跟在标准的配置描述符后面返回给你。