xref: /freebsd/sys/dev/usb/quirk/usb_quirk.h (revision ba3c1f5972d7b90feb6e6da47905ff2757e0fe57)
1 /* $FreeBSD$ */
2 /*-
3  * SPDX-License-Identifier: BSD-2-Clause
4  *
5  * Copyright (c) 2008 Hans Petter Selasky. All rights reserved.
6  *
7  * Redistribution and use in source and binary forms, with or without
8  * modification, are permitted provided that the following conditions
9  * are met:
10  * 1. Redistributions of source code must retain the above copyright
11  *    notice, this list of conditions and the following disclaimer.
12  * 2. Redistributions in binary form must reproduce the above copyright
13  *    notice, this list of conditions and the following disclaimer in the
14  *    documentation and/or other materials provided with the distribution.
15  *
16  * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
17  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
18  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
19  * ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
20  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
21  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
22  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
23  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
24  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
25  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
26  * SUCH DAMAGE.
27  */
28 
29 #ifndef _USB_QUIRK_H_
30 #define	_USB_QUIRK_H_
31 
32 enum {
33 	/*
34 	 * Keep in sync with usb_quirk_str in usb_quirk.c, and with
35 	 * share/man/man4/usb_quirk.4
36 	 */
37 	UQ_NONE,		/* not a valid quirk */
38 
39 	UQ_MATCH_VENDOR_ONLY,	/* match quirk on vendor only */
40 
41 	/* Various quirks */
42 
43 	UQ_AUDIO_SWAP_LR,	/* left and right sound channels are swapped */
44 	UQ_AU_INP_ASYNC,	/* input is async despite claim of adaptive */
45 	UQ_AU_NO_FRAC,		/* don't adjust for fractional samples */
46 	UQ_AU_NO_XU,		/* audio device has broken extension unit */
47 	UQ_BAD_ADC,		/* bad audio spec version number */
48 	UQ_BAD_AUDIO,		/* device claims audio class, but isn't */
49 	UQ_BROKEN_BIDIR,	/* printer has broken bidir mode */
50 	UQ_BUS_POWERED,		/* device is bus powered, despite claim */
51 	UQ_HID_IGNORE,		/* device should be ignored by hid class */
52 	UQ_KBD_IGNORE,		/* device should be ignored by kbd class */
53 	UQ_KBD_BOOTPROTO,	/* device should set the boot protocol */
54 	UQ_UMS_IGNORE,          /* device should be ignored by ums class */
55 	UQ_MS_BAD_CLASS,	/* doesn't identify properly */
56 	UQ_MS_LEADING_BYTE,	/* mouse sends an unknown leading byte */
57 	UQ_MS_REVZ,		/* mouse has Z-axis reversed */
58 	UQ_MS_VENDOR_BTN,	/* mouse has buttons in vendor usage page */
59 	UQ_NO_STRINGS,		/* string descriptors are broken */
60 	UQ_POWER_CLAIM,		/* hub lies about power status */
61 	UQ_SPUR_BUT_UP,		/* spurious mouse button up events */
62 	UQ_SWAP_UNICODE,	/* has some Unicode strings swapped */
63 	UQ_CFG_INDEX_1,		/* select configuration index 1 by default */
64 	UQ_CFG_INDEX_2,		/* select configuration index 2 by default */
65 	UQ_CFG_INDEX_3,		/* select configuration index 3 by default */
66 	UQ_CFG_INDEX_4,		/* select configuration index 4 by default */
67 	UQ_CFG_INDEX_0,		/* select configuration index 0 by default */
68 	UQ_ASSUME_CM_OVER_DATA,	/* assume cm over data feature */
69 	UQ_IGNORE_CDC_CM,	/* ignore cm descriptor */
70 
71 	/*
72 	 * USB Mass Storage Quirks. See "storage/umass.c" for a
73 	 * detailed description.
74 	 */
75 	UQ_MSC_NO_TEST_UNIT_READY,	/* send start/stop instead of TUR */
76 	UQ_MSC_NO_RS_CLEAR_UA,		/* does not reset Unit Att. */
77 	UQ_MSC_NO_START_STOP,		/* does not support start/stop */
78 	UQ_MSC_NO_GETMAXLUN,		/* does not support get max LUN */
79 	UQ_MSC_NO_INQUIRY,		/* fake generic inq response */
80 	UQ_MSC_NO_INQUIRY_EVPD,		/* does not support inq EVPD */
81 	UQ_MSC_NO_PREVENT_ALLOW,	/* does not support medium removal */
82 	UQ_MSC_NO_SYNC_CACHE,		/* does not support sync cache */
83 	UQ_MSC_SHUTTLE_INIT,		/* requires Shuttle init sequence */
84 	UQ_MSC_ALT_IFACE_1,		/* switch to alternate interface 1 */
85 	UQ_MSC_FLOPPY_SPEED,		/* does floppy speeds (20kb/s) */
86 	UQ_MSC_IGNORE_RESIDUE,		/* gets residue wrong */
87 	UQ_MSC_WRONG_CSWSIG,		/* uses wrong CSW signature */
88 	UQ_MSC_RBC_PAD_TO_12,		/* pad RBC requests to 12 bytes */
89 	UQ_MSC_READ_CAP_OFFBY1,		/* reports sector count, not max sec. */
90 	UQ_MSC_FORCE_SHORT_INQ,		/* does not support full inq. */
91 	UQ_MSC_FORCE_WIRE_BBB,		/* force BBB wire protocol */
92 	UQ_MSC_FORCE_WIRE_CBI,		/* force CBI wire protocol */
93 	UQ_MSC_FORCE_WIRE_CBI_I,	/* force CBI with int. wire protocol */
94 	UQ_MSC_FORCE_PROTO_SCSI,	/* force SCSI command protocol */
95 	UQ_MSC_FORCE_PROTO_ATAPI,	/* force ATAPI command protocol */
96 	UQ_MSC_FORCE_PROTO_UFI,		/* force UFI command protocol */
97 	UQ_MSC_FORCE_PROTO_RBC,		/* force RBC command protocol */
98 	UQ_MSC_IGNORE,			/* device should be ignored by umass */
99 
100 	/* Ejection of mass storage (driver disk) */
101 	UQ_MSC_EJECT_HUAWEI,		/* ejects after Huawei USB command */
102 	UQ_MSC_EJECT_SIERRA,		/* ejects after Sierra USB command */
103 	UQ_MSC_EJECT_SCSIEJECT,		/* ejects after SCSI eject command */
104 	UQ_MSC_EJECT_REZERO,		/* ejects after SCSI rezero command */
105 	UQ_MSC_EJECT_ZTESTOR,		/* ejects after ZTE SCSI command */
106 	UQ_MSC_EJECT_CMOTECH,		/* ejects after C-motech SCSI cmd */
107 	UQ_MSC_EJECT_WAIT,		/* wait for the device to eject */
108 	UQ_MSC_EJECT_SAEL_M460,		/* ejects after Sael USB commands */
109 	UQ_MSC_EJECT_HUAWEISCSI,	/* ejects after Huawei SCSI command */
110 	UQ_MSC_EJECT_HUAWEISCSI2,	/* ejects after Huawei SCSI 2 command */
111 	UQ_MSC_EJECT_HUAWEISCSI3,	/* ejects after Huawei SCSI 3 command */
112 	UQ_MSC_EJECT_HUAWEISCSI4,	/* ejects after Huawei SCSI 4 command */
113 	UQ_MSC_EJECT_TCT,		/* ejects after TCT SCSI command */
114 
115 	UQ_BAD_MIDI,		/* device claims MIDI class, but isn't */
116 	UQ_AU_VENDOR_CLASS,	/* audio device uses vendor and not audio class */
117 	UQ_SINGLE_CMD_MIDI,	/* at most one command per USB packet */
118 	UQ_MSC_DYMO_EJECT,	/* ejects Dymo MSC device */
119 	UQ_AU_SET_SPDIF_CM6206,	/* enable S/PDIF audio output */
120 	UQ_WMT_IGNORE,          /* device should be ignored by wmt driver */
121 
122 	USB_QUIRK_MAX
123 };
124 
125 uint8_t	usb_test_quirk(const struct usb_attach_arg *uaa, uint16_t quirk);
126 
127 #endif					/* _USB_QUIRK_H_ */
128