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 里都好使但 PM2.5 进不了 Home Assistant 自动化灯也没法从面板打开社区集成不太稳。ha_xiaomi_home 是小米官方的米家设备接入桥像餐厅设备是后厨面板是食客本地、云端都支持。先看能力清单对路与否。ha_xiaomi_home 能力一览谁适合把米家设备接入 Home Assistant这张表帮你 30 秒判断要不要继续往下看。能力一句话说清多账号统一面板多个小米账号的米家设备可导入同一 Home Assistant 实例本地/云端双通道局域网有中枢网关走本地直连没有就绕小米云状态推送不轮询属性变化实时推到集成面板不滞后实体自动生成MIoT-Spec-V2 描述自动映射成 switch、sensor、climate 等实体实体名多语言13 种语言中文界面开箱就是中文场景在表内就往下走不在——比如蓝牙、红外、虚拟设备暂不支持——就不适合你。米家设备接入 Home Assistant3 步配置跑通 要求 Core 2024.4.4 及以上、Operating System 13.0 及以上。把仓库克隆到服务器先把代码放到 Home Assistant 所在的服务器。cd config git clone https://gitcode.com/GitHub_Trending/ha/ha_xiaomi_home此时你应该看到config/ha_xiaomi_home目录。克隆完下一件事是把它拷进组件目录。跑安装脚本安装脚本会把集成复制进custom_components。cd ha_xiaomi_home ./install.sh /path/to/homeassistant/config此时出现重启提示重启 Home Assistant 即装好。装好之后接着用账号登录。完成小米账号登录设置 → 设备与服务 → 添加集成搜 Xiaomi Home 授权登录。登录走 OAuth 2.0授权码换取密码不存进 Home Assistant记得选对地区否则设备导不出来。登录成功后选家庭。勾选家庭导入设备选择家庭与设备弹窗里勾选要导入的家庭该家庭下设备全部进来。此时净化器和灯应已躺在实体列表里。升级只需进克隆目录git fetch切到新 tag 再跑一次安装脚本不满意同样切回旧 tag 回滚。流程跑完值得看看它和设备到底怎么说话。本地直连与云端推送机制MQTT 通道原理拆解拆解状态推送链路状态像出菜后厨做好就端上桌食客不用反复探头问。集成在小米云的 MQTT Broker消息中间人把消息推给订阅了某个主题的人上订阅设备消息属性变化或事件发生时properties_changed 等上行消息实时推过来配置完成后只查一次全部属性之后不轮询。走小米云时的链路状态往下、指令往上。两条通道共用一条暗线每台设备都带一份 MIoT-Spec-V2 描述像后厨的菜单决定哪些属性变传感器、哪些变开关。拆解指令下发链路指令反着走像传菜单。云端模式经 MIoT Cloud 的 HTTP API即发请求、对端收到后处理发出本地模式发布到中枢网关内置的 MQTT Broker由网关转给设备不出局域网。本地要求网关固件 3.3.0_0023 及以上双通道同时可用时本地优先。家里有中枢网关时这条是主路。记住状态靠订阅通道往下推指令从云端或网关往上走。跑起来之前有几个坑值得提前记一下。米家设备接入 Home Assistant 踩坑排查速查表 这张表覆盖接入米家设备时 90% 的常见报错。现象原因处理登录后设备不显示蓝牙、红外、虚拟设备不支持先在米家App确认绑定登录后设备不显示登录时选错地区选对地区重新导入控制走云端偏慢局域网无中枢网关加装网关后本地自动优先实体名是英文云端翻译不全改 multi_lang.json 后更新无用实体太多冗余 spec 实例未过滤改 spec_filter.yaml 后更新想再深一层把custom_components.xiaomi_home日志级别调成 debug 看内部行为或改 multi_lang.json 和 spec_filter.yaml 后到集成配置里点更新实体转换规则。更细的映射规则下一章的延伸阅读有。延伸阅读实体映射与源码继续深入中文文档MIoT-Spec-V2 到实体的完整转换表和过滤规则都写在这。miot 源码目录云端、局域网、spec 解析的实现都在这里看代码比看文档快。英文 README 里另有官方消息原理与多账号配置说明。跑通之后把集成配置里的debug mode for action打开手动给智能音箱发一条 Action 指令完整感受一遍从菜单到实体的链路。【免费下载链接】ha_xiaomi_homeXiaomi Home Integration for Home Assistant项目地址: https://gitcode.com/GitHub_Trending/ha/ha_xiaomi_home创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考