CAPL的CAN控制器事件-03 on errorPassive

在CAPL（CAN Access Programming Language）中，on errorPassive 是一个事件处理程序，用于在CAN控制器进入错误被动状态（Error Passive State） 时执行特定的操作。这个事件是CAPL中用于监控CAN控制器状态的重要机制之一。

---

错误被动状态（Error Passive State）

在CAN总线通信中，CAN控制器会根据发送错误计数器（TEC）和接收错误计数器（REC）的值 进入不同的错误状态：

1. 主动错误状态（Error Active）：默认状态，CAN控制器可以正常发送和接收报文，并在检测到错误时发送主动错误帧。
2. 错误被动状态（Error Passive）：当TEC或REC的值超过127时，CAN控制器进入此状态。此时，控制器仍然可以通信，但在检测到错误时只能发送被动错误帧。
3. 总线关闭状态（Bus Off）：当TEC的值超过255时，CAN控制器将停止总线通信。

on errorPassive 事件会在CAN控制器从主动错误状态进入错误被动状态时触发。

---

on errorPassive 事件的使用

你可以在CAPL脚本中定义 on errorPassive 事件处理程序，以便在CAN控制器进入错误被动状态时执行特定的操作，例如记录日志、发送诊断报文或采取恢复措施。

语法

on errorPassive {
  // 在这里编写处理逻辑
}

---

示例代码

以下是一个完整的CAPL示例，展示了如何使用 on errorPassive 事件：

variables {
  // 定义变量，用于记录错误被动状态的次数
  int errorPassiveCount = 0;
}

on errorPassive {
  // 当CAN控制器进入错误被动状态时触发
  write("CAN控制器已进入错误被动状态！");

  // 增加错误被动状态计数器
  errorPassiveCount++;
  write("错误被动状态发生次数: %d", errorPassiveCount);

  // 可以在这里添加恢复逻辑，例如重置错误计数器或发送诊断报文
  // 例如：重置CAN控制器的错误计数器
  resetCanController();
}

// 自定义函数：重置CAN控制器的错误计数器
void resetCanController() {
  long tec, rec;
  // 获取当前CAN通道的错误计数器值
  ChnGetErrorCounters(1, tec, rec); // 假设使用CAN通道1
  write("当前TEC: %d, REC: %d", tec, rec);

  // 重置错误计数器
  ChnResetErrorCounters(1); // 重置CAN通道1的错误计数器
  write("已重置CAN控制器的错误计数器。");
}

---

关键点说明

1. 触发条件：

   • on errorPassive 事件在CAN控制器的TEC或REC超过127时触发。
   • 如果错误进一步恶化（TEC超过255），CAN控制器将进入总线关闭状态，此时会触发 on busOff 事件。

2. 错误计数器：

   • 可以使用 ChnGetErrorCounters() 函数获取当前CAN通道的发送错误计数器（TEC）和接收错误计数器（REC）的值。
   • 可以使用 ChnResetErrorCounters() 函数重置错误计数器。

3. 恢复措施：

   • 在 on errorPassive 事件中，可以采取一些恢复措施，例如重置错误计数器、发送诊断报文或重启CAN控制器。

4. 与其他事件的关系：

   • on errorPassive 通常与 on errorActive 和 on busOff 事件一起使用，以全面监控CAN控制器的状态。

---

扩展：相关事件

• on errorActive：当CAN控制器从错误被动状态恢复到主动错误状态时触发。
• on busOff：当CAN控制器进入总线关闭状态时触发。

示例：

on errorActive {
  write("CAN控制器已恢复到主动错误状态！");
}

on busOff {
  write("CAN控制器已进入总线关闭状态！");
}

---

如果你有更多关于CAPL或CAN总线的问题，欢迎继续提问！