docs: Update Bluetooth Low Energy API home page

This commit is contained in:
luweike
2025-10-16 14:38:03 +08:00
parent 7e7773e0b8
commit d56eef151b
2 changed files with 79 additions and 3 deletions

View File

@@ -1,8 +1,41 @@
Bluetooth® Low Energy (Bluetooth LE)
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::
:caption: Bluetooth Low Energy
:maxdepth: 1
:hidden:
Bluetooth Low Energy GAP <esp_gap_ble>
Bluetooth Low Energy GATT Define <esp_gatt_defs>