CAPL系统事件-01 on preStart

在CAPL（CAN Access Programming Language）中，on preStart 事件是一个特殊的事件处理程序，用于在仿真节点（Simulation Node）启动之前执行特定的初始化操作。这个事件通常用于设置仿真环境的初始状态、初始化变量、配置总线参数等。

---

1. on preStart 事件的基本功能

• 触发时机：在仿真节点启动之前触发。
• 主要用途：
  • 初始化变量和信号。
  • 配置总线参数（如波特率、通道模式等）。
  • 设置仿真环境的初始状态。
  • 加载配置文件或数据。

---

2. on preStart 事件的语法

on preStart
{
    // 初始化代码
}

---

3. on preStart 事件的使用场景

场景1：初始化变量

在仿真开始之前，初始化全局变量或环境变量。

variables
{
    int gCounter = 0;
    message Msg1;
}

on preStart
{
    gCounter = 0; // 重置计数器
    Msg1.id = 0x100; // 初始化消息ID
    Msg1.dlc = 8; // 设置消息长度
}

场景2：配置总线参数

在仿真开始之前，配置CAN总线的参数（如波特率、通道模式等）。

on preStart
{
    // 设置CAN通道1的波特率为500 kbps
    canSetBaudrate(1, 500000);
    
    // 设置CAN通道1为正常模式
    canSetChannelMode(1, canCHANNEL_MODE_ACTIVE);
}

场景3：加载配置文件

在仿真开始之前，加载配置文件或数据。

on preStart
{
    // 加载DBC文件
    dbLoadDatabase("example.dbc");
    
    // 加载环境变量
    envVarLoad("env_vars.csv");
}

场景4：设置仿真环境的初始状态

在仿真开始之前，设置仿真环境的初始状态（如发送初始消息）。

on preStart
{
    // 发送初始消息
    message Msg1;
    Msg1.id = 0x100;
    Msg1.dlc = 8;
    Msg1.byte(0) = 0x01;
    output(Msg1);
}

---

4. on preStart 事件的注意事项

• 执行顺序：on preStart 事件在仿真节点启动之前执行，确保所有初始化操作在仿真开始之前完成。
• 仅适用于仿真节点：on preStart 事件仅适用于仿真节点，不适用于测试模块或测量节点。
• 避免耗时操作：由于 on preStart 事件在仿真开始之前执行，应避免执行耗时操作，以免延迟仿真启动。

---

5. 示例

以下是一个完整的CAPL脚本示例，展示了如何使用 on preStart 事件进行初始化和配置：

variables
{
    int gCounter = 0;
    message Msg1;
}

on preStart
{
    // 初始化变量
    gCounter = 0;
    Msg1.id = 0x100;
    Msg1.dlc = 8;
    
    // 配置CAN总线
    canSetBaudrate(1, 500000);
    canSetChannelMode(1, canCHANNEL_MODE_ACTIVE);
    
    // 加载DBC文件
    dbLoadDatabase("example.dbc");
    
    // 发送初始消息
    Msg1.byte(0) = 0x01;
    output(Msg1);
}

on message Msg1
{
    // 处理接收到的消息
    gCounter++;
    write("Received Msg1, Counter: %d", gCounter);
}

---

总结

on preStart 事件是CAPL中用于在仿真节点启动之前执行初始化操作的重要事件处理程序。通过合理使用 on preStart 事件，可以确保仿真环境的正确配置和初始化，从而提高仿真脚本的可靠性和效率。