ha_xiaomi_home小米设备接入 Home Assistant 快速上手教程【免费下载链接】ha_xiaomi_homeXiaomi Home Integration for Home Assistant项目地址: https://gitcode.com/GitHub_Trending/ha/ha_xiaomi_home小米设备一多每个都有自己的 App来回切换很折腾。ha_xiaomi_home 是小米官方支持的 Home Assistant 集成组件把分散的设备控制收进一个面板。这是写给想在 5 分钟内把小米设备接进 Home Assistant 的零基础上手教程。你大概率踩过这些坑打开手机一半图标是米家系 App想收拢到 Home Assistant第一道坎常常是没有官方组件。ha_xiaomi_home 是小米官方支持的组件用小米账号登录后账号下的设备可以直接导入 Home Assistant一个面板管全部。还有人用第三方方式手动加过设备结果实体名称混乱、属性不全写自动化条件时很头疼。这个组件按小米 MIoT 规范把设备自动转换成灯、开关、传感器等标准实体开箱就有正经名字场景可直接引用。还有常见的担心走云控制慢、不稳定网络一断就不灵。如果你家里有小米中枢网关指令可以直接在局域网下发不必绕出公网。如何配置 ha_xiaomi_home5 步从零到全部设备接入环境满足条件后5 步就能让第一台设备出现在 Home Assistant 里。前提核心版本 ≥ 2024.4.4且设备已在米家 App 中完成绑定。第 1 步克隆项目代码把仓库放到 Home Assistant 配置目录下cd HA 配置目录 git clone https://gitcode.com/GitHub_Trending/ha/ha_xiaomi_home第 2 步运行安装脚本脚本参数是 HA 配置目录的绝对路径组件会被复制进 custom_components 子目录cd ha_xiaomi_home bash install.sh /config[!TIP] 运行完脚本后需重启 Home Assistant。日后更新只需切到新版本的 tag 再跑一次脚本旧版本会由脚本自动处理。第 3 步添加集成并登录小米账号进入 设置 → 设备与服务 → 添加集成搜索 Xiaomi Home用小米账号完成 OAuth 登录。官方组件不会保存你的账号密码。第 4 步选择要导入的家居和设备在选择家居和设备弹窗中勾选要导入的家居确认后设备列表会陆续出现在 Home Assistant 中。[!TIP] 多个小米账号的设备不能同时登录在已配置好的 Xiaomi Home 页面点添加中枢再登第二个账号不同账号的设备可以放进同一房间。第 5 步分配房间并写第一条自动化在集成的 CONFIGURE 页可以修改房间归属、设备名称从此就能写传感器触发 → 开灯这类场景。它背后在做什么ha_xiaomi_home 的云端与本地两条通道集成跑起来后值得先搞清一件事指令从哪里发出去状态又从哪里回来ha_xiaomi_home 支持两条通道且都是消息驱动而不是定期挨个问云端通道状态上行、指令下行。设备属性变化properties_changed由小米云里的 MQTT Broker 推送给集成控制指令走 HTTP 下发。配置完成时拉取一次全量设备之后不再有轮询压力。本地通道有小米中枢网关时MQTT Broker 就摆在网关上状态与指令全程走局域网延迟明显更低。集成靠 mDNS 广播发现网关逻辑见miot_mdns.py消息收发走内部消息总线miot_mips.py。把它想成家庭配电箱每个设备占一路这一路有变化时配电箱对应位置立刻贴上告示MQTT 主题Home Assistant 不用挨个插座巡视只订阅告示即可要控制设备时往同一路上贴一张回执单设备自然收到。[!TIP] 本地通道依赖小米中枢网关固件 ≥ 3.3.0_0023目前仅中国大陆发售其他地区以云端模式为主。LAN 控制选项只覆盖 WiFi/网口设备官方不建议启用。遇到问题时查这里用下来常见的小卡点基本就这四种登录后看不到设备——小米云数据按地区隔离导入时选对地区跨账号设备用添加中枢再登一次。控制慢、偶发无响应——云端模式指令要出公网有中枢网关会走本地模式否则检查 HA 机器外网是否稳定。实体名是英文或翻译不对——设备多语言包未同步在集成的 CONFIGURE 页点更新实体转换规则。网关下的子设备局域网控制不了——LAN 控制只覆盖 IP 设备BLE/ZigBee 子设备仍需经网关或云端。 核心要点官方组件无需魔改协议云端保底本地更快实体自动转换开箱即用想深入实体转换规则和多语言包格式可以翻仓库里的中文贡献指南配套中文 README也值得一读。【免费下载链接】ha_xiaomi_homeXiaomi Home Integration for Home Assistant项目地址: https://gitcode.com/GitHub_Trending/ha/ha_xiaomi_home创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考