1 /* 2 * Copyright 2007 Oliver Ruiz Dorantes, oliver.ruiz.dorantes_at_gmail.com 3 * All rights reserved. Distributed under the terms of the MIT License. 4 * 5 */ 6 7 /*- 8 * Copyright (c) Maksim Yevmenkin <m_evmenkin@yahoo.com> 9 * All rights reserved. 10 * 11 * Redistribution and use in source and binary forms, with or without 12 * modification, are permitted provided that the following conditions 13 * are met: 14 * 1. Redistributions of source code must retain the above copyright 15 * notice, this list of conditions and the following disclaimer. 16 * 2. Redistributions in binary form must reproduce the above copyright 17 * notice, this list of conditions and the following disclaimer in the 18 * documentation and/or other materials provided with the distribution. 19 */ 20 21 22 /************************************************************************** 23 ************************************************************************** 24 ** Common defines and types (L2CAP) 25 ************************************************************************** 26 **************************************************************************/ 27 28 #ifndef _L2CAP_ 29 #define _L2CAP_ 30 31 #include <bluetooth/bluetooth.h> 32 33 // TODO: from BSD compatibility layer 34 #define htole16(x) (x) 35 #define le16toh(x) (x) 36 #define le32toh(x) (x) 37 #define htole32(x) (x) 38 39 #define HZ 1000000 // us per second TODO: move somewhere more generic 40 #define bluetooth_l2cap_ertx_timeout (60 * HZ) 41 #define bluetooth_l2cap_rtx_timeout (300 * HZ) 42 43 /* 44 * Channel IDs are assigned relative to the instance of L2CAP node, i.e. 45 * relative to the unit. So the total number of channels that unit can have 46 * open at the same time is 0xffff - 0x0040 = 0xffbf (65471). This number 47 * does not depend on number of connections. 48 */ 49 #define L2CAP_NULL_CID 0x0000 /* DO NOT USE THIS CID */ 50 #define L2CAP_SIGNAL_CID 0x0001 /* signaling channel ID */ 51 #define L2CAP_CLT_CID 0x0002 /* connectionless channel ID */ 52 /* 0x0003 - 0x003f Reserved */ 53 #define L2CAP_FIRST_CID 0x0040 /* dynamically alloc. (start) */ 54 #define L2CAP_LAST_CID 0xffff /* dynamically alloc. (end) */ 55 56 57 /* 58 * L2CAP signaling command ident's are assigned relative to the connection, 59 * because there is only one signaling channel (cid == 0x01) for every 60 * connection. So up to 254 (0xff - 0x01) L2CAP commands can be pending at the 61 * same time for the same connection. 62 */ 63 #define L2CAP_NULL_IDENT 0x00 /* DO NOT USE THIS IDENT */ 64 #define L2CAP_FIRST_IDENT 0x01 /* dynamically alloc. (start) */ 65 #define L2CAP_LAST_IDENT 0xff /* dynamically alloc. (end) */ 66 67 68 /* L2CAP MTU */ 69 #define L2CAP_MTU_MINIMUM 48 70 #define L2CAP_MTU_DEFAULT 672 71 #define L2CAP_MTU_MAXIMUM 0xffff 72 73 /* L2CAP flush and link timeouts */ 74 #define L2CAP_FLUSH_TIMO_DEFAULT 0xffff /* always retransmit */ 75 #define L2CAP_LINK_TIMO_DEFAULT 0xffff 76 77 /* L2CAP Command Reject reasons */ 78 #define L2CAP_REJ_NOT_UNDERSTOOD 0x0000 79 #define L2CAP_REJ_MTU_EXCEEDED 0x0001 80 #define L2CAP_REJ_INVALID_CID 0x0002 81 /* 0x0003 - 0xffff - reserved for future use */ 82 83 /* Protocol/Service Multioplexor (PSM) values */ 84 #define L2CAP_PSM_ANY 0x0000 /* Any/Invalid PSM */ 85 #define L2CAP_PSM_SDP 0x0001 /* Service Discovery Protocol */ 86 #define L2CAP_PSM_RFCOMM 0x0003 /* RFCOMM protocol */ 87 #define L2CAP_PSM_TCP 0x0005 /* Telephony Control Protocol */ 88 #define L2CAP_PSM_TCS 0x0007 /* TCS cordless */ 89 #define L2CAP_PSM_BNEP 0x000F /* BNEP */ 90 #define L2CAP_PSM_HID_CTRL 0x0011 /* HID Control */ 91 #define L2CAP_PSM_HID_INT 0x0013 /* HID Interrupt */ 92 #define L2CAP_PSM_UPnP 0x0015 /* UPnP (ESDP) */ 93 #define L2CAP_PSM_AVCTP 0x0017 /* AVCTP */ 94 #define L2CAP_PSM_AVDTP 0x0019 /* AVDTP */ 95 /* < 0x1000 - reserved for future use */ 96 /* 0x1001 < x < 0xFFFF dinamically assigned */ 97 98 /* L2CAP Connection response command result codes */ 99 #define L2CAP_SUCCESS 0x0000 100 #define L2CAP_PENDING 0x0001 101 #define L2CAP_PSM_NOT_SUPPORTED 0x0002 102 #define L2CAP_SEQUIRY_BLOCK 0x0003 103 #define L2CAP_NO_RESOURCES 0x0004 104 #define L2CAP_TIMEOUT 0xeeee 105 #define L2CAP_UNKNOWN 0xffff 106 /* 0x0005 - 0xffff - reserved for future use */ 107 108 /* L2CAP Connection response status codes */ 109 #define L2CAP_NO_INFO 0x0000 110 #define L2CAP_AUTH_PENDING 0x0001 111 #define L2CAP_AUTZ_PENDING 0x0002 112 /* 0x0003 - 0xffff - reserved for future use */ 113 114 /* L2CAP Configuration response result codes */ 115 #define L2CAP_UNACCEPTABLE_PARAMS 0x0001 116 #define L2CAP_REJECT 0x0002 117 #define L2CAP_UNKNOWN_OPTION 0x0003 118 /* 0x0003 - 0xffff - reserved for future use */ 119 120 /* L2CAP Configuration options */ 121 #define L2CAP_OPT_CFLAG_BIT 0x0001 122 #define L2CAP_OPT_CFLAG(flags) ((flags) & L2CAP_OPT_CFLAG_BIT) 123 #define L2CAP_OPT_HINT_BIT 0x80 124 #define L2CAP_OPT_HINT(type) ((type) & L2CAP_OPT_HINT_BIT) 125 #define L2CAP_OPT_HINT_MASK 0x7f 126 #define L2CAP_OPT_MTU 0x01 127 #define L2CAP_OPT_MTU_SIZE sizeof(uint16) 128 #define L2CAP_OPT_FLUSH_TIMO 0x02 129 #define L2CAP_OPT_FLUSH_TIMO_SIZE sizeof(uint16) 130 #define L2CAP_OPT_QOS 0x03 131 #define L2CAP_OPT_QOS_SIZE sizeof(l2cap_flow_t) 132 /* 0x4 - 0xff - reserved for future use */ 133 134 #define L2CAP_CFG_IN (1 << 0) /* incoming path done */ 135 #define L2CAP_CFG_OUT (1 << 1) /* outgoing path done */ 136 #define L2CAP_CFG_BOTH (L2CAP_CFG_IN | L2CAP_CFG_OUT) 137 #define L2CAP_CFG_IN_SENT (1 << 2) /* L2CAP ConfigReq sent */ 138 #define L2CAP_CFG_OUT_SENT (1 << 3) /* ---/--- */ 139 140 /* L2CAP Information request type codes */ 141 #define L2CAP_CONNLESS_MTU 0x0001 142 #define L2CAP_EXTENDED_MASK 0x0002 143 /* 0x0003 - 0xffff - reserved for future use */ 144 145 /* L2CAP Information response codes */ 146 #define L2CAP_NOT_SUPPORTED 0x0001 147 /* 0x0002 - 0xffff - reserved for future use */ 148 149 /* L2CAP flow (QoS) */ 150 typedef struct { 151 uint8 flags; /* reserved for future use */ 152 uint8 service_type; /* service type */ 153 uint32 token_rate; /* bytes per second */ 154 uint32 token_bucket_size; /* bytes */ 155 uint32 peak_bandwidth; /* bytes per second */ 156 uint32 latency; /* microseconds */ 157 uint32 delay_variation; /* microseconds */ 158 } __attribute__ ((packed)) l2cap_flow_t; 159 160 161 /************************************************************************** 162 ************************************************************************** 163 ** Link level defines, headers and types 164 ************************************************************************** 165 **************************************************************************/ 166 167 /* L2CAP header */ 168 typedef struct { 169 uint16 length; /* payload size */ 170 uint16 dcid; /* destination channel ID */ 171 } __attribute__ ((packed)) l2cap_hdr_t; 172 173 174 /* L2CAP ConnectionLess Traffic (CLT) (if destination cid == 0x2) */ 175 typedef struct { 176 uint16 psm; /* Protocol/Service Multiplexor */ 177 } __attribute__ ((packed)) l2cap_clt_hdr_t; 178 179 #define L2CAP_CLT_MTU_MAXIMUM (L2CAP_MTU_MAXIMUM - sizeof(l2cap_clt_hdr_t)) 180 181 /* L2CAP command header */ 182 typedef struct { 183 uint8 code; /* command OpCode */ 184 uint8 ident; /* identifier to match request and response */ 185 uint16 length; /* command parameters length */ 186 } __attribute__ ((packed)) l2cap_cmd_hdr_t; 187 188 189 /* L2CAP Command Reject */ 190 #define L2CAP_CMD_REJ 0x01 191 typedef struct { 192 uint16 reason; /* reason to reject command */ 193 /* uint8 data[]; -- optional data (depends on reason) */ 194 } __attribute__ ((packed)) l2cap_cmd_rej_cp; 195 196 /* CommandReject data */ 197 typedef union { 198 /* L2CAP_REJ_MTU_EXCEEDED */ 199 struct { 200 uint16 mtu; /* actual signaling MTU */ 201 } __attribute__ ((packed)) mtu; 202 /* L2CAP_REJ_INVALID_CID */ 203 struct { 204 uint16 scid; /* local CID */ 205 uint16 dcid; /* remote CID */ 206 } __attribute__ ((packed)) cid; 207 } l2cap_cmd_rej_data_t; 208 typedef l2cap_cmd_rej_data_t * l2cap_cmd_rej_data_p; 209 210 /* L2CAP Connection Request */ 211 #define L2CAP_CON_REQ 0x02 212 typedef struct { 213 uint16 psm; /* Protocol/Service Multiplexor (PSM) */ 214 uint16 scid; /* source channel ID */ 215 } __attribute__ ((packed)) l2cap_con_req_cp; 216 217 /* L2CAP Connection Response */ 218 #define L2CAP_CON_RSP 0x03 219 typedef struct { 220 uint16 dcid; /* destination channel ID */ 221 uint16 scid; /* source channel ID */ 222 uint16 result; /* 0x00 - success */ 223 uint16 status; /* more info if result != 0x00 */ 224 } __attribute__ ((packed)) l2cap_con_rsp_cp; 225 226 /* L2CAP Configuration Request */ 227 #define L2CAP_CFG_REQ 0x04 228 typedef struct { 229 uint16 dcid; /* destination channel ID */ 230 uint16 flags; /* flags */ 231 /* uint8 options[] -- options */ 232 } __attribute__ ((packed)) l2cap_cfg_req_cp; 233 234 /* L2CAP Configuration Response */ 235 #define L2CAP_CFG_RSP 0x05 236 typedef struct { 237 uint16 scid; /* source channel ID */ 238 uint16 flags; /* flags */ 239 uint16 result; /* 0x00 - success */ 240 /* uint8 options[] -- options */ 241 } __attribute__ ((packed)) l2cap_cfg_rsp_cp; 242 243 /* L2CAP configuration option */ 244 typedef struct { 245 uint8 type; 246 uint8 length; 247 /* uint8 value[] -- option value (depends on type) */ 248 } __attribute__ ((packed)) l2cap_cfg_opt_t; 249 typedef l2cap_cfg_opt_t * l2cap_cfg_opt_p; 250 251 /* L2CAP configuration option value */ 252 typedef union { 253 uint16 mtu; /* L2CAP_OPT_MTU */ 254 uint16 flush_timo; /* L2CAP_OPT_FLUSH_TIMO */ 255 l2cap_flow_t flow; /* L2CAP_OPT_QOS */ 256 } l2cap_cfg_opt_val_t; 257 typedef l2cap_cfg_opt_val_t * l2cap_cfg_opt_val_p; 258 259 /* L2CAP Disconnect Request */ 260 #define L2CAP_DISCON_REQ 0x06 261 typedef struct { 262 uint16 dcid; /* destination channel ID */ 263 uint16 scid; /* source channel ID */ 264 } __attribute__ ((packed)) l2cap_discon_req_cp; 265 266 /* L2CAP Disconnect Response */ 267 #define L2CAP_DISCON_RSP 0x07 268 typedef l2cap_discon_req_cp l2cap_discon_rsp_cp; 269 270 /* L2CAP Echo Request */ 271 #define L2CAP_ECHO_REQ 0x08 272 /* No command parameters, only optional data */ 273 274 /* L2CAP Echo Response */ 275 #define L2CAP_ECHO_RSP 0x09 276 #define L2CAP_MAX_ECHO_SIZE \ 277 (L2CAP_MTU_MAXIMUM - sizeof(l2cap_cmd_hdr_t)) 278 /* No command parameters, only optional data */ 279 280 /* L2CAP Information Request */ 281 #define L2CAP_INFO_REQ 0x0a 282 typedef struct { 283 uint16 type; /* requested information type */ 284 } __attribute__ ((packed)) l2cap_info_req_cp; 285 286 /* L2CAP Information Response */ 287 #define L2CAP_INFO_RSP 0x0b 288 typedef struct { 289 uint16 type; /* requested information type */ 290 uint16 result; /* 0x00 - success */ 291 /* uint8 info[] -- info data (depends on type) 292 * 293 * L2CAP_CONNLESS_MTU - 2 bytes connectionless MTU 294 */ 295 } __attribute__ ((packed)) l2cap_info_rsp_cp; 296 297 #define IS_SIGNAL_REQ(code) ((code & 1) == 0) 298 #define IS_SIGNAL_RSP(code) ((code & 1) == 1) 299 300 301 typedef union { 302 /* L2CAP_CONNLESS_MTU */ 303 struct { 304 uint16 mtu; 305 } __attribute__ ((packed)) mtu; 306 } l2cap_info_rsp_data_t; 307 typedef l2cap_info_rsp_data_t * l2cap_info_rsp_data_p; 308 309 310 #endif 311 312