Vector - CAPL - XCP介绍

前面我们介绍了关于使用vector XCP License后，通过CAPL对XCP协议进行连接、断开和获取当前XCP连接状态的函数，本篇文章不做过多的其他赘述，我们继续介绍CAPL控制XCP相关的其他函数。

xcpActivate

功能：激活用于上传或者DAQ相关测量的A2L参数。

namespace：系统变量的命名空间。

variable：对应的系统变量的名称。

sysVar：系统比那里的完全限定名称，包括所在的名称空间，以“::”分隔，并且需要在最前面带有“sysVar::”。

返回值：

0：成功激活

-1：系统变量没有找到

-2：操作不允许

注意：

A、使用系统变量的结构体时，该函数必须对整个结构体内的变量都有效，不能只对结构体内的某个变量有效。

B、xcpActivate函数不可用在on preStart中，只能在xcpConnect或者xcpDisconnenct成功之后。

代码示例

	
on start
{if(0 == XcpActivate(sysvar::XCP::XcpSim::ampl)){write("Parameter ampl activated for measurement");}
}

xcpDeactivate

功能：停用用于上传或者DAQ相关测量的A2L参数。

namespace：系统变量的命名空间。

variable：对应的系统变量的名称。

sysVar：系统比那里的完全限定名称，包括所在的名称空间，以“::”分隔，并且需要在最前面带有“sysVar::”。

返回值：

0：成功停用

-1：系统变量没有找到

-2：操作不允许

注意：使用系统变量的结构体时，该函数必须对整个结构体内的变量都有效，不能只对结构体内的某个变量有效。

xcpActivateMeasurementGroup

功能：名更改下次连接XCP设备时使用的测量组。

ecuQualifier：设备名称 – 在 CANoeXCP/CCP 窗口中配置。

groupName：测量组的名称。

返回值：

0：函数执行成功

-1：名称为ecuQualifier的设备不存在

-2：操作不允许，连接已成功建立

-5：groupName不存在

xcpDeactivateAll

功能：禁用自动读取活动测量组的所有配置参数。

ecuQualifier：设备名称 – 在 CANoeXCP/CCP 窗口中配置。

返回值：

0：函数执行成功

-1：名称为ecuQualifier的设备不存在

xcpUserCommand & OnXcpUserCommand

功能：将用户定义的数据发送到XCP slave。

ecuQualifier：设备名称 – 在 CANoeXCP/CCP 窗口中配置。

data：Tester定义的byte类型数据

datasize：data的数据长度

返回值：

0：函数执行成功

-1：名称为ecuQualifier的设备不存在

代码示例

variables
{long mMode;long mSegmentNr;byte mUsrCmdResponse = 0;
}void OnXcpConnect(char ecuName[])
{mMode = 255;mSegmentNr = 0;write("Connect callback! ECU: %s", ecuName);XcpGetCalPage(ecuName, mMode, mSegmentNr);
}void OnXcpGetCalPage(char ecu[], long reserved1, long reserved2, long pageNumber)
{Write("OnXcpGetCalPage callback! ECU: %s. Current PageNumber: %d", ecu, pageNumber);if (pageNumber == 0){pageNumber = 1;}else{pageNumber = 0;}XcpSetCalPage(ecu, mMode, mSegmentNr, pageNumber);
}void OnXcpSetCalPage(char ecu[])
{Write("OnXcpSetCalPage callback! ECU: %s", ecu);ProcessUserCmd();
}void ProcessUserCmd()
{byte adata[12] = { 0x01, 0x02, 0x03, 0x04, 0x05, 0x06, 0x07, 0x08, 0x09, 0x0A, 0x0B, 0x0C };XCPUserCommand("XcpSim", adata, 12);
}void OnXcpUserCommand(char ecu[],byte data[], long dataSize)
{mUsrCmdResponse = data[0];Write("OnXcpUserCommandResponse callback! ECU: %s. Data: %d. Data size: %d", ecu, data[0], dataSize);
}