两万字的CAPL语法基础,一篇文章带你入门

蚂蚁小兵 2024-07-20 16:05:02 阅读 55

🍅 我是蚂蚁小兵,专注于车载诊断领域,尤其擅长于对CANoe工具的使用

🍅 寻找组织 ,答疑解惑,摸鱼聊天,博客源码,点击加入👉【相亲相爱一家人】

🍅 玩转CANoe,博客目录大全,点击跳转👉


📘前言

🍅 本章内容,面向CAPL初学者,超过两万字,超全超详细。

🍅 本节内容大量引用,翻译下面的Vector 官方文档:capl_programming ,资料我放在下方公众号网盘了,有需自取!

在这里插入图片描述

目录

📘前言📙1 CAPL 简介📙2 CAPL 语法基础🍅2.1 CAPL和C语言的主要不同点🍅2.1 CAPL和C语言中等价的函数🍅2.2 注释🍅2.3 变量的命名规范🍅2.4 区分大小写🍅2.5 CAPL 关键字🍅2.6 CAPL 支持的数据类型🍅2.7 变量声明🍅2.8 数据类型转换🍅2.9 常量整形浮点数字符字符串宏定义

🍅 2.10 数组🍅 2.11 枚举类型🍅 2.12 结构体数据类型🍅 2.13 message🍅 2.14 定时器🍅 2.15 运算符2.15.1 算数运算2.15.2 赋值运算符2.15.3 布尔运算符2.15.4 比较运算符2.15.5 位运算符2.15.6 三目运算符2.15.7 其它运算符2.15.8 不支持运算符2.15.9 运算符优先级

🍅 2.16 控制语句2.16.1 if 语句2.16.2 if else 语句2.16.3 Switch 语句2.16.4 While 循环语句2.16.5 do...while 循环语句2.16.6 for 循环语句2.16.7 break 语句2.16.8 continue 语句2.16.9 return 语句

🍅 2.17 函数2.17.1 函数重载2.17.2 函数传参2.17.3 函数返回值

🍅 2.18 test case🍅 2.19 CAPL 文件类型2.19.1 根据文件后缀分为.can 和 .cin2.19.2 创建不同的节点类型,就会有不同类型的.can/.cin文件

🍅 2.20 CAPL 文件的编码方式🍅 2.21 CAPL 的事件结构2.21.1 sytem ,系统事件2.21.2 值(信号/变量)变化事件2.21.3 报文接收事件2.21.4 事件中的this 关键字

🍅 2.22 CAPL Browser 的设置2.22.1 配色方案:2.22.2 必须的工具栏:

🌎总结

请添加图片描述


📙1 CAPL 简介

CAPL(发音为“kapple”),是 Communication Access Programming Language 的缩写。CAPL是基于C语言开发的,专门用于CANalyzer和CANoe工具环境,但是CAPL简化了C语言,移除了复杂的指针概念,和一些不常用的关键字等,也融入了一些C++的概念,比如函数重载等。就学习难度而言 CAPL < C< C++。

CANalyzer或CANoe工具本身无需CAPL程序,就足以执行简单的测量和分析。采用CAPL程序,大大扩展了CAN通信的测量和分析。

如果没有CAPL,该工具无法执行的是涉及计时的分析。CAPL可以使分析更加高效

CAPL 脚本是基于事件驱动的,和常规语言不同,CAPL没有 main()函数,没有程序入口,任何事件都有可能触发CAPL脚本的执行,比如,按键事件,定时器事件,执行测试等;如果没有事件发生,那么CAPL程序是“闲置的”。

在这里插入图片描述

任何语言都需要编译之后才能运行,我们编写CAPL 的IDE叫做 CAPL Browser ,是CNAoe 整个开发环境的一部分组件;因为CAPL Browser的整体结构基于事件的概念,并且是专门组织的围绕不同的事件类,软件开发过程比传统的组织要简单得多C程序。关于CAPL的事件结构更详细的解读,参考后面章节博客内容。

在这里插入图片描述


📙2 CAPL 语法基础

🍅2.1 CAPL和C语言的主要不同点

下图可以看出,C语言支持很多概念,CAPL都舍弃掉了,或者只取其一小部分支持,让CAPL语言更加简便和易懂比如CAPL是基础事件驱动的,所以不需要main()函数入口持指针操作,宏定义,头文件都不在支持下图有点老,博主基于CANoe 11版本,枚举和结构体类型都是支持的。在c语言中,使用函数之前,必须要进行声明,而CAPL是不需要的。

在这里插入图片描述


Note

1,在CAPL中,默认所有的局部变量都是静态的,在C语言中,需要用关键字static 修饰的变量才是静态的。这一点新手在写脚本要特别注意 点击,了解 CAPL脚本中关于 局部变量 容易忽略的一点

