2 BlueZ - Bluetooth protocol stack for Linux
3 Copyright (C) 2000-2001 Qualcomm Incorporated
4 Copyright (C) 2009-2010 Gustavo F. Padovan <gustavo@padovan.org>
5 Copyright (C) 2010 Google Inc.
7 Written 2000,2001 by Maxim Krasnyansky <maxk@qualcomm.com>
9 This program is free software; you can redistribute it and/or modify
10 it under the terms of the GNU General Public License version 2 as
11 published by the Free Software Foundation;
13 THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
14 OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
15 FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT OF THIRD PARTY RIGHTS.
16 IN NO EVENT SHALL THE COPYRIGHT HOLDER(S) AND AUTHOR(S) BE LIABLE FOR ANY
17 CLAIM, OR ANY SPECIAL INDIRECT OR CONSEQUENTIAL DAMAGES, OR ANY DAMAGES
18 WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
19 ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
20 OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
22 ALL LIABILITY, INCLUDING LIABILITY FOR INFRINGEMENT OF ANY PATENTS,
23 COPYRIGHTS, TRADEMARKS OR OTHER RIGHTS, RELATING TO USE OF THIS
24 SOFTWARE IS DISCLAIMED.
30 #include <asm/unaligned.h>
33 #define L2CAP_DEFAULT_MTU 672
34 #define L2CAP_DEFAULT_MIN_MTU 48
35 #define L2CAP_DEFAULT_FLUSH_TO 0xFFFF
36 #define L2CAP_EFS_DEFAULT_FLUSH_TO 0xFFFFFFFF
37 #define L2CAP_DEFAULT_TX_WINDOW 63
38 #define L2CAP_DEFAULT_EXT_WINDOW 0x3FFF
39 #define L2CAP_DEFAULT_MAX_TX 3
40 #define L2CAP_DEFAULT_RETRANS_TO 2000 /* 2 seconds */
41 #define L2CAP_DEFAULT_MONITOR_TO 12000 /* 12 seconds */
42 #define L2CAP_DEFAULT_MAX_PDU_SIZE 1492 /* Sized for AMP packet */
43 #define L2CAP_DEFAULT_ACK_TO 200
44 #define L2CAP_DEFAULT_MAX_SDU_SIZE 0xFFFF
45 #define L2CAP_DEFAULT_SDU_ITIME 0xFFFFFFFF
46 #define L2CAP_DEFAULT_ACC_LAT 0xFFFFFFFF
47 #define L2CAP_BREDR_MAX_PAYLOAD 1019 /* 3-DH5 packet */
48 #define L2CAP_LE_MIN_MTU 23
50 #define L2CAP_DISC_TIMEOUT msecs_to_jiffies(100)
51 #define L2CAP_DISC_REJ_TIMEOUT msecs_to_jiffies(5000)
52 #define L2CAP_ENC_TIMEOUT msecs_to_jiffies(5000)
53 #define L2CAP_CONN_TIMEOUT msecs_to_jiffies(40000)
54 #define L2CAP_INFO_TIMEOUT msecs_to_jiffies(4000)
55 #define L2CAP_MOVE_TIMEOUT msecs_to_jiffies(4000)
56 #define L2CAP_MOVE_ERTX_TIMEOUT msecs_to_jiffies(60000)
58 #define L2CAP_A2MP_DEFAULT_MTU 670
60 /* L2CAP socket address */
62 sa_family_t l2_family;
69 /* L2CAP socket options */
70 #define L2CAP_OPTIONS 0x01
71 struct l2cap_options {
81 #define L2CAP_CONNINFO 0x02
82 struct l2cap_conninfo {
88 #define L2CAP_LM_MASTER 0x0001
89 #define L2CAP_LM_AUTH 0x0002
90 #define L2CAP_LM_ENCRYPT 0x0004
91 #define L2CAP_LM_TRUSTED 0x0008
92 #define L2CAP_LM_RELIABLE 0x0010
93 #define L2CAP_LM_SECURE 0x0020
95 /* L2CAP command codes */
96 #define L2CAP_COMMAND_REJ 0x01
97 #define L2CAP_CONN_REQ 0x02
98 #define L2CAP_CONN_RSP 0x03
99 #define L2CAP_CONF_REQ 0x04
100 #define L2CAP_CONF_RSP 0x05
101 #define L2CAP_DISCONN_REQ 0x06
102 #define L2CAP_DISCONN_RSP 0x07
103 #define L2CAP_ECHO_REQ 0x08
104 #define L2CAP_ECHO_RSP 0x09
105 #define L2CAP_INFO_REQ 0x0a
106 #define L2CAP_INFO_RSP 0x0b
107 #define L2CAP_CREATE_CHAN_REQ 0x0c
108 #define L2CAP_CREATE_CHAN_RSP 0x0d
109 #define L2CAP_MOVE_CHAN_REQ 0x0e
110 #define L2CAP_MOVE_CHAN_RSP 0x0f
111 #define L2CAP_MOVE_CHAN_CFM 0x10
112 #define L2CAP_MOVE_CHAN_CFM_RSP 0x11
113 #define L2CAP_CONN_PARAM_UPDATE_REQ 0x12
114 #define L2CAP_CONN_PARAM_UPDATE_RSP 0x13
116 /* L2CAP extended feature mask */
117 #define L2CAP_FEAT_FLOWCTL 0x00000001
118 #define L2CAP_FEAT_RETRANS 0x00000002
119 #define L2CAP_FEAT_BIDIR_QOS 0x00000004
120 #define L2CAP_FEAT_ERTM 0x00000008
121 #define L2CAP_FEAT_STREAMING 0x00000010
122 #define L2CAP_FEAT_FCS 0x00000020
123 #define L2CAP_FEAT_EXT_FLOW 0x00000040
124 #define L2CAP_FEAT_FIXED_CHAN 0x00000080
125 #define L2CAP_FEAT_EXT_WINDOW 0x00000100
126 #define L2CAP_FEAT_UCD 0x00000200
128 /* L2CAP checksum option */
129 #define L2CAP_FCS_NONE 0x00
130 #define L2CAP_FCS_CRC16 0x01
132 /* L2CAP fixed channels */
133 #define L2CAP_FC_L2CAP 0x02
134 #define L2CAP_FC_A2MP 0x08
136 /* L2CAP Control Field bit masks */
137 #define L2CAP_CTRL_SAR 0xC000
138 #define L2CAP_CTRL_REQSEQ 0x3F00
139 #define L2CAP_CTRL_TXSEQ 0x007E
140 #define L2CAP_CTRL_SUPERVISE 0x000C
142 #define L2CAP_CTRL_RETRANS 0x0080
143 #define L2CAP_CTRL_FINAL 0x0080
144 #define L2CAP_CTRL_POLL 0x0010
145 #define L2CAP_CTRL_FRAME_TYPE 0x0001 /* I- or S-Frame */
147 #define L2CAP_CTRL_TXSEQ_SHIFT 1
148 #define L2CAP_CTRL_SUPER_SHIFT 2
149 #define L2CAP_CTRL_POLL_SHIFT 4
150 #define L2CAP_CTRL_FINAL_SHIFT 7
151 #define L2CAP_CTRL_REQSEQ_SHIFT 8
152 #define L2CAP_CTRL_SAR_SHIFT 14
154 /* L2CAP Extended Control Field bit mask */
155 #define L2CAP_EXT_CTRL_TXSEQ 0xFFFC0000
156 #define L2CAP_EXT_CTRL_SAR 0x00030000
157 #define L2CAP_EXT_CTRL_SUPERVISE 0x00030000
158 #define L2CAP_EXT_CTRL_REQSEQ 0x0000FFFC
160 #define L2CAP_EXT_CTRL_POLL 0x00040000
161 #define L2CAP_EXT_CTRL_FINAL 0x00000002
162 #define L2CAP_EXT_CTRL_FRAME_TYPE 0x00000001 /* I- or S-Frame */
164 #define L2CAP_EXT_CTRL_FINAL_SHIFT 1
165 #define L2CAP_EXT_CTRL_REQSEQ_SHIFT 2
166 #define L2CAP_EXT_CTRL_SAR_SHIFT 16
167 #define L2CAP_EXT_CTRL_SUPER_SHIFT 16
168 #define L2CAP_EXT_CTRL_POLL_SHIFT 18
169 #define L2CAP_EXT_CTRL_TXSEQ_SHIFT 18
171 /* L2CAP Supervisory Function */
172 #define L2CAP_SUPER_RR 0x00
173 #define L2CAP_SUPER_REJ 0x01
174 #define L2CAP_SUPER_RNR 0x02
175 #define L2CAP_SUPER_SREJ 0x03
177 /* L2CAP Segmentation and Reassembly */
178 #define L2CAP_SAR_UNSEGMENTED 0x00
179 #define L2CAP_SAR_START 0x01
180 #define L2CAP_SAR_END 0x02
181 #define L2CAP_SAR_CONTINUE 0x03
183 /* L2CAP Command rej. reasons */
184 #define L2CAP_REJ_NOT_UNDERSTOOD 0x0000
185 #define L2CAP_REJ_MTU_EXCEEDED 0x0001
186 #define L2CAP_REJ_INVALID_CID 0x0002
188 /* L2CAP structures */
193 #define L2CAP_HDR_SIZE 4
194 #define L2CAP_ENH_HDR_SIZE 6
195 #define L2CAP_EXT_HDR_SIZE 8
197 #define L2CAP_FCS_SIZE 2
198 #define L2CAP_SDULEN_SIZE 2
199 #define L2CAP_PSMLEN_SIZE 2
200 #define L2CAP_ENH_CTRL_SIZE 2
201 #define L2CAP_EXT_CTRL_SIZE 4
203 struct l2cap_cmd_hdr {
208 #define L2CAP_CMD_HDR_SIZE 4
210 struct l2cap_cmd_rej_unk {
214 struct l2cap_cmd_rej_mtu {
219 struct l2cap_cmd_rej_cid {
225 struct l2cap_conn_req {
230 struct l2cap_conn_rsp {
237 /* protocol/service multiplexer (PSM) */
238 #define L2CAP_PSM_SDP 0x0001
239 #define L2CAP_PSM_RFCOMM 0x0003
241 /* channel indentifier */
242 #define L2CAP_CID_SIGNALING 0x0001
243 #define L2CAP_CID_CONN_LESS 0x0002
244 #define L2CAP_CID_A2MP 0x0003
245 #define L2CAP_CID_LE_DATA 0x0004
246 #define L2CAP_CID_LE_SIGNALING 0x0005
247 #define L2CAP_CID_SMP 0x0006
248 #define L2CAP_CID_DYN_START 0x0040
249 #define L2CAP_CID_DYN_END 0xffff
251 /* connect/create channel results */
252 #define L2CAP_CR_SUCCESS 0x0000
253 #define L2CAP_CR_PEND 0x0001
254 #define L2CAP_CR_BAD_PSM 0x0002
255 #define L2CAP_CR_SEC_BLOCK 0x0003
256 #define L2CAP_CR_NO_MEM 0x0004
257 #define L2CAP_CR_BAD_AMP 0x0005
259 /* connect/create channel status */
260 #define L2CAP_CS_NO_INFO 0x0000
261 #define L2CAP_CS_AUTHEN_PEND 0x0001
262 #define L2CAP_CS_AUTHOR_PEND 0x0002
264 struct l2cap_conf_req {
270 struct l2cap_conf_rsp {
277 #define L2CAP_CONF_SUCCESS 0x0000
278 #define L2CAP_CONF_UNACCEPT 0x0001
279 #define L2CAP_CONF_REJECT 0x0002
280 #define L2CAP_CONF_UNKNOWN 0x0003
281 #define L2CAP_CONF_PENDING 0x0004
282 #define L2CAP_CONF_EFS_REJECT 0x0005
284 /* configuration req/rsp continuation flag */
285 #define L2CAP_CONF_FLAG_CONTINUATION 0x0001
287 struct l2cap_conf_opt {
292 #define L2CAP_CONF_OPT_SIZE 2
294 #define L2CAP_CONF_HINT 0x80
295 #define L2CAP_CONF_MASK 0x7f
297 #define L2CAP_CONF_MTU 0x01
298 #define L2CAP_CONF_FLUSH_TO 0x02
299 #define L2CAP_CONF_QOS 0x03
300 #define L2CAP_CONF_RFC 0x04
301 #define L2CAP_CONF_FCS 0x05
302 #define L2CAP_CONF_EFS 0x06
303 #define L2CAP_CONF_EWS 0x07
305 #define L2CAP_CONF_MAX_SIZE 22
307 struct l2cap_conf_rfc {
311 __le16 retrans_timeout;
312 __le16 monitor_timeout;
316 #define L2CAP_MODE_BASIC 0x00
317 #define L2CAP_MODE_RETRANS 0x01
318 #define L2CAP_MODE_FLOWCTL 0x02
319 #define L2CAP_MODE_ERTM 0x03
320 #define L2CAP_MODE_STREAMING 0x04
322 struct l2cap_conf_efs {
331 #define L2CAP_SERV_NOTRAFIC 0x00
332 #define L2CAP_SERV_BESTEFFORT 0x01
333 #define L2CAP_SERV_GUARANTEED 0x02
335 #define L2CAP_BESTEFFORT_ID 0x01
337 struct l2cap_disconn_req {
342 struct l2cap_disconn_rsp {
347 struct l2cap_info_req {
351 struct l2cap_info_rsp {
357 struct l2cap_create_chan_req {
363 struct l2cap_create_chan_rsp {
370 struct l2cap_move_chan_req {
375 struct l2cap_move_chan_rsp {
380 #define L2CAP_MR_SUCCESS 0x0000
381 #define L2CAP_MR_PEND 0x0001
382 #define L2CAP_MR_BAD_ID 0x0002
383 #define L2CAP_MR_SAME_ID 0x0003
384 #define L2CAP_MR_NOT_SUPP 0x0004
385 #define L2CAP_MR_COLLISION 0x0005
386 #define L2CAP_MR_NOT_ALLOWED 0x0006
388 struct l2cap_move_chan_cfm {
393 #define L2CAP_MC_CONFIRMED 0x0000
394 #define L2CAP_MC_UNCONFIRMED 0x0001
396 struct l2cap_move_chan_cfm_rsp {
401 #define L2CAP_IT_CL_MTU 0x0001
402 #define L2CAP_IT_FEAT_MASK 0x0002
403 #define L2CAP_IT_FIXED_CHAN 0x0003
406 #define L2CAP_IR_SUCCESS 0x0000
407 #define L2CAP_IR_NOTSUPP 0x0001
409 struct l2cap_conn_param_update_req {
413 __le16 to_multiplier;
416 struct l2cap_conn_param_update_rsp {
420 /* Connection Parameters result */
421 #define L2CAP_CONN_PARAM_ACCEPTED 0x0000
422 #define L2CAP_CONN_PARAM_REJECTED 0x0001
424 /* ----- L2CAP channels and connections ----- */
425 struct l2cap_seq_list {
432 #define L2CAP_SEQ_LIST_CLEAR 0xFFFF
433 #define L2CAP_SEQ_LIST_TAIL 0x8000
438 struct l2cap_conn *conn;
439 struct hci_conn *hs_hcon;
440 struct hci_chan *hs_hchan;
473 __u16 retrans_timeout;
474 __u16 monitor_timeout;
480 unsigned long conf_state;
481 unsigned long conn_state;
490 __u16 expected_ack_seq;
491 __u16 expected_tx_seq;
493 __u16 srej_save_reqseq;
494 __u16 last_acked_seq;
496 __u16 unacked_frames;
498 __u16 srej_queue_next;
501 struct sk_buff *sdu_last_frag;
510 __u32 local_sdu_itime;
512 __u32 local_flush_to;
517 __u32 remote_sdu_itime;
518 __u32 remote_acc_lat;
519 __u32 remote_flush_to;
523 struct delayed_work chan_timer;
524 struct delayed_work retrans_timer;
525 struct delayed_work monitor_timer;
526 struct delayed_work ack_timer;
528 struct sk_buff *tx_send_head;
529 struct sk_buff_head tx_q;
530 struct sk_buff_head srej_q;
531 struct l2cap_seq_list srej_list;
532 struct l2cap_seq_list retrans_list;
534 struct list_head list;
535 struct list_head global_l;
538 struct l2cap_ops *ops;
545 struct l2cap_chan *(*new_connection) (struct l2cap_chan *chan);
546 int (*recv) (struct l2cap_chan * chan,
547 struct sk_buff *skb);
548 void (*teardown) (struct l2cap_chan *chan, int err);
549 void (*close) (struct l2cap_chan *chan);
550 void (*state_change) (struct l2cap_chan *chan,
552 void (*ready) (struct l2cap_chan *chan);
553 void (*defer) (struct l2cap_chan *chan);
554 struct sk_buff *(*alloc_skb) (struct l2cap_chan *chan,
555 unsigned long len, int nb);
559 struct hci_conn *hcon;
560 struct hci_chan *hchan;
568 __u8 fixed_chan_mask;
573 struct delayed_work info_timer;
577 struct sk_buff *rx_skb;
583 struct delayed_work security_timer;
584 struct smp_chan *smp_chan;
586 struct list_head chan_l;
587 struct mutex chan_lock;
590 #define L2CAP_INFO_CL_MTU_REQ_SENT 0x01
591 #define L2CAP_INFO_FEAT_MASK_REQ_SENT 0x04
592 #define L2CAP_INFO_FEAT_MASK_REQ_DONE 0x08
594 #define L2CAP_CHAN_RAW 1
595 #define L2CAP_CHAN_CONN_LESS 2
596 #define L2CAP_CHAN_CONN_ORIENTED 3
597 #define L2CAP_CHAN_CONN_FIX_A2MP 4
599 /* ----- L2CAP socket info ----- */
600 #define l2cap_pi(sk) ((struct l2cap_pinfo *) sk)
604 struct l2cap_chan *chan;
605 struct sk_buff *rx_busy_skb;
623 #define L2CAP_CONF_MAX_CONF_REQ 2
624 #define L2CAP_CONF_MAX_CONF_RSP 2
638 /* Definitions for flags in l2cap_chan */
650 L2CAP_TX_STATE_WAIT_F,
655 L2CAP_RX_STATE_SREJ_SENT,
657 L2CAP_RX_STATE_WAIT_P,
658 L2CAP_RX_STATE_WAIT_F,
662 L2CAP_TXSEQ_EXPECTED,
663 L2CAP_TXSEQ_EXPECTED_SREJ,
664 L2CAP_TXSEQ_UNEXPECTED,
665 L2CAP_TXSEQ_UNEXPECTED_SREJ,
666 L2CAP_TXSEQ_DUPLICATE,
667 L2CAP_TXSEQ_DUPLICATE_SREJ,
669 L2CAP_TXSEQ_INVALID_IGNORE,
673 L2CAP_EV_DATA_REQUEST,
674 L2CAP_EV_LOCAL_BUSY_DETECTED,
675 L2CAP_EV_LOCAL_BUSY_CLEAR,
676 L2CAP_EV_RECV_REQSEQ_AND_FBIT,
680 L2CAP_EV_EXPLICIT_POLL,
681 L2CAP_EV_RECV_IFRAME,
690 L2CAP_MOVE_ROLE_NONE,
691 L2CAP_MOVE_ROLE_INITIATOR,
692 L2CAP_MOVE_ROLE_RESPONDER,
699 L2CAP_MOVE_WAIT_RSP_SUCCESS,
700 L2CAP_MOVE_WAIT_CONFIRM,
701 L2CAP_MOVE_WAIT_CONFIRM_RSP,
702 L2CAP_MOVE_WAIT_LOGICAL_COMP,
703 L2CAP_MOVE_WAIT_LOGICAL_CFM,
704 L2CAP_MOVE_WAIT_LOCAL_BUSY,
705 L2CAP_MOVE_WAIT_PREPARE,
708 void l2cap_chan_hold(struct l2cap_chan *c);
709 void l2cap_chan_put(struct l2cap_chan *c);
711 static inline void l2cap_chan_lock(struct l2cap_chan *chan)
713 mutex_lock(&chan->lock);
716 static inline void l2cap_chan_unlock(struct l2cap_chan *chan)
718 mutex_unlock(&chan->lock);
721 static inline void l2cap_set_timer(struct l2cap_chan *chan,
722 struct delayed_work *work, long timeout)
724 BT_DBG("chan %p state %s timeout %ld", chan,
725 state_to_string(chan->state), timeout);
727 /* If delayed work cancelled do not hold(chan)
728 since it is already done with previous set_timer */
729 if (!cancel_delayed_work(work))
730 l2cap_chan_hold(chan);
732 schedule_delayed_work(work, timeout);
735 static inline bool l2cap_clear_timer(struct l2cap_chan *chan,
736 struct delayed_work *work)
740 /* put(chan) if delayed work cancelled otherwise it
741 is done in delayed work function */
742 ret = cancel_delayed_work(work);
744 l2cap_chan_put(chan);
749 #define __set_chan_timer(c, t) l2cap_set_timer(c, &c->chan_timer, (t))
750 #define __clear_chan_timer(c) l2cap_clear_timer(c, &c->chan_timer)
751 #define __clear_retrans_timer(c) l2cap_clear_timer(c, &c->retrans_timer)
752 #define __clear_monitor_timer(c) l2cap_clear_timer(c, &c->monitor_timer)
753 #define __set_ack_timer(c) l2cap_set_timer(c, &chan->ack_timer, \
754 msecs_to_jiffies(L2CAP_DEFAULT_ACK_TO));
755 #define __clear_ack_timer(c) l2cap_clear_timer(c, &c->ack_timer)
757 static inline int __seq_offset(struct l2cap_chan *chan, __u16 seq1, __u16 seq2)
762 return chan->tx_win_max + 1 - seq2 + seq1;
765 static inline __u16 __next_seq(struct l2cap_chan *chan, __u16 seq)
767 return (seq + 1) % (chan->tx_win_max + 1);
770 static inline struct l2cap_chan *l2cap_chan_no_new_connection(struct l2cap_chan *chan)
775 static inline void l2cap_chan_no_teardown(struct l2cap_chan *chan, int err)
779 static inline void l2cap_chan_no_ready(struct l2cap_chan *chan)
783 static inline void l2cap_chan_no_defer(struct l2cap_chan *chan)
787 extern bool disable_ertm;
789 int l2cap_init_sockets(void);
790 void l2cap_cleanup_sockets(void);
792 void __l2cap_connect_rsp_defer(struct l2cap_chan *chan);
793 int __l2cap_wait_ack(struct sock *sk);
795 int l2cap_add_psm(struct l2cap_chan *chan, bdaddr_t *src, __le16 psm);
796 int l2cap_add_scid(struct l2cap_chan *chan, __u16 scid);
798 struct l2cap_chan *l2cap_chan_create(void);
799 void l2cap_chan_close(struct l2cap_chan *chan, int reason);
800 int l2cap_chan_connect(struct l2cap_chan *chan, __le16 psm, u16 cid,
801 bdaddr_t *dst, u8 dst_type);
802 int l2cap_chan_send(struct l2cap_chan *chan, struct msghdr *msg, size_t len,
804 void l2cap_chan_busy(struct l2cap_chan *chan, int busy);
805 int l2cap_chan_check_security(struct l2cap_chan *chan);
806 void l2cap_chan_set_defaults(struct l2cap_chan *chan);
807 int l2cap_ertm_init(struct l2cap_chan *chan);
808 void l2cap_chan_add(struct l2cap_conn *conn, struct l2cap_chan *chan);
809 void __l2cap_chan_add(struct l2cap_conn *conn, struct l2cap_chan *chan);
810 void l2cap_chan_del(struct l2cap_chan *chan, int err);
811 void l2cap_send_conn_req(struct l2cap_chan *chan);
812 void l2cap_move_start(struct l2cap_chan *chan);
813 void l2cap_logical_cfm(struct l2cap_chan *chan, struct hci_chan *hchan,
815 void l2cap_physical_cfm(struct l2cap_chan *chan, int result);
817 #endif /* __L2CAP_H */