BT DEVICE APIs

Overview

Bluetooth device reference APIs.

Instructions

Application Example

Instructions

API Reference

Header File

• components/bt/host/bluedroid/api/include/api/esp_bt_device.h

Functions

const uint8_t *esp_bt_dev_get_address(void)

Get bluetooth device address. Must use after “esp_bluedroid_enable”.

Return

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.

Return

• 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

Parameters

• [in] name: : device name to be set

Provide feedback about this document