小米设备接入 Home Assistant 完整攻略Xiaomi Home 集成【免费下载链接】ha_xiaomi_homeXiaomi Home Integration for Home Assistant项目地址: https://gitcode.com/GitHub_Trending/ha/ha_xiaomi_home如果你家里有一堆米家设备又想全部搬进 Home Assistant 统一自动化Xiaomi Home 集成就是最短路径。它基于小米官方 MIoT 协议支持云端和本地双通道控制。读完这篇你能自己把灯、插座、传感器导进 HA并跑通第一组跨设备联动。为什么小米设备总进不了 Home Assistant玩 HA 的人多半被同一件事卡过米家设备的数据默认只在米家 App 和小米云之间流转第三方想读状态、发指令只能抓包、逆向协议。这条路极不稳定——插件换个设备就崩App 一升级就失效排查起来没有尽头。Xiaomi Home 集成换了一条路它不逆向直接对接小米官方开放的 MIoT 协议。协议是官方维护的标准接口稳定、覆盖设备多一次登录、自动发现取代了一台设备一套代码。登录授权后组件自己拉取设备列表、自己生成实体你不用写一行映射。一句话定位Xiaomi Home 集成是小米设备进 HA 的官方中转站协议转换、状态同步、指令转发全部由它代劳。5 分钟把第一台设备导进来一键安装Git 或 HACS 二选一方式一Git 克隆安装推荐方便以后切换版本git clone https://gitcode.com/GitHub_Trending/ha/ha_xiaomi_home cd ha_xiaomi_home ./install.sh /path/to/homeassistant/config方式二在 HACS 商店里搜索 Xiaomi Home下载后重启即可。⚠️ 安装前确认 HA 版本不低于 2024.4.4操作系统版不低于 13.0版本太旧会缺依赖接口。install.sh只接受一个参数HA 的config目录路径。无论哪种方式装完必须重启 HA集成才会出现在列表里。登录授权选对区域很关键打开 HA 的「设置 → 设备与服务 → 添加集成」搜索Xiaomi Home按提示登录小米账号。登录时注意选择账号所属区域中国大陆、欧洲、印度、俄罗斯、新加坡、美国六选一选错区域会拉不到你的设备。⚠️ 不同区域的小米云数据是隔离的。如果设备分散在多个区域的账号里可以在集成页面继续添加其他账号把多区域设备统一导入同一个 HA。设备自动发现与批量导入登录成功后会弹出「选择家庭和设备」对话框勾选要导入的家庭和设备确认后组件自动生成实体。不用逐台配置导入完成那一刻灯、插座、传感器就都能在实体页里找到了。本地控制需要网关时再打开如果你家有小米中枢网关组件会自动发现并利用它的本地代理能力无需额外配置。没有网关也可以先走云端后续再补本地通道。云端与本地两条通道各走各的路Xiaomi Home 集成的核心设计是双通道。默认走云端组件向小米云的 MQTT Broker 订阅设备消息属性变更、事件、上下线状态会实时推送过来不用轮询你的控制指令则通过 HTTP API 发到云端再转发给设备。人在外地指令照样能到。本地通道把中转站换成了小米中枢网关网关内置标准 MQTT Broker组件直接跟网关订阅和发布消息状态与指令只在局域网里转一圈。响应几乎无延迟数据也不出家门。对比维度云端控制本地控制通信路径设备 → 小米云 → HA设备 → 中枢网关 → HA外部网络依赖需要断外网就失效不需要纯局域网响应速度受网络波动影响毫秒级几乎无延迟适用范围全部设备需中枢网关仅中国大陆发售或支持 LAN 控制的 WiFi/以太网设备另有一个折中选项LAN 控制只对同局域网内的 IP 设备WiFi/有线生效覆盖不到 BLE Mesh、Zigbee 设备。官方建议谨慎使用——有中枢网关时LAN 控制会自动让位不会生效。不用手写映射specv2entity 转换引擎导入完成就能用实体背后是组件里的 specv2entity 转换引擎。每台小米设备出厂都带一份 MIoT-Spec-V2 规格文件用服务 属性 事件 动作描述自己的能力。转换引擎读这份规格自动决定生成什么实体可写的布尔属性变 Switch可写的数值属性变 Number只读属性变 Sensor无参动作变 Button有参动作变 Notify。省掉的活很实在你不用再对着协议文档翻译这个属性是读还是写、该归哪个领域新设备上架后也不需要等社区写插件规格解析规则是通用的。覆盖面速查支持哪些设备与语言设备类别对应 HA 领域典型例子照明light智能灯、灯带开关插座switch智能插座、墙壁开关传感sensor温湿度、人体、门窗传感器空调climate空调伴侣、智能温控器风扇fan智能风扇、空气循环扇媒体播放media_player电视、电视盒子、小爱音箱除六大类外组件还覆盖 cover窗帘、vacuum扫地机、humidifier加湿器、water_heater、fan、device_tracker 等十多个领域基本涵盖米家在售品类蓝牙、红外、虚拟设备暂不支持。界面语言方面translations 目录内置中简、中繁、英、日、德、法、西、俄等 12 种语言跟随 HA 的语言设置自动切换。一个晚上联动是怎么自己跑起来的装上之后看一个具体画面。傍晚开门门磁传感器先触发回家场景玄关灯亮、空调切到舒适温度。说一句看电影客厅主灯熄灭灯带转暖色电视和音箱同时开机。夜里起身人体传感器感知到动作路径灯自动点亮回到床上后延时熄灭。早上出门离家模式关掉全部灯光空调转节能。这些画面没有一行自定义代码。它们成立的前提是设备经 MIoT 协议顺利导入、云端或本地通道保证状态实时同步、转换引擎把每台设备的能力暴露成标准实体。剩下的编排就是 HA 自动化的分内事。出了问题先查这四件事✅ 设备连不上 → 先在 HA 系统里确认能访问小米云ping api.io.mi.com测试→ 再回米家 App 确认账号对该设备有控制权限排除设备本身离线。✅ 实体状态不同步 → 先重启 Xiaomi Home 集成 → 再清除.storage/xiaomi_home.*缓存重新拉取 → 最后检查设备固件是否过旧。✅ 本地控制失效 → 确认中枢网关与 HA 在同一局域网 → 核对网关 IP 配置 → 确认设备在本地控制支持范围内WiFi/以太网设备。✅ 登录或授权报错 → 确认选择的小米账号区域与实际账号一致 → 到米家 App「账号管理 → 应用」中撤销旧授权后重新登录。从哪开始小米设备接入 HA 最烦的从来不是自动化本身而是接进来这一步。Xiaomi Home 集成把它收敛成一次登录装组件、授权、勾选设备剩下的实体生成、状态同步、指令转发都自动完成。今晚就可以从一台智能插座开始导入、开灯、写一条自动化把第一组联动跑通。【免费下载链接】ha_xiaomi_homeXiaomi Home Integration for Home Assistant项目地址: https://gitcode.com/GitHub_Trending/ha/ha_xiaomi_home创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 小米设备接入 Home Assistant 完整攻略：Xiaomi Home 集成
小米设备接入 Home Assistant 完整攻略Xiaomi Home 集成【免费下载链接】ha_xiaomi_homeXiaomi Home Integration for Home Assistant项目地址: https://gitcode.com/GitHub_Trending/ha/ha_xiaomi_home如果你家里有一堆米家设备又想全部搬进 Home Assistant 统一自动化Xiaomi Home 集成就是最短路径。它基于小米官方 MIoT 协议支持云端和本地双通道控制。读完这篇你能自己把灯、插座、传感器导进 HA并跑通第一组跨设备联动。为什么小米设备总进不了 Home Assistant玩 HA 的人多半被同一件事卡过米家设备的数据默认只在米家 App 和小米云之间流转第三方想读状态、发指令只能抓包、逆向协议。这条路极不稳定——插件换个设备就崩App 一升级就失效排查起来没有尽头。Xiaomi Home 集成换了一条路它不逆向直接对接小米官方开放的 MIoT 协议。协议是官方维护的标准接口稳定、覆盖设备多一次登录、自动发现取代了一台设备一套代码。登录授权后组件自己拉取设备列表、自己生成实体你不用写一行映射。一句话定位Xiaomi Home 集成是小米设备进 HA 的官方中转站协议转换、状态同步、指令转发全部由它代劳。5 分钟把第一台设备导进来一键安装Git 或 HACS 二选一方式一Git 克隆安装推荐方便以后切换版本git clone https://gitcode.com/GitHub_Trending/ha/ha_xiaomi_home cd ha_xiaomi_home ./install.sh /path/to/homeassistant/config方式二在 HACS 商店里搜索 Xiaomi Home下载后重启即可。⚠️ 安装前确认 HA 版本不低于 2024.4.4操作系统版不低于 13.0版本太旧会缺依赖接口。install.sh只接受一个参数HA 的config目录路径。无论哪种方式装完必须重启 HA集成才会出现在列表里。登录授权选对区域很关键打开 HA 的「设置 → 设备与服务 → 添加集成」搜索Xiaomi Home按提示登录小米账号。登录时注意选择账号所属区域中国大陆、欧洲、印度、俄罗斯、新加坡、美国六选一选错区域会拉不到你的设备。⚠️ 不同区域的小米云数据是隔离的。如果设备分散在多个区域的账号里可以在集成页面继续添加其他账号把多区域设备统一导入同一个 HA。设备自动发现与批量导入登录成功后会弹出「选择家庭和设备」对话框勾选要导入的家庭和设备确认后组件自动生成实体。不用逐台配置导入完成那一刻灯、插座、传感器就都能在实体页里找到了。本地控制需要网关时再打开如果你家有小米中枢网关组件会自动发现并利用它的本地代理能力无需额外配置。没有网关也可以先走云端后续再补本地通道。云端与本地两条通道各走各的路Xiaomi Home 集成的核心设计是双通道。默认走云端组件向小米云的 MQTT Broker 订阅设备消息属性变更、事件、上下线状态会实时推送过来不用轮询你的控制指令则通过 HTTP API 发到云端再转发给设备。人在外地指令照样能到。本地通道把中转站换成了小米中枢网关网关内置标准 MQTT Broker组件直接跟网关订阅和发布消息状态与指令只在局域网里转一圈。响应几乎无延迟数据也不出家门。对比维度云端控制本地控制通信路径设备 → 小米云 → HA设备 → 中枢网关 → HA外部网络依赖需要断外网就失效不需要纯局域网响应速度受网络波动影响毫秒级几乎无延迟适用范围全部设备需中枢网关仅中国大陆发售或支持 LAN 控制的 WiFi/以太网设备另有一个折中选项LAN 控制只对同局域网内的 IP 设备WiFi/有线生效覆盖不到 BLE Mesh、Zigbee 设备。官方建议谨慎使用——有中枢网关时LAN 控制会自动让位不会生效。不用手写映射specv2entity 转换引擎导入完成就能用实体背后是组件里的 specv2entity 转换引擎。每台小米设备出厂都带一份 MIoT-Spec-V2 规格文件用服务 属性 事件 动作描述自己的能力。转换引擎读这份规格自动决定生成什么实体可写的布尔属性变 Switch可写的数值属性变 Number只读属性变 Sensor无参动作变 Button有参动作变 Notify。省掉的活很实在你不用再对着协议文档翻译这个属性是读还是写、该归哪个领域新设备上架后也不需要等社区写插件规格解析规则是通用的。覆盖面速查支持哪些设备与语言设备类别对应 HA 领域典型例子照明light智能灯、灯带开关插座switch智能插座、墙壁开关传感sensor温湿度、人体、门窗传感器空调climate空调伴侣、智能温控器风扇fan智能风扇、空气循环扇媒体播放media_player电视、电视盒子、小爱音箱除六大类外组件还覆盖 cover窗帘、vacuum扫地机、humidifier加湿器、water_heater、fan、device_tracker 等十多个领域基本涵盖米家在售品类蓝牙、红外、虚拟设备暂不支持。界面语言方面translations 目录内置中简、中繁、英、日、德、法、西、俄等 12 种语言跟随 HA 的语言设置自动切换。一个晚上联动是怎么自己跑起来的装上之后看一个具体画面。傍晚开门门磁传感器先触发回家场景玄关灯亮、空调切到舒适温度。说一句看电影客厅主灯熄灭灯带转暖色电视和音箱同时开机。夜里起身人体传感器感知到动作路径灯自动点亮回到床上后延时熄灭。早上出门离家模式关掉全部灯光空调转节能。这些画面没有一行自定义代码。它们成立的前提是设备经 MIoT 协议顺利导入、云端或本地通道保证状态实时同步、转换引擎把每台设备的能力暴露成标准实体。剩下的编排就是 HA 自动化的分内事。出了问题先查这四件事✅ 设备连不上 → 先在 HA 系统里确认能访问小米云ping api.io.mi.com测试→ 再回米家 App 确认账号对该设备有控制权限排除设备本身离线。✅ 实体状态不同步 → 先重启 Xiaomi Home 集成 → 再清除.storage/xiaomi_home.*缓存重新拉取 → 最后检查设备固件是否过旧。✅ 本地控制失效 → 确认中枢网关与 HA 在同一局域网 → 核对网关 IP 配置 → 确认设备在本地控制支持范围内WiFi/以太网设备。✅ 登录或授权报错 → 确认选择的小米账号区域与实际账号一致 → 到米家 App「账号管理 → 应用」中撤销旧授权后重新登录。从哪开始小米设备接入 HA 最烦的从来不是自动化本身而是接进来这一步。Xiaomi Home 集成把它收敛成一次登录装组件、授权、勾选设备剩下的实体生成、状态同步、指令转发都自动完成。今晚就可以从一台智能插座开始导入、开灯、写一条自动化把第一组联动跑通。【免费下载链接】ha_xiaomi_homeXiaomi Home Integration for Home Assistant项目地址: https://gitcode.com/GitHub_Trending/ha/ha_xiaomi_home创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考