Files
2025-12-09 10:51:14 +08:00

45 lines
1.7 KiB
ReStructuredText

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>