Bluetooth® Main API

API Reference

Header File

  • 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

Functions

esp_bluedroid_status_t esp_bluedroid_get_status(void)

Get bluetooth stack status.

Returns

Bluetooth stack status

esp_err_t esp_bluedroid_enable(void)

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

Returns

  • ESP_OK : Succeed

  • Other : Failed

esp_err_t esp_bluedroid_disable(void)

Disable bluetooth, must prior to esp_bluedroid_deinit().

Returns

  • ESP_OK : Succeed

  • Other : Failed

esp_err_t esp_bluedroid_init(void)

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

Returns

  • ESP_OK : Succeed

  • Other : Failed

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.

Parameters

cfg – Initial configuration of ESP Bluedroid stack.

Returns

  • ESP_OK : Succeed

  • Other : Failed

esp_err_t esp_bluedroid_deinit(void)

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

Returns

  • ESP_OK : Succeed

  • Other : Failed

Structures

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

Macros

BT_BLUEDROID_INIT_CONFIG_DEFAULT()

Enumerations

enum esp_bluedroid_status_t

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

Values:

enumerator ESP_BLUEDROID_STATUS_UNINITIALIZED

Bluetooth not initialized

enumerator ESP_BLUEDROID_STATUS_INITIALIZED

Bluetooth initialized but not enabled

enumerator ESP_BLUEDROID_STATUS_ENABLED

Bluetooth initialized and enabled

Provide feedback about this document