📚 课程目录第2章基于CANoe的CAN总线错误帧注入

2. 基于CANoe的CAN总线错误帧注入

任务目标

本案例使用CANoe的CAN总线干扰功能，向被测ECU所在的CAN网络中注入错误帧（Error Frame），验证ECU在总线错误场景下是否能够正确检测错误、进入容错状态并在总线恢复后正常通信。通过本案例，你将掌握CANoe中错误帧注入的配置方法、测试执行流程以及结果判定标准。

环境与依赖

Vector CANoe（建议版本11.0及以上，支持CAN总线干扰功能）
支持CANoe干扰（Disturbance）功能的VN系列接口卡（如VN1610/VN1640）
被测ECU（DUT）及必要的电源、负载模拟
CANoe工程中已配置好CAN通道（如CAN1连接DUT，CAN2连接仿真节点）

实现方案

CANoe的错误帧注入通过干扰（Disturbance）模块实现。核心思路是：在DUT正常通信过程中，按预设条件在CAN总线上插入错误帧（破坏位填充规则或CRC段），使DUT收到错误帧并触发错误处理机制。本案例使用CAPL脚本控制干扰的启停，并通过监控DUT的响应报文来判断其容错行为。

关键完整代码

/* error_frame_injection.can */

/* 全局变量 */
variables
{
  int gErrorFrameCount = 0;          /* 已注入错误帧计数 */
  int gMaxInjections = 5;            /* 最大注入次数 */
  int gInjectionActive = 0;          /* 注入状态标志 */
  msTimer gInjectTimer;              /* 注入间隔定时器 */
}

/* 系统启动后初始化 */
on start
{
  write("错误帧注入测试启动");
  gErrorFrameCount = 0;
  gInjectionActive = 0;
}

/* 按键 'i' 开始注入 */
on key 'i'
{
  if (gInjectionActive == 0)
  {
    gInjectionActive = 1;
    gErrorFrameCount = 0;
    write("开始注入错误帧，目标次数: %d", gMaxInjections);
    setTimer(gInjectTimer, 100);  /* 100ms后开始第一次注入 */
  }
}

/* 按键 's' 停止注入 */
on key 's'
{
  gInjectionActive = 0;
  cancelTimer(gInjectTimer);
  write("手动停止注入，已注入 %d 次", gErrorFrameCount);
}

/* 定时器触发：执行错误帧注入 */
on timer gInjectTimer
{
  if (gInjectionActive == 0)
  {
    return;
  }

  if (gErrorFrameCount < gMaxInjections)
  {
    /* 在CAN1通道上注入一个错误帧 */
    canDisturbanceFrame(1, 0x123, 8, 0xFFFFFFFF, 0xFFFFFFFF, 0xFFFFFFFF, 0xFFFFFFFF, 0xFFFFFFFF, 0xFFFFFFFF, 0xFFFFFFFF, 0xFFFFFFFF, 0x1C);  /* 0x1C = 在CRC段后强制插入显性位，产生位填充错误 */
    
    gErrorFrameCount++;
    write("已注入第 %d 个错误帧", gErrorFrameCount);
    setTimer(gInjectTimer, 200);  /* 间隔200ms注入下一个 */
  }
  else
  {
    gInjectionActive = 0;
    write("错误帧注入完成，共注入 %d 次", gErrorFrameCount);
  }
}

/* 监控DUT的响应报文（假设DUT周期发送0x456报文） */
on message 0x456
{
  if (gInjectionActive == 1)
  {
    write("DUT响应报文0x456在注入期间仍正常接收，ID=0x456");
  }
}

/* 监控总线错误状态 */
on errorFrame
{
  write("检测到总线错误帧，错误计数器当前值: %d", errorFrameCounter());
}

运行与配置步骤

配置干扰功能：在CANoe工程中，打开Simulation Setup，右键点击CAN1通道，选择Disturbance（干扰）配置。确认干扰功能已启用，并选择“CAN”作为干扰类型。
加载CAPL脚本：将上述代码保存为error_frame_injection.can，添加到CANoe工程的Simulation Setup中的网络节点上（建议添加到一个独立的Test Node或单独的网络节点）。
配置DUT通信：确保DUT在CAN1上正常发送报文（如周期发送0x456），且CANoe能够正常接收。
编译并运行：点击CANoe的Start按钮开始仿真。
执行注入：在CANoe的Write Window中按键盘i键开始注入，按s键手动停止。

验证方法与判定标准

注入生效验证：在CANoe的Trace Window中，应能看到注入时刻出现红色标记的错误帧记录，且Write Window中打印“已注入第N个错误帧”日志。
DUT容错行为判定：观察DUT在错误帧注入期间及注入结束后的行为：
- 通过标准：DUT在错误帧注入期间可能短暂丢失通信，但在注入停止后（或总线恢复后）能够在规定时间（如500ms）内恢复正常发送0x456报文，且无故障码（DTC）记录，或记录的DTC符合预期设计。
- 失败标准：DUT在错误帧注入后持续无法恢复通信，或错误计数器持续增长导致总线关闭（Bus-off），且无法自动恢复。
错误计数器观察：在Statistics窗口中观察CAN1通道的Error Frame Count，确认其数值与注入次数一致（允许因总线其他干扰略有偏差）。

常见问题

干扰功能不可用：确认使用的VN接口卡支持Disturbance功能，且已在CANoe的Hardware Configuration中正确启用。
注入后总线关闭：如果错误帧注入过于频繁或DUT错误计数器溢出，可能导致DUT进入Bus-off状态。此时需要等待DUT执行Bus-off恢复策略（通常为128个11位隐性位），或通过断电重启DUT恢复。
注入参数调整：代码中canDisturbanceFrame最后一个参数0x1C表示在CRC段后插入显性位以产生位填充错误。如需注入其他类型错误（如CRC错误、ACK错误），可修改该参数值，具体参考CANoe的CAPL函数canDisturbanceFrame帮助文档。