CANoe开发入门到精通读书笔记(2)——CAPL编程_capl message变量定义-程序员宅基地

技术标签: 网络  

编程环境capl browser,文件格式.can

目录

1.报文声明

2.定时器声明

3.CAPL程序结构

3.1头文件

3.2全局变量声明

3.3事件处理

事件起始关键字on *

关键字this

系统事件

CAN控制器事件

CAN报文事件

CAN信号事件

定时事件

键盘事件

错误帧事件

环境变量事件

系统变量事件

诊断事件

3.4自定义函数

4.常用函数库简介

4.1通用函数

write函数

4.2 计算函数

4.3 字符串函数

4.4CAN总线函数

4.5LIN总线函数

4.6 诊断函数

5.CAPL使用总线数据库(访问DBC中的报文)

6.CAPL中访问信号、系统变量和环境变量

6.1CAPL中访问信号

6.2CAPL中访问系统变量

6.3CAPL中访问环境变量


1.报文声明

使用关键字message来声明一个报文变量,当使用message声明 报文变量时,默认变量为CAN报文变量。当有数据库支撑的时候,一 个 完 整 的 声 明 应 该 包 括 message ID 或 者 message name , 当有database支撑,声明报文时要通过ID或Name指定所声明的是数据库中的哪条报文
以标识符“x”结尾的ID表示这是一个扩展帧ID,例如,100x。 而 “*” 则表明这条报文在声明时还不含有CAN ID。
使用这种方式声明报文时,一定要指定ID后才能将msg发 送出去
一条CAN报文具有以下属性,用户可以使用“.”访问或修改报文属性
例如,如果需要在CAN1网络上发送一条指定的报文,报文名: magicMessage;报文ID:0x252;包含8个字节0x03 3B 40 00 00 00 00 00;可以定义如下

2.定时器声明

CAPL 提 供 了 两 种 定 时 器 变 量 : T imer 基 于 秒 的 时 间 单 位 ;msTimer基于毫秒的时间单位

3.CAPL程序结构

一个完整的CAPL程序由4部分组成:头文件include files、全局 变量声明、事件处理和自定义函数

3.1头文件

为了增强CAPL代码的复用性,单一的*.can文件已无法满足需求,因此,CAPL提供了*.cin文件(callback interfacefile),用户可以通过该文件搭建自定义的测试框架。

例如,将基本的函数接口按照不同类型 分别定义 在各自的*.cin文件中,然后再在不同的*.can文件中包含所需要的*.cin文件,从而形成二层引用结构。同时也可以在*.cin中包含其他的*.cin文件,然后在*.can文件中包含上层 *.cin文件,进而形成多层的引用结构,从而提高代码复用效率
例如,基本诊断服务定义在BaseServices.cin中,基本函数定义在 CommonFunctions.cin中,测试用例函数定义在TestFunctions.cin 中,将相关的测试用例定义在测试模块文件ECU_01.can中
//在TestFunctions.cin中:

includes
{
    #include"CommonFunctions.cin"
    #include"BaseServices.cin"
}

//在ECU_01.can中:

includes
{
    #include"TestFunctions.cin"
}
这样,在ECU_01.can中可以调用三个*.cin文件中的所有函数。如 果需要编写另一个测试模块ECU_02,只需要在ECU_02.can中包含 TestFunctions.cin即可。

3.2全局变量声明

CAPL跟C语言一样,变量的作用域和生命周期仅限于变量声明的 函数体(即大括号范围)内。CAPL在每个程序的开始部分提供了variables区域给用户声明全局变量。
在此部分声明的全局变量的生命周期从仿真开始持续到仿真结 束,其作用域为整个CAPL文件。而在*.cin文件中声明的全局变量在 包含它的*.can或*.cin中视为可见。

3.3事件处理

CAPL采用了面向事件的机制,通俗来说就是,在什么条件下,在什么时间节点,发生了什么样的报文传递,得到了什么样的报文反馈。而这种面向事件的机制是通过event handler来实现的。
事件分类包括:系统事件,CAN控制器事件,CAN报文事件等

事件起始关键字on *

on后面加某种条件,一旦条件满足则执行下面函数体内的语句。 函数体内的语句是实现接下来需要完成的操作

关键字this

在CAN报文事件中变量事件中,可以使用关键字this访问数据内容
这里的this即为message 100(ID为100的报文变量)

系统事件

