ha_xiaomi_home3 步把米家设备接入 Home Assistant小白也能跑通【免费下载链接】ha_xiaomi_homeXiaomi Home Integration for Home Assistant项目地址: https://gitcode.com/GitHub_Trending/ha/ha_xiaomi_home你买了台空气净化器、一盏智能灯在米家 App 里控制没问题想拉进 Home Assistant 的自动化里却发现没有官方入口社区方案稳定性全看运气。ha_xiaomi_home 就是小米官方给出的答案一个官方支持的集成组件把米家设备接入 Home Assistant本地、云端两种控制方式都支持。设备不用换米家配置也不用改。能力速览一个集成收编米家设备它本质是把小米 IoT 设备接进 Home Assistant 的桥。多账号统一导入多个小米账号的设备能进同一个实例一个仪表盘统一管实体自动生成读设备的MIoT-Spec-V2描述自动转成 switch、sensor 等实体不用手工映射实体名多语言支持 13 种语言属性名自动翻译中文界面开箱就是中文本地/云端双通道局域网有中枢网关走本地直连没有就走小米云状态推送不轮询设备属性一变就主动推过来状态不滞后实体组合可定制改 specs 目录 的字典与过滤规则即可。下面把它跑起来。上手路径3 步接入前置条件Home Assistant Core 2024.4.4 及以上、Operating System 13.0 及以上。第 1 步拿代码在 Home Assistant 所在机器执行cd config git clone https://gitcode.com/GitHub_Trending/ha/ha_xiaomi_home cd ha_xiaomi_home ./install.sh /path/to/your/config组件被复制到 custom_components 目录重启后集成列表里出现 Xiaomi Home。第 2 步登录。进设置 → 设备与服务 → 添加集成搜 Xiaomi Home跳转小米账号登录页。登录走OAuth 2.0密码不存进 Home Assistant。注意选对用户所在地区选错就导不出设备。第 3 步选家庭。登录成功弹出选择家庭与设备勾选要接入的米家家庭该家庭下的设备全部导入。成功信号刷新设备列表空气净化器已经躺在实体列表里。升级或回滚在克隆目录切到目标 tag再跑一次安装脚本。跑通之后你多半会好奇它内部是怎么跑的。原理拆解它是怎么跟设备说话的设备状态从哪来推送不是轮询像快递通知群不是隔几分钟问快递站到了没而是等派件提醒自己弹出来。集成在小米云的 MQTT Broker 上订阅设备消息属性变化或事件触发时 Broker 实时推给集成只在配置完成时查一次全部属性之后不再轮询。控制指令往哪去本地网关优先像家里设了个前台快递不用出城去分拣中心直接送到前台。小米中枢网关固件 3.3.0_0023 及以上内置标准MQTT Broker集成直接向网关订阅消息指令发布到 Broker 后由网关转发给设备全程不出局域网。没有网关时指令走HTTP 接口经小米云转发。两条通道同时可用时本地优先。一句话记住状态靠通道推指令走网关或云端快和远都有路可走。排障与进阶 登录后设备不显示→ 蓝牙、红外、虚拟设备暂不支持或选错用户地区 → 先在米家 App 确认设备绑定再选对地区重新导入控制响应偏慢→ 局域网里没有中枢网关指令绕道小米云 → 加装中枢网关后本地直连自动优先实体名是英文、或一堆没用的实体→ 云端翻译不全、冗余 spec 没过滤 → 改 specs 目录的 multi_lang.json 和 spec_filter.yaml再到集成配置里点更新实体转换规则想同时管两个账号→ 在 Xiaomi Home 配置页选添加中枢再登录一次想看内部行为→ 把 custom_components.xiaomi_home 日志级别调成 debug想深入映射规则翻 doc/README_zh.md 的MIoT-Spec-V2 与 Home Assistant 实体的映射关系一节。【免费下载链接】ha_xiaomi_homeXiaomi Home Integration for Home Assistant项目地址: https://gitcode.com/GitHub_Trending/ha/ha_xiaomi_home创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考