xref: /btstack/src/l2cap.h (revision 7740e150a789d1df1ef04c524d7a853e787ae0ff)
143625864Smatthias.ringwald /*
2a0c35809S[email protected]  * Copyright (C) 2014 BlueKitchen GmbH
31713bceaSmatthias.ringwald  *
41713bceaSmatthias.ringwald  * Redistribution and use in source and binary forms, with or without
51713bceaSmatthias.ringwald  * modification, are permitted provided that the following conditions
61713bceaSmatthias.ringwald  * are met:
71713bceaSmatthias.ringwald  *
81713bceaSmatthias.ringwald  * 1. Redistributions of source code must retain the above copyright
91713bceaSmatthias.ringwald  *    notice, this list of conditions and the following disclaimer.
101713bceaSmatthias.ringwald  * 2. Redistributions in binary form must reproduce the above copyright
111713bceaSmatthias.ringwald  *    notice, this list of conditions and the following disclaimer in the
121713bceaSmatthias.ringwald  *    documentation and/or other materials provided with the distribution.
131713bceaSmatthias.ringwald  * 3. Neither the name of the copyright holders nor the names of
141713bceaSmatthias.ringwald  *    contributors may be used to endorse or promote products derived
151713bceaSmatthias.ringwald  *    from this software without specific prior written permission.
166b64433eSmatthias.ringwald  * 4. Any redistribution, use, or modification is done solely for
176b64433eSmatthias.ringwald  *    personal benefit and not for any commercial purpose or for
186b64433eSmatthias.ringwald  *    monetary gain.
191713bceaSmatthias.ringwald  *
20a0c35809S[email protected]  * THIS SOFTWARE IS PROVIDED BY BLUEKITCHEN GMBH AND CONTRIBUTORS
211713bceaSmatthias.ringwald  * ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
221713bceaSmatthias.ringwald  * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
231713bceaSmatthias.ringwald  * FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL MATTHIAS
241713bceaSmatthias.ringwald  * RINGWALD OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
251713bceaSmatthias.ringwald  * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING,
261713bceaSmatthias.ringwald  * BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS
271713bceaSmatthias.ringwald  * OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED
281713bceaSmatthias.ringwald  * AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
291713bceaSmatthias.ringwald  * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF
301713bceaSmatthias.ringwald  * THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
311713bceaSmatthias.ringwald  * SUCH DAMAGE.
321713bceaSmatthias.ringwald  *
33a0c35809S[email protected]  * Please inquire about commercial licensing options at
34a0c35809S[email protected]  * [email protected]
356b64433eSmatthias.ringwald  *
361713bceaSmatthias.ringwald  */
371713bceaSmatthias.ringwald 
381713bceaSmatthias.ringwald /*
3943625864Smatthias.ringwald  *  l2cap.h
4043625864Smatthias.ringwald  *
413de95307SMilanka Ringwald  *  Logical Link Control and Adaption Protocol (L2CAP)
4243625864Smatthias.ringwald  *
4343625864Smatthias.ringwald  *  Created by Matthias Ringwald on 5/16/09.
4443625864Smatthias.ringwald  */
4543625864Smatthias.ringwald 
46f471afd8S[email protected] #ifndef __L2CAP_H
47f471afd8S[email protected] #define __L2CAP_H
48fd7ed8d4Smatthias.ringwald 
4943625864Smatthias.ringwald #include "hci.h"
5095cbd947Smatthias.ringwald #include "l2cap_signaling.h"
51eb886013SMatthias Ringwald #include "btstack_util.h"
52a8373a41SMatthias Ringwald #include "bluetooth.h"
53da269baaSmatthias.ringwald 
54e3b6fe7eSmatthias.ringwald #if defined __cplusplus
55e3b6fe7eSmatthias.ringwald extern "C" {
56e3b6fe7eSmatthias.ringwald #endif
57e3b6fe7eSmatthias.ringwald 
5823f5e709Smatthias.ringwald // check L2CAP MTU
59b5a7c9b3SMatthias Ringwald #ifdef ENABLE_CLASSIC
60b5a7c9b3SMatthias Ringwald #if (L2CAP_HEADER_SIZE + L2CAP_MINIMAL_MTU) > HCI_ACL_PAYLOAD_SIZE
61db9ab65bSmatthias.ringwald #error "HCI_ACL_PAYLOAD_SIZE too small for minimal L2CAP MTU of 48 bytes"
6223f5e709Smatthias.ringwald #endif
63b5a7c9b3SMatthias Ringwald #endif
64b5a7c9b3SMatthias Ringwald #ifdef ENABLE_BLE
65b5a7c9b3SMatthias Ringwald #if (L2CAP_HEADER_SIZE + L2CAP_LE_DEFAULT_MTU) > HCI_ACL_PAYLOAD_SIZE
66b5a7c9b3SMatthias Ringwald #error "HCI_ACL_PAYLOAD_SIZE too small for minimal L2CAP LE MTU of 23 bytes"
67b5a7c9b3SMatthias Ringwald #endif
68b5a7c9b3SMatthias Ringwald #endif
6923f5e709Smatthias.ringwald 
70ee913607SMatthias Ringwald #define L2CAP_LE_AUTOMATIC_CREDITS 0xffff
71ee913607SMatthias Ringwald 
7273cf2b3dSmatthias.ringwald // private structs
7373cf2b3dSmatthias.ringwald typedef enum {
7473cf2b3dSmatthias.ringwald     L2CAP_STATE_CLOSED = 1,           // no baseband
7573cf2b3dSmatthias.ringwald     L2CAP_STATE_WILL_SEND_CREATE_CONNECTION,
7673cf2b3dSmatthias.ringwald     L2CAP_STATE_WAIT_CONNECTION_COMPLETE,
77df3354fcS[email protected]     L2CAP_STATE_WAIT_REMOTE_SUPPORTED_FEATURES,
78df3354fcS[email protected]     L2CAP_STATE_WAIT_INCOMING_SECURITY_LEVEL_UPDATE,
79df3354fcS[email protected]     L2CAP_STATE_WAIT_OUTGOING_SECURITY_LEVEL_UPDATE,
8052606043SMatthias Ringwald     L2CAP_STATE_WAIT_INCOMING_EXTENDED_FEATURES,    // only for Enhanced Retransmission Mode
811b9cb13dSMatthias Ringwald     L2CAP_STATE_WAIT_OUTGOING_EXTENDED_FEATURES,    // only for Enhanced Retransmission Mode
8273cf2b3dSmatthias.ringwald     L2CAP_STATE_WAIT_CLIENT_ACCEPT_OR_REJECT,
8373cf2b3dSmatthias.ringwald     L2CAP_STATE_WAIT_CONNECT_RSP, // from peer
8473cf2b3dSmatthias.ringwald     L2CAP_STATE_CONFIG,
8573cf2b3dSmatthias.ringwald     L2CAP_STATE_OPEN,
8673cf2b3dSmatthias.ringwald     L2CAP_STATE_WAIT_DISCONNECT,  // from application
8773cf2b3dSmatthias.ringwald     L2CAP_STATE_WILL_SEND_CONNECTION_REQUEST,
88f85a9399S[email protected]     L2CAP_STATE_WILL_SEND_CONNECTION_RESPONSE_INSUFFICIENT_SECURITY,
8973cf2b3dSmatthias.ringwald     L2CAP_STATE_WILL_SEND_CONNECTION_RESPONSE_DECLINE,
9073cf2b3dSmatthias.ringwald     L2CAP_STATE_WILL_SEND_CONNECTION_RESPONSE_ACCEPT,
9173cf2b3dSmatthias.ringwald     L2CAP_STATE_WILL_SEND_DISCONNECT_REQUEST,
9273cf2b3dSmatthias.ringwald     L2CAP_STATE_WILL_SEND_DISCONNECT_RESPONSE,
935cb87675SMatthias Ringwald     L2CAP_STATE_WILL_SEND_LE_CONNECTION_REQUEST,
94ae237d31SMatthias Ringwald     L2CAP_STATE_WILL_SEND_LE_CONNECTION_RESPONSE_DECLINE,
95ae237d31SMatthias Ringwald     L2CAP_STATE_WILL_SEND_LE_CONNECTION_RESPONSE_ACCEPT,
965cb87675SMatthias Ringwald     L2CAP_STATE_WAIT_LE_CONNECTION_RESPONSE,
97ceec418aSMatthias Ringwald     L2CAP_STATE_EMIT_OPEN_FAILED_AND_DISCARD,
9822c29ab4SMatthias Ringwald     L2CAP_STATE_INVALID,
9973cf2b3dSmatthias.ringwald } L2CAP_STATE;
10073cf2b3dSmatthias.ringwald 
10173cf2b3dSmatthias.ringwald typedef enum {
10273cf2b3dSmatthias.ringwald     L2CAP_CHANNEL_STATE_VAR_NONE                   = 0,
10373cf2b3dSmatthias.ringwald     L2CAP_CHANNEL_STATE_VAR_RCVD_CONF_REQ          = 1 << 0,
10473cf2b3dSmatthias.ringwald     L2CAP_CHANNEL_STATE_VAR_RCVD_CONF_RSP          = 1 << 1,
10573cf2b3dSmatthias.ringwald     L2CAP_CHANNEL_STATE_VAR_SEND_CONF_REQ          = 1 << 2,
10673cf2b3dSmatthias.ringwald     L2CAP_CHANNEL_STATE_VAR_SEND_CONF_RSP          = 1 << 3,
10773cf2b3dSmatthias.ringwald     L2CAP_CHANNEL_STATE_VAR_SENT_CONF_REQ          = 1 << 4,
10873cf2b3dSmatthias.ringwald     L2CAP_CHANNEL_STATE_VAR_SENT_CONF_RSP          = 1 << 5,
10963a7246aSmatthias.ringwald     L2CAP_CHANNEL_STATE_VAR_SEND_CONF_RSP_MTU      = 1 << 6,   // in CONF RSP, add MTU field
11063a7246aSmatthias.ringwald     L2CAP_CHANNEL_STATE_VAR_SEND_CONF_RSP_CONT     = 1 << 7,   // in CONF RSP, set CONTINUE flag
11163a7246aSmatthias.ringwald     L2CAP_CHANNEL_STATE_VAR_SEND_CONF_RSP_INVALID  = 1 << 8,   // in CONF RSP, send UNKNOWN OPTIONS
112ac8f1300SMatthias Ringwald     L2CAP_CHANNEL_STATE_VAR_SEND_CONF_RSP_REJECTED = 1 << 9,   // in CONF RSP, send Unacceptable Parameters (ERTM)
113ac8f1300SMatthias Ringwald     L2CAP_CHANNEL_STATE_VAR_BASIC_FALLBACK_TRIED   = 1 << 10,  // set when ERTM was requested but we want only Basic mode (ERM)
114ac8f1300SMatthias Ringwald     L2CAP_CHANNEL_STATE_VAR_SEND_CMD_REJ_UNKNOWN   = 1 << 11,  // send CMD_REJ with reason unknown
115ac8f1300SMatthias Ringwald     L2CAP_CHANNEL_STATE_VAR_SEND_CONN_RESP_PEND    = 1 << 12,  // send Connection Respond with pending
116c99bb618SMatthias Ringwald     L2CAP_CHANNEL_STATE_VAR_INCOMING               = 1 << 15,  // channel is incoming
11773cf2b3dSmatthias.ringwald } L2CAP_CHANNEL_STATE_VAR;
11873cf2b3dSmatthias.ringwald 
1195d18f623SMatthias Ringwald typedef enum {
120fad84cafSMatthias Ringwald     L2CAP_CHANNEL_TYPE_CLASSIC,         // Classic Basic or ERTM
121*7740e150SMatthias Ringwald     L2CAP_CHANNEL_TYPE_CONNECTIONLESS,  // Classic Connectionless
122fad84cafSMatthias Ringwald     L2CAP_CHANNEL_TYPE_LE_DATA_CHANNEL, // LE
123*7740e150SMatthias Ringwald     L2CAP_CHANNEL_TYPE_LE_FIXED,        // LE ATT + SM
1245d18f623SMatthias Ringwald } l2cap_channel_type_t;
1255d18f623SMatthias Ringwald 
1267b181629SMatthias Ringwald typedef struct {
127e8e9809fSMatthias Ringwald     l2cap_segmentation_and_reassembly_t sar;
128e8e9809fSMatthias Ringwald     uint16_t len;
129e32be409SMatthias Ringwald     uint8_t  valid;
1307b181629SMatthias Ringwald } l2cap_ertm_rx_packet_state_t;
1317b181629SMatthias Ringwald 
1327b181629SMatthias Ringwald typedef struct {
13382bb0e22SMatthias Ringwald     l2cap_segmentation_and_reassembly_t sar;
134f0fb4cd7SMatthias Ringwald     uint16_t len;
135db55d2e9SMatthias Ringwald     uint8_t tx_seq;
136db55d2e9SMatthias Ringwald     uint8_t retry_count;
1377b7901d8SMatthias Ringwald     uint8_t retransmission_requested;
1387b181629SMatthias Ringwald } l2cap_ertm_tx_packet_state_t;
1397b181629SMatthias Ringwald 
1409c0e62d3SMatthias Ringwald typedef struct {
1419c0e62d3SMatthias Ringwald     // If not mandatory, the use of ERTM can be decided by the remote
1429c0e62d3SMatthias Ringwald     uint8_t  ertm_mandatory;
1439c0e62d3SMatthias Ringwald 
1449c0e62d3SMatthias Ringwald     // Number of retransmissions that L2CAP is allowed to try before accepting that a packet and the channel is lost.
1459c0e62d3SMatthias Ringwald     uint8_t  max_transmit;
1469c0e62d3SMatthias Ringwald 
1479c0e62d3SMatthias Ringwald     // time before retransmission of i-frame / Recommended : 2000 ms (ACL Flush timeout not used)
1489c0e62d3SMatthias Ringwald     uint16_t retransmission_timeout_ms;
1499c0e62d3SMatthias Ringwald 
1509c0e62d3SMatthias Ringwald     // time after withc s-frames are sent / Recommended: 12000 ms (ACL Flush timeout not used)
1519c0e62d3SMatthias Ringwald     uint16_t monitor_timeout_ms;
1529c0e62d3SMatthias Ringwald 
1539c0e62d3SMatthias Ringwald     // MTU for incoming SDUs
1549c0e62d3SMatthias Ringwald     uint16_t local_mtu;
1559c0e62d3SMatthias Ringwald 
1569c0e62d3SMatthias Ringwald     // Number of buffers for outgoing data
1579c0e62d3SMatthias Ringwald     uint8_t num_tx_buffers;
1589c0e62d3SMatthias Ringwald 
1599c0e62d3SMatthias Ringwald     // Number of packets that can be received out of order (-> our tx_window size)
1609c0e62d3SMatthias Ringwald     uint8_t num_rx_buffers;
1619c0e62d3SMatthias Ringwald 
1629c0e62d3SMatthias Ringwald } l2cap_ertm_config_t;
1637b181629SMatthias Ringwald 
164fad84cafSMatthias Ringwald // info regarding an actual channel
165fad84cafSMatthias Ringwald // note: l2cap_fixed_channel and l2cap_channel_t share commmon fields
166fad84cafSMatthias Ringwald 
167fad84cafSMatthias Ringwald typedef struct l2cap_fixed_channel {
16873cf2b3dSmatthias.ringwald     // linked list - assert: first field
169665d90f2SMatthias Ringwald     btstack_linked_item_t    item;
17073cf2b3dSmatthias.ringwald 
171fad84cafSMatthias Ringwald     // channel type
172fad84cafSMatthias Ringwald     l2cap_channel_type_t channel_type;
173fad84cafSMatthias Ringwald 
174fad84cafSMatthias Ringwald     // local cid, primary key for channel lookup
175fad84cafSMatthias Ringwald     uint16_t  local_cid;
176fad84cafSMatthias Ringwald 
17733c40538SMatthias Ringwald     // packet handler
17833c40538SMatthias Ringwald     btstack_packet_handler_t packet_handler;
17933c40538SMatthias Ringwald 
180fad84cafSMatthias Ringwald     // send request
181fad84cafSMatthias Ringwald     uint8_t waiting_for_can_send_now;
182fad84cafSMatthias Ringwald 
183fad84cafSMatthias Ringwald     // -- end of shared prefix
184fad84cafSMatthias Ringwald 
185fad84cafSMatthias Ringwald } l2cap_fixed_channel_t;
186fad84cafSMatthias Ringwald 
187fad84cafSMatthias Ringwald typedef struct {
188fad84cafSMatthias Ringwald     // linked list - assert: first field
189fad84cafSMatthias Ringwald     btstack_linked_item_t    item;
190fad84cafSMatthias Ringwald 
1915d18f623SMatthias Ringwald     // channel type
1925d18f623SMatthias Ringwald     l2cap_channel_type_t channel_type;
1935d18f623SMatthias Ringwald 
194fad84cafSMatthias Ringwald     // local cid, primary key for channel lookup
195fad84cafSMatthias Ringwald     uint16_t  local_cid;
196fad84cafSMatthias Ringwald 
197fad84cafSMatthias Ringwald     // packet handler
198fad84cafSMatthias Ringwald     btstack_packet_handler_t packet_handler;
199fad84cafSMatthias Ringwald 
200fad84cafSMatthias Ringwald     // send request
201fad84cafSMatthias Ringwald     uint8_t   waiting_for_can_send_now;
202fad84cafSMatthias Ringwald 
203fad84cafSMatthias Ringwald     // -- end of shared prefix
204fad84cafSMatthias Ringwald 
20533c40538SMatthias Ringwald     // timer
20633c40538SMatthias Ringwald     btstack_timer_source_t rtx; // also used for ertx
20733c40538SMatthias Ringwald 
20873cf2b3dSmatthias.ringwald     L2CAP_STATE state;
20973cf2b3dSmatthias.ringwald     L2CAP_CHANNEL_STATE_VAR state_var;
21073cf2b3dSmatthias.ringwald 
21133c40538SMatthias Ringwald     // info
212fc64f94aSMatthias Ringwald     hci_con_handle_t con_handle;
21373cf2b3dSmatthias.ringwald 
214da144af5SMatthias Ringwald     bd_addr_t address;
215da144af5SMatthias Ringwald     bd_addr_type_t address_type;
216da144af5SMatthias Ringwald 
21773cf2b3dSmatthias.ringwald     uint8_t   remote_sig_id;    // used by other side, needed for delayed response
21873cf2b3dSmatthias.ringwald     uint8_t   local_sig_id;     // own signaling identifier
21973cf2b3dSmatthias.ringwald 
22073cf2b3dSmatthias.ringwald     uint16_t  remote_cid;
22173cf2b3dSmatthias.ringwald 
22273cf2b3dSmatthias.ringwald     uint16_t  local_mtu;
22373cf2b3dSmatthias.ringwald     uint16_t  remote_mtu;
22473cf2b3dSmatthias.ringwald 
225c9dc710bS[email protected]     uint16_t  flush_timeout;    // default 0xffff
226c9dc710bS[email protected] 
22773cf2b3dSmatthias.ringwald     uint16_t  psm;
22873cf2b3dSmatthias.ringwald 
2291eb2563eS[email protected]     gap_security_level_t required_security_level;
2301eb2563eS[email protected] 
23173cf2b3dSmatthias.ringwald     uint8_t   reason; // used in decline internal
23273cf2b3dSmatthias.ringwald 
233efedfb4cSMatthias Ringwald     // LE Data Channels
234efedfb4cSMatthias Ringwald 
2357f107edaSMatthias Ringwald     // incoming SDU
236efedfb4cSMatthias Ringwald     uint8_t * receive_sdu_buffer;
237cd529728SMatthias Ringwald     uint16_t  receive_sdu_len;
238cd529728SMatthias Ringwald     uint16_t  receive_sdu_pos;
239efedfb4cSMatthias Ringwald 
2407f107edaSMatthias Ringwald     // outgoing SDU
2417f107edaSMatthias Ringwald     uint8_t  * send_sdu_buffer;
2427f107edaSMatthias Ringwald     uint16_t   send_sdu_len;
2437f107edaSMatthias Ringwald     uint16_t   send_sdu_pos;
2447f107edaSMatthias Ringwald 
245efedfb4cSMatthias Ringwald     // max PDU size
246efedfb4cSMatthias Ringwald     uint16_t  remote_mps;
247efedfb4cSMatthias Ringwald 
248da144af5SMatthias Ringwald     // credits for outgoing traffic
249efedfb4cSMatthias Ringwald     uint16_t credits_outgoing;
250da144af5SMatthias Ringwald 
251da144af5SMatthias Ringwald     // number of packets remote will be granted
252efedfb4cSMatthias Ringwald     uint16_t new_credits_incoming;
253da144af5SMatthias Ringwald 
254da144af5SMatthias Ringwald     // credits for incoming traffic
255efedfb4cSMatthias Ringwald     uint16_t credits_incoming;
256da144af5SMatthias Ringwald 
257ee913607SMatthias Ringwald     // automatic credits incoming
258ee913607SMatthias Ringwald     uint16_t automatic_credits;
259ee913607SMatthias Ringwald 
26043ec931dSMatthias Ringwald #ifdef ENABLE_L2CAP_ENHANCED_RETRANSMISSION_MODE
261af3e22a3SMatthias Ringwald 
26243ec931dSMatthias Ringwald     // l2cap channel mode: basic or enhanced retransmission mode
26343ec931dSMatthias Ringwald     l2cap_channel_mode_t mode;
26485ddcd84SMatthias Ringwald 
265af3e22a3SMatthias Ringwald     // local mps = size of rx/tx buffers
266af3e22a3SMatthias Ringwald     uint16_t local_mps;
267af3e22a3SMatthias Ringwald 
268c9300dcaSMatthias Ringwald     // retransmission timer
269c9300dcaSMatthias Ringwald     btstack_timer_source_t retransmission_timer;
270c9300dcaSMatthias Ringwald 
271c9300dcaSMatthias Ringwald     // monitor timer
272c9300dcaSMatthias Ringwald     btstack_timer_source_t monitor_timer;
273c9300dcaSMatthias Ringwald 
274bbc0a9e7SMatthias Ringwald     // local/remote config options
275bbc0a9e7SMatthias Ringwald     uint16_t local_retransmission_timeout_ms;
276bbc0a9e7SMatthias Ringwald     uint16_t local_monitor_timeout_ms;
2777b181629SMatthias Ringwald 
278bbc0a9e7SMatthias Ringwald     uint16_t remote_retransmission_timeout_ms;
279bbc0a9e7SMatthias Ringwald     uint16_t remote_monitor_timeout_ms;
280bbc0a9e7SMatthias Ringwald 
281bbc0a9e7SMatthias Ringwald     uint8_t remote_tx_window_size;
282bbc0a9e7SMatthias Ringwald 
283bbc0a9e7SMatthias Ringwald     uint8_t local_max_transmit;
284bbc0a9e7SMatthias Ringwald     uint8_t remote_max_transmit;
2857b181629SMatthias Ringwald 
286d84e866fSMatthias Ringwald     // if ertm is not mandatory, allow fallback to L2CAP Basic Mode - flag
287d4016dacSMatthias Ringwald     uint8_t ertm_mandatory;
28885ddcd84SMatthias Ringwald 
2896574158aSMatthias Ringwald     // Frame Chech Sequence (crc16) is present in both directions
2906574158aSMatthias Ringwald     uint8_t fcs_option;
2916574158aSMatthias Ringwald 
292af3e22a3SMatthias Ringwald     // sender: max num of stored outgoing frames
293af3e22a3SMatthias Ringwald     uint8_t num_tx_buffers;
294af3e22a3SMatthias Ringwald 
29594301352SMatthias Ringwald     // sender: number of unacknowledeged I-Frames - frames have been sent, but not acknowledged yet
29694301352SMatthias Ringwald     uint8_t unacked_frames;
29794301352SMatthias Ringwald 
298675e6881SMatthias Ringwald     // sender: buffer index of oldest packet
299675e6881SMatthias Ringwald     uint8_t tx_read_index;
300675e6881SMatthias Ringwald 
301675e6881SMatthias Ringwald     // sender: buffer index to store next tx packet
302f0fb4cd7SMatthias Ringwald     uint8_t tx_write_index;
303f0fb4cd7SMatthias Ringwald 
304f0fb4cd7SMatthias Ringwald     // sender: buffer index of packet to send next
305675e6881SMatthias Ringwald     uint8_t tx_send_index;
306d84e866fSMatthias Ringwald 
30738f62777SMatthias Ringwald     // sender: next seq nr used for sending
30885ddcd84SMatthias Ringwald     uint8_t next_tx_seq;
3097b181629SMatthias Ringwald 
3107b7901d8SMatthias Ringwald     // sender: selective retransmission requested
3117b7901d8SMatthias Ringwald     uint8_t srej_active;
3127b7901d8SMatthias Ringwald 
313af3e22a3SMatthias Ringwald 
314af3e22a3SMatthias Ringwald     // receiver: max num out-of-order packets // tx_window
315af3e22a3SMatthias Ringwald     uint8_t num_rx_buffers;
316af3e22a3SMatthias Ringwald 
317af3e22a3SMatthias Ringwald     // receiver: buffer index of to store packet with delta = 1
318af3e22a3SMatthias Ringwald     uint8_t rx_store_index;
319af3e22a3SMatthias Ringwald 
320af3e22a3SMatthias Ringwald     // receiver: value of tx_seq in next expected i-frame
321af3e22a3SMatthias Ringwald     uint8_t expected_tx_seq;
322af3e22a3SMatthias Ringwald 
323af3e22a3SMatthias Ringwald     // receiver: request transmission with tx_seq = req_seq and ack up to and including req_seq
324af3e22a3SMatthias Ringwald     uint8_t req_seq;
325af3e22a3SMatthias Ringwald 
326af3e22a3SMatthias Ringwald     // receiver: local busy condition
327af3e22a3SMatthias Ringwald     uint8_t local_busy;
328af3e22a3SMatthias Ringwald 
329d2afdd38SMatthias Ringwald     // receiver: send RR frame with optional final flag set - flag
330f0fb4cd7SMatthias Ringwald     uint8_t send_supervisor_frame_receiver_ready;
331f0fb4cd7SMatthias Ringwald 
33262041d70SMatthias Ringwald     // receiver: send RR frame with poll bit set
33362041d70SMatthias Ringwald     uint8_t send_supervisor_frame_receiver_ready_poll;
33462041d70SMatthias Ringwald 
3358f1c9639SMatthias Ringwald     // receiver: send RNR frame - flag
3368f1c9639SMatthias Ringwald     uint8_t send_supervisor_frame_receiver_not_ready;
3378f1c9639SMatthias Ringwald 
338c7309e8dSMatthias Ringwald     // receiver: send REJ frame - flag
339c7309e8dSMatthias Ringwald     uint8_t send_supervisor_frame_reject;
340c7309e8dSMatthias Ringwald 
341df2191a7SMatthias Ringwald     // receiver: send SREJ frame - flag
342df2191a7SMatthias Ringwald     uint8_t send_supervisor_frame_selective_reject;
343df2191a7SMatthias Ringwald 
344d2afdd38SMatthias Ringwald     // set final bit after poll packet with poll bit was received
345d2afdd38SMatthias Ringwald     uint8_t set_final_bit_after_packet_with_poll_bit_set;
346d2afdd38SMatthias Ringwald 
347af3e22a3SMatthias Ringwald     // receiver: meta data for out-of-order frames
3487b181629SMatthias Ringwald     l2cap_ertm_rx_packet_state_t * rx_packets_state;
3497b181629SMatthias Ringwald 
350af3e22a3SMatthias Ringwald     // sender: retransmission state
3517b181629SMatthias Ringwald     l2cap_ertm_tx_packet_state_t * tx_packets_state;
3527b181629SMatthias Ringwald 
353af3e22a3SMatthias Ringwald     // receiver: reassemly pos
354af3e22a3SMatthias Ringwald     uint16_t reassembly_pos;
355af3e22a3SMatthias Ringwald 
356af3e22a3SMatthias Ringwald     // receiver: reassemly sdu length
357af3e22a3SMatthias Ringwald     uint16_t reassembly_sdu_length;
358af3e22a3SMatthias Ringwald 
359af3e22a3SMatthias Ringwald     // receiver: eassembly buffer
360843bae5dSMatthias Ringwald     uint8_t * reassembly_buffer;
361843bae5dSMatthias Ringwald 
362af3e22a3SMatthias Ringwald     // receiver: num_rx_buffers of size local_mps
3637b181629SMatthias Ringwald     uint8_t * rx_packets_data;
3647b181629SMatthias Ringwald 
365af3e22a3SMatthias Ringwald     // sender: num_tx_buffers of size local_mps
3667b181629SMatthias Ringwald     uint8_t * tx_packets_data;
367843bae5dSMatthias Ringwald 
36843ec931dSMatthias Ringwald #endif
36973cf2b3dSmatthias.ringwald } l2cap_channel_t;
37073cf2b3dSmatthias.ringwald 
37173cf2b3dSmatthias.ringwald // info regarding potential connections
37273cf2b3dSmatthias.ringwald typedef struct {
37373cf2b3dSmatthias.ringwald     // linked list - assert: first field
374665d90f2SMatthias Ringwald     btstack_linked_item_t    item;
37573cf2b3dSmatthias.ringwald 
37673cf2b3dSmatthias.ringwald     // service id
37773cf2b3dSmatthias.ringwald     uint16_t  psm;
37873cf2b3dSmatthias.ringwald 
37973cf2b3dSmatthias.ringwald     // incoming MTU
38073cf2b3dSmatthias.ringwald     uint16_t mtu;
38173cf2b3dSmatthias.ringwald 
38273cf2b3dSmatthias.ringwald     // internal connection
38373cf2b3dSmatthias.ringwald     btstack_packet_handler_t packet_handler;
38473cf2b3dSmatthias.ringwald 
385ad671560S[email protected]     // required security level
386df3354fcS[email protected]     gap_security_level_t required_security_level;
387da144af5SMatthias Ringwald 
38873cf2b3dSmatthias.ringwald } l2cap_service_t;
38973cf2b3dSmatthias.ringwald 
39073cf2b3dSmatthias.ringwald 
39173cf2b3dSmatthias.ringwald typedef struct l2cap_signaling_response {
39273cf2b3dSmatthias.ringwald     hci_con_handle_t handle;
39373cf2b3dSmatthias.ringwald     uint8_t  sig_id;
39473cf2b3dSmatthias.ringwald     uint8_t  code;
395e74c5f58SMatthias Ringwald     uint16_t cid;  // source cid for CONNECTION REQUEST
396e74c5f58SMatthias Ringwald     uint16_t data; // infoType for INFORMATION REQUEST, result for CONNECTION REQUEST and COMMAND UNKNOWN
39773cf2b3dSmatthias.ringwald } l2cap_signaling_response_t;
39873cf2b3dSmatthias.ringwald 
39973cf2b3dSmatthias.ringwald 
400f2924d79SMatthias Ringwald void l2cap_register_fixed_channel(btstack_packet_handler_t packet_handler, uint16_t channel_id);
401fc64f94aSMatthias Ringwald int  l2cap_can_send_fixed_channel_packet_now(hci_con_handle_t con_handle, uint16_t channel_id);
4020b9d7e78SMatthias Ringwald void l2cap_request_can_send_fix_channel_now_event(hci_con_handle_t con_handle, uint16_t channel_id);
403fc64f94aSMatthias Ringwald int  l2cap_send_connectionless(hci_con_handle_t con_handle, uint16_t cid, uint8_t *data, uint16_t len);
404fc64f94aSMatthias Ringwald int  l2cap_send_prepared_connectionless(hci_con_handle_t con_handle, uint16_t cid, uint16_t len);
4056cd4da6bS[email protected] 
406f2924d79SMatthias Ringwald // PTS Testing
407fc64f94aSMatthias Ringwald int l2cap_send_echo_request(hci_con_handle_t con_handle, uint8_t *data, uint16_t len);
408f2924d79SMatthias Ringwald void l2cap_require_security_level_2_for_outgoing_sdp(void);
409ac301f95S[email protected] 
4107d34cb71SMatthias Ringwald // Used by RFCOMM - similar to l2cap_can-send_packet_now but does not check if outgoing buffer is reserved
4117d34cb71SMatthias Ringwald int  l2cap_can_send_prepared_packet_now(uint16_t local_cid);
4127d34cb71SMatthias Ringwald 
4135e6d58c4SMilanka Ringwald /* API_START */
414e6cc8be2S[email protected] 
4153de95307SMilanka Ringwald /**
4163de95307SMilanka Ringwald  * @brief Set up L2CAP and register L2CAP with HCI layer.
4173de95307SMilanka Ringwald  */
418e6cc8be2S[email protected] void l2cap_init(void);
419e6cc8be2S[email protected] 
4203de95307SMilanka Ringwald /**
4217298da47SMatthias Ringwald  * @brief Registers packet handler for LE Connection Parameter Update events
4223de95307SMilanka Ringwald  */
423ffbf8201SMatthias Ringwald void l2cap_register_packet_handler(void (*handler)(uint8_t packet_type, uint16_t channel, uint8_t *packet, uint16_t size));
424e6cc8be2S[email protected] 
4253de95307SMilanka Ringwald /**
426f2924d79SMatthias Ringwald  * @brief Get max MTU for Classic connections based on btstack configuration
427f2924d79SMatthias Ringwald  */
428f2924d79SMatthias Ringwald uint16_t l2cap_max_mtu(void);
429f2924d79SMatthias Ringwald 
430f2924d79SMatthias Ringwald /**
431f2924d79SMatthias Ringwald  * @brief Get max MTU for LE connections based on btstack configuration
432f2924d79SMatthias Ringwald  */
433f2924d79SMatthias Ringwald uint16_t l2cap_max_le_mtu(void);
434f2924d79SMatthias Ringwald 
435f2924d79SMatthias Ringwald /**
43625818320SMatthias Ringwald * @brief Set the max MTU for LE connections, if not set l2cap_max_mtu() will be used.
43725818320SMatthias Ringwald */
43825818320SMatthias Ringwald void l2cap_set_max_le_mtu(uint16_t max_mtu);
43925818320SMatthias Ringwald 
44025818320SMatthias Ringwald /**
4413de95307SMilanka Ringwald  * @brief Creates L2CAP channel to the PSM of a remote device with baseband address. A new baseband connection will be initiated if necessary.
4429077cb15SMatthias Ringwald  * @param packet_handler
4439077cb15SMatthias Ringwald  * @param address
4449077cb15SMatthias Ringwald  * @param psm
4459077cb15SMatthias Ringwald  * @param mtu
4469077cb15SMatthias Ringwald  * @param local_cid
447a23045e2SMilanka Ringwald  * @return status
4483de95307SMilanka Ringwald  */
4499077cb15SMatthias Ringwald uint8_t l2cap_create_channel(btstack_packet_handler_t packet_handler, bd_addr_t address, uint16_t psm, uint16_t mtu, uint16_t * out_local_cid);
450e6cc8be2S[email protected] 
4513de95307SMilanka Ringwald /**
4521b9cb13dSMatthias Ringwald  * @brief Creates L2CAP channel to the PSM of a remote device with baseband address using Enhanced Retransmission Mode.
4531b9cb13dSMatthias Ringwald  *        A new baseband connection will be initiated if necessary.
4541b9cb13dSMatthias Ringwald  * @param packet_handler
4551b9cb13dSMatthias Ringwald  * @param address
4561b9cb13dSMatthias Ringwald  * @param psm
4579c0e62d3SMatthias Ringwald  * @param ertm_config
458843bae5dSMatthias Ringwald  * @param buffer to store reassembled rx packet, out-of-order packets and unacknowledged outgoing packets with their tretransmission timers
459501329faSMatthias Ringwald  * @param size of buffer
4601b9cb13dSMatthias Ringwald  * @param local_cid
4611b9cb13dSMatthias Ringwald  * @return status
4621b9cb13dSMatthias Ringwald  */
463501329faSMatthias Ringwald uint8_t l2cap_create_ertm_channel(btstack_packet_handler_t packet_handler, bd_addr_t address, uint16_t psm,
4649c0e62d3SMatthias Ringwald     l2cap_ertm_config_t * ertm_contig, uint8_t * buffer, uint32_t size, uint16_t * out_local_cid);
4651b9cb13dSMatthias Ringwald 
4661b9cb13dSMatthias Ringwald /**
4673de95307SMilanka Ringwald  * @brief Disconnects L2CAP channel with given identifier.
4683de95307SMilanka Ringwald  */
469ce8f182eSMatthias Ringwald void l2cap_disconnect(uint16_t local_cid, uint8_t reason);
470e6cc8be2S[email protected] 
4713de95307SMilanka Ringwald /**
4723de95307SMilanka Ringwald  * @brief Queries the maximal transfer unit (MTU) for L2CAP channel with given identifier.
4733de95307SMilanka Ringwald  */
474e6cc8be2S[email protected] uint16_t l2cap_get_remote_mtu_for_local_cid(uint16_t local_cid);
475e6cc8be2S[email protected] 
4763de95307SMilanka Ringwald /**
4773de95307SMilanka Ringwald  * @brief Sends L2CAP data packet to the channel with given identifier.
4783de95307SMilanka Ringwald  */
479ce8f182eSMatthias Ringwald int l2cap_send(uint16_t local_cid, uint8_t *data, uint16_t len);
480e6cc8be2S[email protected] 
4813de95307SMilanka Ringwald /**
482be2053a6SMatthias Ringwald  * @brief Registers L2CAP service with given PSM and MTU, and assigns a packet handler.
4833de95307SMilanka Ringwald  */
484be2053a6SMatthias Ringwald uint8_t l2cap_register_service(btstack_packet_handler_t packet_handler, uint16_t psm, uint16_t mtu, gap_security_level_t security_level);
485e6cc8be2S[email protected] 
4863de95307SMilanka Ringwald /**
48743ec931dSMatthias Ringwald  * @brief Unregisters L2CAP service with given PSM.
4883de95307SMilanka Ringwald  */
4897e8856ebSMatthias Ringwald uint8_t l2cap_unregister_service(uint16_t psm);
490e6cc8be2S[email protected] 
4913de95307SMilanka Ringwald /**
492f2924d79SMatthias Ringwald  * @brief Accepts incoming L2CAP connection.
4933de95307SMilanka Ringwald  */
494ce8f182eSMatthias Ringwald void l2cap_accept_connection(uint16_t local_cid);
495f2924d79SMatthias Ringwald 
496f2924d79SMatthias Ringwald /**
49743ec931dSMatthias Ringwald  * @brief Accepts incoming L2CAP connection for Enhanced Retransmission Mode
4989c0e62d3SMatthias Ringwald  * @param local_cid
4999c0e62d3SMatthias Ringwald  * @param ertm_config
500843bae5dSMatthias Ringwald  * @param buffer to store reassembled rx packet, out-of-order packets and unacknowledged outgoing packets with their tretransmission timers
501501329faSMatthias Ringwald  * @param size of buffer
5022b70d705SMatthias Ringwald  * @return status
50343ec931dSMatthias Ringwald  */
5049c0e62d3SMatthias Ringwald uint8_t l2cap_accept_ertm_connection(uint16_t local_cid, l2cap_ertm_config_t * ertm_contig, uint8_t * buffer, uint32_t size);
50543ec931dSMatthias Ringwald 
50643ec931dSMatthias Ringwald /**
507f2924d79SMatthias Ringwald  * @brief Deny incoming L2CAP connection.
508f2924d79SMatthias Ringwald  */
5097ef6a7bbSMatthias Ringwald void l2cap_decline_connection(uint16_t local_cid);
510e6cc8be2S[email protected] 
5113de95307SMilanka Ringwald /**
512f2924d79SMatthias Ringwald  * @brief Check if outgoing buffer is available and that there's space on the Bluetooth module
5133de95307SMilanka Ringwald  */
5145e6d58c4SMilanka Ringwald int  l2cap_can_send_packet_now(uint16_t local_cid);
51533c40538SMatthias Ringwald 
51633c40538SMatthias Ringwald /**
5177d34cb71SMatthias Ringwald  * @brief Request emission of L2CAP_EVENT_CAN_SEND_NOW as soon as possible
5187d34cb71SMatthias Ringwald  * @note L2CAP_EVENT_CAN_SEND_NOW might be emitted during call to this function
5197d34cb71SMatthias Ringwald  *       so packet handler should be ready to handle it
5207d34cb71SMatthias Ringwald  * @param local_cid
52133c40538SMatthias Ringwald  */
5227d34cb71SMatthias Ringwald void l2cap_request_can_send_now_event(uint16_t local_cid);
523f2924d79SMatthias Ringwald 
524f2924d79SMatthias Ringwald /**
525f2924d79SMatthias Ringwald  * @brief Reserve outgoing buffer
526f2924d79SMatthias Ringwald  */
5275e6d58c4SMilanka Ringwald int  l2cap_reserve_packet_buffer(void);
5285e6d58c4SMilanka Ringwald 
5293de95307SMilanka Ringwald /**
5303de95307SMilanka Ringwald  * @brief Get outgoing buffer and prepare data.
5313de95307SMilanka Ringwald  */
5325e6d58c4SMilanka Ringwald uint8_t *l2cap_get_outgoing_buffer(void);
5335e6d58c4SMilanka Ringwald 
534f2924d79SMatthias Ringwald /**
535f2924d79SMatthias Ringwald  * @brief Send L2CAP packet prepared in outgoing buffer to channel
536f2924d79SMatthias Ringwald  */
5375e6d58c4SMilanka Ringwald int l2cap_send_prepared(uint16_t local_cid, uint16_t len);
5385e6d58c4SMilanka Ringwald 
5393de95307SMilanka Ringwald /**
540f2924d79SMatthias Ringwald  * @brief Release outgoing buffer (only needed if l2cap_send_prepared is not called)
5413de95307SMilanka Ringwald  */
542f2924d79SMatthias Ringwald void l2cap_release_packet_buffer(void);
543ea392f51SMatthias Ringwald 
544ea392f51SMatthias Ringwald 
5455073de0dSMatthias Ringwald //
5465073de0dSMatthias Ringwald // LE Connection Oriented Channels feature with the LE Credit Based Flow Control Mode == LE Data Channel
5475073de0dSMatthias Ringwald //
548ea392f51SMatthias Ringwald 
5495073de0dSMatthias Ringwald 
5507192e786SMatthias Ringwald /**
5515073de0dSMatthias Ringwald  * @brief Register L2CAP LE Data Channel service
5525073de0dSMatthias Ringwald  * @note MTU and initial credits are specified in l2cap_le_accept_connection(..) call
5535073de0dSMatthias Ringwald  * @param packet_handler
5545073de0dSMatthias Ringwald  * @param psm
5555073de0dSMatthias Ringwald  * @param security_level
5567192e786SMatthias Ringwald  */
557da144af5SMatthias Ringwald uint8_t l2cap_le_register_service(btstack_packet_handler_t packet_handler, uint16_t psm, gap_security_level_t security_level);
5585073de0dSMatthias Ringwald 
5595073de0dSMatthias Ringwald /**
5605073de0dSMatthias Ringwald  * @brief Unregister L2CAP LE Data Channel service
5615073de0dSMatthias Ringwald  * @param psm
5625073de0dSMatthias Ringwald  */
5635073de0dSMatthias Ringwald 
564da144af5SMatthias Ringwald uint8_t l2cap_le_unregister_service(uint16_t psm);
5655073de0dSMatthias Ringwald 
5665073de0dSMatthias Ringwald /*
5675073de0dSMatthias Ringwald  * @brief Accept incoming LE Data Channel connection
5685073de0dSMatthias Ringwald  * @param local_cid             L2CAP LE Data Channel Identifier
5695073de0dSMatthias Ringwald  * @param receive_buffer        buffer used for reassembly of L2CAP LE Information Frames into service data unit (SDU) with given MTU
5705073de0dSMatthias Ringwald  * @param receive_buffer_size   buffer size equals MTU
571ee913607SMatthias Ringwald  * @param initial_credits       Number of initial credits provided to peer or L2CAP_LE_AUTOMATIC_CREDITS to enable automatic credits
5725073de0dSMatthias Ringwald  */
5735073de0dSMatthias Ringwald 
5745073de0dSMatthias Ringwald uint8_t l2cap_le_accept_connection(uint16_t local_cid, uint8_t * receive_sdu_buffer, uint16_t mtu, uint16_t initial_credits);
5755073de0dSMatthias Ringwald 
5765073de0dSMatthias Ringwald /**
5775073de0dSMatthias Ringwald  * @brief Deny incoming LE Data Channel connection due to resource constraints
5785073de0dSMatthias Ringwald  * @param local_cid             L2CAP LE Data Channel Identifier
5795073de0dSMatthias Ringwald  */
5805073de0dSMatthias Ringwald 
5815073de0dSMatthias Ringwald uint8_t l2cap_le_decline_connection(uint16_t local_cid);
5825073de0dSMatthias Ringwald 
5835073de0dSMatthias Ringwald /**
584da144af5SMatthias Ringwald  * @brief Create LE Data Channel
5855073de0dSMatthias Ringwald  * @param packet_handler        Packet handler for this connection
5867dafa750SMatthias Ringwald  * @param con_handle            ACL-LE HCI Connction Handle
5875073de0dSMatthias Ringwald  * @param psm                   Service PSM to connect to
5885073de0dSMatthias Ringwald  * @param receive_buffer        buffer used for reassembly of L2CAP LE Information Frames into service data unit (SDU) with given MTU
5895073de0dSMatthias Ringwald  * @param receive_buffer_size   buffer size equals MTU
590ee913607SMatthias Ringwald  * @param initial_credits       Number of initial credits provided to peer or L2CAP_LE_AUTOMATIC_CREDITS to enable automatic credits
5915073de0dSMatthias Ringwald  * @param security_level        Minimum required security level
5925073de0dSMatthias Ringwald  * @param out_local_cid         L2CAP LE Channel Identifier is stored here
5935073de0dSMatthias Ringwald  */
5947dafa750SMatthias Ringwald uint8_t l2cap_le_create_channel(btstack_packet_handler_t packet_handler, hci_con_handle_t con_handle,
5955073de0dSMatthias Ringwald     uint16_t psm, uint8_t * receive_sdu_buffer, uint16_t mtu, uint16_t initial_credits, gap_security_level_t security_level,
5965073de0dSMatthias Ringwald     uint16_t * out_local_cid);
5975073de0dSMatthias Ringwald 
5985073de0dSMatthias Ringwald /**
5995073de0dSMatthias Ringwald  * @brief Provide credtis for LE Data Channel
6005073de0dSMatthias Ringwald  * @param local_cid             L2CAP LE Data Channel Identifier
6015073de0dSMatthias Ringwald  * @param credits               Number additional credits for peer
6025073de0dSMatthias Ringwald  */
6035073de0dSMatthias Ringwald uint8_t l2cap_le_provide_credits(uint16_t cid, uint16_t credits);
6045073de0dSMatthias Ringwald 
6055073de0dSMatthias Ringwald /**
60644276248SMatthias Ringwald  * @brief Check if packet can be scheduled for transmission
6075073de0dSMatthias Ringwald  * @param local_cid             L2CAP LE Data Channel Identifier
6085073de0dSMatthias Ringwald  */
6095073de0dSMatthias Ringwald int l2cap_le_can_send_now(uint16_t cid);
6105073de0dSMatthias Ringwald 
6115073de0dSMatthias Ringwald /**
612f30489e7SMatthias Ringwald  * @brief Request emission of L2CAP_EVENT_LE_CAN_SEND_NOW as soon as possible
6135073de0dSMatthias Ringwald  * @note L2CAP_EVENT_CAN_SEND_NOW might be emitted during call to this function
6145073de0dSMatthias Ringwald  *       so packet handler should be ready to handle it
6155073de0dSMatthias Ringwald  * @param local_cid             L2CAP LE Data Channel Identifier
6165073de0dSMatthias Ringwald  */
6175073de0dSMatthias Ringwald uint8_t l2cap_le_request_can_send_now_event(uint16_t cid);
6185073de0dSMatthias Ringwald 
6195073de0dSMatthias Ringwald /**
6205073de0dSMatthias Ringwald  * @brief Send data via LE Data Channel
6215073de0dSMatthias Ringwald  * @note Since data larger then the maximum PDU needs to be segmented into multiple PDUs, data needs to stay valid until ... event
6225073de0dSMatthias Ringwald  * @param local_cid             L2CAP LE Data Channel Identifier
6235073de0dSMatthias Ringwald  * @param data                  data to send
6245073de0dSMatthias Ringwald  * @param size                  data size
6255073de0dSMatthias Ringwald  */
6265073de0dSMatthias Ringwald uint8_t l2cap_le_send_data(uint16_t cid, uint8_t * data, uint16_t size);
6275073de0dSMatthias Ringwald 
6285073de0dSMatthias Ringwald /**
6295073de0dSMatthias Ringwald  * @brief Disconnect from LE Data Channel
6305073de0dSMatthias Ringwald  * @param local_cid             L2CAP LE Data Channel Identifier
6315073de0dSMatthias Ringwald  */
6325073de0dSMatthias Ringwald uint8_t l2cap_le_disconnect(uint16_t cid);
6335073de0dSMatthias Ringwald 
6345073de0dSMatthias Ringwald /* API_END */
6355e6d58c4SMilanka Ringwald 
63667a3a5b7SMatthias Ringwald /**
63767a3a5b7SMatthias Ringwald  * @brief ERTM Set channel as busy.
63867a3a5b7SMatthias Ringwald  * @note Can be cleared by l2cap_ertm_set_ready
63967a3a5b7SMatthias Ringwald  * @param local_cid
64067a3a5b7SMatthias Ringwald  */
64167a3a5b7SMatthias Ringwald uint8_t l2cap_ertm_set_busy(uint16_t local_cid);
64267a3a5b7SMatthias Ringwald 
64367a3a5b7SMatthias Ringwald /**
64467a3a5b7SMatthias Ringwald  * @brief ERTM Set channel as ready
64567a3a5b7SMatthias Ringwald  * @note Used after l2cap_ertm_set_busy
64667a3a5b7SMatthias Ringwald  * @param local_cid
64767a3a5b7SMatthias Ringwald  */
64867a3a5b7SMatthias Ringwald uint8_t l2cap_ertm_set_ready(uint16_t local_cid);
64967a3a5b7SMatthias Ringwald 
650e3b6fe7eSmatthias.ringwald #if defined __cplusplus
651e3b6fe7eSmatthias.ringwald }
652e3b6fe7eSmatthias.ringwald #endif
653f471afd8S[email protected] 
654f471afd8S[email protected] #endif // __L2CAP_H
655