/****************************************************************************** * * Copyright 2009-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. * ******************************************************************************/ #ifndef BTIF_HH_H #define BTIF_HH_H #include #include #include #include #include #include #include #include "bta/include/bta_hh_api.h" #include "macros.h" #include "osi/include/alarm.h" #include "osi/include/fixed_queue.h" #include "types/ble_address_with_type.h" #include "types/raw_address.h" /******************************************************************************* * Constants & Macros ******************************************************************************/ #define BTIF_HH_MAX_HID 8 #define BTIF_HH_MAX_ADDED_DEV 32 #define BTIF_HH_MAX_KEYSTATES 3 #define BTIF_HH_KEYSTATE_MASK_NUMLOCK 0x01 #define BTIF_HH_KEYSTATE_MASK_CAPSLOCK 0x02 #define BTIF_HH_KEYSTATE_MASK_SCROLLLOCK 0x04 #define BTIF_HH_MAX_POLLING_ATTEMPTS 10 #define BTIF_HH_POLLING_SLEEP_DURATION_US 5000 #ifndef ENABLE_UHID_SET_REPORT #if defined(__ANDROID__) || defined(TARGET_FLOSS) #define ENABLE_UHID_SET_REPORT 1 #else #define ENABLE_UHID_SET_REPORT 0 #endif #endif /******************************************************************************* * Type definitions and return values ******************************************************************************/ typedef enum : unsigned { BTIF_HH_DISABLED = 0, BTIF_HH_ENABLED, BTIF_HH_DISABLING, } BTIF_HH_STATUS; inline std::string btif_hh_status_text(const BTIF_HH_STATUS& status) { switch (status) { CASE_RETURN_TEXT(BTIF_HH_DISABLED); CASE_RETURN_TEXT(BTIF_HH_ENABLED); CASE_RETURN_TEXT(BTIF_HH_DISABLING); default: return base::StringPrintf("UNKNOWN[%u]", status); } } /* Uhid thread has exclusive access to this block. */ typedef struct { int fd; // for interfacing with uhid int internal_recv_fd; // for receiving internal events in uhid thread int internal_send_fd; // for passing to other threads so they can send // internal events uint8_t dev_handle; tAclLinkSpec link_spec; uint8_t hh_keep_polling; // Deprecated with the aflags hid_report_queuing. // TODO: remove after launching the aflag. bool ready_for_data; fixed_queue_t* get_rpt_id_queue; #if ENABLE_UHID_SET_REPORT fixed_queue_t* set_rpt_id_queue; #endif // ENABLE_UHID_SET_REPORT fixed_queue_t* input_queue; // to store the inputs before uhid is ready. alarm_t* delayed_ready_timer; // to delay marking a device as ready, give input chance to listen. alarm_t* ready_disconn_timer; // to disconnect device if still not ready after some time. } btif_hh_uhid_t; /* Control block to maintain properties of devices */ typedef struct { bthh_connection_state_t dev_status; uint8_t dev_handle; tAclLinkSpec link_spec; tBTA_HH_ATTR_MASK attr_mask; uint8_t sub_class; uint8_t app_id; int internal_send_fd; // for sending internal events from btif pthread_t hh_poll_thread_id; alarm_t* vup_timer; bool local_vup; // Indicated locally initiated VUP btif_hh_uhid_t uhid; // Deprecated with the aflags hid_report_queuing. // TODO: remove after launching the aflag. } btif_hh_device_t; /* Control block to maintain properties of devices */ typedef struct { uint8_t dev_handle; tAclLinkSpec link_spec; tBTA_HH_ATTR_MASK attr_mask; bool reconnect_allowed; // Connection policy } btif_hh_added_device_t; /** * BTIF-HH control block to maintain added devices and currently * connected hid devices */ typedef struct { BTIF_HH_STATUS status; btif_hh_device_t devices[BTIF_HH_MAX_HID]; uint32_t device_num; btif_hh_added_device_t added_devices[BTIF_HH_MAX_ADDED_DEV]; bool service_dereg_active; std::list pending_connections; } btif_hh_cb_t; /******************************************************************************* * Functions ******************************************************************************/ extern btif_hh_cb_t btif_hh_cb; const bthh_interface_t* btif_hh_get_interface(); bt_status_t btif_hh_execute_service(bool b_enable); btif_hh_device_t* btif_hh_find_connected_dev_by_handle(uint8_t handle); btif_hh_device_t* btif_hh_find_dev_by_handle(uint8_t handle); btif_hh_device_t* btif_hh_find_empty_dev(void); bt_status_t btif_hh_virtual_unplug(const tAclLinkSpec& link_spec); bt_status_t btif_hh_connect(const tAclLinkSpec& link_spec); void btif_hh_remove_device(const tAclLinkSpec& link_spec); void btif_hh_setreport(btif_hh_uhid_t* p_uhid, bthh_report_type_t r_type, uint16_t size, uint8_t* report); void btif_hh_senddata(btif_hh_uhid_t* p_uhid, uint16_t size, uint8_t* report); void btif_hh_getreport(btif_hh_uhid_t* p_uhid, bthh_report_type_t r_type, uint8_t reportId, uint16_t bufferSize); void btif_hh_service_registration(bool enable); void btif_hh_load_bonded_dev(const tAclLinkSpec& link_spec, tBTA_HH_ATTR_MASK attr_mask, uint8_t sub_class, uint8_t app_id, tBTA_HH_DEV_DSCP_INFO dscp_info, bool reconnect_allowed); int bta_hh_co_write(int fd, uint8_t* rpt, uint16_t len); void bta_hh_co_close(btif_hh_device_t* p_dev); void bta_hh_co_send_hid_info(btif_hh_device_t* p_dev, const char* dev_name, uint16_t vendor_id, uint16_t product_id, uint16_t version, uint8_t ctry_code, uint16_t dscp_len, uint8_t* p_dscp); void DumpsysHid(int fd); namespace bluetooth::legacy::testing { void bte_hh_evt(tBTA_HH_EVT event, tBTA_HH* p_data); } // namespace bluetooth::legacy::testing namespace std { template <> struct formatter : enum_formatter {}; } // namespace std #endif