《Linux那些事儿之我是USB》我是U盘(36)迷雾重重的批量传输(五)

版权声明:本文为博主原创文章,遵循 CC 4.0 by-sa 版权协议,转载请附上原文出处链接和本声明。
本文链接:https://blog.csdn.net/fudan_abc/article/details/7334702

在讲数据传输阶段之前,先解决刚才的历史遗留问题。usb_stor_bulk_transfer_buf()中,406行,有一个很有趣的函数interpret_urb_result()被调用。这个函数同样来自drivers/usb/storage/transport.c中:

265 static int interpret_urb_result(struct us_data*us, unsigned int pipe,

266                unsigned int length, int result, unsigned int partial)

267 {

268      US_DEBUGP("Status code %d; transferred%u/%u\n",

269                         result, partial,length);

270      switch (result) {

271

272      /* no error code; did we send all the data? */

273      case 0:

274           if (partial != length) {

275               US_DEBUGP("-- shorttransfer\n");

276                return USB_STOR_XFER_SHORT;

277            }

278

279           US_DEBUGP("-- transfer complete\n");

280           return USB_STOR_XFER_GOOD;

281

282     /* stalled */

283     case -EPIPE:

284           /* for control endpoints, (used by CB[I]) astall indicates

285            * afailed command */

286           if (usb_pipecontrol(pipe)) {

287               US_DEBUGP("-- stall oncontrol pipe\n");

288                return USB_STOR_XFER_STALLED;

289           }

290

291           /* for other sorts of endpoint, clear thestall */

292           US_DEBUGP("clearing endpoint halt forpipe 0x%x\n", pipe);

293           if (usb_stor_clear_halt(us, pipe) < 0)

294                return USB_STOR_XFER_ERROR;

295           return USB_STOR_XFER_STALLED;

296

297      /* babble - the device tried to send morethan we wanted to read */

298      case -EOVERFLOW:

299           US_DEBUGP("-- babble\n");

300           return USB_STOR_XFER_LONG;

301

302      /* the transfer was cancelled by abort, disconnect,or timeout */

303      case -ECONNRESET:

304           US_DEBUGP("-- transfercancelled\n");

305           return USB_STOR_XFER_ERROR;

306

307      /* short scatter-gather read transfer */

308      case -EREMOTEIO:

309           US_DEBUGP("-- short readtransfer\n");

310           return USB_STOR_XFER_SHORT;

311

312      /* abort or disconnect in progress */

313      case -EIO:

314           US_DEBUGP("-- abort or disconnect inprogress\n");

315           return USB_STOR_XFER_ERROR;

316

317      /* the catch-all error case */

318      default:

319           US_DEBUGP("-- unknown error\n");

320           return USB_STOR_XFER_ERROR;

321      }

322 }

应该说这个函数的作用是一目了然,就是根据传进来的参数result进行判断,从而采取相应的行动。partial是实际传输的长度,而length是期望传输的长度,传输结束了当然要比较这两者,因为有所期待,才会失望。result是usb_stor_ msg_common()函数的返回值,其实就是状态代码。如果为0说明一切都很顺利,结果也是成功的。268这行,打印结果,同时打印出partial和length的比,注意两个%u中间那个“/”,就是除号,或者说分割分子和分母的符号。

然后通过一个switch语句判断result,为0,说明至少数据有传输。然后有两种情况,于是返回不同的值,USB_STOR_XFER_SHORT和USB_STOR_XFER_GOOD。至于返回这些值之后会得到什么反应,让我们边走边看。目前只需要知道的是,对于真正传输完全令人满意的情况,返回值只能是USB_STOR_XFER_GOOD。返回其他值都说明有问题。而这里作为传递给switch的result,实际上是USB Core那一层传过来的值。

而我们注意到,interpret_urb_result这个函数整个是被作为一个返回值出现在usb_stor_bulk_transfer_buf()中的。换而言之,前者返回之后,后者也马上就返回了,即再次返回到了usb_stor_Bulk_transport()中。因此,我们把视线拉回usb_stor_Bulk_transport(),981行,如果result不为USB_STOR_XFER_GOOD,就说明有一些问题,于是索性usb_stor_Bulk_transport()也返回,没必要再进行下一阶段的传输了。否则,才可以进行下一阶段。

下一个阶段是所谓的Bulk-only传输,总共就是三个阶段,即命令传输阶段、数据传输阶段、状态传输阶段。很显然,真正最有意义的阶段就是数据传输阶段,而在此之前,我们已经讲了第一阶段,即命令传输阶段。下面我们可以来看一下数据阶段。

