【转】Linux那些事儿 之 戏说USB(20)配置

越来越觉得USB的 世界是一个理想化的世界,在那里,一个设备可以有多种配置,做不同的事,过不一样的生活,而我们的配置永远只有一个,从生到死,没得选择。所谓的爱情的选 择,职业的选择,在你选择过后再看,似乎冥冥中都有一种神秘的力量在支配着,而我们在其中只不过是上紧的发条,每个人自出生始就被配置了不同的路,你的彷 徨,你的叛逆,你的伤心,你的快乐,都只不过是许多看似的偶然所组成的必然。

我 不是宿命论者,我也经常在夜深人静不能入寐的时候回忆过去的悲欢与离合,惆怅现在的无助与无奈,思索将来要走的路。不过在爱成往事,烟花散尽后,过往的情 形似乎都是不可逆转的必然。这就是所谓的人类一思考上帝就发笑吧,因为他知道你的努力都是徒劳,但是你还不得不去努力,这就是所谓的无奈的人生。

上帝又发笑了,还是接着看usb设备的配置吧,在include/linux/usb.h里定义

206 /**
207  * struct usb_host_config - representation of a device's configuration
208  * @desc: the device's configuration descriptor.
209  * @string: pointer to the cached version of the iConfiguration string, if
210  *      present for this configuration.
211  * @interface: array of pointers to usb_interface structures, one for each
212  *      interface in the configuration.  The number of interfaces is stored
213  *      in desc.bNumInterfaces.  These pointers are valid only while the
214  *      the configuration is active.
215  * @intf_cache: array of pointers to usb_interface_cache structures, one
216  *      for each interface in the configuration.  These structures exist
217  *      for the entire life of the device.
218  * @extra: pointer to buffer containing all extra descriptors associated
219  *      with this configuration (those preceding the first interface
220  *      descriptor).
221  * @extralen: length of the extra descriptors buffer.
222  *
223   * USB devices may have multiple configurations, but only one can be active
224   * at any time.  Each encapsulates a different operational environment;
225   * for example, a dual-speed device would have separate configurations for
226   * full-speed and high-speed operation.  The number of configurations
227   * available is stored in the device descriptor as bNumConfigurations.
228   *
229   * A configuration can contain multiple interfaces.  Each corresponds to
230   * a different function of the USB device, and all are available whenever
231   * the configuration is active.  The USB standard says that interfaces
232   * are supposed to be numbered from 0 to desc.bNumInterfaces-1, but a lot
233   * of devices get this wrong.  In addition, the interface array is not
234   * guaranteed to be sorted in numerical order.  Use usb_ifnum_to_if() to
235   * look up an interface entry based on its number.
236   *
237   * Device drivers should not attempt to activate configurations.  The choice
238   * of which configuration to install is a policy decision based on such
239   * considerations as available power, functionality provided, and the user's
240   * desires (expressed through userspace tools).  However, drivers can call
241   * usb_reset_configuration() to reinitialize the current configuration and
242  * all its interfaces.
243  */
244 struct usb_host_config {
245          struct usb_config_descriptor    desc;
246
247          char *string;           /* iConfiguration string, if present */
248          /* the interfaces associated with this configuration,
249           * stored in no particular order */
250          struct usb_interface *interface[USB_MAXINTERFACES];
251
252          /* Interface information available even when this is not the
253           * active configuration */
254          struct usb_interface_cache *intf_cache[USB_MAXINTERFACES];
255
256          unsigned char *extra;   /* Extra descriptors */
257          int extralen;
258 };

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

250 /* USB_DT_CONFIG: Configuration descriptor information.
251  *
252  * USB_DT_OTHER_SPEED_CONFIG is the same descriptor, except that the
253  * descriptor type is different.  Highspeed-capable devices can look
254  * different depending on what speed they're currently running.  Only
255  * devices with a USB_DT_DEVICE_QUALIFIER have any OTHER_SPEED_CONFIG
256  * descriptors.
257  */
259          __u8  bLength;
260          __u8  bDescriptorType;
261
262          __le16 wTotalLength;
263          __u8  bNumInterfaces;
264          __u8  bConfigurationValue;
265          __u8  iConfiguration;
266          __u8  bmAttributes;
267          __u8  bMaxPower;
268 } __attribute__ ((packed));
269
270 #define USB_DT_CONFIG_SIZE              9

