xref: /btstack/src/ble/gatt_client.c (revision 8918bbdafce4a0674ec2b099244a8ddc0e95ba42)
1 /*
2  * Copyright (C) 2014 BlueKitchen GmbH
3  *
4  * Redistribution and use in source and binary forms, with or without
5  * modification, are permitted provided that the following conditions
6  * are met:
7  *
8  * 1. Redistributions of source code must retain the above copyright
9  *    notice, this list of conditions and the following disclaimer.
10  * 2. Redistributions in binary form must reproduce the above copyright
11  *    notice, this list of conditions and the following disclaimer in the
12  *    documentation and/or other materials provided with the distribution.
13  * 3. Neither the name of the copyright holders nor the names of
14  *    contributors may be used to endorse or promote products derived
15  *    from this software without specific prior written permission.
16  * 4. Any redistribution, use, or modification is done solely for
17  *    personal benefit and not for any commercial purpose or for
18  *    monetary gain.
19  *
20  * THIS SOFTWARE IS PROVIDED BY BLUEKITCHEN GMBH AND CONTRIBUTORS
21  * ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
22  * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
23  * FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL MATTHIAS
24  * RINGWALD OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
25  * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING,
26  * BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS
27  * OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED
28  * AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
29  * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF
30  * THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
31  * SUCH DAMAGE.
32  *
33  * Please inquire about commercial licensing options at
34  * [email protected]
35  *
36  */
37 
38 #define BTSTACK_FILE__ "gatt_client.c"
39 
40 #include <stdint.h>
41 #include <string.h>
42 
43 #include "btstack_config.h"
44 
45 #include "att_dispatch.h"
46 #include "ad_parser.h"
47 #include "ble/att_db.h"
48 #include "ble/core.h"
49 #include "ble/gatt_client.h"
50 #include "ble/le_device_db.h"
51 #include "ble/sm.h"
52 #include "btstack_debug.h"
53 #include "btstack_event.h"
54 #include "btstack_memory.h"
55 #include "btstack_run_loop.h"
56 #include "btstack_util.h"
57 #include "classic/sdp_util.h"
58 #include "hci.h"
59 #include "hci_cmd.h"
60 #include "hci_dump.h"
61 #include "l2cap.h"
62 
63 static btstack_linked_list_t gatt_client_connections;
64 static btstack_linked_list_t gatt_client_value_listeners;
65 static btstack_packet_callback_registration_t hci_event_callback_registration;
66 
67 #if defined(ENABLE_GATT_CLIENT_PAIRING) || defined (ENABLE_LE_SIGNED_WRITE) || defined (ENABLE_LE_PROACTIVE_AUTHENTICATION)
68 static btstack_packet_callback_registration_t sm_event_callback_registration;
69 #endif
70 
71 static uint8_t mtu_exchange_enabled;
72 
73 static void gatt_client_att_packet_handler(uint8_t packet_type, uint16_t handle, uint8_t *packet, uint16_t size);
74 static void gatt_client_event_packet_handler(uint8_t packet_type, uint16_t channel, uint8_t *packet, uint16_t size);
75 static void gatt_client_report_error_if_pending(gatt_client_t *gatt_client, uint8_t att_error_code);
76 
77 #ifdef ENABLE_LE_SIGNED_WRITE
78 static void att_signed_write_handle_cmac_result(uint8_t hash[8]);
79 #endif
80 
81 void gatt_client_init(void){
82     gatt_client_connections = NULL;
83     mtu_exchange_enabled = 1;
84 
85     // regsister for HCI Events
86     hci_event_callback_registration.callback = &gatt_client_event_packet_handler;
87     hci_add_event_handler(&hci_event_callback_registration);
88 
89 #if defined(ENABLE_GATT_CLIENT_PAIRING) || defined (ENABLE_LE_SIGNED_WRITE) || defined (ENABLE_LE_PROACTIVE_AUTHENTICATION)
90     // register for SM Events
91     sm_event_callback_registration.callback = &gatt_client_event_packet_handler;
92     sm_add_event_handler(&sm_event_callback_registration);
93 #endif
94 
95     // and ATT Client PDUs
96     att_dispatch_register_client(gatt_client_att_packet_handler);
97 }
98 
99 static gatt_client_t * gatt_client_for_timer(btstack_timer_source_t * ts){
100     btstack_linked_list_iterator_t it;
101     btstack_linked_list_iterator_init(&it, &gatt_client_connections);
102     while (btstack_linked_list_iterator_has_next(&it)){
103         gatt_client_t * gatt_client = (gatt_client_t *) btstack_linked_list_iterator_next(&it);
104         if (&gatt_client->gc_timeout == ts) {
105             return gatt_client;
106         }
107     }
108     return NULL;
109 }
110 
111 static void gatt_client_timeout_handler(btstack_timer_source_t * timer){
112     gatt_client_t * gatt_client = gatt_client_for_timer(timer);
113     if (gatt_client == NULL) return;
114     log_info("GATT client timeout handle, handle 0x%02x", gatt_client->con_handle);
115     gatt_client_report_error_if_pending(gatt_client, ATT_ERROR_TIMEOUT);
116 }
117 
118 static void gatt_client_timeout_start(gatt_client_t * gatt_client){
119     log_info("GATT client timeout start, handle 0x%02x", gatt_client->con_handle);
120     btstack_run_loop_remove_timer(&gatt_client->gc_timeout);
121     btstack_run_loop_set_timer_handler(&gatt_client->gc_timeout, gatt_client_timeout_handler);
122     btstack_run_loop_set_timer(&gatt_client->gc_timeout, 30000); // 30 seconds sm timeout
123     btstack_run_loop_add_timer(&gatt_client->gc_timeout);
124 }
125 
126 static void gatt_client_timeout_stop(gatt_client_t * gatt_client){
127     log_info("GATT client timeout stop, handle 0x%02x", gatt_client->con_handle);
128     btstack_run_loop_remove_timer(&gatt_client->gc_timeout);
129 }
130 
131 static gatt_client_t * gatt_client_get_context_for_handle(uint16_t handle){
132     btstack_linked_item_t *it;
133     for (it = (btstack_linked_item_t *) gatt_client_connections; it != NULL; it = it->next){
134         gatt_client_t * gatt_client = (gatt_client_t *) it;
135         if (gatt_client->con_handle == handle){
136             return gatt_client;
137         }
138     }
139     return NULL;
140 }
141 
142 
143 // @returns gatt_client context
144 // returns existing one, or tries to setup new one
145 static gatt_client_t * gatt_client_provide_context_for_handle(hci_con_handle_t con_handle){
146     gatt_client_t * gatt_client = gatt_client_get_context_for_handle(con_handle);
147     if (gatt_client) return gatt_client;
148 
149     // bail if no such hci connection
150     if (!hci_connection_for_handle(con_handle)){
151         log_error("No connection for handle 0x%04x", con_handle);
152         return NULL;
153     }
154     gatt_client = btstack_memory_gatt_client_get();
155     if (!gatt_client) return NULL;
156     // init state
157     gatt_client->con_handle = con_handle;
158     gatt_client->mtu = ATT_DEFAULT_MTU;
159     if (mtu_exchange_enabled){
160         gatt_client->mtu_state = SEND_MTU_EXCHANGE;
161     } else {
162         gatt_client->mtu_state = MTU_AUTO_EXCHANGE_DISABLED;
163     }
164     gatt_client->gatt_client_state = P_READY;
165     btstack_linked_list_add(&gatt_client_connections, (btstack_linked_item_t*)gatt_client);
166     return gatt_client;
167 }
168 
169 static gatt_client_t * gatt_client_provide_context_for_handle_and_start_timer(hci_con_handle_t con_handle){
170     gatt_client_t * gatt_client = gatt_client_provide_context_for_handle(con_handle);
171     if (gatt_client == NULL) return NULL;
172     gatt_client_timeout_start(gatt_client);
173     return gatt_client;
174 }
175 
176 static int is_ready(gatt_client_t * gatt_client){
177     return gatt_client->gatt_client_state == P_READY;
178 }
179 
180 int gatt_client_is_ready(hci_con_handle_t con_handle){
181     gatt_client_t * gatt_client = gatt_client_provide_context_for_handle(con_handle);
182     if (gatt_client == NULL) return 0;
183     return is_ready(gatt_client);
184 }
185 
186 void gatt_client_mtu_enable_auto_negotiation(uint8_t enabled){
187     mtu_exchange_enabled = enabled;
188 }
189 
190 uint8_t gatt_client_get_mtu(hci_con_handle_t con_handle, uint16_t * mtu){
191     gatt_client_t * gatt_client = gatt_client_provide_context_for_handle(con_handle);
192     if (gatt_client == NULL) return BTSTACK_MEMORY_ALLOC_FAILED;
193 
194     if ((gatt_client->mtu_state == MTU_EXCHANGED) || (gatt_client->mtu_state == MTU_AUTO_EXCHANGE_DISABLED)){
195         *mtu = gatt_client->mtu;
196         return ERROR_CODE_SUCCESS;
197     }
198     *mtu = ATT_DEFAULT_MTU;
199     return GATT_CLIENT_IN_WRONG_STATE;
200 }
201 
202 // precondition: can_send_packet_now == TRUE
203 static uint8_t att_confirmation(uint16_t con_handle){
204     l2cap_reserve_packet_buffer();
205     uint8_t * request = l2cap_get_outgoing_buffer();
206     request[0] = ATT_HANDLE_VALUE_CONFIRMATION;
207 
208     return l2cap_send_prepared_connectionless(con_handle, L2CAP_CID_ATTRIBUTE_PROTOCOL, 1);
209 }
210 
211 // precondition: can_send_packet_now == TRUE
212 static uint8_t att_find_information_request(uint16_t request_type, uint16_t con_handle, uint16_t start_handle, uint16_t end_handle){
213     l2cap_reserve_packet_buffer();
214     uint8_t * request = l2cap_get_outgoing_buffer();
215     request[0] = request_type;
216     little_endian_store_16(request, 1, start_handle);
217     little_endian_store_16(request, 3, end_handle);
218 
219     return l2cap_send_prepared_connectionless(con_handle, L2CAP_CID_ATTRIBUTE_PROTOCOL, 5);
220 }
221 
222 // precondition: can_send_packet_now == TRUE
223 static uint8_t att_find_by_type_value_request(uint16_t request_type, uint16_t attribute_group_type, uint16_t con_handle, uint16_t start_handle, uint16_t end_handle, uint8_t * value, uint16_t value_size){
224     l2cap_reserve_packet_buffer();
225     uint8_t * request = l2cap_get_outgoing_buffer();
226 
227     request[0] = request_type;
228     little_endian_store_16(request, 1, start_handle);
229     little_endian_store_16(request, 3, end_handle);
230     little_endian_store_16(request, 5, attribute_group_type);
231     (void)memcpy(&request[7], value, value_size);
232 
233     return l2cap_send_prepared_connectionless(con_handle, L2CAP_CID_ATTRIBUTE_PROTOCOL, 7u + value_size);
234 }
235 
236 // precondition: can_send_packet_now == TRUE
237 static uint8_t att_read_by_type_or_group_request_for_uuid16(uint16_t request_type, uint16_t uuid16, uint16_t con_handle, uint16_t start_handle, uint16_t end_handle){
238     l2cap_reserve_packet_buffer();
239     uint8_t * request = l2cap_get_outgoing_buffer();
240     request[0] = request_type;
241     little_endian_store_16(request, 1, start_handle);
242     little_endian_store_16(request, 3, end_handle);
243     little_endian_store_16(request, 5, uuid16);
244 
245     return l2cap_send_prepared_connectionless(con_handle, L2CAP_CID_ATTRIBUTE_PROTOCOL, 7);
246 }
247 
248 // precondition: can_send_packet_now == TRUE
249 static uint8_t att_read_by_type_or_group_request_for_uuid128(uint16_t request_type, uint8_t * uuid128, uint16_t con_handle, uint16_t start_handle, uint16_t end_handle){
250     l2cap_reserve_packet_buffer();
251     uint8_t * request = l2cap_get_outgoing_buffer();
252     request[0] = request_type;
253     little_endian_store_16(request, 1, start_handle);
254     little_endian_store_16(request, 3, end_handle);
255     reverse_128(uuid128, &request[5]);
256 
257     return l2cap_send_prepared_connectionless(con_handle, L2CAP_CID_ATTRIBUTE_PROTOCOL, 21);
258 }
259 
260 // precondition: can_send_packet_now == TRUE
261 static uint8_t att_read_request(uint16_t request_type, uint16_t con_handle, uint16_t attribute_handle){
262     l2cap_reserve_packet_buffer();
263     uint8_t * request = l2cap_get_outgoing_buffer();
264     request[0] = request_type;
265     little_endian_store_16(request, 1, attribute_handle);
266 
267     return l2cap_send_prepared_connectionless(con_handle, L2CAP_CID_ATTRIBUTE_PROTOCOL, 3);
268 }
269 
270 // precondition: can_send_packet_now == TRUE
271 static uint8_t att_read_blob_request(uint16_t request_type, uint16_t con_handle, uint16_t attribute_handle, uint16_t value_offset){
272     l2cap_reserve_packet_buffer();
273     uint8_t * request = l2cap_get_outgoing_buffer();
274     request[0] = request_type;
275     little_endian_store_16(request, 1, attribute_handle);
276     little_endian_store_16(request, 3, value_offset);
277 
278     return l2cap_send_prepared_connectionless(con_handle, L2CAP_CID_ATTRIBUTE_PROTOCOL, 5);
279 }
280 
281 static uint8_t att_read_multiple_request(uint16_t con_handle, uint16_t num_value_handles, uint16_t * value_handles){
282     l2cap_reserve_packet_buffer();
283     uint8_t * request = l2cap_get_outgoing_buffer();
284     request[0] = ATT_READ_MULTIPLE_REQUEST;
285     int i;
286     int offset = 1;
287     for (i=0;i<num_value_handles;i++){
288         little_endian_store_16(request, offset, value_handles[i]);
289         offset += 2;
290     }
291 
292     return l2cap_send_prepared_connectionless(con_handle, L2CAP_CID_ATTRIBUTE_PROTOCOL, offset);
293 }
294 
295 #ifdef ENABLE_LE_SIGNED_WRITE
296 // precondition: can_send_packet_now == TRUE
297 static uint8_t att_signed_write_request(uint16_t request_type, uint16_t con_handle, uint16_t attribute_handle, uint16_t value_length, uint8_t * value, uint32_t sign_counter, uint8_t sgn[8]){
298     l2cap_reserve_packet_buffer();
299     uint8_t * request = l2cap_get_outgoing_buffer();
300     request[0] = request_type;
301     little_endian_store_16(request, 1, attribute_handle);
302     (void)memcpy(&request[3], value, value_length);
303     little_endian_store_32(request, 3 + value_length, sign_counter);
304     reverse_64(sgn, &request[3 + value_length + 4]);
305 
306     return l2cap_send_prepared_connectionless(con_handle, L2CAP_CID_ATTRIBUTE_PROTOCOL, 3 + value_length + 12);
307 }
308 #endif
309 
310 // precondition: can_send_packet_now == TRUE
311 static uint8_t att_write_request(uint16_t request_type, uint16_t con_handle, uint16_t attribute_handle, uint16_t value_length, uint8_t * value){
312     l2cap_reserve_packet_buffer();
313     uint8_t * request = l2cap_get_outgoing_buffer();
314     request[0] = request_type;
315     little_endian_store_16(request, 1, attribute_handle);
316     (void)memcpy(&request[3], value, value_length);
317 
318     return l2cap_send_prepared_connectionless(con_handle, L2CAP_CID_ATTRIBUTE_PROTOCOL, 3u + value_length);
319 }
320 
321 // precondition: can_send_packet_now == TRUE
322 static uint8_t att_execute_write_request(uint16_t request_type, uint16_t con_handle, uint8_t execute_write){
323     l2cap_reserve_packet_buffer();
324     uint8_t * request = l2cap_get_outgoing_buffer();
325     request[0] = request_type;
326     request[1] = execute_write;
327 
328     return l2cap_send_prepared_connectionless(con_handle, L2CAP_CID_ATTRIBUTE_PROTOCOL, 2);
329 }
330 
331 // precondition: can_send_packet_now == TRUE
332 static uint8_t att_prepare_write_request(uint16_t request_type, uint16_t con_handle, uint16_t attribute_handle, uint16_t value_offset, uint16_t blob_length, uint8_t * value){
333     l2cap_reserve_packet_buffer();
334     uint8_t * request = l2cap_get_outgoing_buffer();
335     request[0] = request_type;
336     little_endian_store_16(request, 1, attribute_handle);
337     little_endian_store_16(request, 3, value_offset);
338     (void)memcpy(&request[5], &value[value_offset], blob_length);
339 
340     return l2cap_send_prepared_connectionless(con_handle, L2CAP_CID_ATTRIBUTE_PROTOCOL, 5u + blob_length);
341 }
342 
343 static uint8_t att_exchange_mtu_request(uint16_t con_handle){
344     uint16_t mtu = l2cap_max_le_mtu();
345     l2cap_reserve_packet_buffer();
346     uint8_t * request = l2cap_get_outgoing_buffer();
347     request[0] = ATT_EXCHANGE_MTU_REQUEST;
348     little_endian_store_16(request, 1, mtu);
349 
350     return l2cap_send_prepared_connectionless(con_handle, L2CAP_CID_ATTRIBUTE_PROTOCOL, 3);
351 }
352 
353 static uint16_t write_blob_length(gatt_client_t * gatt_client){
354     uint16_t max_blob_length = gatt_client->mtu - 5u;
355     if (gatt_client->attribute_offset >= gatt_client->attribute_length) {
356         return 0;
357     }
358     uint16_t rest_length = gatt_client->attribute_length - gatt_client->attribute_offset;
359     if (max_blob_length > rest_length){
360         return rest_length;
361     }
362     return max_blob_length;
363 }
364 
365 static void send_gatt_services_request(gatt_client_t *gatt_client){
366     att_read_by_type_or_group_request_for_uuid16(ATT_READ_BY_GROUP_TYPE_REQUEST, GATT_PRIMARY_SERVICE_UUID, gatt_client->con_handle, gatt_client->start_group_handle, gatt_client->end_group_handle);
367 }
368 
369 static void send_gatt_by_uuid_request(gatt_client_t *gatt_client, uint16_t attribute_group_type){
370     if (gatt_client->uuid16){
371         uint8_t uuid16[2];
372         little_endian_store_16(uuid16, 0, gatt_client->uuid16);
373         att_find_by_type_value_request(ATT_FIND_BY_TYPE_VALUE_REQUEST, attribute_group_type, gatt_client->con_handle, gatt_client->start_group_handle, gatt_client->end_group_handle, uuid16, 2);
374         return;
375     }
376     uint8_t uuid128[16];
377     reverse_128(gatt_client->uuid128, uuid128);
378     att_find_by_type_value_request(ATT_FIND_BY_TYPE_VALUE_REQUEST, attribute_group_type, gatt_client->con_handle, gatt_client->start_group_handle, gatt_client->end_group_handle, uuid128, 16);
379 }
380 
381 static void send_gatt_services_by_uuid_request(gatt_client_t *gatt_client){
382     send_gatt_by_uuid_request(gatt_client, GATT_PRIMARY_SERVICE_UUID);
383 }
384 
385 static void send_gatt_included_service_uuid_request(gatt_client_t *gatt_client){
386     att_read_request(ATT_READ_REQUEST, gatt_client->con_handle, gatt_client->query_start_handle);
387 }
388 
389 static void send_gatt_included_service_request(gatt_client_t *gatt_client){
390     att_read_by_type_or_group_request_for_uuid16(ATT_READ_BY_TYPE_REQUEST, GATT_INCLUDE_SERVICE_UUID, gatt_client->con_handle, gatt_client->start_group_handle, gatt_client->end_group_handle);
391 }
392 
393 static void send_gatt_characteristic_request(gatt_client_t *gatt_client){
394     att_read_by_type_or_group_request_for_uuid16(ATT_READ_BY_TYPE_REQUEST, GATT_CHARACTERISTICS_UUID, gatt_client->con_handle, gatt_client->start_group_handle, gatt_client->end_group_handle);
395 }
396 
397 static void send_gatt_characteristic_descriptor_request(gatt_client_t *gatt_client){
398     att_find_information_request(ATT_FIND_INFORMATION_REQUEST, gatt_client->con_handle, gatt_client->start_group_handle, gatt_client->end_group_handle);
399 }
400 
401 static void send_gatt_read_characteristic_value_request(gatt_client_t *gatt_client){
402     att_read_request(ATT_READ_REQUEST, gatt_client->con_handle, gatt_client->attribute_handle);
403 }
404 
405 static void send_gatt_read_by_type_request(gatt_client_t * gatt_client){
406     if (gatt_client->uuid16){
407         att_read_by_type_or_group_request_for_uuid16(ATT_READ_BY_TYPE_REQUEST, gatt_client->uuid16, gatt_client->con_handle, gatt_client->start_group_handle, gatt_client->end_group_handle);
408     } else {
409         att_read_by_type_or_group_request_for_uuid128(ATT_READ_BY_TYPE_REQUEST, gatt_client->uuid128, gatt_client->con_handle, gatt_client->start_group_handle, gatt_client->end_group_handle);
410     }
411 }
412 
413 static void send_gatt_read_blob_request(gatt_client_t *gatt_client){
414     att_read_blob_request(ATT_READ_BLOB_REQUEST, gatt_client->con_handle, gatt_client->attribute_handle, gatt_client->attribute_offset);
415 }
416 
417 static void send_gatt_read_multiple_request(gatt_client_t * gatt_client){
418     att_read_multiple_request(gatt_client->con_handle, gatt_client->read_multiple_handle_count, gatt_client->read_multiple_handles);
419 }
420 
421 static void send_gatt_write_attribute_value_request(gatt_client_t * gatt_client){
422     att_write_request(ATT_WRITE_REQUEST, gatt_client->con_handle, gatt_client->attribute_handle, gatt_client->attribute_length, gatt_client->attribute_value);
423 }
424 
425 static void send_gatt_write_client_characteristic_configuration_request(gatt_client_t * gatt_client){
426     att_write_request(ATT_WRITE_REQUEST, gatt_client->con_handle, gatt_client->client_characteristic_configuration_handle, 2, gatt_client->client_characteristic_configuration_value);
427 }
428 
429 static void send_gatt_prepare_write_request(gatt_client_t * gatt_client){
430     att_prepare_write_request(ATT_PREPARE_WRITE_REQUEST, gatt_client->con_handle, gatt_client->attribute_handle, gatt_client->attribute_offset, write_blob_length(gatt_client), gatt_client->attribute_value);
431 }
432 
433 static void send_gatt_execute_write_request(gatt_client_t * gatt_client){
434     att_execute_write_request(ATT_EXECUTE_WRITE_REQUEST, gatt_client->con_handle, 1);
435 }
436 
437 static void send_gatt_cancel_prepared_write_request(gatt_client_t * gatt_client){
438     att_execute_write_request(ATT_EXECUTE_WRITE_REQUEST, gatt_client->con_handle, 0);
439 }
440 
441 #ifndef ENABLE_GATT_FIND_INFORMATION_FOR_CCC_DISCOVERY
442 static void send_gatt_read_client_characteristic_configuration_request(gatt_client_t * gatt_client){
443     att_read_by_type_or_group_request_for_uuid16(ATT_READ_BY_TYPE_REQUEST, GATT_CLIENT_CHARACTERISTICS_CONFIGURATION, gatt_client->con_handle, gatt_client->start_group_handle, gatt_client->end_group_handle);
444 }
445 #endif
446 
447 static void send_gatt_read_characteristic_descriptor_request(gatt_client_t * gatt_client){
448     att_read_request(ATT_READ_REQUEST, gatt_client->con_handle, gatt_client->attribute_handle);
449 }
450 
451 #ifdef ENABLE_LE_SIGNED_WRITE
452 static void send_gatt_signed_write_request(gatt_client_t * gatt_client, uint32_t sign_counter){
453     att_signed_write_request(ATT_SIGNED_WRITE_COMMAND, gatt_client->con_handle, gatt_client->attribute_handle, gatt_client->attribute_length, gatt_client->attribute_value, sign_counter, gatt_client->cmac);
454 }
455 #endif
456 
457 static uint16_t get_last_result_handle_from_service_list(uint8_t * packet, uint16_t size){
458     uint8_t attr_length = packet[1];
459     return little_endian_read_16(packet, size - attr_length + 2u);
460 }
461 
462 static uint16_t get_last_result_handle_from_characteristics_list(uint8_t * packet, uint16_t size){
463     uint8_t attr_length = packet[1];
464     return little_endian_read_16(packet, size - attr_length + 3u);
465 }
466 
467 static uint16_t get_last_result_handle_from_included_services_list(uint8_t * packet, uint16_t size){
468     uint8_t attr_length = packet[1];
469     return little_endian_read_16(packet, size - attr_length);
470 }
471 
472 static void gatt_client_handle_transaction_complete(gatt_client_t * gatt_client){
473     gatt_client->gatt_client_state = P_READY;
474     gatt_client_timeout_stop(gatt_client);
475 }
476 
477 static void emit_event_new(btstack_packet_handler_t callback, uint8_t * packet, uint16_t size){
478     if (!callback) return;
479     hci_dump_packet(HCI_EVENT_PACKET, 0, packet, size);
480     (*callback)(HCI_EVENT_PACKET, 0, packet, size);
481 }
482 
483 void gatt_client_listen_for_characteristic_value_updates(gatt_client_notification_t * notification, btstack_packet_handler_t packet_handler, hci_con_handle_t con_handle, gatt_client_characteristic_t * characteristic){
484     notification->callback = packet_handler;
485     notification->con_handle = con_handle;
486     if (characteristic == NULL){
487         notification->attribute_handle = GATT_CLIENT_ANY_VALUE_HANDLE;
488     } else {
489         notification->attribute_handle = characteristic->value_handle;
490     }
491     btstack_linked_list_add(&gatt_client_value_listeners, (btstack_linked_item_t*) notification);
492 }
493 
494 void gatt_client_stop_listening_for_characteristic_value_updates(gatt_client_notification_t * notification){
495     btstack_linked_list_remove(&gatt_client_value_listeners, (btstack_linked_item_t*) notification);
496 }
497 
498 static void emit_event_to_registered_listeners(hci_con_handle_t con_handle, uint16_t attribute_handle, uint8_t * packet, uint16_t size){
499     btstack_linked_list_iterator_t it;
500     btstack_linked_list_iterator_init(&it, &gatt_client_value_listeners);
501     while (btstack_linked_list_iterator_has_next(&it)){
502         gatt_client_notification_t * notification = (gatt_client_notification_t*) btstack_linked_list_iterator_next(&it);
503         if ((notification->con_handle       != GATT_CLIENT_ANY_CONNECTION)   && (notification->con_handle       != con_handle)) continue;
504         if ((notification->attribute_handle != GATT_CLIENT_ANY_VALUE_HANDLE) && (notification->attribute_handle != attribute_handle)) continue;
505         (*notification->callback)(HCI_EVENT_PACKET, 0, packet, size);
506     }
507 }
508 
509 static void emit_gatt_complete_event(gatt_client_t * gatt_client, uint8_t att_status){
510     // @format H1
511     uint8_t packet[5];
512     packet[0] = GATT_EVENT_QUERY_COMPLETE;
513     packet[1] = 3;
514     little_endian_store_16(packet, 2, gatt_client->con_handle);
515     packet[4] = att_status;
516     emit_event_new(gatt_client->callback, packet, sizeof(packet));
517 }
518 
519 static void emit_gatt_service_query_result_event(gatt_client_t * gatt_client, uint16_t start_group_handle, uint16_t end_group_handle, uint8_t * uuid128){
520     // @format HX
521     uint8_t packet[24];
522     packet[0] = GATT_EVENT_SERVICE_QUERY_RESULT;
523     packet[1] = sizeof(packet) - 2u;
524     little_endian_store_16(packet, 2, gatt_client->con_handle);
525     ///
526     little_endian_store_16(packet, 4, start_group_handle);
527     little_endian_store_16(packet, 6, end_group_handle);
528     reverse_128(uuid128, &packet[8]);
529     emit_event_new(gatt_client->callback, packet, sizeof(packet));
530 }
531 
532 static void emit_gatt_included_service_query_result_event(gatt_client_t * gatt_client, uint16_t include_handle, uint16_t start_group_handle, uint16_t end_group_handle, uint8_t * uuid128){
533     // @format HX
534     uint8_t packet[26];
535     packet[0] = GATT_EVENT_INCLUDED_SERVICE_QUERY_RESULT;
536     packet[1] = sizeof(packet) - 2u;
537     little_endian_store_16(packet, 2, gatt_client->con_handle);
538     ///
539     little_endian_store_16(packet, 4, include_handle);
540     //
541     little_endian_store_16(packet, 6, start_group_handle);
542     little_endian_store_16(packet, 8, end_group_handle);
543     reverse_128(uuid128, &packet[10]);
544     emit_event_new(gatt_client->callback, packet, sizeof(packet));
545 }
546 
547 static void emit_gatt_characteristic_query_result_event(gatt_client_t * gatt_client, uint16_t start_handle, uint16_t value_handle, uint16_t end_handle,
548                                                         uint16_t properties, uint8_t * uuid128){
549     // @format HY
550     uint8_t packet[28];
551     packet[0] = GATT_EVENT_CHARACTERISTIC_QUERY_RESULT;
552     packet[1] = sizeof(packet) - 2u;
553     little_endian_store_16(packet, 2, gatt_client->con_handle);
554     ///
555     little_endian_store_16(packet, 4,  start_handle);
556     little_endian_store_16(packet, 6,  value_handle);
557     little_endian_store_16(packet, 8,  end_handle);
558     little_endian_store_16(packet, 10, properties);
559     reverse_128(uuid128, &packet[12]);
560     emit_event_new(gatt_client->callback, packet, sizeof(packet));
561 }
562 
563 static void emit_gatt_all_characteristic_descriptors_result_event(
564         gatt_client_t * gatt_client, uint16_t descriptor_handle, uint8_t * uuid128){
565     // @format HZ
566     uint8_t packet[22];
567     packet[0] = GATT_EVENT_ALL_CHARACTERISTIC_DESCRIPTORS_QUERY_RESULT;
568     packet[1] = sizeof(packet) - 2u;
569     little_endian_store_16(packet, 2, gatt_client->con_handle);
570     ///
571     little_endian_store_16(packet, 4,  descriptor_handle);
572     reverse_128(uuid128, &packet[6]);
573     emit_event_new(gatt_client->callback, packet, sizeof(packet));
574 }
575 
576 static void emit_gatt_mtu_exchanged_result_event(gatt_client_t * gatt_client, uint16_t new_mtu){
577     // @format H2
578     uint8_t packet[6];
579     packet[0] = GATT_EVENT_MTU;
580     packet[1] = sizeof(packet) - 2u;
581     little_endian_store_16(packet, 2, gatt_client->con_handle);
582     little_endian_store_16(packet, 4, new_mtu);
583     att_dispatch_client_mtu_exchanged(gatt_client->con_handle, new_mtu);
584     emit_event_new(gatt_client->callback, packet, sizeof(packet));
585 }
586 ///
587 static void report_gatt_services(gatt_client_t * gatt_client, uint8_t * packet, uint16_t size){
588     uint8_t attr_length = packet[1];
589     uint8_t uuid_length = attr_length - 4u;
590 
591     int i;
592     for (i = 2; i < size; i += attr_length){
593         uint16_t start_group_handle = little_endian_read_16(packet,i);
594         uint16_t end_group_handle   = little_endian_read_16(packet,i+2);
595         uint8_t  uuid128[16];
596         uint16_t uuid16 = 0;
597 
598         if (uuid_length == 2u){
599             uuid16 = little_endian_read_16(packet, i+4);
600             uuid_add_bluetooth_prefix((uint8_t*) &uuid128, uuid16);
601         } else {
602             reverse_128(&packet[i+4], uuid128);
603         }
604         emit_gatt_service_query_result_event(gatt_client, start_group_handle, end_group_handle, uuid128);
605     }
606 }
607 
608 // helper
609 static void characteristic_start_found(gatt_client_t * gatt_client, uint16_t start_handle, uint8_t properties, uint16_t value_handle, uint8_t * uuid, uint16_t uuid_length){
610     uint8_t uuid128[16];
611     uint16_t uuid16 = 0;
612     if (uuid_length == 2u){
613         uuid16 = little_endian_read_16(uuid, 0);
614         uuid_add_bluetooth_prefix((uint8_t*) uuid128, uuid16);
615     } else if (uuid_length == 16u){
616         reverse_128(uuid, uuid128);
617     } else {
618         return;
619     }
620 
621     if (gatt_client->filter_with_uuid && (memcmp(gatt_client->uuid128, uuid128, 16) != 0)) return;
622 
623     gatt_client->characteristic_properties = properties;
624     gatt_client->characteristic_start_handle = start_handle;
625     gatt_client->attribute_handle = value_handle;
626 
627     if (gatt_client->filter_with_uuid) return;
628 
629     gatt_client->uuid16 = uuid16;
630     (void)memcpy(gatt_client->uuid128, uuid128, 16);
631 }
632 
633 static void characteristic_end_found(gatt_client_t * gatt_client, uint16_t end_handle){
634     // TODO: stop searching if filter and uuid found
635 
636     if (!gatt_client->characteristic_start_handle) return;
637 
638     emit_gatt_characteristic_query_result_event(gatt_client, gatt_client->characteristic_start_handle, gatt_client->attribute_handle,
639                                                 end_handle, gatt_client->characteristic_properties, gatt_client->uuid128);
640 
641     gatt_client->characteristic_start_handle = 0;
642 }
643 
644 static void report_gatt_characteristics(gatt_client_t * gatt_client, uint8_t * packet, uint16_t size){
645     if (size < 2u) return;
646     uint8_t attr_length = packet[1];
647     if ((attr_length != 7u) && (attr_length != 21u)) return;
648     uint8_t uuid_length = attr_length - 5u;
649     int i;
650     for (i = 2u; (i + attr_length) <= size; i += attr_length){
651         uint16_t start_handle = little_endian_read_16(packet, i);
652         uint8_t  properties = packet[i+2];
653         uint16_t value_handle = little_endian_read_16(packet, i+3);
654         characteristic_end_found(gatt_client, start_handle - 1u);
655         characteristic_start_found(gatt_client, start_handle, properties, value_handle, &packet[i + 5], uuid_length);
656     }
657 }
658 
659 static void report_gatt_included_service_uuid16(gatt_client_t * gatt_client, uint16_t include_handle, uint16_t uuid16){
660     uint8_t normalized_uuid128[16];
661     uuid_add_bluetooth_prefix(normalized_uuid128, uuid16);
662     emit_gatt_included_service_query_result_event(gatt_client, include_handle, gatt_client->query_start_handle,
663                                                   gatt_client->query_end_handle, normalized_uuid128);
664 }
665 
666 static void report_gatt_included_service_uuid128(gatt_client_t * gatt_client, uint16_t include_handle, uint8_t *uuid128){
667     emit_gatt_included_service_query_result_event(gatt_client, include_handle, gatt_client->query_start_handle,
668                                                   gatt_client->query_end_handle, uuid128);
669 }
670 
671 // @returns packet pointer
672 // @note assume that value is part of an l2cap buffer - overwrite HCI + L2CAP packet headers
673 static const int characteristic_value_event_header_size = 8;
674 static uint8_t * setup_characteristic_value_packet(uint8_t type, hci_con_handle_t con_handle, uint16_t attribute_handle, uint8_t * value, uint16_t length){
675 #ifdef FUZZING_BUILD_MODE_UNSAFE_FOR_PRODUCTION
676     // avoid using pre ATT headers.
677     return NULL;
678 #endif
679     // before the value inside the ATT PDU
680     uint8_t * packet = value - characteristic_value_event_header_size;
681     packet[0] = type;
682     packet[1] = characteristic_value_event_header_size - 2 + length;
683     little_endian_store_16(packet, 2, con_handle);
684     little_endian_store_16(packet, 4, attribute_handle);
685     little_endian_store_16(packet, 6, length);
686     return packet;
687 }
688 
689 // @returns packet pointer
690 // @note assume that value is part of an l2cap buffer - overwrite parts of the HCI/L2CAP/ATT packet (4/4/3) bytes
691 static const int long_characteristic_value_event_header_size = 10;
692 static uint8_t * setup_long_characteristic_value_packet(uint8_t type, hci_con_handle_t con_handle, uint16_t attribute_handle, uint16_t offset, uint8_t * value, uint16_t length){
693 #ifdef FUZZING_BUILD_MODE_UNSAFE_FOR_PRODUCTION
694     // avoid using pre ATT headers.
695     return NULL;
696 #endif
697 #if defined(HCI_INCOMING_PRE_BUFFER_SIZE) && (HCI_INCOMING_PRE_BUFFER_SIZE >= 10 - 8) // L2CAP Header (4) - ACL Header (4)
698     // before the value inside the ATT PDU
699     uint8_t * packet = value - long_characteristic_value_event_header_size;
700     packet[0] = type;
701     packet[1] = long_characteristic_value_event_header_size - 2 + length;
702     little_endian_store_16(packet, 2, con_handle);
703     little_endian_store_16(packet, 4, attribute_handle);
704     little_endian_store_16(packet, 6, offset);
705     little_endian_store_16(packet, 8, length);
706     return packet;
707 #else
708     log_error("HCI_INCOMING_PRE_BUFFER_SIZE >= 2 required for long characteristic reads");
709     return NULL;
710 #endif
711 }
712 
713 // test if notification/indication should be delivered to application (BLESA)
714 static bool gatt_client_accept_server_message(hci_con_handle_t con_handle){
715 #ifdef ENABLE_LE_PROACTIVE_AUTHENTICATION
716 	// ignore messages until re-encryption is complete
717     if (gap_reconnect_security_setup_active(con_handle)) return false;
718 
719 	// after that ignore if bonded but not encrypted
720 	return !gap_bonded(con_handle) || (gap_encryption_key_size(con_handle) > 0);
721 #else
722 	return true;
723 #endif
724 }
725 
726 
727 // @note assume that value is part of an l2cap buffer - overwrite parts of the HCI/L2CAP/ATT packet (4/4/3) bytes
728 static void report_gatt_notification(hci_con_handle_t con_handle, uint16_t value_handle, uint8_t * value, int length){
729 	if (!gatt_client_accept_server_message(con_handle)) return;
730     uint8_t * packet = setup_characteristic_value_packet(GATT_EVENT_NOTIFICATION, con_handle, value_handle, value, length);
731     emit_event_to_registered_listeners(con_handle, value_handle, packet, characteristic_value_event_header_size + length);
732 }
733 
734 // @note assume that value is part of an l2cap buffer - overwrite parts of the HCI/L2CAP/ATT packet (4/4/3) bytes
735 static void report_gatt_indication(hci_con_handle_t con_handle, uint16_t value_handle, uint8_t * value, int length){
736 	if (!gatt_client_accept_server_message(con_handle)) return;
737     uint8_t * packet = setup_characteristic_value_packet(GATT_EVENT_INDICATION, con_handle, value_handle, value, length);
738     emit_event_to_registered_listeners(con_handle, value_handle, packet, characteristic_value_event_header_size + length);
739 }
740 
741 // @note assume that value is part of an l2cap buffer - overwrite parts of the HCI/L2CAP/ATT packet (4/4/3) bytes
742 static void report_gatt_characteristic_value(gatt_client_t * gatt_client, uint16_t attribute_handle, uint8_t * value, uint16_t length){
743     uint8_t * packet = setup_characteristic_value_packet(GATT_EVENT_CHARACTERISTIC_VALUE_QUERY_RESULT, gatt_client->con_handle, attribute_handle, value, length);
744     emit_event_new(gatt_client->callback, packet, characteristic_value_event_header_size + length);
745 }
746 
747 // @note assume that value is part of an l2cap buffer - overwrite parts of the HCI/L2CAP/ATT packet (4/4/3) bytes
748 static void report_gatt_long_characteristic_value_blob(gatt_client_t * gatt_client, uint16_t attribute_handle, uint8_t * blob, uint16_t blob_length, int value_offset){
749     uint8_t * packet = setup_long_characteristic_value_packet(GATT_EVENT_LONG_CHARACTERISTIC_VALUE_QUERY_RESULT, gatt_client->con_handle, attribute_handle, value_offset, blob, blob_length);
750     if (!packet) return;
751     emit_event_new(gatt_client->callback, packet, blob_length + long_characteristic_value_event_header_size);
752 }
753 
754 static void report_gatt_characteristic_descriptor(gatt_client_t * gatt_client, uint16_t descriptor_handle, uint8_t *value, uint16_t value_length, uint16_t value_offset){
755     UNUSED(value_offset);
756     uint8_t * packet = setup_characteristic_value_packet(GATT_EVENT_CHARACTERISTIC_DESCRIPTOR_QUERY_RESULT, gatt_client->con_handle, descriptor_handle, value, value_length);
757     emit_event_new(gatt_client->callback, packet, value_length + 8u);
758 }
759 
760 static void report_gatt_long_characteristic_descriptor(gatt_client_t * gatt_client, uint16_t descriptor_handle, uint8_t *blob, uint16_t blob_length, uint16_t value_offset){
761     uint8_t * packet = setup_long_characteristic_value_packet(GATT_EVENT_LONG_CHARACTERISTIC_DESCRIPTOR_QUERY_RESULT, gatt_client->con_handle, descriptor_handle, value_offset, blob, blob_length);
762     if (!packet) return;
763     emit_event_new(gatt_client->callback, packet, blob_length + long_characteristic_value_event_header_size);
764 }
765 
766 static void report_gatt_all_characteristic_descriptors(gatt_client_t * gatt_client, uint8_t * packet, uint16_t size, uint16_t pair_size){
767     int i;
768     for (i = 0u; (i + pair_size) <= size; i += pair_size){
769         uint16_t descriptor_handle = little_endian_read_16(packet,i);
770         uint8_t uuid128[16];
771         uint16_t uuid16 = 0;
772         if (pair_size == 4u){
773             uuid16 = little_endian_read_16(packet,i+2);
774             uuid_add_bluetooth_prefix(uuid128, uuid16);
775         } else {
776             reverse_128(&packet[i+2], uuid128);
777         }
778         emit_gatt_all_characteristic_descriptors_result_event(gatt_client, descriptor_handle, uuid128);
779     }
780 
781 }
782 
783 static int is_query_done(gatt_client_t * gatt_client, uint16_t last_result_handle){
784     return last_result_handle >= gatt_client->end_group_handle;
785 }
786 
787 static void trigger_next_query(gatt_client_t * gatt_client, uint16_t last_result_handle, gatt_client_state_t next_query_state){
788     if (is_query_done(gatt_client, last_result_handle)){
789         gatt_client_handle_transaction_complete(gatt_client);
790         emit_gatt_complete_event(gatt_client, ATT_ERROR_SUCCESS);
791         return;
792     }
793     // next
794     gatt_client->start_group_handle = last_result_handle + 1u;
795     gatt_client->gatt_client_state = next_query_state;
796 }
797 
798 static void trigger_next_included_service_query(gatt_client_t * gatt_client, uint16_t last_result_handle){
799     trigger_next_query(gatt_client, last_result_handle, P_W2_SEND_INCLUDED_SERVICE_QUERY);
800 }
801 
802 static void trigger_next_service_query(gatt_client_t * gatt_client, uint16_t last_result_handle){
803     trigger_next_query(gatt_client, last_result_handle, P_W2_SEND_SERVICE_QUERY);
804 }
805 
806 static void trigger_next_service_by_uuid_query(gatt_client_t * gatt_client, uint16_t last_result_handle){
807     trigger_next_query(gatt_client, last_result_handle, P_W2_SEND_SERVICE_WITH_UUID_QUERY);
808 }
809 
810 static void trigger_next_characteristic_query(gatt_client_t * gatt_client, uint16_t last_result_handle){
811     if (is_query_done(gatt_client, last_result_handle)){
812         // report last characteristic
813         characteristic_end_found(gatt_client, gatt_client->end_group_handle);
814     }
815     trigger_next_query(gatt_client, last_result_handle, P_W2_SEND_ALL_CHARACTERISTICS_OF_SERVICE_QUERY);
816 }
817 
818 static void trigger_next_characteristic_descriptor_query(gatt_client_t * gatt_client, uint16_t last_result_handle){
819     trigger_next_query(gatt_client, last_result_handle, P_W2_SEND_ALL_CHARACTERISTIC_DESCRIPTORS_QUERY);
820 }
821 
822 static void trigger_next_read_by_type_query(gatt_client_t * gatt_client, uint16_t last_result_handle){
823     trigger_next_query(gatt_client, last_result_handle, P_W2_SEND_READ_BY_TYPE_REQUEST);
824 }
825 
826 static void trigger_next_prepare_write_query(gatt_client_t * gatt_client, gatt_client_state_t next_query_state, gatt_client_state_t done_state){
827     gatt_client->attribute_offset += write_blob_length(gatt_client);
828     uint16_t next_blob_length =  write_blob_length(gatt_client);
829 
830     if (next_blob_length == 0u){
831         gatt_client->gatt_client_state = done_state;
832         return;
833     }
834     gatt_client->gatt_client_state = next_query_state;
835 }
836 
837 static void trigger_next_blob_query(gatt_client_t * gatt_client, gatt_client_state_t next_query_state, uint16_t received_blob_length){
838 
839     uint16_t max_blob_length = gatt_client->mtu - 1u;
840     if (received_blob_length < max_blob_length){
841         gatt_client_handle_transaction_complete(gatt_client);
842         emit_gatt_complete_event(gatt_client, ATT_ERROR_SUCCESS);
843         return;
844     }
845 
846     gatt_client->attribute_offset += received_blob_length;
847     gatt_client->gatt_client_state = next_query_state;
848 }
849 
850 
851 static int is_value_valid(gatt_client_t *gatt_client, uint8_t *packet, uint16_t size){
852     uint16_t attribute_handle = little_endian_read_16(packet, 1);
853     uint16_t value_offset = little_endian_read_16(packet, 3);
854 
855     if (gatt_client->attribute_handle != attribute_handle) return 0;
856     if (gatt_client->attribute_offset != value_offset) return 0;
857     return memcmp(&gatt_client->attribute_value[gatt_client->attribute_offset], &packet[5], size - 5u) == 0u;
858 }
859 
860 // returns 1 if packet was sent
861 static int gatt_client_run_for_gatt_client(gatt_client_t * gatt_client){
862 
863     // wait until re-encryption as central is complete
864     if (gap_reconnect_security_setup_active(gatt_client->con_handle)) return 0;
865 
866 #ifdef ENABLE_LE_PROACTIVE_AUTHENTICATION
867     // wait until re-encryption complete
868     if (gatt_client->reencryption_active) return 0;
869 #endif
870 
871 #ifdef ENABLE_GATT_CLIENT_PAIRING
872     // wait until pairing complete
873     if (gatt_client->wait_for_pairing_complete) return 0;
874 #endif
875 
876     switch (gatt_client->mtu_state) {
877         case SEND_MTU_EXCHANGE:
878             gatt_client->mtu_state = SENT_MTU_EXCHANGE;
879             att_exchange_mtu_request(gatt_client->con_handle);
880             return 1;
881         case SENT_MTU_EXCHANGE:
882             return 0;
883         default:
884             break;
885     }
886 
887     if (gatt_client->send_confirmation){
888         gatt_client->send_confirmation = 0;
889         att_confirmation(gatt_client->con_handle);
890         return 1;
891     }
892 
893     // check MTU for writes
894     switch (gatt_client->gatt_client_state){
895         case P_W2_SEND_WRITE_CHARACTERISTIC_VALUE:
896         case P_W2_SEND_WRITE_CHARACTERISTIC_DESCRIPTOR:
897             if (gatt_client->attribute_length <= (gatt_client->mtu - 3u)) break;
898             log_error("gatt_client_run: value len %u > MTU %u - 3\n", gatt_client->attribute_length,gatt_client->mtu);
899             gatt_client_handle_transaction_complete(gatt_client);
900             emit_gatt_complete_event(gatt_client, ATT_ERROR_INVALID_ATTRIBUTE_VALUE_LENGTH);
901             return 0;
902         default:
903             break;
904     }
905 
906     switch (gatt_client->gatt_client_state){
907         case P_W2_SEND_SERVICE_QUERY:
908             gatt_client->gatt_client_state = P_W4_SERVICE_QUERY_RESULT;
909             send_gatt_services_request(gatt_client);
910             return 1;
911 
912         case P_W2_SEND_SERVICE_WITH_UUID_QUERY:
913             gatt_client->gatt_client_state = P_W4_SERVICE_WITH_UUID_RESULT;
914             send_gatt_services_by_uuid_request(gatt_client);
915             return 1;
916 
917         case P_W2_SEND_ALL_CHARACTERISTICS_OF_SERVICE_QUERY:
918             gatt_client->gatt_client_state = P_W4_ALL_CHARACTERISTICS_OF_SERVICE_QUERY_RESULT;
919             send_gatt_characteristic_request(gatt_client);
920             return 1;
921 
922         case P_W2_SEND_CHARACTERISTIC_WITH_UUID_QUERY:
923             gatt_client->gatt_client_state = P_W4_CHARACTERISTIC_WITH_UUID_QUERY_RESULT;
924             send_gatt_characteristic_request(gatt_client);
925             return 1;
926 
927         case P_W2_SEND_ALL_CHARACTERISTIC_DESCRIPTORS_QUERY:
928             gatt_client->gatt_client_state = P_W4_CHARACTERISTIC_WITH_UUID_QUERY_RESULT;
929             send_gatt_characteristic_descriptor_request(gatt_client);
930             return 1;
931 
932         case P_W2_SEND_INCLUDED_SERVICE_QUERY:
933             gatt_client->gatt_client_state = P_W4_INCLUDED_SERVICE_QUERY_RESULT;
934             send_gatt_included_service_request(gatt_client);
935             return 1;
936 
937         case P_W2_SEND_INCLUDED_SERVICE_WITH_UUID_QUERY:
938             gatt_client->gatt_client_state = P_W4_INCLUDED_SERVICE_UUID_WITH_QUERY_RESULT;
939             send_gatt_included_service_uuid_request(gatt_client);
940             return 1;
941 
942         case P_W2_SEND_READ_CHARACTERISTIC_VALUE_QUERY:
943             gatt_client->gatt_client_state = P_W4_READ_CHARACTERISTIC_VALUE_RESULT;
944             send_gatt_read_characteristic_value_request(gatt_client);
945             return 1;
946 
947         case P_W2_SEND_READ_BLOB_QUERY:
948             gatt_client->gatt_client_state = P_W4_READ_BLOB_RESULT;
949             send_gatt_read_blob_request(gatt_client);
950             return 1;
951 
952         case P_W2_SEND_READ_BY_TYPE_REQUEST:
953             gatt_client->gatt_client_state = P_W4_READ_BY_TYPE_RESPONSE;
954             send_gatt_read_by_type_request(gatt_client);
955             return 1;
956 
957         case P_W2_SEND_READ_MULTIPLE_REQUEST:
958             gatt_client->gatt_client_state = P_W4_READ_MULTIPLE_RESPONSE;
959             send_gatt_read_multiple_request(gatt_client);
960             return 1;
961 
962         case P_W2_SEND_WRITE_CHARACTERISTIC_VALUE:
963             gatt_client->gatt_client_state = P_W4_WRITE_CHARACTERISTIC_VALUE_RESULT;
964             send_gatt_write_attribute_value_request(gatt_client);
965             return 1;
966 
967         case P_W2_PREPARE_WRITE:
968             gatt_client->gatt_client_state = P_W4_PREPARE_WRITE_RESULT;
969             send_gatt_prepare_write_request(gatt_client);
970             return 1;
971 
972         case P_W2_PREPARE_WRITE_SINGLE:
973             gatt_client->gatt_client_state = P_W4_PREPARE_WRITE_SINGLE_RESULT;
974             send_gatt_prepare_write_request(gatt_client);
975             return 1;
976 
977         case P_W2_PREPARE_RELIABLE_WRITE:
978             gatt_client->gatt_client_state = P_W4_PREPARE_RELIABLE_WRITE_RESULT;
979             send_gatt_prepare_write_request(gatt_client);
980             return 1;
981 
982         case P_W2_EXECUTE_PREPARED_WRITE:
983             gatt_client->gatt_client_state = P_W4_EXECUTE_PREPARED_WRITE_RESULT;
984             send_gatt_execute_write_request(gatt_client);
985             return 1;
986 
987         case P_W2_CANCEL_PREPARED_WRITE:
988             gatt_client->gatt_client_state = P_W4_CANCEL_PREPARED_WRITE_RESULT;
989             send_gatt_cancel_prepared_write_request(gatt_client);
990             return 1;
991 
992         case P_W2_CANCEL_PREPARED_WRITE_DATA_MISMATCH:
993             gatt_client->gatt_client_state = P_W4_CANCEL_PREPARED_WRITE_DATA_MISMATCH_RESULT;
994             send_gatt_cancel_prepared_write_request(gatt_client);
995             return 1;
996 
997 #ifdef ENABLE_GATT_FIND_INFORMATION_FOR_CCC_DISCOVERY
998         case P_W2_SEND_FIND_CLIENT_CHARACTERISTIC_CONFIGURATION_QUERY:
999             // use Find Information
1000             gatt_client->gatt_client_state = P_W4_FIND_CLIENT_CHARACTERISTIC_CONFIGURATION_QUERY_RESULT;
1001             send_gatt_characteristic_descriptor_request(gatt_client);
1002 #else
1003         case P_W2_SEND_READ_CLIENT_CHARACTERISTIC_CONFIGURATION_QUERY:
1004             // Use Read By Type
1005             gatt_client->gatt_client_state = P_W4_READ_CLIENT_CHARACTERISTIC_CONFIGURATION_QUERY_RESULT;
1006             send_gatt_read_client_characteristic_configuration_request(gatt_client);
1007 #endif
1008             return 1;
1009 
1010         case P_W2_SEND_READ_CHARACTERISTIC_DESCRIPTOR_QUERY:
1011             gatt_client->gatt_client_state = P_W4_READ_CHARACTERISTIC_DESCRIPTOR_RESULT;
1012             send_gatt_read_characteristic_descriptor_request(gatt_client);
1013             return 1;
1014 
1015         case P_W2_SEND_READ_BLOB_CHARACTERISTIC_DESCRIPTOR_QUERY:
1016             gatt_client->gatt_client_state = P_W4_READ_BLOB_CHARACTERISTIC_DESCRIPTOR_RESULT;
1017             send_gatt_read_blob_request(gatt_client);
1018             return 1;
1019 
1020         case P_W2_SEND_WRITE_CHARACTERISTIC_DESCRIPTOR:
1021             gatt_client->gatt_client_state = P_W4_WRITE_CHARACTERISTIC_DESCRIPTOR_RESULT;
1022             send_gatt_write_attribute_value_request(gatt_client);
1023             return 1;
1024 
1025         case P_W2_WRITE_CLIENT_CHARACTERISTIC_CONFIGURATION:
1026             gatt_client->gatt_client_state = P_W4_CLIENT_CHARACTERISTIC_CONFIGURATION_RESULT;
1027             send_gatt_write_client_characteristic_configuration_request(gatt_client);
1028             return 1;
1029 
1030         case P_W2_PREPARE_WRITE_CHARACTERISTIC_DESCRIPTOR:
1031             gatt_client->gatt_client_state = P_W4_PREPARE_WRITE_CHARACTERISTIC_DESCRIPTOR_RESULT;
1032             send_gatt_prepare_write_request(gatt_client);
1033             return 1;
1034 
1035         case P_W2_EXECUTE_PREPARED_WRITE_CHARACTERISTIC_DESCRIPTOR:
1036             gatt_client->gatt_client_state = P_W4_EXECUTE_PREPARED_WRITE_CHARACTERISTIC_DESCRIPTOR_RESULT;
1037             send_gatt_execute_write_request(gatt_client);
1038             return 1;
1039 
1040 #ifdef ENABLE_LE_SIGNED_WRITE
1041         case P_W4_IDENTITY_RESOLVING:
1042             log_info("P_W4_IDENTITY_RESOLVING - state %x", sm_identity_resolving_state(gatt_client->con_handle));
1043             switch (sm_identity_resolving_state(gatt_client->con_handle)){
1044                 case IRK_LOOKUP_SUCCEEDED:
1045                     gatt_client->le_device_index = sm_le_device_index(gatt_client->con_handle);
1046                     gatt_client->gatt_client_state = P_W4_CMAC_READY;
1047                     break;
1048                 case IRK_LOOKUP_FAILED:
1049                     gatt_client_handle_transaction_complete(gatt_client);
1050                     emit_gatt_complete_event(gatt_client, ATT_ERROR_BONDING_INFORMATION_MISSING);
1051                     return 0;
1052                 default:
1053                     return 0;
1054             }
1055 
1056             /* Fall through */
1057 
1058         case P_W4_CMAC_READY:
1059             if (sm_cmac_ready()){
1060                 sm_key_t csrk;
1061                 le_device_db_local_csrk_get(gatt_client->le_device_index, csrk);
1062                 uint32_t sign_counter = le_device_db_local_counter_get(gatt_client->le_device_index);
1063                 gatt_client->gatt_client_state = P_W4_CMAC_RESULT;
1064                 sm_cmac_signed_write_start(csrk, ATT_SIGNED_WRITE_COMMAND, gatt_client->attribute_handle, gatt_client->attribute_length, gatt_client->attribute_value, sign_counter, att_signed_write_handle_cmac_result);
1065             }
1066             return 0;
1067 
1068         case P_W2_SEND_SIGNED_WRITE: {
1069             gatt_client->gatt_client_state = P_W4_SEND_SINGED_WRITE_DONE;
1070             // bump local signing counter
1071             uint32_t sign_counter = le_device_db_local_counter_get(gatt_client->le_device_index);
1072             le_device_db_local_counter_set(gatt_client->le_device_index, sign_counter + 1);
1073             // send signed write command
1074             send_gatt_signed_write_request(gatt_client, sign_counter);
1075             // finally, notifiy client that write is complete
1076             gatt_client_handle_transaction_complete(gatt_client);
1077             emit_gatt_complete_event(gatt_client, ATT_ERROR_SUCCESS);
1078             return 1;
1079         }
1080 #endif
1081         default:
1082             break;
1083     }
1084 
1085     // requested can send snow?
1086     if (gatt_client->write_without_response_callback){
1087         btstack_packet_handler_t packet_handler = gatt_client->write_without_response_callback;
1088         gatt_client->write_without_response_callback = NULL;
1089         uint8_t event[4];
1090         event[0] = GATT_EVENT_CAN_WRITE_WITHOUT_RESPONSE;
1091         event[1] = sizeof(event) - 2u;
1092         little_endian_store_16(event, 2, gatt_client->con_handle);
1093         packet_handler(HCI_EVENT_PACKET, gatt_client->con_handle, event, sizeof(event));
1094         return 1; // to trigger requeueing (even if higher layer didn't sent)
1095     }
1096 
1097     return 0;
1098 }
1099 
1100 static void gatt_client_run(void){
1101     btstack_linked_item_t *it;
1102     for (it = (btstack_linked_item_t *) gatt_client_connections; it != NULL; it = it->next){
1103         gatt_client_t * gatt_client = (gatt_client_t *) it;
1104         if (!att_dispatch_client_can_send_now(gatt_client->con_handle)) {
1105             att_dispatch_client_request_can_send_now_event(gatt_client->con_handle);
1106             return;
1107         }
1108         int packet_sent = gatt_client_run_for_gatt_client(gatt_client);
1109         if (packet_sent){
1110             // request new permission
1111             att_dispatch_client_request_can_send_now_event(gatt_client->con_handle);
1112             // requeue client for fairness and exit
1113             // note: iterator has become invalid
1114             btstack_linked_list_remove(&gatt_client_connections, (btstack_linked_item_t *) gatt_client);
1115             btstack_linked_list_add_tail(&gatt_client_connections, (btstack_linked_item_t *) gatt_client);
1116             return;
1117         }
1118     }
1119 }
1120 
1121 static void gatt_client_report_error_if_pending(gatt_client_t *gatt_client, uint8_t att_error_code) {
1122     if (is_ready(gatt_client) == 1) return;
1123     gatt_client_handle_transaction_complete(gatt_client);
1124     emit_gatt_complete_event(gatt_client, att_error_code);
1125 }
1126 
1127 static void gatt_client_event_packet_handler(uint8_t packet_type, uint16_t channel, uint8_t *packet, uint16_t size){
1128     UNUSED(channel);    // ok: handling own l2cap events
1129     UNUSED(size);       // ok: there is no channel
1130 
1131     if (packet_type != HCI_EVENT_PACKET) return;
1132 
1133     hci_con_handle_t con_handle;
1134     gatt_client_t * gatt_client;
1135     switch (hci_event_packet_get_type(packet)) {
1136         case HCI_EVENT_DISCONNECTION_COMPLETE:
1137             log_info("GATT Client: HCI_EVENT_DISCONNECTION_COMPLETE");
1138             con_handle = little_endian_read_16(packet,3);
1139             gatt_client = gatt_client_get_context_for_handle(con_handle);
1140             if (gatt_client == NULL) break;
1141 
1142             gatt_client_report_error_if_pending(gatt_client, ATT_ERROR_HCI_DISCONNECT_RECEIVED);
1143             gatt_client_timeout_stop(gatt_client);
1144             btstack_linked_list_remove(&gatt_client_connections, (btstack_linked_item_t *) gatt_client);
1145             btstack_memory_gatt_client_free(gatt_client);
1146             break;
1147 
1148 #ifdef ENABLE_GATT_CLIENT_PAIRING
1149         // Pairing complete (with/without bonding=storing of pairing information)
1150         case SM_EVENT_PAIRING_COMPLETE:
1151             con_handle = sm_event_pairing_complete_get_handle(packet);
1152             gatt_client = gatt_client_get_context_for_handle(con_handle);
1153             if (gatt_client == NULL) break;
1154 
1155             if (gatt_client->wait_for_pairing_complete){
1156                 gatt_client->wait_for_pairing_complete = 0;
1157                 if (sm_event_pairing_complete_get_status(packet)){
1158                     log_info("pairing failed, report previous error 0x%x", gatt_client->pending_error_code);
1159                     gatt_client_report_error_if_pending(gatt_client, gatt_client->pending_error_code);
1160                 } else {
1161                     log_info("pairing success, retry operation");
1162                 }
1163             }
1164             break;
1165 #endif
1166 #ifdef ENABLE_LE_SIGNED_WRITE
1167         // Identity Resolving completed (no code, gatt_client_run will continue)
1168         case SM_EVENT_IDENTITY_RESOLVING_SUCCEEDED:
1169         case SM_EVENT_IDENTITY_RESOLVING_FAILED:
1170             break;
1171 #endif
1172 #ifdef ENABLE_LE_PROACTIVE_AUTHENTICATION
1173         // re-encryption started
1174         case SM_EVENT_REENCRYPTION_STARTED:
1175             con_handle = sm_event_reencryption_complete_get_handle(packet);
1176             gatt_client = gatt_client_get_context_for_handle(con_handle);
1177             if (gatt_client == NULL) break;
1178 
1179             gatt_client->reencryption_active = true;
1180             gatt_client->reencryption_result = ERROR_CODE_SUCCESS;
1181             break;
1182 
1183         // re-encryption complete
1184         case SM_EVENT_REENCRYPTION_COMPLETE:
1185             con_handle = sm_event_reencryption_complete_get_handle(packet);
1186             gatt_client = gatt_client_get_context_for_handle(con_handle);
1187             if (gatt_client == NULL) break;
1188 
1189             // report bonding information missing, if re-encryption failed
1190             gatt_client->reencryption_result = sm_event_reencryption_complete_get_status(packet);
1191             gatt_client->reencryption_active = false;
1192             if (gatt_client->reencryption_result != ERROR_CODE_SUCCESS){
1193                 gatt_client_report_error_if_pending(gatt_client, ATT_ERROR_BONDING_INFORMATION_MISSING);
1194             } else {
1195                 log_info("re-encryption success, retry operation");
1196             }
1197             break;
1198 #endif
1199         default:
1200             break;
1201     }
1202 
1203     gatt_client_run();
1204 }
1205 
1206 static void gatt_client_att_packet_handler(uint8_t packet_type, uint16_t handle, uint8_t *packet, uint16_t size){
1207     gatt_client_t * gatt_client;
1208     if (size < 1u) return;
1209 
1210     if (packet_type == HCI_EVENT_PACKET) {
1211         switch (packet[0]){
1212             case L2CAP_EVENT_CAN_SEND_NOW:
1213                 gatt_client_run();
1214                 break;
1215             // att_server has negotiated the mtu for this connection, cache if context exists
1216             case ATT_EVENT_MTU_EXCHANGE_COMPLETE:
1217                 if (size < 6u) break;
1218                 gatt_client = gatt_client_get_context_for_handle(handle);
1219                 if (gatt_client == NULL) break;
1220                 gatt_client->mtu = little_endian_read_16(packet, 4);
1221                 break;
1222             default:
1223                 break;
1224         }
1225         return;
1226     }
1227 
1228     if (packet_type != ATT_DATA_PACKET) return;
1229 
1230     // special cases: notifications don't need a context while indications motivate creating one
1231     switch (packet[0]){
1232         case ATT_HANDLE_VALUE_NOTIFICATION:
1233             if (size < 3u) return;
1234             report_gatt_notification(handle, little_endian_read_16(packet,1u), &packet[3], size-3u);
1235             return;
1236         case ATT_HANDLE_VALUE_INDICATION:
1237             gatt_client = gatt_client_provide_context_for_handle(handle);
1238             break;
1239         default:
1240             gatt_client = gatt_client_get_context_for_handle(handle);
1241             break;
1242     }
1243 
1244     if (gatt_client == NULL) return;
1245 
1246     uint8_t error_code;
1247     switch (packet[0]){
1248         case ATT_EXCHANGE_MTU_RESPONSE:
1249         {
1250             if (size < 3u) break;
1251             uint16_t remote_rx_mtu = little_endian_read_16(packet, 1);
1252             uint16_t local_rx_mtu = l2cap_max_le_mtu();
1253             gatt_client->mtu = (remote_rx_mtu < local_rx_mtu) ? remote_rx_mtu : local_rx_mtu;
1254             gatt_client->mtu_state = MTU_EXCHANGED;
1255             emit_gatt_mtu_exchanged_result_event(gatt_client, gatt_client->mtu);
1256             break;
1257         }
1258         case ATT_READ_BY_GROUP_TYPE_RESPONSE:
1259             switch(gatt_client->gatt_client_state){
1260                 case P_W4_SERVICE_QUERY_RESULT:
1261                     report_gatt_services(gatt_client, packet, size);
1262                     trigger_next_service_query(gatt_client, get_last_result_handle_from_service_list(packet, size));
1263                     // GATT_EVENT_QUERY_COMPLETE is emitted by trigger_next_xxx when done
1264                     break;
1265                 default:
1266                     break;
1267             }
1268             break;
1269         case ATT_HANDLE_VALUE_INDICATION:
1270             if (size < 3u) break;
1271             report_gatt_indication(handle, little_endian_read_16(packet,1u), &packet[3], size-3u);
1272             gatt_client->send_confirmation = 1;
1273             break;
1274 
1275         case ATT_READ_BY_TYPE_RESPONSE:
1276             switch (gatt_client->gatt_client_state){
1277                 case P_W4_ALL_CHARACTERISTICS_OF_SERVICE_QUERY_RESULT:
1278                     report_gatt_characteristics(gatt_client, packet, size);
1279                     trigger_next_characteristic_query(gatt_client, get_last_result_handle_from_characteristics_list(packet, size));
1280                     // GATT_EVENT_QUERY_COMPLETE is emitted by trigger_next_xxx when done, or by ATT_ERROR
1281                     break;
1282                 case P_W4_CHARACTERISTIC_WITH_UUID_QUERY_RESULT:
1283                     report_gatt_characteristics(gatt_client, packet, size);
1284                     trigger_next_characteristic_query(gatt_client, get_last_result_handle_from_characteristics_list(packet, size));
1285                     // GATT_EVENT_QUERY_COMPLETE is emitted by trigger_next_xxx when done, or by ATT_ERROR
1286                     break;
1287                 case P_W4_INCLUDED_SERVICE_QUERY_RESULT:
1288                 {
1289                     if (size < 2u) break;
1290                     uint16_t uuid16 = 0;
1291                     uint16_t pair_size = packet[1];
1292 
1293                     if (pair_size == 6u){
1294                         if (size < 8u) break;
1295                         // UUIDs not available, query first included service
1296                         gatt_client->start_group_handle = little_endian_read_16(packet, 2); // ready for next query
1297                         gatt_client->query_start_handle = little_endian_read_16(packet, 4);
1298                         gatt_client->query_end_handle = little_endian_read_16(packet, 6);
1299                         gatt_client->gatt_client_state = P_W2_SEND_INCLUDED_SERVICE_WITH_UUID_QUERY;
1300                         break;
1301                     }
1302 
1303                     if (pair_size != 8u) break;
1304 
1305                     // UUIDs included, report all of them
1306                     uint16_t offset;
1307                     for (offset = 2u; (offset + 8u) <= size; offset += pair_size){
1308                         uint16_t include_handle = little_endian_read_16(packet, offset);
1309                         gatt_client->query_start_handle = little_endian_read_16(packet, offset + 2u);
1310                         gatt_client->query_end_handle = little_endian_read_16(packet, offset + 4u);
1311                         uuid16 = little_endian_read_16(packet, offset+6u);
1312                         report_gatt_included_service_uuid16(gatt_client, include_handle, uuid16);
1313                     }
1314 
1315                     trigger_next_included_service_query(gatt_client, get_last_result_handle_from_included_services_list(packet, size));
1316                     // GATT_EVENT_QUERY_COMPLETE is emitted by trigger_next_xxx when done
1317                     break;
1318                 }
1319 #ifndef ENABLE_GATT_FIND_INFORMATION_FOR_CCC_DISCOVERY
1320                 case P_W4_READ_CLIENT_CHARACTERISTIC_CONFIGURATION_QUERY_RESULT:
1321                     gatt_client->client_characteristic_configuration_handle = little_endian_read_16(packet, 2);
1322                     gatt_client->gatt_client_state = P_W2_WRITE_CLIENT_CHARACTERISTIC_CONFIGURATION;
1323                     break;
1324 #endif
1325                 case P_W4_READ_BY_TYPE_RESPONSE: {
1326                     uint16_t pair_size = packet[1];
1327                     uint16_t offset;
1328                     uint16_t last_result_handle = 0;
1329                     for (offset = 2; offset < size ; offset += pair_size){
1330                         uint16_t value_handle = little_endian_read_16(packet, offset);
1331                         report_gatt_characteristic_value(gatt_client, value_handle, &packet[offset + 2u], pair_size - 2u);
1332                         last_result_handle = value_handle;
1333                     }
1334                     trigger_next_read_by_type_query(gatt_client, last_result_handle);
1335                     break;
1336                 }
1337                 default:
1338                     break;
1339             }
1340             break;
1341         case ATT_READ_RESPONSE:
1342             switch (gatt_client->gatt_client_state){
1343                 case P_W4_INCLUDED_SERVICE_UUID_WITH_QUERY_RESULT: {
1344                     uint8_t uuid128[16];
1345                     reverse_128(&packet[1], uuid128);
1346                     report_gatt_included_service_uuid128(gatt_client, gatt_client->start_group_handle, uuid128);
1347                     trigger_next_included_service_query(gatt_client, gatt_client->start_group_handle);
1348                     // GATT_EVENT_QUERY_COMPLETE is emitted by trigger_next_xxx when done
1349                     break;
1350                 }
1351                 case P_W4_READ_CHARACTERISTIC_VALUE_RESULT:
1352                     gatt_client_handle_transaction_complete(gatt_client);
1353                     report_gatt_characteristic_value(gatt_client, gatt_client->attribute_handle, &packet[1], size - 1u);
1354                     emit_gatt_complete_event(gatt_client, ATT_ERROR_SUCCESS);
1355                     break;
1356 
1357                 case P_W4_READ_CHARACTERISTIC_DESCRIPTOR_RESULT:{
1358                     gatt_client_handle_transaction_complete(gatt_client);
1359                     report_gatt_characteristic_descriptor(gatt_client, gatt_client->attribute_handle, &packet[1], size - 1u, 0u);
1360                     emit_gatt_complete_event(gatt_client, ATT_ERROR_SUCCESS);
1361                     break;
1362                 }
1363                 default:
1364                     break;
1365             }
1366             break;
1367 
1368         case ATT_FIND_BY_TYPE_VALUE_RESPONSE:
1369         {
1370             uint8_t pair_size = 4;
1371             int i;
1372             uint16_t start_group_handle;
1373             uint16_t   end_group_handle= 0xffff; // asserts GATT_EVENT_QUERY_COMPLETE is emitted if no results
1374             for (i = 1u; (i + pair_size) <= size; i += pair_size){
1375                 start_group_handle = little_endian_read_16(packet,i);
1376                 end_group_handle = little_endian_read_16(packet,i+2);
1377                 emit_gatt_service_query_result_event(gatt_client, start_group_handle, end_group_handle, gatt_client->uuid128);
1378             }
1379             trigger_next_service_by_uuid_query(gatt_client, end_group_handle);
1380             // GATT_EVENT_QUERY_COMPLETE is emitted by trigger_next_xxx when done
1381             break;
1382         }
1383         case ATT_FIND_INFORMATION_REPLY:
1384         {
1385             if (size < 2u) break;
1386 
1387             uint8_t pair_size = 4;
1388             if (packet[1u] == 2u){
1389                 pair_size = 18;
1390             }
1391             uint16_t offset = 2;
1392 
1393             if (size < (pair_size + offset)) break;
1394             uint16_t last_descriptor_handle = little_endian_read_16(packet, size - pair_size);
1395 
1396 #ifdef ENABLE_GATT_FIND_INFORMATION_FOR_CCC_DISCOVERY
1397             log_info("ENABLE_GATT_FIND_INFORMATION_FOR_CCC_DISCOVERY, state %x", gatt_client->gatt_client_state);
1398             if (gatt_client->gatt_client_state == P_W4_FIND_CLIENT_CHARACTERISTIC_CONFIGURATION_QUERY_RESULT){
1399                 // iterate over descriptors looking for CCC
1400                 if (pair_size == 4){
1401                     while ((offset + 4) <= size){
1402                         uint16_t uuid16 = little_endian_read_16(packet, offset + 2);
1403                         if (uuid16 == GATT_CLIENT_CHARACTERISTICS_CONFIGURATION){
1404                             gatt_client->client_characteristic_configuration_handle = little_endian_read_16(packet, offset);
1405                             gatt_client->gatt_client_state = P_W2_WRITE_CLIENT_CHARACTERISTIC_CONFIGURATION;
1406                             log_info("CCC found %x", gatt_client->client_characteristic_configuration_handle);
1407                             break;
1408                         }
1409                         offset += pair_size;
1410                     }
1411                 }
1412                 if (is_query_done(gatt_client, last_descriptor_handle)){
1413 
1414                 } else {
1415                     // next
1416                     gatt_client->start_group_handle = last_descriptor_handle + 1;
1417                     gatt_client->gatt_client_state = P_W2_SEND_FIND_CLIENT_CHARACTERISTIC_CONFIGURATION_QUERY;
1418                 }
1419                 break;
1420             }
1421 #endif
1422             report_gatt_all_characteristic_descriptors(gatt_client, &packet[2], size - 2u, pair_size);
1423             trigger_next_characteristic_descriptor_query(gatt_client, last_descriptor_handle);
1424             // GATT_EVENT_QUERY_COMPLETE is emitted by trigger_next_xxx when done
1425             break;
1426         }
1427 
1428         case ATT_WRITE_RESPONSE:
1429             switch (gatt_client->gatt_client_state){
1430                 case P_W4_WRITE_CHARACTERISTIC_VALUE_RESULT:
1431                     gatt_client_handle_transaction_complete(gatt_client);
1432                     emit_gatt_complete_event(gatt_client, ATT_ERROR_SUCCESS);
1433                     break;
1434                 case P_W4_CLIENT_CHARACTERISTIC_CONFIGURATION_RESULT:
1435                     gatt_client_handle_transaction_complete(gatt_client);
1436                     emit_gatt_complete_event(gatt_client, ATT_ERROR_SUCCESS);
1437                     break;
1438                 case P_W4_WRITE_CHARACTERISTIC_DESCRIPTOR_RESULT:
1439                     gatt_client_handle_transaction_complete(gatt_client);
1440                     emit_gatt_complete_event(gatt_client, ATT_ERROR_SUCCESS);
1441                     break;
1442                 default:
1443                     break;
1444             }
1445             break;
1446 
1447         case ATT_READ_BLOB_RESPONSE:{
1448             uint16_t received_blob_length = size-1u;
1449             switch(gatt_client->gatt_client_state){
1450                 case P_W4_READ_BLOB_RESULT:
1451                     report_gatt_long_characteristic_value_blob(gatt_client, gatt_client->attribute_handle, &packet[1], received_blob_length, gatt_client->attribute_offset);
1452                     trigger_next_blob_query(gatt_client, P_W2_SEND_READ_BLOB_QUERY, received_blob_length);
1453                     // GATT_EVENT_QUERY_COMPLETE is emitted by trigger_next_xxx when done
1454                     break;
1455                 case P_W4_READ_BLOB_CHARACTERISTIC_DESCRIPTOR_RESULT:
1456                     report_gatt_long_characteristic_descriptor(gatt_client, gatt_client->attribute_handle,
1457                                                                &packet[1], received_blob_length,
1458                                                                gatt_client->attribute_offset);
1459                     trigger_next_blob_query(gatt_client, P_W2_SEND_READ_BLOB_CHARACTERISTIC_DESCRIPTOR_QUERY, received_blob_length);
1460                     // GATT_EVENT_QUERY_COMPLETE is emitted by trigger_next_xxx when done
1461                     break;
1462                 default:
1463                     break;
1464             }
1465             break;
1466         }
1467         case ATT_PREPARE_WRITE_RESPONSE:
1468             switch (gatt_client->gatt_client_state){
1469                 case P_W4_PREPARE_WRITE_SINGLE_RESULT:
1470                     gatt_client_handle_transaction_complete(gatt_client);
1471                     if (is_value_valid(gatt_client, packet, size)){
1472                         emit_gatt_complete_event(gatt_client, ATT_ERROR_SUCCESS);
1473                     } else {
1474                         emit_gatt_complete_event(gatt_client, ATT_ERROR_DATA_MISMATCH);
1475                     }
1476                     break;
1477 
1478                 case P_W4_PREPARE_WRITE_RESULT:{
1479                     gatt_client->attribute_offset = little_endian_read_16(packet, 3);
1480                     trigger_next_prepare_write_query(gatt_client, P_W2_PREPARE_WRITE, P_W2_EXECUTE_PREPARED_WRITE);
1481                     // GATT_EVENT_QUERY_COMPLETE is emitted by trigger_next_xxx when done
1482                     break;
1483                 }
1484                 case P_W4_PREPARE_WRITE_CHARACTERISTIC_DESCRIPTOR_RESULT:{
1485                     gatt_client->attribute_offset = little_endian_read_16(packet, 3);
1486                     trigger_next_prepare_write_query(gatt_client, P_W2_PREPARE_WRITE_CHARACTERISTIC_DESCRIPTOR, P_W2_EXECUTE_PREPARED_WRITE_CHARACTERISTIC_DESCRIPTOR);
1487                     // GATT_EVENT_QUERY_COMPLETE is emitted by trigger_next_xxx when done
1488                     break;
1489                 }
1490                 case P_W4_PREPARE_RELIABLE_WRITE_RESULT:{
1491                     if (is_value_valid(gatt_client, packet, size)){
1492                         gatt_client->attribute_offset = little_endian_read_16(packet, 3);
1493                         trigger_next_prepare_write_query(gatt_client, P_W2_PREPARE_RELIABLE_WRITE, P_W2_EXECUTE_PREPARED_WRITE);
1494                         // GATT_EVENT_QUERY_COMPLETE is emitted by trigger_next_xxx when done
1495                         break;
1496                     }
1497                     gatt_client->gatt_client_state = P_W2_CANCEL_PREPARED_WRITE_DATA_MISMATCH;
1498                     break;
1499                 }
1500                 default:
1501                     break;
1502             }
1503             break;
1504 
1505         case ATT_EXECUTE_WRITE_RESPONSE:
1506             switch (gatt_client->gatt_client_state){
1507                 case P_W4_EXECUTE_PREPARED_WRITE_RESULT:
1508                     gatt_client_handle_transaction_complete(gatt_client);
1509                     emit_gatt_complete_event(gatt_client, ATT_ERROR_SUCCESS);
1510                     break;
1511                 case P_W4_CANCEL_PREPARED_WRITE_RESULT:
1512                     gatt_client_handle_transaction_complete(gatt_client);
1513                     emit_gatt_complete_event(gatt_client, ATT_ERROR_SUCCESS);
1514                     break;
1515                 case P_W4_CANCEL_PREPARED_WRITE_DATA_MISMATCH_RESULT:
1516                     gatt_client_handle_transaction_complete(gatt_client);
1517                     emit_gatt_complete_event(gatt_client, ATT_ERROR_DATA_MISMATCH);
1518                     break;
1519                 case P_W4_EXECUTE_PREPARED_WRITE_CHARACTERISTIC_DESCRIPTOR_RESULT:
1520                     gatt_client_handle_transaction_complete(gatt_client);
1521                     emit_gatt_complete_event(gatt_client, ATT_ERROR_SUCCESS);
1522                     break;
1523                 default:
1524                     break;
1525 
1526             }
1527             break;
1528 
1529         case ATT_READ_MULTIPLE_RESPONSE:
1530             switch(gatt_client->gatt_client_state){
1531                 case P_W4_READ_MULTIPLE_RESPONSE:
1532                     report_gatt_characteristic_value(gatt_client, 0u, &packet[1], size - 1u);
1533                     gatt_client_handle_transaction_complete(gatt_client);
1534                     emit_gatt_complete_event(gatt_client, ATT_ERROR_SUCCESS);
1535                     break;
1536                 default:
1537                     break;
1538             }
1539             break;
1540 
1541         case ATT_ERROR_RESPONSE:
1542             if (size < 5u) return;
1543             error_code = packet[4];
1544             switch (error_code){
1545                 case ATT_ERROR_ATTRIBUTE_NOT_FOUND: {
1546                     switch(gatt_client->gatt_client_state){
1547                         case P_W4_SERVICE_QUERY_RESULT:
1548                         case P_W4_SERVICE_WITH_UUID_RESULT:
1549                         case P_W4_INCLUDED_SERVICE_QUERY_RESULT:
1550                         case P_W4_ALL_CHARACTERISTIC_DESCRIPTORS_QUERY_RESULT:
1551                             gatt_client_handle_transaction_complete(gatt_client);
1552                             emit_gatt_complete_event(gatt_client, ATT_ERROR_SUCCESS);
1553                             break;
1554                         case P_W4_ALL_CHARACTERISTICS_OF_SERVICE_QUERY_RESULT:
1555                         case P_W4_CHARACTERISTIC_WITH_UUID_QUERY_RESULT:
1556                             characteristic_end_found(gatt_client, gatt_client->end_group_handle);
1557                             gatt_client_handle_transaction_complete(gatt_client);
1558                             emit_gatt_complete_event(gatt_client, ATT_ERROR_SUCCESS);
1559                             break;
1560                         case P_W4_READ_BY_TYPE_RESPONSE:
1561                             gatt_client_handle_transaction_complete(gatt_client);
1562                             if (gatt_client->start_group_handle == gatt_client->query_start_handle){
1563                                 emit_gatt_complete_event(gatt_client, ATT_ERROR_ATTRIBUTE_NOT_FOUND);
1564                             } else {
1565                                 emit_gatt_complete_event(gatt_client, ATT_ERROR_SUCCESS);
1566                             }
1567                             break;
1568                         default:
1569                             gatt_client_report_error_if_pending(gatt_client, error_code);
1570                             break;
1571                     }
1572                     break;
1573                 }
1574 
1575 #ifdef ENABLE_GATT_CLIENT_PAIRING
1576 
1577                 case ATT_ERROR_INSUFFICIENT_AUTHENTICATION:
1578                 case ATT_ERROR_INSUFFICIENT_ENCRYPTION_KEY_SIZE:
1579                 case ATT_ERROR_INSUFFICIENT_ENCRYPTION: {
1580 
1581                     // security too low
1582                     if (gatt_client->security_counter > 0) {
1583                         gatt_client_report_error_if_pending(gatt_client, error_code);
1584                         break;
1585                     }
1586                     // start security
1587                     gatt_client->security_counter++;
1588 
1589                     // setup action
1590                     int retry = 1;
1591                     switch (gatt_client->gatt_client_state){
1592                         case P_W4_READ_CHARACTERISTIC_VALUE_RESULT:
1593                             gatt_client->gatt_client_state = P_W2_SEND_READ_CHARACTERISTIC_VALUE_QUERY ;
1594                             break;
1595                         case P_W4_READ_BLOB_RESULT:
1596                             gatt_client->gatt_client_state = P_W2_SEND_READ_BLOB_QUERY;
1597                             break;
1598                         case P_W4_READ_BY_TYPE_RESPONSE:
1599                             gatt_client->gatt_client_state = P_W2_SEND_READ_BY_TYPE_REQUEST;
1600                             break;
1601                         case P_W4_READ_MULTIPLE_RESPONSE:
1602                             gatt_client->gatt_client_state = P_W2_SEND_READ_MULTIPLE_REQUEST;
1603                             break;
1604                         case P_W4_WRITE_CHARACTERISTIC_VALUE_RESULT:
1605                             gatt_client->gatt_client_state = P_W2_SEND_WRITE_CHARACTERISTIC_VALUE;
1606                             break;
1607                         case P_W4_PREPARE_WRITE_RESULT:
1608                             gatt_client->gatt_client_state = P_W2_PREPARE_WRITE;
1609                             break;
1610                         case P_W4_PREPARE_WRITE_SINGLE_RESULT:
1611                             gatt_client->gatt_client_state = P_W2_PREPARE_WRITE_SINGLE;
1612                             break;
1613                         case P_W4_PREPARE_RELIABLE_WRITE_RESULT:
1614                             gatt_client->gatt_client_state = P_W2_PREPARE_RELIABLE_WRITE;
1615                             break;
1616                         case P_W4_EXECUTE_PREPARED_WRITE_RESULT:
1617                             gatt_client->gatt_client_state = P_W2_EXECUTE_PREPARED_WRITE;
1618                             break;
1619                         case P_W4_CANCEL_PREPARED_WRITE_RESULT:
1620                             gatt_client->gatt_client_state = P_W2_CANCEL_PREPARED_WRITE;
1621                             break;
1622                         case P_W4_CANCEL_PREPARED_WRITE_DATA_MISMATCH_RESULT:
1623                             gatt_client->gatt_client_state = P_W2_CANCEL_PREPARED_WRITE_DATA_MISMATCH;
1624                             break;
1625                         case P_W4_READ_CHARACTERISTIC_DESCRIPTOR_RESULT:
1626                             gatt_client->gatt_client_state = P_W2_SEND_READ_CHARACTERISTIC_DESCRIPTOR_QUERY;
1627                             break;
1628                         case P_W4_READ_BLOB_CHARACTERISTIC_DESCRIPTOR_RESULT:
1629                             gatt_client->gatt_client_state = P_W2_SEND_READ_BLOB_CHARACTERISTIC_DESCRIPTOR_QUERY;
1630                             break;
1631                         case P_W4_WRITE_CHARACTERISTIC_DESCRIPTOR_RESULT:
1632                             gatt_client->gatt_client_state = P_W2_SEND_WRITE_CHARACTERISTIC_DESCRIPTOR;
1633                             break;
1634                         case P_W4_CLIENT_CHARACTERISTIC_CONFIGURATION_RESULT:
1635                             gatt_client->gatt_client_state = P_W2_WRITE_CLIENT_CHARACTERISTIC_CONFIGURATION;
1636                             break;
1637                         case P_W4_PREPARE_WRITE_CHARACTERISTIC_DESCRIPTOR_RESULT:
1638                             gatt_client->gatt_client_state = P_W2_PREPARE_WRITE_CHARACTERISTIC_DESCRIPTOR;
1639                             break;
1640                         case P_W4_EXECUTE_PREPARED_WRITE_CHARACTERISTIC_DESCRIPTOR_RESULT:
1641                             gatt_client->gatt_client_state = P_W2_EXECUTE_PREPARED_WRITE_CHARACTERISTIC_DESCRIPTOR;
1642                             break;
1643 #ifdef ENABLE_LE_SIGNED_WRITE
1644                         case P_W4_SEND_SINGED_WRITE_DONE:
1645                             gatt_client->gatt_client_state = P_W2_SEND_SIGNED_WRITE;
1646                             break;
1647 #endif
1648                         default:
1649                             log_info("retry not supported for state %x", gatt_client->gatt_client_state);
1650                             retry = 0;
1651                             break;
1652                     }
1653 
1654                     if (!retry) {
1655                         gatt_client_report_error_if_pending(gatt_client, error_code);
1656                         break;
1657                     }
1658 
1659                     log_info("security error, start pairing");
1660 
1661                     // start pairing for higher security level
1662                     gatt_client->wait_for_pairing_complete = 1;
1663                     gatt_client->pending_error_code = error_code;
1664                     sm_request_pairing(gatt_client->con_handle);
1665                     break;
1666                 }
1667 #endif
1668 
1669                 // nothing we can do about that
1670                 case ATT_ERROR_INSUFFICIENT_AUTHORIZATION:
1671                 default:
1672                     gatt_client_report_error_if_pending(gatt_client, error_code);
1673                     break;
1674             }
1675             break;
1676 
1677         default:
1678             log_info("ATT Handler, unhandled response type 0x%02x", packet[0]);
1679             break;
1680     }
1681     gatt_client_run();
1682 }
1683 
1684 #ifdef ENABLE_LE_SIGNED_WRITE
1685 static void att_signed_write_handle_cmac_result(uint8_t hash[8]){
1686     btstack_linked_list_iterator_t it;
1687     btstack_linked_list_iterator_init(&it, &gatt_client_connections);
1688     while (btstack_linked_list_iterator_has_next(&it)){
1689         gatt_client_t * gatt_client = (gatt_client_t *) btstack_linked_list_iterator_next(&it);
1690         if (gatt_client->gatt_client_state == P_W4_CMAC_RESULT){
1691             // store result
1692             (void)memcpy(gatt_client->cmac, hash, 8);
1693             // reverse_64(hash, gatt_client->cmac);
1694             gatt_client->gatt_client_state = P_W2_SEND_SIGNED_WRITE;
1695             gatt_client_run();
1696             return;
1697         }
1698     }
1699 }
1700 
1701 uint8_t gatt_client_signed_write_without_response(btstack_packet_handler_t callback, hci_con_handle_t con_handle, uint16_t handle, uint16_t message_len, uint8_t * message){
1702     gatt_client_t * gatt_client = gatt_client_provide_context_for_handle(con_handle);
1703     if (gatt_client == NULL) return BTSTACK_MEMORY_ALLOC_FAILED;
1704     if (is_ready(gatt_client) == 0) return GATT_CLIENT_IN_WRONG_STATE;
1705 
1706     gatt_client->callback = callback;
1707     gatt_client->attribute_handle = handle;
1708     gatt_client->attribute_length = message_len;
1709     gatt_client->attribute_value = message;
1710     gatt_client->gatt_client_state = P_W4_IDENTITY_RESOLVING;
1711     gatt_client_run();
1712     return ERROR_CODE_SUCCESS;
1713 }
1714 #endif
1715 
1716 uint8_t gatt_client_discover_primary_services(btstack_packet_handler_t callback, hci_con_handle_t con_handle){
1717     gatt_client_t * gatt_client = gatt_client_provide_context_for_handle_and_start_timer(con_handle);
1718     if (gatt_client == NULL) return BTSTACK_MEMORY_ALLOC_FAILED;
1719     if (is_ready(gatt_client) == 0) return GATT_CLIENT_IN_WRONG_STATE;
1720 
1721     gatt_client->callback = callback;
1722     gatt_client->start_group_handle = 0x0001;
1723     gatt_client->end_group_handle   = 0xffff;
1724     gatt_client->gatt_client_state = P_W2_SEND_SERVICE_QUERY;
1725     gatt_client->uuid16 = 0;
1726     gatt_client_run();
1727     return ERROR_CODE_SUCCESS;
1728 }
1729 
1730 
1731 uint8_t gatt_client_discover_primary_services_by_uuid16(btstack_packet_handler_t callback, hci_con_handle_t con_handle, uint16_t uuid16){
1732     gatt_client_t * gatt_client = gatt_client_provide_context_for_handle_and_start_timer(con_handle);
1733     if (gatt_client == NULL) return BTSTACK_MEMORY_ALLOC_FAILED;
1734     if (is_ready(gatt_client) == 0) return GATT_CLIENT_IN_WRONG_STATE;
1735 
1736     gatt_client->callback = callback;
1737     gatt_client->start_group_handle = 0x0001;
1738     gatt_client->end_group_handle   = 0xffff;
1739     gatt_client->gatt_client_state = P_W2_SEND_SERVICE_WITH_UUID_QUERY;
1740     gatt_client->uuid16 = uuid16;
1741     uuid_add_bluetooth_prefix((uint8_t*) &(gatt_client->uuid128), gatt_client->uuid16);
1742     gatt_client_run();
1743     return ERROR_CODE_SUCCESS;
1744 }
1745 
1746 uint8_t gatt_client_discover_primary_services_by_uuid128(btstack_packet_handler_t callback, hci_con_handle_t con_handle, const uint8_t * uuid128){
1747     gatt_client_t * gatt_client = gatt_client_provide_context_for_handle_and_start_timer(con_handle);
1748     if (gatt_client == NULL) return BTSTACK_MEMORY_ALLOC_FAILED;
1749     if (is_ready(gatt_client) == 0) return GATT_CLIENT_IN_WRONG_STATE;
1750 
1751     gatt_client->callback = callback;
1752     gatt_client->start_group_handle = 0x0001;
1753     gatt_client->end_group_handle   = 0xffff;
1754     gatt_client->uuid16 = 0;
1755     (void)memcpy(gatt_client->uuid128, uuid128, 16);
1756     gatt_client->gatt_client_state = P_W2_SEND_SERVICE_WITH_UUID_QUERY;
1757     gatt_client_run();
1758     return ERROR_CODE_SUCCESS;
1759 }
1760 
1761 uint8_t gatt_client_discover_characteristics_for_service(btstack_packet_handler_t callback, hci_con_handle_t con_handle, gatt_client_service_t *service){
1762     gatt_client_t * gatt_client = gatt_client_provide_context_for_handle_and_start_timer(con_handle);
1763     if (gatt_client == NULL) return BTSTACK_MEMORY_ALLOC_FAILED;
1764     if (is_ready(gatt_client) == 0) return GATT_CLIENT_IN_WRONG_STATE;
1765 
1766     gatt_client->callback = callback;
1767     gatt_client->start_group_handle = service->start_group_handle;
1768     gatt_client->end_group_handle   = service->end_group_handle;
1769     gatt_client->filter_with_uuid = 0;
1770     gatt_client->characteristic_start_handle = 0;
1771     gatt_client->gatt_client_state = P_W2_SEND_ALL_CHARACTERISTICS_OF_SERVICE_QUERY;
1772     gatt_client_run();
1773     return ERROR_CODE_SUCCESS;
1774 }
1775 
1776 uint8_t gatt_client_find_included_services_for_service(btstack_packet_handler_t callback, hci_con_handle_t con_handle, gatt_client_service_t *service){
1777     gatt_client_t * gatt_client = gatt_client_provide_context_for_handle_and_start_timer(con_handle);
1778     if (gatt_client == NULL) return BTSTACK_MEMORY_ALLOC_FAILED;
1779     if (is_ready(gatt_client) == 0) return GATT_CLIENT_IN_WRONG_STATE;
1780     gatt_client->callback = callback;
1781     gatt_client->start_group_handle = service->start_group_handle;
1782     gatt_client->end_group_handle   = service->end_group_handle;
1783     gatt_client->gatt_client_state = P_W2_SEND_INCLUDED_SERVICE_QUERY;
1784 
1785     gatt_client_run();
1786     return ERROR_CODE_SUCCESS;
1787 }
1788 
1789 uint8_t gatt_client_discover_characteristics_for_handle_range_by_uuid16(btstack_packet_handler_t callback, hci_con_handle_t con_handle, uint16_t start_handle, uint16_t end_handle, uint16_t uuid16){
1790     gatt_client_t * gatt_client = gatt_client_provide_context_for_handle_and_start_timer(con_handle);
1791     if (gatt_client == NULL) return BTSTACK_MEMORY_ALLOC_FAILED;
1792     if (is_ready(gatt_client) == 0) return GATT_CLIENT_IN_WRONG_STATE;
1793 
1794     gatt_client->callback = callback;
1795     gatt_client->start_group_handle = start_handle;
1796     gatt_client->end_group_handle   = end_handle;
1797     gatt_client->filter_with_uuid = 1;
1798     gatt_client->uuid16 = uuid16;
1799     uuid_add_bluetooth_prefix((uint8_t*) &(gatt_client->uuid128), uuid16);
1800     gatt_client->characteristic_start_handle = 0;
1801     gatt_client->gatt_client_state = P_W2_SEND_CHARACTERISTIC_WITH_UUID_QUERY;
1802     gatt_client_run();
1803     return ERROR_CODE_SUCCESS;
1804 }
1805 
1806 uint8_t gatt_client_discover_characteristics_for_handle_range_by_uuid128(btstack_packet_handler_t callback, hci_con_handle_t con_handle, uint16_t start_handle, uint16_t end_handle, uint8_t * uuid128){
1807     gatt_client_t * gatt_client = gatt_client_provide_context_for_handle_and_start_timer(con_handle);
1808     if (gatt_client == NULL) return BTSTACK_MEMORY_ALLOC_FAILED;
1809     if (is_ready(gatt_client) == 0) return GATT_CLIENT_IN_WRONG_STATE;
1810 
1811     gatt_client->callback = callback;
1812     gatt_client->start_group_handle = start_handle;
1813     gatt_client->end_group_handle   = end_handle;
1814     gatt_client->filter_with_uuid = 1;
1815     gatt_client->uuid16 = 0;
1816     (void)memcpy(gatt_client->uuid128, uuid128, 16);
1817     gatt_client->characteristic_start_handle = 0;
1818     gatt_client->gatt_client_state = P_W2_SEND_CHARACTERISTIC_WITH_UUID_QUERY;
1819     gatt_client_run();
1820     return ERROR_CODE_SUCCESS;
1821 }
1822 
1823 
1824 uint8_t gatt_client_discover_characteristics_for_service_by_uuid16(btstack_packet_handler_t callback, uint16_t handle, gatt_client_service_t *service, uint16_t  uuid16){
1825     return gatt_client_discover_characteristics_for_handle_range_by_uuid16(callback, handle, service->start_group_handle, service->end_group_handle, uuid16);
1826 }
1827 
1828 uint8_t gatt_client_discover_characteristics_for_service_by_uuid128(btstack_packet_handler_t callback, uint16_t handle, gatt_client_service_t *service, uint8_t * uuid128){
1829     return gatt_client_discover_characteristics_for_handle_range_by_uuid128(callback, handle, service->start_group_handle, service->end_group_handle, uuid128);
1830 }
1831 
1832 uint8_t gatt_client_discover_characteristic_descriptors(btstack_packet_handler_t callback, hci_con_handle_t con_handle, gatt_client_characteristic_t *characteristic){
1833     gatt_client_t * gatt_client = gatt_client_provide_context_for_handle_and_start_timer(con_handle);
1834     if (gatt_client == NULL) return BTSTACK_MEMORY_ALLOC_FAILED;
1835     if (is_ready(gatt_client) == 0) return GATT_CLIENT_IN_WRONG_STATE;
1836 
1837     if (characteristic->value_handle == characteristic->end_handle){
1838         emit_gatt_complete_event(gatt_client, ATT_ERROR_SUCCESS);
1839         return ERROR_CODE_SUCCESS;
1840     }
1841     gatt_client->callback = callback;
1842     gatt_client->start_group_handle = characteristic->value_handle + 1u;
1843     gatt_client->end_group_handle   = characteristic->end_handle;
1844     gatt_client->gatt_client_state = P_W2_SEND_ALL_CHARACTERISTIC_DESCRIPTORS_QUERY;
1845     gatt_client_run();
1846     return ERROR_CODE_SUCCESS;
1847 }
1848 
1849 uint8_t gatt_client_read_value_of_characteristic_using_value_handle(btstack_packet_handler_t callback, hci_con_handle_t con_handle, uint16_t value_handle){
1850     gatt_client_t * gatt_client = gatt_client_provide_context_for_handle_and_start_timer(con_handle);
1851     if (gatt_client == NULL) return BTSTACK_MEMORY_ALLOC_FAILED;
1852     if (is_ready(gatt_client) == 0) return GATT_CLIENT_IN_WRONG_STATE;
1853 
1854     gatt_client->callback = callback;
1855     gatt_client->attribute_handle = value_handle;
1856     gatt_client->attribute_offset = 0;
1857     gatt_client->gatt_client_state = P_W2_SEND_READ_CHARACTERISTIC_VALUE_QUERY;
1858     gatt_client_run();
1859     return ERROR_CODE_SUCCESS;
1860 }
1861 
1862 uint8_t gatt_client_read_value_of_characteristics_by_uuid16(btstack_packet_handler_t callback, hci_con_handle_t con_handle, uint16_t start_handle, uint16_t end_handle, uint16_t uuid16){
1863     gatt_client_t * gatt_client = gatt_client_provide_context_for_handle_and_start_timer(con_handle);
1864     if (gatt_client == NULL) return BTSTACK_MEMORY_ALLOC_FAILED;
1865     if (is_ready(gatt_client) == 0) return GATT_CLIENT_IN_WRONG_STATE;
1866 
1867     gatt_client->callback = callback;
1868     gatt_client->start_group_handle = start_handle;
1869     gatt_client->end_group_handle = end_handle;
1870     gatt_client->query_start_handle = start_handle;
1871     gatt_client->query_end_handle = end_handle;
1872     gatt_client->uuid16 = uuid16;
1873     uuid_add_bluetooth_prefix((uint8_t*) &(gatt_client->uuid128), uuid16);
1874     gatt_client->gatt_client_state = P_W2_SEND_READ_BY_TYPE_REQUEST;
1875     gatt_client_run();
1876     return ERROR_CODE_SUCCESS;
1877 }
1878 
1879 uint8_t gatt_client_read_value_of_characteristics_by_uuid128(btstack_packet_handler_t callback, hci_con_handle_t con_handle, uint16_t start_handle, uint16_t end_handle, uint8_t * uuid128){
1880     gatt_client_t * gatt_client = gatt_client_provide_context_for_handle_and_start_timer(con_handle);
1881     if (gatt_client == NULL) return BTSTACK_MEMORY_ALLOC_FAILED;
1882     if (is_ready(gatt_client) == 0) return GATT_CLIENT_IN_WRONG_STATE;
1883 
1884     gatt_client->callback = callback;
1885     gatt_client->start_group_handle = start_handle;
1886     gatt_client->end_group_handle = end_handle;
1887     gatt_client->query_start_handle = start_handle;
1888     gatt_client->query_end_handle = end_handle;
1889     gatt_client->uuid16 = 0;
1890     (void)memcpy(gatt_client->uuid128, uuid128, 16);
1891     gatt_client->gatt_client_state = P_W2_SEND_READ_BY_TYPE_REQUEST;
1892     gatt_client_run();
1893     return ERROR_CODE_SUCCESS;
1894 }
1895 
1896 
1897 uint8_t gatt_client_read_value_of_characteristic(btstack_packet_handler_t callback, uint16_t handle, gatt_client_characteristic_t *characteristic){
1898     return gatt_client_read_value_of_characteristic_using_value_handle(callback, handle, characteristic->value_handle);
1899 }
1900 
1901 uint8_t gatt_client_read_long_value_of_characteristic_using_value_handle_with_offset(btstack_packet_handler_t callback, hci_con_handle_t con_handle, uint16_t characteristic_value_handle, uint16_t offset){
1902     gatt_client_t * gatt_client = gatt_client_provide_context_for_handle_and_start_timer(con_handle);
1903     if (gatt_client == NULL) return BTSTACK_MEMORY_ALLOC_FAILED;
1904     if (is_ready(gatt_client) == 0) return GATT_CLIENT_IN_WRONG_STATE;
1905 
1906     gatt_client->callback = callback;
1907     gatt_client->attribute_handle = characteristic_value_handle;
1908     gatt_client->attribute_offset = offset;
1909     gatt_client->gatt_client_state = P_W2_SEND_READ_BLOB_QUERY;
1910     gatt_client_run();
1911     return ERROR_CODE_SUCCESS;
1912 }
1913 
1914 uint8_t gatt_client_read_long_value_of_characteristic_using_value_handle(btstack_packet_handler_t callback, hci_con_handle_t con_handle, uint16_t characteristic_value_handle){
1915     return gatt_client_read_long_value_of_characteristic_using_value_handle_with_offset(callback, con_handle, characteristic_value_handle, 0);
1916 }
1917 
1918 uint8_t gatt_client_read_long_value_of_characteristic(btstack_packet_handler_t callback, uint16_t handle, gatt_client_characteristic_t *characteristic){
1919     return gatt_client_read_long_value_of_characteristic_using_value_handle(callback, handle, characteristic->value_handle);
1920 }
1921 
1922 uint8_t gatt_client_read_multiple_characteristic_values(btstack_packet_handler_t callback, hci_con_handle_t con_handle, int num_value_handles, uint16_t * value_handles){
1923     gatt_client_t * gatt_client = gatt_client_provide_context_for_handle_and_start_timer(con_handle);
1924     if (gatt_client == NULL) return BTSTACK_MEMORY_ALLOC_FAILED;
1925     if (is_ready(gatt_client) == 0) return GATT_CLIENT_IN_WRONG_STATE;
1926 
1927     gatt_client->callback = callback;
1928     gatt_client->read_multiple_handle_count = num_value_handles;
1929     gatt_client->read_multiple_handles = value_handles;
1930     gatt_client->gatt_client_state = P_W2_SEND_READ_MULTIPLE_REQUEST;
1931     gatt_client_run();
1932     return ERROR_CODE_SUCCESS;
1933 }
1934 
1935 uint8_t gatt_client_write_value_of_characteristic_without_response(hci_con_handle_t con_handle, uint16_t value_handle, uint16_t value_length, uint8_t * value){
1936     gatt_client_t * gatt_client = gatt_client_provide_context_for_handle(con_handle);
1937     if (gatt_client == NULL) return BTSTACK_MEMORY_ALLOC_FAILED;
1938 
1939     if (value_length > (gatt_client->mtu - 3u)) return GATT_CLIENT_VALUE_TOO_LONG;
1940     if (!att_dispatch_client_can_send_now(gatt_client->con_handle)) return GATT_CLIENT_BUSY;
1941 
1942     return att_write_request(ATT_WRITE_COMMAND, gatt_client->con_handle, value_handle, value_length, value);
1943 }
1944 
1945 uint8_t gatt_client_write_value_of_characteristic(btstack_packet_handler_t callback, hci_con_handle_t con_handle, uint16_t value_handle, uint16_t value_length, uint8_t * data){
1946     gatt_client_t * gatt_client = gatt_client_provide_context_for_handle_and_start_timer(con_handle);
1947     if (gatt_client == NULL) return BTSTACK_MEMORY_ALLOC_FAILED;
1948     if (is_ready(gatt_client) == 0) return GATT_CLIENT_IN_WRONG_STATE;
1949 
1950     gatt_client->callback = callback;
1951     gatt_client->attribute_handle = value_handle;
1952     gatt_client->attribute_length = value_length;
1953     gatt_client->attribute_value = data;
1954     gatt_client->gatt_client_state = P_W2_SEND_WRITE_CHARACTERISTIC_VALUE;
1955     gatt_client_run();
1956     return ERROR_CODE_SUCCESS;
1957 }
1958 
1959 uint8_t gatt_client_write_long_value_of_characteristic_with_offset(btstack_packet_handler_t callback, hci_con_handle_t con_handle, uint16_t value_handle, uint16_t offset, uint16_t value_length, uint8_t  * data){
1960     gatt_client_t * gatt_client = gatt_client_provide_context_for_handle_and_start_timer(con_handle);
1961     if (gatt_client == NULL) return BTSTACK_MEMORY_ALLOC_FAILED;
1962     if (is_ready(gatt_client) == 0) return GATT_CLIENT_IN_WRONG_STATE;
1963 
1964     gatt_client->callback = callback;
1965     gatt_client->attribute_handle = value_handle;
1966     gatt_client->attribute_length = value_length;
1967     gatt_client->attribute_offset = offset;
1968     gatt_client->attribute_value = data;
1969     gatt_client->gatt_client_state = P_W2_PREPARE_WRITE;
1970     gatt_client_run();
1971     return ERROR_CODE_SUCCESS;
1972 }
1973 
1974 uint8_t gatt_client_write_long_value_of_characteristic(btstack_packet_handler_t callback, hci_con_handle_t con_handle, uint16_t value_handle, uint16_t value_length, uint8_t * value){
1975     return gatt_client_write_long_value_of_characteristic_with_offset(callback, con_handle, value_handle, 0, value_length, value);
1976 }
1977 
1978 uint8_t gatt_client_reliable_write_long_value_of_characteristic(btstack_packet_handler_t callback, hci_con_handle_t con_handle, uint16_t value_handle, uint16_t value_length, uint8_t * value){
1979     gatt_client_t * gatt_client = gatt_client_provide_context_for_handle_and_start_timer(con_handle);
1980     if (gatt_client == NULL) return BTSTACK_MEMORY_ALLOC_FAILED;
1981     if (is_ready(gatt_client) == 0) return GATT_CLIENT_IN_WRONG_STATE;
1982 
1983     gatt_client->callback = callback;
1984     gatt_client->attribute_handle = value_handle;
1985     gatt_client->attribute_length = value_length;
1986     gatt_client->attribute_offset = 0;
1987     gatt_client->attribute_value = value;
1988     gatt_client->gatt_client_state = P_W2_PREPARE_RELIABLE_WRITE;
1989     gatt_client_run();
1990     return ERROR_CODE_SUCCESS;
1991 }
1992 
1993 uint8_t gatt_client_write_client_characteristic_configuration(btstack_packet_handler_t callback, hci_con_handle_t con_handle, gatt_client_characteristic_t * characteristic, uint16_t configuration){
1994     gatt_client_t * gatt_client = gatt_client_provide_context_for_handle_and_start_timer(con_handle);
1995     if (gatt_client == NULL) return BTSTACK_MEMORY_ALLOC_FAILED;
1996     if (is_ready(gatt_client) == 0) return GATT_CLIENT_IN_WRONG_STATE;
1997 
1998     if ( (configuration & GATT_CLIENT_CHARACTERISTICS_CONFIGURATION_NOTIFICATION) &&
1999         ((characteristic->properties & ATT_PROPERTY_NOTIFY) == 0u)) {
2000         log_info("gatt_client_write_client_characteristic_configuration: GATT_CLIENT_CHARACTERISTIC_NOTIFICATION_NOT_SUPPORTED");
2001         return GATT_CLIENT_CHARACTERISTIC_NOTIFICATION_NOT_SUPPORTED;
2002     } else if ( (configuration & GATT_CLIENT_CHARACTERISTICS_CONFIGURATION_INDICATION) &&
2003                ((characteristic->properties & ATT_PROPERTY_INDICATE) == 0u)){
2004         log_info("gatt_client_write_client_characteristic_configuration: GATT_CLIENT_CHARACTERISTIC_INDICATION_NOT_SUPPORTED");
2005         return GATT_CLIENT_CHARACTERISTIC_INDICATION_NOT_SUPPORTED;
2006     }
2007 
2008     gatt_client->callback = callback;
2009     gatt_client->start_group_handle = characteristic->value_handle;
2010     gatt_client->end_group_handle = characteristic->end_handle;
2011     little_endian_store_16(gatt_client->client_characteristic_configuration_value, 0, configuration);
2012 
2013 #ifdef ENABLE_GATT_FIND_INFORMATION_FOR_CCC_DISCOVERY
2014     gatt_client->gatt_client_state = P_W2_SEND_FIND_CLIENT_CHARACTERISTIC_CONFIGURATION_QUERY;
2015 #else
2016     gatt_client->gatt_client_state = P_W2_SEND_READ_CLIENT_CHARACTERISTIC_CONFIGURATION_QUERY;
2017 #endif
2018     gatt_client_run();
2019     return ERROR_CODE_SUCCESS;
2020 }
2021 
2022 uint8_t gatt_client_read_characteristic_descriptor_using_descriptor_handle(btstack_packet_handler_t callback, hci_con_handle_t con_handle, uint16_t descriptor_handle){
2023     gatt_client_t * gatt_client = gatt_client_provide_context_for_handle_and_start_timer(con_handle);
2024     if (gatt_client == NULL) return BTSTACK_MEMORY_ALLOC_FAILED;
2025     if (is_ready(gatt_client) == 0) return GATT_CLIENT_IN_WRONG_STATE;
2026 
2027     gatt_client->callback = callback;
2028     gatt_client->attribute_handle = descriptor_handle;
2029 
2030     gatt_client->gatt_client_state = P_W2_SEND_READ_CHARACTERISTIC_DESCRIPTOR_QUERY;
2031     gatt_client_run();
2032     return ERROR_CODE_SUCCESS;
2033 }
2034 
2035 uint8_t gatt_client_read_characteristic_descriptor(btstack_packet_handler_t callback, hci_con_handle_t con_handle, gatt_client_characteristic_descriptor_t * descriptor){
2036     return gatt_client_read_characteristic_descriptor_using_descriptor_handle(callback, con_handle, descriptor->handle);
2037 }
2038 
2039 uint8_t gatt_client_read_long_characteristic_descriptor_using_descriptor_handle_with_offset(btstack_packet_handler_t callback, hci_con_handle_t con_handle, uint16_t descriptor_handle, uint16_t offset){
2040     gatt_client_t * gatt_client = gatt_client_provide_context_for_handle_and_start_timer(con_handle);
2041     if (gatt_client == NULL) return BTSTACK_MEMORY_ALLOC_FAILED;
2042     if (is_ready(gatt_client) == 0) return GATT_CLIENT_IN_WRONG_STATE;
2043 
2044     gatt_client->callback = callback;
2045     gatt_client->attribute_handle = descriptor_handle;
2046     gatt_client->attribute_offset = offset;
2047     gatt_client->gatt_client_state = P_W2_SEND_READ_BLOB_CHARACTERISTIC_DESCRIPTOR_QUERY;
2048     gatt_client_run();
2049     return ERROR_CODE_SUCCESS;
2050 }
2051 
2052 uint8_t gatt_client_read_long_characteristic_descriptor_using_descriptor_handle(btstack_packet_handler_t callback, hci_con_handle_t con_handle, uint16_t descriptor_handle){
2053     return gatt_client_read_long_characteristic_descriptor_using_descriptor_handle_with_offset(callback, con_handle, descriptor_handle, 0);
2054 }
2055 
2056 uint8_t gatt_client_read_long_characteristic_descriptor(btstack_packet_handler_t callback, hci_con_handle_t con_handle, gatt_client_characteristic_descriptor_t * descriptor){
2057     return gatt_client_read_long_characteristic_descriptor_using_descriptor_handle(callback, con_handle, descriptor->handle);
2058 }
2059 
2060 uint8_t gatt_client_write_characteristic_descriptor_using_descriptor_handle(btstack_packet_handler_t callback, hci_con_handle_t con_handle, uint16_t descriptor_handle, uint16_t length, uint8_t  * data){
2061     gatt_client_t * gatt_client = gatt_client_provide_context_for_handle_and_start_timer(con_handle);
2062     if (gatt_client == NULL) return BTSTACK_MEMORY_ALLOC_FAILED;
2063     if (is_ready(gatt_client) == 0) return GATT_CLIENT_IN_WRONG_STATE;
2064 
2065     gatt_client->callback = callback;
2066     gatt_client->attribute_handle = descriptor_handle;
2067     gatt_client->attribute_length = length;
2068     gatt_client->attribute_offset = 0;
2069     gatt_client->attribute_value = data;
2070     gatt_client->gatt_client_state = P_W2_SEND_WRITE_CHARACTERISTIC_DESCRIPTOR;
2071     gatt_client_run();
2072     return ERROR_CODE_SUCCESS;
2073 }
2074 
2075 uint8_t gatt_client_write_characteristic_descriptor(btstack_packet_handler_t callback, hci_con_handle_t con_handle, gatt_client_characteristic_descriptor_t * descriptor, uint16_t length, uint8_t * value){
2076     return gatt_client_write_characteristic_descriptor_using_descriptor_handle(callback, con_handle, descriptor->handle, length, value);
2077 }
2078 
2079 uint8_t gatt_client_write_long_characteristic_descriptor_using_descriptor_handle_with_offset(btstack_packet_handler_t callback, hci_con_handle_t con_handle, uint16_t descriptor_handle, uint16_t offset, uint16_t length, uint8_t  * data){
2080     gatt_client_t * gatt_client = gatt_client_provide_context_for_handle_and_start_timer(con_handle);
2081     if (gatt_client == NULL) return BTSTACK_MEMORY_ALLOC_FAILED;
2082     if (is_ready(gatt_client) == 0) return GATT_CLIENT_IN_WRONG_STATE;
2083 
2084     gatt_client->callback = callback;
2085     gatt_client->attribute_handle = descriptor_handle;
2086     gatt_client->attribute_length = length;
2087     gatt_client->attribute_offset = offset;
2088     gatt_client->attribute_value = data;
2089     gatt_client->gatt_client_state = P_W2_PREPARE_WRITE_CHARACTERISTIC_DESCRIPTOR;
2090     gatt_client_run();
2091     return ERROR_CODE_SUCCESS;
2092 }
2093 
2094 uint8_t gatt_client_write_long_characteristic_descriptor_using_descriptor_handle(btstack_packet_handler_t callback, hci_con_handle_t con_handle, uint16_t descriptor_handle, uint16_t length, uint8_t * data){
2095     return gatt_client_write_long_characteristic_descriptor_using_descriptor_handle_with_offset(callback, con_handle, descriptor_handle, 0, length, data );
2096 }
2097 
2098 uint8_t gatt_client_write_long_characteristic_descriptor(btstack_packet_handler_t callback, hci_con_handle_t con_handle, gatt_client_characteristic_descriptor_t * descriptor, uint16_t length, uint8_t * value){
2099     return gatt_client_write_long_characteristic_descriptor_using_descriptor_handle(callback, con_handle, descriptor->handle, length, value);
2100 }
2101 
2102 /**
2103  * @brief -> gatt complete event
2104  */
2105 uint8_t gatt_client_prepare_write(btstack_packet_handler_t callback, hci_con_handle_t con_handle, uint16_t attribute_handle, uint16_t offset, uint16_t length, uint8_t * data){
2106     gatt_client_t * gatt_client = gatt_client_provide_context_for_handle_and_start_timer(con_handle);
2107     if (gatt_client == NULL) return BTSTACK_MEMORY_ALLOC_FAILED;
2108     if (is_ready(gatt_client) == 0) return GATT_CLIENT_IN_WRONG_STATE;
2109 
2110     gatt_client->callback = callback;
2111     gatt_client->attribute_handle = attribute_handle;
2112     gatt_client->attribute_length = length;
2113     gatt_client->attribute_offset = offset;
2114     gatt_client->attribute_value = data;
2115     gatt_client->gatt_client_state = P_W2_PREPARE_WRITE_SINGLE;
2116     gatt_client_run();
2117     return ERROR_CODE_SUCCESS;
2118 }
2119 
2120 /**
2121  * @brief -> gatt complete event
2122  */
2123 uint8_t gatt_client_execute_write(btstack_packet_handler_t callback, hci_con_handle_t con_handle){
2124     gatt_client_t * gatt_client = gatt_client_provide_context_for_handle_and_start_timer(con_handle);
2125 
2126     if (gatt_client == NULL) return BTSTACK_MEMORY_ALLOC_FAILED;
2127     if (is_ready(gatt_client) == 0) return GATT_CLIENT_IN_WRONG_STATE;
2128 
2129     gatt_client->callback = callback;
2130     gatt_client->gatt_client_state = P_W2_EXECUTE_PREPARED_WRITE;
2131     gatt_client_run();
2132     return ERROR_CODE_SUCCESS;
2133 }
2134 
2135 /**
2136  * @brief -> gatt complete event
2137  */
2138 uint8_t gatt_client_cancel_write(btstack_packet_handler_t callback, hci_con_handle_t con_handle){
2139     gatt_client_t * gatt_client = gatt_client_provide_context_for_handle_and_start_timer(con_handle);
2140     if (gatt_client == NULL) return BTSTACK_MEMORY_ALLOC_FAILED;
2141     if (is_ready(gatt_client) == 0) return GATT_CLIENT_IN_WRONG_STATE;
2142 
2143     gatt_client->callback = callback;
2144     gatt_client->gatt_client_state = P_W2_CANCEL_PREPARED_WRITE;
2145     gatt_client_run();
2146     return ERROR_CODE_SUCCESS;
2147 }
2148 
2149 void gatt_client_deserialize_service(const uint8_t *packet, int offset, gatt_client_service_t *service){
2150     service->start_group_handle = little_endian_read_16(packet, offset);
2151     service->end_group_handle = little_endian_read_16(packet, offset + 2);
2152     reverse_128(&packet[offset + 4], service->uuid128);
2153     if (uuid_has_bluetooth_prefix(service->uuid128)){
2154         service->uuid16 = big_endian_read_32(service->uuid128, 0);
2155     } else {
2156         service->uuid16 = 0;
2157     }
2158 }
2159 
2160 void gatt_client_deserialize_characteristic(const uint8_t * packet, int offset, gatt_client_characteristic_t * characteristic){
2161     characteristic->start_handle = little_endian_read_16(packet, offset);
2162     characteristic->value_handle = little_endian_read_16(packet, offset + 2);
2163     characteristic->end_handle = little_endian_read_16(packet, offset + 4);
2164     characteristic->properties = little_endian_read_16(packet, offset + 6);
2165     reverse_128(&packet[offset+8], characteristic->uuid128);
2166     if (uuid_has_bluetooth_prefix(characteristic->uuid128)){
2167         characteristic->uuid16 = big_endian_read_32(characteristic->uuid128, 0);
2168     } else {
2169         characteristic->uuid16 = 0;
2170     }
2171 }
2172 
2173 void gatt_client_deserialize_characteristic_descriptor(const uint8_t * packet, int offset, gatt_client_characteristic_descriptor_t * descriptor){
2174     descriptor->handle = little_endian_read_16(packet, offset);
2175     reverse_128(&packet[offset+2], descriptor->uuid128);
2176     if (uuid_has_bluetooth_prefix(descriptor->uuid128)){
2177         descriptor->uuid16 = big_endian_read_32(descriptor->uuid128, 0);
2178     } else {
2179         descriptor->uuid16 = 0;
2180     }
2181 }
2182 
2183 void gatt_client_send_mtu_negotiation(btstack_packet_handler_t callback, hci_con_handle_t con_handle){
2184     gatt_client_t * context = gatt_client_provide_context_for_handle(con_handle);
2185     if (context == NULL) return;
2186     if (context->mtu_state == MTU_AUTO_EXCHANGE_DISABLED){
2187         context->callback = callback;
2188         context->mtu_state = SEND_MTU_EXCHANGE;
2189         gatt_client_run();
2190     }
2191 }
2192 
2193 uint8_t gatt_client_request_can_write_without_response_event(btstack_packet_handler_t callback, hci_con_handle_t con_handle){
2194     gatt_client_t * context = gatt_client_provide_context_for_handle(con_handle);
2195     if (context == NULL) return BTSTACK_MEMORY_ALLOC_FAILED;
2196     if (context->write_without_response_callback != NULL) return GATT_CLIENT_IN_WRONG_STATE;
2197     context->write_without_response_callback = callback;
2198     att_dispatch_client_request_can_send_now_event(context->con_handle);
2199     return ERROR_CODE_SUCCESS;
2200 }
2201 
2202 #ifdef FUZZING_BUILD_MODE_UNSAFE_FOR_PRODUCTION
2203 void gatt_client_att_packet_handler_fuzz(uint8_t packet_type, uint16_t handle, uint8_t *packet, uint16_t size){
2204     gatt_client_att_packet_handler(packet_type, handle, packet, size);
2205 }
2206 #endif
2207