ARTICLE DETAIL

资讯详情

深耕郑州网站建设与运营推广的一线实战洞察。

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

小米设备接入 Home Assistant 保姆级指南:ha_xiaomi_home 从零到全屋自动化 小米设备接入 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 秒速览项目内容协议基础小米官方 MIoT 协议小米物联网标准负责描述设备能力控制通道云端 本地经小米中枢网关双通道可按场景切换安装方式install.sh一键拷贝或 HACS 商店搜索安装HA 版本要求不低于 2024.4.4且能访问小米云支持设备类别照明、开关插座、传感器、温控、风扇、加湿器六大类界面语言12 种语言跟随 HA 语言自动切换从零到上线三步装好第 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登录小米账号并选择账号所属区域中国大陆、欧洲、印度、俄罗斯、新加坡、美国。授权完成后组件会自动发现账号下设备并批量导入无需逐台添加多个区域的设备也能统一导入同一实例集中调度。云端还是本地怎么选对比维度云端控制本地控制通信路径设备 → 小米云 → HA设备 → 中枢网关 → HA断网可用性需保持外网连接纯局域网断外网照常响应速度受网络波动影响几乎无延迟隐私状态经云端中转数据不出局域网推荐场景人在外地远程操控传感器联动、本地自动化选云端出门在外也要随时控家里的灯和空调走云端。状态变化由小米云通过 MQTT一种轻量实时消息推送推过来你在 HA 下的指令则经 HTTP 发到云端再转发给设备。选本地把响应速度和隐私放在第一位选本地。它把通信终点换成小米中枢网关网关自带的 MQTT Broker 在局域网里完成状态同步与指令收发数据不经过任何外部服务器反馈是瞬时的。⚠️ 本地控制官方建议谨慎使用目前仅支持 WiFi/以太网设备。家里有中枢网关时组件会自动利用其本地代理能力无需额外配置。参数存放在 本地控制配置目录 的profile_models.yaml中按注释修改即可。为什么导入完实体就自动有了设备导入那一刻实体就已经能用不用你手写一行映射。这背后是specv2entity转换引擎在干活。打个比方小米设备出厂时自带一份能力说明书MIoT-Spec-V2 规格里面写清了自己有哪些属性、能不能改、是什么数据类型。转换引擎就像个翻译官把说明书逐条读进来自动判断该交给谁——能写的布尔属性变成开关Switch只读的数值属性变成传感器Sensor其余同理各就各位。说白了你只管点导入剩下的翻译工作它全包了。它能管多少设备设备类别对应 HA 领域典型设备照明light智能灯、灯带开关插座switch智能插座、墙壁开关传感器sensor温湿度、人体、门窗传感器温控climate空调伴侣、智能温控器风扇fan智能风扇、空气循环扇加湿器humidifier各类智能加湿器界面语言方面界面翻译目录 覆盖 12 种语言中、英、日、德、法、西、俄等都在列且随 HA 的语言设置自动切换。遇到问题先查这里症状可能原因处理动作✅ 连云失败网络访问不到小米云或米家账号无该设备权限先ping api.io.mi.com确认外网再到米家 App 核对设备控制权限排除设备本身离线✅ 实体状态不同步集成缓存或固件过旧依次尝试重启 Xiaomi Home 集成 → 清除.storage/xiaomi_home.*缓存 → 检查设备固件是否过旧✅ 本地控制失效网关与 HA 不在同一局域网或设备不在支持范围确认中枢网关与 HA 同网段核对网关 IP 与配置一致确认设备为 WiFi/以太网把一天的自动化串起来傍晚进门门磁触发回家玄关灯亮起、空调切到舒适温度。说一句看电影主灯熄灭、氛围灯转暖色、电视音响同步开机。夜里起身人体传感器感知到活动自动点亮去卫生间的路径灯回床后又悄悄熄灭。早上出门离家模式关掉全部灯光、空调切到节能。当小米设备接入 Home Assistant 之后你面对的就是一套能自由编排的全屋自动化而不是两套互相隔离的系统。现在就按三步装好把第一台设备导进来剩下的编排交给 HA 自己的自动化吧。【免费下载链接】ha_xiaomi_homeXiaomi Home Integration for Home Assistant项目地址: https://gitcode.com/GitHub_Trending/ha/ha_xiaomi_home创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
返回列表