XCP on CAN Filter Plugin

Note

For an detailed description have a look at our ADTF 3 - Calibration Toolbox Guides page.

Plugin Information

Plugin Filename	xcp_on_can_filter.adtfplugin
Plugin Description	xcp_on_can_filter.plugindescription
Plugin Name	XCP On CAN - Filter Plugin
License	ADTF
Support Mail	support@digitalwerk.net
Homepage URL	https://support.digitalwerk.net/

Plugin Versions

Plugin Version	3.11.4
Plugin File Version	1.0
adtf::calibtb	3.11.4
adtf	3.18.4
adtf::ucom	3.1.0

Component Information

Name	XCP On CAN Filter
CID	xcp_on_can.filter.calibtb.cid
Description	The XCP On CAN-Filter can be used to communicate with ECUs that support XCP via CAN.
Type	Filter

Properties

Name	Value	Type	Description	Subproperties
CAN Channel ID	1	tUInt32	The CAN channel use for sending and receiving messages.
Max DLC Required	true	tBool	With Max DLC Required, the slave can inform the master that it has to use CAN frames with data length 8 bits when sending to the slave.
Slave Mode	false	tBool	Enables slave mode, for use with the 'XCP Emulator' - Filter.
XCP Master CAN Message ID		cString	If specified, XCP frames from master to slave will be transmitted via CAN messages with the given ID. Otherwise the 'CAN_ID_MASTER' settings from the A2L file will be used. Possible Input: Hexnumbers, with prefix '0x' Decimalnumbers
XCP Slave CAN Message ID		cString	If specified, XCP frames from slave to master will be transmitted via CAN messages with the given ID. Otherwise the 'CAN_ID_SLAVE' settings from the A2L file will be used. Possible Input: Hexnumbers, with prefix '0x' Decimalnumbers

Input Pins

Name	Stream Type	Description
can_msg_in	adtf/devicetb/can	Incomming CAN frames from the connected ECU.
xcp_frames_in	adtf/calibtb/xcp_frames	Incoming XCP frames from the connected 'XCP Master'.

Output Pins

Name	Stream Type	Description
can_msg_out	adtf/devicetb/can	Outgoing CAN frames to the connected ECU.
xcp_frames_out	adtf/calibtb/xcp_frames	Outgoing XCP frames to the connected 'XCP Master'.

Runner

Name	Activation Type	Data Triggered	Data Input	Thread Triggered	Thread Cyclic	Timer Triggered	Timer Interval	Description
process_can_msg_in	9	1	can_msg_in	0	0	0	0	Default runner port for the input pin 'can_msg_in'
process_xcp_frames_in	9	1	xcp_frames_in	0	0	0	0	Default runner port for the input pin 'xcp_frames_in'

Output Binding Objects

Name	IID	Proxy OID	Description
xcp_master	xcp_master.aconcagua.calibtb.adtf.iid		Necessary connection to the 'XCP Master' - Filter

Dynamic Pins

Dynamic Input Pins	false
Dynamic Output Pins	false
Dynamic Input Binding Pins	false
Dynamic Output Binding Pins	false

Input Pin Stream Types

Pin Name	can_msg_in
Meta Type Name	adtf/devicetb/can
Stream Type Properties	Name Value Type Description Subproperties channel 1 cString database cString md_data_serialized false tBool md_definitions <?xml version="1.0" encoding="iso-8859-1" standalone="no"?><adtf:ddl xmlns:adtf="adtf"><enums><enum name="eMessageTag" type="tUInt8"><element name="MT_Data" value="0" /><element name="MT_Status" value="1" /></enum><enum name="eDataFlags" type="tUInt16"><element name="DF_ERROR_FRAME" value="1" /><element name="DF_NONE" value="0" /><element name="DF_REMOTE_FRAME" value="2" /><element name="DF_TX_COMPLETED" value="4" /><element name="DF_FLEXIBLE_DATARATE" value="8" /></enum></enums><structs><struct name="tCANData" alignment="1" version="1"><element type="eMessageTag" name="ui8Tag" bytepos="0" arraysize="1" byteorder="LE" alignment="1"/><element type="tUInt8" name="ui8Channel" bytepos="1" arraysize="1" byteorder="LE" alignment="1"/><element type="tInt64" name="tmTimeStamp" bytepos="2" arraysize="1" byteorder="LE" alignment="1"/><element type="tUInt32" name="ui32Id" bytepos="10" arraysize="1" byteorder="LE" alignment="1"/><element type="tUInt8" name="ui8Length" bytepos="14" arraysize="1" byteorder="LE" alignment="1"/><element type="tUInt8" name="ui8Reserved" bytepos="15" arraysize="1" byteorder="LE" alignment="1"/><element type="eDataFlags" name="ui16Flags" bytepos="16" arraysize="1" byteorder="LE" alignment="1"/><element type="tUInt16" name="ui16Reserved" bytepos="18" arraysize="1" byteorder="LE" alignment="1"/><element type="tUInt32" name="ui32Reserved" bytepos="20" arraysize="1" byteorder="LE" alignment="1"/><element type="tUInt8" name="aui8Data" bytepos="24" arraysize="8" byteorder="LE" alignment="1"/></struct></structs></adtf:ddl> cString md_struct tCANData cString network cString

