ESPHome 蓝牙网关三步上手把 BLE 温湿度计接进 Home Assistant【免费下载链接】esphomeESPHome is a system to control your ESP32, ESP8266, BK72xx, RP2040 by simple yet powerful configuration files and control them remotely through Home Automation systems.项目地址: https://gitcode.com/GitHub_Trending/es/esphome传感器贴着墙、电池满格Home Assistant 里却始终没有数值——多半因为它只会说蓝牙。ESPHome 蓝牙网关就是最短解法一块带 Wi-Fi 的 ESP32 守在设备旁边负责收 BLE 广播、把数据转成 MQTT 消息发给 HA你在 HA 里只管看卡片。BLE 广播怎么变成 HA 里的传感器链路只有一条BLE 广播 → ESP32 监听解析 → 发布 MQTT 主题 → HA 自动发现并显示。拿小区门口的代收点来打比方包裹广播包从四面八方送进来代收点拆包登记解析出温度、湿度、电量再统一交给快递员MQTT broker送到各家。ESP32 干的就是代收点这活。它还有第二条腿需要建立连接的主动设备智能开关、门锁走的是 bluetooth_proxy 组件它把原始广播和连接请求转给 HA 的蓝牙集成由 HA 决定连谁、读写什么。两条路共用同一块硬件互不冲突。 最快配出 ESPHome 蓝牙网关的三步硬件不用纠结四行选完部件建议备注主控ESP32-C3 / C6 / 经典 ESP32必须有原生 BLE电源5V/1A 线供电不稳是掉线主因位置居中放置与路由器隔开一点第 1 步装命令行工具。pip install esphome第 2 步建 yaml。下面就是最基础的 ESPHome MQTT 配置加一个蓝牙代理broker 指向你 HA 所在地址esphome: name: ble-gw esp32: board: esp32-c3-devkitm-1 wifi: ssid: 你的Wi-Fi名 password: 你的Wi-Fi密码 mqtt: broker: 192.168.1.10 password: !secret mqtt_pass bluetooth_proxy: connection_slots: 3第 3 步编译上传。esphome compile ble-gw.yaml esphome upload ble-gw.yaml首次上传用 USB 连着设备之后可以改esphome upload ble-gw.yaml --remote走网络或者配合 ota 的密码直接空中升级。接入第一台设备被动监听一台温湿度计以小米 LYWSD02MMC 为例这是最典型的 BLE 设备接入 Home Assistant 路径全程不用写代码esp32_ble_tracker: sensor: - platform: xiaomi_lywsd02mmc mac_address: A4:C1:38:XX:XX:XX bindkey: XXXXXXXXXXXXXXXX temperature: name: 客厅温度 humidity: name: 客厅湿度 battery_level: name: 传感器电量三个要点MAC 地址用esphome ble scan扫出来bindkey是小米广播的解密密钥社区一般用 MiFlow 之类的小工具提取缺了它数据全是乱的传感器平台实现见 xiaomi_lywsd02mmc其它小米型号基本同套路。MQTT 默认开着自动发现固件上去后 HA 里几秒就会出现实体不用手动添加。设备变多后连接槽先调哪按设备数量增长来安排每一步只动一个地方1~3 台被动传感器默认配置就够了。connection_slots出厂默认 3cache_services默认开启服务信息会写进闪存重连时直接读缓存省掉一轮完整的服务发现。出现要主动连接的设备ble_client 接的开关、门锁连接槽是硬资源上限 9。每个主动设备至少占一个槽槽位不够时新的连接请求会被拒。把 bluetooth_proxy 里的connection_slots提到实际需要的数量即可——这就是蓝牙网关连接槽的全部含义一块 ESP32 同时能维持的 BLE 连接上限。5 台以上、广播开始抢 Wi-Fi两者共用 2.4G 射频扫描太密会拖慢网络。把 esp32_ble_tracker 组件 的节奏放慢esp32_ble_tracker: scan_parameters: interval: 1000ms window: 500ms active: false纯广播设备用被动扫描active: false完全够window 决定占用射频的时间片。另外proxy 上报给 HA 的广播包是固定 16 条一批打包发送的这个批量策略在源码里写死不用也不该去配。⚠️ 踩坑自查表症状、原因、处置症状可能原因处置设备偶发掉线供电不稳换 5V/1A 电源缩短 USB 线数值长时间不更新扫描太挤、射频被占调小 window 与 intervalHA 里网关离线MQTT 没连上查 broker 地址与账号密码主动设备连不上连接槽被占满调大 connection_slots上限 9重连明显变慢服务缓存被关打开 cache_services编译报内存不足单网关组件太多拆成多台网关分担加固只需三行只放行认识的 MAC传感器平台只填你信任的mac_address: A4:C1:38:XX:XX:XX陌生广播解析不出实体等于天然白名单。MQTT 走 TLSmqtt 组件 配置里加certificate_authority: !secret ca_certbroker 换 8883 端口账号密码就不再明文过网。OTA 上密码给 ota 组件 加password: !secret ota_pass别让固件升级口裸奔。一台几十块钱的 ESP32就能把身边所有喊话式BLE 设备收进 HA剩下的只是慢慢往里面搬设备。卡住了先翻项目仓库的 issue 区同样的坑大概率已经有人踩过并留下了解法。【免费下载链接】esphomeESPHome is a system to control your ESP32, ESP8266, BK72xx, RP2040 by simple yet powerful configuration files and control them remotely through Home Automation systems.项目地址: https://gitcode.com/GitHub_Trending/es/esphome创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
