1 /****************************************************************************** 2 * 3 * Copyright (C) 1999-2012 Broadcom Corporation 4 * 5 * Licensed under the Apache License, Version 2.0 (the "License"); 6 * you may not use this file except in compliance with the License. 7 * You may obtain a copy of the License at: 8 * 9 * http://www.apache.org/licenses/LICENSE-2.0 10 * 11 * Unless required by applicable law or agreed to in writing, software 12 * distributed under the License is distributed on an "AS IS" BASIS, 13 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 14 * See the License for the specific language governing permissions and 15 * limitations under the License. 16 * 17 ******************************************************************************/ 18 19 /****************************************************************************** 20 * 21 * this file contains the main Bluetooth Manager (BTM) internal 22 * definitions. 23 * 24 ******************************************************************************/ 25 26 #ifndef BTM_BLE_INT_H 27 #define BTM_BLE_INT_H 28 29 #include "common/bt_target.h" 30 #include "osi/fixed_queue.h" 31 #include "osi/pkt_queue.h" 32 #include "osi/thread.h" 33 #include "stack/hcidefs.h" 34 #include "stack/btm_ble_api.h" 35 #include "btm_int.h" 36 37 #if BLE_INCLUDED == TRUE && SMP_INCLUDED == TRUE 38 #include "stack/smp_api.h" 39 #endif 40 41 42 /* scanning enable status */ 43 #define BTM_BLE_SCAN_ENABLE 0x01 44 #define BTM_BLE_SCAN_DISABLE 0x00 45 46 /* advertising enable status */ 47 #define BTM_BLE_ADV_ENABLE 0x01 48 #define BTM_BLE_ADV_DISABLE 0x00 49 50 /* use the high 4 bits unused by inquiry mode */ 51 #define BTM_BLE_SELECT_SCAN 0x20 52 #define BTM_BLE_NAME_REQUEST 0x40 53 #define BTM_BLE_OBSERVE 0x80 54 55 #define BTM_BLE_MAX_WL_ENTRY 1 56 #define BTM_BLE_AD_DATA_LEN 31 57 58 #define BTM_BLE_ENC_MASK 0x03 59 60 #define BTM_BLE_DUPLICATE_DISABLE 0 61 #define BTM_BLE_DUPLICATE_ENABLE 1 62 #define BTM_BLE_DUPLICATE_MAX BTM_BLE_DUPLICATE_ENABLE 63 64 #define BTM_BLE_GAP_DISC_SCAN_INT 18 /* Interval(scan_int) = 11.25 ms= 0x0010 * 0.625 ms */ 65 #define BTM_BLE_GAP_DISC_SCAN_WIN 18 /* scan_window = 11.25 ms= 0x0010 * 0.625 ms */ 66 #define BTM_BLE_GAP_ADV_INT 512 /* Tgap(gen_disc) = 1.28 s= 512 * 0.625 ms */ 67 #define BTM_BLE_GAP_LIM_TOUT 180 /* Tgap(lim_timeout) = 180s max */ 68 #define BTM_BLE_LOW_LATENCY_SCAN_INT 8000 /* Interval(scan_int) = 5s= 8000 * 0.625 ms */ 69 #define BTM_BLE_LOW_LATENCY_SCAN_WIN 8000 /* scan_window = 5s= 8000 * 0.625 ms */ 70 71 72 #define BTM_BLE_GAP_ADV_FAST_INT_1 48 /* TGAP(adv_fast_interval1) = 30(used) ~ 60 ms = 48 *0.625 */ 73 #define BTM_BLE_GAP_ADV_FAST_INT_2 160 /* TGAP(adv_fast_interval2) = 100(used) ~ 150 ms = 160 * 0.625 ms */ 74 #define BTM_BLE_GAP_ADV_SLOW_INT 2048 /* Tgap(adv_slow_interval) = 1.28 s= 512 * 0.625 ms */ 75 #define BTM_BLE_GAP_ADV_DIR_MAX_INT 800 /* Tgap(dir_conn_adv_int_max) = 500 ms = 800 * 0.625 ms */ 76 #define BTM_BLE_GAP_ADV_DIR_MIN_INT 400 /* Tgap(dir_conn_adv_int_min) = 250 ms = 400 * 0.625 ms */ 77 78 #define BTM_BLE_GAP_FAST_ADV_TOUT 30 79 80 #define BTM_BLE_SEC_REQ_ACT_NONE 0 81 #define BTM_BLE_SEC_REQ_ACT_ENCRYPT 1 /* encrypt the link using current key or key refresh */ 82 #define BTM_BLE_SEC_REQ_ACT_PAIR 2 83 #define BTM_BLE_SEC_REQ_ACT_DISCARD 3 /* discard the sec request while encryption is started but not completed */ 84 typedef UINT8 tBTM_BLE_SEC_REQ_ACT; 85 86 #define BLE_STATIC_PRIVATE_MSB_MASK 0x3f 87 #define BLE_NON_RESOLVE_ADDR_MSB 0x00 /* most significant bit, bit7, bit6 is 00 to be non-resolvable random */ 88 #define BLE_RESOLVE_ADDR_MSB 0x40 /* most significant bit, bit7, bit6 is 01 to be resolvable random */ 89 #define BLE_RESOLVE_ADDR_MASK 0xc0 /* bit 6, and bit7 */ 90 #define BTM_BLE_IS_NON_RESLVE_BDA(x) ((x[0] & BLE_RESOLVE_ADDR_MASK) == BLE_NON_RESOLVE_ADDR_MSB) 91 #define BTM_BLE_IS_RESOLVE_BDA(x) ((x[0] & BLE_RESOLVE_ADDR_MASK) == BLE_RESOLVE_ADDR_MSB) 92 93 /* LE scan activity bit mask, continue with LE inquiry bits */ 94 #define BTM_LE_SELECT_CONN_ACTIVE 0x0040 /* selection connection is in progress */ 95 #define BTM_LE_OBSERVE_ACTIVE 0x0080 /* observe is in progress */ 96 #define BTM_LE_DISCOVER_ACTIVE 0x0100 /* scan is in progress */ 97 98 /* BLE scan activity mask checking */ 99 #define BTM_BLE_IS_SCAN_ACTIVE(x) ((x) & BTM_BLE_SCAN_ACTIVE_MASK) 100 #define BTM_BLE_IS_INQ_ACTIVE(x) ((x) & BTM_BLE_INQUIRY_MASK) 101 #define BTM_BLE_IS_OBS_ACTIVE(x) ((x) & BTM_LE_OBSERVE_ACTIVE) 102 #define BTM_BLE_IS_DISCO_ACTIVE(x) ((x) & BTM_LE_DISCOVER_ACTIVE) 103 #define BTM_BLE_IS_SEL_CONN_ACTIVE(x) ((x) & BTM_LE_SELECT_CONN_ACTIVE) 104 105 /* BLE ADDR type ID bit */ 106 #define BLE_ADDR_TYPE_ID_BIT 0x02 107 108 #define BTM_VSC_CHIP_CAPABILITY_L_VERSION 55 109 #define BTM_VSC_CHIP_CAPABILITY_M_VERSION 95 110 111 typedef enum { 112 BTM_BLE_IDLE = 0, 113 BTM_BLE_SCANNING = 1, 114 BTM_BLE_ADVERTISING = 2, 115 }tBTM_BLE_GAP_STATE; 116 117 typedef struct { 118 UINT16 data_mask; 119 UINT8 *p_flags; 120 UINT8 ad_data[BTM_BLE_AD_DATA_LEN]; 121 UINT8 *p_pad; 122 } tBTM_BLE_LOCAL_ADV_DATA; 123 124 typedef struct { 125 UINT32 inq_count; /* Used for determining if a response has already been */ 126 /* received for the current inquiry operation. (We do not */ 127 /* want to flood the caller with multiple responses from */ 128 /* the same device. */ 129 BOOLEAN scan_rsp; 130 tBLE_BD_ADDR le_bda; 131 } tINQ_LE_BDADDR; 132 133 #define BTM_BLE_ADV_DATA_LEN_MAX 31 134 #define BTM_BLE_CACHE_ADV_DATA_MAX 62 135 #if (BLE_50_FEATURE_SUPPORT == TRUE) 136 #define BTM_BLE_EXT_ADV_DATA_LEN_MAX 251 137 #define BTM_BLE_PERIODIC_ADV_DATA_LEN_MAX 252 138 139 #define BTM_BLE_ADV_DATA_OP_INTERMEDIATE_FRAG 0 140 #define BTM_BLE_ADV_DATA_OP_FIRST_FRAG 1 141 #define BTM_BLE_ADV_DATA_OP_LAST_FRAG 2 142 #define BTM_BLE_ADV_DATA_OP_COMPLETE 3 143 #define BTM_BLE_ADV_DATA_OP_UNCHANGED_DATA 4 144 #endif // #if (BLE_50_FEATURE_SUPPORT == TRUE) 145 146 #define BTM_BLE_ISVALID_PARAM(x, min, max) (((x) >= (min) && (x) <= (max)) || ((x) == BTM_BLE_CONN_PARAM_UNDEF)) 147 148 typedef struct { 149 UINT16 discoverable_mode; 150 UINT16 connectable_mode; 151 BOOLEAN scan_params_set; 152 UINT32 scan_window; 153 UINT32 scan_interval; 154 UINT8 scan_type; /* current scan type: active or passive */ 155 UINT8 scan_duplicate_filter; /* duplicate filter enabled for scan */ 156 UINT16 adv_interval_min; 157 UINT16 adv_interval_max; 158 tBTM_BLE_AFP afp; /* advertising filter policy */ 159 tBTM_BLE_SFP sfp; /* scanning filter policy */ 160 tBTM_START_ADV_CMPL_CBACK *p_adv_cb; 161 tBTM_START_STOP_ADV_CMPL_CBACK *p_stop_adv_cb; 162 tBTM_CLEAR_ADV_CMPL_CBACK *p_clear_adv_cb; 163 tBLE_ADDR_TYPE adv_addr_type; 164 UINT8 evt_type; 165 UINT8 adv_mode; 166 tBLE_BD_ADDR direct_bda; 167 tBTM_BLE_EVT directed_conn; 168 BOOLEAN fast_adv_on; 169 TIMER_LIST_ENT fast_adv_timer; 170 171 UINT8 adv_len; 172 UINT8 adv_data_cache[BTM_BLE_CACHE_ADV_DATA_MAX]; 173 BD_ADDR adv_addr; 174 /* inquiry BD addr database */ 175 UINT8 num_bd_entries; 176 UINT8 max_bd_entries; 177 tBTM_BLE_LOCAL_ADV_DATA adv_data; 178 tBTM_BLE_ADV_CHNL_MAP adv_chnl_map; 179 180 TIMER_LIST_ENT inq_timer_ent; 181 BOOLEAN scan_rsp; 182 tBTM_BLE_GAP_STATE state; /* Current state that the adv or scan process is in */ 183 INT8 tx_power; 184 } tBTM_BLE_INQ_CB; 185 186 187 /* random address resolving complete callback */ 188 typedef void (tBTM_BLE_RESOLVE_CBACK) (void *match_rec, void *p); 189 190 typedef void (tBTM_BLE_ADDR_CBACK) (BD_ADDR_PTR static_random, void *p); 191 192 #define BTM_BLE_GAP_ADDR_BIT_RANDOM (1<<0) 193 #define BTM_BLE_GAP_ADDR_BIT_RESOLVABLE (1<<1) 194 195 /* random address management control block */ 196 typedef struct { 197 tBLE_ADDR_TYPE own_addr_type; /* local device LE address type */ 198 UINT8 exist_addr_bit; 199 BD_ADDR static_rand_addr; 200 BD_ADDR resolvale_addr; 201 BD_ADDR private_addr; 202 BD_ADDR random_bda; 203 BOOLEAN busy; 204 tBTM_SEC_DEV_REC *p_dev_rec; 205 tBTM_BLE_RESOLVE_CBACK *p_resolve_cback; 206 tBTM_BLE_ADDR_CBACK *p_generate_cback; 207 void *p; 208 TIMER_LIST_ENT raddr_timer_ent; 209 tBTM_SET_LOCAL_PRIVACY_CBACK *set_local_privacy_cback; 210 } tBTM_LE_RANDOM_CB; 211 212 #define BTM_BLE_MAX_BG_CONN_DEV_NUM 10 213 214 typedef struct { 215 UINT16 scan_interval; 216 UINT16 scan_window; 217 UINT16 min_conn_int; 218 UINT16 max_conn_int; 219 UINT16 slave_latency; 220 UINT16 supervision_tout; 221 UINT16 min_ce_len; 222 UINT16 max_ce_len; 223 } tBTM_LE_CONN_PRAMS; 224 225 226 typedef struct { 227 BD_ADDR bd_addr; 228 UINT8 attr; 229 BOOLEAN is_connected; 230 BOOLEAN in_use; 231 } tBTM_LE_BG_CONN_DEV; 232 233 /* white list using state as a bit mask */ 234 #define BTM_BLE_WL_IDLE 0 235 #define BTM_BLE_WL_INIT 1 236 #define BTM_BLE_WL_SCAN 2 237 #define BTM_BLE_WL_ADV 4 238 typedef UINT8 tBTM_BLE_WL_STATE; 239 240 /* resolving list using state as a bit mask */ 241 #define BTM_BLE_RL_IDLE 0 242 #define BTM_BLE_RL_INIT 1 243 #define BTM_BLE_RL_SCAN 2 244 #define BTM_BLE_RL_ADV 4 245 typedef UINT8 tBTM_BLE_RL_STATE; 246 247 /* BLE connection state */ 248 #define BLE_CONN_IDLE 0 249 #define BLE_DIR_CONN 1 250 #define BLE_BG_CONN 2 251 #define BLE_CONN_CANCEL 3 252 typedef UINT8 tBTM_BLE_CONN_ST; 253 254 typedef struct { 255 void *p_param; 256 } tBTM_BLE_CONN_REQ; 257 258 /* LE state request */ 259 #define BTM_BLE_STATE_INVALID 0 260 #define BTM_BLE_STATE_CONN_ADV 1 261 #define BTM_BLE_STATE_INIT 2 262 #define BTM_BLE_STATE_MASTER 3 263 #define BTM_BLE_STATE_SLAVE 4 264 #define BTM_BLE_STATE_LO_DUTY_DIR_ADV 5 265 #define BTM_BLE_STATE_HI_DUTY_DIR_ADV 6 266 #define BTM_BLE_STATE_NON_CONN_ADV 7 267 #define BTM_BLE_STATE_PASSIVE_SCAN 8 268 #define BTM_BLE_STATE_ACTIVE_SCAN 9 269 #define BTM_BLE_STATE_SCAN_ADV 10 270 #define BTM_BLE_STATE_MAX 11 271 typedef UINT8 tBTM_BLE_STATE; 272 273 #define BTM_BLE_STATE_CONN_ADV_BIT 0x0001 274 #define BTM_BLE_STATE_INIT_BIT 0x0002 275 #define BTM_BLE_STATE_MASTER_BIT 0x0004 276 #define BTM_BLE_STATE_SLAVE_BIT 0x0008 277 #define BTM_BLE_STATE_LO_DUTY_DIR_ADV_BIT 0x0010 278 #define BTM_BLE_STATE_HI_DUTY_DIR_ADV_BIT 0x0020 279 #define BTM_BLE_STATE_NON_CONN_ADV_BIT 0x0040 280 #define BTM_BLE_STATE_PASSIVE_SCAN_BIT 0x0080 281 #define BTM_BLE_STATE_ACTIVE_SCAN_BIT 0x0100 282 #define BTM_BLE_STATE_SCAN_ADV_BIT 0x0200 283 typedef UINT16 tBTM_BLE_STATE_MASK; 284 285 #define BTM_BLE_STATE_ALL_MASK 0x03ff 286 #define BTM_BLE_STATE_ALL_ADV_MASK (BTM_BLE_STATE_CONN_ADV_BIT|BTM_BLE_STATE_LO_DUTY_DIR_ADV_BIT|BTM_BLE_STATE_HI_DUTY_DIR_ADV_BIT|BTM_BLE_STATE_SCAN_ADV_BIT) 287 #define BTM_BLE_STATE_ALL_SCAN_MASK (BTM_BLE_STATE_PASSIVE_SCAN_BIT|BTM_BLE_STATE_ACTIVE_SCAN_BIT) 288 #define BTM_BLE_STATE_ALL_CONN_MASK (BTM_BLE_STATE_MASTER_BIT|BTM_BLE_STATE_SLAVE_BIT) 289 290 #ifndef BTM_LE_RESOLVING_LIST_MAX 291 #define BTM_LE_RESOLVING_LIST_MAX 0x20 292 #endif 293 294 #define BTM_DUPLICATE_SCAN_EXCEPTIONAL_INFO_ADV_ADDR 0 295 #define BTM_DUPLICATE_SCAN_EXCEPTIONAL_INFO_MESH_LINK_ID 1 296 #define BTM_DUPLICATE_SCAN_EXCEPTIONAL_INFO_MESH_BEACON_TYPE 2 297 #define BTM_DUPLICATE_SCAN_EXCEPTIONAL_INFO_MESH_PROV_SRV_ADV 3 298 #define BTM_DUPLICATE_SCAN_EXCEPTIONAL_INFO_MESH_PROXY_SRV_ADV 4 299 300 typedef struct { 301 BD_ADDR *resolve_q_random_pseudo; 302 UINT8 *resolve_q_action; 303 UINT8 q_next; 304 UINT8 q_pending; 305 } tBTM_BLE_RESOLVE_Q; 306 307 typedef struct { 308 BOOLEAN in_use; 309 BOOLEAN to_add; 310 BD_ADDR bd_addr; 311 tBLE_ADDR_TYPE addr_type; 312 UINT8 attr; 313 } tBTM_BLE_WL_OP; 314 315 /* BLE privacy mode */ 316 #define BTM_PRIVACY_NONE 0 /* BLE no privacy */ 317 #define BTM_PRIVACY_1_1 1 /* BLE privacy 1.1, do not support privacy 1.0 */ 318 #define BTM_PRIVACY_1_2 2 /* BLE privacy 1.2 */ 319 #define BTM_PRIVACY_MIXED 3 /* BLE privacy mixed mode, broadcom proprietary mode */ 320 typedef UINT8 tBTM_PRIVACY_MODE; 321 322 /* data length change event callback */ 323 typedef void (tBTM_DATA_LENGTH_CHANGE_CBACK) (UINT16 max_tx_length, UINT16 max_rx_length); 324 325 /* Define BLE Device Management control structure 326 */ 327 typedef struct { 328 UINT16 scan_activity; /* LE scan activity mask */ 329 330 /***************************************************** 331 ** BLE Inquiry 332 *****************************************************/ 333 tBTM_BLE_INQ_CB inq_var; 334 335 /* observer callback and timer */ 336 tBTM_INQ_RESULTS_CB *p_obs_results_cb; 337 tBTM_CMPL_CB *p_obs_cmpl_cb; 338 tBTM_INQ_DIS_CB *p_obs_discard_cb; 339 TIMER_LIST_ENT obs_timer_ent; 340 341 /* scan callback and timer */ 342 tBTM_INQ_RESULTS_CB *p_scan_results_cb; 343 tBTM_CMPL_CB *p_scan_cmpl_cb; 344 TIMER_LIST_ENT scan_timer_ent; 345 346 struct pkt_queue *adv_rpt_queue; 347 struct osi_event *adv_rpt_ready; 348 349 /* background connection procedure cb value */ 350 tBTM_BLE_CONN_TYPE bg_conn_type; 351 UINT32 scan_int; 352 UINT32 scan_win; 353 tBTM_BLE_SEL_CBACK *p_select_cback; 354 /* white list information */ 355 UINT8 white_list_avail_size; 356 tBTM_UPDATE_WHITELIST_CBACK *update_wl_cb; 357 tBTM_BLE_WL_STATE wl_state; 358 359 fixed_queue_t *conn_pending_q; 360 tBTM_BLE_CONN_ST conn_state; 361 362 /* random address management control block */ 363 tBTM_LE_RANDOM_CB addr_mgnt_cb; 364 365 BOOLEAN enabled; 366 367 #if BLE_PRIVACY_SPT == TRUE 368 BOOLEAN mixed_mode; /* privacy 1.2 mixed mode is on or not */ 369 tBTM_PRIVACY_MODE privacy_mode; /* privacy mode */ 370 UINT8 resolving_list_avail_size; /* resolving list available size */ 371 tBTM_BLE_RESOLVE_Q resolving_list_pend_q; /* Resolving list queue */ 372 tBTM_BLE_RL_STATE suspended_rl_state; /* Suspended resolving list state */ 373 UINT8 *irk_list_mask; /* IRK list availability mask, up to max entry bits */ 374 tBTM_BLE_RL_STATE rl_state; /* Resolving list state */ 375 #endif 376 377 tBTM_BLE_WL_OP wl_op_q[BTM_BLE_MAX_BG_CONN_DEV_NUM]; 378 379 /* current BLE link state */ 380 tBTM_BLE_STATE_MASK cur_states; /* bit mask of tBTM_BLE_STATE */ 381 UINT8 link_count[2]; /* total link count master and slave*/ 382 tBTM_UPDATE_DUPLICATE_EXCEPTIONAL_LIST_CMPL_CBACK *update_exceptional_list_cmp_cb; 383 tBTM_SET_CSA_SUPPORT_CMPL_CBACK *set_csa_support_cmpl_cb; 384 } tBTM_BLE_CB; 385 386 #ifdef __cplusplus 387 extern "C" { 388 #endif 389 390 void btm_ble_timeout(TIMER_LIST_ENT *p_tle); 391 void btm_ble_process_adv_pkt (UINT8 *p); 392 void btm_ble_process_adv_discard_evt(UINT8 *p); 393 void btm_ble_process_direct_adv_pkt (UINT8 *p); 394 bool btm_ble_adv_pkt_ready(void); 395 bool btm_ble_adv_pkt_post(pkt_linked_item_t *pkt); 396 void btm_ble_proc_scan_rsp_rpt (UINT8 *p); 397 tBTM_STATUS btm_ble_read_remote_name(BD_ADDR remote_bda, tBTM_INQ_INFO *p_cur, tBTM_CMPL_CB *p_cb); 398 BOOLEAN btm_ble_cancel_remote_name(BD_ADDR remote_bda); 399 400 tBTM_STATUS btm_ble_set_discoverability(UINT16 combined_mode); 401 tBTM_STATUS btm_ble_set_connectability(UINT16 combined_mode); 402 tBTM_STATUS btm_ble_start_inquiry (UINT8 mode, UINT8 duration); 403 void btm_ble_stop_scan(void); 404 void btm_clear_all_pending_le_entry(void); 405 406 BOOLEAN btm_ble_send_extended_scan_params(UINT8 scan_type, UINT32 scan_int, UINT32 scan_win, UINT8 addr_type_own, UINT8 scan_filter_policy); 407 void btm_ble_stop_inquiry(void); 408 void btm_ble_init (void); 409 void btm_ble_free (void); 410 void btm_ble_connected (UINT8 *bda, UINT16 handle, UINT8 enc_mode, UINT8 role, tBLE_ADDR_TYPE addr_type, BOOLEAN addr_matched); 411 void btm_ble_read_remote_features_complete(UINT8 *p); 412 void btm_ble_write_adv_enable_complete(UINT8 *p); 413 void btm_ble_conn_complete(UINT8 *p, UINT16 evt_len, BOOLEAN enhanced); 414 void btm_read_ble_local_supported_states_complete(UINT8 *p, UINT16 evt_len); 415 tBTM_BLE_CONN_ST btm_ble_get_conn_st(void); 416 void btm_ble_set_conn_st(tBTM_BLE_CONN_ST new_st); 417 UINT8 *btm_ble_build_adv_data(tBTM_BLE_AD_MASK *p_data_mask, UINT8 **p_dst, tBTM_BLE_ADV_DATA *p_data); 418 tBTM_STATUS btm_ble_start_adv(void); 419 tBTM_STATUS btm_ble_stop_adv(void); 420 tBTM_STATUS btm_ble_start_scan(void); 421 void btm_ble_create_ll_conn_complete (UINT8 status); 422 void btm_ble_create_conn_cancel_complete (UINT8 *p); 423 tBTM_STATUS btm_ble_set_random_addr(BD_ADDR random_bda); 424 425 /* LE security function from btm_sec.c */ 426 #if SMP_INCLUDED == TRUE 427 void btm_ble_link_sec_check(BD_ADDR bd_addr, tBTM_LE_AUTH_REQ auth_req, tBTM_BLE_SEC_REQ_ACT *p_sec_req_act); 428 void btm_ble_ltk_request_reply(BD_ADDR bda, BOOLEAN use_stk, BT_OCTET16 stk); 429 UINT8 btm_proc_smp_cback(tSMP_EVT event, BD_ADDR bd_addr, tSMP_EVT_DATA *p_data); 430 tBTM_STATUS btm_ble_set_encryption (BD_ADDR bd_addr, void *p_ref_data, UINT8 link_role); 431 void btm_ble_ltk_request(UINT16 handle, UINT8 rand[8], UINT16 ediv); 432 tBTM_STATUS btm_ble_start_encrypt(BD_ADDR bda, BOOLEAN use_stk, BT_OCTET16 stk); 433 void btm_ble_link_encrypted(BD_ADDR bd_addr, UINT8 encr_enable); 434 #endif 435 436 /* LE device management functions */ 437 void btm_ble_reset_id( void ); 438 439 /* security related functions */ 440 void btm_ble_increment_sign_ctr(BD_ADDR bd_addr, BOOLEAN is_local ); 441 BOOLEAN btm_get_local_div (BD_ADDR bd_addr, UINT16 *p_div); 442 BOOLEAN btm_ble_get_enc_key_type(BD_ADDR bd_addr, UINT8 *p_key_types); 443 444 void btm_ble_test_command_complete(UINT8 *p); 445 void btm_ble_rand_enc_complete (UINT8 *p, UINT16 op_code, tBTM_RAND_ENC_CB *p_enc_cplt_cback); 446 447 void btm_sec_save_le_key(BD_ADDR bd_addr, tBTM_LE_KEY_TYPE key_type, tBTM_LE_KEY_VALUE *p_keys, BOOLEAN pass_to_application); 448 void btm_ble_update_sec_key_size(BD_ADDR bd_addr, UINT8 enc_key_size); 449 UINT8 btm_ble_read_sec_key_size(BD_ADDR bd_addr); 450 451 /* white list function */ 452 BOOLEAN btm_update_dev_to_white_list(BOOLEAN to_add, BD_ADDR bd_addr, tBLE_ADDR_TYPE addr_type, tBTM_UPDATE_WHITELIST_CBACK *update_wl_cb); 453 void btm_update_scanner_filter_policy(tBTM_BLE_SFP scan_policy); 454 void btm_update_adv_filter_policy(tBTM_BLE_AFP adv_policy); 455 void btm_ble_clear_white_list (tBTM_UPDATE_WHITELIST_CBACK *update_wl_cb); 456 void btm_read_white_list_size_complete(UINT8 *p, UINT16 evt_len); 457 void btm_ble_add_2_white_list_complete(UINT8 status); 458 void btm_ble_remove_from_white_list_complete(UINT8 *p, UINT16 evt_len); 459 void btm_ble_clear_white_list_complete(UINT8 *p, UINT16 evt_len); 460 void btm_ble_white_list_init(UINT8 white_list_size); 461 462 /* background connection function */ 463 BOOLEAN btm_ble_suspend_bg_conn(void); 464 BOOLEAN btm_ble_resume_bg_conn(void); 465 void btm_ble_initiate_select_conn(BD_ADDR bda); 466 BOOLEAN btm_ble_start_auto_conn(BOOLEAN start); 467 BOOLEAN btm_ble_start_select_conn(BOOLEAN start, tBTM_BLE_SEL_CBACK *p_select_cback); 468 BOOLEAN btm_ble_renew_bg_conn_params(BOOLEAN add, BD_ADDR bd_addr); 469 void btm_write_dir_conn_wl(BD_ADDR target_addr); 470 BOOLEAN btm_ble_update_mode_operation(UINT8 link_role, BD_ADDR bda, UINT8 status); 471 BOOLEAN btm_execute_wl_dev_operation(void); 472 void btm_ble_update_link_topology_mask(UINT8 role, BOOLEAN increase); 473 474 /* direct connection utility */ 475 BOOLEAN btm_send_pending_direct_conn(void); 476 void btm_ble_enqueue_direct_conn_req(void *p_param); 477 478 /* BLE address management */ 479 void btm_gen_resolvable_private_addr (void *p_cmd_cplt_cback); 480 void btm_gen_non_resolvable_private_addr (tBTM_BLE_ADDR_CBACK *p_cback, void *p); 481 void btm_ble_resolve_random_addr(BD_ADDR random_bda, tBTM_BLE_RESOLVE_CBACK *p_cback, void *p); 482 void btm_gen_resolve_paddr_low(tBTM_RAND_ENC *p); 483 484 /* privacy function */ 485 #if (defined BLE_PRIVACY_SPT && BLE_PRIVACY_SPT == TRUE) 486 /* BLE address mapping with CS feature */ 487 BOOLEAN btm_identity_addr_to_random_pseudo(BD_ADDR bd_addr, UINT8 *p_addr_type, BOOLEAN refresh); 488 BOOLEAN btm_random_pseudo_to_identity_addr(BD_ADDR random_pseudo, UINT8 *p_static_addr_type); 489 void btm_ble_refresh_peer_resolvable_private_addr(BD_ADDR pseudo_bda, BD_ADDR rra, UINT8 rra_type); 490 void btm_ble_refresh_local_resolvable_private_addr(BD_ADDR pseudo_addr, BD_ADDR local_rpa); 491 void btm_ble_read_resolving_list_entry_complete(UINT8 *p, UINT16 evt_len) ; 492 void btm_ble_set_addr_resolution_enable_complete(UINT8 *p, UINT16 evt_len) ; 493 void btm_ble_set_rpa_timeout_complete(UINT8 *p, UINT16 evt_len) ; 494 void btm_ble_remove_resolving_list_entry_complete(UINT8 *p, UINT16 evt_len); 495 void btm_ble_add_resolving_list_entry_complete(UINT8 *p, UINT16 evt_len); 496 void btm_ble_clear_resolving_list_complete(UINT8 *p, UINT16 evt_len); 497 void btm_read_ble_resolving_list_size_complete (UINT8 *p, UINT16 evt_len); 498 void btm_ble_enable_resolving_list(UINT8); 499 BOOLEAN btm_ble_disable_resolving_list(UINT8 rl_mask, BOOLEAN to_resume); 500 void btm_ble_enable_resolving_list_for_platform (UINT8 rl_mask); 501 void btm_ble_resolving_list_init(UINT8 max_irk_list_sz); 502 void btm_ble_resolving_list_cleanup(void); 503 void btm_ble_add_default_entry_to_resolving_list(void); 504 void btm_ble_set_privacy_mode_complete(UINT8 *p, UINT16 evt_len); 505 #endif 506 507 void btm_ble_multi_adv_configure_rpa (tBTM_BLE_MULTI_ADV_INST *p_inst); 508 void btm_ble_multi_adv_init(void); 509 void *btm_ble_multi_adv_get_ref(UINT8 inst_id); 510 void btm_ble_multi_adv_cleanup(void); 511 void btm_ble_multi_adv_reenable(UINT8 inst_id); 512 void btm_ble_multi_adv_enb_privacy(BOOLEAN enable); 513 char btm_ble_map_adv_tx_power(int tx_power_index); 514 void btm_ble_batchscan_init(void); 515 void btm_ble_batchscan_cleanup(void); 516 void btm_ble_adv_filter_init(void); 517 void btm_ble_adv_filter_cleanup(void); 518 BOOLEAN btm_ble_topology_check(tBTM_BLE_STATE_MASK request); 519 BOOLEAN btm_ble_clear_topology_mask(tBTM_BLE_STATE_MASK request_state); 520 BOOLEAN btm_ble_set_topology_mask(tBTM_BLE_STATE_MASK request_state); 521 tBTM_BLE_STATE_MASK btm_ble_get_topology_mask(void); 522 523 #if BTM_BLE_CONFORMANCE_TESTING == TRUE 524 void btm_ble_set_no_disc_if_pair_fail (BOOLEAN disble_disc); 525 void btm_ble_set_test_mac_value (BOOLEAN enable, UINT8 *p_test_mac_val); 526 void btm_ble_set_test_local_sign_cntr_value(BOOLEAN enable, UINT32 test_local_sign_cntr); 527 void btm_set_random_address(BD_ADDR random_bda); 528 void btm_ble_set_keep_rfu_in_auth_req(BOOLEAN keep_rfu); 529 #endif 530 531 BOOLEAN btm_get_current_conn_params(BD_ADDR bda, UINT16 *interval, UINT16 *latency, UINT16 *timeout); 532 533 #if (BLE_50_FEATURE_SUPPORT == TRUE) 534 void btm_ble_update_phy_evt(tBTM_BLE_UPDATE_PHY *params); 535 void btm_ble_scan_timeout_evt(void); 536 void btm_ble_adv_set_terminated_evt(tBTM_BLE_ADV_TERMINAT *params); 537 void btm_ble_ext_adv_report_evt(tBTM_BLE_EXT_ADV_REPORT *params); 538 void btm_ble_scan_req_received_evt(tBTM_BLE_SCAN_REQ_RECEIVED *params); 539 void btm_ble_channel_select_algorithm_evt(tBTM_BLE_CHANNEL_SEL_ALG *params); 540 void btm_ble_periodic_adv_report_evt(tBTM_PERIOD_ADV_REPORT *params); 541 void btm_ble_periodic_adv_sync_lost_evt(tBTM_BLE_PERIOD_ADV_SYNC_LOST *params); 542 void btm_ble_periodic_adv_sync_establish_evt(tBTM_BLE_PERIOD_ADV_SYNC_ESTAB *params); 543 #endif // #if (BLE_50_FEATURE_SUPPORT == TRUE) 544 545 #if (BLE_FEAT_PERIODIC_ADV_SYNC_TRANSFER == TRUE) 546 void btm_ble_periodic_adv_sync_trans_recv_evt(tBTM_BLE_PERIOD_ADV_SYNC_TRANS_RECV *params); 547 #endif // #if (BLE_FEAT_PERIODIC_ADV_SYNC_TRANSFER == TRUE) 548 549 /* 550 #ifdef __cplusplus 551 } 552 #endif 553 */ 554 #endif 555