1 /* 2 * Copyright (C) 2014 BlueKitchen GmbH 3 * 4 * Redistribution and use in source and binary forms, with or without 5 * modification, are permitted provided that the following conditions 6 * are met: 7 * 8 * 1. Redistributions of source code must retain the above copyright 9 * notice, this list of conditions and the following disclaimer. 10 * 2. Redistributions in binary form must reproduce the above copyright 11 * notice, this list of conditions and the following disclaimer in the 12 * documentation and/or other materials provided with the distribution. 13 * 3. Neither the name of the copyright holders nor the names of 14 * contributors may be used to endorse or promote products derived 15 * from this software without specific prior written permission. 16 * 4. Any redistribution, use, or modification is done solely for 17 * personal benefit and not for any commercial purpose or for 18 * monetary gain. 19 * 20 * THIS SOFTWARE IS PROVIDED BY BLUEKITCHEN GMBH AND CONTRIBUTORS 21 * ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT 22 * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS 23 * FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL BLUEKITCHEN 24 * GMBH OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, 25 * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, 26 * BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS 27 * OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED 28 * AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, 29 * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF 30 * THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 31 * SUCH DAMAGE. 32 * 33 * Please inquire about commercial licensing options at 34 * [email protected] 35 * 36 */ 37 38 #define BTSTACK_FILE__ "ancs_client.c" 39 40 #include "btstack_config.h" 41 42 #include <stdint.h> 43 #include <string.h> 44 45 #include "ble/gatt-service/ancs_client.h" 46 47 #include "ble/core.h" 48 #include "ble/gatt_client.h" 49 #include "ble/sm.h" 50 #include "btstack_debug.h" 51 #include "btstack_event.h" 52 #include "gap.h" 53 54 // ancs_client.h Start 55 typedef enum ancs_chunk_parser_state { 56 W4_ATTRIBUTE_ID, 57 W4_ATTRIBUTE_LEN, 58 W4_ATTRIBUTE_COMPLETE, 59 } ancs_chunk_parser_state_t; 60 61 typedef enum { 62 TC_IDLE, 63 TC_W4_ENCRYPTED_CONNECTION, 64 TC_W2_QUERY_SERVICE, 65 TC_W4_SERVICE_RESULT, 66 TC_W2_QUERY_CARACTERISTIC, 67 TC_W4_CHARACTERISTIC_RESULT, 68 TC_W2_SUBSCRIBE_DATA_SOURCE, 69 TC_W4_DATA_SOURCE_SUBSCRIBED, 70 TC_W2_ENABLE_NOTIFICATION, 71 TC_W4_NOTIFICATION_SOURCE_SUBSCRIBED, 72 TC_SUBSCRIBED, 73 TC_W4_DISCONNECT 74 } tc_state_t; 75 76 static uint32_t ancs_notification_uid; 77 static hci_con_handle_t gc_handle; 78 static gatt_client_notification_t ancs_notification_source_notification; 79 static gatt_client_notification_t ancs_data_source_notification; 80 static int ancs_service_found; 81 static gatt_client_service_t ancs_service; 82 static gatt_client_characteristic_t ancs_notification_source_characteristic; 83 static gatt_client_characteristic_t ancs_control_point_characteristic; 84 static gatt_client_characteristic_t ancs_data_source_characteristic; 85 static int ancs_characteristcs; 86 static tc_state_t tc_state = TC_IDLE; 87 88 static ancs_chunk_parser_state_t chunk_parser_state; 89 static uint8_t ancs_notification_buffer[50]; 90 static uint16_t ancs_bytes_received; 91 static uint16_t ancs_bytes_needed; 92 static uint8_t ancs_attribute_id; 93 static uint16_t ancs_attribute_len; 94 95 static btstack_packet_handler_t client_handler; 96 static btstack_packet_callback_registration_t hci_event_callback_registration; 97 static btstack_context_callback_registration_t ancs_client_handle_can_send_now; 98 99 static void ancs_client_handle_gatt_client_event(uint8_t packet_type, uint16_t channel, uint8_t *packet, uint16_t size); 100 101 void ancs_client_register_callback(btstack_packet_handler_t handler){ 102 client_handler = handler; 103 } 104 105 static uint8_t ancs_client_request_send_gatt_query(void){ 106 uint8_t status = gatt_client_request_to_send_gatt_query(&ancs_client_handle_can_send_now, gc_handle); 107 if (status != ERROR_CODE_SUCCESS){ 108 tc_state = TC_IDLE; 109 gc_handle = HCI_CON_HANDLE_INVALID; 110 } 111 return status; 112 } 113 114 static void notify_client_text(int event_type){ 115 if (!client_handler) return; 116 uint8_t event[7 + sizeof(ancs_notification_buffer) + 1]; 117 event[0] = HCI_EVENT_ANCS_META; 118 event[1] = 5u + ancs_attribute_len; 119 event[2] = event_type; 120 little_endian_store_16(event, 3, gc_handle); 121 little_endian_store_16(event, 5, ancs_attribute_id); 122 (void)memcpy(&event[7], ancs_notification_buffer, ancs_attribute_len); 123 // we're nice 124 event[7u+ancs_attribute_len] = 0u; 125 (*client_handler)(HCI_EVENT_PACKET, 0u, event, event[1u] + 2u); 126 } 127 128 static void notify_client_simple(int event_type){ 129 if (!client_handler) return; 130 uint8_t event[5]; 131 event[0] = HCI_EVENT_ANCS_META; 132 event[1] = 3; 133 event[2] = event_type; 134 little_endian_store_16(event, 3, gc_handle); 135 (*client_handler)(HCI_EVENT_PACKET, 0, event, sizeof(event)); 136 } 137 138 static void ancs_chunk_parser_init(void){ 139 // skip comand id and notification uid 140 chunk_parser_state = W4_ATTRIBUTE_ID; 141 ancs_bytes_received = 0; 142 ancs_bytes_needed = 6; 143 } 144 145 const char * ancs_client_attribute_name_for_id(int id){ 146 static const char * ancs_attribute_names[] = { 147 "AppIdentifier", 148 "IDTitle", 149 "IDSubtitle", 150 "IDMessage", 151 "IDMessageSize", 152 "IDDate" 153 }; 154 155 static const uint16_t ANCS_ATTRIBUTE_NAMES_COUNT = sizeof(ancs_attribute_names) / sizeof(char *); 156 157 if (id >= ANCS_ATTRIBUTE_NAMES_COUNT) return NULL; 158 return ancs_attribute_names[id]; 159 } 160 161 static void ancs_chunk_parser_handle_byte(uint8_t data){ 162 ancs_notification_buffer[ancs_bytes_received++] = data; 163 if (ancs_bytes_received < ancs_bytes_needed) return; 164 switch (chunk_parser_state){ 165 case W4_ATTRIBUTE_ID: 166 ancs_attribute_id = ancs_notification_buffer[ancs_bytes_received-1u]; 167 ancs_bytes_received = 0; 168 ancs_bytes_needed = 2; 169 chunk_parser_state = W4_ATTRIBUTE_LEN; 170 break; 171 case W4_ATTRIBUTE_LEN: 172 ancs_attribute_len = little_endian_read_16(ancs_notification_buffer, ancs_bytes_received-2u); 173 ancs_bytes_received = 0; 174 ancs_bytes_needed = ancs_attribute_len; 175 if (ancs_attribute_len == 0u) { 176 ancs_bytes_needed = 1; 177 chunk_parser_state = W4_ATTRIBUTE_ID; 178 break; 179 } 180 chunk_parser_state = W4_ATTRIBUTE_COMPLETE; 181 break; 182 case W4_ATTRIBUTE_COMPLETE: 183 ancs_notification_buffer[ancs_bytes_received] = 0; 184 notify_client_text(ANCS_SUBEVENT_CLIENT_NOTIFICATION); 185 ancs_bytes_received = 0; 186 ancs_bytes_needed = 1; 187 chunk_parser_state = W4_ATTRIBUTE_ID; 188 break; 189 default: 190 btstack_unreachable(); 191 break; 192 } 193 } 194 195 static void ancs_client_handle_notification(uint8_t * packet, uint16_t size){ 196 UNUSED(size); 197 198 uint16_t value_handle = little_endian_read_16(packet, 4); 199 uint16_t value_length = little_endian_read_16(packet, 6); 200 uint8_t * value = &packet[8]; 201 202 log_info("ANCS Notification, value handle %u", value_handle); 203 204 if (value_handle == ancs_data_source_characteristic.value_handle){ 205 int i; 206 for (i=0;i<value_length;i++) { 207 ancs_chunk_parser_handle_byte(value[i]); 208 } 209 } else if (value_handle == ancs_notification_source_characteristic.value_handle){ 210 ancs_notification_uid = little_endian_read_32(value, 4); 211 log_info("Notification received: EventID %02x, EventFlags %02x, CategoryID %02x, CategoryCount %u, UID %04x", 212 value[0], value[1], value[2], value[3], (int) ancs_notification_uid); 213 static uint8_t get_notification_attributes[] = {0, 0,0,0,0, 0, 1,32,0, 2,32,0, 3,32,0, 4, 5}; 214 little_endian_store_32(get_notification_attributes, 1, ancs_notification_uid); 215 ancs_notification_uid = 0; 216 ancs_chunk_parser_init(); 217 gatt_client_write_value_of_characteristic(ancs_client_handle_gatt_client_event, gc_handle, ancs_control_point_characteristic.value_handle, 218 sizeof(get_notification_attributes), get_notification_attributes); 219 } else { 220 log_info("Unknown Source: "); 221 log_info_hexdump(value , value_length); 222 } 223 } 224 225 static void ancs_client_send_next_query(void * context){ 226 UNUSED(context); 227 static const uint8_t ancs_service_uuid[] = {0x79,0x05,0xF4,0x31,0xB5,0xCE,0x4E,0x99,0xA4,0x0F,0x4B,0x1E,0x12,0x2D,0x00,0xD0}; 228 229 switch(tc_state){ 230 case TC_W2_QUERY_SERVICE: 231 tc_state = TC_W4_SERVICE_RESULT; 232 (void) gatt_client_discover_primary_services_by_uuid128(ancs_client_handle_gatt_client_event, gc_handle, ancs_service_uuid); 233 break; 234 235 case TC_W2_QUERY_CARACTERISTIC: 236 tc_state = TC_W4_CHARACTERISTIC_RESULT; 237 log_info("ANCS Client - Discover characteristics for ANCS SERVICE "); 238 gatt_client_discover_characteristics_for_service(ancs_client_handle_gatt_client_event, gc_handle, &ancs_service); 239 break; 240 241 case TC_W2_ENABLE_NOTIFICATION: 242 tc_state = TC_W4_NOTIFICATION_SOURCE_SUBSCRIBED; 243 gatt_client_listen_for_characteristic_value_updates(&ancs_notification_source_notification, &ancs_client_handle_gatt_client_event, gc_handle, &ancs_notification_source_characteristic); 244 gatt_client_write_client_characteristic_configuration(ancs_client_handle_gatt_client_event, gc_handle, &ancs_notification_source_characteristic, 245 GATT_CLIENT_CHARACTERISTICS_CONFIGURATION_NOTIFICATION); 246 break; 247 248 case TC_W2_SUBSCRIBE_DATA_SOURCE: 249 tc_state = TC_W4_DATA_SOURCE_SUBSCRIBED; 250 gatt_client_listen_for_characteristic_value_updates(&ancs_data_source_notification, &ancs_client_handle_gatt_client_event, gc_handle, &ancs_data_source_characteristic); 251 gatt_client_write_client_characteristic_configuration(ancs_client_handle_gatt_client_event, gc_handle, &ancs_data_source_characteristic, 252 GATT_CLIENT_CHARACTERISTICS_CONFIGURATION_NOTIFICATION); 253 break; 254 255 default: 256 break; 257 } 258 } 259 260 261 static void ancs_client_handle_gatt_client_event(uint8_t packet_type, uint16_t channel, uint8_t *packet, uint16_t size){ 262 263 UNUSED(packet_type); 264 UNUSED(channel); 265 266 static const uint8_t ancs_notification_source_uuid[] = {0x9F,0xBF,0x12,0x0D,0x63,0x01,0x42,0xD9,0x8C,0x58,0x25,0xE6,0x99,0xA2,0x1D,0xBD}; 267 static const uint8_t ancs_control_point_uuid[] = {0x69,0xD1,0xD8,0xF3,0x45,0xE1,0x49,0xA8,0x98,0x21,0x9B,0xBD,0xFD,0xAA,0xD9,0xD9}; 268 static const uint8_t ancs_data_source_uuid[] = {0x22,0xEA,0xC6,0xE9,0x24,0xD6,0x4B,0xB5,0xBE,0x44,0xB3,0x6A,0xCE,0x7C,0x7B,0xFB}; 269 270 gatt_client_characteristic_t characteristic; 271 272 switch(tc_state){ 273 case TC_W4_SERVICE_RESULT: 274 switch(hci_event_packet_get_type(packet)){ 275 case GATT_EVENT_SERVICE_QUERY_RESULT: 276 gatt_event_service_query_result_get_service(packet, &ancs_service); 277 ancs_service_found = 1; 278 break; 279 case GATT_EVENT_QUERY_COMPLETE: 280 if (!ancs_service_found){ 281 log_info("ANCS Service not found"); 282 tc_state = TC_IDLE; 283 break; 284 } 285 tc_state = TC_W2_QUERY_CARACTERISTIC; 286 break; 287 default: 288 break; 289 } 290 break; 291 292 case TC_W4_CHARACTERISTIC_RESULT: 293 switch(hci_event_packet_get_type(packet)){ 294 case GATT_EVENT_CHARACTERISTIC_QUERY_RESULT: 295 gatt_event_characteristic_query_result_get_characteristic(packet, &characteristic); 296 if (memcmp(characteristic.uuid128, ancs_notification_source_uuid, 16) == 0){ 297 log_info("ANCS Notification Source found, attribute handle %u", characteristic.value_handle); 298 ancs_notification_source_characteristic = characteristic; 299 ancs_characteristcs++; 300 break; 301 } 302 if (memcmp(characteristic.uuid128, ancs_control_point_uuid, 16) == 0){ 303 log_info("ANCS Control Point found, attribute handle %u", characteristic.value_handle); 304 ancs_control_point_characteristic = characteristic; 305 ancs_characteristcs++; 306 break; 307 } 308 if (memcmp(characteristic.uuid128, ancs_data_source_uuid, 16) == 0){ 309 log_info("ANCS Data Source found, attribute handle %u", characteristic.value_handle); 310 ancs_data_source_characteristic = characteristic; 311 ancs_characteristcs++; 312 break; 313 } 314 break; 315 case GATT_EVENT_QUERY_COMPLETE: 316 log_info("ANCS Characteristcs count %u", ancs_characteristcs); 317 tc_state = TC_W2_ENABLE_NOTIFICATION; 318 break; 319 default: 320 break; 321 } 322 break; 323 324 case TC_W4_NOTIFICATION_SOURCE_SUBSCRIBED: 325 switch(hci_event_packet_get_type(packet)){ 326 case GATT_EVENT_QUERY_COMPLETE: 327 log_info("ANCS Notification Source subscribed"); 328 tc_state = TC_W2_SUBSCRIBE_DATA_SOURCE; 329 330 break; 331 default: 332 break; 333 } 334 break; 335 336 case TC_W4_DATA_SOURCE_SUBSCRIBED: 337 switch(hci_event_packet_get_type(packet)){ 338 case GATT_EVENT_QUERY_COMPLETE: 339 log_info("ANCS Data Source subscribed"); 340 tc_state = TC_SUBSCRIBED; 341 notify_client_simple(ANCS_SUBEVENT_CLIENT_CONNECTED); 342 break; 343 default: 344 break; 345 } 346 break; 347 348 case TC_SUBSCRIBED: 349 switch(hci_event_packet_get_type(packet)){ 350 case GATT_EVENT_NOTIFICATION: 351 case GATT_EVENT_INDICATION: 352 ancs_client_handle_notification(packet, size); 353 break; 354 default: 355 break; 356 } 357 break; 358 359 default: 360 break; 361 } 362 363 uint8_t status; 364 switch(tc_state){ 365 case TC_W2_QUERY_SERVICE: 366 case TC_W2_QUERY_CARACTERISTIC: 367 case TC_W2_ENABLE_NOTIFICATION: 368 case TC_W2_SUBSCRIBE_DATA_SOURCE: 369 status = gatt_client_request_to_send_gatt_query(&ancs_client_handle_can_send_now, gc_handle); 370 if (status != ERROR_CODE_SUCCESS){ 371 notify_client_simple(ANCS_SUBEVENT_CLIENT_DISCONNECTED); 372 } 373 break; 374 375 default: 376 break; 377 } 378 } 379 380 static void handle_hci_event(uint8_t packet_type, uint16_t channel, uint8_t *packet, uint16_t size){ 381 382 UNUSED(packet_type); // ok: only hci events 383 UNUSED(channel); // ok: there is no channel 384 UNUSED(size); // ok: fixed format events read from HCI buffer 385 386 int connection_encrypted; 387 uint8_t status; 388 389 // handle connect / disconncet events first 390 switch (hci_event_packet_get_type(packet)) { 391 case HCI_EVENT_META_GAP: 392 switch (hci_event_gap_meta_get_subevent_code(packet)) { 393 case GAP_SUBEVENT_LE_CONNECTION_COMPLETE: 394 gc_handle = gap_subevent_le_connection_complete_get_connection_handle(packet); 395 log_info("Connection handle 0x%04x, request encryption", gc_handle); 396 397 // we need to be paired to enable notifications 398 tc_state = TC_W4_ENCRYPTED_CONNECTION; 399 ancs_service_found = false; 400 sm_request_pairing(gc_handle); 401 break; 402 default: 403 break; 404 } 405 return; 406 407 case HCI_EVENT_ENCRYPTION_CHANGE: 408 case HCI_EVENT_ENCRYPTION_CHANGE_V2: 409 if (gc_handle != hci_event_encryption_change_get_connection_handle(packet)) return; 410 connection_encrypted = hci_event_encryption_change_get_encryption_enabled(packet); 411 log_info("Encryption state change: %u", connection_encrypted); 412 if (!connection_encrypted) return; 413 if (tc_state != TC_W4_ENCRYPTED_CONNECTION) return; 414 415 // let's start 416 log_info("\nANCS Client - CONNECTED, discover ANCS service"); 417 tc_state = TC_W2_QUERY_SERVICE; 418 status = ancs_client_request_send_gatt_query(); 419 if (status != ERROR_CODE_SUCCESS){ 420 notify_client_simple(ANCS_SUBEVENT_CLIENT_DISCONNECTED); 421 } 422 return; 423 424 case HCI_EVENT_DISCONNECTION_COMPLETE: 425 if (hci_event_disconnection_complete_get_connection_handle(packet) != gc_handle) break; 426 if (tc_state == TC_SUBSCRIBED){ 427 notify_client_simple(ANCS_SUBEVENT_CLIENT_DISCONNECTED); 428 } 429 tc_state = TC_IDLE; 430 gc_handle = HCI_CON_HANDLE_INVALID; 431 return; 432 433 default: 434 break; 435 } 436 } 437 438 void ancs_client_init(void){ 439 hci_event_callback_registration.callback = &handle_hci_event; 440 hci_add_event_handler(&hci_event_callback_registration); 441 ancs_client_handle_can_send_now.callback = &ancs_client_send_next_query; 442 } 443 444 // unit test only 445 #if defined __cplusplus 446 extern "C" 447 #endif 448 void ancs_client_set_invalid_parser_state(void); 449 void ancs_client_set_invalid_parser_state(void){ 450 chunk_parser_state = (ancs_chunk_parser_state_t) 0x17; 451 } 452