• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
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 "bt_common.h"
30 #include "bt_target.h"
31 #include "btm_ble_api.h"
32 #include "btm_ble_int_types.h"
33 #include "btm_int.h"
34 #include "btm_int_types.h"
35 #include "hcidefs.h"
36 #include "smp_api.h"
37 
38 extern bool ble_evt_type_is_connectable(uint16_t evt_type);
39 extern void btm_ble_refresh_raddr_timer_timeout(void* data);
40 extern void btm_ble_process_adv_pkt(uint8_t len, uint8_t* p);
41 extern void btm_ble_process_phy_update_pkt(uint8_t len, uint8_t* p);
42 extern void btm_ble_process_ext_adv_pkt(uint8_t len, uint8_t* p);
43 extern void btm_ble_proc_scan_rsp_rpt(uint8_t* p);
44 extern tBTM_STATUS btm_ble_read_remote_name(BD_ADDR remote_bda,
45                                             tBTM_CMPL_CB* p_cb);
46 extern bool btm_ble_cancel_remote_name(BD_ADDR remote_bda);
47 
48 extern tBTM_STATUS btm_ble_set_discoverability(uint16_t combined_mode);
49 extern tBTM_STATUS btm_ble_set_connectability(uint16_t combined_mode);
50 extern void btm_send_hci_scan_enable(uint8_t enable, uint8_t filter_duplicates);
51 extern void btm_send_hci_set_scan_params(uint8_t scan_type, uint16_t scan_int,
52                                          uint16_t scan_win,
53                                          uint8_t addr_type_own,
54                                          uint8_t scan_filter_policy);
55 extern tBTM_STATUS btm_ble_start_inquiry(uint8_t mode, uint8_t duration);
56 extern void btm_ble_stop_scan(void);
57 extern void btm_clear_all_pending_le_entry(void);
58 
59 extern void btm_ble_stop_scan();
60 extern void btm_ble_stop_inquiry(void);
61 extern void btm_ble_init(void);
62 extern void btm_ble_connected(uint8_t* bda, uint16_t handle, uint8_t enc_mode,
63                               uint8_t role, tBLE_ADDR_TYPE addr_type,
64                               bool addr_matched);
65 extern void btm_ble_read_remote_features_complete(uint8_t* p);
66 extern void btm_ble_write_adv_enable_complete(uint8_t* p);
67 extern void btm_ble_conn_complete(uint8_t* p, uint16_t evt_len, bool enhanced);
68 extern void btm_read_ble_local_supported_states_complete(uint8_t* p,
69                                                          uint16_t evt_len);
70 extern tBTM_BLE_CONN_ST btm_ble_get_conn_st(void);
71 extern void btm_ble_set_conn_st(tBTM_BLE_CONN_ST new_st);
72 extern tBTM_STATUS btm_ble_start_adv(void);
73 extern tBTM_STATUS btm_ble_stop_adv(void);
74 extern void btm_le_on_advertising_set_terminated(uint8_t* p, uint16_t length);
75 extern tBTM_STATUS btm_ble_start_scan(void);
76 extern void btm_ble_create_ll_conn_complete(uint8_t status);
77 
78 /* LE security function from btm_sec.cc */
79 extern void btm_ble_link_sec_check(BD_ADDR bd_addr, tBTM_LE_AUTH_REQ auth_req,
80                                    tBTM_BLE_SEC_REQ_ACT* p_sec_req_act);
81 extern void btm_ble_ltk_request_reply(BD_ADDR bda, bool use_stk,
82                                       BT_OCTET16 stk);
83 extern uint8_t btm_proc_smp_cback(tSMP_EVT event, BD_ADDR bd_addr,
84                                   tSMP_EVT_DATA* p_data);
85 extern tBTM_STATUS btm_ble_set_encryption(BD_ADDR bd_addr,
86                                           tBTM_BLE_SEC_ACT sec_act,
87                                           uint8_t link_role);
88 extern void btm_ble_ltk_request(uint16_t handle, uint8_t rand[8],
89                                 uint16_t ediv);
90 extern tBTM_STATUS btm_ble_start_encrypt(BD_ADDR bda, bool use_stk,
91                                          BT_OCTET16 stk);
92 extern void btm_ble_link_encrypted(BD_ADDR bd_addr, uint8_t encr_enable);
93 
94 /* LE device management functions */
95 extern void btm_ble_reset_id(void);
96 
97 /* security related functions */
98 extern void btm_ble_increment_sign_ctr(BD_ADDR bd_addr, bool is_local);
99 extern bool btm_get_local_div(BD_ADDR bd_addr, uint16_t* p_div);
100 extern bool btm_ble_get_enc_key_type(BD_ADDR bd_addr, uint8_t* p_key_types);
101 
102 extern void btm_ble_test_command_complete(uint8_t* p);
103 extern void btm_ble_rand_enc_complete(uint8_t* p, uint16_t op_code,
104                                       tBTM_RAND_ENC_CB* p_enc_cplt_cback);
105 
106 extern void btm_sec_save_le_key(BD_ADDR bd_addr, tBTM_LE_KEY_TYPE key_type,
107                                 tBTM_LE_KEY_VALUE* p_keys,
108                                 bool pass_to_application);
109 extern void btm_ble_update_sec_key_size(BD_ADDR bd_addr, uint8_t enc_key_size);
110 extern uint8_t btm_ble_read_sec_key_size(BD_ADDR bd_addr);
111 
112 /* white list function */
113 extern bool btm_update_dev_to_white_list(bool to_add, BD_ADDR bd_addr);
114 extern void btm_update_scanner_filter_policy(tBTM_BLE_SFP scan_policy);
115 extern void btm_update_adv_filter_policy(tBTM_BLE_AFP adv_policy);
116 extern void btm_ble_clear_white_list(void);
117 extern void btm_read_white_list_size_complete(uint8_t* p, uint16_t evt_len);
118 extern void btm_ble_add_2_white_list_complete(uint8_t status);
119 extern void btm_ble_remove_from_white_list_complete(uint8_t* p,
120                                                     uint16_t evt_len);
121 extern void btm_ble_clear_white_list_complete(uint8_t* p, uint16_t evt_len);
122 extern void btm_ble_white_list_init(uint8_t white_list_size);
123 
124 /* background connection function */
125 extern bool btm_ble_suspend_bg_conn(void);
126 extern bool btm_ble_resume_bg_conn(void);
127 extern void btm_send_hci_create_connection(
128     uint16_t scan_int, uint16_t scan_win, uint8_t init_filter_policy,
129     uint8_t addr_type_peer, BD_ADDR bda_peer, uint8_t addr_type_own,
130     uint16_t conn_int_min, uint16_t conn_int_max, uint16_t conn_latency,
131     uint16_t conn_timeout, uint16_t min_ce_len, uint16_t max_ce_len,
132     uint8_t phy);
133 extern bool btm_ble_start_auto_conn(bool start);
134 extern bool btm_ble_start_select_conn(bool start);
135 extern bool btm_ble_renew_bg_conn_params(bool add, BD_ADDR bd_addr);
136 extern void btm_write_dir_conn_wl(BD_ADDR target_addr);
137 extern void btm_ble_update_mode_operation(uint8_t link_role, BD_ADDR bda,
138                                           uint8_t status);
139 extern bool btm_execute_wl_dev_operation(void);
140 extern void btm_ble_update_link_topology_mask(uint8_t role, bool increase);
141 
142 /* direct connection utility */
143 extern bool btm_send_pending_direct_conn(void);
144 extern void btm_ble_enqueue_direct_conn_req(void* p_param);
145 extern void btm_ble_dequeue_direct_conn_req(BD_ADDR rem_bda);
146 
147 /* BLE address management */
148 extern void btm_gen_resolvable_private_addr(base::Callback<void(BT_OCTET8)> cb);
149 extern void btm_gen_non_resolvable_private_addr(tBTM_BLE_ADDR_CBACK* p_cback,
150                                                 void* p);
151 extern tBTM_SEC_DEV_REC* btm_ble_resolve_random_addr(BD_ADDR random_bda);
152 extern void btm_gen_resolve_paddr_low(BT_OCTET8 rand);
153 
154 /*  privacy function */
155 #if (BLE_PRIVACY_SPT == TRUE)
156 /* BLE address mapping with CS feature */
157 extern bool btm_identity_addr_to_random_pseudo(BD_ADDR bd_addr,
158                                                uint8_t* p_addr_type,
159                                                bool refresh);
160 extern bool btm_random_pseudo_to_identity_addr(BD_ADDR random_pseudo,
161                                                uint8_t* p_static_addr_type);
162 extern void btm_ble_refresh_peer_resolvable_private_addr(BD_ADDR pseudo_bda,
163                                                          BD_ADDR rra,
164                                                          uint8_t rra_type);
165 extern void btm_ble_refresh_local_resolvable_private_addr(BD_ADDR pseudo_addr,
166                                                           BD_ADDR local_rpa);
167 extern void btm_ble_read_resolving_list_entry_complete(uint8_t* p,
168                                                        uint16_t evt_len);
169 extern void btm_ble_remove_resolving_list_entry_complete(uint8_t* p,
170                                                          uint16_t evt_len);
171 extern void btm_ble_add_resolving_list_entry_complete(uint8_t* p,
172                                                       uint16_t evt_len);
173 extern void btm_ble_clear_resolving_list_complete(uint8_t* p, uint16_t evt_len);
174 extern void btm_read_ble_resolving_list_size_complete(uint8_t* p,
175                                                       uint16_t evt_len);
176 extern void btm_ble_enable_resolving_list(uint8_t);
177 extern bool btm_ble_disable_resolving_list(uint8_t rl_mask, bool to_resume);
178 extern void btm_ble_enable_resolving_list_for_platform(uint8_t rl_mask);
179 extern void btm_ble_resolving_list_init(uint8_t max_irk_list_sz);
180 extern void btm_ble_resolving_list_cleanup(void);
181 #endif
182 
183 extern void btm_ble_adv_init(void);
184 extern void* btm_ble_multi_adv_get_ref(uint8_t inst_id);
185 extern void btm_ble_multi_adv_cleanup(void);
186 extern void btm_ble_batchscan_init(void);
187 extern void btm_ble_batchscan_cleanup(void);
188 extern void btm_ble_adv_filter_init(void);
189 extern void btm_ble_adv_filter_cleanup(void);
190 extern bool btm_ble_topology_check(tBTM_BLE_STATE_MASK request);
191 extern bool btm_ble_clear_topology_mask(tBTM_BLE_STATE_MASK request_state);
192 extern bool btm_ble_set_topology_mask(tBTM_BLE_STATE_MASK request_state);
193 extern void btm_ble_set_random_address(BD_ADDR random_bda);
194 
195 #if (BTM_BLE_CONFORMANCE_TESTING == TRUE)
196 extern void btm_ble_set_no_disc_if_pair_fail(bool disble_disc);
197 extern void btm_ble_set_test_mac_value(bool enable, uint8_t* p_test_mac_val);
198 extern void btm_ble_set_test_local_sign_cntr_value(
199     bool enable, uint32_t test_local_sign_cntr);
200 extern void btm_ble_set_keep_rfu_in_auth_req(bool keep_rfu);
201 #endif
202 
203 #endif
204