尧图网页设计 
小米 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 集成组件。登录小米账号后米家 App 里的智能灯、空调、传感器等设备会直接变成 HA 的原生实体状态实时同步可以直接写进自动化和语音控制。本文按实际操作顺序走一遍装好组件、完成 OAuth 登录与设备导入、决定走云控制还是本地控制、看懂实体转换规则最后处理几个常见的坑。ha_xiaomi_home 安装三种方式任选其一动手前先核对版本底线Home Assistant Core ≥ 2024.4.4如果跑在 Operating System 镜像上系统版本要 ≥ 13.0。版本不够就先升级否则配置流程走不下去。官方推荐 git clone 方式后续切换版本、回退都方便cd /config git clone https://gitcode.com/GitHub_Trending/ha/ha_xiaomi_home.git cd ha_xiaomi_home ./install.sh /configinstall.sh 的作用是把custom_components/xiaomi_home拷贝进 HA 的配置目录执行完重启 HA 即可。之后想固定或回退到某个版本切到对应 Tag 再跑一次就行cd /config/ha_xiaomi_home git fetch git checkout v1.0.0 ./install.sh /config不想接触命令行也可以在 HACS 里搜索 Xiaomi Home 一键下载或者手动把custom_components/xiaomi_home文件夹复制到config/custom_components/下。三种方式殊途同归完整说明见 中文文档。三步完成小米 OAuth 登录与设备导入打开「设置 → 设备与服务 → 添加集成」搜索Xiaomi Home进入点击登录按钮会跳转到小米的 OAuth 2.0 授权页完成授权即可。集成拿到的只是访问授权不保存你的账号密码授权成功后弹出「选择家庭与设备」对话框选中设备所在的米家家庭该家庭下的设备就会导入 Home Assistant。两个容易忽略的点选地区配置流程中需要选择账号所属地区中国大陆、欧洲、印度、俄罗斯、新加坡、美国。各地区小米云的用户数据相互隔离选错地区会导不到设备多账号配置完成后可在已配置页继续添加其他小米账号不同账号的设备可以放进同一个区域适合一个米家账号管不全整个家的情况。云控制还是本地控制先看这两张架构图云控制是默认路径不需要任何额外硬件。集成向小米云的 MQTT Broker 订阅设备消息属性变化或事件发生时云端主动推送HA 无需轮询就能第一时间感知下发控制则走云端 HTTP 接口由小米云转发给设备。代价是每条指令都要绕道小米云体验取决于你的外网到云端的链路质量。本地控制由小米中枢网关实现网关内建标准 MQTT Broker订阅和发布都在局域网内完成设备消息不出户断网时也能正常控制。使用条件有两条中枢网关固件需为 3.3.0_0023 及以上或选用内置中枢网关功能的米家设备软件 0.8.9 及以上小米中枢网关目前仅在中国大陆地区发售。局域网内存在符合版本的中枢网关时集成会走这条本地链路没有的话所有指令都经小米云下发。另外还有一个「局域网控制」开关它只认同一局域网内的 IP 设备WiFi 或网线接入管不了 BLE Mesh、ZigBee 设备官方提示可能引起异常、不建议开启——而且只要局域网里已有中枢网关它也不会生效。一句话选型手里有小米中枢网关中国大陆→ 本地控制没有 → 云控制。xiaomi_home 实体转换导入的设备变成什么设备导入后不需要逐个配置集成按 MIoT-Spec-V2 规范自动转换常用规则如下MIoT-Spec-V2 实例条件转换后的 Home Assistant 实体属性可写、布尔型Switch开关属性可写、带取值列表Select选择器属性可写、带取值范围Number数字属性可写、字符串Text文本属性只读Sensor传感器事件—Event参数传入_trigger_event动作无输入参数Button动作有输入参数Notify通知比如音箱的「执行文本指令」动作会转成 Notify 实体参数格式形如[Text Content(str), Silent Execution(bool)]输入[你好, true]就能让音箱播报。默认转换不理想时改 miot/specs/ 目录下的三个文件即可spec_filter.yaml按 URN 排除不要的服务、属性、事件、动作支持通配符4.*表示 siid4 服务的全部属性spec_modify.yaml修正实体类型与属性multi_lang.json本地多语言字典优先级高于云端下发的翻译文件适合修实体名的翻译问题。修改 specs 目录下任何文件后必须在集成的「配置」里点一次「更新实体转换规则」才会生效。进阶选项与常见坑Action 调试模式在配置选项中开启后带动作的实体会多出一个文本入口可手动输入参数向设备发一条指令验证参数格式非常顺手。设备支持范围绝大多数智能品类都支持不支持的只有蓝牙、红外和虚拟设备三类——红外遥控器这类产品不要指望出现在 HA 里。配置文件的保管OAuth 2.0 登录不保存密码但登录后的设备信息、token 等用户信息会明文存放在 HA 配置文件中请确保配置目录不被暴露。怀疑授权泄露时可在米家 App「我的 → 账号管理 → 应用授权」里移除 Xiaomi Home (Home Assistant Integration)。界面语言配置流程提供 13 种语言可选含简中、繁中、英文、日文、俄文等更多细节见 CHANGELOG 与 中文文档。到这里第一台米家设备应该已经在 HA 里可控了之后想调整控制链路或实体行为回到本文的选型与 specs 两节即可。【免费下载链接】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 集成组件。登录小米账号后米家 App 里的智能灯、空调、传感器等设备会直接变成 HA 的原生实体状态实时同步可以直接写进自动化和语音控制。本文按实际操作顺序走一遍装好组件、完成 OAuth 登录与设备导入、决定走云控制还是本地控制、看懂实体转换规则最后处理几个常见的坑。ha_xiaomi_home 安装三种方式任选其一动手前先核对版本底线Home Assistant Core ≥ 2024.4.4如果跑在 Operating System 镜像上系统版本要 ≥ 13.0。版本不够就先升级否则配置流程走不下去。官方推荐 git clone 方式后续切换版本、回退都方便cd /config git clone https://gitcode.com/GitHub_Trending/ha/ha_xiaomi_home.git cd ha_xiaomi_home ./install.sh /configinstall.sh 的作用是把custom_components/xiaomi_home拷贝进 HA 的配置目录执行完重启 HA 即可。之后想固定或回退到某个版本切到对应 Tag 再跑一次就行cd /config/ha_xiaomi_home git fetch git checkout v1.0.0 ./install.sh /config不想接触命令行也可以在 HACS 里搜索 Xiaomi Home 一键下载或者手动把custom_components/xiaomi_home文件夹复制到config/custom_components/下。三种方式殊途同归完整说明见 中文文档。三步完成小米 OAuth 登录与设备导入打开「设置 → 设备与服务 → 添加集成」搜索Xiaomi Home进入点击登录按钮会跳转到小米的 OAuth 2.0 授权页完成授权即可。集成拿到的只是访问授权不保存你的账号密码授权成功后弹出「选择家庭与设备」对话框选中设备所在的米家家庭该家庭下的设备就会导入 Home Assistant。两个容易忽略的点选地区配置流程中需要选择账号所属地区中国大陆、欧洲、印度、俄罗斯、新加坡、美国。各地区小米云的用户数据相互隔离选错地区会导不到设备多账号配置完成后可在已配置页继续添加其他小米账号不同账号的设备可以放进同一个区域适合一个米家账号管不全整个家的情况。云控制还是本地控制先看这两张架构图云控制是默认路径不需要任何额外硬件。集成向小米云的 MQTT Broker 订阅设备消息属性变化或事件发生时云端主动推送HA 无需轮询就能第一时间感知下发控制则走云端 HTTP 接口由小米云转发给设备。代价是每条指令都要绕道小米云体验取决于你的外网到云端的链路质量。本地控制由小米中枢网关实现网关内建标准 MQTT Broker订阅和发布都在局域网内完成设备消息不出户断网时也能正常控制。使用条件有两条中枢网关固件需为 3.3.0_0023 及以上或选用内置中枢网关功能的米家设备软件 0.8.9 及以上小米中枢网关目前仅在中国大陆地区发售。局域网内存在符合版本的中枢网关时集成会走这条本地链路没有的话所有指令都经小米云下发。另外还有一个「局域网控制」开关它只认同一局域网内的 IP 设备WiFi 或网线接入管不了 BLE Mesh、ZigBee 设备官方提示可能引起异常、不建议开启——而且只要局域网里已有中枢网关它也不会生效。一句话选型手里有小米中枢网关中国大陆→ 本地控制没有 → 云控制。xiaomi_home 实体转换导入的设备变成什么设备导入后不需要逐个配置集成按 MIoT-Spec-V2 规范自动转换常用规则如下MIoT-Spec-V2 实例条件转换后的 Home Assistant 实体属性可写、布尔型Switch开关属性可写、带取值列表Select选择器属性可写、带取值范围Number数字属性可写、字符串Text文本属性只读Sensor传感器事件—Event参数传入_trigger_event动作无输入参数Button动作有输入参数Notify通知比如音箱的「执行文本指令」动作会转成 Notify 实体参数格式形如[Text Content(str), Silent Execution(bool)]输入[你好, true]就能让音箱播报。默认转换不理想时改 miot/specs/ 目录下的三个文件即可spec_filter.yaml按 URN 排除不要的服务、属性、事件、动作支持通配符4.*表示 siid4 服务的全部属性spec_modify.yaml修正实体类型与属性multi_lang.json本地多语言字典优先级高于云端下发的翻译文件适合修实体名的翻译问题。修改 specs 目录下任何文件后必须在集成的「配置」里点一次「更新实体转换规则」才会生效。进阶选项与常见坑Action 调试模式在配置选项中开启后带动作的实体会多出一个文本入口可手动输入参数向设备发一条指令验证参数格式非常顺手。设备支持范围绝大多数智能品类都支持不支持的只有蓝牙、红外和虚拟设备三类——红外遥控器这类产品不要指望出现在 HA 里。配置文件的保管OAuth 2.0 登录不保存密码但登录后的设备信息、token 等用户信息会明文存放在 HA 配置文件中请确保配置目录不被暴露。怀疑授权泄露时可在米家 App「我的 → 账号管理 → 应用授权」里移除 Xiaomi Home (Home Assistant Integration)。界面语言配置流程提供 13 种语言可选含简中、繁中、英文、日文、俄文等更多细节见 CHANGELOG 与 中文文档。到这里第一台米家设备应该已经在 HA 里可控了之后想调整控制链路或实体行为回到本文的选型与 specs 两节即可。【免费下载链接】ha_xiaomi_homeXiaomi Home Integration for Home Assistant项目地址: https://gitcode.com/GitHub_Trending/ha/ha_xiaomi_home创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考