小米米家集成安装教程3步把米家设备接入 Home Assistant【免费下载链接】ha_xiaomi_homeXiaomi Home Integration for Home Assistant项目地址: https://gitcode.com/GitHub_Trending/ha/ha_xiaomi_homeXiaomi Home 集成是小米官方支持的组件让你能在 Home Assistant开源智能家居中枢里直接使用米家智能设备。家里有一堆米家灯、插座却不被 HA 识别这个集成就是解决方案用小米账号登录导入设备列表自动生成可控制的实体。云端与本地控制都能用覆盖绝大部分米家品类。下面带你走通安装步骤并整理好高频坑点。小米米家集成能解决什么问题Home Assistant 原生不认识米家设备第三方集成还常在云接口变动后失效。这个集成由小米官方支持走的接口也是官方提供翻车概率低很多。核心能力OAuth 2.0一种不用交密码的授权登录登录不保存你的小米账号密码自动把设备的 MIoT-Spec-V2米家官方的设备描述协议翻译成实体支持多个小米账号不同账号的设备可放进同一区域13 种界面语言简体中文和英文经过人工校审版本门槛Core 2024.4.4 以上或 Operating System 13.0 以上云端控制和本地控制两条路默认走小米云集成订阅设备消息状态变化即时推送不用轮询。配置完成后只全量查询一次属性对云端压力很小。家里有小米中枢网关就能走本地控制消息留在局域网内不依赖外网。网关固件需 3.3.0_0023 以上或用内置中枢网关的设备软件 0.8.9 以上。另有局域网控制选项只支持同网段 WiFi 和网线设备官方 FAQ 明确不建议依赖它。支持哪些设备绝大部分米家品类都支持蓝牙、红外、虚拟设备三类不支持。云服务在中国大陆、欧洲、印度、俄罗斯、新加坡、美国六个地区可用配置时选地区即可跨地区设备可放进同一区域。完整说明见 中文文档。 安装步骤从零跑通的三条命令先确认版本达标然后执行下面的命令。install.sh会把组件文件拷进配置目录的custom_components下cd /path/to/HA_config git clone https://gitcode.com/GitHub_Trending/ha/ha_xiaomi_home cd ha_xiaomi_home ./install.sh /path/to/HA_config之后想升级或回退到指定版本git checkout到对应 tag 再跑一次安装脚本即可脚本逻辑见 install.sh。登录小米米家集成并导入设备重启 Home Assistant进入 设置 设备与服务 添加集成搜索 Xiaomi Home。按提示用小米账号登录弹出家庭选择框选中哪个家庭设备就导入哪些。之后想加第二个账号在集成页点添加中枢即可。 它是怎么工作的谁负责什么核心代码都在custom_components/xiaomi_home/结构简化如下custom_components/xiaomi_home/ ├── miot/ │ ├── miot_client.py # 总调度每个账号一个实例 │ ├── miot_cloud.py # 云登录与 HTTP 接口 │ ├── miot_mips.py # MQTT 消息总线 │ ├── miot_lan.py # 局域网直连 │ └── specs/ # 转换规则与多语言文件 ├── config_flow.py # 配置向导 └── light.py / switch.py # 15 实体类型文件miot_client.py是主线每条控制指令由它按当前状态分发给云、网关或局域网miot_cloud.py管登录和 HTTP 调用miot_mips.py封装 MQTT 订阅发布config_flow.py就是你看到的配置向导。小米米家集成如何把规格翻译成实体每个米家设备有一份服务描述服务下面挂属性、事件、方法。集成按规则翻译可写的布尔属性变开关有取值范围的变 number选项列表变 select只读属性变 sensor事件变 event 实体无参数的方法变 button。设备缺少必需的服务或属性时不会生成实体——这是设备在列表里但点不动的常见根因。⚙️ 进阶配置技巧开启本地控制为什么这么配中枢网关在线时指令不出局域网延迟更低断外网也能控制。确认网关固件 ≥3.3.0_0023或内置中枢设备软件 ≥0.8.9Home Assistant 会通过 mDNS局域网服务发现机制自动找到网关不用额外配置。注意中枢网关目前只在中国大陆发售。改实体名字、过滤多余实体设备名太长或翻译别扭在 miot/specs/ 下的 multi_lang.json 里补一条翻译实体冗余就把实例号写进 spec_filter.yamlurn:miot-spec-v2:device:television:0000A010:xiaomi-rmi1: services: - * # 排除该设备的全部服务改完文件必须执行 设置 设备与服务 Xiaomi Home 配置 更新实体转换规则否则不生效。用 Action 调试模式发测试指令打开Action 调试模式后带参数的方法会多出一个 Text 实体在实体里填参数即可直接下发 Action适合调试自动化前手动验证。️ 高频问题速查症状设备导入却没有实体 → 原因规格缺必需服务或被过滤 → 解法检查 spec_filter.yaml 与设备规格。症状状态变化延迟 → 原因云端订阅断开 → 解法检查主机外网连通性重启集成。症状本地模式不生效 → 原因没有中枢网关或固件旧 → 解法升级网关固件至 3.3.0_0023 以上。症状改了 specs 文件没效果 → 原因忘了应用规则 → 解法执行更新实体转换规则。症状怀疑令牌泄露 → 解法在小米账号管理页的应用授权里取消授权。实用提示导入完成后先去集成配置里选好界面语言校审过的语言实体命名会顺眼很多。【免费下载链接】ha_xiaomi_homeXiaomi Home Integration for Home Assistant项目地址: https://gitcode.com/GitHub_Trending/ha/ha_xiaomi_home创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考