乐鑫重构 Arduino ESP32 蓝牙库：统一 NimBLE 与 Bluedroid API，新增多设备连接支持

mumuyiki

2026年10月20日，乐鑫在官方开发者博客介绍了 Arduino ESP32 Core v4.0 的蓝牙库重构。目前相关功能已进入 v4.0.0-RC1 测试版本，涉及 BLE、BluetoothSerial 等组件，对使用 Arduino 开发 ESP32 蓝牙设备的工程师来说值得关注。

一、统一 NimBLE 与 Bluedroid 接口
此前，ESP32 Arduino 蓝牙库存在两套不同的底层协议栈：原版 ESP32 主要使用 Bluedroid，新款芯片则更多采用 NimBLE。
两者在连接回调、安全权限及描述符管理方面存在差异，导致部分程序移植时需要大量条件编译。
新版通过统一 API 屏蔽底层差异，开发者可以使用相同的接口管理连接、服务和特征值。
二、蓝牙5功能默认启用
新版在支持的芯片上默认启用蓝牙5相关功能，包括扩展广播、周期广播、2M PHY、Coded PHY 等。
开发者可以直接通过 Arduino API 配置，不再需要为了启用这些功能而重新编译底层静态库。
不过，原版 ESP32 仅支持蓝牙4.2，无法通过软件升级获得蓝牙5硬件能力。
三、新增 BLEStream 和多设备连接
此次更新新增 BLEStream 类，基于 Nordic UART Service 实现类似串口的数据传输接口。
开发者可以使用熟悉的 read()、write()、available() 方法收发 BLE 数据，降低无线串口项目的开发难度。
BluetoothSerial 也新增了多设备连接支持，允许多个蓝牙经典模式设备同时连接，并可向指定设备发送数据。
需要注意，经典蓝牙功能仍受到具体芯片硬件及编译配置限制。
四、改善安全性与资源管理
新版使用句柄管理蓝牙对象，减少裸指针带来的生命周期问题，并通过 BTStatus 返回更明确的错误信息。
GATT 特征值的访问权限也进行了统一，通知功能所需的 CCCD 描述符可以自动创建。
此外，官方正在开发 LE Audio 和 Auracast 支持，但目前尚未作为可用功能正式提供。
需要特别注意，v4.0 对旧版 API 存在不兼容修改，原有工程不能保证直接编译通过。
整体来看，这次更新不仅增加了功能，更重要的是改善了 ESP32 蓝牙开发的一致性和可维护性。
大家目前开发 ESP32 BLE 项目时，更习惯使用 Arduino、NimBLE-Arduino，还是直接调用 ESP-IDF 接口？

---

原始来源：Espressif Developer Portal
文章：Portable BLE by Design: The Bluetooth Rewrite in Arduino ESP32 v4.0
发布日期：2026年10月20日
软件版本：Arduino ESP32 Core v4.0.0-RC1
说明：本文根据乐鑫官方技术文章整理，相关功能未经本人实机测试。