XCP On CAN Filter

Table of Contents

• Plugin Information
• Plugin Versions
• Component Information
• Properties
• Input Pins
• Output Pins
• Runner Pins
• Output Binding Objects
• Dynamic Pins
• Input Pin Stream Types
• Output Pin Stream Types

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 Subscription
Support Mail	support@digitalwerk.net
Homepage URL	https://adtf.dev/

Plugin Versions

Plugin Version	3.99.99
Plugin File Version	1.0
adtf::calibtb	3.99.99
adtf	3.21.0
adtf::ucom	3.1.0

Component Information

Name	XCP On CAN Filter
CID	xcp_on_can.filter.calibtb.cid
Description	Use this filter 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.	Value Range: minimum = maximum = Filename Extension Filter:
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.	Value Range: minimum = maximum = Filename Extension Filter:
Slave Mode	false	tBool	Enables slave mode, for use with the 'XCP Emulator' - Filter.	Value Range: minimum = maximum = Filename Extension 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	Value Range: minimum = maximum = Filename Extension Filter:
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	Value Range: minimum = maximum = Filename Extension Filter:
log_channels/default/fatal_action	2	tUInt32	The default action when a fatal error is reported.	Value List: Stop session = 2 Shutdown ADTF = 3 Abort to crash handler = 4Value Range: minimum = maximum = Filename Extension Filter:
log_channels/default/log_level	35	tUInt32	The log level for this channel.	Value List: None = 0 Error = 10 Warning = 20 Info = 30 Detail = 35 Dump = 40 All = 255Value Range: minimum = maximum = Filename Extension Filter:
log_channels/default/recoverable_action	0	tUInt8	The action to perform when a recoverable error is reported.	Value List: Log only = 0 Treat as fatal = 1Value Range: minimum = maximum = Filename Extension Filter:

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 Pins

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 Value Range: minimum = maximum = Filename Extension Filter: database cString Value Range: minimum = maximum = Filename Extension Filter: md_data_serialized false tBool Value Range: minimum = maximum = Filename Extension Filter: 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 Value Range: minimum = maximum = Filename Extension Filter: md_struct tCANData cString Value Range: minimum = maximum = Filename Extension Filter: network cString Value Range: minimum = maximum = Filename Extension Filter:

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 Value Range: minimum = maximum = Filename Extension Filter: 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 Value Range: minimum = maximum = Filename Extension Filter: md_struct tXcpFrame cString Value Range: minimum = maximum = Filename Extension Filter: xcp_config cString Value Range: minimum = maximum = Filename Extension Filter:

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 Value Range: minimum = maximum = Filename Extension Filter: database cString Value Range: minimum = maximum = Filename Extension Filter: md_data_serialized false tBool Value Range: minimum = maximum = Filename Extension Filter: 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 Value Range: minimum = maximum = Filename Extension Filter: md_struct tCANData cString Value Range: minimum = maximum = Filename Extension Filter: network cString Value Range: minimum = maximum = Filename Extension Filter:

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 Value Range: minimum = maximum = Filename Extension Filter: 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 Value Range: minimum = maximum = Filename Extension Filter: md_struct tXcpFrame cString Value Range: minimum = maximum = Filename Extension Filter: xcp_config cString Value Range: minimum = maximum = Filename Extension Filter: