1 /******************************************************************************
2 *
3 * Copyright 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 #ifndef BTM_BLE_INT_TYPES_H
20 #define BTM_BLE_INT_TYPES_H
21
22 #include "osi/include/alarm.h"
23
24 /* scanning enable status */
25 #define BTM_BLE_SCAN_ENABLE 0x01
26 #define BTM_BLE_SCAN_DISABLE 0x00
27
28 /* advertising enable status */
29 #define BTM_BLE_ADV_ENABLE 0x01
30 #define BTM_BLE_ADV_DISABLE 0x00
31
32 /* use the high 4 bits unused by inquiry mode */
33 #define BTM_BLE_SELECT_SCAN 0x20
34 #define BTM_BLE_NAME_REQUEST 0x40
35 #define BTM_BLE_OBSERVE 0x80
36
37 #define BTM_BLE_MAX_WL_ENTRY 1
38 #define BTM_BLE_AD_DATA_LEN 31
39
40 #define BTM_BLE_ENC_MASK 0x03
41
42 #define BTM_BLE_DUPLICATE_ENABLE 1
43 #define BTM_BLE_DUPLICATE_DISABLE 0
44
45 /* Interval(scan_int) = 11.25 ms= 0x0010 * 0.625 ms */
46 #define BTM_BLE_GAP_DISC_SCAN_INT 18
47 /* scan_window = 11.25 ms= 0x0010 * 0.625 ms */
48 #define BTM_BLE_GAP_DISC_SCAN_WIN 18
49 /* Tgap(gen_disc) = 1.28 s= 512 * 0.625 ms */
50 #define BTM_BLE_GAP_ADV_INT 512
51 /* Tgap(lim_timeout) = 180s max */
52 #define BTM_BLE_GAP_LIM_TIMEOUT_MS (180 * 1000)
53 /* Interval(scan_int) = 5s= 8000 * 0.625 ms */
54 #define BTM_BLE_LOW_LATENCY_SCAN_INT 8000
55 /* scan_window = 5s= 8000 * 0.625 ms */
56 #define BTM_BLE_LOW_LATENCY_SCAN_WIN 8000
57
58 /* TGAP(adv_fast_interval1) = 30(used) ~ 60 ms = 48 *0.625 */
59 #define BTM_BLE_GAP_ADV_FAST_INT_1 48
60 /* TGAP(adv_fast_interval2) = 100(used) ~ 150 ms = 160 * 0.625 ms */
61 #define BTM_BLE_GAP_ADV_FAST_INT_2 160
62 /* Tgap(adv_slow_interval) = 1.28 s= 512 * 0.625 ms */
63 #define BTM_BLE_GAP_ADV_SLOW_INT 2048
64 /* Tgap(dir_conn_adv_int_max) = 500 ms = 800 * 0.625 ms */
65 #define BTM_BLE_GAP_ADV_DIR_MAX_INT 800
66 /* Tgap(dir_conn_adv_int_min) = 250 ms = 400 * 0.625 ms */
67 #define BTM_BLE_GAP_ADV_DIR_MIN_INT 400
68
69 #define BTM_BLE_GAP_FAST_ADV_TIMEOUT_MS (30 * 1000)
70
71 #define BTM_BLE_SEC_REQ_ACT_NONE 0
72 /* encrypt the link using current key or key refresh */
73 #define BTM_BLE_SEC_REQ_ACT_ENCRYPT 1
74 #define BTM_BLE_SEC_REQ_ACT_PAIR 2
75 /* discard the sec request while encryption is started but not completed */
76 #define BTM_BLE_SEC_REQ_ACT_DISCARD 3
77 typedef uint8_t tBTM_BLE_SEC_REQ_ACT;
78
79 #define BLE_STATIC_PRIVATE_MSB_MASK 0x3f
80 /* most significant bit, bit7, bit6 is 01 to be resolvable random */
81 #define BLE_RESOLVE_ADDR_MSB 0x40
82 /* bit 6, and bit7 */
83 #define BLE_RESOLVE_ADDR_MASK 0xc0
BTM_BLE_IS_RESOLVE_BDA(const RawAddress & x)84 inline bool BTM_BLE_IS_RESOLVE_BDA(const RawAddress& x) {
85 return ((x.address)[0] & BLE_RESOLVE_ADDR_MASK) == BLE_RESOLVE_ADDR_MSB;
86 }
87
88 /* LE scan activity bit mask, continue with LE inquiry bits */
89 /* observe is in progress */
90 #define BTM_LE_OBSERVE_ACTIVE 0x80
91
92 /* BLE scan activity mask checking */
93 #define BTM_BLE_IS_SCAN_ACTIVE(x) ((x)&BTM_BLE_SCAN_ACTIVE_MASK)
94 #define BTM_BLE_IS_INQ_ACTIVE(x) ((x)&BTM_BLE_INQUIRY_MASK)
95 #define BTM_BLE_IS_OBS_ACTIVE(x) ((x)&BTM_LE_OBSERVE_ACTIVE)
96
97 /* BLE ADDR type ID bit */
98 #define BLE_ADDR_TYPE_ID_BIT 0x02
99
100 #define BTM_VSC_CHIP_CAPABILITY_L_VERSION 55
101 #define BTM_VSC_CHIP_CAPABILITY_M_VERSION 95
102
103 typedef struct {
104 uint16_t data_mask;
105 uint8_t* p_flags;
106 uint8_t ad_data[BTM_BLE_AD_DATA_LEN];
107 uint8_t* p_pad;
108 } tBTM_BLE_LOCAL_ADV_DATA;
109
110 typedef struct {
111 /* Used for determining if a response has already been received for the
112 * current inquiry operation. (We do not want to flood the caller with
113 * multiple responses from the same device. */
114 uint32_t inq_count;
115 bool scan_rsp;
116 tBLE_BD_ADDR le_bda;
117 } tINQ_LE_BDADDR;
118
119 #define BTM_BLE_ISVALID_PARAM(x, min, max) \
120 (((x) >= (min) && (x) <= (max)) || ((x) == BTM_BLE_CONN_PARAM_UNDEF))
121
122 /* 15 minutes minimum for random address refreshing */
123 #define BTM_BLE_PRIVATE_ADDR_INT_MS (15 * 60 * 1000)
124
125 typedef struct {
126 uint16_t discoverable_mode;
127 uint16_t connectable_mode;
128 uint32_t scan_window;
129 uint32_t scan_interval;
130 uint8_t scan_type; /* current scan type: active or passive */
131 uint8_t scan_duplicate_filter; /* duplicate filter enabled for scan */
132 uint16_t adv_interval_min;
133 uint16_t adv_interval_max;
134 tBTM_BLE_AFP afp; /* advertising filter policy */
135 tBTM_BLE_SFP sfp; /* scanning filter policy */
136
137 tBLE_ADDR_TYPE adv_addr_type;
138 uint8_t evt_type;
139 uint8_t adv_mode;
140 tBLE_BD_ADDR direct_bda;
141 tBTM_BLE_EVT directed_conn;
142 bool fast_adv_on;
143 alarm_t* fast_adv_timer;
144
145 /* inquiry BD addr database */
146 uint8_t num_bd_entries;
147 uint8_t max_bd_entries;
148 tBTM_BLE_LOCAL_ADV_DATA adv_data;
149 tBTM_BLE_ADV_CHNL_MAP adv_chnl_map;
150
151 alarm_t* inquiry_timer;
152 bool scan_rsp;
153 uint8_t state; /* Current state that the inquiry process is in */
154 int8_t tx_power;
155 } tBTM_BLE_INQ_CB;
156
157 /* random address resolving complete callback */
158 typedef void(tBTM_BLE_RESOLVE_CBACK)(void* match_rec, void* p);
159
160 typedef void(tBTM_BLE_ADDR_CBACK)(const RawAddress& static_random, void* p);
161
162 /* random address management control block */
163 typedef struct {
164 tBLE_ADDR_TYPE own_addr_type; /* local device LE address type */
165 RawAddress private_addr;
166 RawAddress random_bda;
167 tBTM_BLE_ADDR_CBACK* p_generate_cback;
168 void* p;
169 alarm_t* refresh_raddr_timer;
170 } tBTM_LE_RANDOM_CB;
171
172 typedef struct {
173 uint16_t min_conn_int;
174 uint16_t max_conn_int;
175 uint16_t slave_latency;
176 uint16_t supervision_tout;
177
178 } tBTM_LE_CONN_PRAMS;
179
180 typedef struct {
181 RawAddress bd_addr;
182 uint8_t attr;
183 bool is_connected;
184 bool in_use;
185 } tBTM_LE_BG_CONN_DEV;
186
187 /* white list using state as a bit mask */
188 constexpr uint8_t BTM_BLE_WL_IDLE = 0;
189 constexpr uint8_t BTM_BLE_WL_INIT = 1;
190
191 /* resolving list using state as a bit mask */
192 #define BTM_BLE_RL_IDLE 0
193 #define BTM_BLE_RL_INIT 1
194 #define BTM_BLE_RL_SCAN 2
195 #define BTM_BLE_RL_ADV 4
196 typedef uint8_t tBTM_BLE_RL_STATE;
197
198 /* BLE connection state */
199 #define BLE_CONN_IDLE 0
200 #define BLE_CONNECTING 2
201 #define BLE_CONN_CANCEL 3
202 typedef uint8_t tBTM_BLE_CONN_ST;
203
204 typedef struct { void* p_param; } tBTM_BLE_CONN_REQ;
205
206 /* LE state request */
207 #define BTM_BLE_STATE_INVALID 0
208 #define BTM_BLE_STATE_CONN_ADV 1
209 #define BTM_BLE_STATE_INIT 2
210 #define BTM_BLE_STATE_MASTER 3
211 #define BTM_BLE_STATE_SLAVE 4
212 #define BTM_BLE_STATE_LO_DUTY_DIR_ADV 5
213 #define BTM_BLE_STATE_HI_DUTY_DIR_ADV 6
214 #define BTM_BLE_STATE_NON_CONN_ADV 7
215 #define BTM_BLE_STATE_PASSIVE_SCAN 8
216 #define BTM_BLE_STATE_ACTIVE_SCAN 9
217 #define BTM_BLE_STATE_SCAN_ADV 10
218 #define BTM_BLE_STATE_MAX 11
219 typedef uint8_t tBTM_BLE_STATE;
220
221 #define BTM_BLE_STATE_CONN_ADV_BIT 0x0001
222 #define BTM_BLE_STATE_INIT_BIT 0x0002
223 #define BTM_BLE_STATE_MASTER_BIT 0x0004
224 #define BTM_BLE_STATE_SLAVE_BIT 0x0008
225 #define BTM_BLE_STATE_LO_DUTY_DIR_ADV_BIT 0x0010
226 #define BTM_BLE_STATE_HI_DUTY_DIR_ADV_BIT 0x0020
227 #define BTM_BLE_STATE_NON_CONN_ADV_BIT 0x0040
228 #define BTM_BLE_STATE_PASSIVE_SCAN_BIT 0x0080
229 #define BTM_BLE_STATE_ACTIVE_SCAN_BIT 0x0100
230 #define BTM_BLE_STATE_SCAN_ADV_BIT 0x0200
231 typedef uint16_t tBTM_BLE_STATE_MASK;
232
233 #define BTM_BLE_STATE_ALL_MASK 0x03ff
234 #define BTM_BLE_STATE_ALL_ADV_MASK \
235 (BTM_BLE_STATE_CONN_ADV_BIT | BTM_BLE_STATE_LO_DUTY_DIR_ADV_BIT | \
236 BTM_BLE_STATE_HI_DUTY_DIR_ADV_BIT | BTM_BLE_STATE_SCAN_ADV_BIT)
237 #define BTM_BLE_STATE_ALL_SCAN_MASK \
238 (BTM_BLE_STATE_PASSIVE_SCAN_BIT | BTM_BLE_STATE_ACTIVE_SCAN_BIT)
239 #define BTM_BLE_STATE_ALL_CONN_MASK \
240 (BTM_BLE_STATE_MASTER_BIT | BTM_BLE_STATE_SLAVE_BIT)
241
242 #ifndef BTM_LE_RESOLVING_LIST_MAX
243 #define BTM_LE_RESOLVING_LIST_MAX 0x20
244 #endif
245
246 typedef struct {
247 RawAddress* resolve_q_random_pseudo;
248 uint8_t* resolve_q_action;
249 uint8_t q_next;
250 uint8_t q_pending;
251 } tBTM_BLE_RESOLVE_Q;
252
253 typedef struct {
254 bool in_use;
255 bool to_add;
256 RawAddress bd_addr;
257 uint8_t attr;
258 } tBTM_BLE_WL_OP;
259
260 /* BLE privacy mode */
261 #define BTM_PRIVACY_NONE 0 /* BLE no privacy */
262 #define BTM_PRIVACY_1_1 1 /* BLE privacy 1.1, do not support privacy 1.0 */
263 #define BTM_PRIVACY_1_2 2 /* BLE privacy 1.2 */
264 #define BTM_PRIVACY_MIXED \
265 3 /* BLE privacy mixed mode, broadcom propietary mode */
266 typedef uint8_t tBTM_PRIVACY_MODE;
267
268 /* data length change event callback */
269 typedef void(tBTM_DATA_LENGTH_CHANGE_CBACK)(uint16_t max_tx_length,
270 uint16_t max_rx_length);
271
272 /* Define BLE Device Management control structure
273 */
274 typedef struct {
275 uint8_t scan_activity; /* LE scan activity mask */
276
277 /*****************************************************
278 ** BLE Inquiry
279 *****************************************************/
280 tBTM_BLE_INQ_CB inq_var;
281
282 /* observer callback and timer */
283 tBTM_INQ_RESULTS_CB* p_obs_results_cb;
284 tBTM_CMPL_CB* p_obs_cmpl_cb;
285 alarm_t* observer_timer;
286
287 /* background connection procedure cb value */
288 uint16_t scan_int;
289 uint16_t scan_win;
290
291 /* white list information */
292 uint8_t wl_state;
293
294 tBTM_BLE_CONN_ST conn_state;
295
296 /* random address management control block */
297 tBTM_LE_RANDOM_CB addr_mgnt_cb;
298
299 bool enabled;
300
301 #if (BLE_PRIVACY_SPT == TRUE)
302 bool mixed_mode; /* privacy 1.2 mixed mode is on or not */
303 tBTM_PRIVACY_MODE privacy_mode; /* privacy mode */
304 uint8_t resolving_list_avail_size; /* resolving list available size */
305 tBTM_BLE_RESOLVE_Q resolving_list_pend_q; /* Resolving list queue */
306 tBTM_BLE_RL_STATE suspended_rl_state; /* Suspended resolving list state */
307 uint8_t* irk_list_mask; /* IRK list availability mask, up to max entry bits */
308 tBTM_BLE_RL_STATE rl_state; /* Resolving list state */
309 #endif
310
311 /* current BLE link state */
312 tBTM_BLE_STATE_MASK cur_states; /* bit mask of tBTM_BLE_STATE */
313 uint8_t link_count[2]; /* total link count master and slave*/
314 } tBTM_BLE_CB;
315
316 #endif // BTM_BLE_INT_TYPES_H
317