5分钟上手!HACS 安装 ha-emporia-vue 完整教程,打通 Emporia Vue 与 Home Assistant【免费下载链接】ha-emporia-vueHome Assistant Integration for Emporia Vue Energy Monitor项目地址: https://gitcode.com/gh_mirrors/ha/ha-emporia-vueha-emporia-vue 是专为 Emporia Vue 智能电表打造的 Home Assistant 集成组件它通过官方 API 读取每个回路的实时功率与历史能耗并在 HA 中自动生成传感器实体。本文用 5 分钟带你完成 HACS 安装 ha-emporia-vue 的全部流程从添加自定义仓库、下载组件到账号配置一步步打通 Emporia Vue 与 Home Assistant让你的家庭用电数据在仪表盘上一目了然 ⚡什么是 ha-emporia-vueEmporia Vue 能耗监控接入 Home Assistant 的绝佳方案Emporia Vue 是一款高性价比的家庭能耗监测设备但它本身没有本地 API数据都托管在 Emporia 云服务中。ha-emporia-vue 正是解决这一痛点的社区开源集成 通过 PyEmVue 库调用 Emporia 官方 API采用云轮询模式同步数据iot_class: cloud_polling 为 Emporia Vue 的每个设备通道自动创建传感器展示每分钟平均用电量️ 支持图形化配置config_flow全程无需手写 YAML 组件结构清晰核心代码位于custom_components/emporia_vue/目录其中sensor.py负责能耗传感器config_flow.py实现可视化配置向导const.py定义了各类配置项常量注意该集成并非 Emporia 官方出品而是由社区开发者维护的开源项目与 Emporia Energy 官方无任何关联但功能稳定、更新活跃当前版本 0.12.2。HACS 安装 ha-emporia-vue 的前置条件在开始 HACS 安装之前请先确认以下 3 个条件是否满足✅ Home Assistant 已安装 HACSHome Assistant Community Store插件✅ Home Assistant 版本不低于 2021.9.0见项目hacs.json中的版本要求✅ 拥有 Emporia App 账号支持邮箱密码登录也支持 Google/Apple 账号 Token 认证3 分钟学会HACS 添加自定义仓库的具体步骤ha-emporia-vue 目前尚未收录进 HACS 默认商店需要先以「自定义仓库」的形式添加到 HACS 中整个操作不超过 3 分钟。第一步打开 HACS 主界面从 Home Assistant 左侧边栏点击 HACS进入 Home Assistant Community Store 主页面切换到顶部的Integrations标签页第二步进入集成页面打开自定义仓库菜单在 Integrations 页面右上角点击三点菜单⋮从下拉选项中选择Custom repositories即可进入自定义仓库管理界面第三步粘贴仓库地址并选择类别在弹出的 Custom repositories 窗口中在Add custom repository URL输入框中粘贴 ha-emporia-vue 的仓库地址将Category下拉菜单选择为Integration点击蓝色的ADD按钮完成添加添加成功后Emporia Vue 会出现在自定义仓库列表中并显示描述「Home Assistant Integration for Emporia Vue Energy Monitor」第四步下载并安装 Emporia Vue 集成回到 HACS 的 Integrations 列表找到Emporia Vue点击DOWNLOAD按钮完成下载。HACS 会自动处理依赖库pyemvue、boto3的安装。下载完成后需要重启 Home Assistant让组件生效。如果重启后在配置列表里仍看不到该集成请强制刷新浏览器缓存快捷键CtrlShiftRMac 为CmdShiftR通常就能解决问题。快速配置方法在 Home Assistant 中添加 Emporia Vue 集成安装完成后接下来的账号配置全部在 Home Assistant 界面中完成无需编辑任何配置文件进入 Home Assistant设置 → 设备与服务点击右下角添加集成按钮搜索Emporia Vue并点击进入配置向导输入你在 Emporia App 中使用的邮箱和密码点击提交稍等片刻即可看到「配置成功」的提示 配置完成后集成会自动为 Emporia Vue 的每个回路通道创建独立的传感器实体实时展示功率、电量等数据。Google/Apple 账号登录不了的解决办法Token 认证如果你的 Emporia 账号是通过「使用 Google/Apple 登录」创建的直接用邮箱密码登录会失败。最简单的解决办法是在 Emporia 官网或 App 中为你的邮箱设置一个独立密码若无法设置密码则可以使用 Token 认证方式用浏览器打开 Emporia 网页版并登录按F12打开开发者工具切换到ApplicationChrome/Edge或StorageFirefox标签进入IndexedDB找到与 Amplify 认证相关的存储复制hostedUi.idToken、hostedUi.accessToken、hostedUi.refreshToken三个值在集成配置向导中选择 Token 认证依次粘贴三个 Token 即可完成登录安装后如何查看 Emporia Vue 能耗数据完成 HACS 安装与账号配置后回到 Home Assistant 概览页就能看到效果每个通道都会生成对应的功率传感器仪表盘上可以实时查看当前功率并回放过去 6 小时甚至更长时间段的功率变化曲线直观掌握全屋与各回路的用电情况 顶部仪表盘显示当前实时功率如上图的 616 W 下方图表展示过去 6 小时的功率波动曲线 你还可以在集成选项中开启 1 分钟、1 天、1 个月等不同粒度的统计开关对应const.py中的ENABLE_1M、ENABLE_1D、ENABLE_1MON配置项常见问题排查HACS 安装后找不到集成怎么办问题现象解决方法配置列表里找不到 Emporia Vue确认已重启 HA并用CtrlShiftR强制刷新浏览器缓存添加集成时提示账号错误检查邮箱密码是否与 Emporia App 一致Google/Apple 账号需先设置密码或改用 Token 认证传感器数据一直不更新确认账号权限正确Emporia Vue 设备处于在线状态备选方案git clone 手动安装 ha-emporia-vue如果你不想使用 HACS也可以像安装其他自定义组件一样手动安装。先通过 git 克隆仓库git clone https://gitcode.com/gh_mirrors/ha/ha-emporia-vue然后进入仓库目录将custom_components/emporia_vue整个文件夹复制到 Home Assistant 配置目录下的custom_components/文件夹中没有就新建一个最后重启 Home Assistant 并按上面的步骤添加集成即可。无论选择哪种安装方式只要按照本教程完成 HACS 安装与配置你就能在 5 分钟内打通 Emporia Vue 与 Home Assistant把家里每一度电都看得清清楚楚 快去试试吧【免费下载链接】ha-emporia-vueHome Assistant Integration for Emporia Vue Energy Monitor项目地址: https://gitcode.com/gh_mirrors/ha/ha-emporia-vue创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考