l2cap.h 12.1 KB
Newer Older
1
/*
L
Linus Torvalds 已提交
2 3
   BlueZ - Bluetooth protocol stack for Linux
   Copyright (C) 2000-2001 Qualcomm Incorporated
4
   Copyright (C) 2009-2010 Gustavo F. Padovan <gustavo@padovan.org>
5
   Copyright (C) 2010 Google Inc.
L
Linus Torvalds 已提交
6 7 8 9 10 11 12 13 14 15 16

   Written 2000,2001 by Maxim Krasnyansky <maxk@qualcomm.com>

   This program is free software; you can redistribute it and/or modify
   it under the terms of the GNU General Public License version 2 as
   published by the Free Software Foundation;

   THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
   OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
   FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT OF THIRD PARTY RIGHTS.
   IN NO EVENT SHALL THE COPYRIGHT HOLDER(S) AND AUTHOR(S) BE LIABLE FOR ANY
17 18 19
   CLAIM, OR ANY SPECIAL INDIRECT OR CONSEQUENTIAL DAMAGES, OR ANY DAMAGES
   WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
   ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
L
Linus Torvalds 已提交
20 21
   OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.

22 23
   ALL LIABILITY, INCLUDING LIABILITY FOR INFRINGEMENT OF ANY PATENTS,
   COPYRIGHTS, TRADEMARKS OR OTHER RIGHTS, RELATING TO USE OF THIS
L
Linus Torvalds 已提交
24 25 26 27 28 29 30
   SOFTWARE IS DISCLAIMED.
*/

#ifndef __L2CAP_H
#define __L2CAP_H

/* L2CAP defaults */
31
#define L2CAP_DEFAULT_MTU		672
32
#define L2CAP_DEFAULT_MIN_MTU		48
33
#define L2CAP_DEFAULT_FLUSH_TO		0xffff
34
#define L2CAP_DEFAULT_TX_WINDOW		63
35
#define L2CAP_DEFAULT_MAX_TX		3
36
#define L2CAP_DEFAULT_RETRANS_TO	2000    /* 2 seconds */
37
#define L2CAP_DEFAULT_MONITOR_TO	12000   /* 12 seconds */
38
#define L2CAP_DEFAULT_MAX_PDU_SIZE	1009    /* Sized for 3-DH5 packet */
39
#define L2CAP_DEFAULT_ACK_TO		200
40
#define L2CAP_LE_DEFAULT_MTU		23
L
Linus Torvalds 已提交
41

42 43
#define L2CAP_CONN_TIMEOUT	(40000) /* 40 seconds */
#define L2CAP_INFO_TIMEOUT	(4000)  /*  4 seconds */
L
Linus Torvalds 已提交
44 45 46 47

/* L2CAP socket address */
struct sockaddr_l2 {
	sa_family_t	l2_family;
48
	__le16		l2_psm;
L
Linus Torvalds 已提交
49
	bdaddr_t	l2_bdaddr;
50
	__le16		l2_cid;
L
Linus Torvalds 已提交
51 52 53 54 55 56 57 58 59
};

/* L2CAP socket options */
#define L2CAP_OPTIONS	0x01
struct l2cap_options {
	__u16 omtu;
	__u16 imtu;
	__u16 flush_to;
	__u8  mode;
60
	__u8  fcs;
61
	__u8  max_tx;
62
	__u16 txwin_size;
L
Linus Torvalds 已提交
63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79
};

#define L2CAP_CONNINFO	0x02
struct l2cap_conninfo {
	__u16 hci_handle;
	__u8  dev_class[3];
};

#define L2CAP_LM	0x03
#define L2CAP_LM_MASTER		0x0001
#define L2CAP_LM_AUTH		0x0002
#define L2CAP_LM_ENCRYPT	0x0004
#define L2CAP_LM_TRUSTED	0x0008
#define L2CAP_LM_RELIABLE	0x0010
#define L2CAP_LM_SECURE		0x0020

/* L2CAP command codes */
80 81 82 83 84 85 86 87 88 89 90
#define L2CAP_COMMAND_REJ	0x01
#define L2CAP_CONN_REQ		0x02
#define L2CAP_CONN_RSP		0x03
#define L2CAP_CONF_REQ		0x04
#define L2CAP_CONF_RSP		0x05
#define L2CAP_DISCONN_REQ	0x06
#define L2CAP_DISCONN_RSP	0x07
#define L2CAP_ECHO_REQ		0x08
#define L2CAP_ECHO_RSP		0x09
#define L2CAP_INFO_REQ		0x0a
#define L2CAP_INFO_RSP		0x0b
91 92
#define L2CAP_CONN_PARAM_UPDATE_REQ	0x12
#define L2CAP_CONN_PARAM_UPDATE_RSP	0x13
93