系统事件主要用于处理CANoe测量系统的控制功能,主要有on start、on preStart、on stopMeasurement、on preStop、on key< newKey>以及on timer
常见系统事件CAPL代码举例如下

CAN控制器事件

CAN控制器事件是对硬件接口设备中CAN控制器状态变化事件的响应
例如,下面的代码在侦测到Bus Off状态时,系统会输出信息到 Write窗口,并复位ECU。

CAN报文事件

CAN报文事件指在CAN总线上有指定的或任意报文出现时被调用。 关键字为:on message xxx。例如,下面列出了不同的on message事件

CAN信号事件

CAN信号事件是在CAN总线上出现指定的信号时被调用(需要配合DBC文件使用)。关键字为:on signal xxxon signal_update xxx。需要注意的是,前者只在指定信号的值发生变化时被调用,后者在每次接收到指定信号时均被调用
注意,STAT1只在最近一次OnOff数值改变时被赋值,而STAT2 会记录当前总线上OnOff的值

定时事件

定时器变量可以用来创建一个定时事件,SetTimer函数用来设定时间间隔。当定时器运行到达设定的时间间隔时,将触发该事件,这时on timer函数中的程序块将被执行。需要提醒的是,周期性触发需要在每次触发结束后使用SetTimer复位(定时器采用倒计时)。若在定时器运行中需要停止计时,可以使用cancelTimer函数来取消计时。定时器事件关键字为on timer xxx。以下代码通过定时器事件实现每100ms发送一次报文0x555。

键盘事件

在测量的过程中,通常需要由用户来触发某些事件模拟实际测试环境的人工操作,例如,开始记录log、改变信号或变量的值、停止测量等。利用CAPL提供的键盘事件可以方便地完成这些操作。键盘事件的关键字为 on key xxx

错误帧事件

当总线上出现错误帧或者过载帧时,错误帧处理机制将被调用。关键字为on errorFrame
下面的代码将输出总线错误码,同时将错误帧的信息输出到Write窗口中。

环境变量事件

环境变量事件是对环境变量发生变化的响应,关键字为on enVar xxx,例如:
可以使用getValue()putValue()读写环境变量的值,例如:

系统变量事件

与环境变量事件类似,系统变量事件是对系统变量发生变化的响应,关键字为on sysVar xxxon sysVar_update xxx,例如:(IO为DI_0的命名空间,调用系统变量需要从命名空间中引用)

诊断事件

诊断事件是在诊断请求诊断响应发生时产生,常用诊断事件如表

3.4自定义函数

CAPL函数的语法跟C语言很类似,但也包含一些C语言所不具备的功能
大部分CAPL支持的数据类型都可以直接声明为函数参数, 例如,整型、浮点型、枚举、结构、定时器以及它们的引用。但有一些类型不能被直接声明,而需要加上*号(注意该符号并不是C语言中 指针的意思)。 例 如 : signal * s 、 envvarInt * ev 、 sysvarFloat * sv 、 diagRequest * dr、diagResponse * dr、int matrix[][],以及所有来自于database的变量,均需要加上*号声明
需要注意的是message类型比较特殊,如果该变量是用户自定义的,那么在函数参数声明时,message和message*均可以,但如果该变量来自database,那么只有message *可用。下面的例子是以database中的信号为例。
foo(signal * s) //没有返回类型默认返回void
{
    //将作为参数传递进来的信号的名字打印到wirte输出
    write("Signal name:%s",s.name);
}

4.常用函数库简介

4.1通用函数

通用函数主要包括与当前计算机系统文件操作测量过程控制等相关的函数

write函数

write函数对调试用 处最大,因为它可以按格式输出各种变量的信息
函数原型:
其输出格式如下:
为了便于读者理解,下面举个例子来说明如何使用write函数

4.2 计算函数

4.3 字符串函数

4.4CAN总线函数

CAN总线函数包括报文事件控制器事件统计相关等函数。
注:报文事件、CAN控制器事件此处省略,请参看3.3节。

4.5LIN总线函数

4.6 诊断函数

5.CAPL使用总线数据库(访问DBC中的报文)

CAPL能够很好地支持总线数据库,它不仅能访问数据库中的message的名称、类型、标识符等属性参数,还能识别组成message的各个组件的描述。用户可以将已创建的database文件导入工程文件中,这样CAPL就可以直接引用database中所包含的message,而不需 要逐个数据地去定义所需要的message。例如:

