Linux那些事儿之我是Hub(18)八大重量级函数闪亮登场(二) 函数, 闪亮, 那些事儿, Linux

bingchentiao

第二个函数,usb_set_device_state(),鉴于网友”潜水潜到二零零八”提出drivers/usb/core/hub.c出镜频率过于的高,为避免被人成为新时期祥林嫂,经支部开会决定,从此以后凡是出自drivers/usb/core/hub.c这个文件的函数将不再做介绍其来源,这个就当是默认的位置.
   1041 /**
   1042  * usb_set_device_state - change a device's current state (usbcore, hcds)
   1043  * @udev: pointer to device whose state should be changed
   1044  * @new_state: new state value to be stored
   1045  *
   1046  * udev->state is _not_ fully protected by the device lock.  Although
   1047  * most transitions are made only while holding the lock, the state can
   1048  * can change to USB_STATE_NOTATTACHED at almost any time.  This
   1049  * is so that devices can be marked as disconnected as soon as possible,
   1050  * without having to wait for any semaphores to be released.  As a result,
   1051  * all changes to any device's state must be protected by the
   1052  * device_state_lock spinlock.
   1053  *
   1054  * Once a device has been added to the device tree, all changes to its state
   1055  * should be made using this routine.  The state should _not_ be set directly.
   1056  *
   1057  * If udev->state is already USB_STATE_NOTATTACHED then no change is made.
   1058  * Otherwise udev->state is set to new_state, and if new_state is
   1059  * USB_STATE_NOTATTACHED then all of udev's descendants' states are also set
   1060  * to USB_STATE_NOTATTACHED.
   1061  */
   1062 void usb_set_device_state(struct usb_device *udev,
   1063                 enum usb_device_state new_state)
   1064 {
   1065         unsigned long flags;
   1066
   1067         spin_lock_irqsave(&device_state_lock, flags);
   1068         if (udev->state == USB_STATE_NOTATTACHED)
   1069                 ;       /* do nothing */
   1070         else if (new_state != USB_STATE_NOTATTACHED) {
   1071
   1072                 /* root hub wakeup capabilities are managed out-of-band
   1073                  * and may involve silicon errata ... ignore them here.
   1074                  */
   1075                 if (udev->parent) {
   1076                         if (udev->state == USB_STATE_SUSPENDED
   1077                                         || new_state == USB_STATE_SUSPENDED)
   1078                                 ;       /* No change to wakeup settings */
   1079                         else if (new_state == USB_STATE_CONFIGURED)
   1080                                 device_init_wakeup(&udev->dev,
   1081                                         (udev->actconfig->desc.bmAttributes
   1082                                          & USB_CONFIG_ATT_WAKEUP));
   1083                         else
   1084                                 device_init_wakeup(&udev->dev, 0);
   1085                 }
   1086                 udev->state = new_state;
   1087         } else
   1088                 recursively_mark_NOTATTACHED(udev);
   1089         spin_unlock_irqrestore(&device_state_lock, flags);
   1090 }
