米家集成 ha_xiaomi_home手把手把小米设备接入 Home Assistant3步跑通【免费下载链接】ha_xiaomi_homeXiaomi Home Integration for Home Assistant项目地址: https://gitcode.com/GitHub_Trending/ha/ha_xiaomi_home米家集成 ha_xiaomi_home 是小米官方的 Home Assistant 集成组件把你米家账号里的空气净化器、智能灯、扫地机直接拉进 Home Assistant本地局域网和小米云两条通道都走得通设备状态变化还能实时推过来。零基础照着做三步就能把现有设备全部挂上仪表盘不用换硬件。米家集成安装步骤最短路径跑起来动手前先核对两件事Home Assistant 的 Core 版本要在 2024.4.4 及以上、Operating System 在 13.0 及以上你的小米账号能正常登录要接的设备都绑在这个账号名下。第 1 步拿代码。在跑 Home Assistant 的服务器上把仓库克隆到 config 目录里cd config git clone https://gitcode.com/GitHub_Trending/ha/ha_xiaomi_home执行完config 目录下会多出一个 ha_xiaomi_home 文件夹。第 2 步跑安装脚本参数填你 Home Assistant 的配置目录路径容器部署一般是 /configcd ha_xiaomi_home ./install.sh /configinstall.sh 会把集成组件整个复制到配置目录的 custom_components 下。执行完会看到一句 Xiaomi Home installation is completed. Please restart Home Assistant.第 3 步重启 Home Assistant设置 → 系统 → 重启系统。重启后进设置 → 设备与服务 → 添加集成搜索框里能搜到 Xiaomi Home说明装好了。装好之后先看当天就能玩起来的三件事。米家集成配置指南装完当天就能玩什么登录并导入整个米家家庭你想干什么把空气净化器、智能灯拉进 Home Assistant 的实体列表。去哪操作设置 → 设备与服务 → 添加集成 → 搜 Xiaomi Home → 下一步会跳到小米账号登录页。登录走的是 OAuth 2.0密码不落在 Home Assistant 里注意选对用户所在地区中国、欧洲、美国等不同地区的设备挂在不同的云上选错就导不出来。结果长什么样登录成功弹出选择家庭与设备会话框勾选一个家庭它名下的设备就全部导入。刷新仪表盘空气净化器、灯已经躺在实体列表里了。接入第二个小米账号你想干什么把两个家庭、两套账号的设备放进同一个 Home Assistant 区域统一管理。去哪操作设置 → 设备与服务 → 已配置 → Xiaomi Home → 添加中枢 → 下一步用第二个账号登录一遍。结果长什么样第二个账号的家庭和设备出现在同一区域两个家庭的实体并排显示自动化里随便互相引用。过滤冗余实体、给实体改名你想干什么实体列表太长一些属性看着没用还有些名字是英文。去哪操作改已安装集成 miot/specs 目录下的 spec_filter.yaml写要过滤掉的实例和 multi_lang.json补中文翻译然后在集成配置里点更新实体转换规则。结果长什么样被过滤的实体从列表里消失属性名按你补的翻译显示成中文。玩到这一步你大概会好奇它到底怎么跟设备通信的。米家集成工作原理推送通道与本地直连状态是推过来的不是问出来的。它像个门铃你不用每隔十分钟趴猫眼看一次客人来了没有客人一到门铃自己响。技术上集成在小米云的 MQTT Broker 上订阅了设备消息通道设备属性变化或触发事件时云端把上行消息实时推给集成配置完成时只向云端查一次全部属性之后不再轮询对云端的访问压力很小。控制指令走反方向通过云端 HTTP 接口发出去再由云端转给设备。本地直连中枢网关里藏了个交换机。它像小区内部电话通话不用出局走外部电话局楼里的分机直接接通。小米中枢网关固件 3.3.0_0023 及以上内置一个标准 MQTT Broker集成直接朝网关订阅消息控制指令发布到 Broker 后由网关转给设备全程不出局域网。代码里两条通道同时可用时网关本地通道优先云端兜底。为什么不同设备生成的实体不一样。每台设备自带一份 MIoT-Spec-V2 描述列清楚它有哪些属性、事件、方法。集成拿描述去匹配内置转换规则可写属性按数据格式变成 switch、select、number 或 text只读属性变 sensor事件变 event 实体方法变 button 或 notify。这也是你后面定制实体的入口。接入过程中你可能遇到几个小状况基本一句话就能解决。米家集成常见问题新手最常踩的4个坑 现象登录成功设备却不显示。原因蓝牙、红外和部分虚拟设备暂不支持或者登录时选错了用户地区。 解法先在米家 App 确认设备已绑定该账号再回配置流程选对地区重新导入。现象控制响应慢指令像在绕远路。原因局域网里没有小米中枢网关指令只能借道小米云。 解法加装中枢网关后本地直连自动优先配置里的局域网控制开关不建议拿来顶替官方文档标注它可能引发异常。现象实体名是英文列表里一堆用不上的实体。原因云端翻译不全冗余的 spec 实例默认没被过滤。 解法改 miot/specs 下的 multi_lang.json 和 spec_filter.yaml再到集成配置里点更新实体转换规则生效。现象想看内部发生了什么方便排障。原因默认日志级别不细关键步骤没打出来。 解法在设置 → 仪表盘 → 日志里把 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），仅供参考