ha_xiaomi_home：3步把米家设备完整接入Home Assistant
ha_xiaomi_home3步把米家设备完整接入Home Assistant【免费下载链接】ha_xiaomi_homeXiaomi Home Integration for Home Assistant项目地址: https://gitcode.com/GitHub_Trending/ha/ha_xiaomi_home想把小米设备接入 Home Assistant 时你买了台空气净化器、一盏智能灯、一台扫地机全是小米的。净化器只能在米家 App 里控灯你想拉进 Home Assistant 的自动化里却发现没有官方入口只能翻社区的各种野路子。小米官方的答案是ha_xiaomi_home把米家设备直接接入 Home Assistant本地、云端两种控制方式都支持现有设备不用换。跑通它其实就三步。核心能力速览它能干多少事一句话定位把米家设备接入 Home Assistant 的桥。设备统一面板多个小米账号的米家设备可导入同一个 Home Assistant一个仪表盘统一管理。本地/云端双通道局域网有中枢网关就本地直连没有就走小米云两边都兜得住。状态推送不轮询设备属性一变就主动推过来状态不滞后。实体自动生成读每台设备的 MIoT-Spec-V2 描述自动转成 switch、sensor、climate 等实体不用手工映射。实体名多语言支持 13 种语言属性名自动翻译中文界面开箱就是中文。这 5 点决定了你后面跑通它的速度。安装步骤3 步装好 ha_xiaomi_home 集成第 1 步拿代码把集成装进 Home Assistant 的配置目录版本要求 Core 2024.4.4 及以上、Operating System 13.0 及以上cd config git clone https://gitcode.com/GitHub_Trending/ha/ha_xiaomi_home cd ha_xiaomi_home ./install.sh /configinstall.sh 会把组件复制到 Home Assistant 的custom_components目录/config换成你实际的路径即可之后重启 Home Assistant 就装好了。装好之后登录一下账号。第 2 步登录小米账号界面进设置 → 设备与服务 → 添加集成搜Xiaomi Home点下一步会跳到小米账号登录页。登录走 OAuth 2.0标准授权方式第三方只申请它需要的权限密码不会存进 Home Assistant。⚠️ 要选对用户所在地区中国、欧洲、美国等。不同地区的设备在不同云上选错就导不出设备。登录成功就差最后一步了。第 3 步选择家庭弹出选择家庭与设备会话框勾选要接入的米家家庭该家庭下的设备全部导入。刷新设备列表空气净化器和灯应该已经躺在实体列表里了。以后想升级版本进克隆目录config/ha_xiaomi_home执行以 v1.0.0 为例git fetch git checkout v1.0.0 ./install.sh /config原理拆解ha_xiaomi_home 怎么跟设备说话设备状态为什么总最新推送而不是查询它像快递通知群不是每隔几分钟打一次快递站问到了没而是等派件提醒自己弹出来。技术上是这么回事集成在小米云的 MQTT Broker负责收发、转发消息的中间件上订阅设备消息通道设备属性变化或事件触发时Broker 实时把properties_changed、event等上行消息推给集成配置完成时只向云端查一次全部属性之后不再轮询。控制指令走反方向通过 HTTP API 发set_properties或action消息到云端再由云端转发给设备。一句话记住状态靠通道推指令走 HTTP 下发。如果局域网里有中枢网关还有更快的路。本地直连配置中枢网关里的 MQTT Broker你可以理解为家里设了个前台快递不用出城去分拣中心直接送到前台就行。小米中枢网关固件 3.3.0_0023 及以上内置了一个标准 MQTT Broker集成直接向网关订阅设备消息控制指令发布到 Broker 后由网关转发给设备全程不出局域网。两条通道同时可用时中枢网关的本地控制优先。一句话记住局域网里有前台控制不出家门更快更稳。通道解决的是怎么说话还有件事决定生成哪些实体。不同设备为什么生成不同实体MIoT-Spec-V2每台设备都带一份 MIoT-Spec-V2 描述相当于一张设备说明书列清楚它有哪些属性、事件和方法。集成拿描述去匹配内置映射规则属性变成 sensor 或 switch事件变成 event 实体方法变成 button——这也是你后面定制实体的入口。一句话记住spec 是说明书实体是按说明书自动装配出来的。常见问题与进阶玩法 登录后台设备不显示→ 蓝牙、红外和部分虚拟设备暂不支持 → 先在米家 App 确认设备已绑定该账号再选对地区重新导入。控制指令响应偏慢→ 局域网里没有小米中枢网关指令只能绕道小米云 → 加装中枢网关后本地直连自动优先。实体名是英文或者一堆没用的实体→ 云端翻译不全冗余的 spec 实例默认没被过滤 → 改specs目录下的multi_lang.json和spec_filter.yaml再到集成配置里点更新实体转换规则生效。想看内部到底在干嘛→ 默认日志粒度太粗 → 把custom_components.xiaomi_home的日志级别调成debug。进阶提示想同时管多个小米账号在 Xiaomi Home 配置页选添加中枢再登录一次即可不同账号的设备可以加进同一个 Home Assistant 区域。延伸阅读想查 MIoT-Spec-V2 到实体的完整映射表和过滤规则看 中文文档 就够里面都写全了。【免费下载链接】ha_xiaomi_homeXiaomi Home Integration for Home Assistant项目地址: https://gitcode.com/GitHub_Trending/ha/ha_xiaomi_home创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考