ha_xiaomi_home手把手把米家设备接入 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 就是小米官方出品的米家接入集成一条命令装好本地、云端双通道把现有设备全收进 HA。装完你会得到什么多账号统一面板多个小米账号的设备进同一个仪表盘本地/云端双通道有中枢网关走本地没有走小米云状态推送不轮询设备一变就推过来状态零滞后实体自动生成读 MIoT-Spec-V2 描述自动建实体实体名 13 语言中文界面开箱就是中文实体名光看卖点没感觉下面直接动手3 步就能把设备跑进 Home Assistant。3 步装好米家接入集成先确认你的版本Home Assistant Core 需要2024.4.4 及以上Operating System 需要13.0 及以上。第 1 步拿代码。在 Home Assistant 所在服务器上执行这一步会把仓库克隆下来并跑 install.sh 把组件复制进你的 config 目录cd config git clone https://gitcode.com/GitHub_Trending/ha/ha_xiaomi_home cd ha_xiaomi_home ./install.sh /path/to/your/homeassistant/config第 2 步登录小米账号。进 HA 界面设置 → 设备与服务 → 添加集成搜Xiaomi Home按提示用小米账号登录走 OAuth 2.0密码不会存进 Home Assistant。关键动作是选对地区中国、欧洲、印度、俄罗斯、新加坡、美国六个机房数据互相隔离选错了就导不出设备。第 3 步选家庭。登录后弹出选择家庭与设备勾选要接入的米家家庭该家庭下所有设备自动导入刷新实体列表就能看见你的净化器和灯了。想升级版本更省事进克隆目录切到想要的 Tag 再跑一次 install.sh不用重新装。跑通之后你可能会好奇它到底怎么跟设备说话的。本地直连和云端推送到底连的是什么先说云端通道它像快递通知群不是每隔几分钟打一次快递站问到了没而是等派件提醒弹出来。技术上集成在小米云的 MQTT Broker消息订阅服务器上订阅设备消息通道属性变化或事件触发时 Broker 实时推过来配置完成时只向云端查一次全部属性之后不轮询。控制指令走反方向通过 HTTP 发set_properties或action消息到云端再由云端转发给设备。本地通道更直接像家里设了个前台快递不用出城去分拣中心直接送前台就行。小米中枢网关固件3.3.0_0023及以上内置一个标准 MQTT Broker集成直接向网关订阅设备消息控制指令发布到 Broker 后由网关转发给设备全程不出局域网。两条通道同时可用时中枢网关本地控制优先。除了通道还有条暗线每台设备都带一份MIoT-Spec-V2描述小米给设备写的功能说明书列清楚它有哪些属性、事件、方法。集成拿它去匹配内置映射规则属性变 sensor 或 switch事件变 event方法变 button——这就是不同设备生成不同实体组合的原因。搞懂这套通道之后可以开始把设备真正用起来了。三个场景把米家设备真正用起来场景一两个小米账号一起管。怎么做进已配置的 Xiaomi Home 页面 → 选添加中枢 → 再登录一次第二个账号。注意不同账号的设备能放进同一个区域仪表盘统一管登录时地区照样要选对。场景二把设备接进自动化。比如PM2.5 超标就开空调。怎么做找到净化器对应的 sensor 实体 → 在 Home Assistant 自动化里把它设为触发条件 → 动作里用空调的 climate、switch 实体。注意状态是推送来的触发不会滞后但前提是先按前面 3 步把设备导入成功。场景三实体名是英文、或一堆没用的实体。怎么做在自己 HA 配置目录的 multi_lang.json 里补翻译或在 spec_filter.yaml 里加过滤规则 → 改完到集成 CONFIGURE 页面点更新实体转换规则生效。注意只改自己 config 目录下的副本改完一定要点更新不然不生效。跑完这几个场景剩下的就是一些常见卡点了。卡在这里对着这三条查现象登录后台设备不显示→ 原因蓝牙、红外和虚拟设备暂不支持或登录时选错了地区 → 解法先在米家 App 确认设备已绑定该账号再重新导入并选对地区。现象控制走云端、响应偏慢→ 原因局域网里没有小米中枢网关指令只能绕道小米云 → 解法加装中枢网关后本地直连自动优先配置里的局域网控制开关不建议拿来顶替官方标注它可能引发异常。现象行为怪异不知道内部在干嘛→ 原因默认日志级别看不出细节 → 解法把custom_components.xiaomi_home的日志级别在configuration.yaml里调成 debug事件、动作都会打出来。一句话记住状态靠通道推指令走云端或网关本地控制加台中枢网关就有路可走。更多映射规则和转换细节看 中文文档 和 CHANGELOG。【免费下载链接】ha_xiaomi_homeXiaomi Home Integration for Home Assistant项目地址: https://gitcode.com/GitHub_Trending/ha/ha_xiaomi_home创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考