ha_xiaomi_home | 让小米设备无缝接入 Home Assistant断网也能用【免费下载链接】ha_xiaomi_homeXiaomi Home Integration for Home Assistant项目地址: https://gitcode.com/GitHub_Trending/ha/ha_xiaomi_homeha_xiaomi_home 是小米官方的 Home Assistant 集成组件让你的米家设备直接进 HA 自动化不配对、不写代码用小米账号登录设备自动变成可控实体。如果你家一直是米家归米家、HA 归 HA两拨这就是你等的那块拼图。告别逐个配对双模式控制登录之后家里的设备批量导入控制通道有两种模式按你的环境自动选择模式消息通道要求云端控制小米云MQTT Broker HTTP API无需额外硬件本地控制小米中枢网关局域网内置 MQTT Broker需要中枢网关限中国大陆 云端同步出门在外查状态没有网关时指令走云端。集成会订阅小米云 MQTT Broker一种轻量级发布订阅消息协议上的设备消息状态变化由云端主动推送不做轮询对云端压力很小。 本地直连断网也能用局域网内有中枢网关时指令和状态全走本地网络不断网、零延迟、不担心隐私这才是最像智能家居的那种模式。三步部署从零到跑通克隆仓库要求 HA Core 2024.4.4 及以上把仓库克隆到 config 目录下。跑安装脚本自动把组件复制到custom_components并替换旧版本。重启 HA 并登录添加集成 搜 Xiaomi Home 登录 勾选要导入的家庭完成。cd config git clone https://gitcode.com/GitHub_Trending/ha/ha_xiaomi_home cd ha_xiaomi_home ./install.sh /config中途卡住先看 doc/README_zh.md 的安装与 FAQ 章节项目的 issue 区也有不少真实案例。它是怎么跑起来的一条数据流把它想成一条数据流指令从 HA 出发 → 经云端 HTTP 接口或网关 MQTT→ 到达设备 → 执行 → 状态回传。核心逻辑都在custom_components/xiaomi_home/miot/里miot_client.py负责云端通信miot_lan.py负责局域网直连。另一块魔法在规格转换每台设备由 MIoT-Spec-V2 协议描述设备能力的规范化数据模型就是物模型集成把属性、方法、事件自动翻译成 HA 实体——可写的布尔变开关只读的变传感器不用逐设备定制。让体验再进一步两个实用进阶过滤不想要的实体。设备会带一堆你根本不看属性spec_filter.yaml可以按设备 URN型号编号把它们滤掉urn:miot-spec-v2:device:gateway:0000A019:xiaomi-hub1: services: - 3 properties: - 4.*改完后在配置页点更新实体转换规则即可生效。用 Action 调试模式试指令。开启后会出现一个文本实体可手动发送带参数的方法调用适合在自动化上线前验证。目前覆盖照明、开关、传感器、温控、风扇、扫地机、媒体播放器等 17 类实体。遇到问题状态不更新、名称奇怪先确认米家 App 里设备可控也可用multi_lang.json本地覆盖云端翻译。完全连不上检查网络能否到云端配置时选对地区各地区数据是隔离的。本地控制不生效确认网关固件 3.3.0_0023 以上且设备是中枢网关下的子设备。更多细节见完整文档 doc/README_zh.md。【免费下载链接】ha_xiaomi_homeXiaomi Home Integration for Home Assistant项目地址: https://gitcode.com/GitHub_Trending/ha/ha_xiaomi_home创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考