硬核科普Emporia Vue 电表如何工作ha-emporia-vue 又怎样将每路电路数据搬进 Home Assistant【免费下载链接】ha-emporia-vueHome Assistant Integration for Emporia Vue Energy Monitor项目地址: https://gitcode.com/gh_mirrors/ha/ha-emporia-vueEmporia Vue 电表是目前智能家居圈性价比极高的家庭用电监测神器配合开源的 ha-emporia-vue 集成就能把每一路电路的实时功率、每日用电、每月用电全部搬进 Home Assistant。本文用大白话讲透 Emporia Vue 电表的工作原理、数据链路并给出最简安装与配置步骤帮你彻底告别电费去哪了的谜题。Emporia Vue 电表的工作原理藏在配电箱里的电流侦探Emporia Vue 本身不靠猜它靠的是电流互感器CTCurrent Transformer。每个 CT 就像一个小钳子卡在入户总闸或各分路空开的火线上通过电磁感应测量流过导线的电流大小。总表 分路Vue 主机通常接 2 个总进线 CT再加 8/16 路分路 CT一路一个房间或一台大功率电器空调、热水器、充电桩。功率 电压 × 电流主机根据测得电流乘上电压算出每一路的瞬时功率W再按时间累加成电量kWh。云端存储Vue 主机通过 Wi-Fi 把数据上传到 Emporia 官方云平台你在手机 App 里看到的所有曲线都来自这个云。所以本质上Emporia Vue 电表负责采集而数据真正的中转站是 Emporia 云 API。这也决定了下面的数据搬运方式——ha-emporia-vue 并不直接读电表硬件而是从官方云端 API 拉取再交给 Home Assistant。ha-emporia-vue把云 API 数据变成 Home Assistant 传感器的翻译官ha-emporia-vue 是一个标准的 Home Assistant 自定义集成Custom Component它的核心思路非常简单定时轮询 Emporia 云 API → 解析每路通道数据 → 生成功率/电量传感器 → 交给 Home Assistant 展示和自动化。这个集成本质上是云端轮询iot_class: cloud_polling模式所有逻辑集中在custom_components/emporia_vue目录下几个关键文件分工明确__init__.py负责登录、拉取设备列表、创建多个数据更新协调器DataUpdateCoordinator是整个集成的心脏sensor.py把每路电路数据解析成功率W与电量kWh传感器config_flow.pyUI 配置流程负责邮箱密码登录或 Token 登录switch.py/number.py把 Emporia 智能插座和 EV 充电桩变成可控制的开关与电流调节滑块。整个数据流可以概括成一条链Emporia Vue 电表 → Emporia 云 API → ha-emporia-vue轮询解析→ Home Assistant 传感器 → 仪表盘/自动化每路电路数据是怎么搬进 Home Assistant 的很多新手好奇为什么一个电表能变成十几个传感器秘密在于**通道Channel**机制。1. 设备与通道的映射登录后集成会调用vue.get_devices拿到你的所有 Vue 设备再读取每个设备的通道列表channel_num。每个通道对应一路电路比如1,2,3通常是三相总表4可能是厨房插座5可能是空调这些命名会直接成为 Home Assistant 里的实体名称。2. 三种时间尺度各司其职__init__.py里创建了三个更新协调器每 1 分钟轮询一次云 API分钟级1min显示最近一分钟平均功率也就是仪表盘上跳动的实时功率曲线日级day显示今日累计用电 kWh并巧妙地把分钟数据累加进当天总量月级month显示本月用电 kWh还支持按你的账单结算日自动清零重算。3. 智能的数据处理细节__init__.py里藏了不少硬核细节太阳能回路自动翻转正负号solar_invert、凌晨跨天自动归零check_for_midnight、账单周期切换自动重置check_for_new_month、以及防止 API 延迟导致电量虚增的防抖逻辑——这些都是在sensor.py和__init__.py中逐行实现的保证你看到的电量数字和电费账单对得上。最快安装方法HACS 三步搞定 ⚡对普通用户来说最省事的安装方式是 HACSHome Assistant Community Store。第一步添加自定义仓库打开 HACS → 集成Integrations→ 右上角三个点 →自定义仓库把仓库地址粘贴进去类别选择Integration第二步下载集成添加成功后在集成列表里搜索Emporia Vue点击下载即可。之后重启 Home Assistant必要时清一下浏览器缓存让新集成生效如果你不想用 HACS也可以手动把custom_components文件夹合并进 Home Assistant 的配置目录同时安装 pyemvue 依赖库或者直接克隆仓库https://gitcode.com/gh_mirrors/ha/ha-emporia-vue后取出对应文件。最快配置方法UI 里填账号无需改 YAML ✍️安装完成后在 Home Assistant 的设置 → 设备与服务 → 添加集成搜索 Emporia Vue按提示操作普通 Emporia 账号直接填邮箱和密码一次登录自动发现全部设备和通道Google/Apple 登录的账号先到 Emporia 官网给账号设置一个密码或者用浏览器开发者工具从 IndexedDB 中取出 idToken / accessToken / refreshToken走 Token 认证可选开关分钟、日、月传感器可分别启用或关闭太阳能用户还能开启太阳能数值翻转让发电数据在能源仪表盘上正确显示为正数。全部在 UI 里完成config_flow.py会自动校验账号并存储配置完全不需要手写 configuration.yaml。进阶玩法不止是电表还能管充电桩与插座 如果你家里还有 Emporia 的智能插座或 EV 充电桩ha-emporia-vue 会额外生成开关实体switch.py远程开/关插座或充电桩电流调节滑块number.py像调节音量一样把充电桩的充电电流限制在 6A 到电路上限之间随意调充电状态传感器sensor.py显示充电中 / 已连接 / 已断开 / 故障等状态还能看到 IEC 61851 标准状态码。配合 Home Assistant 的自动化你甚至可以做到光伏发电充足时自动给车充电电价高峰自动暂停——这才是智能家居真正的乐趣所在。常见问题与避坑指南 ️传感器没出现重启后等 1~2 分钟分钟级数据会先刷新日/月传感器随后跟上。电量数字对不上账单检查月传感器设置中的账单结算日以及太阳能回路是否开启了翻转。提示登录失败确认账号密码无误如果是 SSO 账号Token 过期后需要在集成里重新认证config_flow.py已内置 reauth 流程。总结从一块电表到全屋用电大脑 Emporia Vue 电表负责用电流互感器精准采集每路电路数据ha-emporia-vue 集成则负责把云端数据翻译成 Home Assistant 能用的功率与电量传感器。从实时功率到每日每月累计再到充电桩与插座的远程控制整套方案安装简单、配置全 UI、数据颗粒度细是普通家庭迈向能源管理的第一步。现在打开你的 Home Assistant把每一路电路的用电数据搬进来让电费账单从此一目了然吧【免费下载链接】ha-emporia-vueHome Assistant Integration for Emporia Vue Energy Monitor项目地址: https://gitcode.com/gh_mirrors/ha/ha-emporia-vue创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考