把米家设备装进 Home Assistant米家集成完整指南【免费下载链接】ha_xiaomi_homeXiaomi Home Integration for Home Assistant项目地址: https://gitcode.com/GitHub_Trending/ha/ha_xiaomi_home你喊过小爱同学关灯却没让 Home Assistant 听懂吗Home Assistant 米家集成项目名 ha_xiaomi_home就是干这一件事的把你米家账号下的设备接进 Home Assistant让它们能被自动化、场景和语音助手统一调度。它由小米官方支持设备状态走消息订阅推送不是笨办法式的定时轮询登录用 OAuth 2.0集成本身不保存你的账号密码。一句话它解决的是米家设备散落在米家 App 里进不了 HA 自动化这个真实痛点。从 0 到跑通装好并接入第一台设备先花 30 秒确认版本在 Home Assistant 的设置 → 关于里看两处Core 版本要 ≥ 2024.4.4操作系统版本要 ≥ 13.0。不达标就先升级后面所有步骤都建立在它之上。拿到代码装进 config登录 Home Assistant 的终端按顺序执行cd /config git clone https://gitcode.com/GitHub_Trending/ha/ha_xiaomi_home cd ha_xiaomi_home ./install.sh /configinstall.sh会把custom_components/xiaomi_home复制到你的config/custom_components下并自动清掉旧版本。装完重启 Home Assistant。以后想固定到某个版本也不用重新下载cd /config/ha_xiaomi_home git fetch git checkout v1.0.0 ./install.sh /config不想折腾 git 的话还有两条路HACS 社区商店里搜 Xiaomi Home 一键下载或者手动把custom_components/xiaomi_home整个文件夹拷进config/custom_components。登录并勾选设备重启后走一遍配置流程设置 → 设备与服务 → 添加集成 → 搜Xiaomi Home→ 用小米账号授权登录 → 在选择家庭与设备弹窗里勾选要导入的家庭 → 完成。几十秒后设备就会以 HA 原生实体的形式出现在你的系统里。能力版图它到底能做什么先看一张横向对比再列清单。能力项米家 App常见第三方插件ha_xiaomi_home控制通道小米云多为云端或单一局域网云端 本地双通道多账号手动切换多数只支持 1 个支持多账号并存跨地区设备按地区隔离较少涉及可导入同一 HA 区域进 HA 自动化/场景/仪表盘不可视插件而定原生实体直接引用状态同步方式App 内刷新轮询居多MQTT 订阅推送免轮询再补一份能力清单米家设备按 MIoT-Spec-V2 规范自动转成 HA 实体传感器、开关、灯、空调、风扇、窗帘、扫地机、取电、热水器、媒体播放器等平台目录见 custom_components/xiaomi_home/。多账号不同小米账号的设备可以放进同一个 HA 区域互不干扰。跨地区云服务部署在中国大陆、欧洲、印度、俄罗斯、新加坡、美国六地数据按地区隔离导入时选对地区即可。Action 调试模式给带参数的指令开一个文本实体入口方便手动发指令做调试。配置入口改昵称、重新同步设备列表、开调试模式都在设置 → 设备与服务 → 已配置 → Xiaomi Home → 配置里。更多细节含 MIoT-Spec-V2 到 HA 实体的映射规则见官方说明 doc/README_zh.md。云端还是本地两种控制模式的工作原理把云端控制想成打电话给中转站你的指令先发到小米云云再转给设备设备状态变化也先上报到云云再推给你。它的好处是不挑设备、不挑地区坏处是离不开网。本地控制则像直接按手里的遥控器小米中枢网关里自带一个标准 MQTT Broker集成直接连它订阅和下发都发生在你的局域网内不绕公网。断网的时候这条链路照样工作。两个关键事实真正的本地控制依赖中枢网关。需要小米中枢网关固件 3.3.0_0023 及以上或内置中枢网关的米家设备软件 0.8.9 及以上。中枢网关目前仅在中国大陆销售海外地区没有网关可用就默认走云端。没有网关时指令全部经小米云下发有网关时本地链路优先生效。还有个局域网控制开关只覆盖同局域网内走 WiFi/网线的 IP 设备管不到蓝牙 Mesh、ZigBee 设备且官方明说它可能引发异常、不建议开启。能用中枢网关就别用它。什么时候选哪种你的情况建议有中枢网关追求响应速度和断网可用走本地控制设备分散在多个地区、没有网关云端控制需要远程控制人在外面云端控制场景化玩法让设备替你想着做接入之后米家设备就是普通的 HA 实体下面这些玩法都能直接写进自动化。回家模式手机回到家里区域触发客厅灯。给条件加一道光照度判断白天就不亮灯避免大中午也开灯alias: 回家开灯 trigger: - platform: zone zone: zone_home entity_id: device_tracker.你的手机 event: enter condition: - condition: sun after: sunset action: - service: light.turn_on target: entity_id: light.客厅灯离家安防离家时一键关灯关电器扫地机出门开工alias: 离家清理 trigger: - platform: zone zone: zone_home entity_id: device_tracker.你的手机 event: leave action: - service: homeassistant.turn_off target: area_id: living_room - service: vacuum.start门窗传感器、人体传感器接入后会变成 HA 的传感器/事件实体直接写进触发条件即可门窗打开 离家状态 → 推送通知。照明随天走用太阳位置做触发日出前调亮、日落后转暖模拟自然光过渡。传感器读数光照、色温都是实体自动化里拖一下就能用。环境监测联动温湿度传感器、PM2.5 传感器接入后阈值判断就是普通条件alias: 太干就加湿 trigger: - platform: numeric_state entity_id: sensor.卧室湿度 below: 40 action: - service: switch.turn_on target: entity_id: switch.加湿器去年冬天那种出差忘了关加湿器的情况现在交给自动化兜底就行。安心使用安全与避坑先把安全说清楚登录走 OAuth 2.0集成不保存你的小米账号密码这一点可以放心。但登录成功后设备信息、证书、token 会明文存在 Home Assistant 的配置文件里平台限制改不了。所以真正要守的是/config目录本身的权限别把它暴露给不该看的人。怀疑授权泄露时去米家 App → 我的 → 用户名 → 应用授权里把 Xiaomi Home (Home Assistant Integration) 的授权撤掉重新配一遍即可。多账号场景下每个账号都单独授权定期回 App 里看一眼授权列表是好习惯。常见问题速查现象排查方向设备没出现在 HA先在米家 App 里确认设备已添加且在线蓝牙、红外、虚拟设备这三类不支持局域网控制开了没用或出了异常官方不推荐此功能本地局域网里若存在中枢网关局域网控制也不会生效。能用中枢网关就走本地控制导入时选不了设备不同地区的小米云数据隔离导入时选的用户地区要和设备归属一致想用本地控制但没有效果确认你有中枢网关固件 3.3.0_0023或内置中枢的设备软件 0.8.9且在中枢网关可购买/可用的地区写在最后Home Assistant 米家集成把米家设备进不了 HA这件事补齐了双通道控制、多账号、原生实体、消息推送都是官方在维护的。现在就动手吧按从 0 到跑通那节装好挑一盏你最常用的灯接入写出第一条回家开灯自动化。剩下的交给时间。【免费下载链接】ha_xiaomi_homeXiaomi Home Integration for Home Assistant项目地址: https://gitcode.com/GitHub_Trending/ha/ha_xiaomi_home创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 把米家设备装进 Home Assistant：米家集成完整指南
把米家设备装进 Home Assistant米家集成完整指南【免费下载链接】ha_xiaomi_homeXiaomi Home Integration for Home Assistant项目地址: https://gitcode.com/GitHub_Trending/ha/ha_xiaomi_home你喊过小爱同学关灯却没让 Home Assistant 听懂吗Home Assistant 米家集成项目名 ha_xiaomi_home就是干这一件事的把你米家账号下的设备接进 Home Assistant让它们能被自动化、场景和语音助手统一调度。它由小米官方支持设备状态走消息订阅推送不是笨办法式的定时轮询登录用 OAuth 2.0集成本身不保存你的账号密码。一句话它解决的是米家设备散落在米家 App 里进不了 HA 自动化这个真实痛点。从 0 到跑通装好并接入第一台设备先花 30 秒确认版本在 Home Assistant 的设置 → 关于里看两处Core 版本要 ≥ 2024.4.4操作系统版本要 ≥ 13.0。不达标就先升级后面所有步骤都建立在它之上。拿到代码装进 config登录 Home Assistant 的终端按顺序执行cd /config git clone https://gitcode.com/GitHub_Trending/ha/ha_xiaomi_home cd ha_xiaomi_home ./install.sh /configinstall.sh会把custom_components/xiaomi_home复制到你的config/custom_components下并自动清掉旧版本。装完重启 Home Assistant。以后想固定到某个版本也不用重新下载cd /config/ha_xiaomi_home git fetch git checkout v1.0.0 ./install.sh /config不想折腾 git 的话还有两条路HACS 社区商店里搜 Xiaomi Home 一键下载或者手动把custom_components/xiaomi_home整个文件夹拷进config/custom_components。登录并勾选设备重启后走一遍配置流程设置 → 设备与服务 → 添加集成 → 搜Xiaomi Home→ 用小米账号授权登录 → 在选择家庭与设备弹窗里勾选要导入的家庭 → 完成。几十秒后设备就会以 HA 原生实体的形式出现在你的系统里。能力版图它到底能做什么先看一张横向对比再列清单。能力项米家 App常见第三方插件ha_xiaomi_home控制通道小米云多为云端或单一局域网云端 本地双通道多账号手动切换多数只支持 1 个支持多账号并存跨地区设备按地区隔离较少涉及可导入同一 HA 区域进 HA 自动化/场景/仪表盘不可视插件而定原生实体直接引用状态同步方式App 内刷新轮询居多MQTT 订阅推送免轮询再补一份能力清单米家设备按 MIoT-Spec-V2 规范自动转成 HA 实体传感器、开关、灯、空调、风扇、窗帘、扫地机、取电、热水器、媒体播放器等平台目录见 custom_components/xiaomi_home/。多账号不同小米账号的设备可以放进同一个 HA 区域互不干扰。跨地区云服务部署在中国大陆、欧洲、印度、俄罗斯、新加坡、美国六地数据按地区隔离导入时选对地区即可。Action 调试模式给带参数的指令开一个文本实体入口方便手动发指令做调试。配置入口改昵称、重新同步设备列表、开调试模式都在设置 → 设备与服务 → 已配置 → Xiaomi Home → 配置里。更多细节含 MIoT-Spec-V2 到 HA 实体的映射规则见官方说明 doc/README_zh.md。云端还是本地两种控制模式的工作原理把云端控制想成打电话给中转站你的指令先发到小米云云再转给设备设备状态变化也先上报到云云再推给你。它的好处是不挑设备、不挑地区坏处是离不开网。本地控制则像直接按手里的遥控器小米中枢网关里自带一个标准 MQTT Broker集成直接连它订阅和下发都发生在你的局域网内不绕公网。断网的时候这条链路照样工作。两个关键事实真正的本地控制依赖中枢网关。需要小米中枢网关固件 3.3.0_0023 及以上或内置中枢网关的米家设备软件 0.8.9 及以上。中枢网关目前仅在中国大陆销售海外地区没有网关可用就默认走云端。没有网关时指令全部经小米云下发有网关时本地链路优先生效。还有个局域网控制开关只覆盖同局域网内走 WiFi/网线的 IP 设备管不到蓝牙 Mesh、ZigBee 设备且官方明说它可能引发异常、不建议开启。能用中枢网关就别用它。什么时候选哪种你的情况建议有中枢网关追求响应速度和断网可用走本地控制设备分散在多个地区、没有网关云端控制需要远程控制人在外面云端控制场景化玩法让设备替你想着做接入之后米家设备就是普通的 HA 实体下面这些玩法都能直接写进自动化。回家模式手机回到家里区域触发客厅灯。给条件加一道光照度判断白天就不亮灯避免大中午也开灯alias: 回家开灯 trigger: - platform: zone zone: zone_home entity_id: device_tracker.你的手机 event: enter condition: - condition: sun after: sunset action: - service: light.turn_on target: entity_id: light.客厅灯离家安防离家时一键关灯关电器扫地机出门开工alias: 离家清理 trigger: - platform: zone zone: zone_home entity_id: device_tracker.你的手机 event: leave action: - service: homeassistant.turn_off target: area_id: living_room - service: vacuum.start门窗传感器、人体传感器接入后会变成 HA 的传感器/事件实体直接写进触发条件即可门窗打开 离家状态 → 推送通知。照明随天走用太阳位置做触发日出前调亮、日落后转暖模拟自然光过渡。传感器读数光照、色温都是实体自动化里拖一下就能用。环境监测联动温湿度传感器、PM2.5 传感器接入后阈值判断就是普通条件alias: 太干就加湿 trigger: - platform: numeric_state entity_id: sensor.卧室湿度 below: 40 action: - service: switch.turn_on target: entity_id: switch.加湿器去年冬天那种出差忘了关加湿器的情况现在交给自动化兜底就行。安心使用安全与避坑先把安全说清楚登录走 OAuth 2.0集成不保存你的小米账号密码这一点可以放心。但登录成功后设备信息、证书、token 会明文存在 Home Assistant 的配置文件里平台限制改不了。所以真正要守的是/config目录本身的权限别把它暴露给不该看的人。怀疑授权泄露时去米家 App → 我的 → 用户名 → 应用授权里把 Xiaomi Home (Home Assistant Integration) 的授权撤掉重新配一遍即可。多账号场景下每个账号都单独授权定期回 App 里看一眼授权列表是好习惯。常见问题速查现象排查方向设备没出现在 HA先在米家 App 里确认设备已添加且在线蓝牙、红外、虚拟设备这三类不支持局域网控制开了没用或出了异常官方不推荐此功能本地局域网里若存在中枢网关局域网控制也不会生效。能用中枢网关就走本地控制导入时选不了设备不同地区的小米云数据隔离导入时选的用户地区要和设备归属一致想用本地控制但没有效果确认你有中枢网关固件 3.3.0_0023或内置中枢的设备软件 0.8.9且在中枢网关可购买/可用的地区写在最后Home Assistant 米家集成把米家设备进不了 HA这件事补齐了双通道控制、多账号、原生实体、消息推送都是官方在维护的。现在就动手吧按从 0 到跑通那节装好挑一盏你最常用的灯接入写出第一条回家开灯自动化。剩下的交给时间。【免费下载链接】ha_xiaomi_homeXiaomi Home Integration for Home Assistant项目地址: https://gitcode.com/GitHub_Trending/ha/ha_xiaomi_home创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考