6.CAPL中访问信号、系统变量和环境变量

6.1CAPL中访问信号

signal在CAPL中代表的是总线信号交互层的表示,它不同于message。message是CAPL的数据类型,而signal不是。因此,不能在CAPL中定义一个类型为signal的变量
当用户需要访问信号缓冲区并期望读到最后接收到的信号值时,可以使用$符号,例如:
在一个仿真工程中,信号的定义可能会出现歧义,主要原因是含有多个总线网络,不同数据库中出现相同名称的信号名。为了区别不 同的信号,CAPL中引用信号时候需要增加其通道(Channel)、网络(Network)、 节点(Node)和报文(Message)的信息。通过作用域确定具体是哪个信号,以避免歧义。
完整的语法格式如下。
通道::网络::节点::报文::信号
用户可以使用上面的全部或部分的元素,只要能准确表示出信号的唯一性即可。例如:

6.2CAPL中访问系统变量

用户可以在CAPL中可以使用@符号直接访问系统变量而不需要通过函数调用(例如使用SysGetVariableInt 、SysGetVariableFloat等获取变量值,使用SysSetVariableInt 、SysSetVariableFloat等函数修改变量值),以下是需要采取的语法格式:
需要注意的是,对于array或struct类的变量,直接访问方式只能访问其中单个元素,例如:
比 较 通 用 的 访 问 操 作 方 式 是 使 用 以 sysGetVariable 开 头 和 sysSetVariable开头的访问函数。例如:

6.3CAPL中访问环境变量

与系统变量类似,用户可以不使用函数调用通过同样的格式访问环境变量。使用@符号例如:
比 较 通 用 的 访 问 操 作 方 式 是 使 用 函 数 getValue() putValue(),例如:

版权声明:本文为博主原创文章,遵循 CC 4.0 BY-SA 版权协议,转载请附上原文出处链接和本声明。
本文链接:https://blog.csdn.net/weixin_66275497/article/details/136121048

智能推荐

攻防世界_难度8_happy_puzzle_攻防世界困难模式攻略图文-程序员宅基地

文章浏览阅读645次。这个肯定是末尾的IDAT了,因为IDAT必须要满了才会开始一下个IDAT,这个明显就是末尾的IDAT了。,对应下面的create_head()代码。,对应下面的create_tail()代码。不要考虑爆破,我已经试了一下,太多情况了。题目来源:UNCTF。_攻防世界困难模式攻略图文

达梦数据库的导出(备份)、导入_达梦数据库导入导出-程序员宅基地

文章浏览阅读2.9k次,点赞3次,收藏10次。偶尔会用到,记录、分享。1. 数据库导出1.1 切换到dmdba用户su - dmdba1.2 进入达梦数据库安装路径的bin目录,执行导库操作  导出语句:./dexp cwy_init/[email protected]:5236 file=cwy_init.dmp log=cwy_init_exp.log 注释:   cwy_init/init_123..._达梦数据库导入导出

js引入kindeditor富文本编辑器的使用_kindeditor.js-程序员宅基地

文章浏览阅读1.9k次。1. 在官网上下载KindEditor文件,可以删掉不需要要到的jsp,asp,asp.net和php文件夹。接着把文件夹放到项目文件目录下。2. 修改html文件,在页面引入js文件:<script type="text/javascript" src="./kindeditor/kindeditor-all.js"></script><script type="text/javascript" src="./kindeditor/lang/zh-CN.js"_kindeditor.js

STM32学习过程记录11——基于STM32G431CBU6硬件SPI+DMA的高效WS2812B控制方法-程序员宅基地

文章浏览阅读2.3k次,点赞6次,收藏14次。SPI的详情简介不必赘述。假设我们通过SPI发送0xAA,我们的数据线就会变为10101010,通过修改不同的内容,即可修改SPI中0和1的持续时间。比如0xF0即为前半周期为高电平,后半周期为低电平的状态。在SPI的通信模式中,CPHA配置会影响该实验,下图展示了不同采样位置的SPI时序图[1]。CPOL = 0,CPHA = 1:CLK空闲状态 = 低电平,数据在下降沿采样,并在上升沿移出CPOL = 0,CPHA = 0:CLK空闲状态 = 低电平,数据在上升沿采样,并在下降沿移出。_stm32g431cbu6

计算机网络-数据链路层_接收方收到链路层数据后,使用crc检验后,余数为0,说明链路层的传输时可靠传输-程序员宅基地

