Bluetooth\ :sup:`®` Low Energy
====================================

:link_to_translation:`zh_CN:[中文]`

**Bluetooth Low Energy (Bluetooth LE)** provides low-power wireless communication for IoT devices such as wearables, sensors, and smart home products. This section documents the **Bluetooth LE API Reference**, covering APIs for device discovery, data exchange, and Wi-Fi provisioning over Bluetooth LE.

For usage concepts and tutorials, see :doc:`Bluetooth Low Energy <../../../api-guides/ble/index>` in **API Guides**.

The Bluetooth LE API in ESP-IDF is organized into the following parts:

- :doc:`Bluetooth Low Energy GAP <esp_gap_ble>`

  Handles advertising, scanning, connection management, and security operations

- :doc:`Bluetooth Low Energy GATT Define <esp_gatt_defs>`

  Common data types and constants for attributes, characteristics, and UUIDs used in GATT operations

- :doc:`Bluetooth Low Energy GATT Server <esp_gatts>`

  Exposes services and characteristics to remote clients (peripheral role)

- :doc:`Bluetooth Low Energy GATT Client <esp_gattc>`

  Discovers and accesses services on remote servers (central role)

.. only:: SOC_BLUFI_SUPPORTED

   - :doc:`Bluetooth Low Energy BluFi <esp_blufi>`

     Enables Wi-Fi provisioning and configuration via Bluetooth LE

Each part typically includes an **Overview**, **Application Examples**, and **API Reference**, covering purpose, main functionality, sample usage, and detailed API documentation.

.. toctree::
   :maxdepth: 1
   :hidden:

   Bluetooth Low Energy GAP <esp_gap_ble>
   Bluetooth Low Energy GATT Define <esp_gatt_defs>
   Bluetooth Low Energy GATT Server <esp_gatts>
   Bluetooth Low Energy GATT Client <esp_gattc>
   :SOC_BLUFI_SUPPORTED: Bluetooth Low Energy BluFi <esp_blufi>