EVCC项目中Shelly EM设备能量计量问题的技术分析

问题背景

在EVCC开源项目中，用户报告了一个关于Shelly EM(Gen1)设备的能量计量问题。该设备作为热泵充电器使用时，系统错误地将总能量(total)和返回能量(total_returned)两个值进行了相互抵消计算，导致显示的能量值不正确。

技术细节分析

Shelly EM设备提供了两个能量计量值：

1. total - 正向流动能量（消耗）
2. total_returned - 反向流动能量（回馈）

在EVCC的早期版本中，代码仅使用total值作为能量计量结果。但在最近的代码重构中，将Shelly设备的两种实现(energymeter.go和switch.go)进行了合并，导致现在系统会计算两个值的差值。

问题根源

经过技术团队分析，发现问题出现在以下方面：

1. 设备历史数据影响：用户曾将该Shelly EM设备用于测量电池系统，后来又改为测量热泵，导致设备中存储了历史能量数据。

2. 计量逻辑变更：代码重构后，系统开始同时考虑正向和反向能量值，而之前版本仅使用正向能量值。

3. 设备配置要求：正确的设备安装应该确保能量仅向一个方向流动，因此理论上只需要关注一个方向的能量值。

解决方案

技术团队经过讨论确定了以下解决方案：

1. 恢复仅使用正向能量值(total)的逻辑，与Gen2 API保持一致。

2. 建议用户在改变设备用途时重置能量计数器。

3. 关于反向能量(total_returned)的计量将作为独立功能考虑，不在基础能量计量中处理。

技术建议

对于使用Shelly EM设备的EVCC用户，建议：

1. 在改变设备测量对象时，通过Shelly App重置能量计数器。

2. 确保设备正确安装，使能量流向与测量需求一致。

3. 了解系统仅显示正向能量值的设计理念。

未来改进方向

技术团队注意到用户对反向能量计量的需求，计划：

1. 将反向能量计量作为可选功能单独实现。

2. 保持基础能量计量逻辑的简单性和一致性。

3. 完善设备配置文档，明确能量计量的工作原理和限制。

这个问题展示了在物联网设备集成中，历史数据管理和计量逻辑一致性的重要性，也为EVCC项目的设备支持功能提供了有价值的改进方向。