尧图网站建设 
米家设备接入Home Assistant三步完成本地云端双通道完整教程【免费下载链接】ha_xiaomi_homeXiaomi Home Integration for Home Assistant项目地址: https://gitcode.com/GitHub_Trending/ha/ha_xiaomi_home空气净化器、智能灯、扫地机都是小米的可想让它们进 Home Assistant 的自动化一直没有官方入口社区的各种野路子稳定性全靠运气。ha_xiaomi_home 是小米官方出品的 Home Assistant 集成把米家设备接入 Home Assistant一步到位本地、云端两条通道都支持现有设备不用换、配法也不用改。ha_xiaomi_home 是什么官方出品的米家-HA 桥梁给谁用手里有米家设备、想让 Home Assistant 管起来的人。核心价值一个组件收编全部小米设备实体自动长出来不写任何映射代码。能力说明多账号同实例多个小米账号的米家家庭可导入同一个 Home Assistant统一仪表盘管理本地/云端双通道局域网有中枢网关走本地直连没有就走小米云两边都能兜住推送代替轮询设备属性一变立即推送到集成状态零滞后云端访问压力小实体自动生成读取 MIoT-Spec-V2小米官方的设备能力描述文件写清了属性/事件/方法自动转成 switch、sensor、climate 等实体实体名多语言支持 13 种语言属性名自动翻译中文界面开箱就是中文三步跑通装 / 配 / 验装克隆代码执行安装脚本环境要求Home AssistantCore ≥ 2024.4.4、Operating System ≥ 13.0。在 HA 所在服务器上cd config git clone https://gitcode.com/GitHub_Trending/ha/ha_xiaomi_home cd ha_xiaomi_home ./install.sh /path/to/your/homeassistant/configinstall.sh 会把组件复制进custom_components目录随后重启 Home Assistant 即完成安装。配OAuth 登录选对地区再选家庭进设置 → 设备与服务 → 添加集成搜Xiaomi Home进入登录页。登录走 OAuth 2.0密码不会存进 HA但地区必须选对中国、欧洲、美国等——不同地区的设备在不同云上选错就导不出设备。登录后弹出选择家庭与设备勾选米家家庭该家庭下设备全部导入。验实体列表里确认设备到位刷新设备列表空气净化器和灯应该已经出现在实体里。升级版本时回到克隆目录切 Tag 再跑一次脚本cd config/ha_xiaomi_home git fetch git checkout 你想切到的tag ./install.sh /path/to/your/config控制机制拆解状态靠推指令有两条路云端通道订阅小米云的消息中心云端控制架构集成订阅小米云 MQTT Broker状态上行推送、指令下行经 HTTP API 转发打个比方这像小区物业代收快递——你不必每小时跑去收发室问包裹到了没包裹一到物业就打电话给你。对应到技术上集成在小米云的 MQTT Broker负责消息订阅与发布的中间件上订阅设备消息通道属性变化或事件触发时云端把properties_changed、event等消息实时推过来。配置完成时只查一次全量属性之后不再轮询。控制指令走反方向通过 HTTP API 发set_properties或action到云端再转发给设备。本地通道中枢网关内置的 MQTT Broker本地控制架构中枢网关内置 MQTT Broker 全程在局域网内转发无需出外网家里有一台小米中枢网关固件3.3.0_0023及以上时它内部自带一个标准 MQTT Broker。集成直接向网关订阅设备消息控制指令发布到 Broker 后由网关转给设备全程不出局域网。两条通道同时可用时本地优先。云端通道本地通道前提小米云账号中枢网关固件 ≥ 3.3.0_0023状态更新云端 MQTT 推送网关 MQTT 推送指令路径HTTP API → 小米云 → 设备发布到网关 Broker → 网关转发优先级兜底可用时优先实体生成MIoT-Spec-V2 的自动映射每台设备的 MIoT-Spec-V2 描述会被拿去匹配内置转换规则这就是不同设备长出不一样实体组合的原因属性可写布尔 → switch可写枚举/数值 → select / number只读 → sensor事件→ event方法无入参 → button有入参 → notify规则与翻译在 specs 目录multi_lang.json 本地补充翻译、spec_filter.yaml 过滤冗余实例。改完要在集成配置里点更新实体转换规则才生效。排障与进阶 登录后台设备不显示→ 蓝牙、红外和部分虚拟设备暂不支持或登录时选错了用户地区 → 先在米家 App 确认设备已绑定该账号再在配置流程里选对地区重新导入。控制指令响应偏慢→ 局域网内没有中枢网关指令只能绕道小米云 → 加装中枢网关后本地直连自动优先配置里的局域网控制开关不建议拿来顶替官方文档标注它可能引发异常。实体名是英文或一堆没用实体→ 云端翻译不全、冗余 spec 实例默认未过滤 → 修改 specs 目录下的 multi_lang.json 与 spec_filter.yaml再到集成配置点更新实体转换规则。想同时管两个小米账号 / 看内部行为→ 一个账号只导入一套家庭 → 在 Xiaomi Home 配置页选添加中枢再登录一次把custom_components.xiaomi_home的日志级别调成 debug 可观察内部收发过程。更细的 MIoT-Spec-V2 转换表与过滤规则见中文文档。状态顺着通道自己送上门指令有路走云端、也有路走网关——快和远都有得选。【免费下载链接】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 的自动化一直没有官方入口社区的各种野路子稳定性全靠运气。ha_xiaomi_home 是小米官方出品的 Home Assistant 集成把米家设备接入 Home Assistant一步到位本地、云端两条通道都支持现有设备不用换、配法也不用改。ha_xiaomi_home 是什么官方出品的米家-HA 桥梁给谁用手里有米家设备、想让 Home Assistant 管起来的人。核心价值一个组件收编全部小米设备实体自动长出来不写任何映射代码。能力说明多账号同实例多个小米账号的米家家庭可导入同一个 Home Assistant统一仪表盘管理本地/云端双通道局域网有中枢网关走本地直连没有就走小米云两边都能兜住推送代替轮询设备属性一变立即推送到集成状态零滞后云端访问压力小实体自动生成读取 MIoT-Spec-V2小米官方的设备能力描述文件写清了属性/事件/方法自动转成 switch、sensor、climate 等实体实体名多语言支持 13 种语言属性名自动翻译中文界面开箱就是中文三步跑通装 / 配 / 验装克隆代码执行安装脚本环境要求Home AssistantCore ≥ 2024.4.4、Operating System ≥ 13.0。在 HA 所在服务器上cd config git clone https://gitcode.com/GitHub_Trending/ha/ha_xiaomi_home cd ha_xiaomi_home ./install.sh /path/to/your/homeassistant/configinstall.sh 会把组件复制进custom_components目录随后重启 Home Assistant 即完成安装。配OAuth 登录选对地区再选家庭进设置 → 设备与服务 → 添加集成搜Xiaomi Home进入登录页。登录走 OAuth 2.0密码不会存进 HA但地区必须选对中国、欧洲、美国等——不同地区的设备在不同云上选错就导不出设备。登录后弹出选择家庭与设备勾选米家家庭该家庭下设备全部导入。验实体列表里确认设备到位刷新设备列表空气净化器和灯应该已经出现在实体里。升级版本时回到克隆目录切 Tag 再跑一次脚本cd config/ha_xiaomi_home git fetch git checkout 你想切到的tag ./install.sh /path/to/your/config控制机制拆解状态靠推指令有两条路云端通道订阅小米云的消息中心云端控制架构集成订阅小米云 MQTT Broker状态上行推送、指令下行经 HTTP API 转发打个比方这像小区物业代收快递——你不必每小时跑去收发室问包裹到了没包裹一到物业就打电话给你。对应到技术上集成在小米云的 MQTT Broker负责消息订阅与发布的中间件上订阅设备消息通道属性变化或事件触发时云端把properties_changed、event等消息实时推过来。配置完成时只查一次全量属性之后不再轮询。控制指令走反方向通过 HTTP API 发set_properties或action到云端再转发给设备。本地通道中枢网关内置的 MQTT Broker本地控制架构中枢网关内置 MQTT Broker 全程在局域网内转发无需出外网家里有一台小米中枢网关固件3.3.0_0023及以上时它内部自带一个标准 MQTT Broker。集成直接向网关订阅设备消息控制指令发布到 Broker 后由网关转给设备全程不出局域网。两条通道同时可用时本地优先。云端通道本地通道前提小米云账号中枢网关固件 ≥ 3.3.0_0023状态更新云端 MQTT 推送网关 MQTT 推送指令路径HTTP API → 小米云 → 设备发布到网关 Broker → 网关转发优先级兜底可用时优先实体生成MIoT-Spec-V2 的自动映射每台设备的 MIoT-Spec-V2 描述会被拿去匹配内置转换规则这就是不同设备长出不一样实体组合的原因属性可写布尔 → switch可写枚举/数值 → select / number只读 → sensor事件→ event方法无入参 → button有入参 → notify规则与翻译在 specs 目录multi_lang.json 本地补充翻译、spec_filter.yaml 过滤冗余实例。改完要在集成配置里点更新实体转换规则才生效。排障与进阶 登录后台设备不显示→ 蓝牙、红外和部分虚拟设备暂不支持或登录时选错了用户地区 → 先在米家 App 确认设备已绑定该账号再在配置流程里选对地区重新导入。控制指令响应偏慢→ 局域网内没有中枢网关指令只能绕道小米云 → 加装中枢网关后本地直连自动优先配置里的局域网控制开关不建议拿来顶替官方文档标注它可能引发异常。实体名是英文或一堆没用实体→ 云端翻译不全、冗余 spec 实例默认未过滤 → 修改 specs 目录下的 multi_lang.json 与 spec_filter.yaml再到集成配置点更新实体转换规则。想同时管两个小米账号 / 看内部行为→ 一个账号只导入一套家庭 → 在 Xiaomi Home 配置页选添加中枢再登录一次把custom_components.xiaomi_home的日志级别调成 debug 可观察内部收发过程。更细的 MIoT-Spec-V2 转换表与过滤规则见中文文档。状态顺着通道自己送上门指令有路走云端、也有路走网关——快和远都有得选。【免费下载链接】ha_xiaomi_homeXiaomi Home Integration for Home Assistant项目地址: https://gitcode.com/GitHub_Trending/ha/ha_xiaomi_home创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考