xref: /freebsd/sys/dev/usb/usb_msctest.c (revision 9a41df2a0e6408e9b329bbd8b9e37c2b44461a1b)
1 /* $FreeBSD$ */
2 /*-
3  * Copyright (c) 2008,2011 Hans Petter Selasky. All rights reserved.
4  *
5  * Redistribution and use in source and binary forms, with or without
6  * modification, are permitted provided that the following conditions
7  * are met:
8  * 1. Redistributions of source code must retain the above copyright
9  *    notice, this list of conditions and the following disclaimer.
10  * 2. Redistributions in binary form must reproduce the above copyright
11  *    notice, this list of conditions and the following disclaimer in the
12  *    documentation and/or other materials provided with the distribution.
13  *
14  * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
15  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
16  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
17  * ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
18  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
19  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
20  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
21  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
22  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
23  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
24  * SUCH DAMAGE.
25  */
26 
27 /*
28  * The following file contains code that will detect USB autoinstall
29  * disks.
30  *
31  * TODO: Potentially we could add code to automatically detect USB
32  * mass storage quirks for not supported SCSI commands!
33  */
34 
35 #include <sys/stdint.h>
36 #include <sys/stddef.h>
37 #include <sys/param.h>
38 #include <sys/queue.h>
39 #include <sys/types.h>
40 #include <sys/systm.h>
41 #include <sys/kernel.h>
42 #include <sys/bus.h>
43 #include <sys/module.h>
44 #include <sys/lock.h>
45 #include <sys/mutex.h>
46 #include <sys/condvar.h>
47 #include <sys/sysctl.h>
48 #include <sys/sx.h>
49 #include <sys/unistd.h>
50 #include <sys/callout.h>
51 #include <sys/malloc.h>
52 #include <sys/priv.h>
53 
54 #include <dev/usb/usb.h>
55 #include <dev/usb/usbdi.h>
56 #include <dev/usb/usbdi_util.h>
57 
58 #define	USB_DEBUG_VAR usb_debug
59 
60 #include <dev/usb/usb_busdma.h>
61 #include <dev/usb/usb_process.h>
62 #include <dev/usb/usb_transfer.h>
63 #include <dev/usb/usb_msctest.h>
64 #include <dev/usb/usb_debug.h>
65 #include <dev/usb/usb_device.h>
66 #include <dev/usb/usb_request.h>
67 #include <dev/usb/usb_util.h>
68 #include <dev/usb/quirk/usb_quirk.h>
69 
70 enum {
71 	ST_COMMAND,
72 	ST_DATA_RD,
73 	ST_DATA_RD_CS,
74 	ST_DATA_WR,
75 	ST_DATA_WR_CS,
76 	ST_STATUS,
77 	ST_MAX,
78 };
79 
80 enum {
81 	DIR_IN,
82 	DIR_OUT,
83 	DIR_NONE,
84 };
85 
86 #define	SCSI_MAX_LEN	0x100
87 #define	SCSI_INQ_LEN	0x24
88 #define	SCSI_SENSE_LEN	0xFF
89 
90 static uint8_t scsi_test_unit_ready[] = { 0x00, 0x00, 0x00, 0x00, 0x00, 0x00 };
91 static uint8_t scsi_inquiry[] = { 0x12, 0x00, 0x00, 0x00, SCSI_INQ_LEN, 0x00 };
92 static uint8_t scsi_rezero_init[] =     { 0x01, 0x00, 0x00, 0x00, 0x00, 0x00 };
93 static uint8_t scsi_start_stop_unit[] = { 0x1b, 0x00, 0x00, 0x00, 0x02, 0x00 };
94 static uint8_t scsi_ztestor_eject[] =   { 0x85, 0x01, 0x01, 0x01, 0x18, 0x01,
95 					  0x01, 0x01, 0x01, 0x01, 0x00, 0x00 };
96 static uint8_t scsi_cmotech_eject[] =   { 0xff, 0x52, 0x44, 0x45, 0x56, 0x43,
97 					  0x48, 0x47 };
98 static uint8_t scsi_huawei_eject[] =	{ 0x11, 0x06, 0x00, 0x00, 0x00, 0x00,
99 					  0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
100 					  0x00, 0x00, 0x00, 0x00 };
101 static uint8_t scsi_tct_eject[] =	{ 0x06, 0xf5, 0x04, 0x02, 0x52, 0x70 };
102 static uint8_t scsi_sync_cache[] =	{ 0x35, 0x00, 0x00, 0x00, 0x00, 0x00,
103 					  0x00, 0x00, 0x00, 0x00 };
104 static uint8_t scsi_request_sense[] =	{ 0x03, 0x00, 0x00, 0x00, 0x12, 0x00,
105 					  0x00, 0x00, 0x00, 0x00, 0x00, 0x00 };
106 static uint8_t scsi_read_capacity[] =	{ 0x25, 0x00, 0x00, 0x00, 0x00, 0x00,
107 					  0x00, 0x00, 0x00, 0x00 };
108 
109 #define	BULK_SIZE		64	/* dummy */
110 #define	ERR_CSW_FAILED		-1
111 
112 /* Command Block Wrapper */
113 struct bbb_cbw {
114 	uDWord	dCBWSignature;
115 #define	CBWSIGNATURE	0x43425355
116 	uDWord	dCBWTag;
117 	uDWord	dCBWDataTransferLength;
118 	uByte	bCBWFlags;
119 #define	CBWFLAGS_OUT	0x00
120 #define	CBWFLAGS_IN	0x80
121 	uByte	bCBWLUN;
122 	uByte	bCDBLength;
123 #define	CBWCDBLENGTH	16
124 	uByte	CBWCDB[CBWCDBLENGTH];
125 } __packed;
126 
127 /* Command Status Wrapper */
128 struct bbb_csw {
129 	uDWord	dCSWSignature;
130 #define	CSWSIGNATURE	0x53425355
131 	uDWord	dCSWTag;
132 	uDWord	dCSWDataResidue;
133 	uByte	bCSWStatus;
134 #define	CSWSTATUS_GOOD	0x0
135 #define	CSWSTATUS_FAILED	0x1
136 #define	CSWSTATUS_PHASE	0x2
137 } __packed;
138 
139 struct bbb_transfer {
140 	struct mtx mtx;
141 	struct cv cv;
142 	struct bbb_cbw cbw;
143 	struct bbb_csw csw;
144 
145 	struct usb_xfer *xfer[ST_MAX];
146 
147 	uint8_t *data_ptr;
148 
149 	usb_size_t data_len;		/* bytes */
150 	usb_size_t data_rem;		/* bytes */
151 	usb_timeout_t data_timeout;	/* ms */
152 	usb_frlength_t actlen;		/* bytes */
153 
154 	uint8_t	cmd_len;		/* bytes */
155 	uint8_t	dir;
156 	uint8_t	lun;
157 	uint8_t	state;
158 	uint8_t	status_try;
159 	int	error;
160 
161 	uint8_t	buffer[SCSI_MAX_LEN] __aligned(4);
162 };
163 
164 static usb_callback_t bbb_command_callback;
165 static usb_callback_t bbb_data_read_callback;
166 static usb_callback_t bbb_data_rd_cs_callback;
167 static usb_callback_t bbb_data_write_callback;
168 static usb_callback_t bbb_data_wr_cs_callback;
169 static usb_callback_t bbb_status_callback;
170 
171 static void	bbb_done(struct bbb_transfer *, int);
172 static void	bbb_transfer_start(struct bbb_transfer *, uint8_t);
173 static void	bbb_data_clear_stall_callback(struct usb_xfer *, uint8_t,
174 		    uint8_t);
175 static int	bbb_command_start(struct bbb_transfer *, uint8_t, uint8_t,
176 		    void *, size_t, void *, size_t, usb_timeout_t);
177 static struct bbb_transfer *bbb_attach(struct usb_device *, uint8_t);
178 static void	bbb_detach(struct bbb_transfer *);
179 
180 static const struct usb_config bbb_config[ST_MAX] = {
181 
182 	[ST_COMMAND] = {
183 		.type = UE_BULK,
184 		.endpoint = UE_ADDR_ANY,
185 		.direction = UE_DIR_OUT,
186 		.bufsize = sizeof(struct bbb_cbw),
187 		.flags = {.ext_buffer = 1,},
188 		.callback = &bbb_command_callback,
189 		.timeout = 4 * USB_MS_HZ,	/* 4 seconds */
190 	},
191 
192 	[ST_DATA_RD] = {
193 		.type = UE_BULK,
194 		.endpoint = UE_ADDR_ANY,
195 		.direction = UE_DIR_IN,
196 		.bufsize = BULK_SIZE,
197 		.flags = {.ext_buffer = 1,.proxy_buffer = 1,.short_xfer_ok = 1,},
198 		.callback = &bbb_data_read_callback,
199 		.timeout = 4 * USB_MS_HZ,	/* 4 seconds */
200 	},
201 
202 	[ST_DATA_RD_CS] = {
203 		.type = UE_CONTROL,
204 		.endpoint = 0x00,	/* Control pipe */
205 		.direction = UE_DIR_ANY,
206 		.bufsize = sizeof(struct usb_device_request),
207 		.callback = &bbb_data_rd_cs_callback,
208 		.timeout = 1 * USB_MS_HZ,	/* 1 second  */
209 	},
210 
211 	[ST_DATA_WR] = {
212 		.type = UE_BULK,
213 		.endpoint = UE_ADDR_ANY,
214 		.direction = UE_DIR_OUT,
215 		.bufsize = BULK_SIZE,
216 		.flags = {.ext_buffer = 1,.proxy_buffer = 1,},
217 		.callback = &bbb_data_write_callback,
218 		.timeout = 4 * USB_MS_HZ,	/* 4 seconds */
219 	},
220 
221 	[ST_DATA_WR_CS] = {
222 		.type = UE_CONTROL,
223 		.endpoint = 0x00,	/* Control pipe */
224 		.direction = UE_DIR_ANY,
225 		.bufsize = sizeof(struct usb_device_request),
226 		.callback = &bbb_data_wr_cs_callback,
227 		.timeout = 1 * USB_MS_HZ,	/* 1 second  */
228 	},
229 
230 	[ST_STATUS] = {
231 		.type = UE_BULK,
232 		.endpoint = UE_ADDR_ANY,
233 		.direction = UE_DIR_IN,
234 		.bufsize = sizeof(struct bbb_csw),
235 		.flags = {.ext_buffer = 1,.short_xfer_ok = 1,},
236 		.callback = &bbb_status_callback,
237 		.timeout = 1 * USB_MS_HZ,	/* 1 second  */
238 	},
239 };
240 
241 static void
242 bbb_done(struct bbb_transfer *sc, int error)
243 {
244 
245 	sc->error = error;
246 	sc->state = ST_COMMAND;
247 	sc->status_try = 1;
248 	cv_signal(&sc->cv);
249 }
250 
251 static void
252 bbb_transfer_start(struct bbb_transfer *sc, uint8_t xfer_index)
253 {
254 	sc->state = xfer_index;
255 	usbd_transfer_start(sc->xfer[xfer_index]);
256 }
257 
258 static void
259 bbb_data_clear_stall_callback(struct usb_xfer *xfer,
260     uint8_t next_xfer, uint8_t stall_xfer)
261 {
262 	struct bbb_transfer *sc = usbd_xfer_softc(xfer);
263 
264 	if (usbd_clear_stall_callback(xfer, sc->xfer[stall_xfer])) {
265 		switch (USB_GET_STATE(xfer)) {
266 		case USB_ST_SETUP:
267 		case USB_ST_TRANSFERRED:
268 			bbb_transfer_start(sc, next_xfer);
269 			break;
270 		default:
271 			bbb_done(sc, USB_ERR_STALLED);
272 			break;
273 		}
274 	}
275 }
276 
277 static void
278 bbb_command_callback(struct usb_xfer *xfer, usb_error_t error)
279 {
280 	struct bbb_transfer *sc = usbd_xfer_softc(xfer);
281 	uint32_t tag;
282 
283 	switch (USB_GET_STATE(xfer)) {
284 	case USB_ST_TRANSFERRED:
285 		bbb_transfer_start
286 		    (sc, ((sc->dir == DIR_IN) ? ST_DATA_RD :
287 		    (sc->dir == DIR_OUT) ? ST_DATA_WR :
288 		    ST_STATUS));
289 		break;
290 
291 	case USB_ST_SETUP:
292 		sc->status_try = 0;
293 		tag = UGETDW(sc->cbw.dCBWTag) + 1;
294 		USETDW(sc->cbw.dCBWSignature, CBWSIGNATURE);
295 		USETDW(sc->cbw.dCBWTag, tag);
296 		USETDW(sc->cbw.dCBWDataTransferLength, (uint32_t)sc->data_len);
297 		sc->cbw.bCBWFlags = ((sc->dir == DIR_IN) ? CBWFLAGS_IN : CBWFLAGS_OUT);
298 		sc->cbw.bCBWLUN = sc->lun;
299 		sc->cbw.bCDBLength = sc->cmd_len;
300 		if (sc->cbw.bCDBLength > sizeof(sc->cbw.CBWCDB)) {
301 			sc->cbw.bCDBLength = sizeof(sc->cbw.CBWCDB);
302 			DPRINTFN(0, "Truncating long command\n");
303 		}
304 		usbd_xfer_set_frame_data(xfer, 0, &sc->cbw, sizeof(sc->cbw));
305 		usbd_transfer_submit(xfer);
306 		break;
307 
308 	default:			/* Error */
309 		bbb_done(sc, error);
310 		break;
311 	}
312 }
313 
314 static void
315 bbb_data_read_callback(struct usb_xfer *xfer, usb_error_t error)
316 {
317 	struct bbb_transfer *sc = usbd_xfer_softc(xfer);
318 	usb_frlength_t max_bulk = usbd_xfer_max_len(xfer);
319 	int actlen, sumlen;
320 
321 	usbd_xfer_status(xfer, &actlen, &sumlen, NULL, NULL);
322 
323 	switch (USB_GET_STATE(xfer)) {
324 	case USB_ST_TRANSFERRED:
325 		sc->data_rem -= actlen;
326 		sc->data_ptr += actlen;
327 		sc->actlen += actlen;
328 
329 		if (actlen < sumlen) {
330 			/* short transfer */
331 			sc->data_rem = 0;
332 		}
333 	case USB_ST_SETUP:
334 		DPRINTF("max_bulk=%d, data_rem=%d\n",
335 		    max_bulk, sc->data_rem);
336 
337 		if (sc->data_rem == 0) {
338 			bbb_transfer_start(sc, ST_STATUS);
339 			break;
340 		}
341 		if (max_bulk > sc->data_rem) {
342 			max_bulk = sc->data_rem;
343 		}
344 		usbd_xfer_set_timeout(xfer, sc->data_timeout);
345 		usbd_xfer_set_frame_data(xfer, 0, sc->data_ptr, max_bulk);
346 		usbd_transfer_submit(xfer);
347 		break;
348 
349 	default:			/* Error */
350 		if (error == USB_ERR_CANCELLED) {
351 			bbb_done(sc, error);
352 		} else {
353 			bbb_transfer_start(sc, ST_DATA_RD_CS);
354 		}
355 		break;
356 	}
357 }
358 
359 static void
360 bbb_data_rd_cs_callback(struct usb_xfer *xfer, usb_error_t error)
361 {
362 	bbb_data_clear_stall_callback(xfer, ST_STATUS,
363 	    ST_DATA_RD);
364 }
365 
366 static void
367 bbb_data_write_callback(struct usb_xfer *xfer, usb_error_t error)
368 {
369 	struct bbb_transfer *sc = usbd_xfer_softc(xfer);
370 	usb_frlength_t max_bulk = usbd_xfer_max_len(xfer);
371 	int actlen, sumlen;
372 
373 	usbd_xfer_status(xfer, &actlen, &sumlen, NULL, NULL);
374 
375 	switch (USB_GET_STATE(xfer)) {
376 	case USB_ST_TRANSFERRED:
377 		sc->data_rem -= actlen;
378 		sc->data_ptr += actlen;
379 		sc->actlen += actlen;
380 
381 		if (actlen < sumlen) {
382 			/* short transfer */
383 			sc->data_rem = 0;
384 		}
385 	case USB_ST_SETUP:
386 		DPRINTF("max_bulk=%d, data_rem=%d\n",
387 		    max_bulk, sc->data_rem);
388 
389 		if (sc->data_rem == 0) {
390 			bbb_transfer_start(sc, ST_STATUS);
391 			return;
392 		}
393 		if (max_bulk > sc->data_rem) {
394 			max_bulk = sc->data_rem;
395 		}
396 		usbd_xfer_set_timeout(xfer, sc->data_timeout);
397 		usbd_xfer_set_frame_data(xfer, 0, sc->data_ptr, max_bulk);
398 		usbd_transfer_submit(xfer);
399 		return;
400 
401 	default:			/* Error */
402 		if (error == USB_ERR_CANCELLED) {
403 			bbb_done(sc, error);
404 		} else {
405 			bbb_transfer_start(sc, ST_DATA_WR_CS);
406 		}
407 		return;
408 
409 	}
410 }
411 
412 static void
413 bbb_data_wr_cs_callback(struct usb_xfer *xfer, usb_error_t error)
414 {
415 	bbb_data_clear_stall_callback(xfer, ST_STATUS,
416 	    ST_DATA_WR);
417 }
418 
419 static void
420 bbb_status_callback(struct usb_xfer *xfer, usb_error_t error)
421 {
422 	struct bbb_transfer *sc = usbd_xfer_softc(xfer);
423 	int actlen;
424 	int sumlen;
425 
426 	usbd_xfer_status(xfer, &actlen, &sumlen, NULL, NULL);
427 
428 	switch (USB_GET_STATE(xfer)) {
429 	case USB_ST_TRANSFERRED:
430 
431 		/* very simple status check */
432 
433 		if (actlen < (int)sizeof(sc->csw)) {
434 			bbb_done(sc, USB_ERR_SHORT_XFER);
435 		} else if (sc->csw.bCSWStatus == CSWSTATUS_GOOD) {
436 			bbb_done(sc, 0);	/* success */
437 		} else {
438 			bbb_done(sc, ERR_CSW_FAILED);	/* error */
439 		}
440 		break;
441 
442 	case USB_ST_SETUP:
443 		usbd_xfer_set_frame_data(xfer, 0, &sc->csw, sizeof(sc->csw));
444 		usbd_transfer_submit(xfer);
445 		break;
446 
447 	default:
448 		DPRINTF("Failed to read CSW: %s, try %d\n",
449 		    usbd_errstr(error), sc->status_try);
450 
451 		if (error == USB_ERR_CANCELLED || sc->status_try) {
452 			bbb_done(sc, error);
453 		} else {
454 			sc->status_try = 1;
455 			bbb_transfer_start(sc, ST_DATA_RD_CS);
456 		}
457 		break;
458 	}
459 }
460 
461 /*------------------------------------------------------------------------*
462  *	bbb_command_start - execute a SCSI command synchronously
463  *
464  * Return values
465  * 0: Success
466  * Else: Failure
467  *------------------------------------------------------------------------*/
468 static int
469 bbb_command_start(struct bbb_transfer *sc, uint8_t dir, uint8_t lun,
470     void *data_ptr, size_t data_len, void *cmd_ptr, size_t cmd_len,
471     usb_timeout_t data_timeout)
472 {
473 	sc->lun = lun;
474 	sc->dir = data_len ? dir : DIR_NONE;
475 	sc->data_ptr = data_ptr;
476 	sc->data_len = data_len;
477 	sc->data_rem = data_len;
478 	sc->data_timeout = (data_timeout + USB_MS_HZ);
479 	sc->actlen = 0;
480 	sc->cmd_len = cmd_len;
481 	memset(&sc->cbw.CBWCDB, 0, sizeof(sc->cbw.CBWCDB));
482 	memcpy(&sc->cbw.CBWCDB, cmd_ptr, cmd_len);
483 	DPRINTFN(1, "SCSI cmd = %*D\n", (int)cmd_len, (char *)sc->cbw.CBWCDB, ":");
484 
485 	mtx_lock(&sc->mtx);
486 	usbd_transfer_start(sc->xfer[sc->state]);
487 
488 	while (usbd_transfer_pending(sc->xfer[sc->state])) {
489 		cv_wait(&sc->cv, &sc->mtx);
490 	}
491 	mtx_unlock(&sc->mtx);
492 	return (sc->error);
493 }
494 
495 static struct bbb_transfer *
496 bbb_attach(struct usb_device *udev, uint8_t iface_index)
497 {
498 	struct usb_interface *iface;
499 	struct usb_interface_descriptor *id;
500 	struct bbb_transfer *sc;
501 	usb_error_t err;
502 	uint8_t do_unlock;
503 
504 	/* automatic locking */
505 	if (usbd_enum_is_locked(udev)) {
506 		do_unlock = 0;
507 	} else {
508 		do_unlock = 1;
509 		usbd_enum_lock(udev);
510 	}
511 
512 	/*
513 	 * Make sure any driver which is hooked up to this interface,
514 	 * like umass is gone:
515 	 */
516 	usb_detach_device(udev, iface_index, 0);
517 
518 	if (do_unlock)
519 		usbd_enum_unlock(udev);
520 
521 	iface = usbd_get_iface(udev, iface_index);
522 	if (iface == NULL)
523 		return (NULL);
524 
525 	id = iface->idesc;
526 	if (id == NULL || id->bInterfaceClass != UICLASS_MASS)
527 		return (NULL);
528 
529 	switch (id->bInterfaceSubClass) {
530 	case UISUBCLASS_SCSI:
531 	case UISUBCLASS_UFI:
532 	case UISUBCLASS_SFF8020I:
533 	case UISUBCLASS_SFF8070I:
534 		break;
535 	default:
536 		return (NULL);
537 	}
538 
539 	switch (id->bInterfaceProtocol) {
540 	case UIPROTO_MASS_BBB_OLD:
541 	case UIPROTO_MASS_BBB:
542 		break;
543 	default:
544 		return (NULL);
545 	}
546 
547 	sc = malloc(sizeof(*sc), M_USB, M_WAITOK | M_ZERO);
548 	mtx_init(&sc->mtx, "USB autoinstall", NULL, MTX_DEF);
549 	cv_init(&sc->cv, "WBBB");
550 
551 	err = usbd_transfer_setup(udev, &iface_index, sc->xfer, bbb_config,
552 	    ST_MAX, sc, &sc->mtx);
553 	if (err) {
554 		bbb_detach(sc);
555 		return (NULL);
556 	}
557 	return (sc);
558 }
559 
560 static void
561 bbb_detach(struct bbb_transfer *sc)
562 {
563 	usbd_transfer_unsetup(sc->xfer, ST_MAX);
564 	mtx_destroy(&sc->mtx);
565 	cv_destroy(&sc->cv);
566 	free(sc, M_USB);
567 }
568 
569 /*------------------------------------------------------------------------*
570  *	usb_iface_is_cdrom
571  *
572  * Return values:
573  * 1: This interface is an auto install disk (CD-ROM)
574  * 0: Not an auto install disk.
575  *------------------------------------------------------------------------*/
576 int
577 usb_iface_is_cdrom(struct usb_device *udev, uint8_t iface_index)
578 {
579 	struct bbb_transfer *sc;
580 	uint8_t timeout;
581 	uint8_t is_cdrom;
582 	uint8_t sid_type;
583 	int err;
584 
585 	sc = bbb_attach(udev, iface_index);
586 	if (sc == NULL)
587 		return (0);
588 
589 	is_cdrom = 0;
590 	timeout = 4;	/* tries */
591 	while (--timeout) {
592 		err = bbb_command_start(sc, DIR_IN, 0, sc->buffer,
593 		    SCSI_INQ_LEN, &scsi_inquiry, sizeof(scsi_inquiry),
594 		    USB_MS_HZ);
595 
596 		if (err == 0 && sc->actlen > 0) {
597 			sid_type = sc->buffer[0] & 0x1F;
598 			if (sid_type == 0x05)
599 				is_cdrom = 1;
600 			break;
601 		} else if (err != ERR_CSW_FAILED)
602 			break;	/* non retryable error */
603 		usb_pause_mtx(NULL, hz);
604 	}
605 	bbb_detach(sc);
606 	return (is_cdrom);
607 }
608 
609 static uint8_t
610 usb_msc_get_max_lun(struct usb_device *udev, uint8_t iface_index)
611 {
612 	struct usb_device_request req;
613 	usb_error_t err;
614 	uint8_t buf = 0;
615 
616 
617 	/* The Get Max Lun command is a class-specific request. */
618 	req.bmRequestType = UT_READ_CLASS_INTERFACE;
619 	req.bRequest = 0xFE;		/* GET_MAX_LUN */
620 	USETW(req.wValue, 0);
621 	req.wIndex[0] = iface_index;
622 	req.wIndex[1] = 0;
623 	USETW(req.wLength, 1);
624 
625 	err = usbd_do_request(udev, NULL, &req, &buf);
626 	if (err)
627 		buf = 0;
628 
629 	return (buf);
630 }
631 
632 usb_error_t
633 usb_msc_auto_quirk(struct usb_device *udev, uint8_t iface_index)
634 {
635 	struct bbb_transfer *sc;
636 	uint8_t timeout;
637 	uint8_t is_no_direct;
638 	uint8_t sid_type;
639 	int err;
640 
641 	sc = bbb_attach(udev, iface_index);
642 	if (sc == NULL)
643 		return (0);
644 
645 	/*
646 	 * Some devices need a delay after that the configuration
647 	 * value is set to function properly:
648 	 */
649 	usb_pause_mtx(NULL, hz);
650 
651 	if (usb_msc_get_max_lun(udev, iface_index) == 0) {
652 		DPRINTF("Device has only got one LUN.\n");
653 		usbd_add_dynamic_quirk(udev, UQ_MSC_NO_GETMAXLUN);
654 	}
655 
656 	is_no_direct = 1;
657 	for (timeout = 4; timeout != 0; timeout--) {
658 		err = bbb_command_start(sc, DIR_IN, 0, sc->buffer,
659 		    SCSI_INQ_LEN, &scsi_inquiry, sizeof(scsi_inquiry),
660 		    USB_MS_HZ);
661 
662 		if (err == 0 && sc->actlen > 0) {
663 			sid_type = sc->buffer[0] & 0x1F;
664 			if (sid_type == 0x00)
665 				is_no_direct = 0;
666 			break;
667 		} else if (err != ERR_CSW_FAILED)
668 			break;	/* non retryable error */
669 		usb_pause_mtx(NULL, hz);
670 	}
671 
672 	if (is_no_direct) {
673 		DPRINTF("Device is not direct access.\n");
674 		goto done;
675 	}
676 
677 	err = bbb_command_start(sc, DIR_IN, 0, NULL, 0,
678 	    &scsi_test_unit_ready, sizeof(scsi_test_unit_ready),
679 	    USB_MS_HZ);
680 
681 	if (err != 0) {
682 
683 		if (err != ERR_CSW_FAILED)
684 			goto error;
685 	}
686 	timeout = 1;
687 
688 retry_sync_cache:
689 	err = bbb_command_start(sc, DIR_IN, 0, NULL, 0,
690 	    &scsi_sync_cache, sizeof(scsi_sync_cache),
691 	    USB_MS_HZ);
692 
693 	if (err != 0) {
694 
695 		if (err != ERR_CSW_FAILED)
696 			goto error;
697 
698 		DPRINTF("Device doesn't handle synchronize cache\n");
699 
700 		usbd_add_dynamic_quirk(udev, UQ_MSC_NO_SYNC_CACHE);
701 
702 	} else {
703 
704 		/*
705 		 * Certain Kingston memory sticks fail the first
706 		 * read capacity after a synchronize cache command
707 		 * has been issued. Disable the synchronize cache
708 		 * command for such devices.
709 		 */
710 
711 		err = bbb_command_start(sc, DIR_IN, 0, sc->buffer, 8,
712 		    &scsi_read_capacity, sizeof(scsi_read_capacity),
713 		    USB_MS_HZ);
714 
715 		if (err != 0) {
716 			if (err != ERR_CSW_FAILED)
717 				goto error;
718 
719 			err = bbb_command_start(sc, DIR_IN, 0, sc->buffer, 8,
720 			    &scsi_read_capacity, sizeof(scsi_read_capacity),
721 			    USB_MS_HZ);
722 
723 			if (err == 0) {
724 				if (timeout--)
725 					goto retry_sync_cache;
726 
727 				DPRINTF("Device most likely doesn't "
728 				    "handle synchronize cache\n");
729 
730 				usbd_add_dynamic_quirk(udev,
731 				    UQ_MSC_NO_SYNC_CACHE);
732 			} else {
733 				if (err != ERR_CSW_FAILED)
734 					goto error;
735 			}
736 		}
737 	}
738 
739 	/* clear sense status of any failed commands on the device */
740 
741 	err = bbb_command_start(sc, DIR_IN, 0, sc->buffer,
742 	    SCSI_INQ_LEN, &scsi_inquiry, sizeof(scsi_inquiry),
743 	    USB_MS_HZ);
744 
745 	DPRINTF("Inquiry = %d\n", err);
746 
747 	if (err != 0) {
748 
749 		if (err != ERR_CSW_FAILED)
750 			goto error;
751 	}
752 
753 	err = bbb_command_start(sc, DIR_IN, 0, sc->buffer,
754 	    SCSI_SENSE_LEN, &scsi_request_sense,
755 	    sizeof(scsi_request_sense), USB_MS_HZ);
756 
757 	DPRINTF("Request sense = %d\n", err);
758 
759 	if (err != 0) {
760 
761 		if (err != ERR_CSW_FAILED)
762 			goto error;
763 	}
764 
765 done:
766 	bbb_detach(sc);
767 	return (0);
768 
769 error:
770  	bbb_detach(sc);
771 
772 	DPRINTF("Device did not respond, enabling all quirks\n");
773 
774 	usbd_add_dynamic_quirk(udev, UQ_MSC_NO_SYNC_CACHE);
775 	usbd_add_dynamic_quirk(udev, UQ_MSC_NO_TEST_UNIT_READY);
776 
777 	/* Need to re-enumerate the device */
778 	usbd_req_re_enumerate(udev, NULL);
779 
780 	return (USB_ERR_STALLED);
781 }
782 
783 usb_error_t
784 usb_msc_eject(struct usb_device *udev, uint8_t iface_index, int method)
785 {
786 	struct bbb_transfer *sc;
787 	usb_error_t err;
788 
789 	sc = bbb_attach(udev, iface_index);
790 	if (sc == NULL)
791 		return (USB_ERR_INVAL);
792 
793 	err = 0;
794 	switch (method) {
795 	case MSC_EJECT_STOPUNIT:
796 		err = bbb_command_start(sc, DIR_IN, 0, NULL, 0,
797 		    &scsi_test_unit_ready, sizeof(scsi_test_unit_ready),
798 		    USB_MS_HZ);
799 		DPRINTF("Test unit ready status: %s\n", usbd_errstr(err));
800 		err = bbb_command_start(sc, DIR_IN, 0, NULL, 0,
801 		    &scsi_start_stop_unit, sizeof(scsi_start_stop_unit),
802 		    USB_MS_HZ);
803 		break;
804 	case MSC_EJECT_REZERO:
805 		err = bbb_command_start(sc, DIR_IN, 0, NULL, 0,
806 		    &scsi_rezero_init, sizeof(scsi_rezero_init),
807 		    USB_MS_HZ);
808 		break;
809 	case MSC_EJECT_ZTESTOR:
810 		err = bbb_command_start(sc, DIR_IN, 0, NULL, 0,
811 		    &scsi_ztestor_eject, sizeof(scsi_ztestor_eject),
812 		    USB_MS_HZ);
813 		break;
814 	case MSC_EJECT_CMOTECH:
815 		err = bbb_command_start(sc, DIR_IN, 0, NULL, 0,
816 		    &scsi_cmotech_eject, sizeof(scsi_cmotech_eject),
817 		    USB_MS_HZ);
818 		break;
819 	case MSC_EJECT_HUAWEI:
820 		err = bbb_command_start(sc, DIR_IN, 0, NULL, 0,
821 		    &scsi_huawei_eject, sizeof(scsi_huawei_eject),
822 		    USB_MS_HZ);
823 		break;
824 	case MSC_EJECT_TCT:
825 		/*
826 		 * TCTMobile needs DIR_IN flag. To get it, we
827 		 * supply a dummy data with the command.
828 		 */
829 		err = bbb_command_start(sc, DIR_IN, 0, &sc->buffer,
830 		    sizeof(sc->buffer), &scsi_tct_eject,
831 		    sizeof(scsi_tct_eject), USB_MS_HZ);
832 		break;
833 	default:
834 		printf("usb_msc_eject: unknown eject method (%d)\n", method);
835 		break;
836 	}
837 	DPRINTF("Eject CD command status: %s\n", usbd_errstr(err));
838 
839 	bbb_detach(sc);
840 	return (0);
841 }
842