2 * Most of this source has been derived from the Linux USB
4 * (c) 1999-2002 Matthew Dharm (mdharm-usb@one-eyed-alien.net)
5 * (c) 2000 David L. Brown, Jr. (usb-storage@davidb.org)
6 * (c) 1999 Michael Gee (michael@linuxspecific.com)
7 * (c) 2000 Yggdrasil Computing, Inc.
11 * (C) Copyright 2001 Denis Peter, MPL AG Switzerland
12 * Driver model conversion:
13 * (C) Copyright 2015 Google, Inc
15 * For BBB support (C) Copyright 2003
16 * Gary Jennejohn, DENX Software Engineering <garyj@denx.de>
18 * BBB support based on /sys/dev/usb/umass.c from
21 * SPDX-License-Identifier: GPL-2.0+
25 * Currently only the CBI transport protocoll has been implemented, and it
26 * is only tested with a TEAC USB Floppy. Other Massstorages with CBI or CB
27 * transport protocoll may work as well.
31 * Support for USB Mass Storage Devices (BBB) has been added. It has
32 * only been tested with USB memory sticks.
43 #include <asm/byteorder.h>
44 #include <asm/processor.h>
45 #include <dm/device-internal.h>
50 #undef BBB_COMDAT_TRACE
51 #undef BBB_XPORT_TRACE
54 /* direction table -- this indicates the direction of the data
55 * transfer for each command code -- a 1 indicates input
57 static const unsigned char us_direction[256/8] = {
58 0x28, 0x81, 0x14, 0x14, 0x20, 0x01, 0x90, 0x77,
59 0x0C, 0x20, 0x00, 0x04, 0x00, 0x00, 0x00, 0x00,
60 0x00, 0x00, 0x00, 0x00, 0x00, 0x01, 0x00, 0x01,
61 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00
63 #define US_DIRECTION(x) ((us_direction[x>>3] >> (x & 7)) & 1)
65 static ccb usb_ccb __attribute__((aligned(ARCH_DMA_MINALIGN)));
68 static int usb_max_devs; /* number of highest available usb device */
70 static block_dev_desc_t usb_dev_desc[USB_MAX_STOR_DEV];
73 typedef int (*trans_cmnd)(ccb *cb, struct us_data *data);
74 typedef int (*trans_reset)(struct us_data *data);
77 struct usb_device *pusb_dev; /* this usb_device */
79 unsigned int flags; /* from filter initially */
80 # define USB_READY (1 << 0)
81 unsigned char ifnum; /* interface number */
82 unsigned char ep_in; /* in endpoint */
83 unsigned char ep_out; /* out ....... */
84 unsigned char ep_int; /* interrupt . */
85 unsigned char subclass; /* as in overview */
86 unsigned char protocol; /* .............. */
87 unsigned char attention_done; /* force attn on first cmd */
88 unsigned short ip_data; /* interrupt data */
89 int action; /* what to do */
90 int ip_wanted; /* needed */
91 int *irq_handle; /* for USB int requests */
92 unsigned int irqpipe; /* pipe for release_irq */
93 unsigned char irqmaxp; /* max packed for irq Pipe */
94 unsigned char irqinterval; /* Intervall for IRQ Pipe */
95 ccb *srb; /* current srb */
96 trans_reset transport_reset; /* reset routine */
97 trans_cmnd transport; /* transport routine */
100 #ifdef CONFIG_USB_EHCI
102 * The U-Boot EHCI driver can handle any transfer length as long as there is
103 * enough free heap space left, but the SCSI READ(10) and WRITE(10) commands are
104 * limited to 65535 blocks.
106 #define USB_MAX_XFER_BLK 65535
108 #define USB_MAX_XFER_BLK 20
111 static struct us_data usb_stor[USB_MAX_STOR_DEV];
113 #define USB_STOR_TRANSPORT_GOOD 0
114 #define USB_STOR_TRANSPORT_FAILED -1
115 #define USB_STOR_TRANSPORT_ERROR -2
117 int usb_stor_get_info(struct usb_device *dev, struct us_data *us,
118 block_dev_desc_t *dev_desc);
119 int usb_storage_probe(struct usb_device *dev, unsigned int ifnum,
121 static unsigned long usb_stor_read(block_dev_desc_t *block_dev, lbaint_t blknr,
122 lbaint_t blkcnt, void *buffer);
123 static unsigned long usb_stor_write(block_dev_desc_t *block_dev, lbaint_t blknr,
124 lbaint_t blkcnt, const void *buffer);
125 void uhci_show_temp_int_td(void);
127 #ifdef CONFIG_PARTITIONS
128 block_dev_desc_t *usb_stor_get_dev(int index)
130 return (index < usb_max_devs) ? &usb_dev_desc[index] : NULL;
134 static void usb_show_progress(void)
139 /*******************************************************************************
140 * show info on storage devices; 'usb start/init' must be invoked earlier
141 * as we only retrieve structures populated during devices initialization
143 int usb_stor_info(void)
147 if (usb_max_devs > 0) {
148 for (i = 0; i < usb_max_devs; i++) {
149 printf(" Device %d: ", i);
150 dev_print(&usb_dev_desc[i]);
155 printf("No storage devices, perhaps not 'usb start'ed..?\n");
159 static unsigned int usb_get_max_lun(struct us_data *us)
162 ALLOC_CACHE_ALIGN_BUFFER(unsigned char, result, 1);
163 len = usb_control_msg(us->pusb_dev,
164 usb_rcvctrlpipe(us->pusb_dev, 0),
166 USB_TYPE_CLASS | USB_RECIP_INTERFACE | USB_DIR_IN,
168 result, sizeof(char),
169 USB_CNTL_TIMEOUT * 5);
170 debug("Get Max LUN -> len = %i, result = %i\n", len, (int) *result);
171 return (len > 0) ? *result : 0;
174 static int usb_stor_probe_device(struct usb_device *dev)
177 return -ENOENT; /* no more devices available */
179 debug("\n\nProbing for storage\n");
180 if (usb_storage_probe(dev, 0, &usb_stor[usb_max_devs])) {
181 /* OK, it's a storage device. Iterate over its LUNs
182 * and populate `usb_dev_desc'.
184 int lun, max_lun, start = usb_max_devs;
186 max_lun = usb_get_max_lun(&usb_stor[usb_max_devs]);
188 lun <= max_lun && usb_max_devs < USB_MAX_STOR_DEV;
190 struct block_dev_desc *blkdev;
192 blkdev = &usb_dev_desc[usb_max_devs];
193 memset(blkdev, '\0', sizeof(block_dev_desc_t));
194 blkdev->if_type = IF_TYPE_USB;
195 blkdev->dev = usb_max_devs;
196 blkdev->part_type = PART_TYPE_UNKNOWN;
197 blkdev->target = 0xff;
198 blkdev->type = DEV_TYPE_UNKNOWN;
199 blkdev->block_read = usb_stor_read;
200 blkdev->block_write = usb_stor_write;
204 if (usb_stor_get_info(dev, &usb_stor[start],
205 &usb_dev_desc[usb_max_devs]) ==
208 debug("%s: Found device %p\n", __func__, dev);
213 /* if storage device */
214 if (usb_max_devs == USB_MAX_STOR_DEV) {
215 printf("max USB Storage Device reached: %d stopping\n",
223 void usb_stor_reset(void)
228 #ifndef CONFIG_DM_USB
229 /*******************************************************************************
230 * scan the usb and reports device info
231 * to the user if mode = 1
232 * returns current device or -1 if no
234 int usb_stor_scan(int mode)
239 printf(" scanning usb for storage devices... ");
241 usb_disable_asynch(1); /* asynch transfer not allowed */
244 for (i = 0; i < USB_MAX_DEVICE; i++) {
245 struct usb_device *dev;
247 dev = usb_get_dev_index(i); /* get device */
249 if (usb_stor_probe_device(dev))
253 usb_disable_asynch(0); /* asynch transfer allowed */
254 printf("%d Storage Device(s) found\n", usb_max_devs);
255 if (usb_max_devs > 0)
261 static int usb_stor_irq(struct usb_device *dev)
264 us = (struct us_data *)dev->privptr;
274 static void usb_show_srb(ccb *pccb)
277 printf("SRB: len %d datalen 0x%lX\n ", pccb->cmdlen, pccb->datalen);
278 for (i = 0; i < 12; i++)
279 printf("%02X ", pccb->cmd[i]);
283 static void display_int_status(unsigned long tmp)
285 printf("Status: %s %s %s %s %s %s %s\n",
286 (tmp & USB_ST_ACTIVE) ? "Active" : "",
287 (tmp & USB_ST_STALLED) ? "Stalled" : "",
288 (tmp & USB_ST_BUF_ERR) ? "Buffer Error" : "",
289 (tmp & USB_ST_BABBLE_DET) ? "Babble Det" : "",
290 (tmp & USB_ST_NAK_REC) ? "NAKed" : "",
291 (tmp & USB_ST_CRC_ERR) ? "CRC Error" : "",
292 (tmp & USB_ST_BIT_ERR) ? "Bitstuff Error" : "");
295 /***********************************************************************
296 * Data transfer routines
297 ***********************************************************************/
299 static int us_one_transfer(struct us_data *us, int pipe, char *buf, int length)
308 /* determine the maximum packet size for these transfers */
309 max_size = usb_maxpacket(us->pusb_dev, pipe) * 16;
311 /* while we have data left to transfer */
314 /* calculate how long this will be -- maximum or a remainder */
315 this_xfer = length > max_size ? max_size : length;
318 /* setup the retry counter */
321 /* set up the transfer loop */
323 /* transfer the data */
324 debug("Bulk xfer 0x%lx(%d) try #%d\n",
325 (ulong)map_to_sysmem(buf), this_xfer,
327 result = usb_bulk_msg(us->pusb_dev, pipe, buf,
329 USB_CNTL_TIMEOUT * 5);
330 debug("bulk_msg returned %d xferred %d/%d\n",
331 result, partial, this_xfer);
332 if (us->pusb_dev->status != 0) {
333 /* if we stall, we need to clear it before
337 display_int_status(us->pusb_dev->status);
339 if (us->pusb_dev->status & USB_ST_STALLED) {
340 debug("stalled ->clearing endpoint" \
341 "halt for pipe 0x%x\n", pipe);
342 stat = us->pusb_dev->status;
343 usb_clear_halt(us->pusb_dev, pipe);
344 us->pusb_dev->status = stat;
345 if (this_xfer == partial) {
346 debug("bulk transferred" \
349 us->pusb_dev->status);
355 if (us->pusb_dev->status & USB_ST_NAK_REC) {
356 debug("Device NAKed bulk_msg\n");
359 debug("bulk transferred with error");
360 if (this_xfer == partial) {
361 debug(" %ld, but data ok\n",
362 us->pusb_dev->status);
365 /* if our try counter reaches 0, bail out */
366 debug(" %ld, data %d\n",
367 us->pusb_dev->status, partial);
371 /* update to show what data was transferred */
372 this_xfer -= partial;
374 /* continue until this transfer is done */
378 /* if we get here, we're done and successful */
382 static int usb_stor_BBB_reset(struct us_data *us)
388 * Reset recovery (5.3.4 in Universal Serial Bus Mass Storage Class)
390 * For Reset Recovery the host shall issue in the following order:
391 * a) a Bulk-Only Mass Storage Reset
392 * b) a Clear Feature HALT to the Bulk-In endpoint
393 * c) a Clear Feature HALT to the Bulk-Out endpoint
395 * This is done in 3 steps.
397 * If the reset doesn't succeed, the device should be port reset.
399 * This comment stolen from FreeBSD's /sys/dev/usb/umass.c.
401 debug("BBB_reset\n");
402 result = usb_control_msg(us->pusb_dev, usb_sndctrlpipe(us->pusb_dev, 0),
404 USB_TYPE_CLASS | USB_RECIP_INTERFACE,
405 0, us->ifnum, NULL, 0, USB_CNTL_TIMEOUT * 5);
407 if ((result < 0) && (us->pusb_dev->status & USB_ST_STALLED)) {
408 debug("RESET:stall\n");
412 /* long wait for reset */
414 debug("BBB_reset result %d: status %lX reset\n",
415 result, us->pusb_dev->status);
416 pipe = usb_rcvbulkpipe(us->pusb_dev, us->ep_in);
417 result = usb_clear_halt(us->pusb_dev, pipe);
418 /* long wait for reset */
420 debug("BBB_reset result %d: status %lX clearing IN endpoint\n",
421 result, us->pusb_dev->status);
422 /* long wait for reset */
423 pipe = usb_sndbulkpipe(us->pusb_dev, us->ep_out);
424 result = usb_clear_halt(us->pusb_dev, pipe);
426 debug("BBB_reset result %d: status %lX clearing OUT endpoint\n",
427 result, us->pusb_dev->status);
428 debug("BBB_reset done\n");
432 /* FIXME: this reset function doesn't really reset the port, and it
433 * should. Actually it should probably do what it's doing here, and
434 * reset the port physically
436 static int usb_stor_CB_reset(struct us_data *us)
438 unsigned char cmd[12];
442 memset(cmd, 0xff, sizeof(cmd));
443 cmd[0] = SCSI_SEND_DIAG;
445 result = usb_control_msg(us->pusb_dev, usb_sndctrlpipe(us->pusb_dev, 0),
447 USB_TYPE_CLASS | USB_RECIP_INTERFACE,
448 0, us->ifnum, cmd, sizeof(cmd),
449 USB_CNTL_TIMEOUT * 5);
451 /* long wait for reset */
453 debug("CB_reset result %d: status %lX clearing endpoint halt\n",
454 result, us->pusb_dev->status);
455 usb_clear_halt(us->pusb_dev, usb_rcvbulkpipe(us->pusb_dev, us->ep_in));
456 usb_clear_halt(us->pusb_dev, usb_rcvbulkpipe(us->pusb_dev, us->ep_out));
458 debug("CB_reset done\n");
463 * Set up the command for a BBB device. Note that the actual SCSI
464 * command is copied into cbw.CBWCDB.
466 static int usb_stor_BBB_comdat(ccb *srb, struct us_data *us)
472 ALLOC_CACHE_ALIGN_BUFFER(struct umass_bbb_cbw, cbw, 1);
474 dir_in = US_DIRECTION(srb->cmd[0]);
476 #ifdef BBB_COMDAT_TRACE
477 printf("dir %d lun %d cmdlen %d cmd %p datalen %lu pdata %p\n",
478 dir_in, srb->lun, srb->cmdlen, srb->cmd, srb->datalen,
481 for (result = 0; result < srb->cmdlen; result++)
482 printf("cmd[%d] %#x ", result, srb->cmd[result]);
487 if (!(srb->cmdlen <= CBWCDBLENGTH)) {
488 debug("usb_stor_BBB_comdat:cmdlen too large\n");
492 /* always OUT to the ep */
493 pipe = usb_sndbulkpipe(us->pusb_dev, us->ep_out);
495 cbw->dCBWSignature = cpu_to_le32(CBWSIGNATURE);
496 cbw->dCBWTag = cpu_to_le32(CBWTag++);
497 cbw->dCBWDataTransferLength = cpu_to_le32(srb->datalen);
498 cbw->bCBWFlags = (dir_in ? CBWFLAGS_IN : CBWFLAGS_OUT);
499 cbw->bCBWLUN = srb->lun;
500 cbw->bCDBLength = srb->cmdlen;
501 /* copy the command data into the CBW command data buffer */
504 memcpy(cbw->CBWCDB, srb->cmd, srb->cmdlen);
505 result = usb_bulk_msg(us->pusb_dev, pipe, cbw, UMASS_BBB_CBW_SIZE,
506 &actlen, USB_CNTL_TIMEOUT * 5);
508 debug("usb_stor_BBB_comdat:usb_bulk_msg error\n");
512 /* FIXME: we also need a CBI_command which sets up the completion
513 * interrupt, and waits for it
515 static int usb_stor_CB_comdat(ccb *srb, struct us_data *us)
520 unsigned long status;
523 dir_in = US_DIRECTION(srb->cmd[0]);
526 pipe = usb_rcvbulkpipe(us->pusb_dev, us->ep_in);
528 pipe = usb_sndbulkpipe(us->pusb_dev, us->ep_out);
531 debug("CBI gets a command: Try %d\n", 5 - retry);
535 /* let's send the command via the control pipe */
536 result = usb_control_msg(us->pusb_dev,
537 usb_sndctrlpipe(us->pusb_dev , 0),
539 USB_TYPE_CLASS | USB_RECIP_INTERFACE,
541 srb->cmd, srb->cmdlen,
542 USB_CNTL_TIMEOUT * 5);
543 debug("CB_transport: control msg returned %d, status %lX\n",
544 result, us->pusb_dev->status);
545 /* check the return code for the command */
547 if (us->pusb_dev->status & USB_ST_STALLED) {
548 status = us->pusb_dev->status;
549 debug(" stall during command found," \
551 usb_clear_halt(us->pusb_dev,
552 usb_sndctrlpipe(us->pusb_dev, 0));
553 us->pusb_dev->status = status;
555 debug(" error during command %02X" \
556 " Stat = %lX\n", srb->cmd[0],
557 us->pusb_dev->status);
560 /* transfer the data payload for this command, if one exists*/
562 debug("CB_transport: control msg returned %d," \
563 " direction is %s to go 0x%lx\n", result,
564 dir_in ? "IN" : "OUT", srb->datalen);
566 result = us_one_transfer(us, pipe, (char *)srb->pdata,
568 debug("CBI attempted to transfer data," \
569 " result is %d status %lX, len %d\n",
570 result, us->pusb_dev->status,
571 us->pusb_dev->act_len);
572 if (!(us->pusb_dev->status & USB_ST_NAK_REC))
574 } /* if (srb->datalen) */
584 static int usb_stor_CBI_get_status(ccb *srb, struct us_data *us)
589 submit_int_msg(us->pusb_dev, us->irqpipe,
590 (void *) &us->ip_data, us->irqmaxp, us->irqinterval);
593 if (us->ip_wanted == 0)
598 printf(" Did not get interrupt on CBI\n");
600 return USB_STOR_TRANSPORT_ERROR;
602 debug("Got interrupt data 0x%x, transfered %d status 0x%lX\n",
603 us->ip_data, us->pusb_dev->irq_act_len,
604 us->pusb_dev->irq_status);
605 /* UFI gives us ASC and ASCQ, like a request sense */
606 if (us->subclass == US_SC_UFI) {
607 if (srb->cmd[0] == SCSI_REQ_SENSE ||
608 srb->cmd[0] == SCSI_INQUIRY)
609 return USB_STOR_TRANSPORT_GOOD; /* Good */
610 else if (us->ip_data)
611 return USB_STOR_TRANSPORT_FAILED;
613 return USB_STOR_TRANSPORT_GOOD;
615 /* otherwise, we interpret the data normally */
616 switch (us->ip_data) {
618 return USB_STOR_TRANSPORT_GOOD;
620 return USB_STOR_TRANSPORT_FAILED;
622 return USB_STOR_TRANSPORT_ERROR;
624 return USB_STOR_TRANSPORT_ERROR;
627 #define USB_TRANSPORT_UNKNOWN_RETRY 5
628 #define USB_TRANSPORT_NOT_READY_RETRY 10
630 /* clear a stall on an endpoint - special for BBB devices */
631 static int usb_stor_BBB_clear_endpt_stall(struct us_data *us, __u8 endpt)
635 /* ENDPOINT_HALT = 0, so set value to 0 */
636 result = usb_control_msg(us->pusb_dev, usb_sndctrlpipe(us->pusb_dev, 0),
637 USB_REQ_CLEAR_FEATURE, USB_RECIP_ENDPOINT,
638 0, endpt, NULL, 0, USB_CNTL_TIMEOUT * 5);
642 static int usb_stor_BBB_transport(ccb *srb, struct us_data *us)
646 int actlen, data_actlen;
647 unsigned int pipe, pipein, pipeout;
648 ALLOC_CACHE_ALIGN_BUFFER(struct umass_bbb_csw, csw, 1);
649 #ifdef BBB_XPORT_TRACE
654 dir_in = US_DIRECTION(srb->cmd[0]);
657 debug("COMMAND phase\n");
658 result = usb_stor_BBB_comdat(srb, us);
660 debug("failed to send CBW status %ld\n",
661 us->pusb_dev->status);
662 usb_stor_BBB_reset(us);
663 return USB_STOR_TRANSPORT_FAILED;
665 if (!(us->flags & USB_READY))
667 pipein = usb_rcvbulkpipe(us->pusb_dev, us->ep_in);
668 pipeout = usb_sndbulkpipe(us->pusb_dev, us->ep_out);
669 /* DATA phase + error handling */
671 /* no data, go immediately to the STATUS phase */
672 if (srb->datalen == 0)
674 debug("DATA phase\n");
680 result = usb_bulk_msg(us->pusb_dev, pipe, srb->pdata, srb->datalen,
681 &data_actlen, USB_CNTL_TIMEOUT * 5);
682 /* special handling of STALL in DATA phase */
683 if ((result < 0) && (us->pusb_dev->status & USB_ST_STALLED)) {
684 debug("DATA:stall\n");
685 /* clear the STALL on the endpoint */
686 result = usb_stor_BBB_clear_endpt_stall(us,
687 dir_in ? us->ep_in : us->ep_out);
689 /* continue on to STATUS phase */
693 debug("usb_bulk_msg error status %ld\n",
694 us->pusb_dev->status);
695 usb_stor_BBB_reset(us);
696 return USB_STOR_TRANSPORT_FAILED;
698 #ifdef BBB_XPORT_TRACE
699 for (index = 0; index < data_actlen; index++)
700 printf("pdata[%d] %#x ", index, srb->pdata[index]);
703 /* STATUS phase + error handling */
707 debug("STATUS phase\n");
708 result = usb_bulk_msg(us->pusb_dev, pipein, csw, UMASS_BBB_CSW_SIZE,
709 &actlen, USB_CNTL_TIMEOUT*5);
711 /* special handling of STALL in STATUS phase */
712 if ((result < 0) && (retry < 1) &&
713 (us->pusb_dev->status & USB_ST_STALLED)) {
714 debug("STATUS:stall\n");
715 /* clear the STALL on the endpoint */
716 result = usb_stor_BBB_clear_endpt_stall(us, us->ep_in);
717 if (result >= 0 && (retry++ < 1))
722 debug("usb_bulk_msg error status %ld\n",
723 us->pusb_dev->status);
724 usb_stor_BBB_reset(us);
725 return USB_STOR_TRANSPORT_FAILED;
727 #ifdef BBB_XPORT_TRACE
728 ptr = (unsigned char *)csw;
729 for (index = 0; index < UMASS_BBB_CSW_SIZE; index++)
730 printf("ptr[%d] %#x ", index, ptr[index]);
733 /* misuse pipe to get the residue */
734 pipe = le32_to_cpu(csw->dCSWDataResidue);
735 if (pipe == 0 && srb->datalen != 0 && srb->datalen - data_actlen != 0)
736 pipe = srb->datalen - data_actlen;
737 if (CSWSIGNATURE != le32_to_cpu(csw->dCSWSignature)) {
738 debug("!CSWSIGNATURE\n");
739 usb_stor_BBB_reset(us);
740 return USB_STOR_TRANSPORT_FAILED;
741 } else if ((CBWTag - 1) != le32_to_cpu(csw->dCSWTag)) {
743 usb_stor_BBB_reset(us);
744 return USB_STOR_TRANSPORT_FAILED;
745 } else if (csw->bCSWStatus > CSWSTATUS_PHASE) {
747 usb_stor_BBB_reset(us);
748 return USB_STOR_TRANSPORT_FAILED;
749 } else if (csw->bCSWStatus == CSWSTATUS_PHASE) {
751 usb_stor_BBB_reset(us);
752 return USB_STOR_TRANSPORT_FAILED;
753 } else if (data_actlen > srb->datalen) {
754 debug("transferred %dB instead of %ldB\n",
755 data_actlen, srb->datalen);
756 return USB_STOR_TRANSPORT_FAILED;
757 } else if (csw->bCSWStatus == CSWSTATUS_FAILED) {
759 return USB_STOR_TRANSPORT_FAILED;
765 static int usb_stor_CB_transport(ccb *srb, struct us_data *us)
773 status = USB_STOR_TRANSPORT_GOOD;
776 /* issue the command */
778 result = usb_stor_CB_comdat(srb, us);
779 debug("command / Data returned %d, status %lX\n",
780 result, us->pusb_dev->status);
781 /* if this is an CBI Protocol, get IRQ */
782 if (us->protocol == US_PR_CBI) {
783 status = usb_stor_CBI_get_status(srb, us);
784 /* if the status is error, report it */
785 if (status == USB_STOR_TRANSPORT_ERROR) {
786 debug(" USB CBI Command Error\n");
789 srb->sense_buf[12] = (unsigned char)(us->ip_data >> 8);
790 srb->sense_buf[13] = (unsigned char)(us->ip_data & 0xff);
792 /* if the status is good, report it */
793 if (status == USB_STOR_TRANSPORT_GOOD) {
794 debug(" USB CBI Command Good\n");
799 /* do we have to issue an auto request? */
800 /* HERE we have to check the result */
801 if ((result < 0) && !(us->pusb_dev->status & USB_ST_STALLED)) {
802 debug("ERROR %lX\n", us->pusb_dev->status);
803 us->transport_reset(us);
804 return USB_STOR_TRANSPORT_ERROR;
806 if ((us->protocol == US_PR_CBI) &&
807 ((srb->cmd[0] == SCSI_REQ_SENSE) ||
808 (srb->cmd[0] == SCSI_INQUIRY))) {
809 /* do not issue an autorequest after request sense */
810 debug("No auto request and good\n");
811 return USB_STOR_TRANSPORT_GOOD;
813 /* issue an request_sense */
814 memset(&psrb->cmd[0], 0, 12);
815 psrb->cmd[0] = SCSI_REQ_SENSE;
816 psrb->cmd[1] = srb->lun << 5;
819 psrb->pdata = &srb->sense_buf[0];
821 /* issue the command */
822 result = usb_stor_CB_comdat(psrb, us);
823 debug("auto request returned %d\n", result);
824 /* if this is an CBI Protocol, get IRQ */
825 if (us->protocol == US_PR_CBI)
826 status = usb_stor_CBI_get_status(psrb, us);
828 if ((result < 0) && !(us->pusb_dev->status & USB_ST_STALLED)) {
829 debug(" AUTO REQUEST ERROR %ld\n",
830 us->pusb_dev->status);
831 return USB_STOR_TRANSPORT_ERROR;
833 debug("autorequest returned 0x%02X 0x%02X 0x%02X 0x%02X\n",
834 srb->sense_buf[0], srb->sense_buf[2],
835 srb->sense_buf[12], srb->sense_buf[13]);
836 /* Check the auto request result */
837 if ((srb->sense_buf[2] == 0) &&
838 (srb->sense_buf[12] == 0) &&
839 (srb->sense_buf[13] == 0)) {
841 return USB_STOR_TRANSPORT_GOOD;
844 /* Check the auto request result */
845 switch (srb->sense_buf[2]) {
847 /* Recovered Error */
848 return USB_STOR_TRANSPORT_GOOD;
852 if (notready++ > USB_TRANSPORT_NOT_READY_RETRY) {
853 printf("cmd 0x%02X returned 0x%02X 0x%02X 0x%02X"
854 " 0x%02X (NOT READY)\n", srb->cmd[0],
855 srb->sense_buf[0], srb->sense_buf[2],
856 srb->sense_buf[12], srb->sense_buf[13]);
857 return USB_STOR_TRANSPORT_FAILED;
864 if (retry++ > USB_TRANSPORT_UNKNOWN_RETRY) {
865 printf("cmd 0x%02X returned 0x%02X 0x%02X 0x%02X"
866 " 0x%02X\n", srb->cmd[0], srb->sense_buf[0],
867 srb->sense_buf[2], srb->sense_buf[12],
869 return USB_STOR_TRANSPORT_FAILED;
874 return USB_STOR_TRANSPORT_FAILED;
878 static int usb_inquiry(ccb *srb, struct us_data *ss)
883 memset(&srb->cmd[0], 0, 12);
884 srb->cmd[0] = SCSI_INQUIRY;
885 srb->cmd[1] = srb->lun << 5;
889 i = ss->transport(srb, ss);
890 debug("inquiry returns %d\n", i);
896 printf("error in inquiry\n");
902 static int usb_request_sense(ccb *srb, struct us_data *ss)
906 ptr = (char *)srb->pdata;
907 memset(&srb->cmd[0], 0, 12);
908 srb->cmd[0] = SCSI_REQ_SENSE;
909 srb->cmd[1] = srb->lun << 5;
912 srb->pdata = &srb->sense_buf[0];
914 ss->transport(srb, ss);
915 debug("Request Sense returned %02X %02X %02X\n",
916 srb->sense_buf[2], srb->sense_buf[12],
918 srb->pdata = (uchar *)ptr;
922 static int usb_test_unit_ready(ccb *srb, struct us_data *ss)
927 memset(&srb->cmd[0], 0, 12);
928 srb->cmd[0] = SCSI_TST_U_RDY;
929 srb->cmd[1] = srb->lun << 5;
932 if (ss->transport(srb, ss) == USB_STOR_TRANSPORT_GOOD) {
933 ss->flags |= USB_READY;
936 usb_request_sense(srb, ss);
938 * Check the Key Code Qualifier, if it matches
939 * "Not Ready - medium not present"
940 * (the sense Key equals 0x2 and the ASC is 0x3a)
941 * return immediately as the medium being absent won't change
942 * unless there is a user action.
944 if ((srb->sense_buf[2] == 0x02) &&
945 (srb->sense_buf[12] == 0x3a))
953 static int usb_read_capacity(ccb *srb, struct us_data *ss)
959 memset(&srb->cmd[0], 0, 12);
960 srb->cmd[0] = SCSI_RD_CAPAC;
961 srb->cmd[1] = srb->lun << 5;
964 if (ss->transport(srb, ss) == USB_STOR_TRANSPORT_GOOD)
971 static int usb_read_10(ccb *srb, struct us_data *ss, unsigned long start,
972 unsigned short blocks)
974 memset(&srb->cmd[0], 0, 12);
975 srb->cmd[0] = SCSI_READ10;
976 srb->cmd[1] = srb->lun << 5;
977 srb->cmd[2] = ((unsigned char) (start >> 24)) & 0xff;
978 srb->cmd[3] = ((unsigned char) (start >> 16)) & 0xff;
979 srb->cmd[4] = ((unsigned char) (start >> 8)) & 0xff;
980 srb->cmd[5] = ((unsigned char) (start)) & 0xff;
981 srb->cmd[7] = ((unsigned char) (blocks >> 8)) & 0xff;
982 srb->cmd[8] = (unsigned char) blocks & 0xff;
984 debug("read10: start %lx blocks %x\n", start, blocks);
985 return ss->transport(srb, ss);
988 static int usb_write_10(ccb *srb, struct us_data *ss, unsigned long start,
989 unsigned short blocks)
991 memset(&srb->cmd[0], 0, 12);
992 srb->cmd[0] = SCSI_WRITE10;
993 srb->cmd[1] = srb->lun << 5;
994 srb->cmd[2] = ((unsigned char) (start >> 24)) & 0xff;
995 srb->cmd[3] = ((unsigned char) (start >> 16)) & 0xff;
996 srb->cmd[4] = ((unsigned char) (start >> 8)) & 0xff;
997 srb->cmd[5] = ((unsigned char) (start)) & 0xff;
998 srb->cmd[7] = ((unsigned char) (blocks >> 8)) & 0xff;
999 srb->cmd[8] = (unsigned char) blocks & 0xff;
1001 debug("write10: start %lx blocks %x\n", start, blocks);
1002 return ss->transport(srb, ss);
1006 #ifdef CONFIG_USB_BIN_FIXUP
1008 * Some USB storage devices queried for SCSI identification data respond with
1009 * binary strings, which if output to the console freeze the terminal. The
1010 * workaround is to modify the vendor and product strings read from such
1011 * device with proper values (as reported by 'usb info').
1013 * Vendor and product length limits are taken from the definition of
1014 * block_dev_desc_t in include/part.h.
1016 static void usb_bin_fixup(struct usb_device_descriptor descriptor,
1017 unsigned char vendor[],
1018 unsigned char product[]) {
1019 const unsigned char max_vendor_len = 40;
1020 const unsigned char max_product_len = 20;
1021 if (descriptor.idVendor == 0x0424 && descriptor.idProduct == 0x223a) {
1022 strncpy((char *)vendor, "SMSC", max_vendor_len);
1023 strncpy((char *)product, "Flash Media Cntrller",
1027 #endif /* CONFIG_USB_BIN_FIXUP */
1029 static unsigned long usb_stor_read(block_dev_desc_t *block_dev, lbaint_t blknr,
1030 lbaint_t blkcnt, void *buffer)
1032 int device = block_dev->dev;
1033 lbaint_t start, blks;
1035 unsigned short smallblks;
1036 struct usb_device *dev;
1039 ccb *srb = &usb_ccb;
1046 debug("\nusb_read: dev %d\n", device);
1047 dev = usb_dev_desc[device].priv;
1049 debug("%s: No device\n", __func__);
1052 ss = (struct us_data *)dev->privptr;
1054 usb_disable_asynch(1); /* asynch transfer not allowed */
1055 srb->lun = usb_dev_desc[device].lun;
1056 buf_addr = (uintptr_t)buffer;
1060 debug("\nusb_read: dev %d startblk " LBAF ", blccnt " LBAF
1061 " buffer %" PRIxPTR "\n", device, start, blks, buf_addr);
1064 /* XXX need some comment here */
1066 srb->pdata = (unsigned char *)buf_addr;
1067 if (blks > USB_MAX_XFER_BLK)
1068 smallblks = USB_MAX_XFER_BLK;
1070 smallblks = (unsigned short) blks;
1072 if (smallblks == USB_MAX_XFER_BLK)
1073 usb_show_progress();
1074 srb->datalen = usb_dev_desc[device].blksz * smallblks;
1075 srb->pdata = (unsigned char *)buf_addr;
1076 if (usb_read_10(srb, ss, start, smallblks)) {
1077 debug("Read ERROR\n");
1078 usb_request_sense(srb, ss);
1086 buf_addr += srb->datalen;
1087 } while (blks != 0);
1088 ss->flags &= ~USB_READY;
1090 debug("usb_read: end startblk " LBAF
1091 ", blccnt %x buffer %" PRIxPTR "\n",
1092 start, smallblks, buf_addr);
1094 usb_disable_asynch(0); /* asynch transfer allowed */
1095 if (blkcnt >= USB_MAX_XFER_BLK)
1100 static unsigned long usb_stor_write(block_dev_desc_t *block_dev, lbaint_t blknr,
1101 lbaint_t blkcnt, const void *buffer)
1103 int device = block_dev->dev;
1104 lbaint_t start, blks;
1106 unsigned short smallblks;
1107 struct usb_device *dev;
1110 ccb *srb = &usb_ccb;
1117 debug("\nusb_write: dev %d\n", device);
1118 dev = usb_dev_desc[device].priv;
1121 ss = (struct us_data *)dev->privptr;
1123 usb_disable_asynch(1); /* asynch transfer not allowed */
1125 srb->lun = usb_dev_desc[device].lun;
1126 buf_addr = (uintptr_t)buffer;
1130 debug("\nusb_write: dev %d startblk " LBAF ", blccnt " LBAF
1131 " buffer %" PRIxPTR "\n", device, start, blks, buf_addr);
1134 /* If write fails retry for max retry count else
1135 * return with number of blocks written successfully.
1138 srb->pdata = (unsigned char *)buf_addr;
1139 if (blks > USB_MAX_XFER_BLK)
1140 smallblks = USB_MAX_XFER_BLK;
1142 smallblks = (unsigned short) blks;
1144 if (smallblks == USB_MAX_XFER_BLK)
1145 usb_show_progress();
1146 srb->datalen = usb_dev_desc[device].blksz * smallblks;
1147 srb->pdata = (unsigned char *)buf_addr;
1148 if (usb_write_10(srb, ss, start, smallblks)) {
1149 debug("Write ERROR\n");
1150 usb_request_sense(srb, ss);
1158 buf_addr += srb->datalen;
1159 } while (blks != 0);
1160 ss->flags &= ~USB_READY;
1162 debug("usb_write: end startblk " LBAF ", blccnt %x buffer %"
1163 PRIxPTR "\n", start, smallblks, buf_addr);
1165 usb_disable_asynch(0); /* asynch transfer allowed */
1166 if (blkcnt >= USB_MAX_XFER_BLK)
1172 /* Probe to see if a new device is actually a Storage device */
1173 int usb_storage_probe(struct usb_device *dev, unsigned int ifnum,
1176 struct usb_interface *iface;
1178 struct usb_endpoint_descriptor *ep_desc;
1179 unsigned int flags = 0;
1181 /* let's examine the device now */
1182 iface = &dev->config.if_desc[ifnum];
1184 if (dev->descriptor.bDeviceClass != 0 ||
1185 iface->desc.bInterfaceClass != USB_CLASS_MASS_STORAGE ||
1186 iface->desc.bInterfaceSubClass < US_SC_MIN ||
1187 iface->desc.bInterfaceSubClass > US_SC_MAX) {
1188 debug("Not mass storage\n");
1189 /* if it's not a mass storage, we go no further */
1193 memset(ss, 0, sizeof(struct us_data));
1195 /* At this point, we know we've got a live one */
1196 debug("\n\nUSB Mass Storage device detected\n");
1198 /* Initialize the us_data structure with some useful info */
1202 ss->attention_done = 0;
1203 ss->subclass = iface->desc.bInterfaceSubClass;
1204 ss->protocol = iface->desc.bInterfaceProtocol;
1206 /* set the handler pointers based on the protocol */
1207 debug("Transport: ");
1208 switch (ss->protocol) {
1210 debug("Control/Bulk\n");
1211 ss->transport = usb_stor_CB_transport;
1212 ss->transport_reset = usb_stor_CB_reset;
1216 debug("Control/Bulk/Interrupt\n");
1217 ss->transport = usb_stor_CB_transport;
1218 ss->transport_reset = usb_stor_CB_reset;
1221 debug("Bulk/Bulk/Bulk\n");
1222 ss->transport = usb_stor_BBB_transport;
1223 ss->transport_reset = usb_stor_BBB_reset;
1226 printf("USB Storage Transport unknown / not yet implemented\n");
1232 * We are expecting a minimum of 2 endpoints - in and out (bulk).
1233 * An optional interrupt is OK (necessary for CBI protocol).
1234 * We will ignore any others.
1236 for (i = 0; i < iface->desc.bNumEndpoints; i++) {
1237 ep_desc = &iface->ep_desc[i];
1238 /* is it an BULK endpoint? */
1239 if ((ep_desc->bmAttributes &
1240 USB_ENDPOINT_XFERTYPE_MASK) == USB_ENDPOINT_XFER_BULK) {
1241 if (ep_desc->bEndpointAddress & USB_DIR_IN)
1242 ss->ep_in = ep_desc->bEndpointAddress &
1243 USB_ENDPOINT_NUMBER_MASK;
1246 ep_desc->bEndpointAddress &
1247 USB_ENDPOINT_NUMBER_MASK;
1250 /* is it an interrupt endpoint? */
1251 if ((ep_desc->bmAttributes &
1252 USB_ENDPOINT_XFERTYPE_MASK) == USB_ENDPOINT_XFER_INT) {
1253 ss->ep_int = ep_desc->bEndpointAddress &
1254 USB_ENDPOINT_NUMBER_MASK;
1255 ss->irqinterval = ep_desc->bInterval;
1258 debug("Endpoints In %d Out %d Int %d\n",
1259 ss->ep_in, ss->ep_out, ss->ep_int);
1261 /* Do some basic sanity checks, and bail if we find a problem */
1262 if (usb_set_interface(dev, iface->desc.bInterfaceNumber, 0) ||
1263 !ss->ep_in || !ss->ep_out ||
1264 (ss->protocol == US_PR_CBI && ss->ep_int == 0)) {
1265 debug("Problems with device\n");
1268 /* set class specific stuff */
1269 /* We only handle certain protocols. Currently, these are
1271 * The SFF8070 accepts the requests used in u-boot
1273 if (ss->subclass != US_SC_UFI && ss->subclass != US_SC_SCSI &&
1274 ss->subclass != US_SC_8070) {
1275 printf("Sorry, protocol %d not yet supported.\n", ss->subclass);
1279 /* we had found an interrupt endpoint, prepare irq pipe
1280 * set up the IRQ pipe and handler
1282 ss->irqinterval = (ss->irqinterval > 0) ? ss->irqinterval : 255;
1283 ss->irqpipe = usb_rcvintpipe(ss->pusb_dev, ss->ep_int);
1284 ss->irqmaxp = usb_maxpacket(dev, ss->irqpipe);
1285 dev->irq_handle = usb_stor_irq;
1287 dev->privptr = (void *)ss;
1291 int usb_stor_get_info(struct usb_device *dev, struct us_data *ss,
1292 block_dev_desc_t *dev_desc)
1294 unsigned char perq, modi;
1295 ALLOC_CACHE_ALIGN_BUFFER(u32, cap, 2);
1296 ALLOC_CACHE_ALIGN_BUFFER(u8, usb_stor_buf, 36);
1297 u32 capacity, blksz;
1298 ccb *pccb = &usb_ccb;
1300 pccb->pdata = usb_stor_buf;
1302 dev_desc->target = dev->devnum;
1303 pccb->lun = dev_desc->lun;
1304 debug(" address %d\n", dev_desc->target);
1306 if (usb_inquiry(pccb, ss)) {
1307 debug("%s: usb_inquiry() failed\n", __func__);
1311 perq = usb_stor_buf[0];
1312 modi = usb_stor_buf[1];
1315 * Skip unknown devices (0x1f) and enclosure service devices (0x0d),
1316 * they would not respond to test_unit_ready .
1318 if (((perq & 0x1f) == 0x1f) || ((perq & 0x1f) == 0x0d)) {
1319 debug("%s: unknown/unsupported device\n", __func__);
1322 if ((modi&0x80) == 0x80) {
1323 /* drive is removable */
1324 dev_desc->removable = 1;
1326 memcpy(dev_desc->vendor, (const void *)&usb_stor_buf[8], 8);
1327 memcpy(dev_desc->product, (const void *)&usb_stor_buf[16], 16);
1328 memcpy(dev_desc->revision, (const void *)&usb_stor_buf[32], 4);
1329 dev_desc->vendor[8] = 0;
1330 dev_desc->product[16] = 0;
1331 dev_desc->revision[4] = 0;
1332 #ifdef CONFIG_USB_BIN_FIXUP
1333 usb_bin_fixup(dev->descriptor, (uchar *)dev_desc->vendor,
1334 (uchar *)dev_desc->product);
1335 #endif /* CONFIG_USB_BIN_FIXUP */
1336 debug("ISO Vers %X, Response Data %X\n", usb_stor_buf[2],
1338 if (usb_test_unit_ready(pccb, ss)) {
1339 printf("Device NOT ready\n"
1340 " Request Sense returned %02X %02X %02X\n",
1341 pccb->sense_buf[2], pccb->sense_buf[12],
1342 pccb->sense_buf[13]);
1343 if (dev_desc->removable == 1) {
1344 dev_desc->type = perq;
1349 pccb->pdata = (unsigned char *)cap;
1350 memset(pccb->pdata, 0, 8);
1351 if (usb_read_capacity(pccb, ss) != 0) {
1352 printf("READ_CAP ERROR\n");
1356 ss->flags &= ~USB_READY;
1357 debug("Read Capacity returns: 0x%08x, 0x%08x\n", cap[0], cap[1]);
1359 if (cap[0] > (0x200000 * 10)) /* greater than 10 GByte */
1362 cap[0] = cpu_to_be32(cap[0]);
1363 cap[1] = cpu_to_be32(cap[1]);
1366 capacity = be32_to_cpu(cap[0]) + 1;
1367 blksz = be32_to_cpu(cap[1]);
1369 debug("Capacity = 0x%08x, blocksz = 0x%08x\n", capacity, blksz);
1370 dev_desc->lba = capacity;
1371 dev_desc->blksz = blksz;
1372 dev_desc->log2blksz = LOG2(dev_desc->blksz);
1373 dev_desc->type = perq;
1374 debug(" address %d\n", dev_desc->target);
1375 debug("partype: %d\n", dev_desc->part_type);
1377 init_part(dev_desc);
1379 debug("partype: %d\n", dev_desc->part_type);
1383 #ifdef CONFIG_DM_USB
1385 static int usb_mass_storage_probe(struct udevice *dev)
1387 struct usb_device *udev = dev_get_parent_priv(dev);
1390 usb_disable_asynch(1); /* asynch transfer not allowed */
1391 ret = usb_stor_probe_device(udev);
1392 usb_disable_asynch(0); /* asynch transfer allowed */
1397 static const struct udevice_id usb_mass_storage_ids[] = {
1398 { .compatible = "usb-mass-storage" },
1402 U_BOOT_DRIVER(usb_mass_storage) = {
1403 .name = "usb_mass_storage",
1404 .id = UCLASS_MASS_STORAGE,
1405 .of_match = usb_mass_storage_ids,
1406 .probe = usb_mass_storage_probe,
1409 UCLASS_DRIVER(usb_mass_storage) = {
1410 .id = UCLASS_MASS_STORAGE,
1411 .name = "usb_mass_storage",
1414 static const struct usb_device_id mass_storage_id_table[] = {
1416 .match_flags = USB_DEVICE_ID_MATCH_INT_CLASS,
1417 .bInterfaceClass = USB_CLASS_MASS_STORAGE
1419 { } /* Terminating entry */
1422 U_BOOT_USB_DEVICE(usb_mass_storage, mass_storage_id_table);