xref: /linux-6.15/include/linux/usb_usual.h (revision a1e58bbd)
1 /*
2  * Interface to the libusual.
3  *
4  * Copyright (c) 2005 Pete Zaitcev <[email protected]>
5  * Copyright (c) 1999-2002 Matthew Dharm ([email protected])
6  * Copyright (c) 1999 Michael Gee ([email protected])
7  */
8 
9 #ifndef __LINUX_USB_USUAL_H
10 #define __LINUX_USB_USUAL_H
11 
12 
13 /* We should do this for cleanliness... But other usb_foo.h do not do this. */
14 /* #include <linux/usb.h> */
15 
16 /*
17  * The flags field, which we store in usb_device_id.driver_info.
18  * It is compatible with the old usb-storage flags in lower 24 bits.
19  */
20 
21 /*
22  * Static flag definitions.  We use this roundabout technique so that the
23  * proc_info() routine can automatically display a message for each flag.
24  */
25 #define US_DO_ALL_FLAGS						\
26 	US_FLAG(SINGLE_LUN,	0x00000001)			\
27 		/* allow access to only LUN 0 */		\
28 	US_FLAG(NEED_OVERRIDE,	0x00000002)			\
29 		/* unusual_devs entry is necessary */		\
30 	US_FLAG(SCM_MULT_TARG,	0x00000004)			\
31 		/* supports multiple targets */			\
32 	US_FLAG(FIX_INQUIRY,	0x00000008)			\
33 		/* INQUIRY response needs faking */		\
34 	US_FLAG(FIX_CAPACITY,	0x00000010)			\
35 		/* READ CAPACITY response too big */		\
36 	US_FLAG(IGNORE_RESIDUE,	0x00000020)			\
37 		/* reported residue is wrong */			\
38 	US_FLAG(BULK32,		0x00000040)			\
39 		/* Uses 32-byte CBW length */			\
40 	US_FLAG(NOT_LOCKABLE,	0x00000080)			\
41 		/* PREVENT/ALLOW not supported */		\
42 	US_FLAG(GO_SLOW,	0x00000100)			\
43 		/* Need delay after Command phase */		\
44 	US_FLAG(NO_WP_DETECT,	0x00000200)			\
45 		/* Don't check for write-protect */		\
46 	US_FLAG(MAX_SECTORS_64,	0x00000400)			\
47 		/* Sets max_sectors to 64    */			\
48 	US_FLAG(IGNORE_DEVICE,	0x00000800)			\
49 		/* Don't claim device */			\
50 	US_FLAG(CAPACITY_HEURISTICS,	0x00001000)		\
51 		/* sometimes sizes is too big */		\
52 	US_FLAG(MAX_SECTORS_MIN,0x00002000)			\
53 		/* Sets max_sectors to arch min */		\
54 	US_FLAG(BULK_IGNORE_TAG,0x00004000)			\
55 		/* Ignore tag mismatch in bulk operations */
56 
57 
58 #define US_FLAG(name, value)	US_FL_##name = value ,
59 enum { US_DO_ALL_FLAGS };
60 #undef US_FLAG
61 
62 /*
63  * The bias field for libusual and friends.
64  */
65 #define USB_US_TYPE_NONE   0
66 #define USB_US_TYPE_STOR   1		/* usb-storage */
67 #define USB_US_TYPE_UB     2		/* ub */
68 
69 #define USB_US_TYPE(flags) 		(((flags) >> 24) & 0xFF)
70 #define USB_US_ORIG_FLAGS(flags)	((flags) & 0x00FFFFFF)
71 
72 /*
73  * This is probably not the best place to keep these constants, conceptually.
74  * But it's the only header included into all places which need them.
75  */
76 
77 /* Sub Classes */
78 
79 #define US_SC_RBC	0x01		/* Typically, flash devices */
80 #define US_SC_8020	0x02		/* CD-ROM */
81 #define US_SC_QIC	0x03		/* QIC-157 Tapes */
82 #define US_SC_UFI	0x04		/* Floppy */
83 #define US_SC_8070	0x05		/* Removable media */
84 #define US_SC_SCSI	0x06		/* Transparent */
85 #define US_SC_LOCKABLE	0x07		/* Password-protected */
86 
87 #define US_SC_ISD200    0xf0		/* ISD200 ATA */
88 #define US_SC_DEVICE	0xff		/* Use device's value */
89 
90 /* Protocols */
91 
92 #define US_PR_CBI	0x00		/* Control/Bulk/Interrupt */
93 #define US_PR_CB	0x01		/* Control/Bulk w/o interrupt */
94 #define US_PR_BULK	0x50		/* bulk only */
95 #ifdef CONFIG_USB_STORAGE_USBAT
96 #define US_PR_USBAT	0x80		/* SCM-ATAPI bridge */
97 #endif
98 #ifdef CONFIG_USB_STORAGE_SDDR09
99 #define US_PR_EUSB_SDDR09	0x81	/* SCM-SCSI bridge for SDDR-09 */
100 #endif
101 #ifdef CONFIG_USB_STORAGE_SDDR55
102 #define US_PR_SDDR55	0x82		/* SDDR-55 (made up) */
103 #endif
104 #define US_PR_DPCM_USB  0xf0		/* Combination CB/SDDR09 */
105 #ifdef CONFIG_USB_STORAGE_FREECOM
106 #define US_PR_FREECOM   0xf1		/* Freecom */
107 #endif
108 #ifdef CONFIG_USB_STORAGE_DATAFAB
109 #define US_PR_DATAFAB   0xf2		/* Datafab chipsets */
110 #endif
111 #ifdef CONFIG_USB_STORAGE_JUMPSHOT
112 #define US_PR_JUMPSHOT  0xf3		/* Lexar Jumpshot */
113 #endif
114 #ifdef CONFIG_USB_STORAGE_ALAUDA
115 #define US_PR_ALAUDA    0xf4		/* Alauda chipsets */
116 #endif
117 #ifdef CONFIG_USB_STORAGE_KARMA
118 #define US_PR_KARMA     0xf5		/* Rio Karma */
119 #endif
120 
121 #define US_PR_DEVICE	0xff		/* Use device's value */
122 
123 /*
124  */
125 #ifdef CONFIG_USB_LIBUSUAL
126 
127 extern struct usb_device_id storage_usb_ids[];
128 extern void usb_usual_set_present(int type);
129 extern void usb_usual_clear_present(int type);
130 extern int usb_usual_check_type(const struct usb_device_id *, int type);
131 #else
132 
133 #define usb_usual_set_present(t)	do { } while(0)
134 #define usb_usual_clear_present(t)	do { } while(0)
135 #define usb_usual_check_type(id, t)	(0)
136 #endif /* CONFIG_USB_LIBUSUAL */
137 
138 #endif /* __LINUX_USB_USUAL_H */
139