/****************************************************************************** * * Copyright 2003-2012 Broadcom Corporation * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at: * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. * ******************************************************************************/ /****************************************************************************** * * This is the private interface file for the BTA device manager. * ******************************************************************************/ #ifndef BTA_DM_INT_H #define BTA_DM_INT_H #include #include "bt_target.h" #include "bta_sys.h" #include "bta_gatt_api.h" /***************************************************************************** * Constants and data types ****************************************************************************/ #define BTA_COPY_DEVICE_CLASS(coddst, codsrc) \ { \ ((uint8_t*)(coddst))[0] = ((uint8_t*)(codsrc))[0]; \ ((uint8_t*)(coddst))[1] = ((uint8_t*)(codsrc))[1]; \ ((uint8_t*)(coddst))[2] = ((uint8_t*)(codsrc))[2]; \ } #define BTA_DM_MSG_LEN 50 #define BTA_SERVICE_ID_TO_SERVICE_MASK(id) (1 << (id)) /* DM search events */ enum { /* DM search API events */ BTA_DM_API_SEARCH_EVT = BTA_SYS_EVT_START(BTA_ID_DM_SEARCH), BTA_DM_API_SEARCH_CANCEL_EVT, BTA_DM_API_DISCOVER_EVT, BTA_DM_INQUIRY_CMPL_EVT, BTA_DM_REMT_NAME_EVT, BTA_DM_SDP_RESULT_EVT, BTA_DM_SEARCH_CMPL_EVT, BTA_DM_DISCOVERY_RESULT_EVT, BTA_DM_API_DI_DISCOVER_EVT, BTA_DM_DISC_CLOSE_TOUT_EVT }; enum { BTA_DM_RS_NONE, /* straight API call */ BTA_DM_RS_OK, /* the role switch result - successful */ BTA_DM_RS_FAIL /* the role switch result - failed */ }; typedef uint8_t tBTA_DM_RS_RES; /* data type for BTA_DM_API_SEARCH_EVT */ typedef struct { BT_HDR hdr; tBTA_DM_INQ inq_params; tBTA_SERVICE_MASK services; tBTA_DM_SEARCH_CBACK* p_cback; tBTA_DM_RS_RES rs_res; uint8_t num_uuid; bluetooth::Uuid* p_uuid; } tBTA_DM_API_SEARCH; /* data type for BTA_DM_API_DISCOVER_EVT */ typedef struct { BT_HDR hdr; RawAddress bd_addr; tBTA_SERVICE_MASK services; tBTA_DM_SEARCH_CBACK* p_cback; bool sdp_search; tBTA_TRANSPORT transport; uint8_t num_uuid; bluetooth::Uuid* p_uuid; bluetooth::Uuid uuid; } tBTA_DM_API_DISCOVER; /* data type for BTA_DM_API_DI_DISC_EVT */ typedef struct { BT_HDR hdr; RawAddress bd_addr; tBTA_DISCOVERY_DB* p_sdp_db; uint32_t len; tBTA_DM_SEARCH_CBACK* p_cback; } tBTA_DM_API_DI_DISC; typedef struct { RawAddress bd_addr; bool accept; uint8_t pin_len; uint8_t p_pin[PIN_CODE_LEN]; } tBTA_DM_API_PIN_REPLY; typedef struct { BT_HDR hdr; RawAddress bd_addr; tBTA_IO_CAP io_cap; tBTA_OOB_DATA oob_data; tBTA_AUTH_REQ auth_req; } tBTA_DM_CI_IO_REQ; typedef struct { RawAddress bd_addr; BT_OCTET16 c; BT_OCTET16 r; bool accept; } tBTA_DM_CI_RMT_OOB; /* data type for BTA_DM_REMT_NAME_EVT */ typedef struct { BT_HDR hdr; tBTA_DM_SEARCH result; } tBTA_DM_REM_NAME; /* data type for tBTA_DM_DISC_RESULT */ typedef struct { BT_HDR hdr; tBTA_DM_SEARCH result; } tBTA_DM_DISC_RESULT; /* data type for BTA_DM_INQUIRY_CMPL_EVT */ typedef struct { BT_HDR hdr; uint8_t num; } tBTA_DM_INQUIRY_CMPL; /* data type for BTA_DM_SDP_RESULT_EVT */ typedef struct { BT_HDR hdr; uint16_t sdp_result; } tBTA_DM_SDP_RESULT; typedef struct { RawAddress bd_addr; DEV_CLASS dc; LINK_KEY link_key; tBTA_SERVICE_MASK tm; bool is_trusted; uint8_t key_type; tBTA_IO_CAP io_cap; bool link_key_known; bool dc_known; BD_NAME bd_name; uint8_t features[BTA_FEATURE_BYTES_PER_PAGE * (BTA_EXT_FEATURES_PAGE_MAX + 1)]; uint8_t pin_length; } tBTA_DM_API_ADD_DEVICE; typedef struct { BT_HDR hdr; bool enable; } tBTA_DM_API_BLE_FEATURE; /* union of all data types */ typedef union { /* GKI event buffer header */ BT_HDR hdr; tBTA_DM_API_SEARCH search; tBTA_DM_API_DISCOVER discover; tBTA_DM_REM_NAME rem_name; tBTA_DM_DISC_RESULT disc_result; tBTA_DM_INQUIRY_CMPL inq_cmpl; tBTA_DM_SDP_RESULT sdp_event; tBTA_DM_API_DI_DISC di_disc; } tBTA_DM_MSG; #define BTA_DM_NUM_PEER_DEVICE 7 #define BTA_DM_NOT_CONNECTED 0 #define BTA_DM_CONNECTED 1 #define BTA_DM_UNPAIRING 2 typedef uint8_t tBTA_DM_CONN_STATE; #define BTA_DM_DI_NONE 0x00 /* nothing special */ #define BTA_DM_DI_USE_SSR \ 0x10 /* set this bit if ssr is supported for this link */ #define BTA_DM_DI_AV_ACTIVE \ 0x20 /* set this bit if AV is active for this link */ #define BTA_DM_DI_SET_SNIFF \ 0x01 /* set this bit if call BTM_SetPowerMode(sniff) */ #define BTA_DM_DI_INT_SNIFF \ 0x02 /* set this bit if call BTM_SetPowerMode(sniff) & enter sniff mode */ #define BTA_DM_DI_ACP_SNIFF 0x04 /* set this bit if peer init sniff */ typedef uint8_t tBTA_DM_DEV_INFO; /* set power mode request type */ #define BTA_DM_PM_RESTART 1 #define BTA_DM_PM_NEW_REQ 2 #define BTA_DM_PM_EXECUTE 3 typedef uint8_t tBTA_DM_PM_REQ; typedef struct { RawAddress peer_bdaddr; uint16_t link_policy; tBTA_DM_CONN_STATE conn_state; tBTA_PREF_ROLES pref_role; bool in_use; tBTA_DM_DEV_INFO info; tBTA_DM_ENCRYPT_CBACK* p_encrypt_cback; #if (BTM_SSR_INCLUDED == TRUE) tBTM_PM_STATUS prev_low; /* previous low power mode used */ #endif tBTA_DM_PM_ACTION pm_mode_attempted; tBTA_DM_PM_ACTION pm_mode_failed; bool remove_dev_pending; uint16_t conn_handle; tBT_TRANSPORT transport; } tBTA_DM_PEER_DEVICE; /* structure to store list of active connections */ typedef struct { tBTA_DM_PEER_DEVICE peer_device[BTA_DM_NUM_PEER_DEVICE]; uint8_t count; uint8_t le_count; } tBTA_DM_ACTIVE_LINK; typedef struct { RawAddress peer_bdaddr; tBTA_SYS_ID id; uint8_t app_id; tBTA_SYS_CONN_STATUS state; bool new_request; } tBTA_DM_SRVCS; #ifndef BTA_DM_NUM_CONN_SRVS #define BTA_DM_NUM_CONN_SRVS 10 #endif typedef struct { uint8_t count; tBTA_DM_SRVCS conn_srvc[BTA_DM_NUM_CONN_SRVS]; } tBTA_DM_CONNECTED_SRVCS; typedef struct { #define BTA_DM_PM_SNIFF_TIMER_IDX 0 #define BTA_DM_PM_PARK_TIMER_IDX 1 #define BTA_DM_PM_SUSPEND_TIMER_IDX 2 #define BTA_DM_PM_MODE_TIMER_MAX 3 /* * Keep three different timers for PARK, SNIFF and SUSPEND if TBFC is * supported. */ alarm_t* timer[BTA_DM_PM_MODE_TIMER_MAX]; uint8_t srvc_id[BTA_DM_PM_MODE_TIMER_MAX]; uint8_t pm_action[BTA_DM_PM_MODE_TIMER_MAX]; uint8_t active; /* number of active timer */ RawAddress peer_bdaddr; bool in_use; } tBTA_PM_TIMER; extern tBTA_DM_CONNECTED_SRVCS bta_dm_conn_srvcs; #define BTA_DM_NUM_PM_TIMER 7 /* DM control block */ typedef struct { bool is_bta_dm_active; tBTA_DM_ACTIVE_LINK device_list; tBTA_DM_SEC_CBACK* p_sec_cback; tBTA_BLE_ENERGY_INFO_CBACK* p_energy_info_cback; uint16_t state; bool disabling; alarm_t* disable_timer; uint32_t wbt_sdp_handle; /* WIDCOMM Extensions SDP record handle */ uint8_t wbt_scn; /* WIDCOMM Extensions SCN */ uint8_t num_master_only; uint8_t pm_id; tBTA_PM_TIMER pm_timer[BTA_DM_NUM_PM_TIMER]; uint32_t role_policy_mask; /* the bits set indicates the modules that wants to remove role switch from the default link policy */ uint16_t cur_policy; /* current default link policy */ uint16_t rs_event; /* the event waiting for role switch */ uint8_t cur_av_count; /* current AV connecions */ bool disable_pair_mode; /* disable pair mode or not */ bool conn_paired_only; /* allow connectable to paired device only or not */ tBTA_DM_API_SEARCH search_msg; uint16_t page_scan_interval; uint16_t page_scan_window; uint16_t inquiry_scan_interval; uint16_t inquiry_scan_window; /* Storage for pin code request parameters */ RawAddress pin_bd_addr; DEV_CLASS pin_dev_class; tBTA_DM_SEC_EVT pin_evt; tBTA_IO_CAP loc_io_caps; /* IO Capabilities of local device */ tBTA_IO_CAP rmt_io_caps; /* IO Capabilities of remote device */ tBTA_AUTH_REQ loc_auth_req; /* Authentication required for local device */ tBTA_AUTH_REQ rmt_auth_req; uint32_t num_val; /* the numeric value for comparison. If just_works, do not show this number to UI */ bool just_works; /* true, if "Just Works" association model */ #if (BTA_EIR_CANNED_UUID_LIST != TRUE) /* store UUID list for EIR */ uint32_t eir_uuid[BTM_EIR_SERVICE_ARRAY_SIZE]; #if (BTA_EIR_SERVER_NUM_CUSTOM_UUID > 0) bluetooth::Uuid custom_uuid[BTA_EIR_SERVER_NUM_CUSTOM_UUID]; #endif #endif tBTA_DM_ENCRYPT_CBACK* p_encrypt_cback; alarm_t* switch_delay_timer; } tBTA_DM_CB; /* DM search control block */ typedef struct { tBTA_DM_SEARCH_CBACK* p_search_cback; tBTM_INQ_INFO* p_btm_inq_info; tBTA_SERVICE_MASK services; tBTA_SERVICE_MASK services_to_search; tBTA_SERVICE_MASK services_found; tSDP_DISCOVERY_DB* p_sdp_db; uint16_t state; RawAddress peer_bdaddr; bool name_discover_done; BD_NAME peer_name; alarm_t* search_timer; uint8_t service_index; tBTA_DM_MSG* p_search_queue; /* search or discover commands during search cancel stored here */ bool wait_disc; bool sdp_results; bluetooth::Uuid uuid; uint8_t peer_scn; bool sdp_search; bool cancel_pending; /* inquiry cancel is pending */ tBTA_TRANSPORT transport; tBTA_DM_SEARCH_CBACK* p_scan_cback; tGATT_IF client_if; uint8_t num_uuid; bluetooth::Uuid* p_srvc_uuid; uint8_t uuid_to_search; bool gatt_disc_active; uint16_t conn_id; uint8_t* p_ble_rawdata; uint32_t ble_raw_size; uint32_t ble_raw_used; alarm_t* gatt_close_timer; /* GATT channel close delay timer */ RawAddress pending_close_bda; /* pending GATT channel remote device address */ } tBTA_DM_SEARCH_CB; /* DI control block */ typedef struct { tSDP_DISCOVERY_DB* p_di_db; /* pointer to the DI discovery database */ uint8_t di_num; /* total local DI record number */ uint32_t di_handle[BTA_DI_NUM_MAX]; /* local DI record handle, the first one is primary record */ } tBTA_DM_DI_CB; /* DM search state */ enum { BTA_DM_SEARCH_IDLE, BTA_DM_SEARCH_ACTIVE, BTA_DM_SEARCH_CANCELLING, BTA_DM_DISCOVER_ACTIVE }; typedef struct { DEV_CLASS dev_class; /* local device class */ uint16_t policy_settings; /* link policy setting hold, sniff, park, MS switch */ uint16_t page_timeout; /* timeout for page in slots */ uint16_t link_timeout; /* link supervision timeout in slots */ bool avoid_scatter; /* true to avoid scatternet when av is streaming (be the master) */ } tBTA_DM_CFG; extern const uint32_t bta_service_id_to_btm_srv_id_lkup_tbl[]; typedef struct { uint8_t id; uint8_t app_id; uint8_t cfg; } tBTA_DM_RM; extern const tBTA_DM_CFG* p_bta_dm_cfg; extern const tBTA_DM_RM* p_bta_dm_rm_cfg; typedef struct { uint8_t id; uint8_t app_id; uint8_t spec_idx; /* index of spec table to use */ } tBTA_DM_PM_CFG; typedef struct { tBTA_DM_PM_ACTION power_mode; uint16_t timeout; } tBTA_DM_PM_ACTN; typedef struct { uint8_t allow_mask; /* mask of sniff/hold/park modes to allow */ #if (BTM_SSR_INCLUDED == TRUE) uint8_t ssr; /* set SSR on conn open/unpark */ #endif tBTA_DM_PM_ACTN actn_tbl[BTA_DM_PM_NUM_EVTS][2]; } tBTA_DM_PM_SPEC; typedef struct { uint16_t max_lat; uint16_t min_rmt_to; uint16_t min_loc_to; } tBTA_DM_SSR_SPEC; typedef struct { uint16_t manufacturer; uint16_t lmp_sub_version; uint8_t lmp_version; } tBTA_DM_LMP_VER_INFO; extern const uint16_t bta_service_id_to_uuid_lkup_tbl[]; extern const tBTA_DM_PM_CFG* p_bta_dm_pm_cfg; extern const tBTA_DM_PM_SPEC* p_bta_dm_pm_spec; extern const tBTM_PM_PWR_MD* p_bta_dm_pm_md; #if (BTM_SSR_INCLUDED == TRUE) extern tBTA_DM_SSR_SPEC* p_bta_dm_ssr_spec; #endif /* update dynamic BRCM Aware EIR data */ extern const tBTA_DM_EIR_CONF bta_dm_eir_cfg; extern const tBTA_DM_EIR_CONF* p_bta_dm_eir_cfg; /* DM control block */ extern tBTA_DM_CB bta_dm_cb; /* DM search control block */ extern tBTA_DM_SEARCH_CB bta_dm_search_cb; /* DI control block */ extern tBTA_DM_DI_CB bta_dm_di_cb; extern bool bta_dm_search_sm_execute(BT_HDR* p_msg); extern void bta_dm_search_sm_disable(void); extern void bta_dm_enable(tBTA_DM_SEC_CBACK*); extern void bta_dm_disable(); extern void bta_dm_init_cb(void); extern void bta_dm_set_dev_name(const std::vector&); extern void bta_dm_set_visibility(tBTA_DM_DISC, tBTA_DM_CONN, uint8_t, uint8_t); extern void bta_dm_set_scan_config(tBTA_DM_MSG* p_data); extern void bta_dm_vendor_spec_command(tBTA_DM_MSG* p_data); extern void bta_dm_bond(const RawAddress&, tBTA_TRANSPORT); extern void bta_dm_bond_cancel(const RawAddress&); extern void bta_dm_pin_reply(std::unique_ptr msg); extern void bta_dm_add_device(std::unique_ptr msg); extern void bta_dm_remove_device(const RawAddress& bd_addr); extern void bta_dm_close_acl(const RawAddress&, bool, tBTA_TRANSPORT); extern void bta_dm_pm_btm_status(const RawAddress&, tBTM_PM_STATUS, uint16_t, uint8_t); extern void bta_dm_pm_timer(const RawAddress&, tBTA_DM_PM_ACTION); extern void bta_dm_add_ampkey(tBTA_DM_MSG* p_data); extern void bta_dm_add_blekey(const RawAddress& bd_addr, tBTA_LE_KEY_VALUE blekey, tBTA_LE_KEY_TYPE key_type); extern void bta_dm_add_ble_device(const RawAddress& bd_addr, tBLE_ADDR_TYPE addr_type, tBT_DEVICE_TYPE dev_type); extern void bta_dm_ble_passkey_reply(const RawAddress& bd_addr, bool accept, uint32_t passkey); extern void bta_dm_ble_confirm_reply(const RawAddress&, bool); extern void bta_dm_ble_set_conn_params(const RawAddress&, uint16_t, uint16_t, uint16_t, uint16_t); extern void bta_dm_ble_set_conn_scan_params(uint32_t, uint32_t); extern void bta_dm_close_gatt_conn(tBTA_DM_MSG* p_data); extern void bta_dm_ble_observe(bool, uint8_t, tBTA_DM_SEARCH_CBACK*); extern void bta_dm_ble_update_conn_params(const RawAddress&, uint16_t, uint16_t, uint16_t, uint16_t, uint16_t, uint16_t); extern void bta_dm_ble_config_local_privacy(bool); extern void bta_dm_ble_set_adv_params(uint16_t adv_int_min, uint16_t adv_int_max, tBLE_BD_ADDR* p_dir_bda); extern void bta_dm_ble_set_data_length(const RawAddress&, uint16_t); extern void bta_dm_ble_get_energy_info(tBTA_BLE_ENERGY_INFO_CBACK*); extern void bta_dm_set_encryption(const RawAddress&, tBTA_TRANSPORT, tBTA_DM_ENCRYPT_CBACK*, tBTA_DM_BLE_SEC_ACT); extern void bta_dm_confirm(const RawAddress&, bool); extern void bta_dm_ci_io_req_act(const RawAddress& bd_addr, tBTA_IO_CAP io_cap, tBTA_OOB_DATA oob_data, tBTA_AUTH_REQ auth_req); extern void bta_dm_ci_rmt_oob_act(std::unique_ptr msg); extern void bta_dm_init_pm(void); extern void bta_dm_disable_pm(void); extern uint8_t bta_dm_get_av_count(void); extern void bta_dm_search_start(tBTA_DM_MSG* p_data); extern void bta_dm_search_cancel(tBTA_DM_MSG* p_data); extern void bta_dm_discover(tBTA_DM_MSG* p_data); extern void bta_dm_di_disc(tBTA_DM_MSG* p_data); extern void bta_dm_inq_cmpl(tBTA_DM_MSG* p_data); extern void bta_dm_rmt_name(tBTA_DM_MSG* p_data); extern void bta_dm_sdp_result(tBTA_DM_MSG* p_data); extern void bta_dm_search_cmpl(tBTA_DM_MSG* p_data); extern void bta_dm_free_sdp_db(tBTA_DM_MSG* p_data); extern void bta_dm_disc_result(tBTA_DM_MSG* p_data); extern void bta_dm_search_result(tBTA_DM_MSG* p_data); extern void bta_dm_discovery_cmpl(tBTA_DM_MSG* p_data); extern void bta_dm_queue_search(tBTA_DM_MSG* p_data); extern void bta_dm_queue_disc(tBTA_DM_MSG* p_data); extern void bta_dm_search_clear_queue(tBTA_DM_MSG* p_data); extern void bta_dm_search_cancel_cmpl(tBTA_DM_MSG* p_data); extern void bta_dm_search_cancel_notify(tBTA_DM_MSG* p_data); extern void bta_dm_search_cancel_transac_cmpl(tBTA_DM_MSG* p_data); extern void bta_dm_disc_rmt_name(tBTA_DM_MSG* p_data); extern tBTA_DM_PEER_DEVICE* bta_dm_find_peer_device( const RawAddress& peer_addr); void bta_dm_eir_update_uuid(uint16_t uuid16, bool adding); extern void bta_dm_remove_all_acl(const tBTA_DM_LINK_TYPE); #endif /* BTA_DM_INT_H */