TeslaMateAgile项目实现法国EDF Tempo电价集成方案解析

TeslaMateAgile项目实现法国EDF Tempo电价集成方案解析

背景介绍

TeslaMateAgile是一个开源项目，主要用于与TeslaMate电动汽车数据记录系统集成，实现基于动态电价的充电成本计算。近期社区开发者针对法国电力公司(EDF)的Tempo电价方案进行了服务提供商实现，这是一个颇具特色的电价体系。

EDF Tempo电价机制特点

法国EDF的Tempo电价方案具有以下技术特点：

1. 三色电价体系：分为蓝色(Blue)、白色(White)和红色(Red)三种电价日，每种颜色对应不同的电价水平。

2. 时段划分：

   • 高峰时段(HP)：6:00-22:00
   • 低谷时段(HC)：22:00-次日6:00

3. 特殊时间规则：电价日的切换发生在每天6:00而非午夜。例如，如果周五是红色日而周六是白色日，则周六0:00-6:00仍按周五的红色日HC电价计算，6:00后才切换为白色日。

技术实现方案

在TeslaMateAgile项目中实现EDF Tempo电价集成的关键技术点包括：

1. API集成：通过第三方API获取Tempo电价颜色数据，而非直接连接EDF/Enedis官方API，简化了实现复杂度。

2. 电价映射：配置六种不同的电价参数，分别对应三种颜色下的HP和HC时段：

   • BLUE_HP
   • BLUE_HC
   • WHITE_HP
   • WHITE_HC
   • RED_HP
   • RED_HC

3. 时间处理逻辑：正确处理电价日切换的特殊时间规则，确保6:00前后的时段能正确应用前一日和后一日的电价。

4. 数据验证：实现严格的数据验证机制，当电价数据不完整或不可用时抛出异常，避免错误计算。

部署配置

用户可以通过Docker环境变量配置EDF Tempo服务：

environment:
  - EDFTempo__BaseUrl=https://www.api-couleur-tempo.fr/api/joursTempo
  - EDFTempo__BLUE_HP=0.1552
  - EDFTempo__BLUE_HC=0.1288
  - EDFTempo__WHITE_HP=0.1792
  - EDFTempo__WHITE_HC=0.1447
  - EDFTempo__RED_HP=0.6586
  - EDFTempo__RED_HC=0.1518
  - TeslaMate__EnergyProvider=EDFTempo

技术挑战与解决方案

在实现过程中，开发团队遇到了几个关键技术挑战：

1. 充电结束时的0值问题：最初实现中，充电刚结束时计算可能会得到0值。解决方案是确保初始成本值为NULL而非0，并在数据不完整时抛出异常触发重试机制。

2. 时间边界处理：精确处理6:00的日切换时间点，确保电价颜色和时段正确对应。

3. 多平台支持：最初版本仅支持arm64架构，后续扩展为支持linux/arm64和linux/amd64多平台。

4. 测试验证：通过SQL注入方式模拟充电过程，验证电价计算的准确性。

实际应用效果

经过社区测试验证，该实现能够：

• 正确识别Tempo电价颜色日
• 精确划分HP/HC时段
• 准确计算跨日充电(如20:00-8:00)的总成本
• 自动处理电价日切换的特殊规则

总结

TeslaMateAgile对EDF Tempo电价方案的集成，展示了该项目灵活支持不同地区复杂电价体系的能力。通过合理的架构设计和严谨的数据验证机制，成功实现了这一具有法国特色的动态电价计算功能，为当地特斯拉车主提供了准确的充电成本分析工具。该实现也为其他复杂电价体系的集成提供了有价值的参考案例。