The existing Bluetooth examples are split as: 1. examples/bluetooth/bluedroid - Bluedroid Host (BT + BLE) examples a. examples/bluetooth/bluedroid/classic_bt - Classic BT examples b. examples/bluetooth/bluedroid/ble - BLE examples c. examples/bluetooth/bluedroid/coex - Classic BT and BLE coex examples d. examples/bluetooth/bluedroid/hci - VHCI and HCI UART examples i. Rename ble_adv to controller_vhci_ble_adv and move it in hci folder 2. examples/bluetooth/nimble - NimBLE BLE Host + NimBLE Mesh examples 3. examples/bluetooth/esp_ble_mesh - ESP BLE Mesh examples 4. Update documentation references
167 lines
4.9 KiB
C
167 lines
4.9 KiB
C
// Copyright 2017-2018 Espressif Systems (Shanghai) PTE LTD
|
|
//
|
|
// 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 __ESP_HIDD_API_H__
|
|
#define __ESP_HIDD_API_H__
|
|
|
|
#include "esp_bt_defs.h"
|
|
#include "esp_gatt_defs.h"
|
|
#include "esp_err.h"
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
typedef enum {
|
|
ESP_HIDD_EVENT_REG_FINISH = 0,
|
|
ESP_BAT_EVENT_REG,
|
|
ESP_HIDD_EVENT_DEINIT_FINISH,
|
|
ESP_HIDD_EVENT_BLE_CONNECT,
|
|
ESP_HIDD_EVENT_BLE_DISCONNECT,
|
|
ESP_HIDD_EVENT_BLE_VENDOR_REPORT_WRITE_EVT,
|
|
} esp_hidd_cb_event_t;
|
|
|
|
/// HID config status
|
|
typedef enum {
|
|
ESP_HIDD_STA_CONN_SUCCESS = 0x00,
|
|
ESP_HIDD_STA_CONN_FAIL = 0x01,
|
|
} esp_hidd_sta_conn_state_t;
|
|
|
|
/// HID init status
|
|
typedef enum {
|
|
ESP_HIDD_INIT_OK = 0,
|
|
ESP_HIDD_INIT_FAILED = 1,
|
|
} esp_hidd_init_state_t;
|
|
|
|
/// HID deinit status
|
|
typedef enum {
|
|
ESP_HIDD_DEINIT_OK = 0,
|
|
ESP_HIDD_DEINIT_FAILED = 0,
|
|
} esp_hidd_deinit_state_t;
|
|
|
|
#define LEFT_CONTROL_KEY_MASK (1 >> 0)
|
|
#define LEFT_SHIFT_KEY_MASK (1 >> 1)
|
|
#define LEFT_ALT_KEY_MASK (1 >> 2)
|
|
#define LEFT_GUI_KEY_MASK (1 >> 3)
|
|
#define RIGHT_CONTROL_KEY_MASK (1 >> 4)
|
|
#define RIGHT_SHIFT_KEY_MASK (1 >> 5)
|
|
#define RIGHT_ALT_KEY_MASK (1 >> 6)
|
|
#define RIGHT_GUI_KEY_MASK (1 >> 7)
|
|
typedef uint8_t key_mask_t;
|
|
/**
|
|
* @brief HIDD callback parameters union
|
|
*/
|
|
typedef union {
|
|
/**
|
|
* @brief ESP_HIDD_EVENT_INIT_FINISH
|
|
*/
|
|
struct hidd_init_finish_evt_param {
|
|
esp_hidd_init_state_t state; /*!< Initial status */
|
|
esp_gatt_if_t gatts_if;
|
|
} init_finish; /*!< HID callback param of ESP_HIDD_EVENT_INIT_FINISH */
|
|
|
|
/**
|
|
* @brief ESP_HIDD_EVENT_DEINIT_FINISH
|
|
*/
|
|
struct hidd_deinit_finish_evt_param {
|
|
esp_hidd_deinit_state_t state; /*!< De-initial status */
|
|
} deinit_finish; /*!< HID callback param of ESP_HIDD_EVENT_DEINIT_FINISH */
|
|
|
|
/**
|
|
* @brief ESP_HIDD_EVENT_CONNECT
|
|
*/
|
|
struct hidd_connect_evt_param {
|
|
uint16_t conn_id;
|
|
esp_bd_addr_t remote_bda; /*!< HID Remote bluetooth connection index */
|
|
} connect; /*!< HID callback param of ESP_HIDD_EVENT_CONNECT */
|
|
|
|
/**
|
|
* @brief ESP_HIDD_EVENT_DISCONNECT
|
|
*/
|
|
struct hidd_disconnect_evt_param {
|
|
esp_bd_addr_t remote_bda; /*!< HID Remote bluetooth device address */
|
|
} disconnect; /*!< HID callback param of ESP_HIDD_EVENT_DISCONNECT */
|
|
|
|
/**
|
|
* @brief ESP_HIDD_EVENT_BLE_VENDOR_REPORT_WRITE_EVT
|
|
*/
|
|
struct hidd_vendor_write_evt_param {
|
|
uint16_t conn_id; /*!< HID connection index */
|
|
uint16_t report_id; /*!< HID report index */
|
|
uint16_t length; /*!< data length */
|
|
uint8_t *data; /*!< The pointer to the data */
|
|
} vendor_write; /*!< HID callback param of ESP_HIDD_EVENT_BLE_VENDOR_REPORT_WRITE_EVT */
|
|
|
|
} esp_hidd_cb_param_t;
|
|
|
|
|
|
/**
|
|
* @brief HID device event callback function type
|
|
* @param event : Event type
|
|
* @param param : Point to callback parameter, currently is union type
|
|
*/
|
|
typedef void (*esp_hidd_event_cb_t) (esp_hidd_cb_event_t event, esp_hidd_cb_param_t *param);
|
|
|
|
|
|
|
|
/**
|
|
*
|
|
* @brief This function is called to receive hid device callback event
|
|
*
|
|
* @param[in] callbacks: callback functions
|
|
*
|
|
* @return ESP_OK - success, other - failed
|
|
*
|
|
*/
|
|
esp_err_t esp_hidd_register_callbacks(esp_hidd_event_cb_t callbacks);
|
|
|
|
/**
|
|
*
|
|
* @brief This function is called to initialize hid device profile
|
|
*
|
|
* @return ESP_OK - success, other - failed
|
|
*
|
|
*/
|
|
esp_err_t esp_hidd_profile_init(void);
|
|
|
|
/**
|
|
*
|
|
* @brief This function is called to de-initialize hid device profile
|
|
*
|
|
* @return ESP_OK - success, other - failed
|
|
*
|
|
*/
|
|
esp_err_t esp_hidd_profile_deinit(void);
|
|
|
|
/**
|
|
*
|
|
* @brief Get hidd profile version
|
|
*
|
|
* @return Most 8bit significant is Great version, Least 8bit is Sub version
|
|
*
|
|
*/
|
|
uint16_t esp_hidd_get_version(void);
|
|
|
|
void esp_hidd_send_consumer_value(uint16_t conn_id, uint8_t key_cmd, bool key_pressed);
|
|
|
|
void esp_hidd_send_keyboard_value(uint16_t conn_id, key_mask_t special_key_mask, uint8_t *keyboard_cmd, uint8_t num_key);
|
|
|
|
void esp_hidd_send_mouse_value(uint16_t conn_id, uint8_t mouse_button, int8_t mickeys_x, int8_t mickeys_y);
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|
|
|
|
#endif /* __ESP_HIDD_API_H__ */
|
|
|