小米智能家居接入 Home Assistant 完整指南ha_xiaomi_home 一站式集成快速上手【免费下载链接】ha_xiaomi_homeXiaomi Home Integration for Home Assistant项目地址: https://gitcode.com/GitHub_Trending/ha/ha_xiaomi_home家里的小米设备越买越多却散落在米家 App 里各管一摊。想拉进 Home Assistant 做统一自动化又怕云端控制延迟高、配置太绕。ha_xiaomi_home 就是干这事的。它是小米官方支持的 HA 集成把米家设备批量导入 Home Assistant。还能通过中枢网关切到本地控制提速。下面从安装到本地控制一次跑通。它能帮你做到什么批量导入米家设备勾选家庭就能把整屋设备拉进 HA。多账号、多地区的设备也能进同一个区域。本地控制绕开云端有中枢网关时指令经 miot 协议模块 走局域网直达设备。响应更快。实体自动转换它按 MIoT-Spec-V2 协议把设备属性、事件、方法映射成开关、传感器等实体。不用手写。界面可选 13 种语言简中、繁中、英文都有。具体清单以 doc/README_zh.md 为准。事件即触发器设备状态变化、上报事件都能直接当 HA 自动化的触发条件。从零到第一次成功安装步骤与账号绑定先确认版本HA Core ≥ 2024.4.4System 版 ≥ 13.0以仓库说明为准。然后在 HA 配置目录下克隆仓库跑安装脚本git clone https://gitcode.com/GitHub_Trending/ha/ha_xiaomi_home cd ha_xiaomi_home ./install.sh /config检查点custom_components/下出现xiaomi_home文件夹。注意/config要换成你的 HA 配置目录。重启 HA进入设置 设备与服务 添加集成搜索 Xiaomi Home用小米账号登录。授权走 OAuth 2.0密码不会留在 HA 里。检查点弹出选择家庭与设备对话框。勾选要导入的家庭和设备确认。检查点设备列表出现小米设备拨一下开关真机跟着动作。导入后设备状态由小米云 MQTT 推送HA 不用轮询三步切到本地控制云模式下指令经小米云 HTTP 接口中转快慢看网络。本地模式把这一跳换成了中枢网关。网关内置标准 MQTT BrokerHA 直接向它订阅和发布指令。全程不出局域网。⚠️ 前置条件家里有小米中枢网关固件 3.3.0_0023 及以上。或者用带内置中枢网关的米家设备软件 0.8.9 及以上。中枢网关目前仅在中国大陆发售。操作三步把网关固件升到上述版本确认与 HA 在同一局域网。重启 HA集成会通过 mDNS 自动发现网关。打开任意设备详情页查看连接方式一栏。检查点显示 Local 即切换成功。配置页还有个更新局域网控制配置选项。它只能控 IP 设备官方不推荐一般不用碰。场景实战3 个自动化场景第一次成功后下面三个场景最值得先做。湿度超标自动除湿触发米家温湿度传感器读数超过 70%。动作HA 自动化开启米家除湿机。效果湿度回落到 55% 以下自动停机梅雨季不用守着。门锁异常安防联动触发门锁上报异常开锁事件。动作手机推送提醒同时让摄像头开始录像。效果误报还是真异常回家路上心里就有数。大功率设备断电保护触发智能插座功率持续 30 秒超过 1500W。动作自动化直接关闭插座。效果忘关的电热毯、取暖器不用再担心。避坑指南连接超时与状态不更新Q登录成功设备列表却为空现象导入转圈设备出不来。原因配置时选的地区和米家账号所在区域不一致小米云各地区数据互相隔离。解决删掉集成重新配置地区选账号实际区域。反复失败就去米家 App → 我的 → 应用授权重新授权 Xiaomi Home。Q为什么有的设备导不进来现象大部分设备都在缺几台。原因蓝牙设备、红外设备、虚拟设备暂不支持。解决这三类留在米家 App 管理。其余设备把固件升到最新再试一次。Q改了 spec 文件实体却没变化现象编辑了 spec_modify.yaml 后实体不更新。原因specs 目录的规则文件改完要手动刷新转换规则。解决进入设置 设备与服务 已配置 Xiaomi Home 配置点更新实体转换规则。写在最后ha_xiaomi_home 把米家设备接入 HA 的门槛降到了一条脚本加几次点击。装好后记得定期git pull再重跑一次 install.sh顺带看看 CHANGELOG.md 里新支持了哪些设备。下一步挑上面三个场景做一个试试。【免费下载链接】ha_xiaomi_homeXiaomi Home Integration for Home Assistant项目地址: https://gitcode.com/GitHub_Trending/ha/ha_xiaomi_home创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考