Sync usage with man page.
[netbsd-mini2440.git] / sys / dev / usb / umass_quirks.c
blob5881d7b0fd3c91dd27e43816d21fd60df7156292
1 /* $NetBSD: umass_quirks.c,v 1.77 2009/10/12 23:43:05 wiz Exp $ */
3 /*
4 * Copyright (c) 2001, 2004 The NetBSD Foundation, Inc.
5 * All rights reserved.
7 * This code is derived from software contributed to The NetBSD Foundation
8 * by MAEKAWA Masahide (gehenna@NetBSD.org).
9 * This code is derived from software contributed to The NetBSD Foundation
10 * by Charles M. Hannum.
12 * Redistribution and use in source and binary forms, with or without
13 * modification, are permitted provided that the following conditions
14 * are met:
15 * 1. Redistributions of source code must retain the above copyright
16 * notice, this list of conditions and the following disclaimer.
17 * 2. Redistributions in binary form must reproduce the above copyright
18 * notice, this list of conditions and the following disclaimer in the
19 * documentation and/or other materials provided with the distribution.
21 * THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
22 * ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
23 * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
24 * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
25 * BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
26 * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
27 * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
28 * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
29 * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
30 * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
31 * POSSIBILITY OF SUCH DAMAGE.
34 #include <sys/cdefs.h>
35 __KERNEL_RCSID(0, "$NetBSD: umass_quirks.c,v 1.77 2009/10/12 23:43:05 wiz Exp $");
37 #include <sys/param.h>
38 #include <sys/systm.h>
39 #include <sys/device.h>
40 #include <sys/buf.h>
42 #include <dev/scsipi/scsipi_all.h> /* for scsiconf.h below */
43 #include <dev/scsipi/scsiconf.h> /* for quirks defines */
45 #include <dev/usb/usb.h>
46 #include <dev/usb/usbdi.h>
47 #include <dev/usb/usbdevs.h>
49 #include <dev/usb/umassvar.h>
50 #include <dev/usb/umass_quirks.h>
52 Static usbd_status umass_init_insystem(struct umass_softc *);
53 Static usbd_status umass_init_shuttle(struct umass_softc *);
55 Static void umass_fixup_sony(struct umass_softc *);
58 * XXX
59 * PLEASE NOTE that if you want quirk entries added to this table, you MUST
60 * compile a kernel with USB_DEBUG, and submit a full log of the output from
61 * whatever operation is "failing" with ?hcidebug=20 or higher and
62 * umassdebug=0xffffff. (It's usually helpful to also set MSGBUFSIZE to
63 * something "large" unless you're using a serial console.) Without this
64 * information, the source of the problem cannot be properly analyzed, and
65 * the quirk entry WILL NOT be accepted.
66 * Also, when an entry is committed to this table, a concise but clear
67 * description of the problem MUST accompany it.
68 * - mycroft
70 Static const struct umass_quirk umass_quirks[] = {
72 * The following 3 In-System Design adapters use a non-standard ATA
73 * over BBB protocol. Force this protocol by quirk entries.
75 { { USB_VENDOR_INSYSTEM, USB_PRODUCT_INSYSTEM_ADAPTERV2 },
76 UMASS_WPROTO_BBB, UMASS_CPROTO_ISD_ATA,
79 UMATCH_VENDOR_PRODUCT,
80 NULL, NULL
82 { { USB_VENDOR_INSYSTEM, USB_PRODUCT_INSYSTEM_ATAPI },
83 UMASS_WPROTO_BBB, UMASS_CPROTO_ISD_ATA,
86 UMATCH_VENDOR_PRODUCT,
87 NULL, NULL
89 { { USB_VENDOR_INSYSTEM, USB_PRODUCT_INSYSTEM_DRIVEV2_5 },
90 UMASS_WPROTO_BBB, UMASS_CPROTO_ISD_ATA,
93 UMATCH_VENDOR_PRODUCT,
94 NULL, NULL
97 { { USB_VENDOR_INSYSTEM, USB_PRODUCT_INSYSTEM_USBCABLE },
98 UMASS_WPROTO_CBI, UMASS_CPROTO_ATAPI,
101 UMATCH_VENDOR_PRODUCT,
102 umass_init_insystem, NULL
105 { { USB_VENDOR_SHUTTLE, USB_PRODUCT_SHUTTLE_EUSB },
106 UMASS_WPROTO_CBI_I, UMASS_CPROTO_ATAPI,
109 UMATCH_VENDOR_PRODUCT,
110 umass_init_shuttle, NULL
114 * These work around genuine device bugs -- returning the wrong info in
115 * the CSW block.
117 { { USB_VENDOR_OLYMPUS, USB_PRODUCT_OLYMPUS_C1 },
118 UMASS_WPROTO_UNSPEC, UMASS_CPROTO_UNSPEC,
119 UMASS_QUIRK_WRONG_CSWSIG,
121 UMATCH_DEVCLASS_DEVSUBCLASS_DEVPROTO,
122 NULL, NULL
124 { { USB_VENDOR_SCANLOGIC, USB_PRODUCT_SCANLOGIC_SL11R },
125 UMASS_WPROTO_UNSPEC, UMASS_CPROTO_UNSPEC,
126 UMASS_QUIRK_WRONG_CSWTAG,
128 UMATCH_DEVCLASS_DEVSUBCLASS_DEVPROTO,
129 NULL, NULL
131 { { USB_VENDOR_SHUTTLE, USB_PRODUCT_SHUTTLE_ORCA },
132 UMASS_WPROTO_UNSPEC, UMASS_CPROTO_UNSPEC,
133 UMASS_QUIRK_WRONG_CSWTAG,
135 UMATCH_DEVCLASS_DEVSUBCLASS_DEVPROTO,
136 NULL, NULL
140 * Some Sony cameras advertise a subclass code of 0xff, so we force it
141 * to the correct value iff necessary.
143 { { USB_VENDOR_SONY, USB_PRODUCT_SONY_DSC },
144 UMASS_WPROTO_UNSPEC, UMASS_CPROTO_UNSPEC,
145 UMASS_QUIRK_RBC_PAD_TO_12,
147 UMATCH_DEVCLASS_DEVSUBCLASS_DEVPROTO,
148 NULL, umass_fixup_sony
152 * Stupid device reports itself as SFF-8070, but actually returns a UFI
153 * interrupt descriptor. - mycroft, 2004/06/28
155 { { USB_VENDOR_SONY, USB_PRODUCT_SONY_CLIE_40_MS },
156 UMASS_WPROTO_UNSPEC, UMASS_CPROTO_UFI,
159 UMATCH_DEVCLASS_DEVSUBCLASS_DEVPROTO,
160 NULL, NULL
164 * The SONY Portable GPS strage device almost hangs up when request
165 * UR_BBB_GET_MAX_LUN - disable the query logic.
167 { { USB_VENDOR_SONY, USB_PRODUCT_SONY_GPS_CS1 },
168 UMASS_WPROTO_BBB, UMASS_CPROTO_UNSPEC,
169 UMASS_QUIRK_NOGETMAXLUN,
171 UMATCH_DEVCLASS_DEVSUBCLASS_DEVPROTO,
172 NULL, NULL
176 * The DiskOnKey does not reject commands it doesn't recognize in a
177 * sane way -- rather than STALLing the bulk pipe, it continually NAKs
178 * until we time out. To prevent being screwed by this, for now we
179 * disable 10-byte MODE SENSE the klugy way. - mycroft, 2003/10/16
181 { { USB_VENDOR_MSYSTEMS, USB_PRODUCT_MSYSTEMS_DISKONKEY },
182 UMASS_WPROTO_UNSPEC, UMASS_CPROTO_UNSPEC,
184 PQUIRK_NOBIGMODESENSE,
185 UMATCH_DEVCLASS_DEVSUBCLASS_DEVPROTO,
186 NULL, NULL
188 { { USB_VENDOR_MSYSTEMS, USB_PRODUCT_MSYSTEMS_DISKONKEY2 },
189 UMASS_WPROTO_UNSPEC, UMASS_CPROTO_UNSPEC,
191 PQUIRK_NOBIGMODESENSE,
192 UMATCH_DEVCLASS_DEVSUBCLASS_DEVPROTO,
193 NULL, NULL
195 { { USB_VENDOR_MSYSTEMS, USB_PRODUCT_MSYSTEMS_DISKONKEY3 },
196 UMASS_WPROTO_UNSPEC, UMASS_CPROTO_UNSPEC,
198 PQUIRK_NOBIGMODESENSE,
199 UMATCH_DEVCLASS_DEVSUBCLASS_DEVPROTO,
200 NULL, NULL
202 /* IBEAD devices don't like all SCSI commands */
203 { { USB_VENDOR_SIGMATEL, USB_PRODUCT_SIGMATEL_MUSICSTICK },
204 UMASS_WPROTO_UNSPEC, UMASS_CPROTO_UNSPEC,
206 PQUIRK_NODOORLOCK | PQUIRK_NOSYNCCACHE,
207 UMATCH_VENDOR_PRODUCT,
208 NULL, NULL
210 { { USB_VENDOR_SIGMATEL, USB_PRODUCT_SIGMATEL_I_BEAD100 },
211 UMASS_WPROTO_UNSPEC, UMASS_CPROTO_UNSPEC,
213 PQUIRK_NODOORLOCK | PQUIRK_NOSYNCCACHE,
214 UMATCH_VENDOR_PRODUCT,
215 NULL, NULL
217 { { USB_VENDOR_SIGMATEL, USB_PRODUCT_SIGMATEL_I_BEAD150 },
218 UMASS_WPROTO_UNSPEC, UMASS_CPROTO_UNSPEC,
220 PQUIRK_NODOORLOCK | PQUIRK_NOSYNCCACHE,
221 UMATCH_VENDOR_PRODUCT,
222 NULL, NULL
224 /* Meizu M6 doesn't like synchronize-cache, see PR 40442 */
225 { { USB_VENDOR_MEIZU, USB_PRODUCT_MEIZU_M6_SL },
226 UMASS_WPROTO_UNSPEC, UMASS_CPROTO_UNSPEC,
228 PQUIRK_NOSYNCCACHE,
229 UMATCH_VENDOR_PRODUCT,
230 NULL, NULL
234 * Devices with bad residue.
236 { { USB_VENDOR_SUPERTOP, USB_PRODUCT_SUPERTOP_IDEBRIDGE },
237 UMASS_WPROTO_UNSPEC, UMASS_CPROTO_UNSPEC,
238 UMASS_QUIRK_IGNORE_RESIDUE,
240 UMATCH_VENDOR_PRODUCT,
241 NULL, NULL
245 const struct umass_quirk *
246 umass_lookup(u_int16_t vendor, u_int16_t product)
248 return ((const struct umass_quirk *)
249 usb_lookup(umass_quirks, vendor, product));
252 Static usbd_status
253 umass_init_insystem(struct umass_softc *sc)
255 usbd_status err;
257 err = usbd_set_interface(sc->sc_iface, 1);
258 if (err) {
259 DPRINTF(UDMASS_USB,
260 ("%s: could not switch to Alt Interface 1\n",
261 USBDEVNAME(sc->sc_dev)));
262 return (err);
265 return (USBD_NORMAL_COMPLETION);
268 Static usbd_status
269 umass_init_shuttle(struct umass_softc *sc)
271 usb_device_request_t req;
272 u_int8_t status[2];
274 /* The Linux driver does this */
275 req.bmRequestType = UT_READ_VENDOR_DEVICE;
276 req.bRequest = 1;
277 USETW(req.wValue, 0);
278 USETW(req.wIndex, sc->sc_ifaceno);
279 USETW(req.wLength, sizeof(status));
281 return (usbd_do_request(sc->sc_udev, &req, &status));
284 Static void
285 umass_fixup_sony(struct umass_softc *sc)
287 usb_interface_descriptor_t *id;
289 id = usbd_get_interface_descriptor(sc->sc_iface);
290 if (id->bInterfaceSubClass == 0xff)
291 sc->sc_cmd = UMASS_CPROTO_RBC;