Bluetooth® Main API

API Reference

components/bt/host/bluedroid/api/include/api/esp_bt_main.h
This header file can be included with:
#include "esp_bt_main.h"
This header file is a part of the API provided by the bt component. To declare that your component depends on bt, add the following to your CMakeLists.txt:
REQUIRES bt
or
PRIV_REQUIRES bt

esp_bluedroid_status_t esp_bluedroid_get_status(void)

Get bluetooth stack status.

esp_err_t esp_bluedroid_enable(void)

Enable bluetooth, must after esp_bluedroid_init()/esp_bluedroid_init_with_cfg().

返回

esp_err_t esp_bluedroid_disable(void)

Disable Bluetooth, must be called prior to esp_bluedroid_deinit().

备注

Before calling this API, ensure that all activities related to the application, such as connections, scans, etc., are properly closed.

返回

esp_err_t esp_bluedroid_init(void)

Init and alloc the resource for bluetooth, must be prior to every bluetooth stuff.

返回

esp_err_t esp_bluedroid_init_with_cfg(esp_bluedroid_config_t *cfg)

Init and alloc the resource for bluetooth, must be prior to every bluetooth stuff.

参数

cfg -- Initial configuration of ESP Bluedroid stack.

返回

esp_err_t esp_bluedroid_deinit(void)

Deinit and free the resource for bluetooth, must be after every bluetooth stuff.

返回

struct esp_bluedroid_config_t

Bluetooth stack configuration.

Public Members

bool ssp_en: Whether SSP(secure simple pairing) or legacy pairing is used for Classic Bluetooth

enum esp_bluedroid_status_t

Bluetooth stack status type, to indicate whether the bluetooth stack is ready.

Values:

enumerator ESP_BLUEDROID_STATUS_INITIALIZED: Bluetooth initialized but not enabled