米家设备接入 Home Assistant官方小米 Home 集成 4 步跑通的完整指南【免费下载链接】ha_xiaomi_homeXiaomi Home Integration for Home Assistant项目地址: https://gitcode.com/GitHub_Trending/ha/ha_xiaomi_home小米 Home 集成ha_xiaomi_home是小米官方支持的 Home Assistant 自定义组件。装上并用小米账号登录后米家 App 里的灯、空调、扫地机会被自动转换开关、传感器、空调等标准实体可以直接写进场景和自动化。下面带你从安装、登录到原理与深度配置走一遍。 快速跑通四步完成安装与登录先确认 Home Assistant 版本不低于 Core 2024.4.4容器安装的配置目录一般是 /config且设备已在米家 App 中绑定。在终端进入配置目录并获取组件cd config git clone https://gitcode.com/GitHub_Trending/ha/ha_xiaomi_home.git cd ha_xiaomi_home ./install.sh /config脚本会把 xiaomi_home 目录复制到 custom_components 下并提示重启。不想用命令行也可以在 HACS 里搜 Xiaomi Home 下载或手动复制 custom_components/xiaomi_home 目录。 2. 重启 HA进入「设置 设备与服务 添加集成」搜索 Xiaomi Home。 3. 点击登录按钮在浏览器里完成 OAuth 2.0 授权跳转小米官方页面登录不保存你的小米密码。 4. 在「选择家庭与设备」对话框中勾选要导入的米家家庭与设备确认所选地区与账号一致小米云共有中国大陆、欧洲、印度、俄罗斯、新加坡、美国六个机房。验证生效接入后你会看到什么配置完成后注意这三处变化设备出现在设备列表属性按规则转成实体可写的布尔属性变 Switch带可选值的变 Select数值型变 Number只读属性变 Sensor按键类事件变 Event。在米家 App 里操作灯HA 对应实体状态应几秒内同步——它是靠消息订阅推送更新而不是定时轮询。若状态不动先看设备是否在线再到「开发者工具 日志」按 Xiaomi Home 过滤日志。 看懂原理选对控制链路组件提供三种与设备通信的链路选哪种直接影响延迟和断网可用性模式通信链路适用场景依赖条件云端模式HA 与小米云之间状态走 MQTT 订阅控制走 HTTP API远程访问、没有中枢网关公网通畅、账号登录中枢网关本地模式全部经由小米中枢网关内置 MQTT Broker局域网内收发同网低延迟、断公网仍可用中枢网关固件 3.3.0_0023 及以上或内置中枢的设备仅限中国大陆局域网控制HA 直连局域网内 IP 设备买不到中枢、只控制个别有线/WiFi 设备同一局域网仅限 IP 设备不支持蓝牙 Mesh、ZigBee云端模式默认生效。检测到中枢网关时组件会自动切换本地模式局域网控制需在集成配置里手动开启官方明确提示它可能引起异常建议只当备用。深度定制多账号、实体规则与动作调试多账号在 Xiaomi Home 集成页点「添加中枢」登录另一个小米账号不同账号的设备可以放进同一个区域。实体转换规则实体转换规则 目录下的 spec_filter.yaml、spec_modify.yaml、multi_lang.json 可用来过滤不想要的属性、修改单位、补充设备名翻译改完后要到集成配置里点「更新实体转换规则」才生效。动作调试模式配置项中开启 Debug mode for action会生成可发送带参数动作指令的 Text 实体适合测试设备接口。关键文件作用config_flow.py配置流程登录、地区选择、设备过滤miot/miot_cloud.py云端 OAuth、拉设备列表、发指令miot/miot_mips.pyMQTT 消息总线订阅状态与事件miot/miot_lan.py局域网设备发现与直连控制卡住了怎么办登录或拉取设备失败检查配置选项里地区是否与账号一致重跑配置流程确认 HA 能正常访问小米云。某些设备始终不出现蓝牙、红外、虚拟设备这三类暂不支持。实体不刷新、连接中断确认设备在线中枢网关掉线时 HA 首页会有通知组件会自动重连。怀疑令牌泄露米家 App 我的 用户名 应用授权找到 Xiaomi Home 取消授权即可。想深入开发可以看 中文贡献指南把事件实体接进自动化前建议先用动作调试模式验证一次设备响应。【免费下载链接】ha_xiaomi_homeXiaomi Home Integration for Home Assistant项目地址: https://gitcode.com/GitHub_Trending/ha/ha_xiaomi_home创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