94
/* L2CAP extended feature mask */
95 96
#define L2CAP_FEAT_FLOWCTL	0x00000001
#define L2CAP_FEAT_RETRANS	0x00000002
97
#define L2CAP_FEAT_BIDIR_QOS	0x00000004
98 99 100
#define L2CAP_FEAT_ERTM		0x00000008
#define L2CAP_FEAT_STREAMING	0x00000010
#define L2CAP_FEAT_FCS		0x00000020
101
#define L2CAP_FEAT_EXT_FLOW	0x00000040
102
#define L2CAP_FEAT_FIXED_CHAN	0x00000080
103 104
#define L2CAP_FEAT_EXT_WINDOW	0x00000100
#define L2CAP_FEAT_UCD		0x00000200
105 106 107 108

/* L2CAP checksum option */
#define L2CAP_FCS_NONE		0x00
#define L2CAP_FCS_CRC16		0x01
L
Linus Torvalds 已提交
109

110 111 112 113 114 115 116 117 118 119 120 121
/* L2CAP Control Field bit masks */
#define L2CAP_CTRL_SAR               0xC000
#define L2CAP_CTRL_REQSEQ            0x3F00
#define L2CAP_CTRL_TXSEQ             0x007E
#define L2CAP_CTRL_RETRANS           0x0080
#define L2CAP_CTRL_FINAL             0x0080
#define L2CAP_CTRL_POLL              0x0010
#define L2CAP_CTRL_SUPERVISE         0x000C
#define L2CAP_CTRL_FRAME_TYPE        0x0001 /* I- or S-Frame */

#define L2CAP_CTRL_TXSEQ_SHIFT      1
#define L2CAP_CTRL_REQSEQ_SHIFT     8
122
#define L2CAP_CTRL_SAR_SHIFT       14
123 124 125 126 127 128 129 130 131 132 133 134 135

/* L2CAP Supervisory Function */
#define L2CAP_SUPER_RCV_READY           0x0000
#define L2CAP_SUPER_REJECT              0x0004
#define L2CAP_SUPER_RCV_NOT_READY       0x0008
#define L2CAP_SUPER_SELECT_REJECT       0x000C

/* L2CAP Segmentation and Reassembly */
#define L2CAP_SDU_UNSEGMENTED       0x0000
#define L2CAP_SDU_START             0x4000
#define L2CAP_SDU_END               0x8000
#define L2CAP_SDU_CONTINUE          0xC000

136 137 138 139 140 141
/* L2CAP Command rej. reasons */
#define L2CAP_REJ_NOT_UNDERSTOOD      0x0000
#define L2CAP_REJ_MTU_EXCEEDED        0x0001
#define L2CAP_REJ_INVALID_CID         0x0002


L
Linus Torvalds 已提交
142 143
/* L2CAP structures */
struct l2cap_hdr {
144 145
	__le16     len;
	__le16     cid;
146
} __packed;
L
Linus Torvalds 已提交
147 148 149 150 151
#define L2CAP_HDR_SIZE		4

struct l2cap_cmd_hdr {
	__u8       code;
	__u8       ident;
152
	__le16     len;
153
} __packed;
L
Linus Torvalds 已提交
154 155
#define L2CAP_CMD_HDR_SIZE	4

156 157 158 159 160
struct l2cap_cmd_rej_unk {
	__le16     reason;
} __packed;

struct l2cap_cmd_rej_mtu {
161
	__le16     reason;
162 163 164 165 166 167 168
	__le16     max_mtu;
} __packed;

struct l2cap_cmd_rej_cid {
	__le16     reason;
	__le16     scid;
	__le16     dcid;
169
} __packed;
L
Linus Torvalds 已提交
170 171

struct l2cap_conn_req {
172 173
	__le16     psm;
	__le16     scid;
174
} __packed;
L
Linus Torvalds 已提交
175 176

struct l2cap_conn_rsp {
177 178 179 180
	__le16     dcid;
	__le16     scid;
	__le16     result;
	__le16     status;
181
} __packed;
L
Linus Torvalds 已提交
182

