1 /******************************************************************************
3 * Copyright (C) 2005-2012 Broadcom Corporation
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:
9 * http://www.apache.org/licenses/LICENSE-2.0
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.
17 ******************************************************************************/
19 /******************************************************************************
21 * This file contains BTA HID Host internal definitions
23 ******************************************************************************/
31 #include "bta_hh_api.h"
33 #if BTA_HH_LE_INCLUDED == TRUE
34 #include "bta_gatt_api.h"
37 /* can be moved to bta_api.h */
38 #define BTA_HH_MAX_RPT_CHARS 8
40 #if (BTA_GATT_INCLUDED == FALSE || BLE_INCLUDED == FALSE)
41 #undef BTA_HH_LE_INCLUDED
42 #define BTA_HH_LE_INCLUDED FALSE
45 /* state machine events, these events are handled by the state machine */
48 BTA_HH_API_OPEN_EVT = BTA_SYS_EVT_START(BTA_ID_HH),
54 BTA_HH_INT_HANDSK_EVT,
56 BTA_HH_API_WRITE_DEV_EVT,
57 BTA_HH_API_GET_DSCP_EVT,
58 BTA_HH_API_MAINT_DEV_EVT,
60 #if (defined BTA_HH_LE_INCLUDED && BTA_HH_LE_INCLUDED == TRUE)
61 BTA_HH_GATT_CLOSE_EVT,
65 BTA_HH_GATT_READ_CHAR_CMPL_EVT,
66 BTA_HH_GATT_WRITE_CHAR_CMPL_EVT,
67 BTA_HH_GATT_READ_DESCR_CMPL_EVT,
68 BTA_HH_GATT_WRITE_DESCR_CMPL_EVT,
69 BTA_HH_API_SCPP_UPDATE_EVT,
72 /* not handled by execute state machine */
73 BTA_HH_API_ENABLE_EVT,
74 BTA_HH_API_DISABLE_EVT,
77 typedef UINT16 tBTA_HH_INT_EVT; /* HID host internal events */
79 #define BTA_HH_INVALID_EVT (BTA_HH_DISC_CMPL_EVT + 1)
81 /* event used to map between BTE event and BTA event */
82 #define BTA_HH_FST_TRANS_CB_EVT BTA_HH_GET_RPT_EVT
83 #define BTA_HH_FST_BTE_TRANS_EVT HID_TRANS_GET_REPORT
85 /* sub event code used for device maintainence API call */
86 #define BTA_HH_ADD_DEV 0
87 #define BTA_HH_REMOVE_DEV 1
89 /* state machine states */
96 #if (defined BTA_HH_LE_INCLUDED && BTA_HH_LE_INCLUDED == TRUE)
99 ,BTA_HH_INVALID_ST /* Used to check invalid states before executing SM function */
102 typedef UINT8 tBTA_HH_STATE;
104 /* data structure used to send a command/data to HID device */
111 #if (defined BTA_HH_LE_INCLUDED && BTA_HH_LE_INCLUDED == TRUE)
118 /* data type for BTA_HH_API_ENABLE_EVT */
123 UINT8 service_name[BTA_SERVICE_NAME_LEN+1];
124 tBTA_HH_CBACK *p_cback;
125 } tBTA_HH_API_ENABLE;
132 tBTA_HH_PROTO_MODE mode;
135 /* internal event data from BTE HID callback */
152 tBTA_HH_DEV_DSCP_INFO dscp_info;
155 #if BTA_HH_LE_INCLUDED == TRUE
160 tBTA_GATT_REASON reason; /* disconnect reason code, not useful when connect event is reported */
169 }tBTA_HH_SCPP_UPDATE;
171 /* union of all event data types */
175 tBTA_HH_API_ENABLE api_enable;
176 tBTA_HH_API_CONN api_conn;
177 tBTA_HH_CMD_DATA api_sndcmd;
178 tBTA_HH_CBACK_DATA hid_cback;
179 tBTA_HH_STATUS status;
180 tBTA_HH_MAINT_DEV api_maintdev;
181 #if BTA_HH_LE_INCLUDED == TRUE
182 tBTA_HH_LE_CLOSE le_close;
183 tBTA_GATTC_OPEN le_open;
184 tBTA_HH_SCPP_UPDATE le_scpp_update;
188 #if (defined BTA_HH_LE_INCLUDED && BTA_HH_LE_INCLUDED == TRUE)
193 UINT8 inst_id; /* share service instance ID and report instance ID, as
194 hi 4 for service instance ID, low 4 as charatceristic instance ID */
195 tBTA_HH_RPT_TYPE rpt_type;
199 BOOLEAN client_cfg_exist;
200 UINT16 client_cfg_value;
203 #ifndef BTA_HH_LE_RPT_MAX
204 #define BTA_HH_LE_RPT_MAX 10
210 tBTA_HH_LE_RPT report[BTA_HH_LE_RPT_MAX];
212 #define BTA_HH_LE_PROTO_MODE_BIT 0x01
213 #define BTA_HH_LE_CP_BIT 0x02
214 UINT8 option_char; /* control point char exisit or not */
216 BOOLEAN expl_incl_srvc;
217 UINT8 incl_srvc_inst; /* assuming only one included service : battery service */
218 UINT8 cur_expl_char_idx; /* currently discovering service index */
220 #define BTA_HH_LE_REMOTE_WAKE 0x01
221 #define BTA_HH_LE_NORMAL_CONN 0x02
222 UINT8 flag; /* HID Information flag */
225 tBTA_HH_DEV_DESCR descriptor;
227 }tBTA_HH_LE_HID_SRVC;
229 #ifndef BTA_HH_LE_HID_SRVC_MAX
230 #define BTA_HH_LE_HID_SRVC_MAX 1
233 /* convert a HID handle to the LE CB index */
234 #define BTA_HH_GET_LE_CB_IDX(x) (((x) >> 4) - 1)
235 /* convert a GATT connection ID to HID device handle, it is the hi 4 bits of a UINT8 */
236 #define BTA_HH_GET_LE_DEV_HDL(x) (UINT8)(((x) + 1) << 4)
237 /* check to see if th edevice handle is a LE device handle */
238 #define BTA_HH_IS_LE_DEV_HDL(x) ((x) & 0xf0)
239 #define BTA_HH_IS_LE_DEV_HDL_VALID(x) (((x)>>4) < BTA_HH_LE_MAX_KNOWN)
242 /* device control block */
245 tBTA_HH_DEV_DSCP_INFO dscp_info; /* report descriptor and DI information */
246 BD_ADDR addr; /* BD-Addr of the HID device */
247 UINT16 attr_mask; /* attribute mask */
248 UINT16 w4_evt; /* W4_handshake event name */
249 UINT8 index; /* index number referenced to handle index */
250 UINT8 sub_class; /* Cod sub class */
251 UINT8 sec_mask; /* security mask */
252 UINT8 app_id; /* application ID for this connection */
253 UINT8 hid_handle; /* device handle : low 4 bits for regular HID: HID_HOST_MAX_DEVICES can not exceed 15;
254 high 4 bits for LE HID: GATT_MAX_PHY_CHANNEL can not exceed 15 */
255 BOOLEAN vp; /* virtually unplug flag */
256 BOOLEAN in_use; /* control block currently in use */
257 BOOLEAN incoming_conn; /* is incoming connection? */
258 UINT8 incoming_hid_handle; /* temporary handle for incoming connection? */
259 BOOLEAN opened; /* TRUE if device successfully opened HID connection */
260 tBTA_HH_PROTO_MODE mode; /* protocol mode */
261 tBTA_HH_STATE state; /* CB state */
263 #if (BTA_HH_LE_INCLUDED == TRUE)
264 #define BTA_HH_LE_DISC_NONE 0x00
265 #define BTA_HH_LE_DISC_HIDS 0x01
266 #define BTA_HH_LE_DISC_DIS 0x02
267 #define BTA_HH_LE_DISC_SCPS 0x04
270 tBTA_HH_STATUS status;
271 BOOLEAN is_le_device;
272 tBTA_HH_LE_HID_SRVC hid_srvc[BTA_HH_LE_HID_SRVC_MAX];
277 UINT8 cur_srvc_index; /* currently discovering service index */
278 BOOLEAN scps_supported;
280 #define BTA_HH_LE_SCPS_NOTIFY_NONE 0
281 #define BTA_HH_LE_SCPS_NOTIFY_SPT 0x01
282 #define BTA_HH_LE_SCPS_NOTIFY_ENB 0x02
283 UINT8 scps_notify; /* scan refresh supported/notification enabled */
288 /* key board parsing control block */
291 BOOLEAN mod_key[4]; /* ctrl, shift(upper), Alt, GUI */
294 UINT8 last_report[BTA_HH_MAX_RPT_CHARS];
297 /******************************************************************************
298 ** Main Control Block
299 *******************************************************************************/
302 tBTA_HH_KB_CB kb_cb; /* key board control block,
303 suppose BTA will connect
304 to only one keyboard at
306 tBTA_HH_DEV_CB kdev[BTA_HH_MAX_DEVICE]; /* device control block */
307 tBTA_HH_DEV_CB* p_cur; /* current device control
308 block idx, used in sdp */
309 UINT8 cb_index[BTA_HH_MAX_KNOWN]; /* maintain a CB index
311 #if (defined BTA_HH_LE_INCLUDED && BTA_HH_LE_INCLUDED == TRUE)
312 UINT8 le_cb_index[BTA_HH_MAX_DEVICE]; /* maintain a CB index map to LE dev handle */
313 tBTA_GATTC_IF gatt_if;
315 tBTA_HH_CBACK *p_cback; /* Application callbacks */
316 tSDP_DISCOVERY_DB* p_disc_db;
317 UINT8 trace_level; /* tracing level */
318 UINT8 cnt_num; /* connected device number */
319 BOOLEAN w4_disable; /* w4 disable flag */
323 #if BTA_DYNAMIC_MEMORY == FALSE
324 extern tBTA_HH_CB bta_hh_cb;
326 extern tBTA_HH_CB *bta_hh_cb_ptr;
327 #define bta_hh_cb (*bta_hh_cb_ptr)
330 /* from bta_hh_cfg.c */
331 extern tBTA_HH_CFG *p_bta_hh_cfg;
333 /*****************************************************************************
334 ** Function prototypes
335 *****************************************************************************/
336 extern BOOLEAN bta_hh_hdl_event(BT_HDR *p_msg);
337 extern void bta_hh_sm_execute(tBTA_HH_DEV_CB *p_cb, UINT16 event,
338 tBTA_HH_DATA *p_data);
340 /* action functions */
341 extern void bta_hh_api_disc_act(tBTA_HH_DEV_CB *p_cb, tBTA_HH_DATA *p_data);
342 extern void bta_hh_open_act(tBTA_HH_DEV_CB *p_cb, tBTA_HH_DATA *p_data);
343 extern void bta_hh_close_act(tBTA_HH_DEV_CB *p_cb, tBTA_HH_DATA *p_data);
344 extern void bta_hh_data_act(tBTA_HH_DEV_CB *p_cb, tBTA_HH_DATA * p_data);
345 extern void bta_hh_ctrl_dat_act(tBTA_HH_DEV_CB *p_cb, tBTA_HH_DATA * p_data);
346 extern void bta_hh_start_sdp(tBTA_HH_DEV_CB *p_cb, tBTA_HH_DATA *p_data);
347 extern void bta_hh_sdp_cmpl(tBTA_HH_DEV_CB *p_cb, tBTA_HH_DATA *p_data);
348 extern void bta_hh_write_dev_act(tBTA_HH_DEV_CB *p_cb, tBTA_HH_DATA *p_data);
349 extern void bta_hh_get_dscp_act(tBTA_HH_DEV_CB *p_cb, tBTA_HH_DATA *p_data);
350 extern void bta_hh_handsk_act(tBTA_HH_DEV_CB *p_cb, tBTA_HH_DATA *p_data);
351 extern void bta_hh_maint_dev_act(tBTA_HH_DEV_CB *p_cb, tBTA_HH_DATA *p_data);
352 extern void bta_hh_open_cmpl_act(tBTA_HH_DEV_CB *p_cb, tBTA_HH_DATA *p_data);
353 extern void bta_hh_open_failure(tBTA_HH_DEV_CB *p_cb, tBTA_HH_DATA *p_data);
355 /* utility functions */
356 extern UINT8 bta_hh_find_cb(BD_ADDR bda);
357 extern void bta_hh_parse_keybd_rpt(tBTA_HH_BOOT_RPT *p_kb_data,
358 UINT8 *p_report, UINT16 report_len);
359 extern void bta_hh_parse_mice_rpt(tBTA_HH_BOOT_RPT *p_kb_data,
360 UINT8 *p_report, UINT16 report_len);
361 extern BOOLEAN bta_hh_tod_spt(tBTA_HH_DEV_CB *p_cb,UINT8 sub_class);
362 extern void bta_hh_clean_up_kdev(tBTA_HH_DEV_CB *p_cb);
364 extern void bta_hh_add_device_to_list(tBTA_HH_DEV_CB *p_cb, UINT8 handle,
366 tHID_DEV_DSCP_INFO *p_dscp_info,
367 UINT8 sub_class, UINT16 max_latency, UINT16 min_tout, UINT8 app_id);
368 extern void bta_hh_update_di_info(tBTA_HH_DEV_CB *p_cb, UINT16 vendor_id, UINT16 product_id,
369 UINT16 version, UINT8 flag);
370 extern void bta_hh_cleanup_disable(tBTA_HH_STATUS status);
372 extern UINT8 bta_hh_dev_handle_to_cb_idx(UINT8 dev_handle);
374 /* action functions used outside state machine */
375 extern void bta_hh_api_enable(tBTA_HH_DATA *p_data);
376 extern void bta_hh_api_disable(void);
377 extern void bta_hh_disc_cmpl(void);
379 extern tBTA_HH_STATUS bta_hh_read_ssr_param(BD_ADDR bd_addr, UINT16 *p_max_ssr_lat, UINT16 *p_min_ssr_tout);
381 /* functions for LE HID */
382 extern void bta_hh_le_enable(void);
383 extern void bta_hh_le_deregister(void);
384 extern BOOLEAN bta_hh_is_le_device(tBTA_HH_DEV_CB *p_cb, BD_ADDR remote_bda);
385 extern void bta_hh_le_open_conn(tBTA_HH_DEV_CB *p_cb, BD_ADDR remote_bda);
386 extern void bta_hh_le_api_disc_act(tBTA_HH_DEV_CB *p_cb);
387 extern void bta_hh_le_get_dscp_act(tBTA_HH_DEV_CB *p_cb);
388 extern void bta_hh_le_write_dev_act(tBTA_HH_DEV_CB *p_cb, tBTA_HH_DATA *p_data);
389 extern UINT8 bta_hh_le_add_device(tBTA_HH_DEV_CB *p_cb, tBTA_HH_MAINT_DEV *p_dev_info);
390 extern void bta_hh_le_remove_dev_bg_conn(tBTA_HH_DEV_CB *p_cb);
391 extern void bta_hh_le_open_fail(tBTA_HH_DEV_CB *p_cb, tBTA_HH_DATA *p_data);
392 extern void bta_hh_gatt_open(tBTA_HH_DEV_CB *p_cb, tBTA_HH_DATA *p_data);
393 extern void bta_hh_gatt_close(tBTA_HH_DEV_CB *p_cb, tBTA_HH_DATA *p_data);
394 extern void bta_hh_start_security(tBTA_HH_DEV_CB *p_cb, tBTA_HH_DATA *p_buf);
395 extern void bta_hh_start_srvc_discovery(tBTA_HH_DEV_CB *p_cb, tBTA_HH_DATA *p_buf);
396 extern void bta_hh_w4_le_read_char_cmpl(tBTA_HH_DEV_CB *p_cb, tBTA_HH_DATA *p_buf);
397 extern void bta_hh_le_read_char_cmpl(tBTA_HH_DEV_CB *p_cb, tBTA_HH_DATA *p_buf);
398 extern void bta_hh_w4_le_read_descr_cmpl(tBTA_HH_DEV_CB *p_cb, tBTA_HH_DATA *p_buf);
399 extern void bta_hh_le_read_descr_cmpl(tBTA_HH_DEV_CB *p_cb, tBTA_HH_DATA *p_buf);
400 extern void bta_hh_w4_le_write_cmpl(tBTA_HH_DEV_CB *p_cb, tBTA_HH_DATA *p_buf);
401 extern void bta_hh_le_write_cmpl(tBTA_HH_DEV_CB *p_cb, tBTA_HH_DATA *p_buf);
402 extern void bta_hh_le_write_char_descr_cmpl(tBTA_HH_DEV_CB *p_cb, tBTA_HH_DATA *p_buf);
403 extern void bta_hh_start_security(tBTA_HH_DEV_CB *p_cb, tBTA_HH_DATA *p_buf);
404 extern void bta_hh_security_cmpl(tBTA_HH_DEV_CB *p_cb, tBTA_HH_DATA *p_buf);
405 extern void bta_hh_le_update_scpp(tBTA_HH_DEV_CB *p_cb, tBTA_HH_DATA *p_buf);
409 extern void bta_hh_trace_dev_db(void);