EVCC项目中Audi车辆唤醒功能故障排查指南

问题背景

在EVCC 0.202.1版本中，部分Audi车型（如Q5 TFSI e）出现了定时充电功能异常的情况。具体表现为：当车辆按照预设计划进行夜间充电时，系统虽然会尝试执行"wake-up vehicle"操作，但最终未能成功启动充电过程。

技术现象分析

从日志中可以观察到以下关键行为模式：

1. 系统能够正确识别充电计划时间
2. 到达预定时间后会尝试唤醒车辆（显示"wake-up vehicle, attempts left: 4"）
3. 唤醒尝试失败后，系统会自动调整启动时间
4. 经过4次尝试后，充电过程仍未启动

根本原因

经过技术排查，发现问题的核心在于：

1. 车辆的网络连接状态直接影响唤醒功能的成功率
2. 当车辆处于休眠状态且无移动网络连接时，远程唤醒指令无法送达
3. 通过命令行直接执行"evcc vehicle --wakeup"可以验证API接口本身工作正常

解决方案

对于遇到类似问题的用户，建议采取以下步骤进行排查和解决：

1. 网络连接验证

   • 确保车辆停放在有良好移动网络信号的位置
   • 通过Audi官方App测试远程控制功能是否可用

2. 手动唤醒测试

   evcc vehicle --wakeup
   

   观察Audi App是否显示"Laden wird gestartet..."提示

3. 系统配置检查

   • 确认EVCC配置中的车辆信息（VIN、账号等）正确无误
   • 检查cache设置是否合理（建议15分钟以上）

4. 环境因素排除

   • 避免在车辆深度休眠时立即尝试唤醒
   • 考虑增加唤醒尝试间隔时间

技术建议

对于开发者而言，可以考虑以下改进方向：

1. 增强唤醒失败的错误日志记录
2. 实现更智能的重试机制
3. 增加网络连接状态检测功能
4. 提供更明确的用户反馈机制

用户操作指南

1. 当发现定时充电不工作时：

   • 首先检查车辆的网络连接状态
   • 尝试通过Audi App手动启动充电
   • 确认EVCC服务正常运行

2. 对于长期解决方案：

   • 考虑将车辆停放在信号更好的位置
   • 在EVCC配置中适当延长唤醒超时时间
   • 保持EVCC和车辆系统软件为最新版本

总结

该问题主要源于车辆网络连接状态与唤醒机制的交互问题，而非EVCC本身的功能缺陷。通过合理的配置和环境优化，用户可以确保定时充电功能的稳定运行。EVCC开发团队将持续关注此类问题，并在未来版本中进一步优化车辆控制逻辑。