989行,990行,实在没话可说,某些公司的产品在命令阶段和数据阶段居然还得延时100μs,最早时只发现了Genesys Logic公司的产品有这个问题,后来又发现更多的产品也有同样的问题。所以使用了US_FL_GO_SLOW这个flag,如果你有兴趣看一下早期的Linux Kernel,你会发现那时候其实没有这个flag,那时候定义了一个USB_VENDOR_ID_GENESYS,直接比较这个产品是不是Genesys Logic公司的,如果是的,那就考虑这个延时,否则就不用。

993行,transfer_length可能为0,因为有的命令并不需要您传输数据,所以它没有数据阶段。而对于那些有数据阶段的情况,我们进入if这一段。

994行,没什么可说的,就是根据数据传输方向确定用接收管道还是发送管道。

然后,996行,usb_stor_bulk_transfer_sg()函数真正地执行批量数据传输。这个函数来自drivers/usb/storage/transport.c中:

470 int usb_stor_bulk_transfer_sg(struct us_data*us, unsigned int pipe,

471                void *buf, unsigned int length_left, int use_sg, int *residual)

472 {

473     int result;

474     unsigned int partial;

475

476      /* are we scatter-gathering? */

477     if (use_sg) {

478           /* use the usb core scatter-gather primitives*/

479           result = usb_stor_bulk_transfer_sglist(us,pipe,

480                                 (structscatterlist *) buf, use_sg,

481                                 length_left,&partial);

482           length_left -= partial;

483      } else {

484           /* no scatter-gather, just make the request */

485           result = usb_stor_bulk_transfer_buf(us, pipe,buf,

486                                 length_left,&partial);

487           length_left -= partial;

488      }

489

490      /* store the residual and return the error code*/

491      if (residual)

492           *residual = length_left;

493      return result;

494 }

注释说得很清楚,这个函数是一个壳,真正干活的是它所调用或者说利用的那两个函数:usb_stor_bulk_transfer_sglist()和usb_stor_bulk_transfer_buf()。后者刚才已经遇到过了,而前者是专门为scatter-gather传输准备的函数,它也来自drivers/usb/storage/transport.c中:

416 static int usb_stor_bulk_transfer_sglist(structus_data *us, unsigned int pipe,

417                struct scatterlist *sg, int num_sg, unsigned int length,

418                unsigned int *act_len)

419 {

420      int result;

421

422      /*don't submit s-g requests during abort/disconnect processing */

423      if (us->flags &ABORTING_OR_DISCONNECTING)

424           return USB_STOR_XFER_ERROR;

425

426      /* initialize the scatter-gather request block*/

427      US_DEBUGP("%s: xfer %u Bytes, %dentries\n", __FUNCTION__,

428                         length, num_sg);

429      result = usb_sg_init(&us->current_sg,us->pusb_dev, pipe, 0,

430                         sg, num_sg, length,GFP_NOIO);

431      if (result) {

432           US_DEBUGP("usb_sg_init returned%d\n", result);

433           return USB_STOR_XFER_ERROR;

434      }

435

436      /* since the block has been initializedsuccessfully, it's now

437       * okayto cancel it */

438      set_bit(US_FLIDX_SG_ACTIVE,&us->flags);

439

440      /* did an abort/disconnect occur during thesubmission? */

441      if (us->flags &ABORTING_OR_DISCONNECTING) {

442

443           /* cancel the request, if it hasn't beencancelled already */

444           if (test_and_clear_bit(US_FLIDX_SG_ACTIVE,&us->flags)) {

445                US_DEBUGP("--cancelling sg request\n");

446                usb_sg_cancel(&us->current_sg);

447           }

448      }

449

450      /* wait for the completion of the transfer */

451      usb_sg_wait(&us->current_sg);

452      clear_bit(US_FLIDX_SG_ACTIVE, &us->flags);

453

454      result = us->current_sg.status;

455      if (act_len)

456           *act_len = us->current_sg.Bytes;

457      return interpret_urb_result(us, pipe, length,result,

458                         us->current_sg.Bytes);

459 }

在usb_stor_bulk_transfer_sg()函数中,判断use_sg是否为0,从而确定是否用scatter-gather。对于use_sg等于0的情况,表示不用scatter-gather,那么调用usb_stor_bulk_transfer_buf()发送scsi命令。实际传递的数据长度用partial记录,然后length_left就记录还剩下多少没传递,初值当然就是期望传递的那个长度。每次减去实际传递的长度即可。对于use_sg不等于0的情况,usb_stor_bulk_transfer_sglist()函数被调用。我们来看这个函数。
展开阅读全文

没有更多推荐了,返回首页