183 184 185
/* channel indentifier */
#define L2CAP_CID_SIGNALING	0x0001
#define L2CAP_CID_CONN_LESS	0x0002
186 187 188
#define L2CAP_CID_LE_DATA	0x0004
#define L2CAP_CID_LE_SIGNALING	0x0005
#define L2CAP_CID_SMP		0x0006
189 190 191
#define L2CAP_CID_DYN_START	0x0040
#define L2CAP_CID_DYN_END	0xffff

L
Linus Torvalds 已提交
192
/* connect result */
193 194 195 196 197
#define L2CAP_CR_SUCCESS	0x0000
#define L2CAP_CR_PEND		0x0001
#define L2CAP_CR_BAD_PSM	0x0002
#define L2CAP_CR_SEC_BLOCK	0x0003
#define L2CAP_CR_NO_MEM		0x0004
L
Linus Torvalds 已提交
198 199

/* connect status */
200 201 202
#define L2CAP_CS_NO_INFO	0x0000
#define L2CAP_CS_AUTHEN_PEND	0x0001
#define L2CAP_CS_AUTHOR_PEND	0x0002
L
Linus Torvalds 已提交
203 204

struct l2cap_conf_req {
205 206
	__le16     dcid;
	__le16     flags;
L
Linus Torvalds 已提交
207
	__u8       data[0];
208
} __packed;
L
Linus Torvalds 已提交
209 210

struct l2cap_conf_rsp {
211 212 213
	__le16     scid;
	__le16     flags;
	__le16     result;
L
Linus Torvalds 已提交
214
	__u8       data[0];
215
} __packed;
L
Linus Torvalds 已提交
216

217 218 219 220
#define L2CAP_CONF_SUCCESS	0x0000
#define L2CAP_CONF_UNACCEPT	0x0001
#define L2CAP_CONF_REJECT	0x0002
#define L2CAP_CONF_UNKNOWN	0x0003
L
Linus Torvalds 已提交
221 222 223 224 225

struct l2cap_conf_opt {
	__u8       type;
	__u8       len;
	__u8       val[0];
226
} __packed;
L
Linus Torvalds 已提交
227 228
#define L2CAP_CONF_OPT_SIZE	2

229
#define L2CAP_CONF_HINT		0x80
230
#define L2CAP_CONF_MASK		0x7f
231

L
Linus Torvalds 已提交
232 233 234 235
#define L2CAP_CONF_MTU		0x01
#define L2CAP_CONF_FLUSH_TO	0x02
#define L2CAP_CONF_QOS		0x03
#define L2CAP_CONF_RFC		0x04
236
#define L2CAP_CONF_FCS		0x05
L
Linus Torvalds 已提交
237 238 239

#define L2CAP_CONF_MAX_SIZE	22

240 241 242 243 244 245 246
struct l2cap_conf_rfc {
	__u8       mode;
	__u8       txwin_size;
	__u8       max_transmit;
	__le16     retrans_timeout;
	__le16     monitor_timeout;
	__le16     max_pdu_size;
247
} __packed;
248 249 250 251

#define L2CAP_MODE_BASIC	0x00
#define L2CAP_MODE_RETRANS	0x01
#define L2CAP_MODE_FLOWCTL	0x02
252
#define L2CAP_MODE_ERTM		0x03
253
#define L2CAP_MODE_STREAMING	0x04
254

L
Linus Torvalds 已提交
255
struct l2cap_disconn_req {
256 257
	__le16     dcid;
	__le16     scid;
258
} __packed;
L
Linus Torvalds 已提交
259 260

struct l2cap_disconn_rsp {
261 262
	__le16     dcid;
	__le16     scid;
263
} __packed;
L
Linus Torvalds 已提交
264 265

struct l2cap_info_req {
266
	__le16      type;
267
} __packed;
L
Linus Torvalds 已提交
268 269

struct l2cap_info_rsp {
270 271
	__le16      type;
	__le16      result;
L
Linus Torvalds 已提交
272
	__u8        data[0];
273
} __packed;
L
Linus Torvalds 已提交
274 275 276 277

/* info type */
#define L2CAP_IT_CL_MTU     0x0001
#define L2CAP_IT_FEAT_MASK  0x0002
278
#define L2CAP_IT_FIXED_CHAN 0x0003
L
Linus Torvalds 已提交
279 280 281 282 283

/* info result */
#define L2CAP_IR_SUCCESS    0x0000
#define L2CAP_IR_NOTSUPP    0x0001

284 285 286 287 288 289 290 291 292 293 294 295 296 297 298
struct l2cap_conn_param_update_req {
	__le16      min;
	__le16      max;
	__le16      latency;
	__le16      to_multiplier;
} __packed;

