最简路径是用BLEAdvertising+setManufacturerData()手动构造二进制数据，因String传值会UTF-8编码导致乱码或截断，且BThomeV2要求TLV格式、厂商ID 0x02A1（小端）、广播包总长≤31字节。
直接结论：用 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（实际数据长度），后跟原始字节。
立即学习“C++免费学习笔记（深入）”；
例如广播温度 25.3°C（float）：
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 长度校验，每一处都得手动手算一遍，不能靠猜测。
