ha_xiaomi_home：3步把米家设备接入Home Assistant，新手也能上手

ha_xiaomi_home3步把米家设备接入Home Assistant新手也能上手【免费下载链接】ha_xiaomi_homeXiaomi Home Integration for Home Assistant项目地址: https://gitcode.com/GitHub_Trending/ha/ha_xiaomi_home想把小米设备接入Home Assistant时你买了台空气净化器、一盏智能灯、一台扫地机全是小米的。空气净化器在米家App里控灯你想拉进Home Assistant的自动化里却发现没有现成的官方入口只能翻社区的各种野路子稳定性全看运气。小米官方的答案是 ha_xiaomi_home直接把米家设备接入 Home Assistant本地、云端两种控制方式都支持现有设备不用换配法也不用改。看完这段你可能想知道它具体能干多少事。它到底能干什么米家设备全收进一个面板一句话定位把小米智能设备接进 Home Assistant 的桥。设备统一面板多个小米账号的米家设备能导入同一个 Home Assistant 实例一个仪表盘统一管。本地/云端双通道局域网里有中枢网关就走本地直连没有就走小米云两边都兜得住。状态推送不轮询设备属性一变就主动推过来状态不滞后对云端访问压力也小。实体自动生成它读每台设备的 MIoT-Spec-V2 描述自动转成 switch、sensor、climate 等实体不用手工映射。实体名多语言支持 13 种语言设备属性名自动翻译中文界面开箱就是中文。这 5 点决定了你后面跑通它的速度。从零到跑通的时间线3步接入米家设备第 1 步拿代码。在 Home Assistant 所在的服务器上执行要求 Core 2024.4.4 及以上、Operating System 13.0 及以上cd config git clone https://gitcode.com/GitHub_Trending/ha/ha_xiaomi_home cd ha_xiaomi_home ./install.sh /path/to/your/homeassistant/configinstall.sh 会把组件目录复制到 Home Assistant 的 custom_components 下然后重启 Home Assistant 就装好了。第 2 步登录。界面进设置 → 设备与服务 → 添加集成搜Xiaomi Home点下一步会跳到小米账号登录页。登录走 OAuth 2.0密码不会存进 Home Assistant。注意要选对用户所在地区中国、欧洲、美国等不同地区的设备在不同云上选错就导不出设备。第 3 步选家庭。登录成功后弹出选择家庭与设备勾选要接入的米家家庭该家庭下的设备全部导入。刷新设备列表空气净化器和灯应该已经躺在实体列表里了。以后想升级版本进克隆目录拉新 Tag 再跑一次安装脚本即可cd config/ha_xiaomi_home git fetch git checkout 你想切到的tag ./install.sh /path/to/your/config跑通之后你可能会好奇它到底是怎么跟设备说话的。它是怎么跟设备说话的本地直连与云端推送讲透设备状态为什么总最新推送而不是查询说白了它像快递通知群不是每隔几分钟打一次快递站问到了没而是等派件提醒自己弹出来。技术上是这么回事集成在小米云的 MQTT Broker 上订阅设备消息通道设备属性变化或事件触发时发出 properties_changed、event 等上行消息Broker 实时推给集成配置完成时它只向云端查一次全部属性之后不再轮询。控制指令则走反方向通过 HTTP API 发 set_properties 或 action 消息到云端再由云端转发给设备。本地直连怎么配中枢网关里的MQTT Broker你可以理解为家里设了个前台快递不用出城去分拣中心直接送到前台就行。小米中枢网关内置了一个标准 MQTT Broker需固件 3.3.0_0023 及以上集成直接向网关订阅设备消息控制指令发布到 Broker 后由网关转发给设备全程不出局域网。两条通道同时可用时中枢网关的本地控制优先。除了通道还有个暗线机制每台设备都带一份 MIoT-Spec-V2 描述列清楚它有哪些属性、事件、方法。集成拿描述去匹配内置映射规则属性变成 sensor 或 switch事件变成 event方法变成 button——这就是不同设备生成不同实体组合的原因也是你后面定制实体的入口。一句话记住状态靠通道推指令走 HTTP 或网关快和远都有路可走。踩坑记录 还能怎么玩 登录后台设备不显示→ 蓝牙、红外和部分虚拟设备暂不支持或登录时选错了用户地区 → 先在米家App确认设备已绑定该账号再在配置流程里选对地区重新导入。控制指令走云端、响应偏慢→ 局域网里没有小米中枢网关指令只能绕道小米云 → 加装中枢网关后本地直连自动优先配置里的局域网控制开关不建议拿来顶替官方文档标注它可能引发异常。实体名是英文、或者一堆没用的实体→ 云端翻译不全冗余的 spec 实例默认没被过滤 → 改 specs 目录下的 multi_lang.json 和 spec_filter.yaml再到集成配置里点更新实体转换规则生效。想同时管两个小米账号或想看看内部在干嘛→ 一个账号只导入一套家庭 → 在 Xiaomi Home 配置页选添加中枢再登录一次即可看内部行为就把 custom_components.xiaomi_home 的日志级别调成 debug。想更细地了解 MIoT-Spec-V2 到实体的映射规则可以翻一下 中文文档里面把转换表和过滤规则都写全了。【免费下载链接】ha_xiaomi_homeXiaomi Home Integration for Home Assistant项目地址: https://gitcode.com/GitHub_Trending/ha/ha_xiaomi_home创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考