259行,bLength,描述符的长度,值为USB_DT_CONFIG_SIZE

260行,bDescriptorType,描述符的类型,值为USB_DT_CONFIG0x02。这么说对不对?按照前面接口描述符、端点描述符和设备描述符的习惯来说,应该是没问题。但是,生活总是会在我们已经习惯它的时候来个转折,这里的值却并不仅仅可以为USB_DT_CONFIG,还可以为USB_DT_OTHER_SPEED_CONFIG0x07。这里说的OTHER_SPEED_CONFIG描述符描述的是高速设备操作在低速或全速模式时的配置信息,和配置描述符的结构完全相同,区别只是描述符的类型不同,是只有名字不同的孪生兄弟。

262行,wTotalLength,使用GET_DESCRIPTOR请求从设备里获得配置描述符信息时,返回的数据长度,也就是说对包括配置描述符、接口描述符、端点描述符,class-vendor-specific描述符在内的所有描述符算了个总帐。

263行,bNumInterfaces,这个配置包含的接口数目。

263行,bConfigurationValue,对于拥有多个配置的幸运设备来说,可以拿这个值为参数,使用SET_CONFIGURATION请求来改变正在被使用的 USB配置,bConfigurationValue就指明了将要激活哪个配置。咱们的设备虽然可以有多个配置,但同一时间却也只能有一个配置被激活。捎带着提一下,SET_CONFIGURATION请求也是标准的设备请求之一,专门用来设置设备的配置。

265行,iConfiguration,描述配置信息的字符串描述符的索引值。

266行,bmAttributes,这个字段表征了配置的一些特点,比如bit 61表示self-poweredbit 51表示这个配置支持远程唤醒。另外,它的bit 7必须为1,为什么?协议里就这么说的,我也不知道,这个世界上并不是什么事情都找得到原因的。ch9.h里有几个相关的定义

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

267行,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结构的247行,string,这个字符串保存了配置描述符iConfiguration字段对应的字符串描述符信息。

250行,interface[USB_MAXINTERFACES],配置所包含的接口。注释里说的很明确,这个数组的顺序未必是按照配置里接口号的顺序,所以你要想得到某个接口号对应的struct usb_interface结构对象,就必须使用drivers/usb/usb.c里定义的usb_ifnum_to_if函数。

65 /**
66  * usb_ifnum_to_if - get the interface object with a given interface number
67  * @dev: the device whose current configuration is considered
68  * @ifnum: the desired interface
69  *
70  * This walks the device descriptor for the currently active configuration
71  * and returns a pointer to the interface with that particular interface
72  * number, or null.
73  *
74  * Note that configuration descriptors are not required to assign interface
75  * numbers sequentially, so that it would be incorrect to assume that
76  * the first interface in that descriptor corresponds to interface zero.
77  * This routine helps device drivers avoid such mistakes.
78  * However, you should make sure that you do the right thing with any
79  * alternate settings available for this interfaces.
80  *
81  * Don't call this function unless you are bound to one of the interfaces
82  * on this device or you have locked the device!
83  */
84 struct usb_interface *usb_ifnum_to_if(const struct usb_device *dev,
85                                       unsigned ifnum)
86 {
87         struct usb_host_config *config = dev->actconfig;
88         int i;
89
90         if (!config)
91                 return NULL;
92         for (i = 0; i < config->desc.bNumInterfaces; i++)
93                 if (config->interface[i]->altsetting[0]
94                                 .desc.bInterfaceNumber == ifnum)
95                         return config->interface[i];
96
97         return NULL;
98 }

这个函数的道理很简单,就是拿你指定的接口号,和当前配置的每一个接口可选设置0里的接口描述符的bInterfaceNumber字段做比较,相等了,那个接口就是你要寻找的,都不相等,那对不起,不能满足你的要求,虽然它已经尽力了。

