C++ ESP32怎么使用低功耗蓝牙（BLE）广播自定义传感器数据-C++-PHP中文网

最简路径是用bleadvertising+setmanufacturerdata()手动构造二进制数据，因string传值会utf-8编码导致乱码或截断，且bthomev2要求tlv格式、厂商id 0x02a1（小端）、广播包总长≤31字节。

c++ esp32怎么使用低功耗蓝牙（ble）广播自定义传感器数据

直接结论：用 BLEAdvertising + setManufacturerData() 是最简路径，但必须手动构造二进制数据，不能传原始 float/int —— 否则手机端看到的是乱码或截断。

为什么不能直接用 `String` 传传感器值

ESP32 Arduino BLE 库的 setManufacturerData(String) 看似方便，但它把字符串按 UTF-8 编码写入广播包。比如你写 advertising.setManufacturerData("temp=25.3")，实际塞进去的是 10 字节 UTF-8 字节流（含等号、小数点、ASCII 字符），不仅浪费空间，还无法被 Home Assistant 或 bthome-logger 这类工具识别。

真正有效的做法是把数值序列化为紧凑二进制，例如把 float 25.3 转成 4 字节 IEEE754，再拼进厂商数据段。

广播包总长上限 31 字节，AD Type 0xFF（厂商数据）本身占 2 字节（Type + Length），剩下最多 29 字节给你的 payload
厂商 ID 必须是 2 字节（如 Nordic 的 0x0059，BThome 用 0x02A1），所以你只剩 27 字节放真实数据
传 ASCII 字符串在 31 字节里可能只塞下 2～3 个字段；传二进制能轻松打包温度、湿度、电池电压、状态标志共 6～8 个字段

怎么构造合法的 BThomeV2 格式广播包

BThomeV2 是目前最实用的自定义广播协议，Home Assistant 原生支持，且强制要求二进制格式。它的帧结构是 Type-Length-Value（TLV），每个字段以 1 字节 Type 开头，1 字节 Length（实际数据长度），后跟原始字节。

例如广播温度 25.3°C（float）：

C++14

C++14 对 C++11 的修正与增强版本，适合旧系统维护和较老工具链兼容。

下载

0x41 0x04 0x41 C8 66 66
↑    ↑    ↑↑↑↑
Type Len  IEEE754: 25.3 = 0x41C86666

其中 0x41 是 BThome 定义的“温度”类型 ID，0x04 表示后面跟 4 字节。

必须以 0x02A1（Little Endian 存储）作为厂商 ID 开头，即字节数组前两字节是 0xA1, 0x02
整个 payload（含厂商 ID）传给 setManufacturerData() 时，得用 std::vector<uint8_t></uint8_t> 或原始 uint8_t[]，再转成 String —— 不是靠字符拼接，而是用 String((char*)buf, len) 强制解释为字节流
别漏掉广播包里必需的 0x01（Flags）和 0x03（Service UUID）AD 结构，否则 nRF Connect 可能不显示设备，或 Home Assistant 扫不到

nRF Connect 调试时看不到你的设备？检查这三处

nRF Connect 是验证广播内容最直接的工具，但很多初学者扫不到设备，不是代码没跑，而是配置或环境问题。

ESP32 是否启用了 BLE 广播？确认调用了 advertising.start()，且没被 delay() 或阻塞逻辑卡住 —— BLE 广播依赖 FreeRTOS 任务调度，死循环会停掉广播事件
手机蓝牙是否开了“位置权限”？Android 6.0+ 要求开启定位才能扫描 BLE 设备，即使你只是看广播包，不开权限就扫不到任何 Peripheral
广播间隔设太长（比如 2 秒）？nRF Connect 默认只扫 10 秒，若设备每 2 秒广播一次，你有 50% 概率错过首个包。调试阶段建议设 advertising.setScanResponse(true) 并把间隔压到 100 ms：advertising.setInterval(100000, 100000)（单位是微秒）

深度睡眠唤醒后广播失效？重置 BLE 状态是关键

电池供电场景下，ESP32 常用 esp_sleep_enable_timer_wakeup() 配合深度睡眠。但醒来后 BLE 控制器不会自动恢复，BLEDevice::init() 必须重新调用，且要加 BLEDevice::deinit(true) 清理前次状态。

否则会出现：设备醒了，LED 亮了，但广播包发不出去，nRF Connect 扫不到 —— 看似硬件正常，实则是 BLE 控制器卡在未初始化状态。

每次唤醒后，顺序必须是：BLEDevice::deinit(true) → BLEDevice::init("my-sensor") → 重建 BLEAdvertising 对象 → 设置 manufacturer data → advertising.start()
不要复用旧的 BLEAdvertising 实例，它内部持有已释放的内存指针
如果用 PlatformIO，确保 board_build.f_cpu 和 board_build.flash_mode 匹配，否则 BLE 射频校准失败，广播功率极低，1 米外就收不到

真正难的不是“怎么发”，而是“怎么让接收端稳定解出你发的每一个字节”。广播包没有 ACK，没有重传，31 字节里错一个 bit，整包就废。所以字段对齐、大小端、厂商 ID 顺序、TLV 长度校验，每一处都得手动手算一遍，不能靠猜测。