《Linux那些事儿之我是USB》我是U盘（12）梦开始的地方

对于整个usb-storage模块，usb_stor_init()函数是它的开始，然而，对于U盘驱动程序来说，它真正驱使U盘工作却是始于storage_probe()函数。

两条平行线只要相交，就注定开始纠缠一生，不管中间是否短暂分离。USB Core为设备找到了适合它的驱动程序，或者为驱动程序找到了它所支持的设备，但这只是表明双方的第一印象还可以，但彼此是否真的适合对方还需要进一步了解。而U盘驱动则会调用函数storage_probe()去认识对方，它是一个什么样的设备？这里调用了四个函数get_device_info，get_protocol，get_transport，get_pipes。

整个U盘驱动这部大戏，由storage_probe开始，由storage_disconnect结束。其中，storage_probe这个函数占了相当大的篇幅。我们一段一段来看。这两个函数都来自drivers/usb/storage/usb.c中：

945 /* Probe to see if we can drive anewly-connected USB device */

946 static int storage_probe(struct usb_interface*intf,

947const struct usb_device_id *id)

948 {

949 structScsi_Host *host;

950 structus_data *us;

951 intresult;

952 structtask_struct *th;

953

954 if(usb_usual_check_type(id, USB_US_TYPE_STOR))

955 return -ENXIO;

956

957 US_DEBUGP("USB Mass Storagedevice detected\n");

958

959 /*

960 * Ask the SCSI layer to allocate a hoststructure, with extra

961 * space at the end for our privateus_data structure.

962 */

963 host =scsi_host_alloc(&usb_stor_host_template, sizeof(*us));

964 if (!host){

965 printk(KERN_WARNING USB_STORAGE

966"Unable to allocate the scsi host\n");

967 return -ENOMEM;

968 }

969

970 us =host_to_us(host);

971 me mset(us,0, sizeof(struct us_data));

首先先贴出这么几行，两个参数不用多说了，struct usb_interface和struct usb_device_id的这两个指针都是前面介绍过的，来自USB Core一层，我们整个故事里用到的就是这么一个，这两个指针的指向是定下来的。

950行，最重要的一个数据结构终于出现了。整个usb-storage模块里边自己定义的数据结构不多，但是us_data算一个。这个数据结构是跟随我们的代码一直走下去的，如影随形，几乎处处都可以看见它的身影。先把它的代码“贴”出来，来自drivers/usb/storage/usb.h:

102 /* we allocate one of these for every devicethat we remember */

103 struct us_data {

104 /* Thedevice we're working with

105 * It's important to note:

106 * (o) you must hold dev_mutex to change pusb_dev

107 */

108 structmutexdev_mutex; /* protect pusb_dev */

109 structusb_device*pusb_dev; /* this usb_device */

110 structusb_interface*pusb_intf; /* this interface */

111 structus_unusual_dev *unusual_dev;/* device-filter entry */

112 unsignedlongflags;/*from filter initially */

113 unsignedintsend_bulk_pipe; /* cachedpipe values */

114 unsignedintrecv_bulk_pipe;

115 unsignedintsend_ctrl_pipe;

116 unsignedintrecv_ctrl_pipe;

117 unsignedintrecv_intr_pipe;

118

119 /*information about the device */

120 char*transport_name;

121 char*protocol_name;

122 __le32bcs_signature;

123 u8 subclass;

124 u8protocol;

125 u8max_lun;

126

127 u8ifnum; /*interface number */

128 u8ep_bInterval;/* interrupt interval */

129

130 /*function pointers for this device */

131 trans_cmndtransport; /*transport function*/

132 trans_resettransport_reset; /* transport devicereset */

133 proto_cmndproto_handler; /* protocol handler */

134

135 /* SCSIinterfaces */

136 structscsi_cmnd *srb;/* current srb */

137 unsignedinttag;/* current dCBWTag */

138

139 /*control and bulk communications data */

140 structurb*current_urb;/* USB requests*/

141 structusb_ctrlrequest *cr;/* control requests*/

142 struct usb_sg_request current_sg; /* scatter-gather req. */

143 unsignedchar*iobuf; /* I/Obuffer */

144 unsignedchar*sensebuf; /* sense data buffer */

145 dma_addr_tcr_dma; /* bufferDMA addresses */

146 dma_addr_tiobuf_dma;

147

148 /* mutualexclusion and synchronization structures */

149 struct semaphoresema; /* to sleepthread on*/

150 struct completion notify; /* thread begin/end */

151 wait_queue_head_t delay_wait; /* wait duringscan, reset */

152

153 /*subdriver information */

154 void*extra; /* Any extradata */

155 extra_data_destructorextra_destructor;/*extra data destructor */

156 #ifdef CONFIG_PM

157 pm_hooksuspend_resume_hook;

158 #endif

159 };

不难发现，Linux内核中每一个重要的数据结构都很复杂。总之，这个令人头疼的数据结构是每一个设备都有的。换句话说，我们会为每一个设备申请一个us_data，因为这个结构中边的东西我们之后一直会用得着的。950行，structus_data *us，于是，日后我们会非常频繁地看到us的。另，us什么意思？us，即usb storage。

963行，关于usb_stor_host_template，必须得认真看一下，因为这个变量我们以后还会多次碰到。scsi_host_alloc 就是SCSI子系统提供的函数，它的作用就是申请一个SCSI Host相应的数据结构。而它的第一个参数&usb_stor_host_template，其实这是一个struct scsi_host_template的结构体指针，之所以USB Mass Storage里面会涉及SCSI这一层，是因为我们事实上把一块U盘模拟成了一块SCSI设备，对于SCSI设备来说，要想正常工作，得有一个SCSI卡，或者说SCSI Host。而按照SCSI这一层的规矩，要想申请一个SCSI Host的结构体，我们就得提供一个struct scsi_host_template结构体，这其实从名字可以看出，是一个模版，SCSI那层把一切都封装好了，只要提交一个模版给它，它就能为你提供一个structScsi_Host结构体。关于这个usb_stor_host_template，它的定义或者说初始化是在drivers/usb/storage/scsiglue.c中：

441 struct scsi_host_templateusb_stor_host_template = {

442 /* basic userland interface stuff*/

443 .name ="usb-storage",

444 .proc_name="usb-storage",

445 .proc_info =proc_info,

446 .info=host_info,

447

448 /* command interface -- queued only*/

449 .queuecommand=queuecommand,

450

451 /*error and abort handlers */

452 .eh_abort_handler=command_abort,

453 .eh_device_reset_handler=device_reset,

454 .eh_bus_reset_handler= bus_reset,

455

456 /* queuecommands only, only one command per LUN */

457 .can_queue=1,

458 .cmd_per_lun=1,

459

460 /*unknown initiator id */

461 .this_id=-1,

462

463 .slave_alloc=slave_alloc,

464 .slave_configure=slave_configure,

465

466 /* lots ofsg segments can be handled */

467 .sg_tablesize=SG_ALL,

468

469 /*limit the total size of a transfer to 120 KB */

470 .max_sectors=240,

471

472 /* mergecommands... this see ms to help performance, but

473 * periodically someone should test tosee which setting is more

474 * optimal.

475 */

476 .use_clustering = 1,

477

478 /*emulated HBA */

479 .emulated=1,

480

481 /*we do our own delay after a device or bus reset */

482 .skip_settle_delay = 1,

483

484 /*sysfs device attributes */

485 .sdev_attrs=sysfs_device_attr_list,

486

487 /* modulemanagement */

488 .module=THIS_MODULE

489 };

按照SCSI层的规矩，要想申请一个SCSI Host，并且让它工作，我们需要调用三个函数，第一个是scsi_host_alloc()，第二个是scsi_add_host()，第三个是scsi_scan_host()。这三个函数我们都会在接下来的代码里面看到。

scsi_host_alloc()一调用，就是给struct Scsi_Host 结构申请了空间， 而只有调用了scsi_add_host()之后，SCSI核心层才知道有这个Host的存在，然后只有scsi_scan_host()被调用了之后，真正的设备才被发现。这些函数的含义和它们的名字吻合的很好。不是吗?

最后需要指出的是，scsi_host_alloc()需要两个参数，第一个参数是structscsi_host_template 的指针，咱们当然给了它&usb_stor_host_template，而第二个参数实际上是被称为驱动自己的数据，咱们传递的是sizeof(*us)。SCSI层非常友好地给咱们提供了一个接口，在struct Scsi_Host结构体被设计时就专门准备了一个unsigned long hostdata[0]来给别的设备驱动使用，这个hostdata的大小是可以由咱们来定，把sizeof(*us)传递给scsi_host_alloc()就意味着给us申请了内存。而今后如果我们需要从us得到相应的SCSI Host就可以使用内联函数us_to_host()；而反过来要想从SCSI Host得到相应的us则可以使用内联函数host_to_us()，这两个明显是一对，都定义于drivers/usb/storage/usb.h：

161 /* Convert between us_data and thecorresponding Scsi_Host */

162 static inline struct Scsi_Host*us_to_host(struct us_data *us) {

163 returncontainer_of((void *) us, struct Scsi_Host, hostdata);

164 }

165 static inline struct us_data*host_to_us(struct Scsi_Host *host) {

166 return(struct us_data *) host->hostdata;

167 }

总之咱们这么一折腾，就让USB驱动和SCSI Host联系起来。从此以后这个U盘既要扮演U盘的角色又要扮演SCSI设备的角色。

957行，US_DEBUGP是一个宏，来自drivers/usb/storage/debug.h，接下来很多代码中我们也会看到这个宏，它无非就是打印一些调试信息。debug.h中有这么一段：

51 #ifdef CONFIG_USB_STORAGE_DEBUG

52 void usb_stor_show_command(struct scsi_cmnd*srb);

53 void usb_stor_show_sense( unsigned char key,

54unsigned char asc, unsigned char ascq );

55 #define US_DEBUGP(x...) printk( KERN_DEBUGUSB_STORAGE x )

56 #define US_DEBUGPX(x...) printk( x )

57 #define US_DEBUG(x) x

58 #else

59 #define US_DEBUGP(x...)

60 #define US_DEBUGPX(x...)

61 #define US_DEBUG(x)

62 #endif

这里一共定义了几个宏，US_DEBUGP，US_DEBUGPX，US_DEBUG，差别不大，只是形式上略有不同罢了。

需要注意的是，这些调试信息得是我们打开了编译选项CONFIG_USB_STORAGE_DEBUG才有意义的，如果这个选项为0，那么这几个宏就什么也不干，因为它们被赋为空了。关于US_DEBUG系列的这几个宏，就讲到这了。

954行，usb_usual_check_type()干什么用的？这个函数来自drivers/usb/storage/libusual.c中：

98 int usb_usual_check_type(const struct usb_device_id*id, int caller_type)

99 {

100 int id_type =USB_US_TYPE(id->driver_info);

101

102 if(caller_type <= 0 || caller_type >= 3)

103 return -EINVAL;

104

105 /* Driversgrab fixed assignment devices */

106 if (id_type == caller_type)

107 return 0;

108 /* Driversgrab devices biased to them */

109if (id_type==USB_US_TYPE_NONE&& caller_type==atomic_read(&usu_bias))

110 return 0;

111 return -ENODEV;

112 }

这个函数保证现在认领的这个设备属于usb-storage所支持的设备，而不是另一个叫做ub的驱动所支持的设备，如果你足够细心可能会注意到，drivers/block目录下面竟然也有一段与usb相关的驱动代码，它就是drivers/block/ub.c。实际上ub是一个简化版的usb-storage和sd两个模块的结合体，它的功能比较弱，但是要更稳定。如果感兴趣的话可以去读一下ub这个模块的代码。