第3章 CAPL脚本基础：从Hello World开始

说实话，很多刚接触CANoe的朋友，一看到CAPL这三个字母就有点发怵。觉得它像C语言，又不太一样，语法看着眼熟，写起来却总报错。我当年刚入行时也是这样，对着帮助文档啃了半天，结果写个最简单的发送报文都卡壳。

这一章，咱们就把CAPL这层窗户纸捅破。你不需要有C语言基础，跟着我的节奏，一步步来。

3.1 CAPL语言到底是什么？

CAPL的全称是Communication Access Programming Language，直译过来就是“通信访问编程语言”。它是Vector公司专门为CANoe开发的一种事件驱动型脚本语言。

什么叫“事件驱动”？说白了，就是你的脚本平时处于“待机”状态，只有特定的事情发生了，它才会被激活执行。比如：

• 总线上来了一条报文
• 某个信号值发生了变化
• 你按下了面板上的一个按钮
• 定时器到期了

这些就是“事件”。你的CAPL脚本就是为这些事件编写“响应程序”。

3.2 CAPL与C语言的异同

很多教材喜欢列一张大表，把CAPL和C语言从头比到尾。我换个方式，咱们直接看几个最关键的差异点。

对比项	C语言	CAPL
程序入口	main() 函数	无main函数，靠事件触发
头文件	#include <stdio.h> 等	#includes 引用CANdb等数据库
指针	支持，且功能强大	不支持，这是最大区别
动态内存	malloc/free	不支持，变量必须静态声明
标准库	printf, scanf, string.h 等	专用API：output, setSignal, timer 等
变量作用域	局部/全局/静态	类似，但全局变量需在variables块声明
数据类型	int, char, float, double	int, byte, word, dword, float, char 等

除了上面这些，还有几个细节你需要注意：

• 语句结束符：和C一样，用分号 ;
• 注释：支持 // 单行注释和 /* */ 多行注释
• 大小写敏感：myVar 和 myvar 是两个不同的变量
• 函数定义：CAPL的函数不能嵌套定义，所有函数都是全局的

3.3 第一个CAPL脚本：Hello World

光说不练假把式。咱们直接上手写一个。在CANoe里新建一个CAPL文件，输入以下代码：

/* 第一个CAPL脚本：Hello World */
/* 功能：当CANoe启动时，在Write窗口打印一条消息 */

on start
{
  write("Hello World! CAPL脚本已启动。");
  write("当前系统时间: %d ms", timeNow());
}

写完以后，把这个CAPL文件添加到CANoe的仿真节点里。然后点击“开始仿真”，你会看到Write窗口里打印出两行信息。

咱们来拆解一下这段代码：

• on start：这是一个系统事件。当CANoe仿真开始时，这个函数会被自动调用一次。
• write()：CAPL内置的打印函数，类似C语言的printf。它会把内容输出到CANoe的Write窗口。
• timeNow()：返回当前系统时间，单位是毫秒。
• %d：格式化占位符，表示输出一个整数。

你可能会问：为什么不用 printf？因为CAPL没有标准C库，它有自己的I/O函数。 write 就是最常用的一个。

3.4 再进一步：响应一个报文事件

光打印个启动消息太简单了。咱们来点实际的——当总线上出现某个报文时，让脚本自动响应。

/* 响应报文事件示例 */
/* 当收到ID为0x123的报文时，打印其数据 */

on message 0x123
{
  int i;
  write("收到报文 ID=0x%x, 数据长度=%d", this.id, this.dlc);
  
  for(i = 0; i < this.dlc; i++)
  {
    write("  Byte %d: 0x%02x", i, this.byte(i));
  }
}

这里有几个新东西：

• on message 0x123：事件处理器，表示“当收到ID为0x123的报文时”。
• this：关键字，代表当前触发事件的报文对象。通过 this.id 获取报文ID，this.dlc 获取数据长度。
• this.byte(i)：获取报文中第i个字节的数据。

3.5 本章知识体系总览

为了让你对CAPL的整体结构有个直观印象，我画了一张图。你可以把它当作后续学习的“地图”。

3.6 本章小结

这一章我们做了三件事：

1. 理解了CAPL的本质——事件驱动，不是从头跑到尾的主程序。
2. 对比了CAPL和C语言的差异——没有指针、没有动态内存、没有标准库，但有自己的一套API。
3. 亲手写了两个脚本——一个Hello World，一个报文响应。代码虽短，但已经覆盖了CAPL最核心的两个事件：on start 和 on message。