如果你看了协议,可能会在 9.6.5 里看到,请求配置描述符时,配置里的所有接口描述符是按照顺序一个一个返回的。那为什么这里又明确说明,让咱们不要期待它就会是接口号的顺序那?其实很久很久以前这里并不是这么说地,它就说这个数组是按照0..desc.bNumInterfaces的顺序,但同时又说需要通过usb_ifnum_to_if函数来获得指定接口号的接口对象,Alan Stern大侠质疑了这种有些矛盾的说法,于是David Brownell大侠就把它改成现在这个样子了,为什么改?因为协议归协议,厂商归厂商,有些厂商就是有不遵守协议的癖好,它非要先返回接口1再返回接口0,你也没辙,所以就不得不增加usb_ifnum_to_if函数。

USB_MAXINTERFACESdrivers/usb/usb.h里定义的一个宏,值为32,不要说不够用,谁见过有很多接口的设备?

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

254行,intf_cache[USB_MAXINTERFACES]cache是什么?缓存。答对了,不然大学四年岂不是光去吃老赵烤肉了。这是个struct usb_interface_cache对象的结构数组,usb_interfaceusb接口,cache,缓存,所以usb_interface_cache就是usb接口的缓存。缓存些什么?看看include/linux/usb/usb.h里的定义

179 /**
180  * struct usb_interface_cache - long-term representation of a device interface
181  * @num_altsetting: number of altsettings defined.
182  * @ref: reference counter.
183  * @altsetting: variable-length array of interface structures, one for
184  *      each alternate setting that may be selected.  Each one includes a
185  *      set of endpoint configurations.  They will be in no particular order.
186  *
187  * These structures persist for the lifetime of a usb_device, unlike
188  * struct usb_interface (which persists only as long as its configuration
189  * is installed).  The altsetting arrays can be accessed through these
190  * structures at any time, permitting comparison of configurations and
191  * providing support for the /proc/bus/usb/devices pseudo-file.
192  */
194          unsigned num_altsetting;        /* number of alternate settings */
195          struct kref ref;                /* reference counter */
196
197          /* variable-length array of alternate settings for this interface,
198          * stored in no particular order */
199          struct usb_host_interface altsetting[0];
200 };

199行的altsetting[0]是一个可变长数组,按需分配的那种,你对设备说GET_DESCRIPTOR的时候,内核就根据返回的每个接口可选设置的数目分配给intf_cache数组相应的空间,有多少需要多少分配多少,在咱们还在为拥有一套房而奋斗终生的时候,这里已经提前步入了共产主义。

为 什么要缓存这些东东?房价在变,物价在变,设备的配置也在变,此时这个配置可能还在欢快的被宠幸着,彼时它可能就躲在冷宫里写《后宫回忆录》,漫长的等待 之后,哪个导演慧眼识剧本发现了它,她就又迎来了自己的第二春。这就叫此一时彼一时。为了在配置被取代之后仍然能够获取它的一些信息,就把日后可能会需要 的一些东东放在了intf_cache数组的struct usb_interface_cache对象里。谁会需要?这么说吧,你通过sysfs这个窗口只能看到设备当前配置的一些信息,即使是这个配置下面的接口,也只能看到接口正在使用的那个可选设置的信息,可是你希望能够看到更多的,怎么办,窗户太小了,可以趴门口看,usbfs就是这个门,里面显示有你的系统中所有usb设备的可选配置和端点信息,它就是利用intf_cache这个数组里缓存的东东实现的。

256行,extra257行,extralen,有关额外扩展的描述符的,和struct usb_host_interface里的差不多,只是这里的是针对配置的,如果你使用GET_DESCRIPTOR请求从设备里获得配置描述符信息,它们会紧跟在标准的配置描述符后面返回给你。
  • 0
    点赞
  • 0
    收藏
    觉得还不错? 一键收藏
  • 0
    评论

“相关推荐”对你有帮助么?

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值