打造专属家庭能源仪表盘：ha-emporia-vue 传感器接入 Home Assistant 能量面板实战

打造专属家庭能源仪表盘：ha-emporia-vue 传感器接入 Home Assistant 能量面板实战

【免费下载链接】ha-emporia-vueHome Assistant Integration for Emporia Vue Energy Monitor项目地址: https://gitcode.com/gh_mirrors/ha/ha-emporia-vue

想给家里装一套家庭能源仪表盘，实时掌握每个房间、每台电器的用电量？借助ha-emporia-vue这个开源集成，你只需几步就能把 Emporia Vue 智能电表的数据接入Home Assistant 能量面板，从此用电数据一目了然。这篇文章将带你完成从安装到接入能量面板的全流程，即使你是新手也能轻松搞定。

为什么推荐 ha-emporia-vue？

ha-emporia-vue 是 Home Assistant 的官方社区集成（非官方出品，但广受好评），它通过 Emporia 官方 API 拉取数据，为每一个电流互感器（CT）通道自动创建一个传感器，显示每分钟的平均功率。项目自带日、月累计统计，还支持太阳能反向计量，甚至能联动 Emporia 智能插座和 EV 充电桩，是一套相当完整的家庭能源监控方案。

一键安装步骤：通过 HACS 快速部署

最省心的安装方式是使用 HACS（Home Assistant Community Store）。由于该集成尚未进入 HACS 默认商店，需要先把它添加为自定义仓库。

第 1 步：进入 HACS 后点击Integrations（集成）。

第 2 步：点击右上角三点菜单，选择Custom repositories，打开自定义仓库管理界面。

第 3 步：在 "Add custom repository URL" 输入框粘贴仓库地址，类别选择Integration，然后点击ADD。仓库地址为：https://gitcode.com/gh_mirrors/ha/ha-emporia-vue

第 4 步：返回列表找到Emporia Vue，点击下载安装。完成后重启 Home Assistant 并清理浏览器缓存（Ctrl+Shift+R），即可在配置列表中看到它。

手动安装方法（不用 HACS 也能装）

如果你偏好手动安装，直接把项目里的custom_components/emporia_vue文件夹合并到 Home Assistant 配置目录的custom_components下即可。集成依赖pyemvue与boto3两个 Python 库，需确保环境已安装。核心入口代码可参考init.py。

最快配置方法：UI 界面三分钟完成

ha-emporia-vue 完全支持 UI 配置，无需编辑任何 YAML 文件。

1. 进入 Home Assistant 的设置 → 设备与服务；
2. 点击右下角添加集成，搜索Emporia Vue；
3. 输入 Emporia App 的邮箱和密码即可完成登录；
4. 稍等片刻，系统会自动为每个通道创建传感器实体。

整个鉴权流程由 config_flow.py 驱动，支持邮箱密码和 Token 两种认证方式。

Google/Apple 账号的 Token 配置技巧

如果你的 Emporia 账号是通过 Google 或 Apple 登录的，最简单的办法是在 Emporia 官网用同一邮箱设置一个密码，之后就能用标准邮箱密码登录。若不便设置密码，也可以采用 Token 认证：登录 web.emporiaenergy.com 后，按 F12 打开开发者工具，在 IndexedDB 中找到idToken、accessToken、refreshToken三个值（以eyJ开头），填入 Token 认证表单即可。

传感器接入能量面板的核心配置

接入成功后，你会获得三类关键传感器，它们正是能量面板的数据来源：

传感器实体的生成逻辑位于 sensor.py，集成还针对太阳能发电提供了「反转太阳能读数」选项——Emporia 通常把太阳能记为负值，而能量面板要求正数，勾选该选项即可正确显示发电数据。

接着只需在 Home Assistant 的能量面板中，把各用电传感器添加为「家庭用电」，太阳能传感器添加为「太阳能生产」，就能生成漂亮的能源流向图与历史曲线，彻底告别手工记账。

进阶玩法：EV 充电桩与智能插座联动

如果你拥有 Emporia 智能插座或 EV 充电桩，ha-emporia-vue 还会自动生成开关实体（远程通断电）和电流限制实体（设置充电电流，6A 起步）。EV 充电桩的状态传感器会映射为 IEC 61851 标准状态码（如 Charging / Connected / Disconnected），相关实现可参考 switch.py 与 number.py。

常见问题排查

• 配置列表找不到集成：多半是浏览器缓存问题，强制刷新页面或重启 Home Assistant。
• 显示「无法认证」：确认邮箱密码无误；Google/Apple 账号请改用 Token 方式。
• 日/月数据归零异常：集成会自动按本地零点与账单周期重置，若刚跨过重置点出现短暂波动，属正常现象。

写在最后

有了 ha-emporia-vue，搭建家庭能源仪表盘不再需要昂贵的专业设备，一块 Emporia Vue 电表加上开箱即用的集成，就能把全屋用电数据装进Home Assistant 能量面板。从实时功率到月度账单统计，从太阳能发电到 EV 充电管理，它都能帮你轻松掌控。现在就动手安装，开启你的智能用电之旅吧！⚡

【免费下载链接】ha-emporia-vueHome Assistant Integration for Emporia Vue Energy Monitor项目地址: https://gitcode.com/gh_mirrors/ha/ha-emporia-vue