警告

This document is not updated for ESP32H4 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.

# 蓝牙® API

[English]

本章节提供 ESP-IDF 中蓝牙的 API 参考。ESP-IDF 支持两种主机协议栈：Bluedroid 和 NimBLE。

- Bluedroid （默认协议栈）：支持经典蓝牙和低功耗蓝牙，适用于同时使用这两种技术的应用场景。

- NimBLE：仅支持低功耗蓝牙，因代码体积小、内存占用低，适合资源受限的应用。

可通过下方链接查看相应的 API 文档和示例应用。

控制器接口 API

蓝牙主机协议栈与控制器之间的底层接口。

- 控制器 （Controller）& HCI

Bluedroid 协议栈 API

ESP-IDF 默认的主机协议栈，支持经典蓝牙和低功耗蓝牙。

- 蓝牙® 通用 API
- 低功耗蓝牙®

有关蓝牙架构和功能的详细信息，请参阅 API 指南中的以下文档：

蓝牙® 架构、 低功耗蓝牙®

NimBLE 协议栈 API

专为低功耗蓝牙设计的轻量级主机协议栈。

- NimBLE-based Host APIs

更多详细信息和上游文档的 API 参考，请参阅 Apache Mynewt NimBLE 用户指南。

ESP-BLE-MESH API

实现低功耗蓝牙 Mesh 网络功能。

- ESP-BLE-MESH

ESP-BLE-ISO API

低功耗蓝牙等时通道（CIS/BIS），用于蓝牙低功耗音频及时间同步流传输。

- ESP-BLE-ISO

ESP-BLE-AUDIO API

蓝牙低功耗音频配置与服务（BAP、PACS、VCP、HAS、CSIP 等）。

- ESP-BLE-AUDIO

## 示例与教程

ESP-IDF 提供了丰富的示例代码和实践教程，路径见 examples 目录：

- Bluedroid: bluetooth/bluedroid

- NimBLE: bluetooth/nimble

- BLE UART 服务 （基于 NimBLE 或 Bluedroid 的即用型蓝牙串口透传外设，提供 BLE UART Service GATT 布局）：bluetooth/ble_uart_service

使用 Bluedroid 协议栈进行开发的分步示例教程：

- GATT 客户端示例

- GATT 服务端服务表格示例

- GATT 服务端示例

- GATT 客户端安全性示例

- GATT 服务端安全性示例

- GATT 客户端多连接示例

使用 NimBLE 协议栈进行开发的分步示例教程：

- 低功耗蓝牙中心设备示例

- 低功耗蓝牙心率示例

- 低功耗蓝牙外围设备示例

此文档对您有帮助吗？

- 反馈已收到，谢谢！
- 如果您有其他意见，欢迎填写乐鑫文档反馈表。

- 我们重视您的反馈。
- 您可以填写乐鑫文档反馈表告诉我们如何改进该文档。