Warning
This document is not updated for ESP32C6 yet, so some of the content may not be correct.
This warning was automatically inserted due to the source file being in the add_warnings_pages list.
BT DEVICE APIs
Overview
Bluetooth device reference APIs.
API Reference
Header File
Functions
-
const uint8_t *esp_bt_dev_get_address(void)
Get bluetooth device address. Must use after “esp_bluedroid_enable”.
- Returns
bluetooth device address (six bytes), or NULL if bluetooth stack is not enabled
-
esp_err_t esp_bt_dev_set_device_name(const char *name)
Set bluetooth device name. This function should be called after esp_bluedroid_enable() completes successfully.
A BR/EDR/LE device type shall have a single Bluetooth device name which shall be identical irrespective of the physical channel used to perform the name discovery procedure.
- Parameters
name – [in] : device name to be set
- Returns
ESP_OK : Succeed
ESP_ERR_INVALID_ARG : if name is NULL pointer or empty, or string length out of limit
ESP_ERR_INVALID_STATE : if bluetooth stack is not yet enabled
ESP_FAIL : others