struct l2cap_conn_param_update_rsp {
	__le16      result;
} __packed;

/* Connection Parameters result */
#define L2CAP_CONN_PARAM_ACCEPTED	0x0000
#define L2CAP_CONN_PARAM_REJECTED	0x0001

299
/* ----- L2CAP channels and connections ----- */
300 301 302 303 304
struct srej_list {
	__u8	tx_seq;
	struct list_head list;
};

305 306
struct l2cap_chan {
	struct sock *sk;
307 308 309

	struct l2cap_conn	*conn;

310 311
	__u8		state;

312 313
	atomic_t	refcnt;

314 315 316
	__le16		psm;
	__u16		dcid;
	__u16		scid;
317

318 319 320 321
	__u16		imtu;
	__u16		omtu;
	__u16		flush_to;
	__u8		mode;
322
	__u8		chan_type;
323 324 325

	__le16		sport;

326 327
	__u8		sec_level;
	__u8		role_switch;
328
	__u8		force_active;
329

330 331
	__u8		ident;

332 333 334 335 336
	__u8		conf_req[64];
	__u8		conf_len;
	__u8		num_conf_req;
	__u8		num_conf_rsp;

337 338 339 340 341 342 343 344
	__u8		fcs;

	__u8		tx_win;
	__u8		max_tx;
	__u16		retrans_timeout;
	__u16		monitor_timeout;
	__u16		mps;

345
	unsigned long	conf_state;
346
	unsigned long	conn_state;
347
	unsigned long	flags;
348

349 350 351 352 353
	__u8		next_tx_seq;
	__u8		expected_ack_seq;
	__u8		expected_tx_seq;
	__u8		buffer_seq;
	__u8		buffer_seq_srej;
354 355 356 357 358
	__u8		srej_save_reqseq;
	__u8		frames_sent;
	__u8		unacked_frames;
	__u8		retry_count;
	__u8		num_acked;
359 360
	__u16		sdu_len;
	struct sk_buff	*sdu;
361
	struct sk_buff	*sdu_last_frag;
362

363 364 365
	__u8		remote_tx_win;
	__u8		remote_max_tx;
	__u16		remote_mps;
366

367
	struct timer_list	chan_timer;
368 369 370
	struct timer_list	retrans_timer;
	struct timer_list	monitor_timer;
	struct timer_list	ack_timer;
371 372
	struct sk_buff		*tx_send_head;
	struct sk_buff_head	tx_q;
373
	struct sk_buff_head	srej_q;
374
	struct list_head	srej_l;
375

376
	struct list_head list;
377
	struct list_head global_l;
378 379 380 381 382 383 384 385 386

	void		*data;
	struct l2cap_ops *ops;
};

struct l2cap_ops {
	char		*name;

	struct l2cap_chan	*(*new_connection) (void *data);
387
	int			(*recv) (void *data, struct sk_buff *skb);
388
	void			(*close) (void *data);
389
	void			(*state_change) (void *data, int state);
L
Linus Torvalds 已提交
390 391 392 393 394 395 396 397 398 399
};

struct l2cap_conn {
	struct hci_conn	*hcon;

	bdaddr_t	*dst;
	bdaddr_t	*src;

	unsigned int	mtu;

400 401 402 403 404 405 406
	__u32		feat_mask;

	__u8		info_state;
	__u8		info_ident;

	struct timer_list info_timer;

L
Linus Torvalds 已提交
407 408 409 410 411 412
	spinlock_t	lock;

	struct sk_buff *rx_skb;
	__u32		rx_len;
	__u8		tx_ident;

413 414
	__u8		disc_reason;

415
	struct timer_list security_timer;
416
	struct smp_chan *smp_chan;
417

418 419
	struct list_head chan_l;
	rwlock_t	chan_lock;
L
Linus Torvalds 已提交
420 421
};

422
#define L2CAP_INFO_CL_MTU_REQ_SENT	0x01
423 424
#define L2CAP_INFO_FEAT_MASK_REQ_SENT	0x04
#define L2CAP_INFO_FEAT_MASK_REQ_DONE	0x08
425

426 427 428 429
#define L2CAP_CHAN_RAW			1
#define L2CAP_CHAN_CONN_LESS		2
#define L2CAP_CHAN_CONN_ORIENTED	3

430
/* ----- L2CAP socket info ----- */
L
Linus Torvalds 已提交
431 432 433 434
#define l2cap_pi(sk) ((struct l2cap_pinfo *) sk)

