xref: /btstack/src/classic/pbap_client.c (revision 1f790386184c88b9b9a77e96b96adad882ed2194)
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__ "pbap_client.c"
39 
40 #include "btstack_config.h"
41 
42 #include <stdint.h>
43 #include <string.h>
44 
45 #include "hci_cmd.h"
46 #include "btstack_run_loop.h"
47 #include "btstack_debug.h"
48 #include "hci.h"
49 #include "btstack_memory.h"
50 #include "hci_dump.h"
51 #include "l2cap.h"
52 #include "bluetooth_sdp.h"
53 #include "classic/sdp_client_rfcomm.h"
54 #include "btstack_event.h"
55 #include "md5.h"
56 
57 #include "classic/obex.h"
58 #include "classic/obex_parser.h"
59 #include "classic/goep_client.h"
60 #include "classic/pbap.h"
61 #include "classic/pbap_client.h"
62 
63 // 796135f0-f0c5-11d8-0966- 0800200c9a66
64 static const uint8_t pbap_uuid[] = { 0x79, 0x61, 0x35, 0xf0, 0xf0, 0xc5, 0x11, 0xd8, 0x09, 0x66, 0x08, 0x00, 0x20, 0x0c, 0x9a, 0x66};
65 
66 const char * pbap_phonebook_type     = "x-bt/phonebook";
67 const char * pbap_vcard_listing_type = "x-bt/vcard-listing";
68 const char * pbap_vcard_entry_type   = "x-bt/vcard";
69 
70 const char * pbap_vcard_listing_name = "pb";
71 
72 // used for MD5
73 static const uint8_t colon = (uint8_t) ':';
74 
75 static uint32_t pbap_client_supported_features;
76 
77 static bool pbap_client_singleton_used;
78 
79 static btstack_linked_list_t pbap_clients;
80 
81 // emit events
82 static void pbap_client_emit_connected_event(pbap_client_t * context, uint8_t status){
83     uint8_t event[15];
84     int pos = 0;
85     event[pos++] = HCI_EVENT_PBAP_META;
86     pos++;  // skip len
87     event[pos++] = PBAP_SUBEVENT_CONNECTION_OPENED;
88     little_endian_store_16(event,pos,context->goep_cid);
89     pos+=2;
90     event[pos++] = status;
91     (void)memcpy(&event[pos], context->bd_addr, 6);
92     pos += 6;
93     little_endian_store_16(event,pos,context->con_handle);
94     pos += 2;
95     event[pos++] = 0;
96     event[1] = pos - 2;
97     if (pos != sizeof(event)) log_error("goep_client_emit_connected_event size %u", pos);
98     context->client_handler(HCI_EVENT_PACKET, context->goep_cid, &event[0], pos);
99 }
100 
101 static void pbap_client_emit_connection_closed_event(pbap_client_t * context){
102     uint8_t event[5];
103     int pos = 0;
104     event[pos++] = HCI_EVENT_PBAP_META;
105     pos++;  // skip len
106     event[pos++] = PBAP_SUBEVENT_CONNECTION_CLOSED;
107     little_endian_store_16(event,pos,context->goep_cid);
108     pos+=2;
109     event[1] = pos - 2;
110     if (pos != sizeof(event)) log_error("pbap_client_emit_connection_closed_event size %u", pos);
111     context->client_handler(HCI_EVENT_PACKET, context->goep_cid, &event[0], pos);
112 }
113 
114 static void pbap_client_emit_operation_complete_event(pbap_client_t * context, uint8_t status){
115     uint8_t event[6];
116     int pos = 0;
117     event[pos++] = HCI_EVENT_PBAP_META;
118     pos++;  // skip len
119     event[pos++] = PBAP_SUBEVENT_OPERATION_COMPLETED;
120     little_endian_store_16(event,pos,context->goep_cid);
121     pos+=2;
122     event[pos++]= status;
123     event[1] = pos - 2;
124     if (pos != sizeof(event)) log_error("pbap_client_emit_can_send_now_event size %u", pos);
125     context->client_handler(HCI_EVENT_PACKET, context->goep_cid, &event[0], pos);
126 }
127 
128 static void pbap_client_emit_phonebook_size_event(pbap_client_t * context, uint8_t status, uint16_t phonebook_size){
129     uint8_t event[8];
130     int pos = 0;
131     event[pos++] = HCI_EVENT_PBAP_META;
132     pos++;  // skip len
133     event[pos++] = PBAP_SUBEVENT_PHONEBOOK_SIZE;
134     little_endian_store_16(event,pos,context->goep_cid);
135     pos+=2;
136     event[pos++] = status;
137     little_endian_store_16(event,pos, phonebook_size);
138     pos+=2;
139     event[1] = pos - 2;
140     if (pos != sizeof(event)) log_error("pbap_client_emit_phonebook_size_event size %u", pos);
141     context->client_handler(HCI_EVENT_PACKET, context->goep_cid, &event[0], pos);
142 }
143 
144 static void pbap_client_emit_authentication_event(pbap_client_t * context, uint8_t options){
145     // split options
146     uint8_t user_id_required = (options & 1) ? 1 : 0;
147     uint8_t full_access      = (options & 2) ? 1 : 0;
148 
149     uint8_t event[7];
150     int pos = 0;
151     event[pos++] = HCI_EVENT_PBAP_META;
152     pos++;  // skip len
153     event[pos++] = PBAP_SUBEVENT_AUTHENTICATION_REQUEST;
154     little_endian_store_16(event,pos,context->goep_cid);
155     pos+=2;
156     event[pos++] = user_id_required;
157     event[pos++] = full_access;
158     if (pos != sizeof(event)) log_error("pbap_client_emit_authentication_event size %u", pos);
159     context->client_handler(HCI_EVENT_PACKET, context->goep_cid, &event[0], pos);
160 }
161 
162 static void pbap_client_emit_card_result_event(pbap_client_t * context, const char * name, const char * handle){
163     uint8_t event[5 + PBAP_MAX_NAME_LEN + PBAP_MAX_HANDLE_LEN];
164     int pos = 0;
165     event[pos++] = HCI_EVENT_PBAP_META;
166     pos++;  // skip len
167     event[pos++] = PBAP_SUBEVENT_CARD_RESULT;
168     little_endian_store_16(event,pos,context->goep_cid);
169     pos+=2;
170     int name_len = btstack_min(PBAP_MAX_NAME_LEN, (uint16_t) strlen(name));
171     event[pos++] = name_len;
172     (void)memcpy(&event[pos], name, name_len);
173     pos += name_len;
174     int handle_len = btstack_min(PBAP_MAX_HANDLE_LEN, (uint16_t) strlen(handle));
175     event[pos++] = handle_len;
176     (void)memcpy(&event[pos], handle, handle_len);
177     pos += handle_len;
178     event[1] = pos - 2;
179     context->client_handler(HCI_EVENT_PACKET, context->goep_cid, &event[0], pos);
180 }
181 
182 static pbap_client_t * pbap_client_for_cid(uint16_t cid){
183     btstack_linked_list_iterator_t it;
184     btstack_linked_list_iterator_init(&it, &pbap_clients);
185     while (btstack_linked_list_iterator_has_next(&it)){
186         pbap_client_t * client = (pbap_client_t *) btstack_linked_list_iterator_next(&it);
187         if (client->goep_cid == cid){
188             return client;
189         }
190     }
191     return NULL;
192 }
193 
194 static void pbap_client_finalize(pbap_client_t *client) {
195     client->state = PBAP_CLIENT_INIT;
196     btstack_linked_list_remove(&pbap_clients, (btstack_linked_item_t*) client);
197 }
198 
199 static void pbap_client_vcard_listing_init_parser(pbap_client_t * client){
200     yxml_init(&client->xml_parser, client->xml_buffer, sizeof(client->xml_buffer));
201     client->parser_card_found = false;
202     client->parser_name_found = false;
203     client->parser_handle_found = false;
204 }
205 
206 static void pbap_client_phonebook_size_parser_init(pbap_client_phonebook_size_parser_t * phonebook_size_parer){
207     memset(phonebook_size_parer, 0, sizeof(pbap_client_phonebook_size_parser_t));
208 }
209 
210 static void pbap_client_phonebook_size_parser_process_data(pbap_client_phonebook_size_parser_t * phonebook_size_parser, const uint8_t * data_buffer, uint16_t data_len){
211     while (data_len){
212         uint16_t bytes_to_consume = 1;
213         switch(phonebook_size_parser->state){
214             case PBAP_CLIENT_PHONEBOOK_SIZE_PARSER_STATE_INVALID:
215                 return;
216             case PBAP_CLIENT_PHONEBOOK_SIZE_PARSER_STATE_W4_TYPE:
217                 phonebook_size_parser->type = *data_buffer;
218                 phonebook_size_parser->state = PBAP_CLIENT_PHONEBOOK_SIZE_PARSER_STATE_W4_LEN;
219                 break;
220             case PBAP_CLIENT_PHONEBOOK_SIZE_PARSER_STATE_W4_LEN:
221                 phonebook_size_parser->len = *data_buffer;
222                 phonebook_size_parser->state = PBAP_CLIENT_PHONEBOOK_SIZE_PARSER_STATE_W4_VALUE;
223                 switch (phonebook_size_parser->type){
224                     case PBAP_APPLICATION_PARAMETER_PHONEBOOK_SIZE:
225                         if (phonebook_size_parser->len != 2){
226                             phonebook_size_parser->state = PBAP_CLIENT_PHONEBOOK_SIZE_PARSER_STATE_INVALID;
227                             return;
228                         }
229                         break;
230                     default:
231                         break;
232                     }
233                 break;
234             case PBAP_CLIENT_PHONEBOOK_SIZE_PARSER_STATE_W4_VALUE:
235                 bytes_to_consume = btstack_min(phonebook_size_parser->len - phonebook_size_parser->pos, data_len);
236                 switch (phonebook_size_parser->type){
237                     case PBAP_APPLICATION_PARAMETER_PHONEBOOK_SIZE:
238                         memcpy(&phonebook_size_parser->size_buffer[phonebook_size_parser->pos], data_buffer, bytes_to_consume);
239                         break;
240                     default:
241                         // ignore data
242                         break;
243                 }
244                 phonebook_size_parser->pos += bytes_to_consume;
245                 if (phonebook_size_parser->pos == phonebook_size_parser->len){
246                     phonebook_size_parser->state = PBAP_CLIENT_PHONEBOOK_SIZE_PARSER_STATE_W4_TYPE;
247                     switch (phonebook_size_parser->type){
248                         case PBAP_APPLICATION_PARAMETER_PHONEBOOK_SIZE:
249                             phonebook_size_parser->have_size = true;
250                             break;
251                         default:
252                             break;
253                     }
254                 }
255                 break;
256             default:
257                 break;
258         }
259         data_buffer += bytes_to_consume;
260         data_len    -= bytes_to_consume;
261     }
262 }
263 
264 static void obex_auth_parser_init(pbap_client_obex_auth_parser_t * auth_parser){
265     memset(auth_parser, 0, sizeof(pbap_client_obex_auth_parser_t));
266 }
267 
268 static void obex_auth_parser_process_data(pbap_client_obex_auth_parser_t * auth_parser, const uint8_t * data_buffer, uint16_t data_len){
269     while (data_len){
270         uint16_t bytes_to_consume = 1;
271         switch(auth_parser->state){
272             case OBEX_AUTH_PARSER_STATE_INVALID:
273                 return;
274             case OBEX_AUTH_PARSER_STATE_W4_TYPE:
275                 auth_parser->type = *data_buffer;
276                 auth_parser->state = OBEX_AUTH_PARSER_STATE_W4_LEN;
277                 break;
278             case OBEX_AUTH_PARSER_STATE_W4_LEN:
279                 auth_parser->len = *data_buffer;
280                 switch (auth_parser->type){
281                     case 0:
282                         if (auth_parser->len != 0x10){
283                             auth_parser->state = OBEX_AUTH_PARSER_STATE_INVALID;
284                             return;
285                         }
286                         break;
287                     case 1:
288                         if (auth_parser->len != 0x01){
289                             auth_parser->state = OBEX_AUTH_PARSER_STATE_INVALID;
290                             return;
291                         }
292                         break;
293                     case 2:
294                         // TODO: handle charset
295                         // charset_code = challenge_data[i];
296                         break;
297                     default:
298                         break;
299                 }
300                 auth_parser->state = OBEX_AUTH_PARSER_STATE_W4_VALUE;
301                 break;
302             case OBEX_AUTH_PARSER_STATE_W4_VALUE:
303                 bytes_to_consume = btstack_min(auth_parser->len - auth_parser->pos, data_len);
304                 switch (auth_parser->type){
305                     case 0:
306                         memcpy(&auth_parser->authentication_nonce[auth_parser->pos], data_buffer, bytes_to_consume);
307                         break;
308                     case 1:
309                         auth_parser->authentication_options = *data_buffer;
310                         break;
311                     default:
312                         // ignore
313                         break;
314                 }
315                 auth_parser->pos += bytes_to_consume;
316                 if (auth_parser->pos == auth_parser->len){
317                     auth_parser->state = OBEX_AUTH_PARSER_STATE_W4_TYPE;
318                 }
319                 break;
320             default:
321                 btstack_unreachable();
322                 break;
323         }
324         data_buffer += bytes_to_consume;
325         data_len    -= bytes_to_consume;
326     }
327 }
328 
329 static void pbap_client_yml_append_character(yxml_t * xml_parser, char * buffer, uint16_t buffer_size){
330     // "In UTF-8, characters from the U+0000..U+10FFFF range (the UTF-16 accessible range) are encoded using sequences of 1 to 4 octets."
331     uint16_t char_len = (uint16_t) strlen(xml_parser->data);
332     btstack_assert(char_len <= 4);
333     uint16_t dest_len = (uint16_t) strlen(buffer);
334     uint16_t zero_pos = dest_len + char_len;
335     if (zero_pos >= buffer_size) return;
336     memcpy(&buffer[dest_len], xml_parser->data, char_len);
337     buffer[zero_pos] = '\0';
338 }
339 
340 static void pbap_client_process_vcard_list_body(pbap_client_t *client, const uint8_t *data, uint16_t data_len) {
341 
342     while (data_len--) {
343         yxml_ret_t r = yxml_parse(&client->xml_parser, *data++);
344         switch (r) {
345             case YXML_ELEMSTART:
346                 client->parser_card_found = strcmp("card", client->xml_parser.elem) == 0;
347                 break;
348             case YXML_ELEMEND:
349                 if (client->parser_card_found) {
350                     pbap_client_emit_card_result_event(client, client->parser_name,
351                                                        client->parser_handle);
352                 }
353                 client->parser_card_found = false;
354                 break;
355             case YXML_ATTRSTART:
356                 if (!client->parser_card_found) break;
357                 if (strcmp("name", client->xml_parser.attr) == 0) {
358                     client->parser_name_found = true;
359                     client->parser_name[0] = 0;
360                     break;
361                 }
362                 if (strcmp("handle", client->xml_parser.attr) == 0) {
363                     client->parser_handle_found = true;
364                     client->parser_handle[0] = 0;
365                     break;
366                 }
367                 break;
368             case YXML_ATTRVAL:
369                 if (client->parser_name_found) {
370                     pbap_client_yml_append_character(&client->xml_parser,
371                                                      client->parser_name,
372                                                      sizeof(client->parser_name));
373                     break;
374                 }
375                 if (client->parser_handle_found) {
376                     pbap_client_yml_append_character(&client->xml_parser,
377                                                      client->parser_handle,
378                                                      sizeof(client->parser_handle));
379                     break;
380                 }
381                 break;
382             case YXML_ATTREND:
383                 client->parser_name_found = false;
384                 client->parser_handle_found = false;
385                 break;
386             default:
387                 break;
388         }
389     }
390 }
391 
392 static void pbap_client_parser_callback_connect(void * user_data, uint8_t header_id, uint16_t total_len, uint16_t data_offset, const uint8_t * data_buffer, uint16_t data_len){
393     pbap_client_t * client = (pbap_client_t *) user_data;
394     switch (header_id){
395         case OBEX_HEADER_CONNECTION_ID:
396             if (obex_parser_header_store(client->obex_header_buffer, sizeof(client->obex_header_buffer), total_len, data_offset, data_buffer, data_len) == OBEX_PARSER_HEADER_COMPLETE){
397                 goep_client_set_connection_id(client->goep_cid, big_endian_read_32(client->obex_header_buffer, 0));
398             }
399             break;
400         case OBEX_HEADER_AUTHENTICATION_CHALLENGE:
401             obex_auth_parser_process_data(&client->obex_auth_parser, data_buffer, data_len);
402             break;
403         default:
404             break;
405     }
406 }
407 
408 static void pbap_client_parser_callback_get_phonebook_size(void * user_data, uint8_t header_id, uint16_t total_len, uint16_t data_offset, const uint8_t * data_buffer, uint16_t data_len){
409     UNUSED(total_len);
410     UNUSED(data_offset);
411     pbap_client_t *client = (pbap_client_t *) user_data;
412     switch (header_id) {
413         case OBEX_HEADER_APPLICATION_PARAMETERS:
414             pbap_client_phonebook_size_parser_process_data(&client->phonebook_size_parser, data_buffer, data_len);
415             break;
416         default:
417             break;
418     }
419 }
420 
421 static void pbap_client_parser_callback_get_operation(void * user_data, uint8_t header_id, uint16_t total_len, uint16_t data_offset, const uint8_t * data_buffer, uint16_t data_len){
422     pbap_client_t *client = (pbap_client_t *) user_data;
423     switch (header_id) {
424         case OBEX_HEADER_SINGLE_RESPONSE_MODE:
425             obex_parser_header_store(&client->obex_srm.srm_value, 1, total_len, data_offset, data_buffer, data_len);
426             break;
427         case OBEX_HEADER_SINGLE_RESPONSE_MODE_PARAMETER:
428             obex_parser_header_store(&client->obex_srm.srmp_value, 1, total_len, data_offset, data_buffer, data_len);
429             break;
430         case OBEX_HEADER_BODY:
431         case OBEX_HEADER_END_OF_BODY:
432             switch(client->state){
433                 case PBAP_CLIENT_W4_PHONEBOOK:
434                 case PBAP_CLIENT_W4_GET_CARD_ENTRY_COMPLETE:
435                     client->client_handler(PBAP_DATA_PACKET, client->goep_cid, (uint8_t *) data_buffer, data_len);
436                     if (data_offset + data_len == total_len){
437                         client->flow_wait_for_user = true;
438                     }
439                     break;
440                 case PBAP_CLIENT_W4_GET_CARD_LIST_COMPLETE:
441                     pbap_client_process_vcard_list_body(client, data_buffer, data_len);
442                     break;
443                 default:
444                     btstack_unreachable();
445                     break;
446             }
447             break;
448         default:
449             // ignore other headers
450             break;
451     }
452 }
453 
454 static uint16_t pbap_client_application_params_add_vcard_selector(const pbap_client_t * client, uint8_t * application_parameters){
455     uint16_t pos = 0;
456     if (client->vcard_selector_supported){
457         // vCard Selector
458         if (client->vcard_selector){
459             application_parameters[pos++] = PBAP_APPLICATION_PARAMETER_VCARD_SELECTOR;
460             application_parameters[pos++] = 8;
461             memset(&application_parameters[pos], 0, 4);
462             pos += 4;
463             big_endian_store_32(application_parameters, pos, client->vcard_selector);
464             pos += 4;
465         }
466         // vCard Selector Operator
467         if (client->vcard_selector_operator != PBAP_VCARD_SELECTOR_OPERATOR_OR){
468             application_parameters[pos++] = PBAP_APPLICATION_PARAMETER_VCARD_SELECTOR_OPERATOR;
469             application_parameters[pos++] = 1;
470             application_parameters[pos++] = client->vcard_selector_operator;
471         }
472     }
473     return pos;
474 }
475 
476 static uint16_t pbap_client_application_params_add_max_list_count(const pbap_client_t * client, uint8_t * application_parameters, uint16_t max_count){
477     UNUSED(client);
478     uint16_t pos = 0;
479     application_parameters[pos++] = PBAP_APPLICATION_PARAMETER_MAX_LIST_COUNT;
480     application_parameters[pos++] = 2;
481     big_endian_store_16(application_parameters, 2, max_count);
482     pos += 2;
483     return pos;
484 }
485 
486 static uint16_t pbap_client_application_params_add_list_start_offset(const pbap_client_t * client, uint8_t * application_parameters, uint16_t list_start_offset){
487     uint16_t pos = 0;
488     if (client->list_start_offset != 0){
489         application_parameters[pos++] = PBAP_APPLICATION_PARAMETER_LIST_START_OFFSET;
490         application_parameters[pos++] = 2;
491         big_endian_store_16(application_parameters, 2, list_start_offset);
492         pos += 2;
493     }
494     return pos;
495 }
496 
497 // max size: PBAP_MAX_PHONE_NUMBER_LEN + 5
498 static uint16_t pbap_client_application_params_add_phone_number(const pbap_client_t * client, uint8_t * application_parameters){
499     uint16_t pos = 0;
500     if (client->phone_number){
501         // Search by phone number
502         uint16_t phone_number_len = btstack_min(PBAP_MAX_PHONE_NUMBER_LEN, (uint16_t) strlen(client->phone_number));
503         application_parameters[pos++] = PBAP_APPLICATION_PARAMETER_SEARCH_VALUE;
504 		btstack_assert(phone_number_len <= 255);
505         application_parameters[pos++] = (uint8_t) phone_number_len;
506         (void)memcpy(&application_parameters[pos],
507                      client->phone_number, phone_number_len);
508         pos += phone_number_len;
509         application_parameters[pos++] = PBAP_APPLICATION_PARAMETER_SEARCH_PROPERTY;
510         application_parameters[pos++] = 1;
511         application_parameters[pos++] = 0x01; // Number
512     }
513     return pos;
514 }
515 
516 static uint16_t pbap_client_application_params_add_property_selector(const pbap_client_t * client, uint8_t * application_parameters){
517     // TODO: support format
518     uint16_t pos = 0;
519     uint32_t property_selector_lower = client->property_selector;
520     if (client->vcard_name != NULL){
521         if (strncmp(client->vcard_name, "X-BT-UID:", 9) == 0) {
522             property_selector_lower |= 1U << 31;
523         }
524         if (strncmp(client->vcard_name, "X-BT-UCI:", 9) == 0) {
525             property_selector_lower |= 1U << 30;
526         }
527     }
528     if (property_selector_lower != 0){
529         application_parameters[pos++] = PBAP_APPLICATION_PARAMETER_PROPERTY_SELECTOR;
530         application_parameters[pos++] = 8;
531         big_endian_store_32(application_parameters, pos, 0);    // upper 32-bits are reserved/unused so far
532         pos += 4;
533         big_endian_store_32(application_parameters, pos, property_selector_lower);
534         pos += 4;
535     }
536     return pos;
537 }
538 
539 // Mandatory if the PSE advertises a PbapSupportedFeatures attribute in its SDP record, else excluded.
540 static uint16_t pbap_client_application_parameters_add_supported_features(const pbap_client_t * client, uint8_t *application_parameters) {
541     uint16_t pos = 0;
542     if (goep_client_get_pbap_supported_features(client->goep_cid) != PBAP_FEATURES_NOT_PRESENT){
543         application_parameters[pos++] = PBAP_APPLICATION_PARAMETER_PBAP_SUPPORTED_FEATURES;
544         application_parameters[pos++] = 4;
545         big_endian_store_32(application_parameters, 2, pbap_client_supported_features);
546         pos += 4;
547     }
548     return pos;
549 }
550 
551 static void pbap_client_add_application_parameters(const pbap_client_t * client, uint8_t * application_parameters, uint16_t len){
552     if (len > 0){
553         goep_client_header_add_application_parameters(client->goep_cid, &application_parameters[0], len);
554     }
555 }
556 
557 static void pbap_client_prepare_srm_header(pbap_client_t * client){
558     if (client->flow_control_enabled == false){
559         obex_srm_client_prepare_header(&client->obex_srm, client->goep_cid);
560     }
561 }
562 
563 static void pbap_client_prepare_get_operation(pbap_client_t * client){
564     obex_parser_init_for_response(&client->obex_parser, OBEX_OPCODE_GET, pbap_client_parser_callback_get_operation, client);
565     obex_srm_client_reset_fields(&client->obex_srm);
566     client->obex_parser_waiting_for_response = true;
567 }
568 
569 static void pbap_handle_can_send_now(pbap_client_t *pbap_client) {
570     uint16_t path_element_start;
571     uint16_t path_element_len;
572     const char * path_element;
573     uint8_t  application_parameters[PBAP_MAX_PHONE_NUMBER_LEN + 10];
574     uint8_t  challenge_response[36];
575     uint16_t pos;
576 
577     MD5_CTX md5_ctx;
578 
579     if (pbap_client->abort_operation){
580         pbap_client->abort_operation = 0;
581         // prepare request
582         goep_client_request_create_abort(pbap_client->goep_cid);
583         // state
584         pbap_client->state = PBAP_CLIENT_W4_ABORT_COMPLETE;
585         // prepare response
586         obex_parser_init_for_response(&pbap_client->obex_parser, OBEX_OPCODE_ABORT, NULL, pbap_client);
587         obex_srm_client_init(&pbap_client->obex_srm);
588         pbap_client->obex_parser_waiting_for_response = true;
589         // send packet
590         goep_client_execute(pbap_client->goep_cid);
591         return;
592     }
593 
594     switch (pbap_client->state){
595         case PBAP_CLIENT_W2_SEND_CONNECT_REQUEST:
596             // prepare request
597             goep_client_request_create_connect(pbap_client->goep_cid, OBEX_VERSION, 0, OBEX_MAX_PACKETLEN_DEFAULT);
598             goep_client_header_add_target(pbap_client->goep_cid, pbap_uuid, 16);
599             pos = 0;
600             pos += pbap_client_application_parameters_add_supported_features(pbap_client, &application_parameters[pos]);
601             pbap_client_add_application_parameters(pbap_client, application_parameters, pos);
602             // state
603             pbap_client->state = PBAP_CLIENT_W4_CONNECT_RESPONSE;
604             // prepare response
605             obex_parser_init_for_response(&pbap_client->obex_parser, OBEX_OPCODE_CONNECT, pbap_client_parser_callback_connect, pbap_client);
606             obex_auth_parser_init(&pbap_client->obex_auth_parser);
607             obex_srm_client_init(&pbap_client->obex_srm);
608             pbap_client->obex_parser_waiting_for_response = true;
609             // send packet
610             goep_client_execute(pbap_client->goep_cid);
611             break;
612         case PBAP_CLIENT_W2_SEND_AUTHENTICATED_CONNECT:
613             // prepare request
614             goep_client_request_create_connect(pbap_client->goep_cid, OBEX_VERSION, 0, OBEX_MAX_PACKETLEN_DEFAULT);
615             goep_client_header_add_target(pbap_client->goep_cid, pbap_uuid, 16);
616             // setup authentication challenge response
617             pos = 0;
618             challenge_response[pos++] = 0;  // Tag Digest
619             challenge_response[pos++] = 16; // Len
620             // calculate md5
621             MD5_Init(&md5_ctx);
622             MD5_Update(&md5_ctx, pbap_client->obex_auth_parser.authentication_nonce, 16);
623             MD5_Update(&md5_ctx, &colon, 1);
624             MD5_Update(&md5_ctx, pbap_client->authentication_password, (uint16_t) strlen(pbap_client->authentication_password));
625             MD5_Final(&challenge_response[pos], &md5_ctx);
626             pos += 16;
627             challenge_response[pos++] = 2;  // Tag Nonce
628             challenge_response[pos++] = 16; // Len
629             (void)memcpy(&challenge_response[pos], pbap_client->obex_auth_parser.authentication_nonce, 16);
630             pos += 16;
631             goep_client_header_add_challenge_response(pbap_client->goep_cid, challenge_response, pos);
632             // state
633             pbap_client->state = PBAP_CLIENT_W4_CONNECT_RESPONSE;
634             // prepare response
635             obex_parser_init_for_response(&pbap_client->obex_parser, OBEX_OPCODE_CONNECT, pbap_client_parser_callback_connect, pbap_client);
636             obex_srm_client_init(&pbap_client->obex_srm);
637             pbap_client->obex_parser_waiting_for_response = true;
638             // send packet
639             goep_client_execute(pbap_client->goep_cid);
640             break;
641         case PBAP_CLIENT_W2_SEND_DISCONNECT_REQUEST:
642             // prepare request
643             goep_client_request_create_disconnect(pbap_client->goep_cid);
644             // state
645             pbap_client->state = PBAP_CLIENT_W4_DISCONNECT_RESPONSE;
646             // prepare response
647             obex_parser_init_for_response(&pbap_client->obex_parser, OBEX_OPCODE_DISCONNECT, NULL, pbap_client);
648             obex_srm_client_init(&pbap_client->obex_srm);
649             pbap_client->obex_parser_waiting_for_response = true;
650             // send packet
651             goep_client_execute(pbap_client->goep_cid);
652             return;
653         case PBAP_CLIENT_W2_GET_PHONEBOOK_SIZE:
654             // prepare request
655             goep_client_request_create_get(pbap_client->goep_cid);
656             pbap_client_prepare_srm_header(pbap_client);
657             goep_client_header_add_name(pbap_client->goep_cid, pbap_client->phonebook_path);
658             goep_client_header_add_type(pbap_client->goep_cid, pbap_phonebook_type);
659 
660             pos = 0;
661             pos += pbap_client_application_params_add_vcard_selector(pbap_client, &application_parameters[pos]);
662             // just get size
663             pos += pbap_client_application_params_add_max_list_count(pbap_client, &application_parameters[pos], 0);
664             pbap_client_add_application_parameters(pbap_client, application_parameters, pos);
665 
666             // state
667             pbap_client->state = PBAP_CLIENT_W4_GET_PHONEBOOK_SIZE_COMPLETE;
668             // prepare response
669             obex_parser_init_for_response(&pbap_client->obex_parser, OBEX_OPCODE_GET, pbap_client_parser_callback_get_phonebook_size, pbap_client);
670             obex_srm_client_init(&pbap_client->obex_srm);
671             pbap_client_phonebook_size_parser_init(&pbap_client->phonebook_size_parser);
672             pbap_client->obex_parser_waiting_for_response = true;
673             // send packet
674             goep_client_execute(pbap_client->goep_cid);
675             break;
676         case PBAP_CLIENT_W2_PULL_PHONEBOOK:
677             // prepare request
678             goep_client_request_create_get(pbap_client->goep_cid);
679             if (pbap_client->request_number == 0){
680                 obex_srm_client_init(&pbap_client->obex_srm);
681                 pbap_client_prepare_srm_header(pbap_client);
682                 goep_client_header_add_name(pbap_client->goep_cid, pbap_client->phonebook_path);
683                 goep_client_header_add_type(pbap_client->goep_cid, pbap_phonebook_type);
684 
685                 pos = 0;
686                 pos += pbap_client_application_params_add_property_selector(pbap_client, &application_parameters[pos]);
687                 if (pbap_client->max_list_count){
688                     pos += pbap_client_application_params_add_max_list_count(pbap_client, &application_parameters[pos], pbap_client->max_list_count);
689                 }
690                 pos += pbap_client_application_params_add_list_start_offset (pbap_client, &application_parameters[pos], pbap_client->list_start_offset);
691                 pos += pbap_client_application_params_add_vcard_selector(pbap_client, &application_parameters[pos]);
692                 pbap_client_add_application_parameters(pbap_client, application_parameters, pos);
693             }
694             // state
695             pbap_client->state = PBAP_CLIENT_W4_PHONEBOOK;
696             pbap_client->flow_next_triggered = 0;
697             pbap_client->flow_wait_for_user = 0;
698             // prepare response
699             pbap_client_prepare_get_operation(pbap_client);
700             // send packet
701             pbap_client->request_number++;
702             goep_client_execute(pbap_client->goep_cid);
703             break;
704         case PBAP_CLIENT_W2_GET_CARD_LIST:
705             // prepare request
706             goep_client_request_create_get(pbap_client->goep_cid);
707             if (pbap_client->request_number == 0){
708                 obex_srm_client_init(&pbap_client->obex_srm);
709                 pbap_client_prepare_srm_header(pbap_client);
710                 goep_client_header_add_name(pbap_client->goep_cid, pbap_client->phonebook_path);
711                 goep_client_header_add_type(pbap_client->goep_cid, pbap_vcard_listing_type);
712 
713                 pos = 0;
714                 pos += pbap_client_application_params_add_vcard_selector(pbap_client, &application_parameters[pos]);
715                 pos += pbap_client_application_params_add_phone_number(pbap_client, &application_parameters[pos]);
716                 pbap_client_add_application_parameters(pbap_client, application_parameters, pos);
717             }
718             // state
719             pbap_client->state = PBAP_CLIENT_W4_GET_CARD_LIST_COMPLETE;
720             // prepare response
721             pbap_client_prepare_get_operation(pbap_client);
722             // send packet
723             pbap_client->request_number++;
724             goep_client_execute(pbap_client->goep_cid);
725             break;
726         case PBAP_CLIENT_W2_GET_CARD_ENTRY:
727             // prepare request
728             goep_client_request_create_get(pbap_client->goep_cid);
729             if (pbap_client->request_number == 0){
730                 obex_srm_client_init(&pbap_client->obex_srm);
731                 pbap_client_prepare_srm_header(pbap_client);
732                 goep_client_header_add_name(pbap_client->goep_cid, pbap_client->vcard_name);
733                 goep_client_header_add_type(pbap_client->goep_cid, pbap_vcard_entry_type);
734 
735                 pos = 0;
736                 pos += pbap_client_application_params_add_property_selector(pbap_client, &application_parameters[pos]);
737                 pbap_client_add_application_parameters(pbap_client, application_parameters, pos);
738             }
739             // state
740             pbap_client->state = PBAP_CLIENT_W4_GET_CARD_ENTRY_COMPLETE;
741             // prepare response
742             pbap_client_prepare_get_operation(pbap_client);
743             // send packet
744             pbap_client->request_number++;
745             goep_client_execute(pbap_client->goep_cid);
746             break;
747         case PBAP_CLIENT_W2_SET_PATH_ROOT:
748             // prepare request
749             goep_client_request_create_set_path(pbap_client->goep_cid, 1 << 1); // Don’t create directory
750             goep_client_header_add_name(pbap_client->goep_cid, "");
751             // state
752             pbap_client->state = PBAP_CLIENT_W4_SET_PATH_ROOT_COMPLETE;
753             // prepare response
754             obex_parser_init_for_response(&pbap_client->obex_parser, OBEX_OPCODE_SETPATH, NULL, pbap_client);
755             obex_srm_client_init(&pbap_client->obex_srm);
756             pbap_client->obex_parser_waiting_for_response = true;
757             // send packet
758             goep_client_execute(pbap_client->goep_cid);
759             break;
760         case PBAP_CLIENT_W2_SET_PATH_ELEMENT:
761             // prepare request
762             // find '/' or '\0'
763             path_element_start = pbap_client->set_path_offset;
764             while ((pbap_client->current_folder[pbap_client->set_path_offset] != '\0') &&
765                 (pbap_client->current_folder[pbap_client->set_path_offset] != '/')){
766                 pbap_client->set_path_offset++;
767             }
768             path_element_len = pbap_client->set_path_offset-path_element_start;
769             path_element = (const char *) &pbap_client->current_folder[path_element_start];
770 
771             // skip /
772             if (pbap_client->current_folder[pbap_client->set_path_offset] == '/'){
773                 pbap_client->set_path_offset++;
774             }
775 
776             goep_client_request_create_set_path(pbap_client->goep_cid, 1 << 1); // Don’t create directory
777             goep_client_header_add_name_prefix(pbap_client->goep_cid, path_element, path_element_len); // next element
778             // state
779             pbap_client->state = PBAP_CLIENT_W4_SET_PATH_ELEMENT_COMPLETE;
780             // prepare response
781             obex_parser_init_for_response(&pbap_client->obex_parser, OBEX_OPCODE_SETPATH, NULL, pbap_client);
782             obex_srm_client_init(&pbap_client->obex_srm);
783             pbap_client->obex_parser_waiting_for_response = true;
784             // send packet
785             goep_client_execute(pbap_client->goep_cid);
786             break;
787         default:
788             break;
789     }
790 }
791 
792 static void pbap_packet_handler_hci(uint8_t *packet, uint16_t size){
793     UNUSED(size);
794     uint8_t status;
795 
796     pbap_client_t * client;
797 
798     switch (hci_event_packet_get_type(packet)) {
799         case HCI_EVENT_GOEP_META:
800             switch (hci_event_goep_meta_get_subevent_code(packet)){
801                 case GOEP_SUBEVENT_CONNECTION_OPENED:
802                     client = pbap_client_for_cid(goep_subevent_connection_opened_get_goep_cid(packet));
803                     btstack_assert(client != NULL);
804                     status = goep_subevent_connection_opened_get_status(packet);
805                     goep_subevent_connection_opened_get_bd_addr(packet, client->bd_addr);
806                     if (status){
807                         log_info("pbap: connection failed %u", status);
808                         pbap_client_finalize(client);
809                         pbap_client_emit_connected_event(client, status);
810                     } else {
811                         log_info("pbap: connection established");
812                         client->con_handle = goep_subevent_connection_opened_get_con_handle(packet);
813                         client->state = PBAP_CLIENT_W2_SEND_CONNECT_REQUEST;
814                         goep_client_request_can_send_now(client->goep_cid);
815                     }
816                     break;
817                 case GOEP_SUBEVENT_CONNECTION_CLOSED:
818                     client = pbap_client_for_cid(goep_subevent_connection_closed_get_goep_cid(packet));
819                     btstack_assert(client != NULL);
820                     if (client->state > PBAP_CLIENT_CONNECTED){
821                         pbap_client_emit_operation_complete_event(client, OBEX_DISCONNECTED);
822                     }
823                     pbap_client_finalize(client);
824                     pbap_client_emit_connection_closed_event(client);
825                     break;
826                 case GOEP_SUBEVENT_CAN_SEND_NOW:
827                     client = pbap_client_for_cid(goep_subevent_can_send_now_get_goep_cid(packet));
828                     btstack_assert(client != NULL);
829                     pbap_handle_can_send_now(client);
830                     break;
831                 default:
832                     break;
833             }
834             break;
835         default:
836             break;
837     }
838 }
839 
840 static void pbap_packet_handler_goep(pbap_client_t *client, uint8_t *packet, uint16_t size) {
841 
842     if (client->obex_parser_waiting_for_response == false) return;
843 
844     obex_parser_object_state_t parser_state;
845     parser_state = obex_parser_process_data(&client->obex_parser, packet, size);
846     if (parser_state == OBEX_PARSER_OBJECT_STATE_COMPLETE){
847         client->obex_parser_waiting_for_response = false;
848         obex_parser_operation_info_t op_info;
849         obex_parser_get_operation_info(&client->obex_parser, &op_info);
850         switch (client->state){
851             case PBAP_CLIENT_W4_CONNECT_RESPONSE:
852                 switch (op_info.response_code) {
853                     case OBEX_RESP_SUCCESS:
854                         client->state = PBAP_CLIENT_CONNECTED;
855                         client->vcard_selector_supported = pbap_client_supported_features & goep_client_get_pbap_supported_features(client->goep_cid) & PBAP_SUPPORTED_FEATURES_VCARD_SELECTING;
856                         pbap_client_emit_connected_event(client, ERROR_CODE_SUCCESS);
857                         break;
858                     case OBEX_RESP_UNAUTHORIZED:
859                         client->state = PBAP_CLIENT_W4_USER_AUTHENTICATION;
860                         pbap_client_emit_authentication_event(client, client->obex_auth_parser.authentication_options);
861                         break;
862                     default:
863                         log_info("pbap: obex connect failed, result 0x%02x", packet[0]);
864                         client->state = PBAP_CLIENT_INIT;
865                         pbap_client_emit_connected_event(client, OBEX_CONNECT_FAILED);
866                         break;
867                 }
868                 break;
869             case PBAP_CLIENT_W4_DISCONNECT_RESPONSE:
870                 client->state = PBAP_CLIENT_CONNECTED;
871                 goep_client_disconnect(client->goep_cid);
872                 break;
873             case PBAP_CLIENT_W4_SET_PATH_ROOT_COMPLETE:
874             case PBAP_CLIENT_W4_SET_PATH_ELEMENT_COMPLETE:
875                 switch (op_info.response_code) {
876                     case OBEX_RESP_SUCCESS:
877                         // more path?
878                         if (client->current_folder[client->set_path_offset]) {
879                             client->state = PBAP_CLIENT_W2_SET_PATH_ELEMENT;
880                             goep_client_request_can_send_now(client->goep_cid);
881                         } else {
882                             client->current_folder = NULL;
883                             client->state = PBAP_CLIENT_CONNECTED;
884                             pbap_client_emit_operation_complete_event(client, ERROR_CODE_SUCCESS);
885                         }
886                         break;
887                     case OBEX_RESP_NOT_FOUND:
888                         client->state = PBAP_CLIENT_CONNECTED;
889                         pbap_client_emit_operation_complete_event(client, OBEX_NOT_FOUND);
890                         break;
891                     default:
892                         client->state = PBAP_CLIENT_CONNECTED;
893                         pbap_client_emit_operation_complete_event(client, OBEX_UNKNOWN_ERROR);
894                         break;
895                 }
896                 break;
897             case PBAP_CLIENT_W4_PHONEBOOK:
898                 switch (op_info.response_code) {
899                     case OBEX_RESP_CONTINUE:
900                         obex_srm_client_handle_headers(&client->obex_srm);
901                         if (obex_srm_client_is_srm_active(&client->obex_srm)) {
902                             // prepare response
903                             pbap_client_prepare_get_operation(client);
904                             break;
905                         }
906                         client->state = PBAP_CLIENT_W2_PULL_PHONEBOOK;
907                         if (!client->flow_control_enabled || !client->flow_wait_for_user ||
908                             client->flow_next_triggered) {
909                             goep_client_request_can_send_now(client->goep_cid);
910                         }
911                         break;
912                     case OBEX_RESP_SUCCESS:
913                         client->state = PBAP_CLIENT_CONNECTED;
914                         pbap_client_emit_operation_complete_event(client, ERROR_CODE_SUCCESS);
915                         break;
916                     default:
917                         log_info("unexpected response 0x%02x", packet[0]);
918                         client->state = PBAP_CLIENT_CONNECTED;
919                         pbap_client_emit_operation_complete_event(client, OBEX_UNKNOWN_ERROR);
920                         break;
921                 }
922                 break;
923             case PBAP_CLIENT_W4_GET_PHONEBOOK_SIZE_COMPLETE:
924                 switch (op_info.response_code) {
925                     case OBEX_RESP_SUCCESS:
926                         if (client->phonebook_size_parser.have_size) {
927                             uint16_t phonebook_size = big_endian_read_16(client->phonebook_size_parser.size_buffer, 0);
928                             client->state = PBAP_CLIENT_CONNECTED;
929                             pbap_client_emit_phonebook_size_event(client, 0, phonebook_size);
930                             break;
931                         }
932                         /* fall through */
933                     default:
934                         client->state = PBAP_CLIENT_CONNECTED;
935                         pbap_client_emit_phonebook_size_event(client, OBEX_UNKNOWN_ERROR, 0);
936                         break;
937                 }
938                 break;
939             case PBAP_CLIENT_W4_GET_CARD_LIST_COMPLETE:
940                 switch (op_info.response_code) {
941                     case OBEX_RESP_CONTINUE:
942                         // handle continue
943                         obex_srm_client_handle_headers(&client->obex_srm);
944                         if (obex_srm_client_is_srm_active(&client->obex_srm)) {
945                             // prepare response
946                             pbap_client_prepare_get_operation(client);
947                             break;
948                         }
949                         client->state = PBAP_CLIENT_W2_GET_CARD_LIST;
950                         goep_client_request_can_send_now(client->goep_cid);
951                         break;
952                     case OBEX_RESP_SUCCESS:
953                         // done
954                         client->state = PBAP_CLIENT_CONNECTED;
955                         pbap_client_emit_operation_complete_event(client, ERROR_CODE_SUCCESS);
956                         break;
957                     case OBEX_RESP_NOT_ACCEPTABLE:
958                         client->state = PBAP_CLIENT_CONNECTED;
959                         pbap_client_emit_operation_complete_event(client, OBEX_NOT_ACCEPTABLE);
960                         break;
961                     default:
962                         log_info("unexpected response 0x%02x", packet[0]);
963                         client->state = PBAP_CLIENT_CONNECTED;
964                         pbap_client_emit_operation_complete_event(client, OBEX_UNKNOWN_ERROR);
965                         break;
966                 }
967                 break;
968             case PBAP_CLIENT_W4_GET_CARD_ENTRY_COMPLETE:
969                 switch (op_info.response_code) {
970                     case OBEX_RESP_CONTINUE:
971                         obex_srm_client_handle_headers(&client->obex_srm);
972                         if (obex_srm_client_is_srm_active(&client->obex_srm)) {
973                             // prepare response
974                             pbap_client_prepare_get_operation(client);
975                             break;
976                         }
977                         client->state = PBAP_CLIENT_W2_GET_CARD_ENTRY;
978                         goep_client_request_can_send_now(client->goep_cid);
979                         break;
980                     case OBEX_RESP_SUCCESS:
981                         client->state = PBAP_CLIENT_CONNECTED;
982                         pbap_client_emit_operation_complete_event(client, ERROR_CODE_SUCCESS);
983                         break;
984                     case OBEX_RESP_NOT_ACCEPTABLE:
985                         client->state = PBAP_CLIENT_CONNECTED;
986                         pbap_client_emit_operation_complete_event(client, OBEX_NOT_ACCEPTABLE);
987                         break;
988                     default:
989                         log_info("unexpected response 0x%02x", packet[0]);
990                         client->state = PBAP_CLIENT_CONNECTED;
991                         pbap_client_emit_operation_complete_event(client, OBEX_UNKNOWN_ERROR);
992                         break;
993                 }
994                 break;
995             case PBAP_CLIENT_W4_ABORT_COMPLETE:
996                 client->state = PBAP_CLIENT_CONNECTED;
997                 pbap_client_emit_operation_complete_event(client, OBEX_ABORTED);
998                 break;
999             default:
1000                 btstack_unreachable();
1001                 break;
1002         }
1003     }
1004 }
1005 
1006 static void pbap_packet_handler(uint8_t packet_type, uint16_t channel, uint8_t *packet, uint16_t size){
1007     UNUSED(channel); // ok: there is no channel
1008     UNUSED(size);    // ok: handling own geop events
1009 
1010     pbap_client_t * client;
1011 
1012     switch (packet_type){
1013         case HCI_EVENT_PACKET:
1014             pbap_packet_handler_hci(packet, size);
1015             break;
1016         case GOEP_DATA_PACKET:
1017             client = pbap_client_for_cid(channel);
1018             btstack_assert(client != NULL);
1019             pbap_packet_handler_goep(client, packet, size);
1020             break;
1021         default:
1022             break;
1023     }
1024 }
1025 
1026 void pbap_client_init(void){
1027     pbap_client_supported_features =
1028             PBAP_SUPPORTED_FEATURES_DOWNLOAD |
1029             PBAP_SUPPORTED_FEATURES_BROWSING |
1030             PBAP_SUPPORTED_FEATURES_DATABASE_IDENTIFIER |
1031             PBAP_SUPPORTED_FEATURES_FOLDER_VERSION_COUNTERS |
1032             PBAP_SUPPORTED_FEATURES_VCARD_SELECTING |
1033             PBAP_SUPPORTED_FEATURES_ENHANCED_MISSED_CALLS |
1034             PBAP_SUPPORTED_FEATURES_DEFAULT_CONTACT_IMAGE_FORMAT |
1035             PBAP_SUPPORTED_FEATURES_X_BT_UCI_VCARD_PROPERTY |
1036             PBAP_SUPPORTED_FEATURES_X_BT_UID_VCARD_PROPERTY |
1037             PBAP_SUPPORTED_FEATURES_CONTACT_REFERENCING;
1038 
1039     pbap_client_singleton_used = false;
1040 }
1041 
1042 void pbap_client_deinit(void){
1043 }
1044 
1045 uint8_t pbap_client_connect(pbap_client_t * client, l2cap_ertm_config_t *l2cap_ertm_config, uint8_t *l2cap_ertm_buffer,
1046                             uint16_t l2cap_ertm_buffer_size, btstack_packet_handler_t handler, bd_addr_t addr, uint16_t * out_cid) {
1047     client->state = PBAP_CLIENT_W4_GOEP_CONNECTION;
1048     client->client_handler = handler;
1049     client->vcard_selector = 0;
1050     client->vcard_selector_operator = PBAP_VCARD_SELECTOR_OPERATOR_OR;
1051 
1052     btstack_linked_list_add(&pbap_clients, (btstack_linked_item_t*) client);
1053 
1054     uint8_t status = goep_client_connect(&client->goep_client, l2cap_ertm_config, l2cap_ertm_buffer, l2cap_ertm_buffer_size,
1055                                          &pbap_packet_handler, addr, BLUETOOTH_SERVICE_CLASS_PHONEBOOK_ACCESS_PSE, 0, &client->goep_cid);
1056     *out_cid = client->goep_cid;
1057 
1058     if (status) {
1059         pbap_client_finalize(client);
1060     }
1061     return status;
1062 }
1063 
1064 uint8_t pbap_connect(btstack_packet_handler_t handler, bd_addr_t addr, uint16_t * out_cid){
1065     static pbap_client_t pbap_client_singleton;
1066 
1067     l2cap_ertm_config_t *l2cap_ertm_config = NULL;
1068     uint8_t *l2cap_ertm_buffer = NULL;
1069     uint16_t l2cap_ertm_buffer_size = 0;
1070 
1071 #ifdef ENABLE_GOEP_L2CAP
1072 // singleton instance
1073     static uint8_t pbap_client_singleton_ertm_buffer[1000];
1074     static l2cap_ertm_config_t pbap_client_singleton_ertm_config = {
1075             1,  // ertm mandatory
1076             2,  // max transmit, some tests require > 1
1077             2000,
1078             12000,
1079             512,    // l2cap ertm mtu
1080             2,
1081             2,
1082             1,      // 16-bit FCS
1083     };
1084 
1085     l2cap_ertm_config = &pbap_client_singleton_ertm_config;
1086     l2cap_ertm_buffer = pbap_client_singleton_ertm_buffer;
1087     l2cap_ertm_buffer_size = sizeof(pbap_client_singleton_ertm_buffer);
1088 #endif
1089 
1090     if (pbap_client_singleton_used && pbap_client_singleton.state != PBAP_CLIENT_INIT){
1091         return BTSTACK_MEMORY_ALLOC_FAILED;
1092     }
1093 
1094     pbap_client_singleton_used = true;
1095 
1096     memset(&pbap_client_singleton, 0, sizeof(pbap_client_t));
1097     return pbap_client_connect(&pbap_client_singleton, l2cap_ertm_config, l2cap_ertm_buffer, l2cap_ertm_buffer_size, handler, addr, out_cid);
1098 }
1099 
1100 uint8_t pbap_disconnect(uint16_t pbap_cid){
1101     pbap_client_t * pbap_client = pbap_client_for_cid(pbap_cid);
1102     if (pbap_client == NULL){
1103         return ERROR_CODE_UNKNOWN_CONNECTION_IDENTIFIER;
1104     }
1105     if (pbap_client->state < PBAP_CLIENT_CONNECTED){
1106         return BTSTACK_BUSY;
1107     }
1108     pbap_client->state = PBAP_CLIENT_W2_SEND_DISCONNECT_REQUEST;
1109     goep_client_request_can_send_now(pbap_client->goep_cid);
1110     return ERROR_CODE_SUCCESS;
1111 }
1112 
1113 uint8_t pbap_get_phonebook_size(uint16_t pbap_cid, const char * path){
1114     pbap_client_t * pbap_client = pbap_client_for_cid(pbap_cid);
1115     if (pbap_client == NULL){
1116         return ERROR_CODE_UNKNOWN_CONNECTION_IDENTIFIER;
1117     }
1118     if (pbap_client->state != PBAP_CLIENT_CONNECTED){
1119         return BTSTACK_BUSY;
1120     }
1121     pbap_client->state = PBAP_CLIENT_W2_GET_PHONEBOOK_SIZE;
1122     pbap_client->phonebook_path = path;
1123     pbap_client->request_number = 0;
1124     goep_client_request_can_send_now(pbap_client->goep_cid);
1125     return ERROR_CODE_SUCCESS;
1126 }
1127 
1128 uint8_t pbap_pull_phonebook(uint16_t pbap_cid, const char * path){
1129     pbap_client_t * pbap_client = pbap_client_for_cid(pbap_cid);
1130     if (pbap_client == NULL){
1131         return ERROR_CODE_UNKNOWN_CONNECTION_IDENTIFIER;
1132     }
1133     if (pbap_client->state != PBAP_CLIENT_CONNECTED){
1134         return BTSTACK_BUSY;
1135     }
1136     pbap_client->state = PBAP_CLIENT_W2_PULL_PHONEBOOK;
1137     pbap_client->phonebook_path = path;
1138     pbap_client->vcard_name = NULL;
1139     pbap_client->request_number = 0;
1140     goep_client_request_can_send_now(pbap_client->goep_cid);
1141     return ERROR_CODE_SUCCESS;
1142 }
1143 
1144 uint8_t pbap_set_phonebook(uint16_t pbap_cid, const char * path){
1145     pbap_client_t * pbap_client = pbap_client_for_cid(pbap_cid);
1146     if (pbap_client == NULL){
1147         return ERROR_CODE_UNKNOWN_CONNECTION_IDENTIFIER;
1148     }
1149     if (pbap_client->state != PBAP_CLIENT_CONNECTED){
1150         return BTSTACK_BUSY;
1151     }
1152     pbap_client->state = PBAP_CLIENT_W2_SET_PATH_ROOT;
1153     pbap_client->current_folder = path;
1154     pbap_client->set_path_offset = 0;
1155     goep_client_request_can_send_now(pbap_client->goep_cid);
1156     return ERROR_CODE_SUCCESS;
1157 }
1158 
1159 uint8_t pbap_authentication_password(uint16_t pbap_cid, const char * password){
1160     pbap_client_t * pbap_client = pbap_client_for_cid(pbap_cid);
1161     if (pbap_client == NULL){
1162         return ERROR_CODE_UNKNOWN_CONNECTION_IDENTIFIER;
1163     }
1164     if (pbap_client->state != PBAP_CLIENT_W4_USER_AUTHENTICATION){
1165         return BTSTACK_BUSY;
1166     }
1167     pbap_client->state = PBAP_CLIENT_W2_SEND_AUTHENTICATED_CONNECT;
1168     pbap_client->authentication_password = password;
1169     goep_client_request_can_send_now(pbap_client->goep_cid);
1170     return ERROR_CODE_SUCCESS;
1171 }
1172 
1173 uint8_t pbap_pull_vcard_listing(uint16_t pbap_cid, const char * path){
1174     pbap_client_t * pbap_client = pbap_client_for_cid(pbap_cid);
1175     if (pbap_client == NULL){
1176         return ERROR_CODE_UNKNOWN_CONNECTION_IDENTIFIER;
1177     }
1178     if (pbap_client->state != PBAP_CLIENT_CONNECTED){
1179         return BTSTACK_BUSY;
1180     }
1181     pbap_client->state = PBAP_CLIENT_W2_GET_CARD_LIST;
1182     pbap_client->phonebook_path = path;
1183     pbap_client->phone_number = NULL;
1184     pbap_client->request_number = 0;
1185     pbap_client_vcard_listing_init_parser(pbap_client);
1186     goep_client_request_can_send_now(pbap_client->goep_cid);
1187     return ERROR_CODE_SUCCESS;
1188 }
1189 
1190 uint8_t pbap_pull_vcard_entry(uint16_t pbap_cid, const char * path){
1191     pbap_client_t * pbap_client = pbap_client_for_cid(pbap_cid);
1192     if (pbap_client == NULL){
1193         return ERROR_CODE_UNKNOWN_CONNECTION_IDENTIFIER;
1194     }
1195     if (pbap_client->state != PBAP_CLIENT_CONNECTED){
1196         return BTSTACK_BUSY;
1197     }
1198     pbap_client->state = PBAP_CLIENT_W2_GET_CARD_ENTRY;
1199     // pbap_client->phonebook_path = NULL;
1200     // pbap_client->phone_number = NULL;
1201     pbap_client->vcard_name = path;
1202     pbap_client->request_number = 0;
1203     goep_client_request_can_send_now(pbap_client->goep_cid);
1204     return ERROR_CODE_SUCCESS;
1205 }
1206 
1207 uint8_t pbap_lookup_by_number(uint16_t pbap_cid, const char * phone_number){
1208     pbap_client_t * pbap_client = pbap_client_for_cid(pbap_cid);
1209     if (pbap_client == NULL){
1210         return ERROR_CODE_UNKNOWN_CONNECTION_IDENTIFIER;
1211     }
1212     if (pbap_client->state != PBAP_CLIENT_CONNECTED){
1213         return BTSTACK_BUSY;
1214     }
1215     pbap_client->state = PBAP_CLIENT_W2_GET_CARD_LIST;
1216     pbap_client->phonebook_path = pbap_vcard_listing_name;
1217     pbap_client->phone_number   = phone_number;
1218     pbap_client->request_number = 0;
1219     pbap_client_vcard_listing_init_parser(pbap_client);
1220     goep_client_request_can_send_now(pbap_client->goep_cid);
1221     return ERROR_CODE_SUCCESS;
1222 }
1223 
1224 uint8_t pbap_abort(uint16_t pbap_cid){
1225     pbap_client_t * pbap_client = pbap_client_for_cid(pbap_cid);
1226     if (pbap_client == NULL){
1227         return ERROR_CODE_UNKNOWN_CONNECTION_IDENTIFIER;
1228     }
1229     if ((pbap_client->state < PBAP_CLIENT_CONNECTED) || (pbap_client->abort_operation != 0)){
1230         return ERROR_CODE_COMMAND_DISALLOWED;
1231     }
1232     log_info("abort current operation, state 0x%02x", pbap_client->state);
1233     pbap_client->abort_operation = 1;
1234     return ERROR_CODE_SUCCESS;
1235 }
1236 
1237 uint8_t pbap_next_packet(uint16_t pbap_cid){
1238     pbap_client_t * pbap_client = pbap_client_for_cid(pbap_cid);
1239     if (pbap_client == NULL){
1240         return ERROR_CODE_UNKNOWN_CONNECTION_IDENTIFIER;
1241     }
1242     if (!pbap_client->flow_control_enabled){
1243         return ERROR_CODE_SUCCESS;
1244     }
1245     switch (pbap_client->state){
1246         case PBAP_CLIENT_W2_PULL_PHONEBOOK:
1247             goep_client_request_can_send_now(pbap_client->goep_cid);
1248             break;
1249         case PBAP_CLIENT_W4_PHONEBOOK:
1250             pbap_client->flow_next_triggered = 1;
1251             break;
1252         default:
1253             break;
1254     }
1255     return ERROR_CODE_SUCCESS;
1256 }
1257 
1258 uint8_t pbap_set_flow_control_mode(uint16_t pbap_cid, int enable){
1259     pbap_client_t * pbap_client = pbap_client_for_cid(pbap_cid);
1260     if (pbap_client == NULL){
1261         return ERROR_CODE_UNKNOWN_CONNECTION_IDENTIFIER;
1262     }
1263     if (pbap_client->state != PBAP_CLIENT_CONNECTED){
1264         return BTSTACK_BUSY;
1265     }
1266     pbap_client->flow_control_enabled = enable;
1267     return ERROR_CODE_SUCCESS;
1268 }
1269 
1270 uint8_t pbap_set_vcard_selector(uint16_t pbap_cid, uint32_t vcard_selector){
1271     pbap_client_t * pbap_client = pbap_client_for_cid(pbap_cid);
1272     if (pbap_client == NULL){
1273         return ERROR_CODE_UNKNOWN_CONNECTION_IDENTIFIER;
1274     }
1275     if (pbap_client->state != PBAP_CLIENT_CONNECTED){
1276         return BTSTACK_BUSY;
1277     }
1278     pbap_client->vcard_selector = vcard_selector;
1279     return ERROR_CODE_SUCCESS;
1280 }
1281 
1282 uint8_t pbap_set_vcard_selector_operator(uint16_t pbap_cid, int vcard_selector_operator){
1283     pbap_client_t * pbap_client = pbap_client_for_cid(pbap_cid);
1284     if (pbap_client == NULL){
1285         return ERROR_CODE_UNKNOWN_CONNECTION_IDENTIFIER;
1286     }
1287     if (pbap_client->state != PBAP_CLIENT_CONNECTED){
1288         return BTSTACK_BUSY;
1289     }
1290     pbap_client->vcard_selector_operator = vcard_selector_operator;
1291     return ERROR_CODE_SUCCESS;
1292 }
1293 
1294 uint8_t pbap_set_property_selector(uint16_t pbap_cid, uint32_t property_selector){
1295     pbap_client_t * pbap_client = pbap_client_for_cid(pbap_cid);
1296     if (pbap_client == NULL){
1297         return ERROR_CODE_UNKNOWN_CONNECTION_IDENTIFIER;
1298     }
1299     if (pbap_client->state != PBAP_CLIENT_CONNECTED){
1300         return BTSTACK_BUSY;
1301     }
1302     pbap_client->property_selector  = property_selector;
1303     return ERROR_CODE_SUCCESS;
1304 }
1305 
1306 uint8_t pbap_set_max_list_count(uint16_t pbap_cid, uint16_t max_list_count){
1307     pbap_client_t * pbap_client = pbap_client_for_cid(pbap_cid);
1308     if (pbap_client == NULL){
1309         return ERROR_CODE_UNKNOWN_CONNECTION_IDENTIFIER;
1310     }
1311     if (pbap_client->state != PBAP_CLIENT_CONNECTED){
1312         return BTSTACK_BUSY;
1313     }
1314     pbap_client->max_list_count = max_list_count;
1315     return ERROR_CODE_SUCCESS;
1316 }
1317 
1318 uint8_t pbap_set_list_start_offset(uint16_t pbap_cid, uint16_t list_start_offset){
1319     pbap_client_t * pbap_client = pbap_client_for_cid(pbap_cid);
1320     if (pbap_client == NULL){
1321         return ERROR_CODE_UNKNOWN_CONNECTION_IDENTIFIER;
1322     }
1323     if (pbap_client->state != PBAP_CLIENT_CONNECTED){
1324         return BTSTACK_BUSY;
1325     }
1326     pbap_client->list_start_offset = list_start_offset;
1327     return ERROR_CODE_SUCCESS;
1328 }
1329