CAPL函数-03定时器函数

在 CAPL（CAN Access Programming Language）中，定时器函数用于创建和管理定时器，以实现周期性或延迟操作。定时器在 CAPL 脚本中非常常用，例如用于周期性发送消息、超时检测、任务调度等。

---

CAPL 中的定时器函数分类

1. 定时器创建与启动

• setTimer
  启动或重启一个定时器。

  void setTimer(timer t, long duration);
  

  • t：定时器变量。
  • duration：定时器时长（单位：毫秒）。

  示例：

  variables {
      timer msTimer1;
  }
  
  on start {
      setTimer(msTimer1, 100); // 启动定时器，100ms 后触发
  }
  

---

2. 定时器取消

• cancelTimer
  取消一个正在运行的定时器。

  void cancelTimer(timer t);
  

  示例：

  on key 'c' {
      cancelTimer(msTimer1); // 取消定时器
  }
  

---

3. 定时器状态检查

• isTimerActive
  检查定时器是否正在运行。

  int isTimerActive(timer t);
  

  • 返回值：1 表示定时器正在运行，0 表示定时器未运行。

  示例：

  on key 's' {
      if (isTimerActive(msTimer1)) {
          write("定时器正在运行");
      } else {
          write("定时器未运行");
      }
  }
  

---

4. 定时器事件

• on timer 事件
  当定时器触发时执行的操作。

  on timer <timerName> {
      // 定时器触发时的操作
  }
  

  示例：

  variables {
      timer msTimer1;
      int counter = 0;
  }
  
  on start {
      setTimer(msTimer1, 100); // 启动定时器
  }
  
  on timer msTimer1 {
      counter++;
      write("定时器触发，计数器值: %d", counter);
      setTimer(msTimer1, 100); // 重新启动定时器
  }
  

---

5. 定时器类型

CAPL 支持两种定时器类型：

• 毫秒定时器：基于毫秒的定时器，使用 timer 关键字定义。

• 秒定时器：基于秒的定时器，使用 secondsTimer 关键字定义。

  示例：

  variables {
      timer msTimer1;       // 毫秒定时器
      secondsTimer secTimer1; // 秒定时器
  }
  
  on start {
      setTimer(msTimer1, 100); // 100 毫秒
      setTimer(secTimer1, 5);  // 5 秒
  }
  
  on timer msTimer1 {
      write("毫秒定时器触发");
      setTimer(msTimer1, 100); // 重新启动
  }
  
  on timer secTimer1 {
      write("秒定时器触发");
      setTimer(secTimer1, 5); // 重新启动
  }
  

---

示例：综合使用定时器函数

示例 1：周期性发送消息

variables {
    timer msTimer1;
    message 0x100 msg1;
    int counter = 0;
}

on start {
    msg1.dlc = 8; // 设置消息长度
    setTimer(msTimer1, 100); // 启动定时器
}

on timer msTimer1 {
    // 设置消息数据
    msg1.byte(0) = counter;
    output(msg1); // 发送消息
    counter++;
    setTimer(msTimer1, 100); // 重新启动定时器
}

示例 2：超时检测

variables {
    timer timeoutTimer;
}

on message 0x100 {
    write("接收到消息 0x100");
    cancelTimer(timeoutTimer); // 取消超时定时器
}

on start {
    setTimer(timeoutTimer, 1000); // 启动超时定时器
}

on timer timeoutTimer {
    write("超时：未收到消息 0x100");
}

---

注意事项

1. 定时器精度：

   • CAPL 定时器的精度取决于系统的调度能力，通常可以满足毫秒级的需求。

2. 定时器数量：

   • CAPL 脚本中可以定义多个定时器，但过多的定时器可能会影响性能。

3. 定时器重启：

   • 在 on timer 事件中调用 setTimer 可以重新启动定时器，实现周期性任务。

4. 定时器取消：

   • 使用 cancelTimer 可以手动取消定时器，避免不必要的触发。

---

总结

CAPL 中的定时器函数主要包括：

1. setTimer：启动或重启定时器。
2. cancelTimer：取消定时器。
3. isTimerActive：检查定时器状态。
4. on timer 事件：定时器触发时执行的操作。

通过灵活使用这些函数，可以实现周期性任务、超时检测、任务调度等功能，满足仿真、测试和分析的需求。