1. 为什么选择Passive BLE Monitor接入小米温湿度计如果你正在使用HomeAssistant搭建智能家居系统想要接入小米温湿度计2代LYWSD03MMCPassive BLE Monitor可能是最优雅的解决方案。这个集成最大的特点就是完全被动监听——不需要与设备建立双向连接不会影响温湿度计原有的工作模式也不会增加它的电量消耗。我最初尝试过其他方案比如通过小米网关中转或者使用第三方插件主动连接设备。实测下来这些方法要么需要额外硬件要么会导致设备电量快速耗尽。而Passive BLE Monitor只需要一个蓝牙适配器就能安静地偷听温湿度计广播出来的数据真正做到无感接入。这种方案特别适合不想拆机刷固件的用户希望保持设备原厂稳定性的用户需要长期稳定监测环境数据的场景2. 准备工作与环境配置2.1 硬件需求清单在开始之前确保你准备好以下硬件小米温湿度计2代型号LYWSD03MMC运行HomeAssistant的主机树莓派/NAS/PC等蓝牙适配器如果是树莓派内置蓝牙即可我用的是一台树莓派4B实测内置蓝牙完全够用。如果你用的是虚拟机运行的HA建议购买一个USB蓝牙5.0适配器兼容性会更好。2.2 软件环境检查登录你的HomeAssistant后台确认以下几个关键点系统版本在2023.5以上已安装HACSHomeAssistant社区商店蓝牙服务正常运行可以通过SSH连接到主机运行以下命令检查蓝牙状态hciconfig -a如果看到类似UP RUNNING的状态说明蓝牙正常工作。如果显示DOWN需要先启用蓝牙sudo systemctl start bluetooth3. 安装Passive BLE Monitor集成3.1 通过HACS安装打开HA的侧边栏进入HACS 集成点击右下角的浏览并下载存储库。在搜索框输入Passive BLE Monitor选择第一个结果作者Magalex。点击下载后HACS会自动完成安装。这里有个小技巧下载完成后不要急着重启先继续后面的步骤等所有配置都准备好后再一次性重启可以节省时间。3.2 配置蓝牙适配器安装完成后进入配置 设备与服务点击右下角添加集成搜索Passive BLE Monitor。在配置界面中最关键的是选择正确的蓝牙适配器地址。如果你不确定哪个是你的蓝牙适配器可以在终端运行hcitool dev这个命令会列出所有可用的蓝牙设备复制对应的MAC地址填入配置界面。4. 获取设备密钥和MAC地址4.1 使用Telink Flasher获取加密密钥这是整个流程中最关键的一步。你需要一台带蓝牙的电脑Windows/Mac/Linux都可以按照以下步骤操作打开Chrome浏览器访问Telink Flasher网页工具点击Connect按钮在弹出窗口中选择LYWSD03MMC连接成功后点击Do activation等待几秒钟页面会显示32位的加密密钥注意这个密钥只会显示一次务必立即复制保存。我建议同时记录在HA的机密功能和本地文本文件中以防丢失。4.2 扫描获取MAC地址保持温湿度计处于正常工作状态在HA主机上打开终端依次输入bluetoothctl scan on这时会开始扫描周围的蓝牙设备。找到名为LYWSD03MMC的设备记录它的MAC地址。这个过程可能需要10-20分钟如果长时间没找到可以尝试将温湿度计靠近蓝牙适配器关闭其他可能干扰的蓝牙设备重启蓝牙服务后重新扫描5. 完整配置流程详解5.1 添加设备到Passive BLE Monitor回到HA的Passive BLE Monitor集成界面点击Add device在弹出窗口中第一栏输入MAC地址格式如A4:C1:38:12:34:56第三栏输入之前获取的32位加密密钥其他选项保持默认点击提交这里有个容易踩坑的地方提交后界面看起来没有任何变化其实这是正常的。你需要返回上一级在设备列表中选择--Devices--然后再次提交。5.2 等待数据出现由于小米温湿度计是周期性广播数据大约每10分钟一次提交配置后需要耐心等待。我建议不要频繁刷新页面可以将温湿度计放在蓝牙适配器附近等待20-30分钟再检查当数据开始出现时你会在Bluetooth Low Energy Monitor的设备列表中看到温湿度计点击进入就能查看实时数据。6. 数据优化与高级配置6.1 提高数据更新频率默认情况下温湿度计每10分钟才广播一次数据。如果你需要更实时的监测可以通过以下方法优化唤醒设备轻触温湿度计的按钮它会立即广播一次数据修改扫描间隔在configuration.yaml中添加ble_monitor: scan_interval: 60 discovery: true这样集成会每分钟主动扫描一次但注意会增加主机负担。6.2 数据校准与单位设置有时候传感器数据可能会有偏差可以在配置中进行校准ble_monitor: devices: - mac: A4:C1:38:12:34:56 temperature_offset: 0.5 humidity_offset: -2还可以修改显示单位sensor: - platform: ble_monitor temperature_unit: F7. 常见问题排查7.1 设备未出现怎么办如果等待30分钟后仍然看不到数据可以尝试以下排查步骤检查蓝牙适配器是否正常工作确认密钥和MAC地址输入正确注意大小写重启HomeAssistant服务尝试将集成删除后重新添加7.2 数据不稳定怎么解决蓝牙信号容易受到干扰如果发现数据时有时无缩短设备与蓝牙适配器的距离避免将适配器放在金属物体附近检查周围是否有其他2.4GHz设备干扰如WiFi路由器考虑使用蓝牙信号中继器我在书房部署时就遇到过这个问题后来把树莓派从金属机柜里拿出来信号立即稳定了。8. 数据可视化与自动化当数据稳定接入后你可以创建精美的仪表盘。我习惯使用实体卡片来展示温湿度数据配合历史图表观察变化趋势。还可以设置自动化比如当温度超过28℃时自动打开空调或者湿度低于40%时启动加湿器。一个简单的自动化配置示例automation: - alias: Turn on AC when too hot trigger: platform: numeric_state entity_id: sensor.ble_temperature above: 28 action: service: switch.turn_on target: entity_id: switch.ac_power这种被动监听方案最大的优势就是稳定可靠。我的系统已经连续运行6个月温湿度计依然使用原装电池数据从未中断。相比那些需要主动连接的方案Passive BLE Monitor确实是最省心省电的选择。
