xref: /btstack/src/classic/pbap_client.c (revision f84f8a7f220f8305ddfd9996b40dbfe5025a6155)
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 #include "yxml.h"
57 
58 #include "classic/obex.h"
59 #include "classic/obex_iterator.h"
60 #include "classic/goep_client.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 typedef enum {
73     PBAP_INIT = 0,
74     PBAP_W4_GOEP_CONNECTION,
75     PBAP_W2_SEND_CONNECT_REQUEST,
76     PBAP_W4_CONNECT_RESPONSE,
77     PBAP_W4_USER_AUTHENTICATION,
78     PBAP_W2_SEND_AUTHENTICATED_CONNECT,
79     PBAP_CONNECT_RESPONSE_RECEIVED,
80     PBAP_CONNECTED,
81     //
82     PBAP_W2_SEND_DISCONNECT_REQUEST,
83     PBAP_W4_DISCONNECT_RESPONSE,
84     //
85     PBAP_W2_PULL_PHONEBOOK,
86     PBAP_W4_PHONEBOOK,
87     PBAP_W2_SET_PATH_ROOT,
88     PBAP_W4_SET_PATH_ROOT_COMPLETE,
89     PBAP_W2_SET_PATH_ELEMENT,
90     PBAP_W4_SET_PATH_ELEMENT_COMPLETE,
91     PBAP_W2_GET_PHONEBOOK_SIZE,
92     PBAP_W4_GET_PHONEBOOK_SIZE_COMPLETE,
93     // - pull vacard liast
94     PBAP_W2_GET_CARD_LIST,
95     PBAP_W4_GET_CARD_LIST_COMPLETE,
96     // - pull vcard entry
97     PBAP_W2_GET_CARD_ENTRY,
98     PBAP_W4_GET_CARD_ENTRY_COMPLETE
99 
100 } pbap_state_t;
101 
102 typedef enum {
103     SRM_DISABLED,
104     SRM_W4_CONFIRM,
105     SRM_ENABLED_BUT_WAITING,
106     SRM_ENABLED
107 } srm_state_t;
108 
109 typedef struct pbap_client {
110     pbap_state_t state;
111     uint16_t  cid;
112     bd_addr_t bd_addr;
113     hci_con_handle_t con_handle;
114     uint8_t   incoming;
115     uint16_t  goep_cid;
116     btstack_packet_handler_t client_handler;
117     int request_number;
118     srm_state_t srm_state;
119     const char * current_folder;
120     const char * phone_number;
121     const char * phonebook_path;
122     const char * vcard_name;
123     uint16_t set_path_offset;
124     /* vcard selector / operator */
125     uint32_t vcard_selector;
126     uint8_t  vcard_selector_operator;
127     uint8_t  vcard_selector_supported;
128     /* abort */
129     uint8_t  abort_operation;
130     /* authentication */
131     uint8_t  authentication_options;
132     uint16_t authentication_nonce[16];
133     const char * authentication_password;
134     /* xml parser */
135     yxml_t  xml_parser;
136     uint8_t xml_buffer[50];
137     /* vcard listing parser */
138     bool parser_card_found;
139     bool parser_name_found;
140     bool parser_handle_found;
141     char parser_name[PBAP_MAX_NAME_LEN];
142     char parser_handle[PBAP_MAX_HANDLE_LEN];
143     /* flow control mode */
144     uint8_t flow_control_enabled;
145     uint8_t flow_next_triggered;
146 } pbap_client_t;
147 
148 typedef struct {
149     uint8_t srm_value;
150     uint8_t srmp_value;
151 } obex_srm_t;
152 
153 static uint32_t pbap_client_supported_features;
154 
155 static pbap_client_t pbap_client_singleton;
156 static pbap_client_t * pbap_client = &pbap_client_singleton;
157 
158 static void pbap_client_emit_connected_event(pbap_client_t * context, uint8_t status){
159     uint8_t event[15];
160     int pos = 0;
161     event[pos++] = HCI_EVENT_PBAP_META;
162     pos++;  // skip len
163     event[pos++] = PBAP_SUBEVENT_CONNECTION_OPENED;
164     little_endian_store_16(event,pos,context->cid);
165     pos+=2;
166     event[pos++] = status;
167     (void)memcpy(&event[pos], context->bd_addr, 6);
168     pos += 6;
169     little_endian_store_16(event,pos,context->con_handle);
170     pos += 2;
171     event[pos++] = context->incoming;
172     event[1] = pos - 2;
173     if (pos != sizeof(event)) log_error("goep_client_emit_connected_event size %u", pos);
174     context->client_handler(HCI_EVENT_PACKET, context->cid, &event[0], pos);
175 }
176 
177 static void pbap_client_emit_connection_closed_event(pbap_client_t * context){
178     uint8_t event[5];
179     int pos = 0;
180     event[pos++] = HCI_EVENT_PBAP_META;
181     pos++;  // skip len
182     event[pos++] = PBAP_SUBEVENT_CONNECTION_CLOSED;
183     little_endian_store_16(event,pos,context->cid);
184     pos+=2;
185     event[1] = pos - 2;
186     if (pos != sizeof(event)) log_error("pbap_client_emit_connection_closed_event size %u", pos);
187     context->client_handler(HCI_EVENT_PACKET, context->cid, &event[0], pos);
188 }
189 
190 static void pbap_client_emit_operation_complete_event(pbap_client_t * context, uint8_t status){
191     uint8_t event[6];
192     int pos = 0;
193     event[pos++] = HCI_EVENT_PBAP_META;
194     pos++;  // skip len
195     event[pos++] = PBAP_SUBEVENT_OPERATION_COMPLETED;
196     little_endian_store_16(event,pos,context->cid);
197     pos+=2;
198     event[pos++]= status;
199     event[1] = pos - 2;
200     if (pos != sizeof(event)) log_error("pbap_client_emit_can_send_now_event size %u", pos);
201     context->client_handler(HCI_EVENT_PACKET, context->cid, &event[0], pos);
202 }
203 
204 static void pbap_client_emit_phonebook_size_event(pbap_client_t * context, uint8_t status, uint16_t phonebook_size){
205     uint8_t event[8];
206     int pos = 0;
207     event[pos++] = HCI_EVENT_PBAP_META;
208     pos++;  // skip len
209     event[pos++] = PBAP_SUBEVENT_PHONEBOOK_SIZE;
210     little_endian_store_16(event,pos,context->cid);
211     pos+=2;
212     event[pos++] = status;
213     little_endian_store_16(event,pos, phonebook_size);
214     pos+=2;
215     event[1] = pos - 2;
216     if (pos != sizeof(event)) log_error("pbap_client_emit_phonebook_size_event size %u", pos);
217     context->client_handler(HCI_EVENT_PACKET, context->cid, &event[0], pos);
218 }
219 
220 static void pbap_client_emit_authentication_event(pbap_client_t * context, uint8_t options){
221     // split options
222     uint8_t user_id_required = (options & 1) ? 1 : 0;
223     uint8_t full_access      = (options & 2) ? 1 : 0;
224 
225     uint8_t event[7];
226     int pos = 0;
227     event[pos++] = HCI_EVENT_PBAP_META;
228     pos++;  // skip len
229     event[pos++] = PBAP_SUBEVENT_AUTHENTICATION_REQUEST;
230     little_endian_store_16(event,pos,context->cid);
231     pos+=2;
232     event[pos++] = user_id_required;
233     event[pos++] = full_access;
234     if (pos != sizeof(event)) log_error("pbap_client_emit_authentication_event size %u", pos);
235     context->client_handler(HCI_EVENT_PACKET, context->cid, &event[0], pos);
236 }
237 
238 static void pbap_client_emit_card_result_event(pbap_client_t * context, const char * name, const char * handle){
239     uint8_t event[5 + PBAP_MAX_NAME_LEN + PBAP_MAX_HANDLE_LEN];
240     int pos = 0;
241     event[pos++] = HCI_EVENT_PBAP_META;
242     pos++;  // skip len
243     event[pos++] = PBAP_SUBEVENT_CARD_RESULT;
244     little_endian_store_16(event,pos,context->cid);
245     pos+=2;
246     int name_len = btstack_min(PBAP_MAX_NAME_LEN, strlen(name));
247     event[pos++] = name_len;
248     (void)memcpy(&event[pos], name, name_len);
249     pos += name_len;
250     int handle_len = btstack_min(PBAP_MAX_HANDLE_LEN, strlen(handle));
251     event[pos++] = handle_len;
252     (void)memcpy(&event[pos], handle, handle_len);
253     pos += handle_len;
254     event[1] = pos - 2;
255     context->client_handler(HCI_EVENT_PACKET, context->cid, &event[0], pos);
256 }
257 
258 static const uint8_t collon = (uint8_t) ':';
259 
260 static void pbap_client_vcard_listing_init_parser(pbap_client_t * client){
261     yxml_init(&client->xml_parser, client->xml_buffer, sizeof(client->xml_buffer));
262     client->parser_card_found = false;
263     client->parser_name_found = false;
264     client->parser_handle_found = false;
265 }
266 
267 static void pbap_handle_can_send_now(void){
268     uint16_t path_element_start;
269     uint16_t path_element_len;
270     const char * path_element;
271     uint8_t  application_parameters[PBAP_MAX_PHONE_NUMBER_LEN + 10];
272     uint8_t  challenge_response[36];
273     int i;
274     uint16_t phone_number_len;
275 
276     MD5_CTX md5_ctx;
277 
278     if (pbap_client->abort_operation){
279         pbap_client->abort_operation = 0;
280         pbap_client->state = PBAP_CONNECTED;
281         goep_client_request_create_abort(pbap_client->goep_cid);
282         goep_client_execute(pbap_client->goep_cid);
283         return;
284     }
285 
286     switch (pbap_client->state){
287         case PBAP_W2_SEND_CONNECT_REQUEST:
288             goep_client_request_create_connect(pbap_client->goep_cid, OBEX_VERSION, 0, OBEX_MAX_PACKETLEN_DEFAULT);
289             goep_client_header_add_target(pbap_client->goep_cid, pbap_uuid, 16);
290             // Mandatory if the PSE advertises a PbapSupportedFeatures attribute in its SDP record, else excluded.
291             if (goep_client_get_pbap_supported_features(pbap_client->goep_cid) != PBAP_FEATURES_NOT_PRESENT){
292                 application_parameters[0] = PBAP_APPLICATION_PARAMETER_PBAP_SUPPORTED_FEATURES;
293                 application_parameters[1] = 4;
294                 big_endian_store_32(application_parameters, 2, pbap_client_supported_features);
295                 goep_client_header_add_application_parameters(pbap_client->goep_cid, &application_parameters[0], 6);
296             }
297             pbap_client->state = PBAP_W4_CONNECT_RESPONSE;
298             goep_client_execute(pbap_client->goep_cid);
299             break;
300         case PBAP_W2_SEND_AUTHENTICATED_CONNECT:
301             goep_client_request_create_connect(pbap_client->goep_cid, OBEX_VERSION, 0, OBEX_MAX_PACKETLEN_DEFAULT);
302             goep_client_header_add_target(pbap_client->goep_cid, pbap_uuid, 16);
303             // setup authentication challenge response
304             i = 0;
305             challenge_response[i++] = 0;  // Tag Digest
306             challenge_response[i++] = 16; // Len
307             // calculate md5
308             MD5_Init(&md5_ctx);
309             MD5_Update(&md5_ctx, pbap_client->authentication_nonce, 16);
310             MD5_Update(&md5_ctx, &collon, 1);
311             MD5_Update(&md5_ctx, pbap_client->authentication_password, strlen(pbap_client->authentication_password));
312             MD5_Final(&challenge_response[i], &md5_ctx);
313             i += 16;
314             challenge_response[i++] = 2;  // Tag Nonce
315             challenge_response[i++] = 16; // Len
316             (void)memcpy(&challenge_response[i],
317                          pbap_client->authentication_nonce, 16);
318             i += 16;
319             goep_client_header_add_challenge_response(pbap_client->goep_cid, challenge_response, i);
320             pbap_client->state = PBAP_W4_CONNECT_RESPONSE;
321             goep_client_execute(pbap_client->goep_cid);
322             break;
323         case PBAP_W2_SEND_DISCONNECT_REQUEST:
324             goep_client_request_create_disconnect(pbap_client->goep_cid);
325             pbap_client->state = PBAP_W4_DISCONNECT_RESPONSE;
326             goep_client_execute(pbap_client->goep_cid);
327             return;
328         case PBAP_W2_PULL_PHONEBOOK:
329         case PBAP_W2_GET_PHONEBOOK_SIZE:
330             goep_client_request_create_get(pbap_client->goep_cid);
331             if (pbap_client->request_number == 0){
332                 if (!pbap_client->flow_control_enabled){
333                     goep_client_header_add_srm_enable(pbap_client->goep_cid);
334                     pbap_client->srm_state = SRM_W4_CONFIRM;
335                 }
336                 goep_client_header_add_name(pbap_client->goep_cid, pbap_client->phonebook_path);
337                 goep_client_header_add_type(pbap_client->goep_cid, pbap_phonebook_type);
338                 i = 0;
339                 if (pbap_client->vcard_selector_supported){
340                     // vCard Selector
341                     if (pbap_client->vcard_selector){
342                         application_parameters[i++] = PBAP_APPLICATION_PARAMETER_VCARD_SELECTOR;
343                         application_parameters[i++] = 8;
344                         memset(&application_parameters[i], 0, 4);
345                         i += 4;
346                         big_endian_store_32(application_parameters, i, pbap_client->vcard_selector);
347                         i += 4;
348                     }
349                     // vCard Selector Operator
350                     if (pbap_client->vcard_selector_operator != PBAP_VCARD_SELECTOR_OPERATOR_OR){
351                         application_parameters[i++] = PBAP_APPLICATION_PARAMETER_VCARD_SELECTOR_OPERATOR;
352                         application_parameters[i++] = 1;
353                         application_parameters[i++] = pbap_client->vcard_selector_operator;
354                     }
355                 }
356                 if (pbap_client->state == PBAP_W2_GET_PHONEBOOK_SIZE){
357                     // Regular TLV wih 1-byte len
358                     application_parameters[i++] = PBAP_APPLICATION_PARAMETER_MAX_LIST_COUNT;
359                     application_parameters[i++] = 2;
360                     big_endian_store_16(application_parameters, 2, 0);
361                     i += 2;
362                 }
363                 if (i){
364                     goep_client_header_add_application_parameters(pbap_client->goep_cid, application_parameters, i);
365                 }
366             }
367             if (pbap_client->state == PBAP_W2_GET_PHONEBOOK_SIZE){
368                 // state
369                 pbap_client->state = PBAP_W4_GET_PHONEBOOK_SIZE_COMPLETE;
370             } else {
371                 // state
372                 pbap_client->state = PBAP_W4_PHONEBOOK;
373             }
374             // send packet
375             pbap_client->request_number++;
376             goep_client_execute(pbap_client->goep_cid);
377             break;
378         case PBAP_W2_GET_CARD_LIST:
379             goep_client_request_create_get(pbap_client->goep_cid);
380             if (pbap_client->request_number == 0){
381                 if (!pbap_client->flow_control_enabled){
382                     goep_client_header_add_srm_enable(pbap_client->goep_cid);
383                     pbap_client->srm_state = SRM_W4_CONFIRM;
384                 }
385                 goep_client_header_add_name(pbap_client->goep_cid, pbap_client->phonebook_path);
386                 goep_client_header_add_type(pbap_client->goep_cid, pbap_vcard_listing_type);
387                 i = 0;
388                 if (pbap_client->vcard_selector_supported){
389                     // vCard Selector
390                     if (pbap_client->vcard_selector){
391                         application_parameters[i++] = PBAP_APPLICATION_PARAMETER_VCARD_SELECTOR;
392                         application_parameters[i++] = 8;
393                         memset(&application_parameters[i], 0, 4);
394                         i += 4;
395                         big_endian_store_32(application_parameters, i, pbap_client->vcard_selector);
396                         i += 4;
397                     }
398                     // vCard Selector Operator
399                     if (pbap_client->vcard_selector_operator != PBAP_VCARD_SELECTOR_OPERATOR_OR){
400                         application_parameters[i++] = PBAP_APPLICATION_PARAMETER_VCARD_SELECTOR_OPERATOR;
401                         application_parameters[i++] = 1;
402                         application_parameters[i++] = pbap_client->vcard_selector_operator;
403                     }
404                 }
405                 if (pbap_client->phone_number){
406                     // Search by phone number
407                     phone_number_len = btstack_min(PBAP_MAX_PHONE_NUMBER_LEN, strlen(pbap_client->phone_number));
408                     application_parameters[i++] = PBAP_APPLICATION_PARAMETER_SEARCH_VALUE;
409                     application_parameters[i++] = phone_number_len;
410                     (void)memcpy(&application_parameters[i],
411                                  pbap_client->phone_number, phone_number_len);
412                     i += phone_number_len;
413                     application_parameters[i++] = PBAP_APPLICATION_PARAMETER_SEARCH_PROPERTY;
414                     application_parameters[i++] = 1;
415                     application_parameters[i++] = 0x01; // Number
416                 }
417                 if (i){
418                     goep_client_header_add_application_parameters(pbap_client->goep_cid, &application_parameters[0], i);
419                 }
420             }
421 
422             // send packet
423             pbap_client->state = PBAP_W4_GET_CARD_LIST_COMPLETE;
424             pbap_client->request_number++;
425             goep_client_execute(pbap_client->goep_cid);
426             break;
427         case PBAP_W2_GET_CARD_ENTRY:
428             goep_client_request_create_get(pbap_client->goep_cid);
429             if (pbap_client->request_number == 0){
430                 if (!pbap_client->flow_control_enabled){
431                     goep_client_header_add_srm_enable(pbap_client->goep_cid);
432                     pbap_client->srm_state = SRM_W4_CONFIRM;
433                 }
434                 goep_client_header_add_name(pbap_client->goep_cid, pbap_client->vcard_name);
435                 goep_client_header_add_type(pbap_client->goep_cid, pbap_vcard_entry_type);
436                 // TODO: support property selector
437                 // TODO: support format
438                 i = 0;
439                 uint32_t property_selector_lower = 0;
440                 uint32_t property_selector_higher = 0;
441                 if (strncmp(pbap_client->vcard_name, "X-BT-UID:", 9) == 0) {
442                     property_selector_lower = 1U << 31;
443                 }
444                 if (strncmp(pbap_client->vcard_name, "X-BT-UCI:", 9) == 0) {
445                     property_selector_lower = 1U << 30;
446                 }
447                 if (property_selector_lower != 0){
448                     application_parameters[i++] = PBAP_APPLICATION_PARAMETER_PROPERTY_SELECTOR;
449                     application_parameters[i++] = 8;
450                     big_endian_store_32(application_parameters, i, property_selector_higher);
451                     i += 4;
452                     big_endian_store_32(application_parameters, i, property_selector_lower);
453                     i += 4;
454                 }
455                 if (i > 0){
456                     goep_client_header_add_application_parameters(pbap_client->goep_cid, &application_parameters[0], i);
457                 }
458                 pbap_client->state = PBAP_W4_GET_CARD_ENTRY_COMPLETE;
459             }
460             // send packet
461             pbap_client->request_number++;
462             goep_client_execute(pbap_client->goep_cid);
463             break;
464         case PBAP_W2_SET_PATH_ROOT:
465             goep_client_request_create_set_path(pbap_client->goep_cid, 1 << 1); // Don’t create directory
466             goep_client_header_add_name(pbap_client->goep_cid, "");
467             // state
468             pbap_client->state = PBAP_W4_SET_PATH_ROOT_COMPLETE;
469             // send packet
470             goep_client_execute(pbap_client->goep_cid);
471             break;
472         case PBAP_W2_SET_PATH_ELEMENT:
473             // find '/' or '\0'
474             path_element_start = pbap_client->set_path_offset;
475             while ((pbap_client->current_folder[pbap_client->set_path_offset] != '\0') &&
476                 (pbap_client->current_folder[pbap_client->set_path_offset] != '/')){
477                 pbap_client->set_path_offset++;
478             }
479             path_element_len = pbap_client->set_path_offset-path_element_start;
480             path_element = (const char *) &pbap_client->current_folder[path_element_start];
481 
482             // skip /
483             if (pbap_client->current_folder[pbap_client->set_path_offset] == '/'){
484                 pbap_client->set_path_offset++;
485             }
486 
487             goep_client_request_create_set_path(pbap_client->goep_cid, 1 << 1); // Don’t create directory
488             goep_client_header_add_name_prefix(pbap_client->goep_cid, path_element, path_element_len); // next element
489             // state
490             pbap_client->state = PBAP_W4_SET_PATH_ELEMENT_COMPLETE;
491             // send packet
492             goep_client_execute(pbap_client->goep_cid);
493             break;
494         default:
495             break;
496     }
497 }
498 
499 static void pbap_parse_authentication_challenge(pbap_client_t * context, const uint8_t * challenge_data, uint16_t challenge_len){
500     int i;
501 
502     for (i=0 ; i<challenge_len ; ){
503         int tag = challenge_data[i];
504         int len = challenge_data[i + 1];
505         i += 2;
506         switch (tag) {
507             case 0:
508                 if (len != 0x10) {
509                     log_error("Invalid OBEX digest len %u", len);
510                     return;
511                 }
512                 (void)memcpy(context->authentication_nonce, &challenge_data[i], 16);
513                 break;
514             case 1:
515                 context->authentication_options = challenge_data[i];
516                 break;
517             case 2:
518                 // TODO: handle charset
519                 // charset_code = challenge_data[i];
520                 break;
521             default:
522                 break;
523         }
524         i += len;
525     }
526 }
527 
528 static void obex_srm_handle_srm_header(obex_srm_t * obex_srm, uint8_t hi, uint16_t data_len, const uint8_t * data){
529     switch (hi){
530         case OBEX_HEADER_SINGLE_RESPONSE_MODE:
531             if (data_len != 1) break;
532             obex_srm->srm_value = *data;
533             break;
534         case OBEX_HEADER_SINGLE_RESPONSE_MODE_PARAMETER:
535             if (data_len != 1) break;
536             obex_srm->srmp_value = *data;
537             break;
538         default:
539             btstack_unreachable();
540             break;
541     }
542 }
543 
544 static void obex_srm_init(obex_srm_t * obex_srm){
545     obex_srm->srm_value = OBEX_SRM_DISABLE;
546     obex_srm->srmp_value = OBEX_SRMP_NEXT;
547 }
548 
549 
550 static void pbap_handle_srm_headers(pbap_client_t * context, const obex_srm_t * obex_srm){
551     // Update SRM state based on SRM headers
552     switch (context->srm_state){
553         case SRM_W4_CONFIRM:
554             switch (obex_srm->srm_value){
555                 case OBEX_SRM_ENABLE:
556                     switch (obex_srm->srmp_value){
557                         case OBEX_SRMP_WAIT:
558                             context->srm_state = SRM_ENABLED_BUT_WAITING;
559                             break;
560                         default:
561                             context->srm_state = SRM_ENABLED;
562                             break;
563                     }
564                     break;
565                 default:
566                     context->srm_state = SRM_DISABLED;
567                     break;
568             }
569             break;
570         case SRM_ENABLED_BUT_WAITING:
571             switch (obex_srm->srmp_value){
572                 case OBEX_SRMP_WAIT:
573                     context->srm_state = SRM_ENABLED_BUT_WAITING;
574                     break;
575                 default:
576                     context->srm_state = SRM_ENABLED;
577                     break;
578             }
579             break;
580         default:
581             break;
582     }
583     log_info("SRM state %u", context->srm_state);
584 }
585 
586 static void pbap_client_process_vcard_listing(uint8_t *packet, uint16_t size, obex_srm_t * obex_srm) {
587     obex_iterator_t it;
588     for (obex_iterator_init_with_response_packet(&it, goep_client_get_request_opcode(pbap_client->goep_cid), packet, size); obex_iterator_has_more(&it) ; obex_iterator_next(&it)){
589 
590         uint8_t           hi = obex_iterator_get_hi(&it);
591         uint16_t    data_len = obex_iterator_get_data_len(&it);
592         const uint8_t * data =  obex_iterator_get_data(&it);
593         uint16_t    char_len;
594 
595         switch (hi){
596             case OBEX_HEADER_SINGLE_RESPONSE_MODE:
597             case OBEX_HEADER_SINGLE_RESPONSE_MODE_PARAMETER:
598                 obex_srm_handle_srm_header(obex_srm, hi, data_len, data);
599                 break;
600             case OBEX_HEADER_BODY:
601             case OBEX_HEADER_END_OF_BODY:
602                 // now try parsing it
603                 while (data_len--) {
604                     yxml_ret_t r = yxml_parse(&pbap_client->xml_parser, *data++);
605                     switch (r) {
606                         case YXML_ELEMSTART:
607                             pbap_client->parser_card_found = strcmp("card", pbap_client->xml_parser.elem) == 0;
608                             break;
609                         case YXML_ELEMEND:
610                             if (pbap_client->parser_card_found) {
611                                 pbap_client_emit_card_result_event(pbap_client, pbap_client->parser_name,
612                                                                    pbap_client->parser_handle);
613                             }
614                             pbap_client->parser_card_found = false;
615                             break;
616                         case YXML_ATTRSTART:
617                             if (!pbap_client->parser_card_found) break;
618                             if (strcmp("name", pbap_client->xml_parser.attr) == 0) {
619                                 pbap_client->parser_name_found = true;
620                                 pbap_client->parser_name[0] = 0;
621                                 break;
622                             }
623                             if (strcmp("handle", pbap_client->xml_parser.attr) == 0) {
624                                 pbap_client->parser_handle_found = true;
625                                 pbap_client->parser_handle[0] = 0;
626                                 break;
627                             }
628                             break;
629                         case YXML_ATTRVAL:
630                             if (pbap_client->parser_name_found) {
631                                 // "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."
632                                 char_len = strlen(pbap_client->xml_parser.data);
633                                 if ((strlen(pbap_client->parser_name) + char_len + 1) >=
634                                     sizeof(pbap_client->parser_name))
635                                     break;
636                                 strcat(pbap_client->parser_name, pbap_client->xml_parser.data);
637                                 break;
638                             }
639                             if (pbap_client->parser_handle_found) {
640                                 // "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."
641                                 char_len = strlen(pbap_client->xml_parser.data);
642                                 if ((strlen(pbap_client->parser_handle) + char_len + 1) >=
643                                     sizeof(pbap_client->parser_handle))
644                                     break;
645                                 strcat(pbap_client->parser_handle, pbap_client->xml_parser.data);
646                                 break;
647                             }
648                             break;
649                         case YXML_ATTREND:
650                             pbap_client->parser_name_found = false;
651                             pbap_client->parser_handle_found = false;
652                             break;
653                         default:
654                             break;
655                     }
656                 }
657                 break;
658             default:
659                 break;
660         }
661     }
662 }
663 static void pbap_packet_handler_hci(uint8_t *packet, uint16_t size){
664     UNUSED(size);
665     uint8_t status;
666     switch (hci_event_packet_get_type(packet)) {
667         case HCI_EVENT_GOEP_META:
668             switch (hci_event_goep_meta_get_subevent_code(packet)){
669                 case GOEP_SUBEVENT_CONNECTION_OPENED:
670                     status = goep_subevent_connection_opened_get_status(packet);
671                     pbap_client->con_handle = goep_subevent_connection_opened_get_con_handle(packet);
672                     pbap_client->incoming = goep_subevent_connection_opened_get_incoming(packet);
673                     goep_subevent_connection_opened_get_bd_addr(packet, pbap_client->bd_addr);
674                     if (status){
675                         log_info("pbap: connection failed %u", status);
676                         pbap_client->state = PBAP_INIT;
677                         pbap_client_emit_connected_event(pbap_client, status);
678                     } else {
679                         log_info("pbap: connection established");
680                         pbap_client->goep_cid = goep_subevent_connection_opened_get_goep_cid(packet);
681                         pbap_client->state = PBAP_W2_SEND_CONNECT_REQUEST;
682                         goep_client_request_can_send_now(pbap_client->goep_cid);
683                     }
684                     break;
685                 case GOEP_SUBEVENT_CONNECTION_CLOSED:
686                     if (pbap_client->state != PBAP_CONNECTED){
687                         pbap_client_emit_operation_complete_event(pbap_client, OBEX_DISCONNECTED);
688                     }
689                     pbap_client->state = PBAP_INIT;
690                     pbap_client_emit_connection_closed_event(pbap_client);
691                     break;
692                 case GOEP_SUBEVENT_CAN_SEND_NOW:
693                     pbap_handle_can_send_now();
694                     break;
695                 default:
696                     break;
697             }
698             break;
699         default:
700             break;
701     }
702 }
703 
704 static void pbap_packet_handler_goep(uint8_t *packet, uint16_t size){
705     obex_iterator_t it;
706     int wait_for_user = 0;
707 
708     // get SRM and SRMP Headers
709     obex_srm_t obex_srm;
710     obex_srm_init(&obex_srm);
711 
712     // TODO: handle chunked data
713     switch (pbap_client->state){
714         case PBAP_W4_CONNECT_RESPONSE:
715             switch (packet[0]){
716                 case OBEX_RESP_SUCCESS:
717                     for (obex_iterator_init_with_response_packet(&it, goep_client_get_request_opcode(pbap_client->goep_cid), packet, size); obex_iterator_has_more(&it) ; obex_iterator_next(&it)){
718                         uint8_t hi = obex_iterator_get_hi(&it);
719                         if (hi == OBEX_HEADER_CONNECTION_ID){
720                             goep_client_set_connection_id(pbap_client->goep_cid, obex_iterator_get_data_32(&it));
721                         }
722                     }
723                     pbap_client->state = PBAP_CONNECTED;
724                     pbap_client->vcard_selector_supported = pbap_client_supported_features & goep_client_get_pbap_supported_features(pbap_client->goep_cid) & PBAP_SUPPORTED_FEATURES_VCARD_SELECTING;
725                     pbap_client_emit_connected_event(pbap_client, ERROR_CODE_SUCCESS);
726                     break;
727                 case OBEX_RESP_UNAUTHORIZED:
728                     for (obex_iterator_init_with_response_packet(&it, goep_client_get_request_opcode(pbap_client->goep_cid), packet, size); obex_iterator_has_more(&it) ; obex_iterator_next(&it)){
729                         uint8_t hi = obex_iterator_get_hi(&it);
730                         if (hi == OBEX_HEADER_AUTHENTICATION_CHALLENGE){
731                             pbap_parse_authentication_challenge(pbap_client, obex_iterator_get_data(&it), obex_iterator_get_data_len(&it));
732                         }
733                     }
734                     pbap_client->state = PBAP_W4_USER_AUTHENTICATION;
735                     pbap_client_emit_authentication_event(pbap_client, pbap_client->authentication_options);
736                     break;
737                 default:
738                     log_info("pbap: obex connect failed, result 0x%02x", packet[0]);
739                     pbap_client->state = PBAP_INIT;
740                     pbap_client_emit_connected_event(pbap_client, OBEX_CONNECT_FAILED);
741                     break;
742             }
743             break;
744         case PBAP_W4_DISCONNECT_RESPONSE:
745             goep_client_disconnect(pbap_client->goep_cid);
746             break;
747         case PBAP_W4_SET_PATH_ROOT_COMPLETE:
748         case PBAP_W4_SET_PATH_ELEMENT_COMPLETE:
749             if (packet[0] == OBEX_RESP_SUCCESS){
750                 // more path?
751                 if (pbap_client->current_folder[pbap_client->set_path_offset]){
752                     pbap_client->state = PBAP_W2_SET_PATH_ELEMENT;
753                     goep_client_request_can_send_now(pbap_client->goep_cid);
754                 } else {
755                     pbap_client->current_folder = NULL;
756                     pbap_client->state = PBAP_CONNECTED;
757                     pbap_client_emit_operation_complete_event(pbap_client, ERROR_CODE_SUCCESS);
758                 }
759             } else if (packet[0] == OBEX_RESP_NOT_FOUND){
760                 pbap_client->state = PBAP_CONNECTED;
761                 pbap_client_emit_operation_complete_event(pbap_client, OBEX_NOT_FOUND);
762             } else {
763                 pbap_client->state = PBAP_CONNECTED;
764                 pbap_client_emit_operation_complete_event(pbap_client, OBEX_UNKNOWN_ERROR);
765             }
766             break;
767         case PBAP_W4_PHONEBOOK:
768             pbap_client->flow_next_triggered = 0;
769             wait_for_user = 0;
770             for (obex_iterator_init_with_response_packet(&it, goep_client_get_request_opcode(pbap_client->goep_cid), packet, size); obex_iterator_has_more(&it) ; obex_iterator_next(&it)){
771                 uint8_t hi = obex_iterator_get_hi(&it);
772                 uint16_t     data_len = obex_iterator_get_data_len(&it);
773                 const uint8_t  * data = obex_iterator_get_data(&it);
774                 switch (hi){
775                     case OBEX_HEADER_SINGLE_RESPONSE_MODE:
776                     case OBEX_HEADER_SINGLE_RESPONSE_MODE_PARAMETER:
777                         obex_srm_handle_srm_header(&obex_srm, hi, data_len, data);
778                         break;
779                     case OBEX_HEADER_BODY:
780                     case OBEX_HEADER_END_OF_BODY:
781                         pbap_client->client_handler(PBAP_DATA_PACKET, pbap_client->cid, (uint8_t *) data, data_len);
782                         wait_for_user++;
783                         if (wait_for_user > 1){
784                             log_error("wait_for_user %u", wait_for_user);
785                         }
786                         break;
787                     default:
788                         break;
789                 }
790             }
791             switch(packet[0]){
792                 case OBEX_RESP_CONTINUE:
793                     pbap_handle_srm_headers(pbap_client, &obex_srm);
794                     if (pbap_client->srm_state ==  SRM_ENABLED) break;
795                     pbap_client->state = PBAP_W2_PULL_PHONEBOOK;
796                     if (!pbap_client->flow_control_enabled || !wait_for_user || pbap_client->flow_next_triggered) {
797                         goep_client_request_can_send_now(pbap_client->goep_cid);
798                     }
799                     break;
800                 case OBEX_RESP_SUCCESS:
801                     pbap_client->state = PBAP_CONNECTED;
802                     pbap_client_emit_operation_complete_event(pbap_client, 0);
803                     break;
804                 default:
805                     log_info("unexpected response 0x%02x", packet[0]);
806                     pbap_client->state = PBAP_CONNECTED;
807                     pbap_client_emit_operation_complete_event(pbap_client, OBEX_UNKNOWN_ERROR);
808                     break;
809             }
810             break;
811         case PBAP_W4_GET_PHONEBOOK_SIZE_COMPLETE:
812             pbap_client->state = PBAP_CONNECTED;
813             if (packet[0] == OBEX_RESP_SUCCESS){
814                 int have_size = 0;
815                 uint16_t phonebook_size;
816                 for (obex_iterator_init_with_response_packet(&it, goep_client_get_request_opcode(pbap_client->goep_cid), packet, size); obex_iterator_has_more(&it) ; obex_iterator_next(&it)){
817                     uint8_t hi = obex_iterator_get_hi(&it);
818                     if (hi == OBEX_HEADER_APPLICATION_PARAMETERS){
819                         uint16_t     data_len = obex_iterator_get_data_len(&it);
820                         const uint8_t  * data =  obex_iterator_get_data(&it);
821                         // iterate over application headers (TLV with 1 bytes len)
822                         unsigned int i = 0;
823                         while (i<data_len){
824                             uint8_t tag = data[i++];
825                             uint8_t len = data[i++];
826                             if ((tag == PBAP_APPLICATION_PARAMETER_PHONEBOOK_SIZE) && (len == 2)){
827                                 have_size = 1;
828                                 phonebook_size = big_endian_read_16(data, i);
829                             }
830                             i+=len;
831                         }
832                     }
833                 }
834                 if (have_size){
835                     pbap_client_emit_phonebook_size_event(pbap_client, 0, phonebook_size);
836                     break;
837                 }
838             }
839             pbap_client_emit_phonebook_size_event(pbap_client, OBEX_UNKNOWN_ERROR, 0);
840             break;
841         case PBAP_W4_GET_CARD_LIST_COMPLETE:
842             switch (packet[0]){
843                 case OBEX_RESP_CONTINUE:
844                     // process data
845                     pbap_client_process_vcard_listing(packet, size, &obex_srm);
846                     // handle continue
847                     pbap_handle_srm_headers(pbap_client, &obex_srm);
848                     if (pbap_client->srm_state ==  SRM_ENABLED) break;
849                     pbap_client->state = PBAP_W2_GET_CARD_LIST;
850                     if (!pbap_client->flow_control_enabled || !wait_for_user || pbap_client->flow_next_triggered) {
851                         goep_client_request_can_send_now(pbap_client->goep_cid);
852                     }
853                     break;
854                 case OBEX_RESP_SUCCESS:
855                     // process data
856                     pbap_client_process_vcard_listing(packet, size, &obex_srm);
857                     // done
858                     pbap_client->state = PBAP_CONNECTED;
859                     pbap_client_emit_operation_complete_event(pbap_client, 0);
860                     break;
861                 case OBEX_RESP_NOT_ACCEPTABLE:
862                     pbap_client->state = PBAP_CONNECTED;
863                     pbap_client_emit_operation_complete_event(pbap_client, OBEX_NOT_ACCEPTABLE);
864                     break;
865                 default:
866                     log_info("unexpected response 0x%02x", packet[0]);
867                     pbap_client->state = PBAP_CONNECTED;
868                     pbap_client_emit_operation_complete_event(pbap_client, OBEX_UNKNOWN_ERROR);
869                     break;
870             }
871             break;
872         case PBAP_W4_GET_CARD_ENTRY_COMPLETE:
873             switch (packet[0]){
874                 case OBEX_RESP_CONTINUE:
875                     for (obex_iterator_init_with_response_packet(&it, goep_client_get_request_opcode(pbap_client->goep_cid), packet, size); obex_iterator_has_more(&it) ; obex_iterator_next(&it)){
876                         uint8_t hi = obex_iterator_get_hi(&it);
877                         uint16_t data_len = obex_iterator_get_data_len(&it);
878                         const uint8_t *data = obex_iterator_get_data(&it);
879                         switch (hi) {
880                             case OBEX_HEADER_SINGLE_RESPONSE_MODE:
881                             case OBEX_HEADER_SINGLE_RESPONSE_MODE_PARAMETER:
882                                 obex_srm_handle_srm_header(&obex_srm, hi, data_len, data);
883                                 break;
884                             default:
885                                 break;
886                         }
887                     }
888                     pbap_handle_srm_headers(pbap_client, &obex_srm);
889                     if (pbap_client->srm_state ==  SRM_ENABLED) break;
890                     pbap_client->state = PBAP_W2_GET_CARD_ENTRY;
891                     if (!pbap_client->flow_control_enabled || !wait_for_user || pbap_client->flow_next_triggered) {
892                         goep_client_request_can_send_now(pbap_client->goep_cid);
893                     }
894                     break;
895                 case OBEX_RESP_SUCCESS:
896                     pbap_client->state = PBAP_CONNECTED;
897                     pbap_client_emit_operation_complete_event(pbap_client, 0);
898                     break;
899                 case OBEX_RESP_NOT_ACCEPTABLE:
900                     pbap_client->state = PBAP_CONNECTED;
901                     pbap_client_emit_operation_complete_event(pbap_client, OBEX_NOT_ACCEPTABLE);
902                     break;
903                 default:
904                     log_info("unexpected response 0x%02x", packet[0]);
905                     pbap_client->state = PBAP_CONNECTED;
906                     pbap_client_emit_operation_complete_event(pbap_client, OBEX_UNKNOWN_ERROR);
907                     break;
908             }
909             break;
910         default:
911             break;
912     }
913 }
914 
915 static void pbap_packet_handler(uint8_t packet_type, uint16_t channel, uint8_t *packet, uint16_t size){
916     UNUSED(channel); // ok: there is no channel
917     UNUSED(size);    // ok: handling own geop events
918 
919     switch (packet_type){
920         case HCI_EVENT_PACKET:
921             pbap_packet_handler_hci(packet, size);
922             break;
923         case GOEP_DATA_PACKET:
924             pbap_packet_handler_goep(packet, size);
925             break;
926         default:
927             break;
928     }
929 }
930 
931 static void pbap_client_reset_state(void) {
932     pbap_client_supported_features =
933             PBAP_SUPPORTED_FEATURES_DOWNLOAD |
934             PBAP_SUPPORTED_FEATURES_BROWSING |
935             PBAP_SUPPORTED_FEATURES_DATABASE_IDENTIFIER |
936             PBAP_SUPPORTED_FEATURES_FOLDER_VERSION_COUNTERS |
937             PBAP_SUPPORTED_FEATURES_VCARD_SELECTING |
938             PBAP_SUPPORTED_FEATURES_ENHANCED_MISSED_CALLS |
939             PBAP_SUPPORTED_FEATURES_DEFAULT_CONTACT_IMAGE_FORMAT |
940             PBAP_SUPPORTED_FEATURES_X_BT_UCI_VCARD_PROPERTY |
941             PBAP_SUPPORTED_FEATURES_X_BT_UID_VCARD_PROPERTY |
942             PBAP_SUPPORTED_FEATURES_CONTACT_REFERENCING;
943     pbap_client->state = PBAP_INIT;
944     pbap_client->cid = 1;
945 }
946 
947 void pbap_client_init(void){
948     pbap_client_reset_state();
949 }
950 
951 void pbap_client_deinit(void){
952     pbap_client_reset_state();
953     memset(pbap_client, 0, sizeof(pbap_client_t));
954 }
955 
956 uint8_t pbap_connect(btstack_packet_handler_t handler, bd_addr_t addr, uint16_t * out_cid){
957     if (pbap_client->state != PBAP_INIT){
958         return BTSTACK_MEMORY_ALLOC_FAILED;
959     }
960 
961     pbap_client->state = PBAP_W4_GOEP_CONNECTION;
962     pbap_client->client_handler = handler;
963     pbap_client->vcard_selector = 0;
964     pbap_client->vcard_selector_operator = PBAP_VCARD_SELECTOR_OPERATOR_OR;
965 
966     uint8_t err = goep_client_create_connection(&pbap_packet_handler, addr, BLUETOOTH_SERVICE_CLASS_PHONEBOOK_ACCESS_PSE, &pbap_client->goep_cid);
967     *out_cid = pbap_client->cid;
968     if (err) return err;
969     return ERROR_CODE_SUCCESS;
970 }
971 
972 uint8_t pbap_disconnect(uint16_t pbap_cid){
973     UNUSED(pbap_cid);
974     if (pbap_client->state != PBAP_CONNECTED){
975         return BTSTACK_BUSY;
976     }
977     pbap_client->state = PBAP_W2_SEND_DISCONNECT_REQUEST;
978     goep_client_request_can_send_now(pbap_client->goep_cid);
979     return ERROR_CODE_SUCCESS;
980 }
981 
982 uint8_t pbap_get_phonebook_size(uint16_t pbap_cid, const char * path){
983     UNUSED(pbap_cid);
984     if (pbap_client->state != PBAP_CONNECTED){
985         return BTSTACK_BUSY;
986     }
987     pbap_client->state = PBAP_W2_GET_PHONEBOOK_SIZE;
988     pbap_client->phonebook_path = path;
989     pbap_client->request_number = 0;
990     goep_client_request_can_send_now(pbap_client->goep_cid);
991     return ERROR_CODE_SUCCESS;
992 }
993 
994 uint8_t pbap_pull_phonebook(uint16_t pbap_cid, const char * path){
995     UNUSED(pbap_cid);
996     if (pbap_client->state != PBAP_CONNECTED){
997         return BTSTACK_BUSY;
998     }
999     pbap_client->state = PBAP_W2_PULL_PHONEBOOK;
1000     pbap_client->phonebook_path = path;
1001     pbap_client->request_number = 0;
1002     goep_client_request_can_send_now(pbap_client->goep_cid);
1003     return ERROR_CODE_SUCCESS;
1004 }
1005 
1006 uint8_t pbap_set_phonebook(uint16_t pbap_cid, const char * path){
1007     UNUSED(pbap_cid);
1008     if (pbap_client->state != PBAP_CONNECTED){
1009         return BTSTACK_BUSY;
1010     }
1011     pbap_client->state = PBAP_W2_SET_PATH_ROOT;
1012     pbap_client->current_folder = path;
1013     pbap_client->set_path_offset = 0;
1014     goep_client_request_can_send_now(pbap_client->goep_cid);
1015     return ERROR_CODE_SUCCESS;
1016 }
1017 
1018 uint8_t pbap_authentication_password(uint16_t pbap_cid, const char * password){
1019     UNUSED(pbap_cid);
1020     if (pbap_client->state != PBAP_W4_USER_AUTHENTICATION){
1021         return BTSTACK_BUSY;
1022     }
1023     pbap_client->state = PBAP_W2_SEND_AUTHENTICATED_CONNECT;
1024     pbap_client->authentication_password = password;
1025     goep_client_request_can_send_now(pbap_client->goep_cid);
1026     return ERROR_CODE_SUCCESS;
1027 }
1028 
1029 uint8_t pbap_pull_vcard_listing(uint16_t pbap_cid, const char * path){
1030     UNUSED(pbap_cid);
1031     if (pbap_client->state != PBAP_CONNECTED){
1032         return BTSTACK_BUSY;
1033     }
1034     pbap_client->state = PBAP_W2_GET_CARD_LIST;
1035     pbap_client->phonebook_path = path;
1036     pbap_client->phone_number = NULL;
1037     pbap_client->request_number = 0;
1038     pbap_client_vcard_listing_init_parser(pbap_client);
1039     goep_client_request_can_send_now(pbap_client->goep_cid);
1040     return ERROR_CODE_SUCCESS;
1041 }
1042 
1043 uint8_t pbap_pull_vcard_entry(uint16_t pbap_cid, const char * path){
1044     UNUSED(pbap_cid);
1045     if (pbap_client->state != PBAP_CONNECTED){
1046         return BTSTACK_BUSY;
1047     }
1048     pbap_client->state = PBAP_W2_GET_CARD_ENTRY;
1049     // pbap_client->phonebook_path = NULL;
1050     // pbap_client->phone_number = NULL;
1051     pbap_client->vcard_name = path;
1052     pbap_client->request_number = 0;
1053     goep_client_request_can_send_now(pbap_client->goep_cid);
1054     return ERROR_CODE_SUCCESS;
1055 }
1056 
1057 uint8_t pbap_lookup_by_number(uint16_t pbap_cid, const char * phone_number){
1058     UNUSED(pbap_cid);
1059     if (pbap_client->state != PBAP_CONNECTED){
1060         return BTSTACK_BUSY;
1061     }
1062     pbap_client->state = PBAP_W2_GET_CARD_LIST;
1063     pbap_client->phonebook_path = pbap_vcard_listing_name;
1064     pbap_client->phone_number   = phone_number;
1065     pbap_client->request_number = 0;
1066     pbap_client_vcard_listing_init_parser(pbap_client);
1067     goep_client_request_can_send_now(pbap_client->goep_cid);
1068     return ERROR_CODE_SUCCESS;
1069 }
1070 
1071 uint8_t pbap_abort(uint16_t pbap_cid){
1072     UNUSED(pbap_cid);
1073     if (pbap_client->state != PBAP_CONNECTED){
1074         return BTSTACK_BUSY;
1075     }
1076     log_info("abort current operation, state 0x%02x", pbap_client->state);
1077     pbap_client->abort_operation = 1;
1078     return ERROR_CODE_SUCCESS;
1079 }
1080 
1081 uint8_t pbap_next_packet(uint16_t pbap_cid){
1082     // log_info("pbap_next_packet, state %x", pbap_client->state);
1083     UNUSED(pbap_cid);
1084     if (!pbap_client->flow_control_enabled){
1085         return ERROR_CODE_SUCCESS;
1086     }
1087     switch (pbap_client->state){
1088         case PBAP_W2_PULL_PHONEBOOK:
1089             goep_client_request_can_send_now(pbap_client->goep_cid);
1090             break;
1091         case PBAP_W4_PHONEBOOK:
1092             pbap_client->flow_next_triggered = 1;
1093             break;
1094         default:
1095             break;
1096     }
1097     return ERROR_CODE_SUCCESS;
1098 }
1099 
1100 uint8_t pbap_set_flow_control_mode(uint16_t pbap_cid, int enable){
1101     UNUSED(pbap_cid);
1102     if (pbap_client->state != PBAP_CONNECTED){
1103         return BTSTACK_BUSY;
1104     }
1105     pbap_client->flow_control_enabled = enable;
1106     return ERROR_CODE_SUCCESS;
1107 }
1108 
1109 uint8_t pbap_set_vcard_selector(uint16_t pbap_cid, uint32_t vcard_selector){
1110     UNUSED(pbap_cid);
1111     if (pbap_client->state != PBAP_CONNECTED){
1112         return BTSTACK_BUSY;
1113     }
1114     pbap_client->vcard_selector = vcard_selector;
1115     return ERROR_CODE_SUCCESS;
1116 }
1117 
1118 uint8_t pbap_set_vcard_selector_operator(uint16_t pbap_cid, int vcard_selector_operator){
1119     UNUSED(pbap_cid);
1120     if (pbap_client->state != PBAP_CONNECTED){
1121         return BTSTACK_BUSY;
1122     }
1123     pbap_client->vcard_selector_operator = vcard_selector_operator;
1124     return ERROR_CODE_SUCCESS;
1125 }
1126