4、CAPL脚本入门：CAPL语言特性、事件函数模型、变量与数据类型、常用系统函数
好，咱们进入CAPL脚本的世界。说实话，很多刚接触CANoe的朋友，一看到CAPL就头大。觉得它像C语言，又不完全是。我当年刚入行时也这么觉得。但用久了你会发现，它其实就是为汽车总线测试量身定做的一把瑞士军刀。今天我就带你把它拆开看看，到底怎么用。
4.1 CAPL语言特性：它到底特别在哪？
CAPL全称是Communication Access Programming Language。说白了，它就是一种事件驱动的脚本语言。什么叫事件驱动？你想想看，你写个普通程序，是从上往下跑的。但CAPL不是，它是“等”在那里的。等什么？等总线上的信号变化，等定时器超时，等按键被按下。
我个人习惯把CAPL比作一个“门卫”。它平时就站在门口，看到特定的人（事件）来了，才执行特定的动作（函数）。这种模型特别适合做总线仿真和测试。
核心特性总结：
- 事件驱动：程序不是主动运行，而是被动响应。
- 类C语法：如果你写过C语言，上手会很快。但要注意，它没有指针，没有动态内存分配。
- 强类型：变量必须先声明，后使用。类型错了，编译会报错。
- 专为总线设计：内置了对CAN、LIN、FlexRay、Ethernet等总线的直接支持。
嗯，这里要注意一点。CAPL虽然像C，但它不是C。你不能在CAPL里写malloc或者printf。它的输出函数是write()，不是printf。我刚开始学的时候，就老犯这个错，编译报错半天找不到原因。
4.2 事件函数模型：CAPL的灵魂
事件函数，就是CAPL的“灵魂”。你写的所有逻辑，几乎都挂在这些事件函数下面。常见的几类，我给你列出来：
| 事件类型 | 关键字 | 触发时机 |
|---|---|---|
| 系统事件 | on start |
测量开始时执行一次 |
| 系统事件 | on preStart |
测量开始前执行（用于初始化） |
| 系统事件 | on stopMeasurement |
测量停止时执行 |
| 总线事件 | on message 0x123 |
收到ID为0x123的CAN报文时 |
| 总线事件 | on signal SignalName |
信号SignalName的值发生变化时 |
| 定时器事件 | on timer TimerName |
定时器TimerName超时时 |
| 键盘事件 | on key 'a' |
按下键盘上的'a'键时 |
你看，是不是很直观？每个事件函数都以on开头，后面跟着事件类型。我建议你记住这个套路，因为CAPL里几乎所有交互都是通过这种方式实现的。
举个例子，你想在收到发动机转速报文时，打印一下当前转速。代码怎么写？
on message EngineData
{
// 假设EngineData报文里有一个信号叫EngineSpeed
write("当前发动机转速: %d rpm", this.EngineSpeed);
}这里有个小细节。this关键字，代表当前触发事件的报文对象。你通过this.信号名就能直接访问到信号值。我在项目中遇到过，有人把this写成了msg，结果编译报错。记住，在on message里，就用this。
4.3 变量与数据类型：存东西得有“容器”
变量就是用来存数据的“容器”。CAPL的数据类型，我整理了一下，常用的就这些：
| 类型 | 关键字 | 说明 | 示例 |
|---|---|---|---|
| 整数 | int, long, dword |
有符号/无符号，32位 | int counter = 0; |
| 浮点数 | float |
单精度浮点 | float voltage = 12.5; |
| 字符 | char |
单个字符 | char ch = 'A'; |
| 字符串 | char[] |
字符数组，用于存文本 | char msg[32] = "Hello"; |
| 布尔 | byte 或 int |
CAPL没有专门的bool，用0/1代替 | byte isOk = 1; |
| 报文 | message * |
用于定义总线报文对象 | message 0x100 txMsg; |
| 定时器 | timer, msTimer |
毫秒/秒级定时器 | msTimer myTimer; |
个人经验： 我建议你尽量用int和float。别用long和dword，除非你明确知道自己在处理无符号数。因为CAPL里int和long其实都是32位，用int更直观，不容易搞混。
变量的作用域也分三种：
- 全局变量：声明在所有函数外面，整个文件都能用。
- 局部变量：声明在函数内部，只有那个函数能用。
- 静态变量：用
static修饰的局部变量，函数退出后值不丢失。
举个例子，你写个计数器，每次收到报文就加1。用静态变量就很方便：
on message 0x100
{
static int count = 0;
count++;
write("收到第 %d 次报文", count);
}你看，count每次进来都不会清零。这就是静态变量的妙用。我曾经在做一个网关仿真时，需要统计每种报文的接收次数，就是用静态变量实现的，非常简洁。
4.4 常用系统函数：CAPL的“工具箱”
CAPL自带了很多系统函数，帮你省去造轮子的时间。我挑几个最常用的，你记一下：
| 函数名 | 功能 | 示例 |
|---|---|---|
write() |
输出文本到Write窗口 | write("Hello %d", x); |
setTimer() |
启动一个定时器 | setTimer(myTimer, 100); // 100ms后触发 |
cancelTimer() |
取消一个定时器 | cancelTimer(myTimer); |
output() |
发送一个报文到总线上 | output(txMsg); |
getSignal() |
读取某个信号的值 | speed = getSignal(EngineSpeed); |
setSignal() |
设置某个信号的值 | setSignal(EngineSpeed, 2000); |
timeNow() |
获取当前系统时间（纳秒） | t = timeNow(); |
strlen() |
获取字符串长度 | len = strlen(msg); |
避坑指南： 我曾经在项目里用setTimer()时，忘了定时器是单次的。也就是说，触发一次后，它就停了。如果你想要周期触发，必须在on timer里再次调用setTimer()。这个坑我踩过，后来养成了习惯：每次在on timer里第一行就写setTimer()，确保它一直跑。
再给你看个综合例子，把上面这些串起来：
/* 全局变量 */
message 0x200 txMsg;
msTimer cycleTimer;
on start
{
/* 初始化报文 */
txMsg.dlc = 8;
txMsg.byte(0) = 0xAA;
/* 启动周期定时器，每100ms触发一次 */
setTimer(cycleTimer, 100);
write("仿真开始，定时器已启动");
}
on timer cycleTimer
{
/* 定时器触发，发送报文 */
output(txMsg);
/* 重新启动定时器，实现周期发送 */
setTimer(cycleTimer, 100);
}
on message 0x100
{
/* 收到0x100报文时，打印其第一个字节 */
write("收到0x100报文，Byte0 = 0x%02X", this.byte(0));
}
on key 's'
{
/* 按's'键，停止定时器 */
cancelTimer(cycleTimer);
write("定时器已停止");
}这个例子涵盖了on start、on timer、on message、on key四种事件，以及setTimer、cancelTimer、output、write四个系统函数。你把它跑一遍，基本就掌握了CAPL的骨架。
好了，这一章的内容就到这。CAPL入门其实不难，关键是理解“事件驱动”这个核心思想。你想想看，你不需要控制程序什么时候跑，你只需要告诉它“当XX发生时，做XX事”。剩下的，CAPL帮你搞定。下一章，我会带你深入CAPL的字符串处理和数组操作，到时候咱们再聊。