1 /*        $NetBSD: usb_quirks.h,v 1.30 2021/10/01 21:09:50 macallan Exp $       */
2 /*        $FreeBSD: src/sys/dev/usb/usb_quirks.h,v 1.9 1999/11/12 23:31:03 n_hibma Exp $  */
3 
4 /*
5  * Copyright (c) 1998 The NetBSD Foundation, Inc.
6  * All rights reserved.
7  *
8  * This code is derived from software contributed to The NetBSD Foundation
9  * by Lennart Augustsson (lennart@augustsson.net) at
10  * Carlstedt Research & Technology.
11  *
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.
20  *
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.
32  */
33 
34 struct usbd_quirks {
35           uint32_t uq_flags;  /* Device problems: */
36 #define UQ_NO_SET_PROTO       0x0001    /* cannot handle SET PROTOCOL. */
37 #define UQ_SWAP_UNICODE       0x0002    /* has some Unicode strings swapped. */
38 #define UQ_MS_REVZ  0x0004    /* mouse has Z-axis reversed */
39 #define UQ_NO_STRINGS         0x0008    /* string descriptors are broken. */
40 #define UQ_BAD_ADC  0x0010    /* bad audio spec version number. */
41 #define UQ_BAD_AUDIO          0x0040    /* device claims audio class, but isn't */
42 #define UQ_SPUR_BUT_UP        0x0080    /* spurious mouse button up events */
43 #define UQ_AU_NO_XU 0x0100    /* audio device has broken extension unit */
44 #define UQ_AU_NO_FRAC         0x0400    /* don't adjust for fractional samples */
45 #define UQ_AU_INP_ASYNC       0x0800    /* input is async despite claim of adaptive */
46 #define UQ_ASSUME_CM_OVER_DATA 0x1000 /* modem device breaks on cm over data */
47 #define UQ_BROKEN_BIDIR       0x2000    /* printer has broken bidir mode */
48 #define UQ_HID_IGNORE         0x4000    /* device should be ignored by hid class */
49 #define UQ_NO_UNION_NRM 0x8000  /* has no normal UNION descriptor */
50 #define UQ_LOST_CS_DESC 0x10000 /* look everywhere for the CS descriptors */
51 #define UQ_APPLE_ISO          0x20000   /* force ISO layout on Apple keyboards */
52 #define UQ_DESC_CORRUPT       0x40000   /* may corrupt its config descriptors */
53 #define UQ_MISS_OUT_ACK       0x80000   /* may fail to ack output */
54 #define UQ_ALWAYS_ON   0x100000         /* for mice that keep disconnecting */
55           const usb_descriptor_t **desc;          /* Replacement for UQ_DESC_CORRUPT */
56 };
57 
58 extern const struct usbd_quirks usbd_no_quirk;
59 
60 usbd_status usbd_get_desc_fake(struct usbd_device *, int, int, int, void *);
61 const struct usbd_quirks *usbd_find_quirk(usb_device_descriptor_t *);
62