Pin Name	xcp_frames_in
Meta Type Name	adtf/calibtb/xcp_frames
Stream Type Properties	Name Value Type Description Subproperties md_data_serialized false tBool md_definitions <struct name="tXcpFrame" alignment="1" version="1"> <element name="eDirection" type="tUInt32" arraysize="1"> <deserialized alignment="1"/> <serialized byteorder="LE" bytepos="0"/> </element> <element name="tmReceiveTime" type="tInt64" arraysize="1"> <deserialized alignment="1"/> <serialized byteorder="LE" bytepos="4"/> </element> <element name="ui16Counter" type="tUInt16" arraysize="1"> <deserialized alignment="1"/> <serialized byteorder="LE" bytepos="12"/> </element> <element name="ui16Length" type="tUInt16" arraysize="1"> <deserialized alignment="1"/> <serialized byteorder="LE" bytepos="14"/> </element> <element name="aui8Packet" type="tUInt8" arraysize="ui16Length"> <deserialized alignment="1"/> <serialized byteorder="LE" bytepos="16"/> </element></struct> cString md_struct tXcpFrame cString xcp_config cString

Output Pin Stream Types

Pin Name	can_msg_out
Meta Type Name	adtf/devicetb/can
Stream Type Properties	Name Value Type Description Subproperties channel 1 cString database cString md_data_serialized false tBool md_definitions <?xml version="1.0" encoding="iso-8859-1" standalone="no"?><adtf:ddl xmlns:adtf="adtf"><enums><enum name="eMessageTag" type="tUInt8"><element name="MT_Data" value="0" /><element name="MT_Status" value="1" /></enum><enum name="eDataFlags" type="tUInt16"><element name="DF_ERROR_FRAME" value="1" /><element name="DF_NONE" value="0" /><element name="DF_REMOTE_FRAME" value="2" /><element name="DF_TX_COMPLETED" value="4" /><element name="DF_FLEXIBLE_DATARATE" value="8" /></enum></enums><structs><struct name="tCANData" alignment="1" version="1"><element type="eMessageTag" name="ui8Tag" bytepos="0" arraysize="1" byteorder="LE" alignment="1"/><element type="tUInt8" name="ui8Channel" bytepos="1" arraysize="1" byteorder="LE" alignment="1"/><element type="tInt64" name="tmTimeStamp" bytepos="2" arraysize="1" byteorder="LE" alignment="1"/><element type="tUInt32" name="ui32Id" bytepos="10" arraysize="1" byteorder="LE" alignment="1"/><element type="tUInt8" name="ui8Length" bytepos="14" arraysize="1" byteorder="LE" alignment="1"/><element type="tUInt8" name="ui8Reserved" bytepos="15" arraysize="1" byteorder="LE" alignment="1"/><element type="eDataFlags" name="ui16Flags" bytepos="16" arraysize="1" byteorder="LE" alignment="1"/><element type="tUInt16" name="ui16Reserved" bytepos="18" arraysize="1" byteorder="LE" alignment="1"/><element type="tUInt32" name="ui32Reserved" bytepos="20" arraysize="1" byteorder="LE" alignment="1"/><element type="tUInt8" name="aui8Data" bytepos="24" arraysize="8" byteorder="LE" alignment="1"/></struct></structs></adtf:ddl> cString md_struct tCANData cString network cString

Pin Name	xcp_frames_out
Meta Type Name	adtf/calibtb/xcp_frames
Stream Type Properties	Name Value Type Description Subproperties md_data_serialized false tBool md_definitions <struct name="tXcpFrame" alignment="1" version="1"> <element name="eDirection" type="tUInt32" arraysize="1"> <deserialized alignment="1"/> <serialized byteorder="LE" bytepos="0"/> </element> <element name="tmReceiveTime" type="tInt64" arraysize="1"> <deserialized alignment="1"/> <serialized byteorder="LE" bytepos="4"/> </element> <element name="ui16Counter" type="tUInt16" arraysize="1"> <deserialized alignment="1"/> <serialized byteorder="LE" bytepos="12"/> </element> <element name="ui16Length" type="tUInt16" arraysize="1"> <deserialized alignment="1"/> <serialized byteorder="LE" bytepos="14"/> </element> <element name="aui8Packet" type="tUInt8" arraysize="ui16Length"> <deserialized alignment="1"/> <serialized byteorder="LE" bytepos="16"/> </element></struct> cString md_struct tXcpFrame cString xcp_config cString