天可怜见,这个函数不是很长,问题是,这个函数里面又调用了别的函数.
USB_STATE_NOTATTACHED,就是啥也没有,基本上就是说设备已经断开了,这种情况当然啥也不用做.
咱们刚才在usb_alloc_dev设置了等于USB_STATE_ATTACHED,所以继续,new_state,结合实参看一下,传递的是USB_STATE_POWERED,Root Hub另有管理方式,我们这里首先就处理非Root Hub的情况,如果原来就是USB_STATE_SUSPENDED,现还设置USB_STATE_SUSPENDED,那么当然什么也不用做.如果新的状态要被设置为USB_STATE_CONFIGURED,那么调用device_init_wakeup(),初始化唤醒方面的东西,您要是和我一样,对电源管理不感兴趣,那么估计这里您不会被唤醒,您会进入睡眠.不过人在江湖,身不由己,如果能够退出江湖,我们都想退出,然而,任我行说过,有人的地方就有江湖,人就是江湖,你怎么退出?我们又如何退出呢?既然不能退出,那么只好硬着头皮前进.
要认识device_init_wakeup()首先需要知道两个概念,can_wakeup和should_wakeup.这两个家伙从哪里钻出来的?看struct device结构体,里面有这么一个成员, struct dev_pm_info power,来看看struct dev_pm_info,来自include/linux/pm.h:
    265 struct dev_pm_info {
    266         pm_message_t            power_state;
    267         unsigned                can_wakeup:1;
    268 #ifdef  CONFIG_PM
    269         unsigned                should_wakeup:1;
    270         pm_message_t            prev_state;
    271         void                    * saved_state;
    272         struct device           * pm_parent;
    273         struct list_head        entry;
    274 #endif
275 };
这些都是电源管理部分的核心数据结构,显然我们没有必要深入研究,只是需要知道,can_wakeup为1表明一个设备可以被唤醒,设备驱动为了支持Linux中的电源管理,有责任调用device_init_wakeup()来初始化can_wakeup.而should_wakeup则是在设备的电源状态发生变化的时候被device_may_wakeup()用来测试,测试它该不该变化.因此can_wakeup表明的是一种能力,should_wakeup表明的是有了这种能力以后去不去做某件事,就好比我们吵架的时候经常说,不是我打不过你,而是我不想打你.打得过是一种能力,但是有这种能力不一定就会去真的打,还得衡量该不该打.
我们给device_init_wakeup()传递的参数是这个设备以及配置描述符中的bmAttributes&USB_CONFIG_ATT_WAKEUP,这是因为,USB spec中规定了,bmAttributes,的D5表明的就是一个USB设备是否具有被唤醒的能力.如下图所示:


而USB_CONFIG_ATT_WAKEUP被定义为1<<5,所以这里比较的就是D5是否为1,为1就是说:”我能”.
1083这个else就是说,如果设备将要被设置的新状态又不是USB_STATE_CONFIGUERD,那么就执行这里的device_init_wakeup,这里第二个参数传递的是0,就是说先不打开这个设备的wakeup能力.咱们这个上下文就是这种情况,咱们刚刚才说到,咱们的新状态就是USB_STATE_POWERED.
直到1086行,才正式把咱们的状态设置为新的这个状态,对于我们这个上下文,那就是USB_STATE_POWERED.
1087行这里又是一个else,那么很显然这个else的意思就是原来的状态不是USB_STATE_NOTATTACHED而现在要设置成USB_STATE_NOTATTACHED.这又是一个递归函数.其作用就是其名字中所说的那样,递归的把各设备都设置成NOTATTACHED状态.
   1028 static void recursively_mark_NOTATTACHED(struct usb_device *udev)

1029 {
   1030         int i;
   1031
   1032         for (i = 0; i < udev->maxchild; ++i) {

1033                 if (udev->children)
   1034                         recursively_mark_NOTATTACHED(udev->children);
   1035         }
   1036         if (udev->state == USB_STATE_SUSPENDED)
   1037                 udev->discon_suspended = 1;
   1038         udev->state = USB_STATE_NOTATTACHED;
   1039 }
这段代码真的是太简单了,属于教科书般的递归函数的经典例子.就是每一个设备遍历自己的子节点,一个个调用recursively_mark_NOTATTACHED()函数把其state设置为USB_STATE_NOTATTACHED.如果设备的状态处于USB_STATE_SUSPENDED,那么设置udev->discon_suspended为1,struct usb_device中的一个成员,unsigned discon_suspended,含义很明显,表征Disconnected while suspended.这里这么一设置,暂时我们还不知道有什么用,不过到时候我们就会在电源管理部分的代码里看到判断这个flag了,很显然设置了这个flag就会阻止suspend相关的代码被调用,咱们走着瞧.
Ok,第二个函数就这么轻轻松松搞定!