xref: /openbmc/linux/include/net/bluetooth/rfcomm.h (revision 9e726b17)
1 /*
2    RFCOMM implementation for Linux Bluetooth stack (BlueZ).
3    Copyright (C) 2002 Maxim Krasnyansky <maxk@qualcomm.com>
4    Copyright (C) 2002 Marcel Holtmann <marcel@holtmann.org>
5 
6    This program is free software; you can redistribute it and/or modify
7    it under the terms of the GNU General Public License version 2 as
8    published by the Free Software Foundation;
9 
10    THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
11    OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
12    FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT OF THIRD PARTY RIGHTS.
13    IN NO EVENT SHALL THE COPYRIGHT HOLDER(S) AND AUTHOR(S) BE LIABLE FOR ANY
14    CLAIM, OR ANY SPECIAL INDIRECT OR CONSEQUENTIAL DAMAGES, OR ANY DAMAGES
15    WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
16    ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
17    OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
18 
19    ALL LIABILITY, INCLUDING LIABILITY FOR INFRINGEMENT OF ANY PATENTS,
20    COPYRIGHTS, TRADEMARKS OR OTHER RIGHTS, RELATING TO USE OF THIS
21    SOFTWARE IS DISCLAIMED.
22 */
23 
24 #ifndef __RFCOMM_H
25 #define __RFCOMM_H
26 
27 #define RFCOMM_PSM 3
28 
29 #define RFCOMM_CONN_TIMEOUT (HZ * 30)
30 #define RFCOMM_DISC_TIMEOUT (HZ * 20)
31 #define RFCOMM_AUTH_TIMEOUT (HZ * 25)
32 #define RFCOMM_IDLE_TIMEOUT (HZ * 2)
33 
34 #define RFCOMM_DEFAULT_MTU	127
35 #define RFCOMM_DEFAULT_CREDITS	7
36 
37 #define RFCOMM_MAX_L2CAP_MTU	1013
38 #define RFCOMM_MAX_CREDITS	40
39 
40 #define RFCOMM_SKB_HEAD_RESERVE	8
41 #define RFCOMM_SKB_TAIL_RESERVE	2
42 #define RFCOMM_SKB_RESERVE  (RFCOMM_SKB_HEAD_RESERVE + RFCOMM_SKB_TAIL_RESERVE)
43 
44 #define RFCOMM_SABM	0x2f
45 #define RFCOMM_DISC	0x43
46 #define RFCOMM_UA	0x63
47 #define RFCOMM_DM	0x0f
48 #define RFCOMM_UIH	0xef
49 
50 #define RFCOMM_TEST	0x08
51 #define RFCOMM_FCON	0x28
52 #define RFCOMM_FCOFF	0x18
53 #define RFCOMM_MSC	0x38
54 #define RFCOMM_RPN	0x24
55 #define RFCOMM_RLS	0x14
56 #define RFCOMM_PN	0x20
57 #define RFCOMM_NSC	0x04
58 
59 #define RFCOMM_V24_FC	0x02
60 #define RFCOMM_V24_RTC	0x04
61 #define RFCOMM_V24_RTR	0x08
62 #define RFCOMM_V24_IC	0x40
63 #define RFCOMM_V24_DV	0x80
64 
65 #define RFCOMM_RPN_BR_2400	0x0
66 #define RFCOMM_RPN_BR_4800	0x1
67 #define RFCOMM_RPN_BR_7200	0x2
68 #define RFCOMM_RPN_BR_9600	0x3
69 #define RFCOMM_RPN_BR_19200	0x4
70 #define RFCOMM_RPN_BR_38400	0x5
71 #define RFCOMM_RPN_BR_57600	0x6
72 #define RFCOMM_RPN_BR_115200	0x7
73 #define RFCOMM_RPN_BR_230400	0x8
74 
75 #define RFCOMM_RPN_DATA_5	0x0
76 #define RFCOMM_RPN_DATA_6	0x1
77 #define RFCOMM_RPN_DATA_7	0x2
78 #define RFCOMM_RPN_DATA_8	0x3
79 
80 #define RFCOMM_RPN_STOP_1	0
81 #define RFCOMM_RPN_STOP_15	1
82 
83 #define RFCOMM_RPN_PARITY_NONE	0x0
84 #define RFCOMM_RPN_PARITY_ODD	0x1
85 #define RFCOMM_RPN_PARITY_EVEN	0x3
86 #define RFCOMM_RPN_PARITY_MARK	0x5
87 #define RFCOMM_RPN_PARITY_SPACE	0x7
88 
89 #define RFCOMM_RPN_FLOW_NONE	0x00
90 
91 #define RFCOMM_RPN_XON_CHAR	0x11
92 #define RFCOMM_RPN_XOFF_CHAR	0x13
93 
94 #define RFCOMM_RPN_PM_BITRATE		0x0001
95 #define RFCOMM_RPN_PM_DATA		0x0002
96 #define RFCOMM_RPN_PM_STOP		0x0004
97 #define RFCOMM_RPN_PM_PARITY		0x0008
98 #define RFCOMM_RPN_PM_PARITY_TYPE	0x0010
99 #define RFCOMM_RPN_PM_XON		0x0020
100 #define RFCOMM_RPN_PM_XOFF		0x0040
101 #define RFCOMM_RPN_PM_FLOW		0x3F00
102 
103 #define RFCOMM_RPN_PM_ALL		0x3F7F
104 
105 struct rfcomm_hdr {
106 	u8 addr;
107 	u8 ctrl;
108 	u8 len;    // Actual size can be 2 bytes
109 } __attribute__ ((packed));
110 
111 struct rfcomm_cmd {
112 	u8 addr;
113 	u8 ctrl;
114 	u8 len;
115 	u8 fcs;
116 } __attribute__ ((packed));
117 
118 struct rfcomm_mcc {
119 	u8 type;
120 	u8 len;
121 } __attribute__ ((packed));
122 
123 struct rfcomm_pn {
124 	u8  dlci;
125 	u8  flow_ctrl;
126 	u8  priority;
127 	u8  ack_timer;
128 	__le16 mtu;
129 	u8  max_retrans;
130 	u8  credits;
131 } __attribute__ ((packed));
132 
133 struct rfcomm_rpn {
134 	u8  dlci;
135 	u8  bit_rate;
136 	u8  line_settings;
137 	u8  flow_ctrl;
138 	u8  xon_char;
139 	u8  xoff_char;
140 	__le16 param_mask;
141 } __attribute__ ((packed));
142 
143 struct rfcomm_rls {
144 	u8  dlci;
145 	u8  status;
146 } __attribute__ ((packed));
147 
148 struct rfcomm_msc {
149 	u8  dlci;
150 	u8  v24_sig;
151 } __attribute__ ((packed));
152 
153 /* ---- Core structures, flags etc ---- */
154 
155 struct rfcomm_session {
156 	struct list_head list;
157 	struct socket   *sock;
158 	struct timer_list timer;
159 	unsigned long    state;
160 	unsigned long    flags;
161 	atomic_t         refcnt;
162 	int              initiator;
163 
164 	/* Default DLC parameters */
165 	int    cfc;
166 	uint   mtu;
167 
168 	struct list_head dlcs;
169 };
170 
171 struct rfcomm_dlc {
172 	struct list_head      list;
173 	struct rfcomm_session *session;
174 	struct sk_buff_head   tx_queue;
175 	struct timer_list     timer;
176 
177 	spinlock_t    lock;
178 	unsigned long state;
179 	unsigned long flags;
180 	atomic_t      refcnt;
181 	u8            dlci;
182 	u8            addr;
183 	u8            priority;
184 	u8            v24_sig;
185 	u8            remote_v24_sig;
186 	u8            mscex;
187 	u8            out;
188 	u8            sec_level;
189 	u8            role_switch;
190 	u32           defer_setup;
191 
192 	uint          mtu;
193 	uint          cfc;
194 	uint          rx_credits;
195 	uint          tx_credits;
196 
197 	void          *owner;
198 
199 	void (*data_ready)(struct rfcomm_dlc *d, struct sk_buff *skb);
200 	void (*state_change)(struct rfcomm_dlc *d, int err);
201 	void (*modem_status)(struct rfcomm_dlc *d, u8 v24_sig);
202 };
203 
204 /* DLC and session flags */
205 #define RFCOMM_RX_THROTTLED 0
206 #define RFCOMM_TX_THROTTLED 1
207 #define RFCOMM_TIMED_OUT    2
208 #define RFCOMM_MSC_PENDING  3
209 #define RFCOMM_SEC_PENDING  4
210 #define RFCOMM_AUTH_PENDING 5
211 #define RFCOMM_AUTH_ACCEPT  6
212 #define RFCOMM_AUTH_REJECT  7
213 #define RFCOMM_DEFER_SETUP  8
214 
215 /* Scheduling flags and events */
216 #define RFCOMM_SCHED_STATE  0
217 #define RFCOMM_SCHED_RX     1
218 #define RFCOMM_SCHED_TX     2
219 #define RFCOMM_SCHED_TIMEO  3
220 #define RFCOMM_SCHED_AUTH   4
221 #define RFCOMM_SCHED_WAKEUP 31
222 
223 /* MSC exchange flags */
224 #define RFCOMM_MSCEX_TX     1
225 #define RFCOMM_MSCEX_RX     2
226 #define RFCOMM_MSCEX_OK     (RFCOMM_MSCEX_TX + RFCOMM_MSCEX_RX)
227 
228 /* CFC states */
229 #define RFCOMM_CFC_UNKNOWN  -1
230 #define RFCOMM_CFC_DISABLED 0
231 #define RFCOMM_CFC_ENABLED  RFCOMM_MAX_CREDITS
232 
233 /* ---- RFCOMM SEND RPN ---- */
234 int rfcomm_send_rpn(struct rfcomm_session *s, int cr, u8 dlci,
235 			u8 bit_rate, u8 data_bits, u8 stop_bits,
236 			u8 parity, u8 flow_ctrl_settings,
237 			u8 xon_char, u8 xoff_char, u16 param_mask);
238 
239 /* ---- RFCOMM DLCs (channels) ---- */
240 struct rfcomm_dlc *rfcomm_dlc_alloc(gfp_t prio);
241 void rfcomm_dlc_free(struct rfcomm_dlc *d);
242 int  rfcomm_dlc_open(struct rfcomm_dlc *d, bdaddr_t *src, bdaddr_t *dst, u8 channel);
243 int  rfcomm_dlc_close(struct rfcomm_dlc *d, int reason);
244 int  rfcomm_dlc_send(struct rfcomm_dlc *d, struct sk_buff *skb);
245 int  rfcomm_dlc_set_modem_status(struct rfcomm_dlc *d, u8 v24_sig);
246 int  rfcomm_dlc_get_modem_status(struct rfcomm_dlc *d, u8 *v24_sig);
247 void rfcomm_dlc_accept(struct rfcomm_dlc *d);
248 
249 #define rfcomm_dlc_lock(d)     spin_lock(&d->lock)
250 #define rfcomm_dlc_unlock(d)   spin_unlock(&d->lock)
251 
252 static inline void rfcomm_dlc_hold(struct rfcomm_dlc *d)
253 {
254 	atomic_inc(&d->refcnt);
255 }
256 
257 static inline void rfcomm_dlc_put(struct rfcomm_dlc *d)
258 {
259 	if (atomic_dec_and_test(&d->refcnt))
260 		rfcomm_dlc_free(d);
261 }
262 
263 extern void __rfcomm_dlc_throttle(struct rfcomm_dlc *d);
264 extern void __rfcomm_dlc_unthrottle(struct rfcomm_dlc *d);
265 
266 static inline void rfcomm_dlc_throttle(struct rfcomm_dlc *d)
267 {
268 	if (!test_and_set_bit(RFCOMM_RX_THROTTLED, &d->flags))
269 		__rfcomm_dlc_throttle(d);
270 }
271 
272 static inline void rfcomm_dlc_unthrottle(struct rfcomm_dlc *d)
273 {
274 	if (test_and_clear_bit(RFCOMM_RX_THROTTLED, &d->flags))
275 		__rfcomm_dlc_unthrottle(d);
276 }
277 
278 /* ---- RFCOMM sessions ---- */
279 void   rfcomm_session_getaddr(struct rfcomm_session *s, bdaddr_t *src, bdaddr_t *dst);
280 
281 static inline void rfcomm_session_hold(struct rfcomm_session *s)
282 {
283 	atomic_inc(&s->refcnt);
284 }
285 
286 /* ---- RFCOMM sockets ---- */
287 struct sockaddr_rc {
288 	sa_family_t	rc_family;
289 	bdaddr_t	rc_bdaddr;
290 	u8		rc_channel;
291 };
292 
293 #define RFCOMM_CONNINFO	0x02
294 struct rfcomm_conninfo {
295 	__u16 hci_handle;
296 	__u8  dev_class[3];
297 };
298 
299 #define RFCOMM_LM	0x03
300 #define RFCOMM_LM_MASTER	0x0001
301 #define RFCOMM_LM_AUTH		0x0002
302 #define RFCOMM_LM_ENCRYPT	0x0004
303 #define RFCOMM_LM_TRUSTED	0x0008
304 #define RFCOMM_LM_RELIABLE	0x0010
305 #define RFCOMM_LM_SECURE	0x0020
306 
307 #define rfcomm_pi(sk) ((struct rfcomm_pinfo *) sk)
308 
309 struct rfcomm_pinfo {
310 	struct bt_sock bt;
311 	struct rfcomm_dlc   *dlc;
312 	u8     channel;
313 	u8     sec_level;
314 	u8     role_switch;
315 };
316 
317 int  rfcomm_init_sockets(void);
318 void rfcomm_cleanup_sockets(void);
319 
320 int  rfcomm_connect_ind(struct rfcomm_session *s, u8 channel, struct rfcomm_dlc **d);
321 
322 /* ---- RFCOMM TTY ---- */
323 #define RFCOMM_MAX_DEV  256
324 
325 #define RFCOMMCREATEDEV		_IOW('R', 200, int)
326 #define RFCOMMRELEASEDEV	_IOW('R', 201, int)
327 #define RFCOMMGETDEVLIST	_IOR('R', 210, int)
328 #define RFCOMMGETDEVINFO	_IOR('R', 211, int)
329 #define RFCOMMSTEALDLC		_IOW('R', 220, int)
330 
331 #define RFCOMM_REUSE_DLC      0
332 #define RFCOMM_RELEASE_ONHUP  1
333 #define RFCOMM_HANGUP_NOW     2
334 #define RFCOMM_TTY_ATTACHED   3
335 #define RFCOMM_TTY_RELEASED   4
336 
337 struct rfcomm_dev_req {
338 	s16      dev_id;
339 	u32      flags;
340 	bdaddr_t src;
341 	bdaddr_t dst;
342 	u8       channel;
343 };
344 
345 struct rfcomm_dev_info {
346 	s16      id;
347 	u32      flags;
348 	u16      state;
349 	bdaddr_t src;
350 	bdaddr_t dst;
351 	u8       channel;
352 };
353 
354 struct rfcomm_dev_list_req {
355 	u16      dev_num;
356 	struct   rfcomm_dev_info dev_info[0];
357 };
358 
359 int  rfcomm_dev_ioctl(struct sock *sk, unsigned int cmd, void __user *arg);
360 
361 #ifdef CONFIG_BT_RFCOMM_TTY
362 int  rfcomm_init_ttys(void);
363 void rfcomm_cleanup_ttys(void);
364 #else
365 static inline int rfcomm_init_ttys(void)
366 {
367 	return 0;
368 }
369 static inline void rfcomm_cleanup_ttys(void)
370 {
371 }
372 #endif
373 #endif /* __RFCOMM_H */
374