ARTICLE DETAIL

资讯详情

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

ha_xiaomi_home:3 步把米家设备接入 Home Assistant,新手也能上手

ha_xiaomi_home:3 步把米家设备接入 Home Assistant,新手也能上手 ha_xiaomi_home3 步把米家设备接入 Home Assistant新手也能上手【免费下载链接】ha_xiaomi_homeXiaomi Home Integration for Home Assistant项目地址: https://gitcode.com/GitHub_Trending/ha/ha_xiaomi_home想把米家设备接入 Home Assistant 时你买了台米家空气净化器、一个智能灯泡、一台小米扫地机它们全在米家 App 里才能操作。你想把灯拉进 Home Assistant 的自动化里却发现没有现成的官方入口只能翻社区的各种野路子稳定性全看运气。ha_xiaomi_home 是小米官方提供的米家集成直接把米家设备接进 Home Assistant本地、云端两条控制路都能走现有设备不用换配法也不用改。那它具体能帮你做到什么程度往下看。能力速览ha_xiaomi_home 替你做了什么一句话定位把米家设备接进 Home Assistant 的官方桥。统一面板多个小米账号的设备导入同一个实例一个界面全管住本地/云端双通道有中枢网关走本地直连没有就走小米云两边都兜得住推送不轮询设备属性一变立刻推过来状态不滞后实体自动生成读每台设备的 MIoT-Spec-V2 描述自动转成 switch、sensor 等实体多语言实体名覆盖 13 种语言设备属性名自动翻译中文界面开箱即中文这几点直接决定了你后面配多快。功能心里有数了接着聊最短时间跑通它的办法。从 0 到跑通3 步接入米家设备第 1 步拿代码要求 Core 2024.4.4 及以上、Operating System 13.0 及以上cd config git clone https://gitcode.com/GitHub_Trending/ha/ha_xiaomi_home cd ha_xiaomi_home ./install.sh /path/to/your/homeassistant/configinstall.sh 会把组件复制到 custom_components 目录下重启 Home Assistant 就装好了。装好之后下一步是登录。第 2 步用小米账号登录界面进 设置 → 设备与服务 → 添加集成搜Xiaomi Home点下一步会跳到小米账号登录页。登录走 OAuth 2.0密码不会存进 Home Assistant。这里要留意用户所在地区选对不同地区的设备在不同的云上选错就导不出设备。第 3 步选家庭与设备登录成功后弹出选择家庭与设备勾选要接入的米家家庭该家庭下的设备会全部导入。刷新设备列表空气净化器和灯应该已经躺在实体列表里了。以后想升级在克隆目录切到新 tag 再跑一次脚本即可cd config/ha_xiaomi_home git fetch git checkout tag ./install.sh /path/to/your/config跑通之后你可能会好奇它到底是怎么跟设备说话的。引擎盖下面本地直连与云端推送怎么跑的设备状态为什么总最新推送而不是查询像快递通知群不用你打电话问。集成在小米云的 MQTT Broker 上订阅设备消息通道设备属性变化或事件触发时云端会把properties_changed、event这类上行消息实时推给集成。它只在配置完成时向云端查一次全部设备属性之后不再轮询对云端的访问压力也很小。一句话记住状态由云端主动推变了就马上知道。本地直连怎么配中枢网关里藏了个 MQTT Broker像家里设了前台快递不用出城。小米中枢网关固件 3.3.0_0023 及以上内置了一个标准 MQTT Broker集成直接向网关订阅设备消息控制指令发布到 Broker 后由网关转发给设备全程不出局域网。两条通道同时可用时本地控制自动优先。另外每台设备都带一份 MIoT-Spec-V2 描述列清它有哪些属性、事件、方法集成拿描述去匹配内置映射规则转成实体——这就是后面定制实体的入口。一句话记住有网关指令不出门没网关走云端快和远都有路。原理聊清楚了那实际用起来容易踩的坑呢踩坑记录 进阶玩法 登录后台设备不显示→ 蓝牙/红外/虚拟设备不支持或地区选错 → 先在米家 App 确认设备已绑定再在配置流程选对地区重新导入。控制指令走云端、响应偏慢→ 局域网内没有中枢网关 → 加装中枢网关后本地直连自动优先配置里的局域网控制开关可能引发异常不建议拿来顶替。实体名是英文、或一堆没用的实体→ 云端翻译不全、冗余 spec 实例未过滤 → 改 spec 目录下的 multi_lang.json 与 spec_filter.yaml再到集成配置里点更新实体转换规则生效。想同时管两个小米账号→ 一个账号只导入一套家庭 → 在 Xiaomi Home 配置页选添加中枢再登录一次想看内部行为把custom_components.xiaomi_home的日志级别调成 debug 即可。更完整的 MIoT-Spec-V2 到实体的转换表和过滤规则翻一下 中文文档 就有。【免费下载链接】ha_xiaomi_homeXiaomi Home Integration for Home Assistant项目地址: https://gitcode.com/GitHub_Trending/ha/ha_xiaomi_home创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
返回列表