xref: /btstack/src/l2cap_signaling.c (revision bc37f7b0d0a3eaa5763a873c5730bc14b849aaa0)
1 /*
2  * Copyright (C) 2014 BlueKitchen GmbH
3  *
4  * Redistribution and use in source and binary forms, with or without
5  * modification, are permitted provided that the following conditions
6  * are met:
7  *
8  * 1. Redistributions of source code must retain the above copyright
9  *    notice, this list of conditions and the following disclaimer.
10  * 2. Redistributions in binary form must reproduce the above copyright
11  *    notice, this list of conditions and the following disclaimer in the
12  *    documentation and/or other materials provided with the distribution.
13  * 3. Neither the name of the copyright holders nor the names of
14  *    contributors may be used to endorse or promote products derived
15  *    from this software without specific prior written permission.
16  * 4. Any redistribution, use, or modification is done solely for
17  *    personal benefit and not for any commercial purpose or for
18  *    monetary gain.
19  *
20  * THIS SOFTWARE IS PROVIDED BY BLUEKITCHEN GMBH AND CONTRIBUTORS
21  * ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
22  * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
23  * FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL MATTHIAS
24  * RINGWALD OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
25  * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING,
26  * BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS
27  * OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED
28  * AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
29  * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF
30  * THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
31  * SUCH DAMAGE.
32  *
33  * Please inquire about commercial licensing options at
34  * [email protected]
35  *
36  */
37 
38 /*
39  *  l2cap_signaling.h
40  *
41  *  Created by Matthias Ringwald on 7/23/09.
42  */
43 
44 #include "l2cap_signaling.h"
45 #include "btstack_config.h"
46 #include "btstack_debug.h"
47 #include "hci.h"
48 
49 #include <string.h>
50 
51 static const char *l2cap_signaling_commands_format[] = {
52 "2D",    // 0x01 command reject: reason {cmd not understood (0), sig MTU exceeded (2:max sig MTU), invalid CID (4:req CID)}, data len, data
53 "22",    // 0x02 connection request: PSM, Source CID
54 "2222",  // 0x03 connection response: Dest CID, Source CID, Result, Status
55 "22D",   // 0x04 config request: Dest CID, Flags, Configuration options
56 "222D",  // 0x05 config response: Source CID, Flags, Result, Configuration options
57 "22",    // 0x06 disconection request: Dest CID, Source CID
58 "22",    // 0x07 disconection response: Dest CID, Source CID
59 "D",     // 0x08 echo request: Data
60 "D",     // 0x09 echo response: Data
61 "2",     // 0x0a information request: InfoType {1=Connectionless MTU, 2=Extended features supported}
62 "22D",   // 0x0b information response: InfoType, Result, Data
63 #ifdef ENABLE_BLE
64 NULL,    // 0x0c non-supported AMP command
65 NULL,    // 0x0d non-supported AMP command
66 NULL,    // 0x0e non-supported AMP command
67 NULL,    // 0x0f non-supported AMP command
68 NULL,    // 0x10 non-supported AMP command
69 NULL,    // 0x11 non-supported AMP command
70 "2222",  // 0x12 connection parameter update request: interval min, interval max, slave latency, timeout multipler
71 "2",     // 0x13 connection parameter update response: result
72 "22222", // 0X14 le credit based connection request: le psm, source cid, mtu, mps, initial credits
73 "22222", // 0x15 le credit based connection respone: dest cid, mtu, mps, initial credits, result
74 "22",    // 0x16 le flow control credit: source cid, credits
75 #endif
76 };
77 
78 static const int num_l2cap_commands = sizeof(l2cap_signaling_commands_format) / sizeof(const char *);
79 
80 uint8_t   sig_seq_nr  = 0xff;
81 uint16_t  source_cid  = 0x40;
82 
83 uint8_t l2cap_next_sig_id(void){
84     if (sig_seq_nr == 0xff) {
85         sig_seq_nr = 1;
86     } else {
87         sig_seq_nr++;
88     }
89     return sig_seq_nr;
90 }
91 
92 uint16_t l2cap_next_local_cid(void){
93     return source_cid++;
94 }
95 
96 static uint16_t l2cap_create_signaling_internal(uint8_t * acl_buffer, hci_con_handle_t handle, uint16_t cid, L2CAP_SIGNALING_COMMANDS cmd, uint8_t identifier, va_list argptr){
97 
98     const char *format = NULL;
99     if (cmd > 0 && cmd <= num_l2cap_commands) {
100         format = l2cap_signaling_commands_format[cmd-1];
101     }
102     if (!format){
103         log_error("l2cap_create_signaling_internal: invalid command id 0x%02x", cmd);
104         return 0;
105     }
106 
107     int pb = hci_non_flushable_packet_boundary_flag_supported() ? 0x00 : 0x02;
108 
109     // 0 - Connection handle : PB=pb : BC=00
110     little_endian_store_16(acl_buffer, 0, handle | (pb << 12) | (0 << 14));
111     // 6 - L2CAP channel = 1
112     little_endian_store_16(acl_buffer, 6, cid);
113     // 8 - Code
114     acl_buffer[8] = cmd;
115     // 9 - id (!= 0 sequentially)
116     acl_buffer[9] = identifier;
117 
118     // 12 - L2CAP signaling parameters
119     uint16_t pos = 12;
120     uint16_t word;
121     uint8_t * ptr;
122     while (*format) {
123         switch(*format) {
124             case '1': //  8 bit value
125             case '2': // 16 bit value
126                 word = va_arg(argptr, int);
127                 // minimal va_arg is int: 2 bytes on 8+16 bit CPUs
128                 acl_buffer[pos++] = word & 0xff;
129                 if (*format == '2') {
130                     acl_buffer[pos++] = word >> 8;
131                 }
132                 break;
133             case 'D': // variable data. passed: len, ptr
134                 word = va_arg(argptr, int);
135                 ptr  = va_arg(argptr, uint8_t *);
136                 memcpy(&acl_buffer[pos], ptr, word);
137                 pos += word;
138                 break;
139             default:
140                 break;
141         }
142         format++;
143     };
144     va_end(argptr);
145 
146     // Fill in various length fields: it's the number of bytes following for ACL lenght and l2cap parameter length
147     // - the l2cap payload length is counted after the following channel id (only payload)
148 
149     // 2 - ACL length
150     little_endian_store_16(acl_buffer, 2,  pos - 4);
151     // 4 - L2CAP packet length
152     little_endian_store_16(acl_buffer, 4,  pos - 6 - 2);
153     // 10 - L2CAP signaling parameter length
154     little_endian_store_16(acl_buffer, 10, pos - 12);
155 
156     return pos;
157 }
158 
159 uint16_t l2cap_create_signaling_classic(uint8_t * acl_buffer, hci_con_handle_t handle, L2CAP_SIGNALING_COMMANDS cmd, uint8_t identifier, va_list argptr){
160     return l2cap_create_signaling_internal(acl_buffer, handle, 1, cmd, identifier, argptr);
161 }
162 
163 #ifdef ENABLE_BLE
164 uint16_t l2cap_create_signaling_le(uint8_t * acl_buffer, hci_con_handle_t handle, L2CAP_SIGNALING_COMMANDS cmd, uint8_t identifier, va_list argptr){
165     return l2cap_create_signaling_internal(acl_buffer, handle, 5, cmd, identifier, argptr);
166 }
167 #endif
168