【CAPL实战】LIN帧干扰的脚本实现

1、帧头干扰响应linDisturbRespWithHeader

1.1 函数功能

使用一个新的header帧头来干扰指定的response响应。

1.2 参数说明

linDisturbRespWithHeader(long disturbedFrameId, dword byteIndex, dword bitIndex, long disturbingFrameId);
// disturbedFrameId：需要干扰的ID，范围0~63
// byteIndex：需要干扰的字节索引（第一个字节为0）；如果索引等于帧长度，将会干扰校验和字节；大于帧长度的索引，干扰无效。范围0~N，N帧长度。
// bitIndex：响应中断开始的bit位，索引0-7表示数据位，索引8代表停止位。较大的索引值指定索引数据字节后的字节空间，这时需要确保字节空间足够大。
// disturbingFrameId：仿真用于中断指定字节的帧头标识符

返回值：如果执行成功，返回不等于0；否则为0。

1.3 代码实例

使用ID=2的帧头来干扰报文ID=2数据段的byte3的bit2位，干扰方法如下：

int result;
on key "a"
{
	result = linDisturbRespWithHeader(2, 3, 2, 2);
	if(result != 0)
	{
		TestStepPass("PASS","干扰成功");
	}else
	{
		TestStepFail("FAIL","干扰失败");	
	}
}

1.4 执行结果

• 从上面的实例我们可以看到，函数触发后只会干扰1次；
• 对于第4个参数disturbingFrameId：仿真用于中断指定字节的帧头标识符，仿真的ID可以与被干扰的ID一致；当然也可以仿真0~63的任意ID。
• 脚本开发上要注意对于返回值的判断，来知道脚本中的函数是否触发成功。

2、帧头干扰帧头linDisturbHeaderWithHeader

2.1 函数功能

使用一个新的header帧头来干扰下一个的header帧头。

2.2 参数说明

linDisturbHeaderWithHeader(dword byteIndex, dword bitIndex, long disturbingFrameId);
// byteIndex：需要干扰的字节索引，0：同步段，1：受保护ID段。
// bitIndex：帧头中断开始的bit位，索引0-7表示数据位，索引8代表停止位。较大的索引值指定索引数据字节后的字节空间，这时需要确保字节空间足够大。取值范围：0~255。
// disturbingFrameId：仿真用于干扰帧头的帧头标识符ID

返回值：如果执行成功，返回不等于0；否则为0。

2.3 代码实例

使用ID=2的帧头来干扰报文ID=2帧头的同步段的bit4位，干扰方法如下：

int result;
on key "b"
{
	result = linDisturbHeaderWithHeader(0, 4, 2);
	if(result !=0)
	{
		TestStepPass("PASS","干扰成功");
	}else
	{
		TestStepFail("FAIL","干扰失败");
	}
}