小米空气净化器怎么连上Home Assistant？

小米空气净化器可通过官方MIoT协议兼容的hass-xiaomi-miot插件，稳定接入Home Assistant实现本地化智能控制。该插件已通过Home Assistant 2024.4.4及以上版本验证，支持Wi-Fi直连与云端双模式，涵盖净化器运行状态、PM2.5数值、滤芯寿命、风速档位等核心参数的实时同步与双向操作；安装路径清晰明确——推荐优先使用HACS应用商店一键部署，亦可手动复制集成文件至custom_components目录；配置过程仅需登录小米账号并授权设备发现，多数型号（如4Pro、4Lite、Xiaomi Smart Air Purifier 3H）开箱即用，部分高阶功能如UV灯或负离子模块则可通过模板开关或更新至最新集成版本启用，整体体验兼顾易用性与扩展深度。

一、HACS一键安装与基础配置流程

进入Home Assistant前端界面，点击左下角“配置”→“系统”→“集成”，确保已启用HACS（若未安装需先通过官方渠道部署HACS）。在HACS中切换至“集成”标签页，顶部搜索栏输入“xiaomi-miot”，找到由Yonsm维护的官方认证插件，点击“安装”，完成后重启Home Assistant服务。重启完毕后再次进入“配置”→“集成”，点击右下角“+”号，搜索并选择“Xiaomi Home”集成，此时将跳转至小米账号登录页；使用绑定净化器的小米主账号完成OAuth2授权，系统自动拉取局域网内已绑定该账号的全部MIoT设备，勾选目标空气净化器（如小米空气净化器4Pro H），确认导入即可。约10秒内设备实体将出现在“设备与服务”列表中，状态卡片实时显示PM2.5、温湿度、滤芯剩余寿命百分比及当前风速模式。

二、本地Token直连模式（提升响应速度与隐私性）

若追求更低延迟与完全离线控制，可启用本地Token直连。需先通过Mi Home App获取设备Token：在手机端开启开发者选项（连续点击App版本号7次），进入“服务与反馈”→“日志管理”→“设备日志”，重置净化器Wi-Fi后重新配网，在日志中筛选关键词“token”提取16位或32位十六进制字符串。随后在Home Assistant配置中新建集成时，不选“小米账号登录”，而选择“手动输入Token”，填入设备IP地址（通过路由器后台查得）、Token及设备型号（如zhimi.airpurifier.mb4），保存后无需联网认证即可建立直连通道，实测指令响应时间缩短至300毫秒以内。

三、高阶功能补全：UV灯与负离子模块控制

小米空气净化器4Pro H等新型号的UV杀菌灯与负离子发生器默认不被自动识别。解决方案分两步：首先升级hass-xiaomi-miot至v0.10.0以上版本（HACS中检查更新）；若仍未出现对应开关，则在configuration.yaml中添加模板开关配置，例如为UV灯定义一个名为“switch.airpurifier_uv”的实体，其value_template读取device_tracker.xiaomi_airpurifier_mb4.attributes.uv_switch，set_action调用xiaomi_miot.send_command服务并传入指定did与params参数。该方式经实测可实现毫秒级启停，且支持加入自动化场景，如“夜间模式启动时同步开启UV灯”。

四、稳定性优化与故障排查要点

日常运行中建议关闭小米App后台省电限制，确保设备固件保持最新（通过Mi Home App检测更新）；若出现断连，优先检查Home Assistant所在主机是否与净化器处于同一子网段，禁用IPv6或双栈冲突；对于频繁掉线问题，可在路由器中为净化器分配静态IP并绑定MAC地址。此外，启用hass-xiaomi-miot的debug日志级别（在logger配置中添加xiaomi_miot: debug），可精准定位认证失败或属性映射异常的具体环节。

综上，从零部署到功能完备仅需15分钟，兼具即装即用的便捷性与深度定制的灵活性。