小米设备接入Home Assistant全攻略ha_xiaomi_home三步完成智能家居整合【免费下载链接】ha_xiaomi_homeXiaomi Home Integration for Home Assistant项目地址: https://gitcode.com/GitHub_Trending/ha/ha_xiaomi_home如果你家里的灯光、空调、传感器还散落在米家App和Home Assistant两个世界里每次联动都要双开操作那这篇文章就是为你准备的。ha_xiaomi_home是小米官方维护的开源集成组件专门解决小米设备接入Home Assistant这一核心问题让全屋智能设备在同一个面板里被统一控制。接下来我会用闯关的方式带你从认识、安装到玩出花样全程零基础可跟。从一个真实的尴尬场景说起先讲一件我自己的糗事装了智能门锁和人体传感器后本想着开门自动亮灯结果灯是小米的、自动化是Home Assistant的两边各自为政。下班回家摸黑开门喊了一嗓子小爱同学开灯灯亮了可说好的自动一次没实现。问题的根源不在设备而在生态之间的那堵墙。小米的设备遵循自家MIoT协议而Home Assistant用的是另一套实体体系两者对话需要一座桥。ha_xiaomi_home就是这座桥——它把小米设备的能力翻译成Home Assistant认识的实体让跨品牌自动化真正跑起来。它凭什么行官方出品的翻译官市面上有不少第三方接入方案但ha_xiaomi_home最大的底气是官方背景由小米团队直接维护协议实现跟着MIoT-Spec-V2规范走意味着新设备、新功能的适配更快出问题的概率也更低。它的核心能力可以浓缩成三点协议翻译把小米的MIoT-Spec-V2协议自动转换为Home Assistant实体你不用手动填任何映射表双通道控制云控与本地控制两条路径并存按场景自由切换广度覆盖照明、开关、传感器、空调、风扇、加湿器、扫地机、窗帘、音箱等十几类设备都能接甚至支持多账号、多区域的设备混编到同一个家庭里。一句话总结它负责听不懂的话翻译给你听你只管在Home Assistant里尽情发挥创意。云控与本地两条通道按需切换这是ha_xiaomi_home最值得说道的设计。你不需要二选一而是可以同时拥有两种姿势。通道一走云端人在外面也能管云控模式下组件在小米云的MQTT Broker上订阅设备消息。设备状态一变云端立刻把变化推给Home Assistant不用反复轮询你要下发指令则通过云端HTTP接口转发到设备。这套推送状态下发指令的组合让远程控制既可靠又省流量——集成刚配置好时只全量查询一次设备属性之后全靠订阅推送。通道二走本地响应快且更私密本地模式依赖小米中枢网关固件3.3.0_0023及以上。网关内置了标准MQTT Broker设备状态变化和指令下发全程在局域网内完成不经过任何云端中转。两种方式怎么选我整理了一张对比表对比维度云控模式本地模式通信路径设备 → 小米云 → 集成设备 → 中枢网关 → 集成远程控制天然支持随时随地需额外配置主要面向局域网响应速度取决于网络状况毫秒级几乎无延迟隐私性状态数据经过云端数据不出家庭网络适用场景外出远程操控、跨区域管理人体感应、温湿度联动等即时响应场景提醒一句本地模式目前主要面向中国大陆用户中枢网关仅在内地发售。如果你没有中枢网关所有指令都会自动走云端功能不受影响只是响应路径不同。第一关装——三种安装方式任选动手之前先确认版本Home Assistant Core 需不低于 2024.4.4系统版本建议 13.0 以上。然后挑一种你最顺手的装法安装方式适合人群特点Git 克隆 安装脚本喜欢命令行、想方便升级的玩家后续切版本号更新很方便HACS 商店安装大多数用户界面点几下就完成最省心手动拷贝临时尝鲜直接把组件文件夹放进custom_components以Git方式为例核心命令就三步git clone https://gitcode.com/GitHub_Trending/ha/ha_xiaomi_home cd ha_xiaomi_home ./install.sh /path/to/homeassistant/config装完重启Home Assistant在设置 设备与服务里就能搜到Xiaomi Home了。也许你会担心命令看不懂——别慌第二、第三种方式连终端都不用开HACS里搜一下点下载即可。第二关连——登录、选区域、拉设备进入设置 设备与服务点击添加集成搜索Xiaomi Home跟着向导做三件事登录小米账号组件采用OAuth 2.0授权登录密码不会保存在Home Assistant里安全性有保障选择区域目前支持中国大陆、欧洲、印度、俄罗斯、新加坡和美国六个区域勾选家庭与设备弹窗里选择要导入的小米家庭设备列表自动同步过来。这里有个容易被忽略的好特性多个账号、多个区域的设备可以混进同一个家。比如你在国内和新加坡都有设备可以导入到同一区域统一管理不用再拆成两套系统。配置完成后还可以随时在配置里增删设备、更新昵称无需重装。第三关转——MIoT协议自动变成实体设备导入后你会发现它们已经自动变成了一个个标准的Home Assistant实体。这背后是custom_components/xiaomi_home/miot/specs/specv2entity.py这个转换引擎在干活它的映射逻辑非常直观MIoT属性特征自动转换成的实体可写、布尔型Switch 开关可写、文本型Text 文本可写、枚举取值Select 选择器可写、数值区间Number 数值只读属性Sensor 传感器事件Event 事件实体无参动作Button 按钮带参动作Notify 通知换句话说可写的开关属性自动变成Switch只读的温度数值自动变成Sensor——完全不需要手动配置复杂的映射关系这也是它零学习成本口碑的来源。如果你用的设备不在官方默认映射里组件还提供了spec_filter.yaml、spec_modify.yaml等规则文件供高级用户微调普通用户跳过即可。第四关玩——把设备串成场景设备进来了接下来才是乐趣所在。我家里现在跑着几个自动化全部由ha_xiaomi_home导入的设备驱动晨起模式工作日早7点卧室灯从10%亮度缓慢爬升窗帘缓缓打开观影模式一句话触发客厅主灯熄灭、氛围灯切暖色电视和音响待命离家模式门磁检测到出门后全屋灯光关闭空调切到节能档夜间过道人体传感器在22点后探测到活动自动点亮过道地灯60秒后熄灭。这些场景无一例外都得益于协议转换这一步传感器、开关、灯光在Home Assistant里已经是标准实体automations直接调用即可。你不需要理解MIoT协议的任何细节就像用普通智能家居一样写自动化。避坑清单新手最容易踩的4个坑玩了一段时间把踩过的坑和官方FAQ里的要点整理成清单帮你省点冤枉时间症状排查思路登录或同步失败先测api.io.mi.com连通性再用米家App确认账号有设备控制权限实体状态不更新重启集成必要时清理.storage下对应的缓存文件检查设备固件是否过旧本地模式没生效确认中枢网关与Home Assistant在同一局域网且网关固件已更新到支持版本部分设备没导入官方目前不支持蓝牙、红外和虚拟设备这类设备请先在米家确认类型另外两个值得提前知道的信息一是组件提供13套语言包含简繁中文、英、日、德、法、西、俄、土等界面完全本地化二是登录凭证会以明文形式存放在Home Assistant配置目录里请务必保管好配置文件的访问权限。写在最后从两个App来回切到一个面板管全家中间差的只是一个靠谱的桥。ha_xiaomi_home用官方协议、双通道控制和傻瓜式转换把小米设备接入Home Assistant的门槛压到了最低——你要做的不过是装好它、登录账号、然后尽情编排你的场景。如果你也受够了多平台割裂的体验不妨现在就照着上面的步骤试一次让家里的设备真正睡到一张床上。【免费下载链接】ha_xiaomi_homeXiaomi Home Integration for Home Assistant项目地址: https://gitcode.com/GitHub_Trending/ha/ha_xiaomi_home创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考