3 * Note that this is not the same as the USB Mass Storage driver
5 * Copyright Matthew Wilcox for Intel Corp, 2010
6 * Copyright Sarah Sharp for Intel Corp, 2010
8 * Distributed under the terms of the GNU GPL, version two.
11 #include <linux/blkdev.h>
12 #include <linux/slab.h>
13 #include <linux/types.h>
14 #include <linux/usb.h>
15 #include <linux/usb/storage.h>
17 #include <scsi/scsi.h>
18 #include <scsi/scsi_dbg.h>
19 #include <scsi/scsi_cmnd.h>
20 #include <scsi/scsi_device.h>
21 #include <scsi/scsi_host.h>
22 #include <scsi/scsi_tcq.h>
24 /* Common header for all IUs */
34 IU_ID_RESPONSE = 0x04,
35 IU_ID_TASK_MGMT = 0x05,
36 IU_ID_READ_READY = 0x06,
37 IU_ID_WRITE_READY = 0x07,
49 __u8 cdb[16]; /* XXX: Overflow-checking tools may misunderstand */
53 * Also used for the Read Ready and Write Ready IUs since they have the
54 * same first four bytes
64 __u8 sense[SCSI_SENSE_BUFFERSIZE];
68 * The r00-r01c specs define this version of the SENSE IU data structure.
69 * It's still in use by several different firmware releases.
77 __u8 service_response;
78 __u8 sense[SCSI_SENSE_BUFFERSIZE];
94 struct usb_interface *intf;
95 struct usb_device *udev;
97 unsigned cmd_pipe, status_pipe, data_in_pipe, data_out_pipe;
98 unsigned use_streams:1;
99 unsigned uas_sense_old:1;
103 ALLOC_STATUS_URB = (1 << 0),
104 SUBMIT_STATUS_URB = (1 << 1),
105 ALLOC_DATA_IN_URB = (1 << 2),
106 SUBMIT_DATA_IN_URB = (1 << 3),
107 ALLOC_DATA_OUT_URB = (1 << 4),
108 SUBMIT_DATA_OUT_URB = (1 << 5),
109 ALLOC_CMD_URB = (1 << 6),
110 SUBMIT_CMD_URB = (1 << 7),
113 /* Overrides scsi_pointer */
114 struct uas_cmd_info {
118 struct urb *status_urb;
119 struct urb *data_in_urb;
120 struct urb *data_out_urb;
121 struct list_head list;
124 /* I hate forward declarations, but I actually have a loop */
125 static int uas_submit_urbs(struct scsi_cmnd *cmnd,
126 struct uas_dev_info *devinfo, gfp_t gfp);
128 static DEFINE_SPINLOCK(uas_work_lock);
129 static LIST_HEAD(uas_work_list);
131 static void uas_do_work(struct work_struct *work)
133 struct uas_cmd_info *cmdinfo;
134 struct list_head list;
136 spin_lock_irq(&uas_work_lock);
137 list_replace_init(&uas_work_list, &list);
138 spin_unlock_irq(&uas_work_lock);
140 list_for_each_entry(cmdinfo, &list, list) {
141 struct scsi_pointer *scp = (void *)cmdinfo;
142 struct scsi_cmnd *cmnd = container_of(scp,
143 struct scsi_cmnd, SCp);
144 uas_submit_urbs(cmnd, cmnd->device->hostdata, GFP_KERNEL);
148 static DECLARE_WORK(uas_work, uas_do_work);
150 static void uas_sense(struct urb *urb, struct scsi_cmnd *cmnd)
152 struct sense_iu *sense_iu = urb->transfer_buffer;
153 struct scsi_device *sdev = cmnd->device;
155 if (urb->actual_length > 16) {
156 unsigned len = be16_to_cpup(&sense_iu->len);
157 if (len + 16 != urb->actual_length) {
158 int newlen = min(len + 16, urb->actual_length) - 16;
161 sdev_printk(KERN_INFO, sdev, "%s: urb length %d "
162 "disagrees with IU sense data length %d, "
163 "using %d bytes of sense data\n", __func__,
164 urb->actual_length, len, newlen);
167 memcpy(cmnd->sense_buffer, sense_iu->sense, len);
170 cmnd->result = sense_iu->status;
171 if (sdev->current_cmnd)
172 sdev->current_cmnd = NULL;
173 cmnd->scsi_done(cmnd);
177 static void uas_sense_old(struct urb *urb, struct scsi_cmnd *cmnd)
179 struct sense_iu_old *sense_iu = urb->transfer_buffer;
180 struct scsi_device *sdev = cmnd->device;
182 if (urb->actual_length > 8) {
183 unsigned len = be16_to_cpup(&sense_iu->len) - 2;
184 if (len + 8 != urb->actual_length) {
185 int newlen = min(len + 8, urb->actual_length) - 8;
188 sdev_printk(KERN_INFO, sdev, "%s: urb length %d "
189 "disagrees with IU sense data length %d, "
190 "using %d bytes of sense data\n", __func__,
191 urb->actual_length, len, newlen);
194 memcpy(cmnd->sense_buffer, sense_iu->sense, len);
197 cmnd->result = sense_iu->status;
198 if (sdev->current_cmnd)
199 sdev->current_cmnd = NULL;
200 cmnd->scsi_done(cmnd);
204 static void uas_xfer_data(struct urb *urb, struct scsi_cmnd *cmnd,
207 struct uas_cmd_info *cmdinfo = (void *)&cmnd->SCp;
210 cmdinfo->state = direction | SUBMIT_STATUS_URB;
211 err = uas_submit_urbs(cmnd, cmnd->device->hostdata, GFP_ATOMIC);
213 spin_lock(&uas_work_lock);
214 list_add_tail(&cmdinfo->list, &uas_work_list);
215 spin_unlock(&uas_work_lock);
216 schedule_work(&uas_work);
220 static void uas_stat_cmplt(struct urb *urb)
222 struct iu *iu = urb->transfer_buffer;
223 struct scsi_device *sdev = urb->context;
224 struct uas_dev_info *devinfo = sdev->hostdata;
225 struct scsi_cmnd *cmnd;
229 dev_err(&urb->dev->dev, "URB BAD STATUS %d\n", urb->status);
234 tag = be16_to_cpup(&iu->tag) - 1;
235 if (sdev->current_cmnd)
236 cmnd = sdev->current_cmnd;
238 cmnd = scsi_find_tag(sdev, tag);
244 if (urb->actual_length < 16)
245 devinfo->uas_sense_old = 1;
246 if (devinfo->uas_sense_old)
247 uas_sense_old(urb, cmnd);
249 uas_sense(urb, cmnd);
251 case IU_ID_READ_READY:
252 uas_xfer_data(urb, cmnd, SUBMIT_DATA_IN_URB);
254 case IU_ID_WRITE_READY:
255 uas_xfer_data(urb, cmnd, SUBMIT_DATA_OUT_URB);
258 scmd_printk(KERN_ERR, cmnd,
259 "Bogus IU (%d) received on status pipe\n", iu->iu_id);
263 static void uas_data_cmplt(struct urb *urb)
265 struct scsi_data_buffer *sdb = urb->context;
266 sdb->resid = sdb->length - urb->actual_length;
270 static struct urb *uas_alloc_data_urb(struct uas_dev_info *devinfo, gfp_t gfp,
271 unsigned int pipe, u16 stream_id,
272 struct scsi_data_buffer *sdb,
273 enum dma_data_direction dir)
275 struct usb_device *udev = devinfo->udev;
276 struct urb *urb = usb_alloc_urb(0, gfp);
280 usb_fill_bulk_urb(urb, udev, pipe, NULL, sdb->length, uas_data_cmplt,
282 if (devinfo->use_streams)
283 urb->stream_id = stream_id;
284 urb->num_sgs = udev->bus->sg_tablesize ? sdb->table.nents : 0;
285 urb->sg = sdb->table.sgl;
290 static struct urb *uas_alloc_sense_urb(struct uas_dev_info *devinfo, gfp_t gfp,
291 struct scsi_cmnd *cmnd, u16 stream_id)
293 struct usb_device *udev = devinfo->udev;
294 struct urb *urb = usb_alloc_urb(0, gfp);
300 iu = kzalloc(sizeof(*iu), gfp);
304 usb_fill_bulk_urb(urb, udev, devinfo->status_pipe, iu, sizeof(*iu),
305 uas_stat_cmplt, cmnd->device);
306 urb->stream_id = stream_id;
307 urb->transfer_flags |= URB_FREE_BUFFER;
315 static struct urb *uas_alloc_cmd_urb(struct uas_dev_info *devinfo, gfp_t gfp,
316 struct scsi_cmnd *cmnd, u16 stream_id)
318 struct usb_device *udev = devinfo->udev;
319 struct scsi_device *sdev = cmnd->device;
320 struct urb *urb = usb_alloc_urb(0, gfp);
321 struct command_iu *iu;
327 len = cmnd->cmd_len - 16;
331 iu = kzalloc(sizeof(*iu) + len, gfp);
335 iu->iu_id = IU_ID_COMMAND;
336 iu->tag = cpu_to_be16(stream_id);
337 if (sdev->ordered_tags && (cmnd->request->cmd_flags & REQ_HARDBARRIER))
338 iu->prio_attr = UAS_ORDERED_TAG;
340 iu->prio_attr = UAS_SIMPLE_TAG;
342 int_to_scsilun(sdev->lun, &iu->lun);
343 memcpy(iu->cdb, cmnd->cmnd, cmnd->cmd_len);
345 usb_fill_bulk_urb(urb, udev, devinfo->cmd_pipe, iu, sizeof(*iu) + len,
347 urb->transfer_flags |= URB_FREE_BUFFER;
356 * Why should I request the Status IU before sending the Command IU? Spec
357 * says to, but also says the device may receive them in any order. Seems
361 static int uas_submit_urbs(struct scsi_cmnd *cmnd,
362 struct uas_dev_info *devinfo, gfp_t gfp)
364 struct uas_cmd_info *cmdinfo = (void *)&cmnd->SCp;
366 if (cmdinfo->state & ALLOC_STATUS_URB) {
367 cmdinfo->status_urb = uas_alloc_sense_urb(devinfo, gfp, cmnd,
369 if (!cmdinfo->status_urb)
370 return SCSI_MLQUEUE_DEVICE_BUSY;
371 cmdinfo->state &= ~ALLOC_STATUS_URB;
374 if (cmdinfo->state & SUBMIT_STATUS_URB) {
375 if (usb_submit_urb(cmdinfo->status_urb, gfp)) {
376 scmd_printk(KERN_INFO, cmnd,
377 "sense urb submission failure\n");
378 return SCSI_MLQUEUE_DEVICE_BUSY;
380 cmdinfo->state &= ~SUBMIT_STATUS_URB;
383 if (cmdinfo->state & ALLOC_DATA_IN_URB) {
384 cmdinfo->data_in_urb = uas_alloc_data_urb(devinfo, gfp,
385 devinfo->data_in_pipe, cmdinfo->stream,
386 scsi_in(cmnd), DMA_FROM_DEVICE);
387 if (!cmdinfo->data_in_urb)
388 return SCSI_MLQUEUE_DEVICE_BUSY;
389 cmdinfo->state &= ~ALLOC_DATA_IN_URB;
392 if (cmdinfo->state & SUBMIT_DATA_IN_URB) {
393 if (usb_submit_urb(cmdinfo->data_in_urb, gfp)) {
394 scmd_printk(KERN_INFO, cmnd,
395 "data in urb submission failure\n");
396 return SCSI_MLQUEUE_DEVICE_BUSY;
398 cmdinfo->state &= ~SUBMIT_DATA_IN_URB;
401 if (cmdinfo->state & ALLOC_DATA_OUT_URB) {
402 cmdinfo->data_out_urb = uas_alloc_data_urb(devinfo, gfp,
403 devinfo->data_out_pipe, cmdinfo->stream,
404 scsi_out(cmnd), DMA_TO_DEVICE);
405 if (!cmdinfo->data_out_urb)
406 return SCSI_MLQUEUE_DEVICE_BUSY;
407 cmdinfo->state &= ~ALLOC_DATA_OUT_URB;
410 if (cmdinfo->state & SUBMIT_DATA_OUT_URB) {
411 if (usb_submit_urb(cmdinfo->data_out_urb, gfp)) {
412 scmd_printk(KERN_INFO, cmnd,
413 "data out urb submission failure\n");
414 return SCSI_MLQUEUE_DEVICE_BUSY;
416 cmdinfo->state &= ~SUBMIT_DATA_OUT_URB;
419 if (cmdinfo->state & ALLOC_CMD_URB) {
420 cmdinfo->cmd_urb = uas_alloc_cmd_urb(devinfo, gfp, cmnd,
422 if (!cmdinfo->cmd_urb)
423 return SCSI_MLQUEUE_DEVICE_BUSY;
424 cmdinfo->state &= ~ALLOC_CMD_URB;
427 if (cmdinfo->state & SUBMIT_CMD_URB) {
428 if (usb_submit_urb(cmdinfo->cmd_urb, gfp)) {
429 scmd_printk(KERN_INFO, cmnd,
430 "cmd urb submission failure\n");
431 return SCSI_MLQUEUE_DEVICE_BUSY;
433 cmdinfo->state &= ~SUBMIT_CMD_URB;
439 static int uas_queuecommand(struct scsi_cmnd *cmnd,
440 void (*done)(struct scsi_cmnd *))
442 struct scsi_device *sdev = cmnd->device;
443 struct uas_dev_info *devinfo = sdev->hostdata;
444 struct uas_cmd_info *cmdinfo = (void *)&cmnd->SCp;
447 BUILD_BUG_ON(sizeof(struct uas_cmd_info) > sizeof(struct scsi_pointer));
449 if (!cmdinfo->status_urb && sdev->current_cmnd)
450 return SCSI_MLQUEUE_DEVICE_BUSY;
452 if (blk_rq_tagged(cmnd->request)) {
453 cmdinfo->stream = cmnd->request->tag + 1;
455 sdev->current_cmnd = cmnd;
459 cmnd->scsi_done = done;
461 cmdinfo->state = ALLOC_STATUS_URB | SUBMIT_STATUS_URB |
462 ALLOC_CMD_URB | SUBMIT_CMD_URB;
464 switch (cmnd->sc_data_direction) {
465 case DMA_FROM_DEVICE:
466 cmdinfo->state |= ALLOC_DATA_IN_URB | SUBMIT_DATA_IN_URB;
468 case DMA_BIDIRECTIONAL:
469 cmdinfo->state |= ALLOC_DATA_IN_URB | SUBMIT_DATA_IN_URB;
471 cmdinfo->state |= ALLOC_DATA_OUT_URB | SUBMIT_DATA_OUT_URB;
476 if (!devinfo->use_streams) {
477 cmdinfo->state &= ~(SUBMIT_DATA_IN_URB | SUBMIT_DATA_OUT_URB);
481 err = uas_submit_urbs(cmnd, devinfo, GFP_ATOMIC);
483 /* If we did nothing, give up now */
484 if (cmdinfo->state & SUBMIT_STATUS_URB) {
485 usb_free_urb(cmdinfo->status_urb);
486 return SCSI_MLQUEUE_DEVICE_BUSY;
488 spin_lock(&uas_work_lock);
489 list_add_tail(&cmdinfo->list, &uas_work_list);
490 spin_unlock(&uas_work_lock);
491 schedule_work(&uas_work);
497 static int uas_eh_abort_handler(struct scsi_cmnd *cmnd)
499 struct scsi_device *sdev = cmnd->device;
500 sdev_printk(KERN_INFO, sdev, "%s tag %d\n", __func__,
503 /* XXX: Send ABORT TASK Task Management command */
507 static int uas_eh_device_reset_handler(struct scsi_cmnd *cmnd)
509 struct scsi_device *sdev = cmnd->device;
510 sdev_printk(KERN_INFO, sdev, "%s tag %d\n", __func__,
513 /* XXX: Send LOGICAL UNIT RESET Task Management command */
517 static int uas_eh_target_reset_handler(struct scsi_cmnd *cmnd)
519 struct scsi_device *sdev = cmnd->device;
520 sdev_printk(KERN_INFO, sdev, "%s tag %d\n", __func__,
523 /* XXX: Can we reset just the one USB interface?
524 * Would calling usb_set_interface() have the right effect?
529 static int uas_eh_bus_reset_handler(struct scsi_cmnd *cmnd)
531 struct scsi_device *sdev = cmnd->device;
532 struct uas_dev_info *devinfo = sdev->hostdata;
533 struct usb_device *udev = devinfo->udev;
535 sdev_printk(KERN_INFO, sdev, "%s tag %d\n", __func__,
538 if (usb_reset_device(udev))
544 static int uas_slave_alloc(struct scsi_device *sdev)
546 sdev->hostdata = (void *)sdev->host->hostdata[0];
550 static int uas_slave_configure(struct scsi_device *sdev)
552 struct uas_dev_info *devinfo = sdev->hostdata;
553 scsi_set_tag_type(sdev, MSG_ORDERED_TAG);
554 scsi_activate_tcq(sdev, devinfo->qdepth - 1);
558 static struct scsi_host_template uas_host_template = {
559 .module = THIS_MODULE,
561 .queuecommand = uas_queuecommand,
562 .slave_alloc = uas_slave_alloc,
563 .slave_configure = uas_slave_configure,
564 .eh_abort_handler = uas_eh_abort_handler,
565 .eh_device_reset_handler = uas_eh_device_reset_handler,
566 .eh_target_reset_handler = uas_eh_target_reset_handler,
567 .eh_bus_reset_handler = uas_eh_bus_reset_handler,
568 .can_queue = 65536, /* Is there a limit on the _host_ ? */
570 .sg_tablesize = SG_NONE,
571 .cmd_per_lun = 1, /* until we override it */
572 .skip_settle_delay = 1,
576 static struct usb_device_id uas_usb_ids[] = {
577 { USB_INTERFACE_INFO(USB_CLASS_MASS_STORAGE, USB_SC_SCSI, USB_PR_BULK) },
578 { USB_INTERFACE_INFO(USB_CLASS_MASS_STORAGE, USB_SC_SCSI, USB_PR_UAS) },
579 /* 0xaa is a prototype device I happen to have access to */
580 { USB_INTERFACE_INFO(USB_CLASS_MASS_STORAGE, USB_SC_SCSI, 0xaa) },
583 MODULE_DEVICE_TABLE(usb, uas_usb_ids);
585 static int uas_is_interface(struct usb_host_interface *intf)
587 return (intf->desc.bInterfaceClass == USB_CLASS_MASS_STORAGE &&
588 intf->desc.bInterfaceSubClass == USB_SC_SCSI &&
589 intf->desc.bInterfaceProtocol == USB_PR_UAS);
592 static int uas_switch_interface(struct usb_device *udev,
593 struct usb_interface *intf)
597 if (uas_is_interface(intf->cur_altsetting))
600 for (i = 0; i < intf->num_altsetting; i++) {
601 struct usb_host_interface *alt = &intf->altsetting[i];
602 if (alt == intf->cur_altsetting)
604 if (uas_is_interface(alt))
605 return usb_set_interface(udev,
606 alt->desc.bInterfaceNumber,
607 alt->desc.bAlternateSetting);
613 static void uas_configure_endpoints(struct uas_dev_info *devinfo)
615 struct usb_host_endpoint *eps[4] = { };
616 struct usb_interface *intf = devinfo->intf;
617 struct usb_device *udev = devinfo->udev;
618 struct usb_host_endpoint *endpoint = intf->cur_altsetting->endpoint;
619 unsigned i, n_endpoints = intf->cur_altsetting->desc.bNumEndpoints;
621 devinfo->uas_sense_old = 0;
623 for (i = 0; i < n_endpoints; i++) {
624 unsigned char *extra = endpoint[i].extra;
625 int len = endpoint[i].extralen;
627 if (extra[1] == USB_DT_PIPE_USAGE) {
628 unsigned pipe_id = extra[2];
629 if (pipe_id > 0 && pipe_id < 5)
630 eps[pipe_id - 1] = &endpoint[i];
639 * Assume that if we didn't find a control pipe descriptor, we're
640 * using a device with old firmware that happens to be set up like
644 devinfo->cmd_pipe = usb_sndbulkpipe(udev, 1);
645 devinfo->status_pipe = usb_rcvbulkpipe(udev, 1);
646 devinfo->data_in_pipe = usb_rcvbulkpipe(udev, 2);
647 devinfo->data_out_pipe = usb_sndbulkpipe(udev, 2);
649 eps[1] = usb_pipe_endpoint(udev, devinfo->status_pipe);
650 eps[2] = usb_pipe_endpoint(udev, devinfo->data_in_pipe);
651 eps[3] = usb_pipe_endpoint(udev, devinfo->data_out_pipe);
653 devinfo->cmd_pipe = usb_sndbulkpipe(udev,
654 eps[0]->desc.bEndpointAddress);
655 devinfo->status_pipe = usb_rcvbulkpipe(udev,
656 eps[1]->desc.bEndpointAddress);
657 devinfo->data_in_pipe = usb_rcvbulkpipe(udev,
658 eps[2]->desc.bEndpointAddress);
659 devinfo->data_out_pipe = usb_sndbulkpipe(udev,
660 eps[3]->desc.bEndpointAddress);
663 devinfo->qdepth = usb_alloc_streams(devinfo->intf, eps + 1, 3, 256,
665 if (devinfo->qdepth < 0) {
666 devinfo->qdepth = 256;
667 devinfo->use_streams = 0;
669 devinfo->use_streams = 1;
674 * XXX: What I'd like to do here is register a SCSI host for each USB host in
675 * the system. Follow usb-storage's design of registering a SCSI host for
676 * each USB device for the moment. Can implement this by walking up the
677 * USB hierarchy until we find a USB host.
679 static int uas_probe(struct usb_interface *intf, const struct usb_device_id *id)
682 struct Scsi_Host *shost;
683 struct uas_dev_info *devinfo;
684 struct usb_device *udev = interface_to_usbdev(intf);
686 if (uas_switch_interface(udev, intf))
689 devinfo = kmalloc(sizeof(struct uas_dev_info), GFP_KERNEL);
694 shost = scsi_host_alloc(&uas_host_template, sizeof(void *));
698 shost->max_cmd_len = 16 + 252;
700 shost->sg_tablesize = udev->bus->sg_tablesize;
702 result = scsi_add_host(shost, &intf->dev);
705 shost->hostdata[0] = (unsigned long)devinfo;
707 devinfo->intf = intf;
708 devinfo->udev = udev;
709 uas_configure_endpoints(devinfo);
711 scsi_scan_host(shost);
712 usb_set_intfdata(intf, shost);
717 scsi_host_put(shost);
721 static int uas_pre_reset(struct usb_interface *intf)
723 /* XXX: Need to return 1 if it's not our device in error handling */
727 static int uas_post_reset(struct usb_interface *intf)
729 /* XXX: Need to return 1 if it's not our device in error handling */
733 static void uas_disconnect(struct usb_interface *intf)
735 struct usb_device *udev = interface_to_usbdev(intf);
736 struct usb_host_endpoint *eps[3];
737 struct Scsi_Host *shost = usb_get_intfdata(intf);
738 struct uas_dev_info *devinfo = (void *)shost->hostdata[0];
740 scsi_remove_host(shost);
742 eps[0] = usb_pipe_endpoint(udev, devinfo->status_pipe);
743 eps[1] = usb_pipe_endpoint(udev, devinfo->data_in_pipe);
744 eps[2] = usb_pipe_endpoint(udev, devinfo->data_out_pipe);
745 usb_free_streams(intf, eps, 3, GFP_KERNEL);
751 * XXX: Should this plug into libusual so we can auto-upgrade devices from
754 static struct usb_driver uas_driver = {
757 .disconnect = uas_disconnect,
758 .pre_reset = uas_pre_reset,
759 .post_reset = uas_post_reset,
760 .id_table = uas_usb_ids,
763 static int uas_init(void)
765 return usb_register(&uas_driver);
768 static void uas_exit(void)
770 usb_deregister(&uas_driver);
773 module_init(uas_init);
774 module_exit(uas_exit);
776 MODULE_LICENSE("GPL");
777 MODULE_AUTHOR("Matthew Wilcox and Sarah Sharp");