尧图网站建设 
小米设备接入 Home Assistant 指南选对控制方式五步完成连接【免费下载链接】ha_xiaomi_homeXiaomi Home Integration for Home Assistant项目地址: https://gitcode.com/GitHub_Trending/ha/ha_xiaomi_homeXiaomi Home米家集成是小米官方支持的 Home Assistant 集成组件登录小米账号后可以把米家设备全部导入 Home Assistant实现跨品牌设备的统一管理、自动化与场景联动。本文用新手能看懂的方式讲清云端还是本地控制怎么选、如何完成安装登录、多账号怎么管以及常见问题怎么处理。为什么要把小米设备接入 Home Assistant小米生态链设备好用但有个现实问题米家 App 只能管理米家体系内的设备。家里如果同时有小米的门磁、其他品牌的灯和空调想开门磁时关灯、开空调在米家 App 里是做不到的。Home Assistant 解决的就是这件事。它本身不认识小米设备装完 Xiaomi Home 集成后小米设备会像原生设备一样出现在系统里之后所有品牌设备的开关、状态放在同一个仪表盘上自动化可以用任何设备的状态做触发条件不再受单个 App 的限制场景、仪表盘、语音控制都能跨品牌使用。接入后你能拿到什么覆盖大部分米家品类灯、插座开关、空调、空气净化器、加湿器、扫地机、热水器、音箱媒体播放器、门窗传感器二进制传感器等。小米按 MIoT 规范把设备功能自动转成 Home Assistant 实体——可写的属性变成开关、数值、选项只读属性变成传感器事件变成事件实体动作变成按钮或通知实体。有少数品类不支持蓝牙设备、红外设备、虚拟设备。这三类接不进来选型时先排除。云端还是本地一分钟选对控制方式接入前唯一要做的决定是控制指令走哪条路。差别只在命令经过谁的手。云端控制兼容好开箱即用没有额外硬件时指令从 Home Assistant 发到小米云再转到设备设备状态变化则由云端的 MQTT 订阅机制直接推送给集成不需要反复轮询所以设备多也不会给云端造成压力。好处很直接不挑设备、不加硬件装好就能用人在外面也能控制家里设备远程访问是标配缺点是指令要绕道公网家里断网就无法控制。云端控制的完整实现在 custom_components/xiaomi_home/miot/miot_cloud.py。本地控制低延迟断网可用本地控制需要一台小米中枢网关固件 ≥ 3.3.0_0023或一台内置中枢网关功能的米家设备软件 ≥ 0.8.9。中枢网关内部自带标准 MQTT BrokerHome Assistant 直接向网关订阅消息、发布指令全程走局域网。局域网内响应更快断网也能控制数据不出家门隐私上更干净限制中枢网关目前仅在中国大陆销售其他地区用不了。本地控制的完整实现在 custom_components/xiaomi_home/miot/miot_lan.py中枢网关的局域网发现逻辑在 custom_components/xiaomi_home/miot/miot_mdns.py。另外还有个局域网控制选项可以直控同一局域网内带 IP 的设备Wi-Fi 或网线连接但控制不了蓝牙 Mesh、ZigBee 设备官方文档提示该功能可能引起异常建议不要开启。有中枢网关时它也不会生效。对照表怎么选对比项云端控制本地控制中枢网关响应速度经过云端略有延迟局域网内响应更快隐私指令与状态经过小米云数据不出局域网远程访问支持任何地方都能控制仅限家庭网络硬件要求无中枢网关或内置中枢设备地区限制无支持中国大陆、欧洲、印度、俄罗斯、新加坡、美国中枢网关仅中国大陆有售一句话结论没有中枢网关就用云端这是大多数新手的路径有中枢网关、又在意延迟和隐私就切本地控制。小米设备接入 Home Assistant 的 5 个步骤第 1 步确认 Home Assistant 版本Core ≥ 2024.4.4Operating System 安装方式 ≥ 13.0。版本不够先升级这是所有安装方式的前提。第 2 步安装 Xiaomi Home 集成三种方式任选其一方式 AHACS多数人首选。打开 HACS搜索 Xiaomi Home进入详情页下载即可。方式 BGit clone官方推荐方便锁定版本。进入 config 目录执行git clone https://gitcode.com/GitHub_Trending/ha/ha_xiaomi_home cd ha_xiaomi_home ./install.sh /config第一条命令把仓库拉到 config 目录下install.sh /config会自动把集成复制到custom_components并提示重启。以后想固定某个版本切到对应 tag 再跑一遍脚本即可。方式 C手动复制。通过 Samba 或 FTP把custom_components/xiaomi_home整个文件夹拷到 Home Assistant 的config/custom_components下。装完记得重启 Home Assistant否则集成不会出现。第 3 步添加集成并登录小米账号依次进入设置 设备与服务 添加集成 搜索 Xiaomi Home 下一步 点击登录按页面提示用小米账号完成授权。配置流程的实现在 custom_components/xiaomi_home/config_flow.py。登录走的是 OAuth 2.0 授权账号密码不会存进 Home Assistant这一点可以放心。第 4 步选择地区与家庭导入设备配置过程中要先选择所在地区。小米云的数据按地区隔离当前支持中国大陆、欧洲、印度、俄罗斯、新加坡、美国六个地区选错地区就会看不到设备。登录成功后弹出选择家庭与设备对话框选中要导入的米家家庭该家庭下的设备会一并导入。第 5 步验证设备实体打开设备页面确认每个设备都生成了实体门窗传感器有事件实体、空调有 climate 实体、灯有 light 实体。把它们拖进对应区域客厅、卧室就可以开始写场景和自动化了。关于账号安全记住两件事密码不保存但登录成功后设备信息、证书、token 等凭据会明文存放在 Home Assistant 的配置文件中这是 HA 平台的限制。配置文件泄露等于账号授权泄露请保管好配置目录。怀疑 token 泄露时去米家 App 撤销授权我的 点击用户名进入小米账号页面 应用授权 Xiaomi Home (Home Assistant Integration) 取消授权。从能用到好用多账号管理、自动化场景与规格扩展多账号管理家人名下的设备也接进来一个家庭里设备分散在多个小米账号下很常见。第一个账号配置完成后进入 设置 设备与服务 已配置 Xiaomi Home 添加中枢再登录另一个小米账号即可。不同账号、甚至不同地区的设备都可以放进同一个区域统一管理。先写这三组自动化离家模式触发条件设成所有手机device_tracker 实体离开家动作是关闭全部灯和插座、启动扫地机。回家模式晚上到家开门时门磁事件实体触发打开客厅灯、空调切到预设温度。睡眠模式定时触发卧室灯调至最低亮度加湿器设到睡眠湿度。小提示小米设备的事件门磁触发、开关双击、传感器报警等都会转成 Home Assistant 的事件实体可以直接在自动化里做触发条件不需要额外写轮询。设备规格扩展修正和补充实体个别设备的实体翻译不对、或者该有的实体没生成时可以改 custom_components/xiaomi_home/miot/specs/ 目录下的规则文件spec_add.json补充额外的实体转换规则spec_filter.yaml/spec_modify.yaml过滤不需要的实体、修改已有转换multi_lang.json本地维护的多语言字典优先级高于云端下载的文件适合修正实体名称。改完文件不会自动生效要到集成页面点CONFIGURE 更新实体转换规则。集成共支持 13 种界面语言简中、繁中、英文、西班牙语、俄语、法语、德语、日语、意大利语、荷兰语、葡萄牙语、巴西葡萄牙语、土耳其语在配置流程的语言选项里选。翻译文件在 custom_components/xiaomi_home/translations/。Action 调试模式验证自动化是否发对了指令在配置项里开启Action 调试模式后集成会为带参数的动作生成一个文本实体你可以手动向设备发送带参数的 Action 指令。自动化行为不符合预期时用它来确认是触发条件的问题还是指令本身的问题比翻日志快。小米设备接入 Home Assistant 排障现象 → 原因 → 解决现象可能原因解决办法安装后搜不到集成装完没重启重启 Home Assistantinstall.sh 结束时也会提示登录后设备列表是空的地区选错重新走配置流程选正确的地区——各地区小米云数据相互隔离某些设备一直不出现该设备属于蓝牙、红外或虚拟设备官方暂不支持这三类属预期行为控制明显延迟或超时云端链路慢或家庭网络连小米云不稳定先排查家庭网络有中枢网关的话改用本地控制想用本地模式却用不了网络里没有中枢网关或版本不达标升级中枢网关固件至 3.3.0_0023 以上、内置中枢软件至 0.8.9 以上不在中国大陆则只能用云端开启了局域网控制却不生效局域网内已存在中枢网关该功能自动失效或设备是蓝牙 Mesh/ZigBee 无 IP官方本就不建议开启此功能不需要可直接关闭实体名称是英文或翻译不准云端多语言文件覆盖不全在multi_lang.json补充对应翻译再点更新实体转换规则改了 specs 目录的文件没反应忘记触发规则更新CONFIGURE 更新实体转换规则怀疑账号或 token 泄露配置文件被他人读取先在米家 App 撤销授权见上文路径再收紧配置目录的访问权限写在最后接入本身不复杂复杂的是之后的习惯养成。建议从两三台最常用的设备开始把离家、回家这两组自动化跑稳再逐步导入全屋设备。等云端和本地的区别在你家网络里验证清楚剩下的就是按需调整——这个顺序下几乎不会踩到上面排障表里的大部分问题。【免费下载链接】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_homeXiaomi Home米家集成是小米官方支持的 Home Assistant 集成组件登录小米账号后可以把米家设备全部导入 Home Assistant实现跨品牌设备的统一管理、自动化与场景联动。本文用新手能看懂的方式讲清云端还是本地控制怎么选、如何完成安装登录、多账号怎么管以及常见问题怎么处理。为什么要把小米设备接入 Home Assistant小米生态链设备好用但有个现实问题米家 App 只能管理米家体系内的设备。家里如果同时有小米的门磁、其他品牌的灯和空调想开门磁时关灯、开空调在米家 App 里是做不到的。Home Assistant 解决的就是这件事。它本身不认识小米设备装完 Xiaomi Home 集成后小米设备会像原生设备一样出现在系统里之后所有品牌设备的开关、状态放在同一个仪表盘上自动化可以用任何设备的状态做触发条件不再受单个 App 的限制场景、仪表盘、语音控制都能跨品牌使用。接入后你能拿到什么覆盖大部分米家品类灯、插座开关、空调、空气净化器、加湿器、扫地机、热水器、音箱媒体播放器、门窗传感器二进制传感器等。小米按 MIoT 规范把设备功能自动转成 Home Assistant 实体——可写的属性变成开关、数值、选项只读属性变成传感器事件变成事件实体动作变成按钮或通知实体。有少数品类不支持蓝牙设备、红外设备、虚拟设备。这三类接不进来选型时先排除。云端还是本地一分钟选对控制方式接入前唯一要做的决定是控制指令走哪条路。差别只在命令经过谁的手。云端控制兼容好开箱即用没有额外硬件时指令从 Home Assistant 发到小米云再转到设备设备状态变化则由云端的 MQTT 订阅机制直接推送给集成不需要反复轮询所以设备多也不会给云端造成压力。好处很直接不挑设备、不加硬件装好就能用人在外面也能控制家里设备远程访问是标配缺点是指令要绕道公网家里断网就无法控制。云端控制的完整实现在 custom_components/xiaomi_home/miot/miot_cloud.py。本地控制低延迟断网可用本地控制需要一台小米中枢网关固件 ≥ 3.3.0_0023或一台内置中枢网关功能的米家设备软件 ≥ 0.8.9。中枢网关内部自带标准 MQTT BrokerHome Assistant 直接向网关订阅消息、发布指令全程走局域网。局域网内响应更快断网也能控制数据不出家门隐私上更干净限制中枢网关目前仅在中国大陆销售其他地区用不了。本地控制的完整实现在 custom_components/xiaomi_home/miot/miot_lan.py中枢网关的局域网发现逻辑在 custom_components/xiaomi_home/miot/miot_mdns.py。另外还有个局域网控制选项可以直控同一局域网内带 IP 的设备Wi-Fi 或网线连接但控制不了蓝牙 Mesh、ZigBee 设备官方文档提示该功能可能引起异常建议不要开启。有中枢网关时它也不会生效。对照表怎么选对比项云端控制本地控制中枢网关响应速度经过云端略有延迟局域网内响应更快隐私指令与状态经过小米云数据不出局域网远程访问支持任何地方都能控制仅限家庭网络硬件要求无中枢网关或内置中枢设备地区限制无支持中国大陆、欧洲、印度、俄罗斯、新加坡、美国中枢网关仅中国大陆有售一句话结论没有中枢网关就用云端这是大多数新手的路径有中枢网关、又在意延迟和隐私就切本地控制。小米设备接入 Home Assistant 的 5 个步骤第 1 步确认 Home Assistant 版本Core ≥ 2024.4.4Operating System 安装方式 ≥ 13.0。版本不够先升级这是所有安装方式的前提。第 2 步安装 Xiaomi Home 集成三种方式任选其一方式 AHACS多数人首选。打开 HACS搜索 Xiaomi Home进入详情页下载即可。方式 BGit clone官方推荐方便锁定版本。进入 config 目录执行git clone https://gitcode.com/GitHub_Trending/ha/ha_xiaomi_home cd ha_xiaomi_home ./install.sh /config第一条命令把仓库拉到 config 目录下install.sh /config会自动把集成复制到custom_components并提示重启。以后想固定某个版本切到对应 tag 再跑一遍脚本即可。方式 C手动复制。通过 Samba 或 FTP把custom_components/xiaomi_home整个文件夹拷到 Home Assistant 的config/custom_components下。装完记得重启 Home Assistant否则集成不会出现。第 3 步添加集成并登录小米账号依次进入设置 设备与服务 添加集成 搜索 Xiaomi Home 下一步 点击登录按页面提示用小米账号完成授权。配置流程的实现在 custom_components/xiaomi_home/config_flow.py。登录走的是 OAuth 2.0 授权账号密码不会存进 Home Assistant这一点可以放心。第 4 步选择地区与家庭导入设备配置过程中要先选择所在地区。小米云的数据按地区隔离当前支持中国大陆、欧洲、印度、俄罗斯、新加坡、美国六个地区选错地区就会看不到设备。登录成功后弹出选择家庭与设备对话框选中要导入的米家家庭该家庭下的设备会一并导入。第 5 步验证设备实体打开设备页面确认每个设备都生成了实体门窗传感器有事件实体、空调有 climate 实体、灯有 light 实体。把它们拖进对应区域客厅、卧室就可以开始写场景和自动化了。关于账号安全记住两件事密码不保存但登录成功后设备信息、证书、token 等凭据会明文存放在 Home Assistant 的配置文件中这是 HA 平台的限制。配置文件泄露等于账号授权泄露请保管好配置目录。怀疑 token 泄露时去米家 App 撤销授权我的 点击用户名进入小米账号页面 应用授权 Xiaomi Home (Home Assistant Integration) 取消授权。从能用到好用多账号管理、自动化场景与规格扩展多账号管理家人名下的设备也接进来一个家庭里设备分散在多个小米账号下很常见。第一个账号配置完成后进入 设置 设备与服务 已配置 Xiaomi Home 添加中枢再登录另一个小米账号即可。不同账号、甚至不同地区的设备都可以放进同一个区域统一管理。先写这三组自动化离家模式触发条件设成所有手机device_tracker 实体离开家动作是关闭全部灯和插座、启动扫地机。回家模式晚上到家开门时门磁事件实体触发打开客厅灯、空调切到预设温度。睡眠模式定时触发卧室灯调至最低亮度加湿器设到睡眠湿度。小提示小米设备的事件门磁触发、开关双击、传感器报警等都会转成 Home Assistant 的事件实体可以直接在自动化里做触发条件不需要额外写轮询。设备规格扩展修正和补充实体个别设备的实体翻译不对、或者该有的实体没生成时可以改 custom_components/xiaomi_home/miot/specs/ 目录下的规则文件spec_add.json补充额外的实体转换规则spec_filter.yaml/spec_modify.yaml过滤不需要的实体、修改已有转换multi_lang.json本地维护的多语言字典优先级高于云端下载的文件适合修正实体名称。改完文件不会自动生效要到集成页面点CONFIGURE 更新实体转换规则。集成共支持 13 种界面语言简中、繁中、英文、西班牙语、俄语、法语、德语、日语、意大利语、荷兰语、葡萄牙语、巴西葡萄牙语、土耳其语在配置流程的语言选项里选。翻译文件在 custom_components/xiaomi_home/translations/。Action 调试模式验证自动化是否发对了指令在配置项里开启Action 调试模式后集成会为带参数的动作生成一个文本实体你可以手动向设备发送带参数的 Action 指令。自动化行为不符合预期时用它来确认是触发条件的问题还是指令本身的问题比翻日志快。小米设备接入 Home Assistant 排障现象 → 原因 → 解决现象可能原因解决办法安装后搜不到集成装完没重启重启 Home Assistantinstall.sh 结束时也会提示登录后设备列表是空的地区选错重新走配置流程选正确的地区——各地区小米云数据相互隔离某些设备一直不出现该设备属于蓝牙、红外或虚拟设备官方暂不支持这三类属预期行为控制明显延迟或超时云端链路慢或家庭网络连小米云不稳定先排查家庭网络有中枢网关的话改用本地控制想用本地模式却用不了网络里没有中枢网关或版本不达标升级中枢网关固件至 3.3.0_0023 以上、内置中枢软件至 0.8.9 以上不在中国大陆则只能用云端开启了局域网控制却不生效局域网内已存在中枢网关该功能自动失效或设备是蓝牙 Mesh/ZigBee 无 IP官方本就不建议开启此功能不需要可直接关闭实体名称是英文或翻译不准云端多语言文件覆盖不全在multi_lang.json补充对应翻译再点更新实体转换规则改了 specs 目录的文件没反应忘记触发规则更新CONFIGURE 更新实体转换规则怀疑账号或 token 泄露配置文件被他人读取先在米家 App 撤销授权见上文路径再收紧配置目录的访问权限写在最后接入本身不复杂复杂的是之后的习惯养成。建议从两三台最常用的设备开始把离家、回家这两组自动化跑稳再逐步导入全屋设备。等云端和本地的区别在你家网络里验证清楚剩下的就是按需调整——这个顺序下几乎不会踩到上面排障表里的大部分问题。【免费下载链接】ha_xiaomi_homeXiaomi Home Integration for Home Assistant项目地址: https://gitcode.com/GitHub_Trending/ha/ha_xiaomi_home创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考