文章浏览阅读1.2k次,点赞2次,收藏8次。数据链路层习题自测问题1.数据链路(即逻辑链路)与链路(即物理链路)有何区别?“电路接通了”与”数据链路接通了”的区别何在?2.数据链路层中的链路控制包括哪些功能?试讨论数据链路层做成可靠的链路层有哪些优点和缺点。3.网络适配器的作用是什么?网络适配器工作在哪一层?4.数据链路层的三个基本问题(帧定界、透明传输和差错检测)为什么都必须加以解决?5.如果在数据链路层不进行帧定界,会发生什么问题?6.PPP协议的主要特点是什么?为什么PPP不使用帧的编号?PPP适用于什么情况?为什么PPP协议不_接收方收到链路层数据后,使用crc检验后,余数为0,说明链路层的传输时可靠传输

软件测试工程师移民加拿大_无证移民,未受过软件工程师的教育(第1部分)-程序员宅基地

文章浏览阅读587次。软件测试工程师移民加拿大 无证移民,未受过软件工程师的教育(第1部分) (Undocumented Immigrant With No Education to Software Engineer(Part 1))Before I start, I want you to please bear with me on the way I write, I have very little gen...

随便推点

Thinkpad X250 secure boot failed 启动失败问题解决_安装完系统提示secureboot failure-程序员宅基地

文章浏览阅读304次。Thinkpad X250笔记本电脑,装的是FreeBSD,进入BIOS修改虚拟化配置(其后可能是误设置了安全开机),保存退出后系统无法启动,显示:secure boot failed ,把自己惊出一身冷汗,因为这台笔记本刚好还没开始做备份.....根据错误提示,到bios里面去找相关配置,在Security里面找到了Secure Boot选项,发现果然被设置为Enabled,将其修改为Disabled ,再开机,终于正常启动了。_安装完系统提示secureboot failure

C++如何做字符串分割(5种方法)_c++ 字符串分割-程序员宅基地

文章浏览阅读10w+次,点赞93次,收藏352次。1、用strtok函数进行字符串分割原型: char *strtok(char *str, const char *delim);功能:分解字符串为一组字符串。参数说明:str为要分解的字符串,delim为分隔符字符串。返回值:从str开头开始的一个个被分割的串。当没有被分割的串时则返回NULL。其它:strtok函数线程不安全,可以使用strtok_r替代。示例://借助strtok实现split#include <string.h>#include <stdio.h&_c++ 字符串分割

2013第四届蓝桥杯 C/C++本科A组 真题答案解析_2013年第四届c a组蓝桥杯省赛真题解答-程序员宅基地

文章浏览阅读2.3k次。1 .高斯日记 大数学家高斯有个好习惯:无论如何都要记日记。他的日记有个与众不同的地方,他从不注明年月日,而是用一个整数代替,比如:4210后来人们知道,那个整数就是日期,它表示那一天是高斯出生后的第几天。这或许也是个好习惯,它时时刻刻提醒着主人:日子又过去一天,还有多少时光可以用于浪费呢?高斯出生于:1777年4月30日。在高斯发现的一个重要定理的日记_2013年第四届c a组蓝桥杯省赛真题解答

基于供需算法优化的核极限学习机(KELM)分类算法-程序员宅基地

文章浏览阅读851次,点赞17次,收藏22次。摘要:本文利用供需算法对核极限学习机(KELM)进行优化,并用于分类。

metasploitable2渗透测试_metasploitable2怎么进入-程序员宅基地

文章浏览阅读1.1k次。一、系统弱密码登录1、在kali上执行命令行telnet 192.168.26.1292、Login和password都输入msfadmin3、登录成功,进入系统4、测试如下:二、MySQL弱密码登录:1、在kali上执行mysql –h 192.168.26.129 –u root2、登录成功,进入MySQL系统3、测试效果:三、PostgreSQL弱密码登录1、在Kali上执行psql -h 192.168.26.129 –U post..._metasploitable2怎么进入

Python学习之路:从入门到精通的指南_python人工智能开发从入门到精通pdf-程序员宅基地

文章浏览阅读257次。本文将为初学者提供Python学习的详细指南,从Python的历史、基础语法和数据类型到面向对象编程、模块和库的使用。通过本文,您将能够掌握Python编程的核心概念,为今后的编程学习和实践打下坚实基础。_python人工智能开发从入门到精通pdf