小米设备接入 Home Assistant 实战：米家集成上手指南

小米设备接入 Home Assistant 实战米家集成上手指南【免费下载链接】ha_xiaomi_homeXiaomi Home Integration for Home Assistant项目地址: https://gitcode.com/GitHub_Trending/ha/ha_xiaomi_home用 Home Assistant 管理米家设备时最让人头疼的是 HA 里的状态和设备的实际状态差了一步。米家集成Xiaomi Home Integration是小米官方支持的 Home Assistant 集成组件它基于 MIoT-Spec-V2 协议自动把小米设备转换成 HA 实体支持云控制和中枢网关本地控制适合想把米家设备纳入 HA 统一管理的用户。为什么选官方米家集成第三方米家集成常需要手工维护设备映射固件升级或规格变更后实体很容易失去同步。米家集成由小米官方提供基于小米 IoT 平台定义的 MIoT-Spec-V2 协议每个产品有一份标准化的物模型描述它的服务、属性、事件和方法。集成在导入时直接读取这份规格生成对应的 Home Assistant 实体不需要自己写映射。它目前覆盖大部分米家设备品类仅蓝牙、红外和虚拟设备不支持。云端接口部署在中国大陆、欧洲、印度、俄罗斯、新加坡、美国六个地区配置时要选择账号所在地区但不同地区的设备可以放进同一个 HA 区域。安装配置Git 克隆、OAuth 登录与米家设备导入两种安装方式与版本要求Home Assistant 的版本要求是 Core 2024.4.4 及以上、Operating System 13.0 及以上。官方推荐 git clone把仓库克隆到 config 目录再运行 install.sh。这种方式后续切换版本方便checkout 到对应 Tag 后重跑脚本即可cd config git clone https://gitcode.com/GitHub_Trending/ha/ha_xiaomi_home.git cd ha_xiaomi_home ./install.sh /config有 HACS 的话搜索 Xiaomi Home 一键安装也可以。手动安装则是把仓库里的custom_components/xiaomi_home文件夹复制到 HA 的 custom_components 目录。账号授权后的设备导入进入“设置 设备与服务 添加集成”搜索 Xiaomi Home 登录。登录走 OAuth 2.0集成不保存你的小米账号密码。登录成功后弹出“选择家庭与设备”对话框选中某个家庭该家庭下的设备就会全部导入。多账号家庭可以在已配置的集成页面继续添加账号不同账号的设备也能放进同一区域。消息流向云控制与本地控制的区别云控制MQTT 订阅推送默认走小米云。集成在云端的 MQTT Broker 上订阅设备消息设备属性变化或事件发生时云端直接推给 HA不需要轮询类似订报纸状态变化送上门而不是你反复去问。整个过程中只在配置完成时向云端查一次全部属性负载很小控制指令则通过云端 HTTP 接口发给设备。本地控制小米中枢网关离线直连家里有小【免费下载链接】ha_xiaomi_homeXiaomi Home Integration for Home Assistant项目地址: https://gitcode.com/GitHub_Trending/ha/ha_xiaomi_home创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考