如何把小米设备全部接入 Home Assistant：ha_xiaomi_home 新手指南

如何把小米设备全部接入 Home Assistantha_xiaomi_home 新手指南【免费下载链接】ha_xiaomi_homeXiaomi Home Integration for Home Assistant项目地址: https://gitcode.com/GitHub_Trending/ha/ha_xiaomi_home本文带你完成智能家居接入的全过程用 ha_xiaomi_home 把小米设备接入 Home Assistant实现集中控制与跨品牌自动化云端与本地双模式可按需切换。✅ 它到底能帮你做什么统一集中控制账号下的小米设备全部导入 Home Assistant与第三方设备在同一面板里操作跨品牌联动米家设备可与其他品牌设备一起写进自动化触发与执行自由组合本地低延迟有小米中枢网关时家中控制走局域网毫秒级响应免手动映射按设备规格自动生成实体无需逐条配置映射关系多区域管理不同区域账号的设备可导入同一区域统一管理 工作原理云端链路与本地链路云端模式经 MIoT 云中转怎么选状态推送组件在 MIoT 云内的 MQTT Broker 上订阅设备主题设备属性变化或事件发生时上报云端由 MQTT Broker 实时推给组件HA 侧无需轮询实体状态即时更新。指令下发组件通过 MIoT 云的 HTTP API 发送指令云端再转发到设备。这条链路不依赖网关只要有外网就能用适合远程场景。本地模式毫秒级响应怎么选状态推送小米中枢网关或内置中枢网关功能的设备内嵌标准 MQTT Broker组件经网关订阅设备状态在局域网内直接推送。指令下发组件把指令发布到网关的 MQTT Broker由网关转发给设备全程不出外网响应在毫秒级。两点注意中枢网关目前仅在中国大陆发售没有网关时可开启局域网控制功能但它只支持 WiFi/以太网连接的设备蓝牙 Mesh、Zigbee 设备不在其列。同一局域网存在中枢网关时即使开启了局域网控制指令也会自动改走网关本地代理。对比项云端模式本地模式响应延迟百毫秒级受外网质量影响毫秒级依赖条件MIoT 云与外网连通中枢网关局域网控制仅限 WiFi/以太网设备适用场景远程控制、家中无网关家庭自动化、低延迟、在意隐私 接入实操从安装到设备上线确认版本并安装。要求 Home Assistant Core ≥ 2024.4.4Operating System ≥ 13.0。两种方式在 HACS 商店搜索 “Xiaomi Home” 一键安装或 Git 克隆后运行安装脚本git clone https://gitcode.com/GitHub_Trending/ha/ha_xiaomi_home cd ha_xiaomi_home ./install.sh /path/to/homeassistant/config安装完成后重启 Home Assistant。添加集成、登录账号。进入 设置 → 设备与服务 → 添加集成搜索 “Xiaomi Home”用小米账号登录OAuth 授权流程不保存你的密码再选择所在区域。支持中国大陆、欧洲、印度、俄罗斯、新加坡、美国。登录成功后组件自动发现账号下的 MIoT 设备勾选即可导入。核对导入设备。在设备页检查实体是否齐全、开关与读数是否正常。跨区域设备可以导入到同一区域统一管理。可选开启本地控制。在集成配置页的 “Update LAN control configuration” 中启用局域网控制本地控制参数可在 profile_models.yaml 中调整。该功能仅覆盖 WiFi/以太网设备且可能出现异常官方建议谨慎开启。 设备与实体支持按实体类型覆盖的主要设备light智能灯泡、灯带、小夜灯switch智能插座、墙壁开关sensor温湿度、光照、烟雾、水浸传感器climate空调伴侣、智能空调fan风扇、空气循环扇humidifier智能加湿器转换由内置引擎 specv2entity.py 按 MIoT-Spec-V2 规格完成可写的布尔属性生成 Switch 实体只读数值属性生成 Sensor可写字符串生成 Text带离散值列表的生成 Select带数值区间的生成 Number设备事件转为 Event 实体动作Action转为 Button 或 Notify。你不需要手写任何映射。界面语言方面translations/ 目录提供 12 种语言。 联动场景示例会客模式门铃/门磁触发来客 → 客厅主灯调至 100%、电视开机、空调切到舒适温度。睡眠渐暗23:00 睡眠自动化启动 → 卧室灯亮度 10 分钟内降至 0窗帘关闭加湿器切夜间档。出差巡检出差时段 HA 检测到家中无人 → 核对门锁是否已锁、灯光是否全关异常则推送通知到手机。 问题排查速查设备连接失败或无法登录→ 先ping api.io.mi.com确认能连通小米云再到米家 APP 里验证该账号对设备是否有控制权限。实体状态不同步→ 重启 Xiaomi Home 集成仍异常则清除.storage/xiaomi_home.*缓存文件后重新导入。本地控制不生效→ 确认网关与 HA 在同一网段、设备为 WiFi/以太网接入有中枢网关时检查其固件版本是否达标。导入列表里没有设备→ 检查登录时所选区域是否与账号设备所在区域一致不同区域云数据相互隔离。结语小米设备接入 Home Assistant 后它们就变成可参与自动化、面板和脚本的普通实体后续只需按需添加设备即可扩展。更多细节见中文文档 doc/README_zh.md 与项目仓库内的 CHANGELOG。【免费下载链接】ha_xiaomi_homeXiaomi Home Integration for Home Assistant项目地址: https://gitcode.com/GitHub_Trending/ha/ha_xiaomi_home创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考