xref: /linux/include/linux/usb/irda.h (revision 8dd06ef34b6e2f41b29fbf5fc1663780f2524285)
1 /* SPDX-License-Identifier: GPL-2.0 */
2 /*
3  * USB IrDA Bridge Device Definition
4  */
5 
6 #ifndef __LINUX_USB_IRDA_H
7 #define __LINUX_USB_IRDA_H
8 
9 /* This device should use Application-specific class */
10 
11 #define USB_SUBCLASS_IRDA			0x02
12 
13 /*-------------------------------------------------------------------------*/
14 
15 /* Class-Specific requests (bRequest field) */
16 
17 #define USB_REQ_CS_IRDA_RECEIVING		1
18 #define USB_REQ_CS_IRDA_CHECK_MEDIA_BUSY	3
19 #define USB_REQ_CS_IRDA_RATE_SNIFF		4
20 #define USB_REQ_CS_IRDA_UNICAST_LIST		5
21 #define USB_REQ_CS_IRDA_GET_CLASS_DESC		6
22 
23 /*-------------------------------------------------------------------------*/
24 
25 /* Class-Specific descriptor */
26 
27 #define USB_DT_CS_IRDA				0x21
28 
29 /*-------------------------------------------------------------------------*/
30 
31 /* Data sizes */
32 
33 #define USB_IRDA_DS_2048			(1 << 5)
34 #define USB_IRDA_DS_1024			(1 << 4)
35 #define USB_IRDA_DS_512				(1 << 3)
36 #define USB_IRDA_DS_256				(1 << 2)
37 #define USB_IRDA_DS_128				(1 << 1)
38 #define USB_IRDA_DS_64				(1 << 0)
39 
40 /* Window sizes */
41 
42 #define USB_IRDA_WS_7				(1 << 6)
43 #define USB_IRDA_WS_6				(1 << 5)
44 #define USB_IRDA_WS_5				(1 << 4)
45 #define USB_IRDA_WS_4				(1 << 3)
46 #define USB_IRDA_WS_3				(1 << 2)
47 #define USB_IRDA_WS_2				(1 << 1)
48 #define USB_IRDA_WS_1				(1 << 0)
49 
50 /* Min turnaround times in usecs */
51 
52 #define USB_IRDA_MTT_0				(1 << 7)
53 #define USB_IRDA_MTT_10				(1 << 6)
54 #define USB_IRDA_MTT_50				(1 << 5)
55 #define USB_IRDA_MTT_100			(1 << 4)
56 #define USB_IRDA_MTT_500			(1 << 3)
57 #define USB_IRDA_MTT_1000			(1 << 2)
58 #define USB_IRDA_MTT_5000			(1 << 1)
59 #define USB_IRDA_MTT_10000			(1 << 0)
60 
61 /* Baud rates */
62 
63 #define USB_IRDA_BR_4000000			(1 << 8)
64 #define USB_IRDA_BR_1152000			(1 << 7)
65 #define USB_IRDA_BR_576000			(1 << 6)
66 #define USB_IRDA_BR_115200			(1 << 5)
67 #define USB_IRDA_BR_57600			(1 << 4)
68 #define USB_IRDA_BR_38400			(1 << 3)
69 #define USB_IRDA_BR_19200			(1 << 2)
70 #define USB_IRDA_BR_9600			(1 << 1)
71 #define USB_IRDA_BR_2400			(1 << 0)
72 
73 /* Additional BOFs */
74 
75 #define USB_IRDA_AB_0				(1 << 7)
76 #define USB_IRDA_AB_1				(1 << 6)
77 #define USB_IRDA_AB_2				(1 << 5)
78 #define USB_IRDA_AB_3				(1 << 4)
79 #define USB_IRDA_AB_6				(1 << 3)
80 #define USB_IRDA_AB_12				(1 << 2)
81 #define USB_IRDA_AB_24				(1 << 1)
82 #define USB_IRDA_AB_48				(1 << 0)
83 
84 /* IRDA Rate Sniff */
85 
86 #define USB_IRDA_RATE_SNIFF			1
87 
88 /*-------------------------------------------------------------------------*/
89 
90 struct usb_irda_cs_descriptor {
91 	__u8	bLength;
92 	__u8	bDescriptorType;
93 
94 	__le16	bcdSpecRevision;
95 	__u8	bmDataSize;
96 	__u8	bmWindowSize;
97 	__u8	bmMinTurnaroundTime;
98 	__le16	wBaudRate;
99 	__u8	bmAdditionalBOFs;
100 	__u8	bIrdaRateSniff;
101 	__u8	bMaxUnicastList;
102 } __attribute__ ((packed));
103 
104 /*-------------------------------------------------------------------------*/
105 
106 /* Data Format */
107 
108 #define USB_IRDA_STATUS_MEDIA_BUSY	(1 << 7)
109 
110 /* The following is a 4-bit value used for both
111  * inbound and outbound headers:
112  *
113  * 0 - speed ignored
114  * 1 - 2400 bps
115  * 2 - 9600 bps
116  * 3 - 19200 bps
117  * 4 - 38400 bps
118  * 5 - 57600 bps
119  * 6 - 115200 bps
120  * 7 - 576000 bps
121  * 8 - 1.152 Mbps
122  * 9 - 4 Mbps
123  * 10..15 - Reserved
124  */
125 #define USB_IRDA_STATUS_LINK_SPEED	0x0f
126 
127 #define USB_IRDA_LS_NO_CHANGE		0
128 #define USB_IRDA_LS_2400		1
129 #define USB_IRDA_LS_9600		2
130 #define USB_IRDA_LS_19200		3
131 #define USB_IRDA_LS_38400		4
132 #define USB_IRDA_LS_57600		5
133 #define USB_IRDA_LS_115200		6
134 #define USB_IRDA_LS_576000		7
135 #define USB_IRDA_LS_1152000		8
136 #define USB_IRDA_LS_4000000		9
137 
138 /* The following is a 4-bit value used only for
139  * outbound header:
140  *
141  * 0 - No change (BOF ignored)
142  * 1 - 48 BOFs
143  * 2 - 24 BOFs
144  * 3 - 12 BOFs
145  * 4 - 6 BOFs
146  * 5 - 3 BOFs
147  * 6 - 2 BOFs
148  * 7 - 1 BOFs
149  * 8 - 0 BOFs
150  * 9..15 - Reserved
151  */
152 #define USB_IRDA_EXTRA_BOFS		0xf0
153 
154 struct usb_irda_inbound_header {
155 	__u8		bmStatus;
156 };
157 
158 struct usb_irda_outbound_header {
159 	__u8		bmChange;
160 };
161 
162 #endif /* __LINUX_USB_IRDA_H */
163 
164