00a7cdbb0b
1. Occupy conn[9] for adv. The max connection number of bluetooth controller decrease to 9. (Previously, it is 10) 2. modify the enum of setting BLE TX power corresponding to connection's. 3. fix libbtdm_app.a cwitch jump table
215 lines
8.6 KiB
C
215 lines
8.6 KiB
C
// Copyright 2015-2016 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 __BT_H__
|
|
#define __BT_H__
|
|
|
|
#include <stdint.h>
|
|
#include <stdbool.h>
|
|
#include "esp_err.h"
|
|
#include "sdkconfig.h"
|
|
#include "esp_task.h"
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
/**
|
|
* @brief Controller config options, depend on config mask.
|
|
* Config mask indicate which functions enabled, this means
|
|
* some options or parameters of some functions enabled by config mask.
|
|
*/
|
|
typedef struct {
|
|
uint16_t controller_task_stack_size; /*!< Bluetooth controller task stack size */
|
|
uint8_t controller_task_prio; /*!< Bluetooth controller task priority */
|
|
uint8_t hci_uart_no; /*!< If use UART1/2 as HCI IO interface, indicate UART number */
|
|
uint32_t hci_uart_baudrate; /*!< If use UART1/2 as HCI IO interface, indicate UART baudrate */
|
|
} esp_bt_controller_config_t;
|
|
|
|
#ifdef CONFIG_BT_ENABLED
|
|
|
|
#ifdef CONFIG_BT_HCI_UART_NO
|
|
#define BT_HCI_UART_NO_DEFAULT CONFIG_BT_HCI_UART_NO
|
|
#else
|
|
#define BT_HCI_UART_NO_DEFAULT 1
|
|
#endif /* BT_HCI_UART_NO_DEFAULT */
|
|
|
|
#ifdef CONFIG_BT_HCI_UART_BAUDRATE
|
|
#define BT_HCI_UART_BAUDRATE_DEFAULT CONFIG_BT_HCI_UART_BAUDRATE
|
|
#else
|
|
#define BT_HCI_UART_BAUDRATE_DEFAULT 921600
|
|
#endif /* BT_HCI_UART_BAUDRATE_DEFAULT */
|
|
|
|
#define BT_CONTROLLER_INIT_CONFIG_DEFAULT() { \
|
|
.controller_task_stack_size = ESP_TASK_BT_CONTROLLER_STACK, \
|
|
.controller_task_prio = ESP_TASK_BT_CONTROLLER_PRIO, \
|
|
.hci_uart_no = BT_HCI_UART_NO_DEFAULT, \
|
|
.hci_uart_baudrate = BT_HCI_UART_BAUDRATE_DEFAULT, \
|
|
};
|
|
#else
|
|
#define BT_CONTROLLER_INIT_CONFIG_DEFAULT() {0}; _Static_assert(0, "please enable bluetooth in menuconfig to use bt.h");
|
|
#endif
|
|
|
|
/**
|
|
* @brief Bluetooth mode for controller enable/disable
|
|
*/
|
|
typedef enum {
|
|
ESP_BT_MODE_IDLE = 0x00, /*!< Bluetooth is not running */
|
|
ESP_BT_MODE_BLE = 0x01, /*!< Run BLE mode */
|
|
ESP_BT_MODE_CLASSIC_BT = 0x02, /*!< Run Classic BT mode */
|
|
ESP_BT_MODE_BTDM = 0x03, /*!< Run dual mode */
|
|
} esp_bt_mode_t;
|
|
|
|
/**
|
|
* @brief Bluetooth controller enable/disable/initialised/de-initialised status
|
|
*/
|
|
typedef enum {
|
|
ESP_BT_CONTROLLER_STATUS_IDLE = 0,
|
|
ESP_BT_CONTROLLER_STATUS_INITED,
|
|
ESP_BT_CONTROLLER_STATUS_ENABLED,
|
|
ESP_BT_CONTROLLER_STATUS_NUM,
|
|
} esp_bt_controller_status_t;
|
|
|
|
|
|
/**
|
|
* @brief BLE tx power type
|
|
* ESP_BLE_PWR_TYPE_CONN_HDL0-9: for each connection, and only be set after connetion completed.
|
|
* when disconnect, the correspond TX power is not effected.
|
|
* ESP_BLE_PWR_TYPE_ADV : for advertising/scan response.
|
|
* ESP_BLE_PWR_TYPE_SCAN : for scan.
|
|
* ESP_BLE_PWR_TYPE_DEFAULT : if each connection's TX power is not set, it will use this default value.
|
|
* if neither in scan mode nor in adv mode, it will use this default value.
|
|
* If none of power type is set, system will use ESP_PWR_LVL_P1 as default for ADV/SCAN/CONN0-9.
|
|
*/
|
|
typedef enum {
|
|
ESP_BLE_PWR_TYPE_CONN_HDL0 = 0, /*!< For connection handle 0 */
|
|
ESP_BLE_PWR_TYPE_CONN_HDL1 = 1, /*!< For connection handle 1 */
|
|
ESP_BLE_PWR_TYPE_CONN_HDL2 = 2, /*!< For connection handle 2 */
|
|
ESP_BLE_PWR_TYPE_CONN_HDL3 = 3, /*!< For connection handle 3 */
|
|
ESP_BLE_PWR_TYPE_CONN_HDL4 = 4, /*!< For connection handle 4 */
|
|
ESP_BLE_PWR_TYPE_CONN_HDL5 = 5, /*!< For connection handle 5 */
|
|
ESP_BLE_PWR_TYPE_CONN_HDL6 = 6, /*!< For connection handle 6 */
|
|
ESP_BLE_PWR_TYPE_CONN_HDL7 = 7, /*!< For connection handle 7 */
|
|
ESP_BLE_PWR_TYPE_CONN_HDL8 = 8, /*!< For connection handle 8 */
|
|
ESP_BLE_PWR_TYPE_ADV = 9, /*!< For advertising */
|
|
ESP_BLE_PWR_TYPE_SCAN = 10, /*!< For scan */
|
|
ESP_BLE_PWR_TYPE_DEFAULT = 11, /*!< For default, if not set other, it will use default value */
|
|
ESP_BLE_PWR_TYPE_NUM = 12, /*!< TYPE numbers */
|
|
} esp_ble_power_type_t;
|
|
|
|
/**
|
|
* @brief Bluetooth TX power level(index), it's just a index corresponding to power(dbm).
|
|
*/
|
|
typedef enum {
|
|
ESP_PWR_LVL_N14 = 0, /*!< Corresponding to -14dbm */
|
|
ESP_PWR_LVL_N11 = 1, /*!< Corresponding to -11dbm */
|
|
ESP_PWR_LVL_N8 = 2, /*!< Corresponding to -8dbm */
|
|
ESP_PWR_LVL_N5 = 3, /*!< Corresponding to -5dbm */
|
|
ESP_PWR_LVL_N2 = 4, /*!< Corresponding to -2dbm */
|
|
ESP_PWR_LVL_P1 = 5, /*!< Corresponding to 1dbm */
|
|
ESP_PWR_LVL_P4 = 6, /*!< Corresponding to 4dbm */
|
|
ESP_PWR_LVL_P7 = 7, /*!< Corresponding to 7dbm */
|
|
} esp_power_level_t;
|
|
|
|
/**
|
|
* @brief Set BLE TX power
|
|
* Connection Tx power should only be set after connection created.
|
|
* @param power_type : The type of which tx power, could set Advertising/Connection/Default and etc
|
|
* @param power_level: Power level(index) corresponding to absolute value(dbm)
|
|
* @return ESP_OK - success, other - failed
|
|
*/
|
|
esp_err_t esp_ble_tx_power_set(esp_ble_power_type_t power_type, esp_power_level_t power_level);
|
|
|
|
/**
|
|
* @brief Get BLE TX power
|
|
* Connection Tx power should only be get after connection created.
|
|
* @param power_type : The type of which tx power, could set Advertising/Connection/Default and etc
|
|
* @return >= 0 - Power level, < 0 - Invalid
|
|
*/
|
|
esp_power_level_t esp_ble_tx_power_get(esp_ble_power_type_t power_type);
|
|
|
|
|
|
/**
|
|
* @brief Initialize BT controller to allocate task and other resource.
|
|
* @param cfg: Initial configuration of BT controller.
|
|
* This function should be called only once, before any other BT functions are called.
|
|
* @return ESP_OK - success, other - failed
|
|
*/
|
|
esp_err_t esp_bt_controller_init(esp_bt_controller_config_t *cfg);
|
|
|
|
/**
|
|
* @brief De-initialize BT controller to free resource and delete task.
|
|
*
|
|
* This function should be called only once, after any other BT functions are called.
|
|
* This function is not whole completed, esp_bt_controller_init cannot called after this function.
|
|
* @return ESP_OK - success, other - failed
|
|
*/
|
|
esp_err_t esp_bt_controller_deinit(void);
|
|
|
|
/**
|
|
* @brief Enable BT controller
|
|
* @param mode : the mode(BLE/BT/BTDM) to enable.
|
|
* Now only support BTDM.
|
|
* @return ESP_OK - success, other - failed
|
|
*/
|
|
esp_err_t esp_bt_controller_enable(esp_bt_mode_t mode);
|
|
|
|
/**
|
|
* @brief Disable BT controller
|
|
* @param mode : the mode(BLE/BT/BTDM) to disable.
|
|
* Now only support BTDM.
|
|
* @return ESP_OK - success, other - failed
|
|
*/
|
|
esp_err_t esp_bt_controller_disable(esp_bt_mode_t mode);
|
|
|
|
/**
|
|
* @brief Get BT controller is initialised/de-initialised/enabled/disabled
|
|
* @return status value
|
|
*/
|
|
esp_bt_controller_status_t esp_bt_controller_get_status(void);
|
|
|
|
/** @brief esp_vhci_host_callback
|
|
* used for vhci call host function to notify what host need to do
|
|
*/
|
|
typedef struct esp_vhci_host_callback {
|
|
void (*notify_host_send_available)(void); /*!< callback used to notify that the host can send packet to controller */
|
|
int (*notify_host_recv)(uint8_t *data, uint16_t len); /*!< callback used to notify that the controller has a packet to send to the host*/
|
|
} esp_vhci_host_callback_t;
|
|
|
|
/** @brief esp_vhci_host_check_send_available
|
|
* used for check actively if the host can send packet to controller or not.
|
|
* @return true for ready to send, false means cannot send packet
|
|
*/
|
|
bool esp_vhci_host_check_send_available(void);
|
|
|
|
/** @brief esp_vhci_host_send_packet
|
|
* host send packet to controller
|
|
* @param data the packet point
|
|
*,@param len the packet length
|
|
*/
|
|
void esp_vhci_host_send_packet(uint8_t *data, uint16_t len);
|
|
|
|
/** @brief esp_vhci_host_register_callback
|
|
* register the vhci referece callback, the call back
|
|
* struct defined by vhci_host_callback structure.
|
|
* @param callback esp_vhci_host_callback type variable
|
|
*/
|
|
void esp_vhci_host_register_callback(const esp_vhci_host_callback_t *callback);
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|
|
|
|
#endif /* __BT_H__ */
|