米家设备接入 Home Assistant 完整指南ha_xiaomi_home 三步跑通本地与云端双控制【免费下载链接】ha_xiaomi_homeXiaomi Home Integration for Home Assistant项目地址: https://gitcode.com/GitHub_Trending/ha/ha_xiaomi_home官方入口来了米家设备进 Home Assistant 不再靠野路子米家 App 里控着空气净化器、智能灯、扫地机某天你想让 HA 的自动化接管它们打开集成列表一搜——没有官方入口只有社区脚本和各种不稳定的桥接。其实小米官方早就给了答案ha_xiaomi_home一个把米家设备直接接进 Home Assistant 的官方集成组件本地直连和云端推送两条通道都支持你现有的设备、现有配法都不用动。一句话结论装完、登录、选家庭米家设备就躺在 HA 实体列表里了状态还是实时推过来的。它到底帮你解决什么一份能力速查表一句话定位米家设备与 Home Assistant 之间的官方翻译层。多账号聚合多个小米账号的设备可以导入同一个 HA 实例一个面板统管全屋。本地/云端双通道局域网里有小米中枢网关就走本地直连没有就走小米云两条路自动兜底。状态实时推送设备属性一变就推过来不靠轮询刷状态延迟低、对云端压力也小。实体自动生成读每台设备自带的 MIoT-Spec-V2小米定义的设备说明书描述它有哪些属性、事件、方法自动切成 switch、sensor、climate 等实体零手工映射。实体名 13 语言中文界面开箱就是中文设备名支持简繁中文、英、日、德等 13 种语言。你关心的事ha_xiaomi_home 怎么做装起来麻烦吗一条./install.sh或 HACS 一键装支持所有设备吗大部分米家设备品类蓝牙/红外/虚拟设备除外断网还能控吗有中枢网关时走局域网本地控制要改实体名/过滤冗余实体改 specs 目录下的规则文件即可这几点直接决定你上手顺不顺手接下来三步就能跑通。从零到跑通克隆、安装、登录第 1 步克隆代码并安装前置要求Home Assistant Core ≥ 2024.4.4、Operating System ≥ 13.0在 HA 所在的服务器 config 目录下执行cd config git clone https://gitcode.com/GitHub_Trending/ha/ha_xiaomi_home cd ha_xiaomi_home ./install.sh /path/to/your/homeassistant/configinstall.sh 做的事很简单把custom_components/xiaomi_home整个复制到你的 HA 配置目录然后重启 Home Assistant即装好。不喜欢 git 的话也可以进 HACS 搜Xiaomi Home直接下载或用 Samba 手动把组件文件夹拷进config/custom_components/。第 2 步登录小米账号HA 界面进设置 → 设备与服务 → 添加集成搜Xiaomi Home下一步会跳到小米账号登录页。登录走 OAuth 2.0密码不会存进 HA。⚠️ 关键提醒要选对账号所在地区中国大陆、欧洲、美国等不同地区的设备挂在不同的云上选错了就导不出设备。第 3 步选家庭设备进场登录后弹出选择家庭与设备勾选要接入的米家家庭该家庭下所有设备一次性导入。刷新设备列表你的净化器和灯应该已经在实体列表里了。以后升级 / 回滚进克隆目录拉新代码切到想要的 Tag再跑一次安装脚本即可——安装脚本会先清掉旧版再拷新版所以回滚就是切回旧 Tag 重装cd config/ha_xiaomi_home git fetch git checkout v0.4.6 # 切到任意想要的版本 ./install.sh /path/to/your/homeassistant/config版本历史可以看 CHANGELOG.md。装好之后它跟设备之间到底怎么传话往下看。内部怎么跑 ⚙️推送、网关与自动翻译设备状态为什么总最新像直播不靠刷新你可以把它想成直播而不是点播不是每隔几分钟刷一次屏幕问有动静没而是平台一有新画面就自动推到你眼前。技术上集成在小米云的 MQTT Broker可以理解为一个消息中转站上订阅了设备消息通道设备属性变化或事件触发时云端就把properties_changed、event这类消息实时推给集成配置完成时它只向云端查一次全部属性之后基本不再轮询。控制指令走反方向通过 HTTP API 发set_properties或action到云端再由云端转给设备。本地直连怎么生效家里装了中继基站如果局域网里有小米中枢网关固件 3.3.0_0023 及以上它内部自带一个标准 MQTT Broker相当于在家里架了个消息中继基站集成直接向网关订阅设备消息控制指令发到网关后由网关转给设备全程不出局域网。两条通道同时可用时本地优先。除了通道还有一条暗线每台设备都带一份 MIoT-Spec-V2 描述集成拿它当施工图纸去匹配内置映射规则——属性变 sensor 或 switch事件变 event方法变 button。具体规则见 中文文档里的映射表这也是你后面定制实体的入口。一句话记住状态靠通道推指令走 HTTP 或网关快和远各有一条路。踩坑记录与进阶玩法 现象原因怎么处理登录后设备不显示蓝牙、红外、部分虚拟设备暂不支持或登录时选错了用户地区先在米家 App 确认设备已绑定该账号再重新走配置流程选对地区导入控制走云端、响应偏慢局域网里没有中枢网关指令只能绕道小米云加装中枢网关后本地直连自动优先配置里的局域网控制开关不建议当替代品官方明确标注可能引发异常实体名是英文、冗余实体一堆云端翻译不全多余的 spec 实例默认没被过滤改 specs 目录下的multi_lang.json和spec_filter.yaml再到集成配置点更新实体转换规则生效想同时管两个小米账号一个账号默认只导入一套家庭进 Xiaomi Home 配置页选添加中枢再登录一次即可进阶玩法把custom_components.xiaomi_home的日志级别调到 debug能看清每条设备消息在配置里开Action 调试模式可以给带参数的设备方法手动发指令会生成一个文本实体作为输入口调试自动化非常顺手。核心代码都在 custom_components/xiaomi_home/miot/想扒消息总线和 spec 解析逻辑的话直接翻这里。想深入 MIoT-Spec-V2 的完整转换表和过滤规则看 中文文档 就够了里面写得很全。【免费下载链接】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官方入口来了米家设备进 Home Assistant 不再靠野路子米家 App 里控着空气净化器、智能灯、扫地机某天你想让 HA 的自动化接管它们打开集成列表一搜——没有官方入口只有社区脚本和各种不稳定的桥接。其实小米官方早就给了答案ha_xiaomi_home一个把米家设备直接接进 Home Assistant 的官方集成组件本地直连和云端推送两条通道都支持你现有的设备、现有配法都不用动。一句话结论装完、登录、选家庭米家设备就躺在 HA 实体列表里了状态还是实时推过来的。它到底帮你解决什么一份能力速查表一句话定位米家设备与 Home Assistant 之间的官方翻译层。多账号聚合多个小米账号的设备可以导入同一个 HA 实例一个面板统管全屋。本地/云端双通道局域网里有小米中枢网关就走本地直连没有就走小米云两条路自动兜底。状态实时推送设备属性一变就推过来不靠轮询刷状态延迟低、对云端压力也小。实体自动生成读每台设备自带的 MIoT-Spec-V2小米定义的设备说明书描述它有哪些属性、事件、方法自动切成 switch、sensor、climate 等实体零手工映射。实体名 13 语言中文界面开箱就是中文设备名支持简繁中文、英、日、德等 13 种语言。你关心的事ha_xiaomi_home 怎么做装起来麻烦吗一条./install.sh或 HACS 一键装支持所有设备吗大部分米家设备品类蓝牙/红外/虚拟设备除外断网还能控吗有中枢网关时走局域网本地控制要改实体名/过滤冗余实体改 specs 目录下的规则文件即可这几点直接决定你上手顺不顺手接下来三步就能跑通。从零到跑通克隆、安装、登录第 1 步克隆代码并安装前置要求Home Assistant Core ≥ 2024.4.4、Operating System ≥ 13.0在 HA 所在的服务器 config 目录下执行cd config git clone https://gitcode.com/GitHub_Trending/ha/ha_xiaomi_home cd ha_xiaomi_home ./install.sh /path/to/your/homeassistant/configinstall.sh 做的事很简单把custom_components/xiaomi_home整个复制到你的 HA 配置目录然后重启 Home Assistant即装好。不喜欢 git 的话也可以进 HACS 搜Xiaomi Home直接下载或用 Samba 手动把组件文件夹拷进config/custom_components/。第 2 步登录小米账号HA 界面进设置 → 设备与服务 → 添加集成搜Xiaomi Home下一步会跳到小米账号登录页。登录走 OAuth 2.0密码不会存进 HA。⚠️ 关键提醒要选对账号所在地区中国大陆、欧洲、美国等不同地区的设备挂在不同的云上选错了就导不出设备。第 3 步选家庭设备进场登录后弹出选择家庭与设备勾选要接入的米家家庭该家庭下所有设备一次性导入。刷新设备列表你的净化器和灯应该已经在实体列表里了。以后升级 / 回滚进克隆目录拉新代码切到想要的 Tag再跑一次安装脚本即可——安装脚本会先清掉旧版再拷新版所以回滚就是切回旧 Tag 重装cd config/ha_xiaomi_home git fetch git checkout v0.4.6 # 切到任意想要的版本 ./install.sh /path/to/your/homeassistant/config版本历史可以看 CHANGELOG.md。装好之后它跟设备之间到底怎么传话往下看。内部怎么跑 ⚙️推送、网关与自动翻译设备状态为什么总最新像直播不靠刷新你可以把它想成直播而不是点播不是每隔几分钟刷一次屏幕问有动静没而是平台一有新画面就自动推到你眼前。技术上集成在小米云的 MQTT Broker可以理解为一个消息中转站上订阅了设备消息通道设备属性变化或事件触发时云端就把properties_changed、event这类消息实时推给集成配置完成时它只向云端查一次全部属性之后基本不再轮询。控制指令走反方向通过 HTTP API 发set_properties或action到云端再由云端转给设备。本地直连怎么生效家里装了中继基站如果局域网里有小米中枢网关固件 3.3.0_0023 及以上它内部自带一个标准 MQTT Broker相当于在家里架了个消息中继基站集成直接向网关订阅设备消息控制指令发到网关后由网关转给设备全程不出局域网。两条通道同时可用时本地优先。除了通道还有一条暗线每台设备都带一份 MIoT-Spec-V2 描述集成拿它当施工图纸去匹配内置映射规则——属性变 sensor 或 switch事件变 event方法变 button。具体规则见 中文文档里的映射表这也是你后面定制实体的入口。一句话记住状态靠通道推指令走 HTTP 或网关快和远各有一条路。踩坑记录与进阶玩法 现象原因怎么处理登录后设备不显示蓝牙、红外、部分虚拟设备暂不支持或登录时选错了用户地区先在米家 App 确认设备已绑定该账号再重新走配置流程选对地区导入控制走云端、响应偏慢局域网里没有中枢网关指令只能绕道小米云加装中枢网关后本地直连自动优先配置里的局域网控制开关不建议当替代品官方明确标注可能引发异常实体名是英文、冗余实体一堆云端翻译不全多余的 spec 实例默认没被过滤改 specs 目录下的multi_lang.json和spec_filter.yaml再到集成配置点更新实体转换规则生效想同时管两个小米账号一个账号默认只导入一套家庭进 Xiaomi Home 配置页选添加中枢再登录一次即可进阶玩法把custom_components.xiaomi_home的日志级别调到 debug能看清每条设备消息在配置里开Action 调试模式可以给带参数的设备方法手动发指令会生成一个文本实体作为输入口调试自动化非常顺手。核心代码都在 custom_components/xiaomi_home/miot/想扒消息总线和 spec 解析逻辑的话直接翻这里。想深入 MIoT-Spec-V2 的完整转换表和过滤规则看 中文文档 就够了里面写得很全。【免费下载链接】ha_xiaomi_homeXiaomi Home Integration for Home Assistant项目地址: https://gitcode.com/GitHub_Trending/ha/ha_xiaomi_home创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
)