2,void 在CAPL中只支持函数返回值类型,表示函数没有返回值

3,CAPL中使用了一些标准的C函数。这些函数通常是数学函数或字符串函数(例如,abs(),strncpy())已经在CAPL内部预定义了。

4,CAPL没有完整的ANSI C标准库,但它有CAPL特有的库,称为CAPL dll。dll编程需要有一定的编程经验

5,字符串数据类型在CAPL中不支持;但是,您可以使用字符数组(例如,char temp[6]= " Hello "😉。


🍅2.1 CAPL和C语言中等价的函数

对于C程序员来说,了解一些等价的函数是很有帮助的。下面是一个类似的简明列表函数,但有关CAPL函数如何使用的更多详细信息,请参阅CAPL函数参考手册。

在这里插入图片描述


🍅2.2 注释

CAPL 的注释方式和大多数语言都一样,都是通过 // 或者 /**/ 来实现的,下面四种注释方法都是合法的。CAPL Brower中注释代码的默认快捷键 选中你要注释的代码,先按住组合键 Ctrl + K ,然后在按组合键Ctrl +C ; 解除注释是 先按住组合键 Ctrl + K ,然后在按组合键Ctrl +U ;

<code>1. /* This is a comment.*/

2. /* This comment is spread

over two lines.*/

3. /*

You can do this, too.

*/

4. // CAPL also accepts the C++ comment.


🍅2.3 变量的命名规范

变量名、函数名和数组名可以由字母和数字和下划线组成,但是首字母不能是数字

下面的命名都是合法的:

sum

number_of_units

J5x7

_sysflag

下面的命名都是不合法的:

int // because it is a reserved keyword

sum$value // the $ is not a recognized character

3Times // because a variable name cannot begin with a number

number of units // because spaces are not allowed


🍅2.4 区分大小写

在使用CAPL编写时,一定要记住,对于用户定义的变量,小写字母和大写字母是不同的变量

下面三个变量是三个不同的变量

input_1

Input_1

INPUT_1

但是CAPL支持的关键字是不区分大小写的,比如 INT a; 和int a;是一样的。


🍅2.5 CAPL 关键字

关键字不能用来命名变量或函数。CAPL使用C编程中保留的关键字语言。但是,CAPL不支持一些常见的C关键字。

下面是保留关键字的列表,包括CAPL支持的和不支持的关键字本图较老,emum和struct现在是支持的。

在这里插入图片描述


🍅2.6 CAPL 支持的数据类型

下表列出了支持的部分数据类型,不全,不过足以介绍CAPL支持的基本数据类型,以及所占的字节数,还有是是有符号数等等。message 和timer等是CAPL独有的数据类型,这里不描述

在这里插入图片描述


🍅2.7 变量声明

CAPL 变量有局部变量和全局变量,在CAPL 中Variables中定义的是全局变量

在这里插入图片描述

数据类型float和double都是占8个字节,它们指定符合IEEE的64位浮点数标准,它们彼此兼容。变量的初始化在声明期间是可选的,定义的时候如果没有初始化,

整形数据则默认是0;

char 型默认是null ;

message 类型默认的数据段是0;

定时器timer ,不需要初始化下面的变量声明是合法的

<code>char letter_a = “a”;

int number_days_in_year = 365;

message wake-up xxx; // 后面再说

timer one_second; // 定时器必须全局变量 后面再说

int j, k = 2; // 如果变量不初始化,默认j = 0

double x = 33.7;

char p;


🍅2.8 数据类型转换

CAPL支持类型转换,隐形和显性都可以

-下面 第一个赋值语句使用隐形转换,即将1.6和1.7添加到结果3.3,但是sum是整形,所以自动截断,结果就是3

-下面 第二个赋值语句使用显性转换,即1+1 =2 ,最后结果就是2

int sum;

sum = 1.6 + 1.7;

sum = (int) 1.6 + (int) 1.7;


🍅2.9 常量

初始化一个变量意味着给它赋一个初始值或开始值。在CAPL中,这可以在同一行中完成变量声明。当值在声明期间赋值时,它们被视为常量

整形

整形可以是十进制和十六进制

int value = 20;

int value2 = 0x14;

浮点数

浮点数可以是十进制数,或者科学计数法,以下都是合法的

float value = 0.23;

float value2 = 23E-2;

2.1

2.1e0

3.1415

0.00034

22e+3

1E-6

字符

字符常量 是用单引号,括起来的一个字符

char value = ‘B’;

char value2 = ‘8’;

char value3 = ‘?’;

CAPL支持使用ASCII字符集。上面的三个字符赋值可以用十六进制分别

char value = 0x42;

char value2 = 0x38;

char value3 = 0x3F;

字符串

字符串常量由一系列由双引号括起来的一个或多个连续字符组成。字符串存储在char类型的数据元素数组中。最后一个元素包含空字符\0,即用于指示字符串的结束。要确保字符串数组定义时的大小总是字符串长度 + 1,因为结束符\0也占用一个字符

char value[30] = “Here’s a string in C and CAPL”;

char value2[19] = “spaces are allowed”;

char value3[31] = “with a tab escape sequence \t”;

如果已经定义过了一个字符串数组,不可以直接给它赋值的,下面代码时不允许的

char value3[31] ;

value3 = “with a tab escape sequence ”;

可行的一种方法,是通过CAPL自带的字符串操作函数实现

char value3[31] ;

strncpy(value3, “with a tab escape sequence ”, elcount(value3));

宏定义

在C语言中,下面代码是合法的,但是在CAPL中是不可以的。

#define TRUE 1

#define FALSE 0


🍅 2.10 数组

数组时同一种数据类型的集合,元素必须小于等于指定的大小

下面时26个字母,但是我们必须定义27个大小,因为数据类型时char , 结束符\0要占一个字节

char alphabet[27] = “ABCDEFGHIJKLMNOPQRSTUVWXYZ”;

我们通过下表索引可以获取数组中的数值,比如 alphabet[0] 就是 ‘A’

整形或者浮点型数组,大小可以和声明的元素数量一致,比如

int sample_data[4] = { 100, 300, 500, 600 };

如果,定义时,数组没有完全舒适化,其余的用默认值0填充

int sample_data[10] = { 100, 300, 500, 600 };

也可以定义二维数组

int M[4][5] = {

{ 10, 5, -3, 17, 82 },

{ 9, 0, 0, 8, -7 },

{ 32, 20, 1, 0, 14 },

{ 0, 0, 8, 7, 6 }

};

要确定数组中元素的数量,可以使用elCount()函数,如下面的例子所示:

nt i, j;

for ( j = 0; j < elCount(array); j++ )

for ( i = 0; i <= elCount(array[j]); i++ )

. . .


🍅 2.11 枚举类型

枚举类型在CAPL中定义的方式与在C中完全相同

enum Colors { Red, Green, Blue }; // 默认 从 0开始,每个元素+1

enum State { State_Off = -1, State_On = 1 }; //可以指定值

定义完成后,可以直接使用enum的成员变量

on key 'c'

{

enum Colors { Red, Green, Blue }; // 默认 从 0开始,每个元素+1

write("Colors red : %d",Red);

write("Colors Green : %d",Green);

}

//输出结果

Program / ModelColors red : 0

Program / ModelColors Green : 1

当对枚举类型初始化变量后,有两种方法给枚举变量赋值,如下脚本可以通过 enum.Name() 可以获取变量当前值对应的元素名字

on key 'c'

{

enum Colors { Red, Green, Blue }; // 默认 从 0开始,每个元素+1

enum Colors color; //定义枚举变量

color = Green;

# color = (enum Colors)1;//也可以通过 强制类型转换,将整形数据转为枚举类型赋值

write("colors is %s and value is : %d",color.Name(),color);

//输出结果

Program / Modelcolors is Green and value is : 1

}


🍅 2.12 结构体数据类型

结构体在CAPL中定义的方式与在C中完全相同-定义结构体变量时,完成初始化

on key 'c'

{

struct Data

{

int age;

long hight;

char name[50];

};

struct Data data = { 12,150,"张三"}; //结构体定义时,初始化

write("姓名:%s ; 年龄:%d ; 身高:%d",data.name,data.age,data.hight);

//输出结果

姓名:张三 ; 年龄:12 ; 身高:150

}

定义结构体变量时,没有初始化,后面再赋值

on key 'c'

{

struct Data

{

int age;

long hight;

char name[50];

};

struct Data data;

data.age = 15;

data.hight = 150;

strncpy(data.name,"张三",elcount(data.name));

write("姓名:%s ; 年龄:%d ; 身高:%d",data.name,data.age,data.hight);

//输出结果

姓名:张三 ; 年龄:15 ; 身高:150

}


🍅 2.13 message

message 是CAPL独有的数据类型,可以用来仿真,改写,创建报文等,是CANoe 仿真测试的比较核心内容message ,有丰富的属性和相关方法,详情需要参考help文档了,不做深入探讨一下代码将向总线上发送一帧ID = 100 的报文

on key 'c'

{

message 100 msg;

msg.DLC = 1;

msg.BYTE(0) = 0xff;

output(msg);

}


🍅 2.14 定时器

由于CAPL被设计为提供事件驱动的环境,计时器提供了一种简单的触发周期性的方法事件。CAPL允许设置无限多个用户定义的计时器。CAPL 提供两种定时器: 毫秒计时器(msTimer) 和 秒计时器(timer),必须再全局变量中定义定时器

msTimer tenth_second_clock;

Timer one_minute_clock;

使用一个定时器分一下三个步骤:

声明一个计时器变量在事件过程(preStart 除外)或用户定义的函数中预先设置计时器为该计时器定义一个on timer 事件

下面代码,是一个简单但是完整的毫秒定时器的使用方法,目的是案件‘a’触发后,开启定时器,20ms后发送 ID =100的报文

variables

{

msTimer myTimer; // creates a millisecond timer

message 100 msg; // creates message 100

}

on key ‘a’ // when the ‘a’ key is pressed

{

setTimer(myTimer,20); // set myTimer to 20 ms

}

on timer myTimer // when myTimer expires (after 20 ms)

{

output(msg); // output the message

}

周期定时器:下面代码周期为100ms的发送ID=0x555的报文

variables

{

message 0x555 msg1 = { dlc = 1};

mstimer timer1; // define timer1

}

on start

{

setTimer(timer1, 100); // initialize timer to run for 100 msec

}

on timer timer1

{

msg1.byte(0) = msg1.byte(0) + 1; // increment the data

output(msg1); // output message

setTimer(timer1, 100); // reset the timer

}

如果定时器还没被触发,你可以通过setTimer() 函数,重置该定时器如果定时器还没被触发,你也可以通过cancelTimer() 函数来取消该定时器


🍅 2.15 运算符

CAPL的运算符大多数和C都一样,也进行了一些删减CAPL的运算符包括下面几大类

算数运算

赋值运算

关系运算

布尔运算

位运算

混合运算

2.15.1 算数运算

下图是CAPL支持的算数运算符,包括加减乘除,取模等,完全和C语言一样

在这里插入图片描述

下面一些算数运算符的使用

<code>int x,y,z;

y = 8;

z = 4;

x = y + z; // Addition. Result = 12

x = y - z; // Subtraction. Result = 4

x = y * z; // Multiplication. Result = 32

x = y / z; // Division. Result = 2

x = z % y; // Modulo. Result = 4

x = y++; // Increment. Result = 9

x = z--; // Decrement. Result = 3

2.15.2 赋值运算符

下图是CAPL支持的赋值运算符,完全和C语言一样。

在这里插入图片描述

下面一些赋值运算符的简单使用

<code>int y, z;

y = 8;

z = 4;

// each statement below is independent from the others

y += z; // Addition. Result: y = 12

y -= z; // Subtraction. Result: y = 4

y *= z; // Multiplication. Result: y = 32

y /= z; // Division. Result: y = 2

y %= z; // Modulo. Result: y = 0

y <<= 1; // Left-shift. Result: y = 16

y &= z; // AND. Result: y = 0 (binary arithmetic)

y |= z; // OR. Result: y = 12 (binary arithmetic)

y ^= z; // XOR. Result: y = 12 (binary arithmetic)

2.15.3 布尔运算符

下图是CAPL支持的布尔运算符,完全和C语言一样。

在这里插入图片描述

下面一些布尔运算符的简单使用

<code>byte y, z;

y = 0x00;

z = 0x01;

if (!y) // test result is TRUE

if (!z) // test result is FALSE

if (y == 0 && z == 1) // test result is TRUE

if (y == 1 || z == 1) // test result is TRUE

2.15.4 比较运算符

下图是CAPL支持的比较运算符,完全和C语言一样。

在这里插入图片描述

下面一些比较运算符的简单使用

<code>int y,z;

y = 8;

z = 4;

if (y == z) // test result is FALSE

if (y != z) // test result is TRUE

if (y <= z) // test result is FALSE

if (y >= z) // test result is TRUE

2.15.5 位运算符

下图是CAPL支持的位运算符,完全和C语言一样。

在这里插入图片描述

下面一些位运算符的简单使用

<code>byte x, y, z;

y = 0x0AA; // y = 1010 1010

z = 0x05A; // z = 0101 1010

x = y & z; // AND result = 0000 1010

x = y | z; // OR result = 1111 1010

x = y ^ z; // XOR result = 1111 0000

x = y << 1; // shift left result = 0101 0100

x = y >> 1; // shift right result = 0101 0101

x = ~y; // 1’s complement result = 0101 0101

2.15.6 三目运算符

下图是CAPL支持的三目运算符,完全和C语言一样。返回值:先求表达式 1 的值,如果为真,则执行表达式 2,并返回表达式 2 的结果;如果表达式 1 的值为假,则执行表达式 3,并返回表达式 3 的结果

在这里插入图片描述

<code>byte x, y, z;

z = 3;

y = 5;

x = (y < z) ? z : y; // conditional result x = 5

2.15.7 其它运算符

下图是CAPL支持的运算符,[]可以用来数组索引取值, 点 表示结构体的成员,这在CAPL语言中很常见,不止用于结构体的成员变量,很多Object都有成员

在这里插入图片描述

比如message数据类型

<code> message 100 msg;

msg.DLC = 1;

msg.BYTE(0) = 0xff;

output(msg);

2.15.8 不支持运算符

下图是CAPL支持的运算符,& 在CAPL中局部支持,可以用来地址传参,比如 void function(int & dl),可以在函数内部改变传入的变量

在这里插入图片描述

2.15.9 运算符优先级

下图是我在网上找的C语言的运算符优先级,因为CAPL语言基于C,大部分都适用。没有必要去记哈,贴出来给个参考。如果代码需要复合运算的时候,都加上括号,既方便阅读代码,也不用担心优先级的问题。

在这里插入图片描述


🍅 2.16 控制语句

CAPL支持的控制语句和C语言中一样,包括 if else ,do ,while ,for 等

2.16.1 if 语句

if (expression) statement;

if 括号内的表达式为真,或者非0,则执行if 下面的语句如果没有花括号,则只执行if下面的第一行语句

<code> int speed ;

speed = 80;

if (speed > 60)

write("line 1");//这一行语句受if语句控制

write("line 2");//这一行语句不受if语句控制

如果有花括号,执行if下面花括号的所有语句

int speed ;

speed = 80;

if (speed > 60)

{

//花括号内的语句都会执行

write("line 1");

write("line 2");

}

2.16.2 if else 语句

如果下面表达式为真或者非0,则执行语句块1,否则执行语句块2

if (expression) statement_1

else statement_2

if else 的典型用法

int speed ;

speed = 40;

if (speed > 60)

{

write("line 1");

}

else if(speed > 80)

{

write("line 2");

}

else

{

write("line 3");

}

2.16.3 Switch 语句

下面是switch 语句的伪代码表示:

switch (expression)

{

case value1: statement1; statement2; … break;

case value2: statement1; statement2; … break;

. . .

default: statement1; statement2; … break;

}

switch (expression) 中的 expression应该是个 整形变量或者字符变量或者枚举类型变量case value1: 每个case分支中的value应该是个 整形或者字符常量,注意case value后面有个冒号default ,当所有分支都不能匹配的时候,会执行default内的代码当遇到 break 语句时,switch 终止,控制流将跳转到 switch 语句后的下一行。不是每一个 case 都需要包含 break。如果 case 语句不包含 break,控制流将会 继续 后续的 case,直到遇到 break 为止。

float value1, value2, result;

char operator;

...

switch ( operator )

{

case ‘+’: result = value1 + value2;

break;

case ‘-’: result = value1 – value2;

break;

case ‘*’: result = value1 * value2;

break;

case ‘/’: if ( value2 == 0) write (“Division by zero!”);

else result = value1 / value2;

break;

default: write (“Unknown operator.”);

break;

}

2.16.4 While 循环语句

Capl 语言中 while 循环的语法:

while(condition)

{

statement(s);

}

在这里,statement(s) 可以是一个单独的语句,也可以是几个语句组成的代码块。condition 可以是任意的表达式,当为任意非零值时都为 true。当条件为 true 时执行循环。 当条件为 false 时,退出循环.

int a = 10;

/* while 循环执行 */

while( a < 20 )

{

write("a 的值: %d\n", a);

a++;

}

2.16.5 do…while 循环语句

Capl 语言中 do…while 循环的语法:

do

{

statement(s);

}while( condition );

在这里,statement(s) 可以是一个单独的语句,也可以是几个语句组成的代码块。condition 可以是任意的表达式,当为任意非零值时都为 true。当条件为 true 时执行循环。 当条件为 false 时,退出循环.不像 for 和 while 循环,它们是在循环头部测试循环条件。在 C 语言中,do…while 循环是在循环的尾部检查它的条件。do…while 循环与 while 循环类似,但是 do…while 循环会确保至少执行一次循环。还要注意while 表达式最后是分号结尾的

int a = 10;

/* do 循环执行,在条件被测试之前至少执行一次 */

do

{

write("a 的值: %d\n", a);

a = a + 1;

}while( a < 20 );

2.16.6 for 循环语句

Capl 语言中 for 循环的语法:

for ( init; condition; increment )

{

statement(s);

}

下面是 for 循环的控制流:

1,init 会首先被执行,且只会执行一次。您也可以不在这里写任何语句,只要有一个分号出现即可。CAPL语句不允许在这个位置定义新的变量,而C语言是可以的

2,接下来,会判断 condition。如果为真,则执行循环主体。如果为假,则不执行循环主体,且控制流会跳转到紧接着 for 循环的下一条语句。切记不要让condition永远为真,否则会是个死循环

3,在执行完 for 循环主体后,控制流会跳回上面的 increment 语句。该语句允许您更新循环控制变量。该语句可以留空,只要在条件后有一个分号出现即可。

4,条件再次被判断。如果为真,则执行循环,这个过程会不断重复(循环主体,然后增加步值,再然后重新判断条件)。在条件变为假时,for 循环终止。

下面三个代码都是可以的

int a ;

/* for 循环执行 */

for( a = 10; a < 20; a = a + 1 )

{

write("a 的值: %d\n", a);

}

int a ;

a =10;

/* for 循环执行 */

for( ; a < 20; a = a + 1 ) //第一个表达式为空

{

write("a 的值: %d\n", a);

}

int a ;

a =10;

/* for 循环执行 */

for( ; a < 20; )//第1,3个表达式为空

{

write("a 的值: %d\n", a);

a = a + 1;

}

2.16.7 break 语句

Capl 语言中 break 语句有以下两种用法:

当 break 语句出现在一个循环内时,循环会立即终止,且程序流将继续执行紧接着循环的下一条语句。

它可用于终止 switch 语句中的一个 case。

如果您使用的是嵌套循环(即一个循环内嵌套另一个循环),break 语句会停止执行最内层的循环,然后开始执行该块之后的下一行代码。

下图是break语句在循环语句中的使用,和退出循环的过程

在这里插入图片描述

<code> int a = 10;

/* while 循环执行 */

while( a < 20 )

{

write("a 的值: %d\n", a);

a++;

if( a > 15)

{

/* 使用 break 语句终止循环 */

break;

}

}

2.16.8 continue 语句

continue 语句有点像 break 语句。但它不是强制终止,continue 会跳过当前循环中的代码,强迫开始下一次循环。

对于 for 循环,continue 语句执行后自增语句仍然会执行。对于 while 和 do…while 循环,continue 语句重新执行条件判断语句

-下图是continue 语句在循环语句中的使用

在这里插入图片描述

<code> int a = 10;

/* do 循环执行 */

do

{

if( a == 15)

{

/* 跳过迭代 */

a = a + 1;

continue;

}

write("a 的值: %d\n", a);

a++;

}while( a < 20 );

//输出结果:

a 的值: 10

a 的值: 11

a 的值: 12

a 的值: 13

a 的值: 14

a 的值: 16

a 的值: 17

a 的值: 18

a 的值: 19

2.16.9 return 语句

CAPL脚本中,不带参数的return也可以退出循环语句

on key 'c'

{

int a = 10;

/* while 循环执行 */

while( a < 20 )

{

write("a 的值: %d\n", a);

a++;

if( a > 15)

{

/* 使用 break 语句终止循环 */

return;

}

}

}

但是更多的使用return,是用来在函数中,返回一个值或者值的表达式注意:CAPL中所有的事件处理都不返回

long Power(int x, int y)

{

int i;

long result;

result = 1;

for (i = 1; i <= y; i++)

result *= x;

return result;

}


🍅 2.17 函数

1, CAPL语言,选用了C语言库的少部分函数,但是CANoe有它自己的大量的函数库,这些函数都是专用于CANalyzer或CANoe编程环境中有用的各种专用操作。

2,CAPL的函数大致分为3类:

自定义的函数;不用任何声明,在CAPL文件任意位置都可以CAPL内置的函数;不用像C语言那样的要引用 #include <stdio.h>等等各种库,已经被内置在CAPL中,随用随调DLL: 考虑到CAPL内置库不够用,CAPL对动态库有很好的支持

3 ,CAPL为其内置函数使用一致且易于阅读的命名约定:

所有标准C函数都是小写的(例如,sin(), cos(), strlen(), strncat())非标准C函数,且只有1个单词的函数都是用小写(例如,trigger(), outport(), inport())非标准C函数,但是超过1个单词的,除第一个单词,其余的首字母都大写(例如,swapInt(), timeDiff(), putValueToControl())

4, 虽然函数名是不区分大小的,但是为了保持CAPL统一的编码规则和可读性,建议你依据上面的规则

2.17.1 函数重载

这里CAPL引入了C++的函数重载的思想,只要保证参数不同,我们可以定义相同的函数名

on key 'c'

{

printme(5.7);

printme(3, "Feet");

}

void printme (double num)

{

write("Floating point %f", num);

}

void printme (int num, char units[])

{

write("%d %s", num, units);

}


2.17.2 函数传参

因为没有C语言指针的概念,相对C语言函数传参就相对简单很对,以数值类型传参为例传值:将函数外的参数再内存中拷贝一份,再函数内的更改,不会对函数外的参数有影响。

on key 'a'

{

int a = 10 ,b =20 ;

write("a=%d ; b=%d",a,b);

swip_1(a,b);

write("a=%d ; b=%d",a,b);

}

void swip_1(int a, int b)

{

int temp;

temp = a;

a = b;

b = temp;

write("inter>>>>a=%d ; b=%d",a,b);

}

输出结果:

a=10 ; b=20

inter>>>>a=20 ; b=10

a=10 ; b=20


引用传参:将变量的引用传入函数,效果和指针相同,在函数内更改,也会对函数外的参数进行更改

on key 'b'

{

int a = 10 ,b =20 ;

write("a=%d ; b=%d",a,b);

swip_2(a,b);

write("a=%d ; b=%d",a,b);

}

void swip_2(int& a, int& b)

{

int temp;

temp = a;

a = b;

b = temp;

write("inter>>>>a=%d ; b=%d",a,b);

}

输出结果:

a=10 ; b=20

inter>>>>a=20 ; b=10

a=20 ; b=10


数组/结构体传参 : 数组/结构体等连续内存的变量传参都是 地址传参,函数内部的操作都会对函数外产生影响。

void test_2(char para2[])

{

snprintf(para2,elCount(para2),"hello Vector!");

}

On key 'c'

{

char input[100] = "hello world!";

write("***********%s",input);

test_2(input);

write("***********%s",input);

}

输出结果:

***********hello world!

***********hello Vector!


2.17.3 函数返回值

原则上来说,CAPL 的函数只支持 数值类型 的返回值

有同学问,数组和结构体类型可以作为返回值吗?答案是不可以的,如果你想把函数中的数组传出去,请给它传参传入一个数组,上面也说了函数内对数组的更改是会影响要函数外的,这样就把函数 “return” 出去了

long test_1(long para1,long para2)

{

return para1 + para2 ;

}

On key 'a'

{

write("***********%d",test_1(3,5));

}


🍅 2.18 test case

testcase NewTestCase()

{

// 测试方法的代码块

}

testcase 是CAPL语法独有的一种语法模块,有点像函数,可以传递各种参数,也是需要有程序调用它才会执行

常见的调用testcase 的方法有两种 ,一种是XML TestModule ,另一种是CAPL TestModule

从零开始学习CANoe(七)—— XML 测试节点

从零开始学习CANoe(六)—— CAPL 测试节点

下面是XML TestModule 方式,由xml文件调用testcase ,xml编程进一步的学习可以参考:Capl编程xml标签语法

test.xml 部分代码,测试启动时,会依次调用CAPL中的 testcase

<?xml version="1.0" encoding="iso-8859-1" standalone="yes"?>code>

<testmodule title="CANoe" version="1.12">code>

<capltestcase name="test_1" />code>

<capltestcase name="test_1" >code>

<caplparam type="string" name="case_id">TC_10449595</caplparam>code>

<caplparam type="int" name="case_id">0x245</caplparam>code>

</capltestcase>

</testmodule>

test.can 中的 testcase,负责测试方法的具体实现。

testcase test_1()

{

write("test_1 running");

}

testcase test_2(char case_id[],int message_id)

{

write("test_2 running ,case_id : %s",case_id);

}

CAPL TestModule 类型中的 testcase 是通过 MainTest 来调用的。

在这里插入图片描述


🍅 2.19 CAPL 文件类型

2.19.1 根据文件后缀分为.can 和 .cin

类似于C语言的.c和.h文件 ,一般情况我们在.can文件写 test case,在 .cin 文件写函数和定义变量,然后在.can的includes 模块中把.cin文件引用进来。

在这里插入图片描述

特别说明:

其实 .can 和.cin文件 的内部结构基本一致,都可以定义变量,事件,函数等,功能基本一样

和C语言不同的是 在.can和.cin文件中,使用函数,不需要提前声明,任何地方都可以定义,任何地方都可以使用,注意我说的<code>任何

比如:在.cin 文件中定义的函数和变量,在.can文件中可以直接使用,这好理解,因为是.can文件 include了 .cin文件 ;但是 在.can 文件中定义的函数和变量,在cin文件中也是可以直接使用的。

2.19.2 创建不同的节点类型,就会有不同类型的.can/.cin文件

如下图,虽然都是.can文件,但是 一个节点类型是 Test node ,一个节点类型是Simulation node,节点类型不同

在这里插入图片描述

文件的类型不同,在创建节点类型的时候就决定了,虽然都是.can文件 ,但是支持的CAPL语法也会有所差别。

Test node:侧重于测试测量,CAPL内置了很多的测试函数,可以在Test node类型的.can文件中使用,但是不可以在simulation node 类型的can文件中使用,函数中包含testxxxx的都是如此 ,比如常见的testwaitfortimeout()是最常见的延时等待函数,但是它不能在 simulation node 类型的can文件中使用。

在这里插入图片描述


🍅 2.20 CAPL 文件的编码方式

.can/cin文件的编码方式,这在很多编程语言中都有,在CAPL中开头部分定义

/@!Encoding:936/ : 支持中文字符串,比如write(“调用顺序 —— 1”)

/*@!Encoding:ASCII/ :不支持中文,老外写代码用的都是这个

其它的暂时没用到,就不说了,有兴趣自己gg吧

在这里插入图片描述


🍅 2.21 CAPL 的事件结构

这里再次强调下,CAPL脚本是基于事件驱动的,也就是说CAPL脚本中每一行代码都是某个对应的事件发生了才去执行的。

testcase,是由其它功能模块调用而执行的,如上边所说xml test moduleFunctions :函数也肯定是被调用才被执行的Test Function ,这个本文我没说,也是被xml/.net 文件调用而执行的,和testcse同一类的includes : 非事件,引用.cin和dll文件的功能块Variables: 非事件,定义全局变量,注意是相对本文件的全局变量,非CANoe环境的全局变量,在CANoe中使用全局变量有系统变量和环境变量

在这里插入图片描述

2.21.1 sytem ,系统事件

on timer 和 on key 就不再赘述了,前面也已经写过了,圈起来的是几个测量事件,启动和停止CANoe 软件的时候会分别调用

CAPL 脚本中 定时器 ,按键触发事件的使用

<code>在这里插入代码片

在这里插入图片描述

执行顺序如下:on preStart过程仅用于初始化变量、在Write Window中显示消息以及从文件中读取数据on preStop函数可用于执行一些在测量停止实际生效之前必须执行的最终操作。

<code>on preStart

{

write("调用顺序 —— 1");

}

on Start

{

write("调用顺序 —— 2");

}

on preStop

{

write("调用顺序 —— 3");

}

on stopMeasurement

{

write("调用顺序 —— 4");

}

在这里插入图片描述

注意

on start 和 on stopMeasurement 事件不能在 test node 类型的.can文件中使用可以使用 on preStart ,但是不能用来对变量赋值等操作如果测量测试已经完成,那么 on preStop 中的代码也不会被执行。所以 系统的测数量事件相关代码最好集中在simulated node .can文件中完成

在这里插入图片描述

2.21.2 值(信号/变量)变化事件

比如信号值,系统变量,环境变量 ,这些元素值发生变化,会触发这些事件

CAPL 脚本中对信号,系统变量,环境变量的 事件响应

在这里插入图片描述

2.21.3 报文接收事件

总线上收到指定的报文后,会触发 on message 事件,同时message 是一个object 对象,它由很多属性,可以通过 this .xxx获取和设置

CAPL脚本 对CAN 报文的事件响应

<code>On message CAN1.0x4c

{

write("***0x%x",this.id);

}

在这里插入图片描述


2.21.4 事件中的this 关键字

1)在接收CAN对象或环境变量的事件过程中,对象的数据结构由关键字this指定。例如,您可以通过以下方式访问刚刚接收到的消息100的第一个数据字节

<code>on message 100 {

byte byte_0;

byte_0 = this.byte(0);

...

}

2):类似地,您可以通过以下方法读取刚刚更改过的整数环境变量Switch的新值

on envVar Switch {

int val;

val = getvalue(this);

...

}

3):类似地,键盘按键事件

On key 'a'

{

write("pressed %c",this);

}


🍅 2.22 CAPL Browser 的设置

2.22.1 配色方案:

在这里插入图片描述

在这里插入图片描述

2.22.2 必须的工具栏:

在使用CAPL 写脚本时,我认为这三个工具栏应该要打开的,可以便捷你的开发速度

Output :开发的时候,编译可以实时发现脚本的错误信息Symbols: 在CANoe中加载的DBC,CDD文件的元素,定义的系统变量等都可以直接这里找的到,随用随查看CALP Functions: C语言在使用库函数时,需要在文件开头include相应的库文件,但是CAPL不需要那么麻烦,它内置了很多自己专用的函数,也吸收了一些C/C++的函数,但是不需要include任何文件,可以在CAPL中直接使用。有时候记不全函数的名称,可以直接搜索查看。

在这里插入图片描述

在这里插入图片描述

🌎总结

23

7

🚩要有最朴素的生活,最遥远的梦想,即使明天天寒地冻,路遥马亡!

🚩如果这篇博客对你有帮助,请 “点赞” “评论”“收藏”一键三连 哦!码字不易,大家的支持就是我坚持下去的动力。

18



声明

本文内容仅代表作者观点,或转载于其他网站,本站不以此文作为商业用途
如有涉及侵权,请联系本站进行删除
转载本站原创文章,请注明来源及作者。