xref: /btstack/src/classic/goep_client.c (revision fe0c3f15115a5d8dca604f2efeff84eb68959715)
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 BLUEKITCHEN
24  * GMBH 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 #define BTSTACK_FILE__ "goep_client.c"
39 
40 #include "btstack_config.h"
41 
42 #include <stdint.h>
43 #include <string.h>
44 
45 #include "btstack_debug.h"
46 #include "hci_dump.h"
47 #include "bluetooth_sdp.h"
48 #include "btstack_event.h"
49 #include "classic/goep_client.h"
50 #include "classic/obex_message_builder.h"
51 #include "classic/obex.h"
52 #include "classic/obex_iterator.h"
53 #include "classic/rfcomm.h"
54 #include "classic/sdp_client.h"
55 #include "classic/sdp_util.h"
56 #include "l2cap.h"
57 
58 //------------------------------------------------------------------------------------------------------------
59 // goep_client.c
60 //
61 
62 #ifdef ENABLE_GOEP_L2CAP
63 #ifndef ENABLE_L2CAP_ENHANCED_RETRANSMISSION_MODE
64 #error "ENABLE_GOEP_L2CAP requires ENABLE_L2CAP_ENHANCED_RETRANSMISSION_MODE. Please enable ENABLE_L2CAP_ENHANCED_RETRANSMISSION_MODE or disable ENABLE_GOEP_L2CAP"
65 #endif
66 #endif
67 
68 static uint16_t goep_client_cid;
69 static btstack_linked_list_t goep_clients;
70 
71 static goep_client_t *    goep_client_sdp_active;
72 static uint8_t            goep_client_sdp_query_attribute_value[30];
73 static const unsigned int goep_client_sdp_query_attribute_value_buffer_size = sizeof(goep_client_sdp_query_attribute_value);
74 static uint8_t goep_packet_buffer[150];
75 
76 // singleton instance
77 static goep_client_t   goep_client_singleton;
78 
79 #ifdef ENABLE_GOEP_L2CAP
80 // singleton instance
81 static uint8_t goep_client_singleton_ertm_buffer[1000];
82 static l2cap_ertm_config_t goep_client_singleton_ertm_config = {
83     1,  // ertm mandatory
84     2,  // max transmit, some tests require > 1
85     2000,
86     12000,
87     512,    // l2cap ertm mtu
88     2,
89     2,
90     1,      // 16-bit FCS
91 };
92 #endif
93 
94 static inline void goep_client_emit_connected_event(goep_client_t * goep_client, uint8_t status){
95     uint8_t event[15];
96     int pos = 0;
97     event[pos++] = HCI_EVENT_GOEP_META;
98     pos++;  // skip len
99     event[pos++] = GOEP_SUBEVENT_CONNECTION_OPENED;
100     little_endian_store_16(event, pos, goep_client->cid);
101     pos+=2;
102     event[pos++] = status;
103     (void)memcpy(&event[pos], goep_client->bd_addr, 6);
104     pos += 6;
105     little_endian_store_16(event, pos, goep_client->con_handle);
106     pos += 2;
107     event[pos++] = goep_client->incoming;
108     event[1] = pos - 2;
109     if (pos != sizeof(event)) log_error("goep_client_emit_connected_event size %u", pos);
110     goep_client->client_handler(HCI_EVENT_PACKET, goep_client->cid, &event[0], pos);
111 }
112 
113 static inline void goep_client_emit_connection_closed_event(goep_client_t * goep_client){
114     uint8_t event[5];
115     int pos = 0;
116     event[pos++] = HCI_EVENT_GOEP_META;
117     pos++;  // skip len
118     event[pos++] = GOEP_SUBEVENT_CONNECTION_CLOSED;
119     little_endian_store_16(event, pos, goep_client->cid);
120     pos+=2;
121     event[1] = pos - 2;
122     if (pos != sizeof(event)) log_error("goep_client_emit_connection_closed_event size %u", pos);
123     goep_client->client_handler(HCI_EVENT_PACKET, goep_client->cid, &event[0], pos);
124 }
125 
126 static inline void goep_client_emit_can_send_now_event(goep_client_t * goep_client){
127     uint8_t event[5];
128     int pos = 0;
129     event[pos++] = HCI_EVENT_GOEP_META;
130     pos++;  // skip len
131     event[pos++] = GOEP_SUBEVENT_CAN_SEND_NOW;
132     little_endian_store_16(event, pos, goep_client->cid);
133     pos+=2;
134     event[1] = pos - 2;
135     if (pos != sizeof(event)) log_error("goep_client_emit_can_send_now_event size %u", pos);
136     goep_client->client_handler(HCI_EVENT_PACKET, goep_client->cid, &event[0], pos);
137 }
138 
139 static void goep_client_handle_connection_opened(goep_client_t * goep_client, uint8_t status, uint16_t mtu){
140     if (status) {
141         goep_client->state = GOEP_CLIENT_INIT;
142         log_info("goep_client: open failed, status %u", status);
143     } else {
144         goep_client->bearer_mtu = mtu;
145         goep_client->state = GOEP_CLIENT_CONNECTED;
146         log_info("goep_client: connection opened. cid %u, max frame size %u", goep_client->bearer_cid, goep_client->bearer_mtu);
147     }
148     goep_client_emit_connected_event(goep_client, status);
149 }
150 
151 static void goep_client_handle_connection_close(goep_client_t * goep_client){
152     goep_client->state = GOEP_CLIENT_INIT;
153     btstack_linked_list_remove(&goep_clients, (btstack_linked_item_t *) goep_client);
154     goep_client_emit_connection_closed_event(goep_client);
155 }
156 
157 static goep_client_t * goep_client_for_cid(uint16_t cid){
158     btstack_linked_list_iterator_t it;
159     btstack_linked_list_iterator_init(&it, &goep_clients);
160     while (btstack_linked_list_iterator_has_next(&it)){
161         goep_client_t * goep_client = (goep_client_t *) btstack_linked_list_iterator_next(&it);
162         if (goep_client->cid == cid){
163             return goep_client;
164         }
165     }
166     return NULL;
167 }
168 
169 static goep_client_t * goep_client_for_bearer_cid(uint16_t bearer_cid){
170     btstack_linked_list_iterator_t it;
171     btstack_linked_list_iterator_init(&it, &goep_clients);
172     while (btstack_linked_list_iterator_has_next(&it)){
173         goep_client_t * goep_client = (goep_client_t *) btstack_linked_list_iterator_next(&it);
174         if (goep_client->bearer_cid == bearer_cid){
175             return goep_client;
176         }
177     }
178     return NULL;
179 }
180 
181 static void goep_client_packet_handler(uint8_t packet_type, uint16_t channel, uint8_t *packet, uint16_t size){
182     UNUSED(channel);
183     UNUSED(size);
184     goep_client_t * goep_client;
185     switch (packet_type){
186         case HCI_EVENT_PACKET:
187             switch (hci_event_packet_get_type(packet)) {
188 #ifdef ENABLE_GOEP_L2CAP
189                 case L2CAP_EVENT_CHANNEL_OPENED:
190                     goep_client = goep_client_for_bearer_cid(l2cap_event_channel_opened_get_local_cid(packet));
191                     btstack_assert(goep_client != NULL);
192                     goep_client_handle_connection_opened(goep_client, l2cap_event_channel_opened_get_status(packet),
193                                                          btstack_min(l2cap_event_channel_opened_get_remote_mtu(packet), l2cap_event_channel_opened_get_local_mtu(packet)));
194                     break;
195                 case L2CAP_EVENT_CAN_SEND_NOW:
196                     goep_client = goep_client_for_bearer_cid(l2cap_event_can_send_now_get_local_cid(packet));
197                     btstack_assert(goep_client != NULL);
198                     goep_client_emit_can_send_now_event(goep_client);
199                     break;
200                 case L2CAP_EVENT_CHANNEL_CLOSED:
201                     goep_client = goep_client_for_bearer_cid(l2cap_event_channel_closed_get_local_cid(packet));
202                     btstack_assert(goep_client != NULL);
203                     goep_client_handle_connection_close(goep_client);
204                     break;
205 #endif
206                 case RFCOMM_EVENT_CHANNEL_OPENED:
207                     goep_client = goep_client_for_bearer_cid(rfcomm_event_channel_opened_get_rfcomm_cid(packet));
208                     btstack_assert(goep_client != NULL);
209                     goep_client_handle_connection_opened(goep_client, rfcomm_event_channel_opened_get_status(packet), rfcomm_event_channel_opened_get_max_frame_size(packet));
210                     return;
211                 case RFCOMM_EVENT_CAN_SEND_NOW:
212                     goep_client = goep_client_for_bearer_cid(rfcomm_event_can_send_now_get_rfcomm_cid(packet));
213                     btstack_assert(goep_client != NULL);
214                     goep_client_emit_can_send_now_event(goep_client);
215                     break;
216                 case RFCOMM_EVENT_CHANNEL_CLOSED:
217                     goep_client = goep_client_for_bearer_cid(rfcomm_event_channel_closed_get_rfcomm_cid(packet));
218                     btstack_assert(goep_client != NULL);
219                     goep_client_handle_connection_close(goep_client);
220                     break;
221                 default:
222                     break;
223             }
224             break;
225         case L2CAP_DATA_PACKET:
226         case RFCOMM_DATA_PACKET:
227             goep_client = goep_client_for_bearer_cid(channel);
228             btstack_assert(goep_client != NULL);
229             goep_client->client_handler(GOEP_DATA_PACKET, goep_client->cid, packet, size);
230             break;
231         default:
232             break;
233     }
234 }
235 
236 static void goep_client_handle_sdp_query_end_of_record(goep_client_t * goep_client){
237     if (goep_client->uuid == BLUETOOTH_SERVICE_CLASS_MESSAGE_ACCESS_SERVER){
238         if (goep_client->mas_info.instance_id == goep_client->map_mas_instance_id){
239             // Requested MAS Instance found, accept info
240             log_info("MAS Instance #%u found", goep_client->map_mas_instance_id);
241             goep_client->rfcomm_port = goep_client->mas_info.rfcomm_port;
242             goep_client->profile_supported_features = goep_client->mas_info.supported_features;
243             goep_client->map_supported_message_types = goep_client->mas_info.supported_message_types;
244 #ifdef ENABLE_GOEP_L2CAP
245             goep_client->l2cap_psm = goep_client->mas_info.l2cap_psm;
246 #endif
247         }
248     }
249 }
250 static uint8_t goep_client_start_connect(goep_client_t * goep_client){
251 #ifdef ENABLE_GOEP_L2CAP
252     if (goep_client->l2cap_psm){
253         log_info("Remote GOEP L2CAP PSM: %u", goep_client->l2cap_psm);
254         return l2cap_ertm_create_channel(&goep_client_packet_handler, goep_client->bd_addr, goep_client->l2cap_psm,
255         &goep_client->ertm_config, goep_client->ertm_buffer,
256         goep_client->ertm_buffer_size, &goep_client->bearer_cid);
257     }
258 #endif
259     log_info("Remote GOEP RFCOMM Server Channel: %u", goep_client->rfcomm_port);
260     return rfcomm_create_channel(&goep_client_packet_handler, goep_client->bd_addr, goep_client->rfcomm_port, &goep_client->bearer_cid);
261 }
262 
263 static void goep_client_handle_sdp_query_event(uint8_t packet_type, uint16_t channel, uint8_t *packet, uint16_t size){
264     goep_client_t * goep_client = goep_client_sdp_active;
265     btstack_assert(goep_client != NULL);
266 
267     UNUSED(packet_type);
268     UNUSED(channel);
269     UNUSED(size);
270 
271     des_iterator_t des_list_it;
272     des_iterator_t prot_it;
273     uint8_t status;
274     uint16_t record_index;
275     bool goep_server_found;
276 
277     switch (hci_event_packet_get_type(packet)){
278         case SDP_EVENT_QUERY_ATTRIBUTE_VALUE:
279 
280             // detect new record
281             record_index = sdp_event_query_attribute_byte_get_record_id(packet);
282             if (record_index != goep_client->record_index){
283                 goep_client->record_index = record_index;
284                 goep_client_handle_sdp_query_end_of_record(goep_client);
285                 memset(&goep_client->mas_info, 0, sizeof(goep_client->mas_info));
286             }
287 
288             // check if relevant attribute
289             switch(sdp_event_query_attribute_byte_get_attribute_id(packet)){
290                 case BLUETOOTH_ATTRIBUTE_PROTOCOL_DESCRIPTOR_LIST:
291                 case BLUETOOTH_ATTRIBUTE_PBAP_SUPPORTED_FEATURES:
292                 case BLUETOOTH_ATTRIBUTE_MAS_INSTANCE_ID:
293                 case BLUETOOTH_ATTRIBUTE_SUPPORTED_MESSAGE_TYPES:
294 #ifdef ENABLE_GOEP_L2CAP
295                 case BLUETOOTH_ATTRIBUTE_GOEP_L2CAP_PSM:
296 #endif
297                     break;
298                 default:
299                     return;
300             }
301 
302             // warn if attribute too large to fit in our buffer
303             if (sdp_event_query_attribute_byte_get_attribute_length(packet) > goep_client_sdp_query_attribute_value_buffer_size) {
304                 log_error("SDP attribute value size exceeded for attribute %x: available %d, required %d", sdp_event_query_attribute_byte_get_attribute_id(packet), goep_client_sdp_query_attribute_value_buffer_size, sdp_event_query_attribute_byte_get_attribute_length(packet));
305                 break;
306             }
307 
308             // store single byte
309             goep_client_sdp_query_attribute_value[sdp_event_query_attribute_byte_get_data_offset(packet)] = sdp_event_query_attribute_byte_get_data(packet);
310 
311             // wait until value fully received
312             if ((uint16_t)(sdp_event_query_attribute_byte_get_data_offset(packet)+1) != sdp_event_query_attribute_byte_get_attribute_length(packet)) break;
313 
314             // process attributes
315             switch(sdp_event_query_attribute_byte_get_attribute_id(packet)) {
316                 case BLUETOOTH_ATTRIBUTE_PROTOCOL_DESCRIPTOR_LIST:
317                     for (des_iterator_init(&des_list_it, goep_client_sdp_query_attribute_value); des_iterator_has_more(&des_list_it); des_iterator_next(&des_list_it)) {
318                         uint8_t       *des_element;
319                         uint8_t       *element;
320                         uint32_t       uuid;
321 
322                         if (des_iterator_get_type(&des_list_it) != DE_DES) continue;
323 
324                         des_element = des_iterator_get_element(&des_list_it);
325                         des_iterator_init(&prot_it, des_element);
326 
327                         // first element is UUID
328                         element = des_iterator_get_element(&prot_it);
329                         if (de_get_element_type(element) != DE_UUID) continue;
330 
331                         uuid = de_get_uuid32(element);
332                         des_iterator_next(&prot_it);
333                         if (!des_iterator_has_more(&prot_it)) continue;
334 
335                         // second element is RFCOMM server channel or L2CAP PSM
336                         element = des_iterator_get_element(&prot_it);
337                         if (uuid == BLUETOOTH_PROTOCOL_RFCOMM){
338                             if (goep_client->uuid == BLUETOOTH_SERVICE_CLASS_MESSAGE_ACCESS_SERVER) {
339                                 goep_client->mas_info.rfcomm_port = element[de_get_header_size(element)];
340                             } else {
341                                 goep_client->rfcomm_port = element[de_get_header_size(element)];
342                             }
343                         }
344                     }
345                     break;
346 #ifdef ENABLE_GOEP_L2CAP
347                 case BLUETOOTH_ATTRIBUTE_GOEP_L2CAP_PSM:
348                     if (goep_client->uuid == BLUETOOTH_SERVICE_CLASS_MESSAGE_ACCESS_SERVER){
349                         de_element_get_uint16(goep_client_sdp_query_attribute_value, &goep_client->mas_info.l2cap_psm);
350                     } else {
351                         de_element_get_uint16(goep_client_sdp_query_attribute_value, &goep_client->l2cap_psm);
352                     }
353                     break;
354 #endif
355                 // BLUETOOTH_ATTRIBUTE_PBAP_SUPPORTED_FEATURES == BLUETOOTH_ATTRIBUTE_MAP_SUPPORTED_FEATURES == 0x0317
356                 case BLUETOOTH_ATTRIBUTE_PBAP_SUPPORTED_FEATURES:
357                     if (de_get_element_type(goep_client_sdp_query_attribute_value) != DE_UINT) break;
358                     if (de_get_size_type(goep_client_sdp_query_attribute_value) != DE_SIZE_32) break;
359                     if (goep_client->uuid == BLUETOOTH_SERVICE_CLASS_MESSAGE_ACCESS_SERVER) {
360                         goep_client->mas_info.supported_features  = big_endian_read_32(goep_client_sdp_query_attribute_value, de_get_header_size(goep_client_sdp_query_attribute_value));
361                     } else {
362                         goep_client->profile_supported_features  = big_endian_read_32(goep_client_sdp_query_attribute_value, de_get_header_size(goep_client_sdp_query_attribute_value));
363                     }
364                     break;
365 
366                 case BLUETOOTH_ATTRIBUTE_MAS_INSTANCE_ID:
367                     if (de_get_element_type(goep_client_sdp_query_attribute_value) != DE_UINT) break;
368                     if (de_get_size_type(goep_client_sdp_query_attribute_value) != DE_SIZE_8) break;
369                     goep_client->mas_info.instance_id = goep_client_sdp_query_attribute_value[de_get_header_size(goep_client_sdp_query_attribute_value)];
370                     break;
371 
372                 case BLUETOOTH_ATTRIBUTE_SUPPORTED_MESSAGE_TYPES:
373                     if (de_get_element_type(goep_client_sdp_query_attribute_value) != DE_UINT) break;
374                     if (de_get_size_type(goep_client_sdp_query_attribute_value) != DE_SIZE_8) break;
375                     goep_client->mas_info.supported_message_types = goep_client_sdp_query_attribute_value[de_get_header_size(goep_client_sdp_query_attribute_value)];
376                     break;
377 
378                 default:
379                     break;
380             }
381             break;
382 
383         case SDP_EVENT_QUERY_COMPLETE:
384             goep_client_sdp_active = NULL;
385             goep_client_handle_sdp_query_end_of_record(goep_client);
386             status = sdp_event_query_complete_get_status(packet);
387             if (status != ERROR_CODE_SUCCESS){
388                 log_info("GOEP client, SDP query failed 0x%02x", status);
389                 goep_client->state = GOEP_CLIENT_INIT;
390                 goep_client_emit_connected_event(goep_client, status);
391                 break;
392             }
393             goep_server_found = false;
394             if (goep_client->rfcomm_port != 0){
395                 goep_server_found = true;
396             }
397 #ifdef ENABLE_GOEP_L2CAP
398             if (goep_client->l2cap_psm != 0){
399                 goep_server_found = true;
400             }
401 #endif
402             if (goep_server_found == false){
403                 log_info("No GOEP RFCOMM or L2CAP server found");
404                 goep_client->state = GOEP_CLIENT_INIT;
405                 goep_client_emit_connected_event(goep_client, SDP_SERVICE_NOT_FOUND);
406                 break;
407             }
408             (void) goep_client_start_connect(goep_client);
409             break;
410 
411         default:
412             break;
413     }
414 }
415 
416 static uint8_t * goep_client_get_outgoing_buffer(goep_client_t * goep_client){
417     if (goep_client->l2cap_psm){
418         return goep_packet_buffer;
419     } else {
420         return rfcomm_get_outgoing_buffer();
421     }
422 }
423 
424 static uint16_t goep_client_get_outgoing_buffer_len(goep_client_t * goep_client){
425     if (goep_client->l2cap_psm){
426         return sizeof(goep_packet_buffer);
427     } else {
428         return rfcomm_get_max_frame_size(goep_client->bearer_cid);
429     }
430 }
431 
432 static void goep_client_packet_init(goep_client_t *goep_client, uint8_t opcode) {
433     if (goep_client->l2cap_psm != 0){
434     } else {
435         rfcomm_reserve_packet_buffer();
436     }
437     // store opcode for parsing of response
438     goep_client->obex_opcode = opcode;
439 }
440 
441 void goep_client_init(void){
442     goep_client_singleton.state = GOEP_CLIENT_INIT;
443 }
444 
445 void goep_client_deinit(void){
446     goep_clients = NULL;
447     goep_client_cid = 0;
448     memset(&goep_client_singleton, 0, sizeof(goep_client_t));
449     memset(goep_client_sdp_query_attribute_value, 0, sizeof(goep_client_sdp_query_attribute_value));
450     memset(goep_packet_buffer, 0, sizeof(goep_packet_buffer));
451 }
452 
453 static void geop_client_sdp_query_start(void * context){
454     uint16_t goep_cid = (uint16_t)(uintptr_t) context;
455     goep_client_t * goep_client = goep_client_for_cid(goep_cid);
456     if (context != NULL){
457         goep_client_sdp_active = goep_client;
458         sdp_client_query_uuid16(&goep_client_handle_sdp_query_event, goep_client->bd_addr,
459                                 goep_client->uuid);
460     }
461 }
462 
463 uint8_t
464 goep_client_connect(goep_client_t *goep_client, l2cap_ertm_config_t *l2cap_ertm_config, uint8_t *l2cap_ertm_buffer,
465                     uint16_t l2cap_ertm_buffer_size, btstack_packet_handler_t handler, bd_addr_t addr, uint16_t uuid,
466                     uint8_t instance_id, uint16_t *out_cid) {
467     // get new goep cid, skip 0x0000
468     goep_client_cid++;
469     if (goep_client_cid == 0) {
470         goep_client_cid = 1;
471     }
472 
473     // add to list
474     memset(goep_client, 0, sizeof(goep_client_t));
475     goep_client->state = GOEP_CLIENT_W4_SDP;
476     goep_client->cid = goep_client_cid;
477     goep_client->client_handler = handler;
478     goep_client->uuid = uuid;
479     goep_client->map_mas_instance_id = instance_id;
480     goep_client->profile_supported_features = PROFILE_FEATURES_NOT_PRESENT;
481     (void)memcpy(goep_client->bd_addr, addr, 6);
482     goep_client->sdp_query_request.callback = geop_client_sdp_query_start;
483     goep_client->sdp_query_request.context = (void *)(uintptr_t) goep_client->cid;
484     goep_client->obex_connection_id = OBEX_CONNECTION_ID_INVALID;
485 #ifdef ENABLE_GOEP_L2CAP
486     memcpy(&goep_client->ertm_config, l2cap_ertm_config, sizeof(l2cap_ertm_config_t));
487     goep_client->ertm_buffer_size = l2cap_ertm_buffer_size;
488     goep_client->ertm_buffer = l2cap_ertm_buffer;
489 #endif
490     btstack_linked_list_add(&goep_clients, (btstack_linked_item_t *) goep_client);
491 
492     // request sdp query
493     sdp_client_register_query_callback(&goep_client->sdp_query_request);
494 
495     *out_cid = goep_client->cid;
496     return ERROR_CODE_SUCCESS;
497 }
498 
499 #ifdef ENABLE_GOEP_L2CAP
500 uint8_t goep_client_connect_l2cap(goep_client_t *goep_client, l2cap_ertm_config_t *l2cap_ertm_config, uint8_t *l2cap_ertm_buffer,
501                           uint16_t l2cap_ertm_buffer_size, btstack_packet_handler_t handler, bd_addr_t addr, uint16_t l2cap_psm,
502                           uint16_t *out_cid){
503     // get new goep cid, skip 0x0000
504     goep_client_cid++;
505     if (goep_client_cid == 0) {
506         goep_client_cid = 1;
507     }
508 
509     // add to list
510     memset(goep_client, 0, sizeof(goep_client_t));
511     goep_client->state = GOEP_CLIENT_W4_SDP;
512     goep_client->cid = goep_client_cid;
513     goep_client->client_handler = handler;
514     goep_client->profile_supported_features = PROFILE_FEATURES_NOT_PRESENT;
515     (void)memcpy(goep_client->bd_addr, addr, 6);
516     goep_client->obex_connection_id = OBEX_CONNECTION_ID_INVALID;
517     memcpy(&goep_client->ertm_config, l2cap_ertm_config, sizeof(l2cap_ertm_config_t));
518     goep_client->ertm_buffer_size = l2cap_ertm_buffer_size;
519     goep_client->ertm_buffer = l2cap_ertm_buffer;
520     btstack_linked_list_add(&goep_clients, (btstack_linked_item_t *) goep_client);
521 
522     goep_client->l2cap_psm = l2cap_psm;
523 
524     *out_cid = goep_client->cid;
525 
526     return goep_client_start_connect(goep_client);
527 }
528 #endif
529 
530 uint8_t goep_client_create_connection(btstack_packet_handler_t handler, bd_addr_t addr, uint16_t uuid, uint16_t * out_cid){
531     goep_client_t * goep_client = &goep_client_singleton;
532     if (goep_client->state != GOEP_CLIENT_INIT) {
533         return BTSTACK_MEMORY_ALLOC_FAILED;
534     }
535 #ifdef ENABLE_GOEP_L2CAP
536     return goep_client_connect(goep_client, &goep_client_singleton_ertm_config, goep_client_singleton_ertm_buffer,
537                                sizeof(goep_client_singleton_ertm_buffer), handler, addr, uuid, 0, out_cid);
538 #else
539     return goep_client_connect(goep_client,NULL, NULL, 0, handler, addr, uuid, 0, out_cid);
540 #endif
541 }
542 
543 uint32_t goep_client_get_pbap_supported_features(uint16_t goep_cid){
544     goep_client_t * goep_client = goep_client_for_cid(goep_cid);
545     if (goep_client == NULL){
546         return PBAP_FEATURES_NOT_PRESENT;
547     }
548     return goep_client->profile_supported_features;
549 }
550 
551 uint32_t goep_client_get_map_supported_features(uint16_t goep_cid){
552     goep_client_t * goep_client = goep_client_for_cid(goep_cid);
553     if (goep_client == NULL){
554         return PROFILE_FEATURES_NOT_PRESENT;
555     }
556     return goep_client->profile_supported_features;
557 }
558 
559 uint8_t goep_client_get_map_mas_instance_id(uint16_t goep_cid){
560     goep_client_t * goep_client = goep_client_for_cid(goep_cid);
561     if (goep_client == NULL){
562         return 0;
563     }
564     return goep_client->map_mas_instance_id;
565 }
566 
567 uint8_t goep_client_get_map_supported_message_types(uint16_t goep_cid){
568     goep_client_t * goep_client = goep_client_for_cid(goep_cid);
569     if (goep_client == NULL){
570         return 0;
571     }
572     return goep_client->map_supported_message_types;
573 }
574 
575 
576 bool goep_client_version_20_or_higher(uint16_t goep_cid){
577     goep_client_t * goep_client = goep_client_for_cid(goep_cid);
578     if (goep_client == NULL){
579         return false;
580     }
581     return goep_client->l2cap_psm != 0;
582 }
583 
584 void goep_client_request_can_send_now(uint16_t goep_cid){
585     goep_client_t * goep_client = goep_client_for_cid(goep_cid);
586     if (goep_client == NULL){
587         return;
588     }
589     if (goep_client->l2cap_psm){
590         l2cap_request_can_send_now_event(goep_client->bearer_cid);
591     } else {
592         rfcomm_request_can_send_now_event(goep_client->bearer_cid);
593     }
594 }
595 
596 uint8_t goep_client_disconnect(uint16_t goep_cid){
597     goep_client_t * goep_client = goep_client_for_cid(goep_cid);
598     if (goep_client == NULL){
599         return ERROR_CODE_UNKNOWN_CONNECTION_IDENTIFIER;
600     }
601     if (goep_client->l2cap_psm){
602         l2cap_disconnect(goep_client->bearer_cid);
603     } else {
604         rfcomm_disconnect(goep_client->bearer_cid);
605     }
606     return ERROR_CODE_SUCCESS;
607 }
608 
609 void goep_client_set_connection_id(uint16_t goep_cid, uint32_t connection_id){
610     goep_client_t * goep_client = goep_client_for_cid(goep_cid);
611     if (goep_client == NULL){
612         return;
613     }
614     goep_client->obex_connection_id = connection_id;
615 }
616 
617 uint8_t goep_client_get_request_opcode(uint16_t goep_cid){
618     goep_client_t * goep_client = goep_client_for_cid(goep_cid);
619     if (goep_client == NULL){
620         return 0;
621     }
622     return goep_client->obex_opcode;
623 }
624 
625 void goep_client_request_create_connect(uint16_t goep_cid, uint8_t obex_version_number, uint8_t flags, uint16_t maximum_obex_packet_length){
626     goep_client_t * goep_client = goep_client_for_cid(goep_cid);
627     if (goep_client == NULL){
628         return;
629     }
630     goep_client_packet_init(goep_client, OBEX_OPCODE_CONNECT);
631     // workaround: limit OBEX packet len to L2CAP/RFCOMM MTU to avoid handling of fragemented packets
632     maximum_obex_packet_length = btstack_min(maximum_obex_packet_length, goep_client->bearer_mtu);
633 
634     uint8_t * buffer = goep_client_get_outgoing_buffer(goep_client);
635     uint16_t buffer_len = goep_client_get_outgoing_buffer_len(goep_client);
636     obex_message_builder_request_create_connect(buffer, buffer_len, obex_version_number, flags, maximum_obex_packet_length);
637 }
638 
639 void goep_client_request_create_get(uint16_t goep_cid){
640     goep_client_t * goep_client = goep_client_for_cid(goep_cid);
641     if (goep_client == NULL){
642         return;
643     }
644     goep_client_packet_init(goep_client, OBEX_OPCODE_GET | OBEX_OPCODE_FINAL_BIT_MASK);
645     uint8_t * buffer = goep_client_get_outgoing_buffer(goep_client);
646     uint16_t buffer_len = goep_client_get_outgoing_buffer_len(goep_client);
647     obex_message_builder_request_create_get(buffer, buffer_len, goep_client->obex_connection_id);
648 }
649 
650 void goep_client_request_create_put(uint16_t goep_cid){
651     goep_client_t * goep_client = goep_client_for_cid(goep_cid);
652     if (goep_client == NULL){
653         return;
654     }
655     goep_client_packet_init(goep_client, OBEX_OPCODE_PUT | OBEX_OPCODE_FINAL_BIT_MASK);
656     uint8_t * buffer = goep_client_get_outgoing_buffer(goep_client);
657     uint16_t buffer_len = goep_client_get_outgoing_buffer_len(goep_client);
658     obex_message_builder_request_create_put(buffer, buffer_len, goep_client->obex_connection_id);
659 }
660 
661 void goep_client_request_create_set_path(uint16_t goep_cid, uint8_t flags){
662     goep_client_t * goep_client = goep_client_for_cid(goep_cid);
663     if (goep_client == NULL){
664         return;
665     }
666     goep_client_packet_init(goep_client, OBEX_OPCODE_SETPATH);
667     uint8_t * buffer = goep_client_get_outgoing_buffer(goep_client);
668     uint16_t buffer_len = goep_client_get_outgoing_buffer_len(goep_client);
669     obex_message_builder_request_create_set_path(buffer, buffer_len, flags, goep_client->obex_connection_id);
670 }
671 
672 void goep_client_request_create_abort(uint16_t goep_cid){
673     goep_client_t * goep_client = goep_client_for_cid(goep_cid);
674     if (goep_client == NULL){
675         return;
676     }
677     goep_client_packet_init(goep_client, OBEX_OPCODE_ABORT);
678 
679     uint8_t * buffer = goep_client_get_outgoing_buffer(goep_client);
680     uint16_t buffer_len = goep_client_get_outgoing_buffer_len(goep_client);
681     obex_message_builder_request_create_abort(buffer, buffer_len, goep_client->obex_connection_id);
682 }
683 
684 void goep_client_request_create_disconnect(uint16_t goep_cid){
685     goep_client_t * goep_client = goep_client_for_cid(goep_cid);
686     if (goep_client == NULL){
687         return;
688     }
689     goep_client_packet_init(goep_client, OBEX_OPCODE_DISCONNECT);
690     uint8_t * buffer = goep_client_get_outgoing_buffer(goep_client);
691     uint16_t buffer_len = goep_client_get_outgoing_buffer_len(goep_client);
692     obex_message_builder_request_create_disconnect(buffer, buffer_len, goep_client->obex_connection_id);
693 }
694 
695 void goep_client_header_add_byte(uint16_t goep_cid, uint8_t header_type, uint8_t value){
696     goep_client_t * goep_client = goep_client_for_cid(goep_cid);
697     if (goep_client == NULL){
698         return;
699     }
700     uint8_t * buffer = goep_client_get_outgoing_buffer(goep_client);
701     uint16_t buffer_len = goep_client_get_outgoing_buffer_len(goep_client);
702     obex_message_builder_header_add_byte(buffer, buffer_len, header_type, value);
703 }
704 
705 void goep_client_header_add_word(uint16_t goep_cid, uint8_t header_type, uint32_t value){
706     goep_client_t * goep_client = goep_client_for_cid(goep_cid);
707     if (goep_client == NULL){
708         return;
709     }
710     uint8_t * buffer = goep_client_get_outgoing_buffer(goep_client);
711     uint16_t buffer_len = goep_client_get_outgoing_buffer_len(goep_client);
712     obex_message_builder_header_add_word(buffer, buffer_len, header_type, value);
713 }
714 
715 void goep_client_header_add_variable(uint16_t goep_cid, uint8_t header_type, const uint8_t * header_data, uint16_t header_data_length){
716     goep_client_t * goep_client = goep_client_for_cid(goep_cid);
717     if (goep_client == NULL){
718         return;
719     }
720     uint8_t * buffer = goep_client_get_outgoing_buffer(goep_client);
721     uint16_t buffer_len = goep_client_get_outgoing_buffer_len(goep_client);
722     obex_message_builder_header_add_variable(buffer, buffer_len, header_type, header_data, header_data_length);
723 }
724 
725 void goep_client_header_add_srm_enable(uint16_t goep_cid){
726     goep_client_t * goep_client = goep_client_for_cid(goep_cid);
727     if (goep_client == NULL){
728         return;
729     }
730     uint8_t * buffer = goep_client_get_outgoing_buffer(goep_client);
731     uint16_t buffer_len = goep_client_get_outgoing_buffer_len(goep_client);
732     obex_message_builder_header_add_srm_enable(buffer, buffer_len);
733 }
734 
735 void goep_client_header_add_target(uint16_t goep_cid, const uint8_t * target, uint16_t length){
736     goep_client_t * goep_client = goep_client_for_cid(goep_cid);
737     if (goep_client == NULL){
738         return;
739     }
740     uint8_t * buffer = goep_client_get_outgoing_buffer(goep_client);
741     uint16_t buffer_len = goep_client_get_outgoing_buffer_len(goep_client);
742     obex_message_builder_header_add_target(buffer, buffer_len, target, length);
743 }
744 
745 void goep_client_header_add_application_parameters(uint16_t goep_cid, const uint8_t * data, uint16_t length){
746     goep_client_t * goep_client = goep_client_for_cid(goep_cid);
747     if (goep_client == NULL){
748         return;
749     }
750     uint8_t * buffer = goep_client_get_outgoing_buffer(goep_client);
751     uint16_t buffer_len = goep_client_get_outgoing_buffer_len(goep_client);
752     obex_message_builder_header_add_application_parameters(buffer, buffer_len, data, length);
753 }
754 
755 void goep_client_header_add_challenge_response(uint16_t goep_cid, const uint8_t * data, uint16_t length){
756     goep_client_t * goep_client = goep_client_for_cid(goep_cid);
757     if (goep_client == NULL){
758         return;
759     }
760     uint8_t * buffer = goep_client_get_outgoing_buffer(goep_client);
761     uint16_t buffer_len = goep_client_get_outgoing_buffer_len(goep_client);
762     obex_message_builder_header_add_challenge_response(buffer, buffer_len, data, length);
763 }
764 
765 void goep_client_body_add_static(uint16_t goep_cid, const uint8_t * data, uint32_t length){
766     goep_client_t * goep_client = goep_client_for_cid(goep_cid);
767     if (goep_client == NULL){
768         return;
769     }
770     uint8_t * buffer = goep_client_get_outgoing_buffer(goep_client);
771     uint16_t buffer_len = goep_client_get_outgoing_buffer_len(goep_client);
772     obex_message_builder_body_add_static(buffer, buffer_len, data, length);
773 }
774 
775 uint16_t goep_client_body_get_outgoing_buffer_len(uint16_t goep_cid) {
776     goep_client_t * goep_client = goep_client_for_cid(goep_cid);
777     if (goep_client == NULL){
778         return 0;
779     }
780     return goep_client_get_outgoing_buffer_len(goep_client);
781 };
782 
783 void goep_client_body_fillup_static(uint16_t goep_cid, const uint8_t * data, uint32_t length, uint32_t * ret_length){
784     goep_client_t * goep_client = goep_client_for_cid(goep_cid);
785     if (goep_client == NULL){
786         return;
787     }
788     uint8_t * buffer = goep_client_get_outgoing_buffer(goep_client);
789     uint16_t buffer_len = goep_client_get_outgoing_buffer_len(goep_client);
790     obex_message_builder_body_fillup_static(buffer, buffer_len, data, length, ret_length);
791 }
792 
793 void goep_client_header_add_name(uint16_t goep_cid, const char * name){
794     goep_client_t * goep_client = goep_client_for_cid(goep_cid);
795     if (goep_client == NULL){
796         return;
797     }
798     uint8_t * buffer = goep_client_get_outgoing_buffer(goep_client);
799     uint16_t buffer_len = goep_client_get_outgoing_buffer_len(goep_client);
800     obex_message_builder_header_add_name(buffer, buffer_len, name);
801 }
802 
803 void goep_client_header_add_name_prefix(uint16_t goep_cid, const char * name, uint16_t name_len){
804     goep_client_t * goep_client = goep_client_for_cid(goep_cid);
805     if (goep_client == NULL){
806         return;
807     }
808     uint8_t * buffer = goep_client_get_outgoing_buffer(goep_client);
809     uint16_t buffer_len = goep_client_get_outgoing_buffer_len(goep_client);
810     obex_message_builder_header_add_name_prefix(buffer, buffer_len, name, name_len);
811 }
812 
813 void goep_client_header_add_unicode_prefix(uint16_t goep_cid, uint8_t header_id, const char * name, uint16_t name_len){
814     goep_client_t * goep_client = goep_client_for_cid(goep_cid);
815     if (goep_client == NULL){
816         return;
817     }
818     uint8_t * buffer = goep_client_get_outgoing_buffer(goep_client);
819     uint16_t buffer_len = goep_client_get_outgoing_buffer_len(goep_client);
820     obex_message_builder_header_add_unicode_prefix(buffer, buffer_len, header_id, name, name_len);
821 }
822 
823 void goep_client_header_add_type(uint16_t goep_cid, const char * type){
824     goep_client_t * goep_client = goep_client_for_cid(goep_cid);
825     if (goep_client == NULL){
826         return;
827     }
828     uint8_t * buffer = goep_client_get_outgoing_buffer(goep_client);
829     uint16_t buffer_len = goep_client_get_outgoing_buffer_len(goep_client);
830     obex_message_builder_header_add_type(buffer, buffer_len, type);
831 }
832 
833 void goep_client_header_add_length(uint16_t goep_cid, uint32_t length){
834     goep_client_t * goep_client = goep_client_for_cid(goep_cid);
835     if (goep_client == NULL){
836         return;
837     }
838     uint8_t * buffer = goep_client_get_outgoing_buffer(goep_client);
839     uint16_t buffer_len = goep_client_get_outgoing_buffer_len(goep_client);
840     obex_message_builder_header_add_length(buffer, buffer_len, length);
841 }
842 
843 uint16_t goep_client_request_get_max_body_size(uint16_t goep_cid){
844     goep_client_t * goep_client = goep_client_for_cid(goep_cid);
845     if (goep_client == NULL){
846         return 0;
847     }
848     uint8_t * buffer = goep_client_get_outgoing_buffer(goep_client);
849     uint16_t buffer_len = goep_client_get_outgoing_buffer_len(goep_client);
850     uint16_t pos = big_endian_read_16(buffer, 1);
851     return buffer_len - pos;
852 }
853 
854 int goep_client_execute(uint16_t goep_cid){
855     goep_client_t * goep_client = goep_client_for_cid(goep_cid);
856     if (goep_client == NULL){
857         return ERROR_CODE_UNKNOWN_CONNECTION_IDENTIFIER;
858     }
859     return goep_client_execute_with_final_bit (goep_cid, true);
860 }
861 
862 int goep_client_execute_with_final_bit(uint16_t goep_cid, bool final){
863     goep_client_t * goep_client = goep_client_for_cid(goep_cid);
864     if (goep_client == NULL){
865         return ERROR_CODE_UNKNOWN_CONNECTION_IDENTIFIER;
866     }
867     uint8_t * buffer = goep_client_get_outgoing_buffer(goep_client);
868     uint16_t buffer_len = goep_client_get_outgoing_buffer_len(goep_client);
869 
870     obex_message_builder_set_final_bit (buffer, buffer_len, final);
871 
872     uint16_t pos = big_endian_read_16(buffer, 1);
873     if (goep_client->l2cap_psm){
874         return l2cap_send(goep_client->bearer_cid, buffer, pos);
875     } else {
876         return rfcomm_send_prepared(goep_client->bearer_cid, pos);
877     }
878 }
879 
880