企业官网建设流程全解析

小米设备接入 Home Assistant 保姆级指南：ha_xiaomi_home 从零到全屋自动化

【免费下载链接】ha_xiaomi_homeXiaomi Home Integration for Home Assistant项目地址: https://gitcode.com/GitHub_Trending/ha/ha_xiaomi_home

想把家里的智能灯、温湿度计、空调伴侣都放进 Home Assistant 统一面板？ha_xiaomi_home 就是干这个的：基于小米官方 MIoT 协议，让小米设备接入 Home Assistant 变得简单。一次授权，设备自动发现、批量导入，云端与本地两条控制通道随你挑。

10 秒速览

从零到上线：三步装好

第 1 步：确认环境

打开 HA 版本设置，确认不低于 2024.4.4，并且系统能正常连上小米云（可先ping api.io.mi.com测试）。版本太旧会缺组件依赖的接口。

第 2 步：二选一安装

git clone https://gitcode.com/GitHub_Trending/ha/ha_xiaomi_home cd ha_xiaomi_home ./install.sh /path/to/homeassistant/config

或在 HACS 商店里搜索 "Xiaomi Home"，一键下载即可。

⚠️install.sh只接受一个参数，即 HA 的config目录路径。无论用哪种方式，装完都必须重启 Home Assistant，组件才会出现在集成列表里。

第 3 步：添加集成、授权与区域选择

进入"设置 → 设备与服务 → 添加集成"，搜索 "Xiaomi Home"，登录小米账号并选择账号所属区域（中国大陆、欧洲、印度、俄罗斯、新加坡、美国）。授权完成后，组件会自动发现账号下设备并批量导入，无需逐台添加；多个区域的设备也能统一导入同一实例集中调度。

云端还是本地：怎么选

选云端：出门在外也要随时控家里的灯和空调，走云端。状态变化由小米云通过 MQTT（一种轻量实时消息推送）推过来，你在 HA 下的指令则经 HTTP 发到云端再转发给设备。

选本地：把响应速度和隐私放在第一位，选本地。它把通信终点换成小米中枢网关，网关自带的 MQTT Broker 在局域网里完成状态同步与指令收发，数据不经过任何外部服务器，反馈是瞬时的。

⚠️ 本地控制官方建议谨慎使用，目前仅支持 WiFi/以太网设备。家里有中枢网关时，组件会自动利用其本地代理能力，无需额外配置。参数存放在 本地控制配置目录 的profile_models.yaml中，按注释修改即可。

为什么导入完实体就自动有了

设备导入那一刻，实体就已经能用，不用你手写一行映射。这背后是specv2entity转换引擎在干活。

打个比方：小米设备出厂时自带一份"能力说明书"（MIoT-Spec-V2 规格），里面写清了自己有哪些属性、能不能改、是什么数据类型。转换引擎就像个翻译官，把说明书逐条读进来，自动判断该交给谁——能写的布尔属性变成开关（Switch），只读的数值属性变成传感器（Sensor），其余同理，各就各位。

说白了，你只管点导入，剩下的翻译工作它全包了。

它能管多少设备

界面语言方面，界面翻译目录 覆盖 12 种语言，中、英、日、德、法、西、俄等都在列，且随 HA 的语言设置自动切换。

遇到问题先查这里

把一天的自动化串起来

傍晚进门，门磁触发"回家"，玄关灯亮起、空调切到舒适温度。说一句"看电影"，主灯熄灭、氛围灯转暖色、电视音响同步开机。夜里起身，人体传感器感知到活动，自动点亮去卫生间的路径灯，回床后又悄悄熄灭。早上出门，离家模式关掉全部灯光、空调切到节能。

当小米设备接入 Home Assistant 之后，你面对的就是一套能自由编排的全屋自动化，而不是两套互相隔离的系统。现在就按"三步装好"把第一台设备导进来，剩下的编排交给 HA 自己的自动化吧。

【免费下载链接】ha_xiaomi_homeXiaomi Home Integration for Home Assistant项目地址: https://gitcode.com/GitHub_Trending/ha/ha_xiaomi_home