1 /* $NetBSD: l2cap.h,v 1.13 2014/05/20 18:25:54 rmind Exp $ */ 2 3 /*- 4 * Copyright (c) 2005 Iain Hibbert. 5 * Copyright (c) 2006 Itronix Inc. 6 * All rights reserved. 7 * 8 * Redistribution and use in source and binary forms, with or without 9 * modification, are permitted provided that the following conditions 10 * are met: 11 * 1. Redistributions of source code must retain the above copyright 12 * notice, this list of conditions and the following disclaimer. 13 * 2. Redistributions in binary form must reproduce the above copyright 14 * notice, this list of conditions and the following disclaimer in the 15 * documentation and/or other materials provided with the distribution. 16 * 3. The name of Itronix Inc. may not be used to endorse 17 * or promote products derived from this software without specific 18 * prior written permission. 19 * 20 * THIS SOFTWARE IS PROVIDED BY ITRONIX INC. ``AS IS'' AND 21 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED 22 * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR 23 * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL ITRONIX INC. BE LIABLE FOR ANY 24 * DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES 25 * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; 26 * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND 27 * ON ANY THEORY OF LIABILITY, WHETHER IN 28 * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) 29 * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE 30 * POSSIBILITY OF SUCH DAMAGE. 31 */ 32 /*- 33 * Copyright (c) Maksim Yevmenkin <m_evmenkin@yahoo.com> 34 * All rights reserved. 35 * 36 * Redistribution and use in source and binary forms, with or without 37 * modification, are permitted provided that the following conditions 38 * are met: 39 * 1. Redistributions of source code must retain the above copyright 40 * notice, this list of conditions and the following disclaimer. 41 * 2. Redistributions in binary form must reproduce the above copyright 42 * notice, this list of conditions and the following disclaimer in the 43 * documentation and/or other materials provided with the distribution. 44 * 45 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND 46 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 47 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 48 * ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE 49 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 50 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 51 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 52 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 53 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 54 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 55 * SUCH DAMAGE. 56 * 57 * $Id: l2cap.h,v 1.13 2014/05/20 18:25:54 rmind Exp $ 58 * $FreeBSD: src/sys/netgraph/bluetooth/include/l2cap.h,v 1.4 2005/08/31 18:13:23 emax Exp $ 59 */ 60 61 /* 62 * This file contains everything that application needs to know about 63 * Link Layer Control and Adaptation Protocol (L2CAP). All information 64 * was obtained from Bluetooth Specification Books (v1.1 and up) 65 * 66 * This file can be included by both kernel and userland applications. 67 */ 68 69 #ifndef _NETBT_L2CAP_H_ 70 #define _NETBT_L2CAP_H_ 71 72 #include <sys/types.h> 73 74 /************************************************************************** 75 ************************************************************************** 76 ** Common defines and types (L2CAP) 77 ************************************************************************** 78 **************************************************************************/ 79 80 /* 81 * Channel IDs are assigned per machine. So the total number of channels that 82 * a machine can have open at the same time is 0xffff - 0x0040 = 0xffbf (65471). 83 * This number does not depend on number of HCI connections. 84 */ 85 86 #define L2CAP_NULL_CID 0x0000 /* DO NOT USE THIS CID */ 87 #define L2CAP_SIGNAL_CID 0x0001 /* signaling channel ID */ 88 #define L2CAP_CLT_CID 0x0002 /* connectionless channel ID */ 89 /* 0x0003 - 0x003f Reserved */ 90 #define L2CAP_FIRST_CID 0x0040 /* dynamically alloc. (start) */ 91 #define L2CAP_LAST_CID 0xffff /* dynamically alloc. (end) */ 92 93 /* L2CAP MTU */ 94 #define L2CAP_MTU_MINIMUM 48 95 #define L2CAP_MTU_DEFAULT 672 96 #define L2CAP_MTU_MAXIMUM 0xffff 97 98 /* L2CAP flush and link timeouts */ 99 #define L2CAP_FLUSH_TIMO_DEFAULT 0xffff /* always retransmit */ 100 #define L2CAP_LINK_TIMO_DEFAULT 0xffff 101 102 /* L2CAP Command Reject reasons */ 103 #define L2CAP_REJ_NOT_UNDERSTOOD 0x0000 104 #define L2CAP_REJ_MTU_EXCEEDED 0x0001 105 #define L2CAP_REJ_INVALID_CID 0x0002 106 /* 0x0003 - 0xffff - reserved for future use */ 107 108 /* Protocol/Service Multiplexor (PSM) values */ 109 #define L2CAP_PSM_ANY 0x0000 /* Any/Invalid PSM */ 110 #define L2CAP_PSM_SDP 0x0001 /* Service Discovery Protocol */ 111 #define L2CAP_PSM_RFCOMM 0x0003 /* RFCOMM protocol */ 112 #define L2CAP_PSM_TCP 0x0005 /* Telephony Control Protocol */ 113 #define L2CAP_PSM_TCS 0x0007 /* TCS cordless */ 114 #define L2CAP_PSM_BNEP 0x000f /* Bluetooth Network */ 115 /* Encapsulation Protocol*/ 116 #define L2CAP_PSM_HID_CNTL 0x0011 /* HID Control */ 117 #define L2CAP_PSM_HID_INTR 0x0013 /* HID Interrupt */ 118 #define L2CAP_PSM_ESDP 0x0015 /* Extended Service */ 119 /* Discovery Profile */ 120 #define L2CAP_PSM_AVCTP 0x0017 /* Audio/Visual Control */ 121 /* Transport Protocol */ 122 #define L2CAP_PSM_AVDTP 0x0019 /* Audio/Visual Distribution */ 123 /* Transport Protocol */ 124 /* 0x0019 - 0x1000 - reserved for future use */ 125 126 #define L2CAP_PSM_INVALID(psm) (((psm) & 0x0101) != 0x0001) 127 128 /* L2CAP Connection response command result codes */ 129 #define L2CAP_SUCCESS 0x0000 130 #define L2CAP_PENDING 0x0001 131 #define L2CAP_PSM_NOT_SUPPORTED 0x0002 132 #define L2CAP_SECURITY_BLOCK 0x0003 133 #define L2CAP_NO_RESOURCES 0x0004 134 #define L2CAP_TIMEOUT 0xeeee 135 #define L2CAP_UNKNOWN 0xffff 136 /* 0x0005 - 0xffff - reserved for future use */ 137 138 /* L2CAP Connection response status codes */ 139 #define L2CAP_NO_INFO 0x0000 140 #define L2CAP_AUTH_PENDING 0x0001 141 #define L2CAP_AUTZ_PENDING 0x0002 142 /* 0x0003 - 0xffff - reserved for future use */ 143 144 /* L2CAP Configuration response result codes */ 145 #define L2CAP_UNACCEPTABLE_PARAMS 0x0001 146 #define L2CAP_REJECT 0x0002 147 #define L2CAP_UNKNOWN_OPTION 0x0003 148 /* 0x0003 - 0xffff - reserved for future use */ 149 150 /* L2CAP Configuration options */ 151 #define L2CAP_OPT_CFLAG_BIT 0x0001 152 #define L2CAP_OPT_CFLAG(flags) ((flags) & L2CAP_OPT_CFLAG_BIT) 153 #define L2CAP_OPT_HINT_BIT 0x80 154 #define L2CAP_OPT_HINT(type) ((type) & L2CAP_OPT_HINT_BIT) 155 #define L2CAP_OPT_HINT_MASK 0x7f 156 #define L2CAP_OPT_MTU 0x01 157 #define L2CAP_OPT_MTU_SIZE sizeof(uint16_t) 158 #define L2CAP_OPT_FLUSH_TIMO 0x02 159 #define L2CAP_OPT_FLUSH_TIMO_SIZE sizeof(uint16_t) 160 #define L2CAP_OPT_QOS 0x03 161 #define L2CAP_OPT_QOS_SIZE sizeof(l2cap_qos_t) 162 #define L2CAP_OPT_RFC 0x04 163 #define L2CAP_OPT_RFC_SIZE sizeof(l2cap_rfc_t) 164 /* 0x05 - 0xff - reserved for future use */ 165 166 /* L2CAP Information request type codes */ 167 #define L2CAP_CONNLESS_MTU 0x0001 168 #define L2CAP_EXTENDED_FEATURES 0x0002 169 #define L2CAP_FIXED_CHANNELS 0x0003 170 /* 0x0004 - 0xffff - reserved for future use */ 171 172 /* L2CAP Information response codes */ 173 #define L2CAP_NOT_SUPPORTED 0x0001 174 /* 0x0002 - 0xffff - reserved for future use */ 175 176 /* L2CAP Quality of Service option */ 177 typedef struct { 178 uint8_t flags; /* reserved for future use */ 179 uint8_t service_type; /* service type */ 180 uint32_t token_rate; /* bytes per second */ 181 uint32_t token_bucket_size; /* bytes */ 182 uint32_t peak_bandwidth; /* bytes per second */ 183 uint32_t latency; /* microseconds */ 184 uint32_t delay_variation; /* microseconds */ 185 } __packed l2cap_qos_t; 186 187 /* L2CAP QoS type */ 188 #define L2CAP_QOS_NO_TRAFFIC 0x00 189 #define L2CAP_QOS_BEST_EFFORT 0x01 /* (default) */ 190 #define L2CAP_QOS_GUARANTEED 0x02 191 /* 0x03 - 0xff - reserved for future use */ 192 193 /* L2CAP Retransmission & Flow Control option */ 194 typedef struct { 195 uint8_t mode; /* RFC mode */ 196 uint8_t window_size; /* bytes */ 197 uint8_t max_transmit; /* max retransmissions */ 198 uint16_t retransmit_timo; /* milliseconds */ 199 uint16_t monitor_timo; /* milliseconds */ 200 uint16_t max_pdu_size; /* bytes */ 201 } __packed l2cap_rfc_t; 202 203 /* L2CAP RFC mode */ 204 #define L2CAP_RFC_BASIC 0x00 /* (default) */ 205 #define L2CAP_RFC_RETRANSMIT 0x01 206 #define L2CAP_RFC_FLOW 0x02 207 /* 0x03 - 0xff - reserved for future use */ 208 209 /************************************************************************** 210 ************************************************************************** 211 ** Link level defines, headers and types 212 ************************************************************************** 213 **************************************************************************/ 214 215 /* L2CAP header */ 216 typedef struct { 217 uint16_t length; /* payload size */ 218 uint16_t dcid; /* destination channel ID */ 219 } __packed l2cap_hdr_t; 220 221 /* L2CAP ConnectionLess Traffic (dcid == L2CAP_CLT_CID) */ 222 typedef struct { 223 uint16_t psm; /* Protocol/Service Multiplexor */ 224 } __packed l2cap_clt_hdr_t; 225 226 #define L2CAP_CLT_MTU_MAXIMUM \ 227 (L2CAP_MTU_MAXIMUM - sizeof(l2cap_clt_hdr_t)) 228 229 /* L2CAP Command header (dcid == L2CAP_SIGNAL_CID) */ 230 typedef struct { 231 uint8_t code; /* command OpCode */ 232 uint8_t ident; /* identifier to match request and response */ 233 uint16_t length; /* command parameters length */ 234 } __packed l2cap_cmd_hdr_t; 235 236 /* L2CAP Command Reject */ 237 #define L2CAP_COMMAND_REJ 0x01 238 typedef struct { 239 uint16_t reason; /* reason to reject command */ 240 uint16_t data[2];/* optional data */ 241 } __packed l2cap_cmd_rej_cp; 242 243 /* L2CAP Connection Request */ 244 #define L2CAP_CONNECT_REQ 0x02 245 typedef struct { 246 uint16_t psm; /* Protocol/Service Multiplexor (PSM) */ 247 uint16_t scid; /* source channel ID */ 248 } __packed l2cap_con_req_cp; 249 250 /* L2CAP Connection Response */ 251 #define L2CAP_CONNECT_RSP 0x03 252 typedef struct { 253 uint16_t dcid; /* destination channel ID */ 254 uint16_t scid; /* source channel ID */ 255 uint16_t result; /* 0x00 - success */ 256 uint16_t status; /* more info if result != 0x00 */ 257 } __packed l2cap_con_rsp_cp; 258 259 /* L2CAP Configuration Request */ 260 #define L2CAP_CONFIG_REQ 0x04 261 typedef struct { 262 uint16_t dcid; /* destination channel ID */ 263 uint16_t flags; /* flags */ 264 /* uint8_t options[] -- options */ 265 } __packed l2cap_cfg_req_cp; 266 267 /* L2CAP Configuration Response */ 268 #define L2CAP_CONFIG_RSP 0x05 269 typedef struct { 270 uint16_t scid; /* source channel ID */ 271 uint16_t flags; /* flags */ 272 uint16_t result; /* 0x00 - success */ 273 /* uint8_t options[] -- options */ 274 } __packed l2cap_cfg_rsp_cp; 275 276 /* L2CAP configuration option */ 277 typedef struct { 278 uint8_t type; 279 uint8_t length; 280 /* uint8_t value[] -- option value (depends on type) */ 281 } __packed l2cap_cfg_opt_t; 282 283 /* L2CAP configuration option value */ 284 typedef union { 285 uint16_t mtu; /* L2CAP_OPT_MTU */ 286 uint16_t flush_timo; /* L2CAP_OPT_FLUSH_TIMO */ 287 l2cap_qos_t qos; /* L2CAP_OPT_QOS */ 288 l2cap_rfc_t rfc; /* L2CAP_OPT_RFC */ 289 } l2cap_cfg_opt_val_t; 290 291 /* L2CAP Disconnect Request */ 292 #define L2CAP_DISCONNECT_REQ 0x06 293 typedef struct { 294 uint16_t dcid; /* destination channel ID */ 295 uint16_t scid; /* source channel ID */ 296 } __packed l2cap_discon_req_cp; 297 298 /* L2CAP Disconnect Response */ 299 #define L2CAP_DISCONNECT_RSP 0x07 300 typedef l2cap_discon_req_cp l2cap_discon_rsp_cp; 301 302 /* L2CAP Echo Request */ 303 #define L2CAP_ECHO_REQ 0x08 304 /* No command parameters, only optional data */ 305 306 /* L2CAP Echo Response */ 307 #define L2CAP_ECHO_RSP 0x09 308 #define L2CAP_MAX_ECHO_SIZE \ 309 (L2CAP_MTU_MAXIMUM - sizeof(l2cap_cmd_hdr_t)) 310 /* No command parameters, only optional data */ 311 312 /* L2CAP Information Request */ 313 #define L2CAP_INFO_REQ 0x0a 314 typedef struct { 315 uint16_t type; /* requested information type */ 316 } __packed l2cap_info_req_cp; 317 318 /* L2CAP Information Response */ 319 #define L2CAP_INFO_RSP 0x0b 320 typedef struct { 321 uint16_t type; /* requested information type */ 322 uint16_t result; /* 0x00 - success */ 323 /* uint8_t info[] -- info data (depends on type) 324 */ 325 } __packed l2cap_info_rsp_cp; 326 327 328 /************************************************************************** 329 ************************************************************************** 330 ** L2CAP Socket Definitions 331 ************************************************************************** 332 **************************************************************************/ 333 334 /* Socket options */ 335 #define SO_L2CAP_IMTU 1 /* incoming MTU */ 336 #define SO_L2CAP_OMTU 2 /* outgoing MTU */ 337 #define SO_L2CAP_IQOS 3 /* incoming QoS */ 338 #define SO_L2CAP_OQOS 4 /* outgoing QoS */ 339 #define SO_L2CAP_FLUSH 5 /* flush timeout */ 340 #define SO_L2CAP_LM 6 /* link mode */ 341 342 /* L2CAP link mode flags */ 343 #define L2CAP_LM_AUTH (1<<0) /* want authentication */ 344 #define L2CAP_LM_ENCRYPT (1<<1) /* want encryption */ 345 #define L2CAP_LM_SECURE (1<<2) /* want secured link */ 346 347 #ifdef _KERNEL 348 349 LIST_HEAD(l2cap_channel_list, l2cap_channel); 350 351 /* global variables */ 352 extern struct l2cap_channel_list l2cap_active_list; 353 extern struct l2cap_channel_list l2cap_listen_list; 354 extern struct pool l2cap_pdu_pool; 355 extern struct pool l2cap_req_pool; 356 extern const l2cap_qos_t l2cap_default_qos; 357 358 /* sysctl variables */ 359 extern int l2cap_response_timeout; 360 extern int l2cap_response_extended_timeout; 361 extern int l2cap_sendspace, l2cap_recvspace; 362 363 /* 364 * L2CAP Channel 365 */ 366 struct l2cap_channel { 367 struct hci_link *lc_link; /* ACL connection (down) */ 368 uint16_t lc_state; /* channel state */ 369 uint16_t lc_flags; /* channel flags */ 370 uint8_t lc_ident; /* cached request id */ 371 372 uint16_t lc_lcid; /* local channel ID */ 373 struct sockaddr_bt lc_laddr; /* local address */ 374 375 uint16_t lc_rcid; /* remote channel ID */ 376 struct sockaddr_bt lc_raddr; /* remote address */ 377 378 int lc_mode; /* link mode */ 379 uint16_t lc_imtu; /* incoming mtu */ 380 uint16_t lc_omtu; /* outgoing mtu */ 381 uint16_t lc_flush; /* flush timeout */ 382 l2cap_qos_t lc_iqos; /* incoming QoS flow control */ 383 l2cap_qos_t lc_oqos; /* outgoing Qos flow control */ 384 385 uint8_t lc_pending; /* num of pending PDUs */ 386 MBUFQ_HEAD() lc_txq; /* transmit queue */ 387 388 const struct btproto *lc_proto; /* upper layer callbacks */ 389 void *lc_upper; /* upper layer argument */ 390 391 LIST_ENTRY(l2cap_channel)lc_ncid; /* next channel (ascending CID) */ 392 }; 393 394 /* l2cap_channel state */ 395 #define L2CAP_CLOSED 0 /* closed */ 396 #define L2CAP_WAIT_SEND_CONNECT_REQ 1 /* waiting to send connect request */ 397 #define L2CAP_WAIT_RECV_CONNECT_RSP 2 /* waiting to recv connect response */ 398 #define L2CAP_WAIT_SEND_CONNECT_RSP 3 /* waiting to send connect response */ 399 #define L2CAP_WAIT_CONFIG 4 /* waiting for configuration */ 400 #define L2CAP_OPEN 5 /* user data transfer state */ 401 #define L2CAP_WAIT_DISCONNECT 6 /* have sent disconnect request */ 402 403 /* l2cap_channel flags */ 404 #define L2CAP_SHUTDOWN (1<<0) /* channel is closing */ 405 #define L2CAP_WAIT_CONFIG_REQ (1<<1) /* waiting for config request */ 406 #define L2CAP_WAIT_CONFIG_RSP (1<<2) /* waiting for config response */ 407 408 /* 409 * L2CAP Request 410 */ 411 struct l2cap_req { 412 struct hci_link *lr_link; /* ACL connection */ 413 struct l2cap_channel *lr_chan; /* channel pointer */ 414 uint8_t lr_code; /* request code */ 415 uint8_t lr_id; /* request id */ 416 callout_t lr_rtx; /* response timer */ 417 TAILQ_ENTRY(l2cap_req) lr_next; /* next request on link */ 418 }; 419 420 /* 421 * L2CAP Protocol Data Unit 422 */ 423 struct l2cap_pdu { 424 struct l2cap_channel *lp_chan; /* PDU owner */ 425 MBUFQ_HEAD() lp_data; /* PDU data */ 426 TAILQ_ENTRY(l2cap_pdu) lp_next; /* next PDU on link */ 427 int lp_pending; /* # of fragments pending */ 428 }; 429 430 /* 431 * L2CAP function prototypes 432 */ 433 434 struct socket; 435 struct sockopt; 436 struct mbuf; 437 438 /* l2cap_lower.c */ 439 void l2cap_close(struct l2cap_channel *, int); 440 void l2cap_recv_frame(struct mbuf *, struct hci_link *); 441 int l2cap_start(struct l2cap_channel *); 442 443 /* l2cap_misc.c */ 444 int l2cap_setmode(struct l2cap_channel *); 445 int l2cap_cid_alloc(struct l2cap_channel *); 446 struct l2cap_channel *l2cap_cid_lookup(uint16_t); 447 int l2cap_request_alloc(struct l2cap_channel *, uint8_t); 448 struct l2cap_req *l2cap_request_lookup(struct hci_link *, uint8_t); 449 void l2cap_request_free(struct l2cap_req *); 450 void l2cap_rtx(void *); 451 void l2cap_init(void); 452 453 /* l2cap_signal.c */ 454 void l2cap_recv_signal(struct mbuf *, struct hci_link *); 455 int l2cap_send_connect_req(struct l2cap_channel *); 456 int l2cap_send_config_req(struct l2cap_channel *); 457 int l2cap_send_disconnect_req(struct l2cap_channel *); 458 int l2cap_send_connect_rsp(struct hci_link *, uint8_t, uint16_t, uint16_t, uint16_t); 459 460 /* l2cap_socket.c */ 461 int l2cap_ctloutput(int, struct socket *, struct sockopt *); 462 463 /* l2cap_upper.c */ 464 int l2cap_attach_pcb(struct l2cap_channel **, const struct btproto *, void *); 465 int l2cap_bind(struct l2cap_channel *, struct sockaddr_bt *); 466 int l2cap_sockaddr(struct l2cap_channel *, struct sockaddr_bt *); 467 int l2cap_connect(struct l2cap_channel *, struct sockaddr_bt *); 468 int l2cap_peeraddr(struct l2cap_channel *, struct sockaddr_bt *); 469 int l2cap_disconnect(struct l2cap_channel *, int); 470 void l2cap_detach_pcb(struct l2cap_channel **); 471 int l2cap_listen(struct l2cap_channel *); 472 int l2cap_send(struct l2cap_channel *, struct mbuf *); 473 int l2cap_setopt(struct l2cap_channel *, const struct sockopt *); 474 int l2cap_getopt(struct l2cap_channel *, struct sockopt *); 475 476 #endif /* _KERNEL */ 477 478 #endif /* _NETBT_L2CAP_H_ */ 479