struct l2cap_pinfo {
	struct bt_sock	bt;
435
	struct l2cap_chan	*chan;
436
	struct sk_buff	*rx_busy_skb;
L
Linus Torvalds 已提交
437 438
};

439 440 441 442 443 444 445 446 447 448
enum {
	CONF_REQ_SENT,
	CONF_INPUT_DONE,
	CONF_OUTPUT_DONE,
	CONF_MTU_DONE,
	CONF_MODE_DONE,
	CONF_CONNECT_PEND,
	CONF_NO_FCS_RECV,
	CONF_STATE2_DEVICE,
};
449 450 451

#define L2CAP_CONF_MAX_CONF_REQ 2
#define L2CAP_CONF_MAX_CONF_RSP 2
452

453 454 455 456 457 458 459 460 461 462 463
enum {
	CONN_SREJ_SENT,
	CONN_WAIT_F,
	CONN_SREJ_ACT,
	CONN_SEND_PBIT,
	CONN_REMOTE_BUSY,
	CONN_LOCAL_BUSY,
	CONN_REJ_ACT,
	CONN_SEND_FBIT,
	CONN_RNR_SENT,
};
464

465 466
/* Definitions for flags in l2cap_chan */
enum {
467
	FLAG_FORCE_RELIABLE,
468 469 470
	FLAG_FLUSHABLE,
};

471 472
#define __set_chan_timer(c, t) l2cap_set_timer(c, &c->chan_timer, (t))
#define __clear_chan_timer(c) l2cap_clear_timer(c, &c->chan_timer)
473 474 475 476 477 478 479 480 481
#define __set_retrans_timer(c) l2cap_set_timer(c, &c->retrans_timer, \
		L2CAP_DEFAULT_RETRANS_TO);
#define __clear_retrans_timer(c) l2cap_clear_timer(c, &c->retrans_timer)
#define __set_monitor_timer(c) l2cap_set_timer(c, &c->monitor_timer, \
		L2CAP_DEFAULT_MONITOR_TO);
#define __clear_monitor_timer(c) l2cap_clear_timer(c, &c->monitor_timer)
#define __set_ack_timer(c) l2cap_set_timer(c, &chan->ack_timer, \
		L2CAP_DEFAULT_ACK_TO);
#define __clear_ack_timer(c) l2cap_clear_timer(c, &c->ack_timer)
482

483
static inline int l2cap_tx_window_full(struct l2cap_chan *ch)
484 485 486
{
	int sub;

487
	sub = (ch->next_tx_seq - ch->expected_ack_seq) % 64;
488 489 490 491

	if (sub < 0)
		sub += 64;

492
	return sub == ch->remote_tx_win;
493 494
}

495 496 497 498 499
#define __get_txseq(ctrl)	(((ctrl) & L2CAP_CTRL_TXSEQ) >> 1)
#define __get_reqseq(ctrl)	(((ctrl) & L2CAP_CTRL_REQSEQ) >> 8)
#define __is_iframe(ctrl)	(!((ctrl) & L2CAP_CTRL_FRAME_TYPE))
#define __is_sframe(ctrl)	((ctrl) & L2CAP_CTRL_FRAME_TYPE)
#define __is_sar_start(ctrl)	(((ctrl) & L2CAP_CTRL_SAR) == L2CAP_SDU_START)
L
Linus Torvalds 已提交
500

501 502 503 504 505
extern int disable_ertm;

int l2cap_init_sockets(void);
void l2cap_cleanup_sockets(void);

506
void __l2cap_connect_rsp_defer(struct l2cap_chan *chan);
507
int __l2cap_wait_ack(struct sock *sk);
508

509 510 511
int l2cap_add_psm(struct l2cap_chan *chan, bdaddr_t *src, __le16 psm);
int l2cap_add_scid(struct l2cap_chan *chan,  __u16 scid);

512
struct l2cap_chan *l2cap_chan_create(struct sock *sk);
513
void l2cap_chan_close(struct l2cap_chan *chan, int reason);
514
void l2cap_chan_destroy(struct l2cap_chan *chan);
515
int l2cap_chan_connect(struct l2cap_chan *chan);
516
int l2cap_chan_send(struct l2cap_chan *chan, struct msghdr *msg, size_t len);
517
void l2cap_chan_busy(struct l2cap_chan *chan, int busy);
518

L
Linus Torvalds 已提交
519
#endif /* __L2CAP_H */