参考教程：01 新建工程及通道配置_哔哩哔哩_bilibili
1、简介
（1）CAPL是CANoe自带的一种类C编程语言，封装有丰富的函数库。
（2）CAPL脚本需要和软件中的节点关联在一起，当CANoe工程启动时，CAPL中的程序才能被使能。
（3）使用CANoe的仿真功能与测量功能时可以在两个地方添加与CAPL文件关联的节点：
①可以在Simulation Setup窗口中添加一个仿真的网络节点，或者选择网络中已有的节点与CAPL脚本关联。
1\]在Simulation Setup窗口中右键，选择"Insert Network Node"添加一个网络节点。  \[2\]右键一个网络节点（下图以新增节点为例），选择"Configuration..."。  \[3\]在下图红框所示的地方配置与该节点关联的CAPL文件（文件后缀为.can），点击"File..."可以关联已有的CAPL文件，也可以新建一个CAPL文件（不选择已有的CAPL文件，直接输入不存在的文件名打开即可）。   ②在Measurement Setup窗口中有一些蓝色方块，这里将它们称作功能模块，可以在这里添加CAPL编程节点，这些节点一般用于实现过滤或者数据分析等功能。 \[1\]在Measurement Setup窗口中蓝色方块，选择"Insert Program Node"添加一个编程节点。  \[2\]在下图红框所示的地方配置与该节点关联的CAPL文件（文件后缀为.can），点击"Select..."可以关联已有的CAPL文件，也可以新建一个CAPL文件（不选择已有的CAPL文件，直接输入不存在的文件名打开即可）。   \[3\]编程节点添加完成。  （4）在使用CANoe的测试功能时也可以添加关联CAPL文件的测试节点，其关联方式与网络节点相同，这里不再赘述。  （5）CAPL文件的访问和编辑： ①直接双击CAPL节点可以打开CAPL文件。 ②CANoe中CAPL的编译环境为CAPL Browser，其界面由以下几部分组成： \[1\]菜单区（下图红框所示）：主要功能有Comment Out（注释选定的行）、Compile（程序编译）、Import Environment（环境导入）等。 \[2\]架构浏览树（下图黄框所示）：显示CAPL文件中定义的所有函数以及相关事件。 \[3\]代码编辑区（下图蓝框所示）：在这里可以进行CAPL脚本的编辑。 \[4\]输出窗口（下图绿框所示）：显示CAPL程序的编译结果。  \[5\]CAPL函数库访问区和符号访问区：CAPL函数库中有丰富的函数，可以直接进行调用；CAPL可以通过符号访问区直接访问CANoe中加载的环境，包括数据库中的报文、信号以及系统变量等。  ## 2、Event （1）CAPL的一些特点： ①CAPL是一种与C语言非常类似的面向过程语言，语法比C语言简单。 ②CAPL程序的执行由事件Event触发，在CANoe工程运行时发生某个事件（比如收到错误报文），就会调用这个事件对应的CAPL程序。  （2）CAPL中常见的事件如下图所示，从上往下依次是CANoe工程启动、CANoe工程停止、接收特定ID报文（其代码句柄后紧跟报文ID或者报文名称）、计时器事件（也可认为是周期事件，其代码句柄后紧跟计时器名称）、按下外设按键（其代码句柄后紧跟按键名称，比如键盘上的'a'），其对应的代码句柄在其右侧，花括号内的语句是事件触发后需要执行的程序段，并不固定。  （3）以外设按键a触发为例： ①双击Simulation Setup窗口中已经关联CAPL文件的网络节点，打开其CAPL文件。  ②新增蓝框所示的代码块，编辑完成后点击"Compile"（编译），输出窗口中没有报错即为编译成功。   ③启动CANoe工程，按下键盘上的按键a，Write窗口中将会输出"key a pressed"。  ## 3、Send Message （1）使用CAPL脚本发送CAN报文（可以是自定义报文，也可以是数据库中已定义的报文）的步骤： ①定义一个报文message类型的变量，这个变量实际上是一个结构体变量。 \[1\]对于自定义报文，定义的语法为"message \<报文ID\> \<报文变量名称\>;"。 \[2\]对于数据库中已定义的报文，定义的语法为"message \<报文名\> \<报文变量名称\>;"。 ②对这个变量进行赋值操作，赋值方法和在C语言中访问结构体变量成员的语法相同。message类型的结构体变量有如下所示的成员，常用的有dlc------数据段长度、byte(n)------数据段的第n个字节（对于数据库中已定义的报文，可以直接通过信号名称访问数据段相应的位置）。  ③使用发送函数output（参数为报文变量名）将该报文发送。 （2）自定义报文的发送： ①打开与仿真节点关联的CAPL文件，定义一个按键事件，这里仍旧以按下按键a为例，然后在事件的程序块中定义报文变量msg1，其ID为0x1A，数据段长度为4，然后做发送操作。  ②程序编译完成后，启动CANoe工程，然后在键盘上按下按键a，可以看到总线上有ID为0x1A的报文传输。  （3）数据库中已定义报文的发送： ①打开与仿真节点关联的CAPL文件，定义一个按键事件，这里以按下按键b为例，然后在事件的程序块中定义报文变量msg2，其对应的报文的名字为EngineState，内含信号EngineSpeed和OnOff，给信号赋值后做发送操作。  ②程序编译完成后，启动CANoe工程，然后在键盘上按下按键b，可以看到总线上有名称为EngineState的报文传输。  ## 4、Access （1）信号的发送或者信号值的改变也可以作为CAPL程序的触发事件。 ①"on signal \<信号名\>"------信号值改变事件的句柄。 ②"on signal_update \<信号名\>"------信号发送到总线上事件的句柄。  （2）getSignal函数（参数为信号名）可以返回参数中信号的值，也可以使用"$\<信号名\>"直接访问信号的值。  （3）setSignal函数（参数为信号名和数值）可以为参数中的信号赋值，也可以使用"$\<信号名\>"直接访问信号的值。  （3）系统变量被激活或者系统变量值的改变也可以作为CAPL程序的触发事件。 ①"on sysvar \<系统变量\>"------系统变量值改变事件的句柄。 ②"on sysvar_update \<系统变量\>"------系统变量被激活事件的句柄。  （4）对于简单数据类型的系统变量，可以使用"@\<系统变量名\>"直接访问系统变量的值；使用函数对系统变量的访问需要考虑其数据类型，这里以int类型的系统变量为例： ①对int类型的系统变量赋值需要使用sysSetVariableInt函数，其参数依次为系统变量和需要赋上的数值。 ②读取int类型的系统变量的值需要使用sysGetVariableInt函数，其参数依次为系统变量和存储读取数值的变量。 