一条命令把米家接入Home Assistant小米官方集成ha_xiaomi_home新手完整指南【免费下载链接】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本地、云端两条控制通道都覆盖现有设备不用换。能力速览小米官方集成能帮你做哪些事多账号设备统一管理多个小米账号下的米家设备可导入同一个 Home Assistant 实例一起调度。本地/云端双通道局域网有中枢网关就本地直连没有就走小米云两边都能兜住。状态订阅推送设备属性一变就实时推过来不轮询、不滞后。实体自动生成读每台设备的 MIoT-Spec-V2小米 IoT 平台的设备功能描述标准自动转成 switch、sensor、climate 等实体不用手工映射。实体名多语言属性名自动翻译支持 13 种语言中文界面开箱即中文。先把整套流程跑通再回头拆它的内部机制这样理解起来最顺。安装前的版本检查动手前先确认两项前置条件Home Assistant Core 2024.4.4 及以上Operating System 13.0 及以上在 HA 界面底部就能看到当前版本号不满足就先升级系统否则后续步骤会在安装时卡住。版本没问题就可以把代码拉到服务器上了。一条命令跑起来克隆代码并执行安装脚本在 Home Assistant 所在服务器的终端里克隆仓库进 config 目录再运行安装脚本。脚本做的事很单纯把custom_components/xiaomi_home组件复制到你的配置目录里。cd config git clone https://gitcode.com/GitHub_Trending/ha/ha_xiaomi_home cd ha_xiaomi_home ./install.sh /path/to/your/config跑完终端会提示安装完成接着重启 Home Assistant。重启后在集成列表里能看到Xiaomi Home就说明装好了。以后想升级切到目标 Tag 再跑一次脚本即可cd config/ha_xiaomi_home git fetch git checkout 你要切换的tag ./install.sh /path/to/your/config小米账号登录与家庭设备导入界面里走设置 → 设备与服务 → 添加集成搜索Xiaomi Home进入登录页有两个要点地区务必选对不同地区的设备存在不同的云上选错就导不出设备这是登录失败最常见的原因。密码不入库登录走 OAuth 2.0 流程密码不会存进 Home Assistant但登录后的账号令牌会明文存在配置文件中注意别把配置目录泄露出去。登录成功会弹出选择家庭与设备对话框勾选要接入的米家家庭该家庭下的设备会全部导入。刷新设备列表空气净化器和灯出现在实体列表里就算跑通了。跑通之后你可能会好奇它到底是怎么跟设备说话的下面拆开两条通道看。设备状态为什么不滞后订阅推送与家里的小中转站状态保鲜靠的不是反复询问更像体育场馆的电子记分牌比分一变屏幕立刻刷新你不用每隔几分钟起身去看一次计分板。技术实现上集成在小米云的 MQTT BrokerMQTT 是一种轻量级的消息订阅协议上订阅设备消息通道。设备属性变化或事件触发时云端把消息实时推给集成配置完成时它只向云端查一次全部属性之后不再轮询。控制指令走反方向集成通过云端 HTTP 接口发出由云端转发给设备。如果家里有小米中枢网关固件 3.3.0_0023 及以上或内置中枢网关功能的米家设备链路会进一步缩短网关内置标准 MQTT Broker集成直接向网关订阅消息控制指令也直接发布给网关由它转发到设备全程不出局域网。通道之外还有一条暗线每台设备都自带 MIoT-Spec-V2 描述列清楚它有哪些属性、事件、方法。集成拿描述去匹配内置规则——属性转成 sensor 或 switch事件转成 event方法转成 button这就是不同设备生成不同实体组合的原因也是日后你定制实体的入口。机制上没什么更多悬念了但实际用起来还是有几个容易绊脚的地方。最容易卡住的 4 个问题 ⚠️登录后部分设备不显示→ 蓝牙、红外和部分虚拟设备目前不支持或登录时选错了用户地区 → 先在米家 App 确认设备已绑定该账号再到配置流程里选对地区重新导入。控制指令走云端、响应偏慢→ 局域网里没有小米中枢网关指令只能绕道小米云 → 加装中枢网关后本地链路自动生效配置里的局域网控制开关只覆盖 IP 设备官方文档明确它可能引发异常不建议拿它顶替。实体名是英文、或一堆用不上的实体→ 云端翻译不全冗余的 spec 实例默认没被过滤 → 改 specs 目录下的 multi_lang.json 和 spec_filter.yaml再到集成配置里点更新实体转换规则让修改生效。想同时管两个小米账号→ 一个账号只导入一套家庭 → 在 Xiaomi Home 配置页点添加中枢再用另一个账号登录一次不同账号的设备还能放进同一个区域。进阶资料去哪找官方中文文档MIoT-Spec-V2 到实体的完整转换表、过滤规则和自定义写法都写在这里。specs 映射规则目录想定制实体、补翻译从这里动手。更新日志升级版本前看一眼确认实体 unique_id 规则有无变化避免已配置的自动化失效。【免费下载链接】ha_xiaomi_homeXiaomi Home Integration for Home Assistant项目地址: https://gitcode.com/GitHub_Trending/ha/ha_xiaomi_home创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 一条命令把米家接入Home Assistant：小米官方集成ha_xiaomi_home新手完整指南
一条命令把米家接入Home Assistant小米官方集成ha_xiaomi_home新手完整指南【免费下载链接】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本地、云端两条控制通道都覆盖现有设备不用换。能力速览小米官方集成能帮你做哪些事多账号设备统一管理多个小米账号下的米家设备可导入同一个 Home Assistant 实例一起调度。本地/云端双通道局域网有中枢网关就本地直连没有就走小米云两边都能兜住。状态订阅推送设备属性一变就实时推过来不轮询、不滞后。实体自动生成读每台设备的 MIoT-Spec-V2小米 IoT 平台的设备功能描述标准自动转成 switch、sensor、climate 等实体不用手工映射。实体名多语言属性名自动翻译支持 13 种语言中文界面开箱即中文。先把整套流程跑通再回头拆它的内部机制这样理解起来最顺。安装前的版本检查动手前先确认两项前置条件Home Assistant Core 2024.4.4 及以上Operating System 13.0 及以上在 HA 界面底部就能看到当前版本号不满足就先升级系统否则后续步骤会在安装时卡住。版本没问题就可以把代码拉到服务器上了。一条命令跑起来克隆代码并执行安装脚本在 Home Assistant 所在服务器的终端里克隆仓库进 config 目录再运行安装脚本。脚本做的事很单纯把custom_components/xiaomi_home组件复制到你的配置目录里。cd config git clone https://gitcode.com/GitHub_Trending/ha/ha_xiaomi_home cd ha_xiaomi_home ./install.sh /path/to/your/config跑完终端会提示安装完成接着重启 Home Assistant。重启后在集成列表里能看到Xiaomi Home就说明装好了。以后想升级切到目标 Tag 再跑一次脚本即可cd config/ha_xiaomi_home git fetch git checkout 你要切换的tag ./install.sh /path/to/your/config小米账号登录与家庭设备导入界面里走设置 → 设备与服务 → 添加集成搜索Xiaomi Home进入登录页有两个要点地区务必选对不同地区的设备存在不同的云上选错就导不出设备这是登录失败最常见的原因。密码不入库登录走 OAuth 2.0 流程密码不会存进 Home Assistant但登录后的账号令牌会明文存在配置文件中注意别把配置目录泄露出去。登录成功会弹出选择家庭与设备对话框勾选要接入的米家家庭该家庭下的设备会全部导入。刷新设备列表空气净化器和灯出现在实体列表里就算跑通了。跑通之后你可能会好奇它到底是怎么跟设备说话的下面拆开两条通道看。设备状态为什么不滞后订阅推送与家里的小中转站状态保鲜靠的不是反复询问更像体育场馆的电子记分牌比分一变屏幕立刻刷新你不用每隔几分钟起身去看一次计分板。技术实现上集成在小米云的 MQTT BrokerMQTT 是一种轻量级的消息订阅协议上订阅设备消息通道。设备属性变化或事件触发时云端把消息实时推给集成配置完成时它只向云端查一次全部属性之后不再轮询。控制指令走反方向集成通过云端 HTTP 接口发出由云端转发给设备。如果家里有小米中枢网关固件 3.3.0_0023 及以上或内置中枢网关功能的米家设备链路会进一步缩短网关内置标准 MQTT Broker集成直接向网关订阅消息控制指令也直接发布给网关由它转发到设备全程不出局域网。通道之外还有一条暗线每台设备都自带 MIoT-Spec-V2 描述列清楚它有哪些属性、事件、方法。集成拿描述去匹配内置规则——属性转成 sensor 或 switch事件转成 event方法转成 button这就是不同设备生成不同实体组合的原因也是日后你定制实体的入口。机制上没什么更多悬念了但实际用起来还是有几个容易绊脚的地方。最容易卡住的 4 个问题 ⚠️登录后部分设备不显示→ 蓝牙、红外和部分虚拟设备目前不支持或登录时选错了用户地区 → 先在米家 App 确认设备已绑定该账号再到配置流程里选对地区重新导入。控制指令走云端、响应偏慢→ 局域网里没有小米中枢网关指令只能绕道小米云 → 加装中枢网关后本地链路自动生效配置里的局域网控制开关只覆盖 IP 设备官方文档明确它可能引发异常不建议拿它顶替。实体名是英文、或一堆用不上的实体→ 云端翻译不全冗余的 spec 实例默认没被过滤 → 改 specs 目录下的 multi_lang.json 和 spec_filter.yaml再到集成配置里点更新实体转换规则让修改生效。想同时管两个小米账号→ 一个账号只导入一套家庭 → 在 Xiaomi Home 配置页点添加中枢再用另一个账号登录一次不同账号的设备还能放进同一个区域。进阶资料去哪找官方中文文档MIoT-Spec-V2 到实体的完整转换表、过滤规则和自定义写法都写在这里。specs 映射规则目录想定制实体、补翻译从这里动手。更新日志升级版本前看一眼确认实体 unique_id 规则有无变化避免已配置的自动化失效。【免费下载链接】ha_xiaomi_homeXiaomi Home Integration for Home Assistant项目地址: https://gitcode.com/GitHub_Trending/ha/ha_xiaomi_home创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考