XCP Master Filter

Table of Contents

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

Plugin Information

Plugin Filename	xcp_master.adtfplugin
Plugin Description	xcp_master.plugindescription
Plugin Name	XCP Master 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 Master Filter
CID	xcp_master.filter.calibtb.cid
Description	Use this filter to read from and write to XCP frames.
Type	Filter

Properties

Name	Value	Type	Description	Subproperties
A2L or Xml Filename		cFilename	The A2L file that describes the ECU. You can also specify the converted file with the XML representation.	Value Range: minimum = maximum = Filename Extension Filter:
Connect During Startup	2	tUInt8	Handling the state, when the XCP Master tries to establish a connection to the ECU: 'Disabled': Useful if you are going to force connection establishment via the interface binding later on 'When XCP Master filter is started': The XCP master will try to connect to the ECU during filter startup 'After the session has been started': The connection will established after the complete FilterGraph has started.This is required, if you're using Streaming Sources, which are initialized after the XCP Master Filter(e.g. at communication over CAN-FD, the 'Vector CAN FD Device Receiver') 'Asynchronous Start': The XCP Master filter will start asynchronous and will not block the runlevel change.('Retries for Sending' property must be '0')	Value List: Disabled = 0 When XCP Master filter is started = 1 After the session has been started = 2 Asynchronous Start = 3Value Range: minimum = maximum = Filename Extension Filter:
DAQ Complementary Connection Slave Id	-1	tInt32	If != -1, enables DAQ transport via the complementary connection with the given slave id.	Value Range: minimum = maximum = Filename Extension Filter:
Decode Frames	true	tBool	If enabled, signals will be extracted and decoded. Disable this when recording raw XPC frames to improve performance.	Value Range: minimum = maximum = Filename Extension Filter:
Default Aquisition DAQ Event Id	-1	tInt32	If a request for signal transmission does not specify a DAQ event id or polling interval and there is not default event id specified within the A2L, then this event wil be used. -1 --> none.	Value Range: minimum = maximum = Filename Extension Filter:
Default Aquisition DAQ Prescaler	1	tInt16	If a request for signal transmission does not specify a DAQ prescaler value and there is not default prescaler specified within the A2L, then this value will be used.	Value Range: minimum = maximum = Filename Extension Filter:
Default Aquisition Polling Interval	0	tInt64	If a request does not specify a DAQ event id or polling interval and there is not default event id specified within the A2L, then this polling interval will be used. 0 --> none.	Value Range: minimum = maximum = Filename Extension Filter:
Dump Buffer Layout	false	tBool	If enabled the DAQ Layout will be printed to the log.	Value Range: minimum = maximum = Filename Extension Filter:
Dump DAQ Frames	false	tBool	If enabled incoming XCP DAQ Frames will be dumped to the log. Property 'Dump Frames' must also be enabled.	Value Range: minimum = maximum = Filename Extension Filter:
Dump DAQ Layout	false	tBool	If enabled DAQs will be dumped to the log.	Value Range: minimum = maximum = Filename Extension Filter:
Dump Frames	false	tBool	If enabled incoming and outgoing XCP Frames will be dumped to the log.	Value Range: minimum = maximum = Filename Extension Filter:
ECU Clock Is Synchronized.	false	tBool	If enabled and if the ADTF Stream Clock is a system clock, then the hardware timestamps will be used verbatim. Requires 'Use Synchronized Hardware Timestamps' = true.	Value Range: minimum = maximum = Filename Extension Filter:
Ignore Connection Error	false	tBool	If enabled, then the master will not abort startup if it cannot connect right away. This is useful if you are going to force connection establishment via the interface binding later on.	Value Range: minimum = maximum = Filename Extension Filter:
Ignore DAQ Limits from A2L	false	tBool	When activated no DAQ Limit check will be performed.	Value Range: minimum = maximum = Filename Extension Filter:
Ignore EPK Mismatch	false	tBool	When activated any possible EPK mismatch will be ignored.	Value Range: minimum = maximum = Filename Extension Filter:
Ignore Read Only flag	false	tBool	If enabled the master will allow writing signals/parameters that are marked as read-only.	Value Range: minimum = maximum = Filename Extension Filter:
Parameter Filename		cFilename	If not empty, the values of the parameters of the given file will be DOWNLOADed to the ECU after a connection has been established.	Value Range: minimum = maximum = Filename Extension Filter:
Playback Mode	false	tBool	If enabled, the filter will not try to comminicate with an actual ECU.	Value Range: minimum = maximum = Filename Extension Filter:
Reset FlexXCPBuffers	true	tBool	If enabled the Flexray Buffers will be reset upon connection	Value Range: minimum = maximum = Filename Extension Filter:
Retries for Sending	2	tInt16	Defines the count of retries for sending XCP frames to the ECU. If the property set to '-1', the XCP Master Filter tries to send the XCP frame until the ECU is responding or the session has been shut down.	Value Range: minimum = maximum = Filename Extension Filter:
Separate DAQ Counter	true	tBool	If enabled, a separate frame counter will be used to detect missing DAQ frames.	Value Range: minimum = maximum = Filename Extension Filter:
Store Additional Sample Info	true	tBool	If activated stores the hardware timestamp and DAQ List ID in the sample info.	Value Range: minimum = maximum = Filename Extension Filter:
Timeout [µs]	2000000	tInt32	The timeout after which the master will assume the ECU did not respond correctly.	Value Range: minimum = maximum = Filename Extension Filter:
Timestamp Tick Multiplier	true	tBool	If enabled, hw timestamps will be multipled by tick count, otherwise the will be dived by them.	Value Range: minimum = maximum = Filename Extension Filter:
Transport Layer	2	tUInt32	Choose the used transport layer settings.	Value List: CAN = 1 TCP = 2 UDP = 3 Flexray = 4Value Range: minimum = maximum = Filename Extension Filter:
Use Synchronized Hardware Timestamps	true	tBool	If enabled, the HW timestamps contained within XCP Frames will be used to improve the ADTF timestamps of the signal values. If disabled, only the recieve timestamps of the frames will be used.	Value Range: minimum = maximum = Filename Extension Filter:
XCP Commands/Calibration Commands/DOWNLOAD	true	tBool	Activates / Deactivates XCP command: DOWNLOAD	Value Range: minimum = maximum = Filename Extension Filter:
XCP Commands/Calibration Commands/DOWNLOAD_MAX	true	tBool	Activates / Deactivates XCP command: DOWNLOAD_MAX	Value Range: minimum = maximum = Filename Extension Filter:
XCP Commands/Calibration Commands/DOWNLOAD_NEXT	true	tBool	Activates / Deactivates XCP command: DOWNLOAD_NEXT	Value Range: minimum = maximum = Filename Extension Filter:
XCP Commands/Calibration Commands/MODIFY_BITS	true	tBool	Activates / Deactivates XCP command: MODIFY_BITS	Value Range: minimum = maximum = Filename Extension Filter:
XCP Commands/Calibration Commands/SHORT_DOWNLOAD	true	tBool	Activates / Deactivates XCP command: SHORT_DOWNLOAD	Value Range: minimum = maximum = Filename Extension Filter:
XCP Commands/DAQ and STIM Commands/ALLOC_DAQ	true	tBool	Activates / Deactivates XCP command: ALLOC_DAQ	Value Range: minimum = maximum = Filename Extension Filter:
XCP Commands/DAQ and STIM Commands/ALLOC_ODT	true	tBool	Activates / Deactivates XCP command: ALLOC_ODT	Value Range: minimum = maximum = Filename Extension Filter:
XCP Commands/DAQ and STIM Commands/ALLOC_ODT_ENTRY	true	tBool	Activates / Deactivates XCP command: ALLOC_ODT_ENTRY	Value Range: minimum = maximum = Filename Extension Filter:
XCP Commands/DAQ and STIM Commands/CLEAR_DAQ_LIST	true	tBool	Activates / Deactivates XCP command: CLEAR_DAQ_LIST	Value Range: minimum = maximum = Filename Extension Filter:
XCP Commands/DAQ and STIM Commands/FREE_DAQ	true	tBool	Activates / Deactivates XCP command: FREE_DAQ	Value Range: minimum = maximum = Filename Extension Filter:
XCP Commands/DAQ and STIM Commands/GET_DAQ_CLOCK	true	tBool	Activates / Deactivates XCP command: GET_DAQ_CLOCK	Value Range: minimum = maximum = Filename Extension Filter:
XCP Commands/DAQ and STIM Commands/GET_DAQ_EVENT_INFO	true	tBool	Activates / Deactivates XCP command: GET_DAQ_EVENT_INFO	Value Range: minimum = maximum = Filename Extension Filter:
XCP Commands/DAQ and STIM Commands/GET_DAQ_LIST_INFO	true	tBool	Activates / Deactivates XCP command: GET_DAQ_LIST_INFO	Value Range: minimum = maximum = Filename Extension Filter:
XCP Commands/DAQ and STIM Commands/GET_DAQ_LIST_MODE	true	tBool	Activates / Deactivates XCP command: GET_DAQ_LIST_MODE	Value Range: minimum = maximum = Filename Extension Filter:
XCP Commands/DAQ and STIM Commands/GET_DAQ_PROCESSOR_INFO	true	tBool	Activates / Deactivates XCP command: GET_DAQ_PROCESSOR_INFO	Value Range: minimum = maximum = Filename Extension Filter:
XCP Commands/DAQ and STIM Commands/GET_DAQ_RESOLUTION_INFO	true	tBool	Activates / Deactivates XCP command: GET_DAQ_RESOLUTION_INFO	Value Range: minimum = maximum = Filename Extension Filter:
XCP Commands/DAQ and STIM Commands/READ_DAQ	true	tBool	Activates / Deactivates XCP command: READ_DAQ	Value Range: minimum = maximum = Filename Extension Filter:
XCP Commands/DAQ and STIM Commands/SET_DAQ_LIST_MODE	true	tBool	Activates / Deactivates XCP command: SET_DAQ_LIST_MODE	Value Range: minimum = maximum = Filename Extension Filter:
XCP Commands/DAQ and STIM Commands/SET_DAQ_PTR	true	tBool	Activates / Deactivates XCP command: SET_DAQ_PTR	Value Range: minimum = maximum = Filename Extension Filter:
XCP Commands/DAQ and STIM Commands/START_STOP_DAQ_LIST	true	tBool	Activates / Deactivates XCP command: START_STOP_DAQ_LIST	Value Range: minimum = maximum = Filename Extension Filter:
XCP Commands/DAQ and STIM Commands/START_STOP_SYNCH	true	tBool	Activates / Deactivates XCP command: START_STOP_SYNCH	Value Range: minimum = maximum = Filename Extension Filter:
XCP Commands/DAQ and STIM Commands/WRITE_DAQ	true	tBool	Activates / Deactivates XCP command: WRITE_DAQ	Value Range: minimum = maximum = Filename Extension Filter:
XCP Commands/PAG Commands/COPY_CAL_PAGE	true	tBool	Activates / Deactivates XCP command: COPY_CAL_PAGE	Value Range: minimum = maximum = Filename Extension Filter:
XCP Commands/PAG Commands/GET_CAL_PAGE	true	tBool	Activates / Deactivates XCP command: GET_CAL_PAGE	Value Range: minimum = maximum = Filename Extension Filter:
XCP Commands/PAG Commands/GET_PAGE_INFO	true	tBool	Activates / Deactivates XCP command: GET_PAGE_INFO	Value Range: minimum = maximum = Filename Extension Filter:
XCP Commands/PAG Commands/GET_PAG_PROCESSOR_INFO	true	tBool	Activates / Deactivates XCP command: GET_PAG_PROCESSOR_INFO	Value Range: minimum = maximum = Filename Extension Filter:
XCP Commands/PAG Commands/GET_SEGMENT_INFO	true	tBool	Activates / Deactivates XCP command: GET_SEGMENT_INFO	Value Range: minimum = maximum = Filename Extension Filter:
XCP Commands/PAG Commands/GET_SEGMENT_MODE	true	tBool	Activates / Deactivates XCP command: GET_SEGMENT_MODE	Value Range: minimum = maximum = Filename Extension Filter:
XCP Commands/PAG Commands/SET_CAL_PAGE	true	tBool	Activates / Deactivates XCP command: SET_CAL_PAGE	Value Range: minimum = maximum = Filename Extension Filter:
XCP Commands/PAG Commands/SET_SEGMENT_MODE	true	tBool	Activates / Deactivates XCP command: SET_SEGMENT_MODE	Value Range: minimum = maximum = Filename Extension Filter:
XCP Commands/PGM Commands/GET_PGM_PROCESSOR_INFO	true	tBool	Activates / Deactivates XCP command: GET_PGM_PROCESSOR_INFO	Value Range: minimum = maximum = Filename Extension Filter:
XCP Commands/PGM Commands/GET_SECTOR_INFO	true	tBool	Activates / Deactivates XCP command: GET_SECTOR_INFO	Value Range: minimum = maximum = Filename Extension Filter:
XCP Commands/PGM Commands/PROGRAM	true	tBool	Activates / Deactivates XCP command: PROGRAM	Value Range: minimum = maximum = Filename Extension Filter:
XCP Commands/PGM Commands/PROGRAM_CLEAR	true	tBool	Activates / Deactivates XCP command: PROGRAM_CLEAR	Value Range: minimum = maximum = Filename Extension Filter:
XCP Commands/PGM Commands/PROGRAM_FORMAT	true	tBool	Activates / Deactivates XCP command: PROGRAM_FORMAT	Value Range: minimum = maximum = Filename Extension Filter:
XCP Commands/PGM Commands/PROGRAM_MAX	true	tBool	Activates / Deactivates XCP command: PROGRAM_MAX	Value Range: minimum = maximum = Filename Extension Filter:
XCP Commands/PGM Commands/PROGRAM_NEXT	true	tBool	Activates / Deactivates XCP command: PROGRAM_NEXT	Value Range: minimum = maximum = Filename Extension Filter:
XCP Commands/PGM Commands/PROGRAM_PREPARE	true	tBool	Activates / Deactivates XCP command: PROGRAM_PREPARE	Value Range: minimum = maximum = Filename Extension Filter:
XCP Commands/PGM Commands/PROGRAM_RESET	true	tBool	Activates / Deactivates XCP command: PROGRAM_RESET	Value Range: minimum = maximum = Filename Extension Filter:
XCP Commands/PGM Commands/PROGRAM_START	true	tBool	Activates / Deactivates XCP command: PROGRAM_START	Value Range: minimum = maximum = Filename Extension Filter:
XCP Commands/PGM Commands/PROGRAM_VERIFY	true	tBool	Activates / Deactivates XCP command: PROGRAM_VERIFY	Value Range: minimum = maximum = Filename Extension Filter:
XCP Commands/Standard Commands/BUILD_CHECKSUM	true	tBool	Activates / Deactivates XCP command: BUILD_CHECKSUM	Value Range: minimum = maximum = Filename Extension Filter:
XCP Commands/Standard Commands/CONNECT	true	tBool	Activates / Deactivates XCP command: CONNECT	Value Range: minimum = maximum = Filename Extension Filter:
XCP Commands/Standard Commands/DISCONNECT	true	tBool	Activates / Deactivates XCP command: DISCONNECT	Value Range: minimum = maximum = Filename Extension Filter:
XCP Commands/Standard Commands/GET_COMM_MODE_INFO	true	tBool	Activates / Deactivates XCP command: GET_COMM_MODE_INFO	Value Range: minimum = maximum = Filename Extension Filter:
XCP Commands/Standard Commands/GET_ID	true	tBool	Activates / Deactivates XCP command: GET_ID	Value Range: minimum = maximum = Filename Extension Filter:
XCP Commands/Standard Commands/GET_SEED	true	tBool	Activates / Deactivates XCP command: GET_SEED	Value Range: minimum = maximum = Filename Extension Filter:
XCP Commands/Standard Commands/GET_STATUS	true	tBool	Activates / Deactivates XCP command: GET_STATUS	Value Range: minimum = maximum = Filename Extension Filter:
XCP Commands/Standard Commands/SET_MTA	true	tBool	Activates / Deactivates XCP command: SET_MTA	Value Range: minimum = maximum = Filename Extension Filter:
XCP Commands/Standard Commands/SET_REQUEST	true	tBool	Activates / Deactivates XCP command: SET_REQUEST	Value Range: minimum = maximum = Filename Extension Filter:
XCP Commands/Standard Commands/SHORT_UPLOAD	true	tBool	Activates / Deactivates XCP command: SHORT_UPLOAD	Value Range: minimum = maximum = Filename Extension Filter:
XCP Commands/Standard Commands/SYNC	true	tBool	Activates / Deactivates XCP command: SYNC	Value Range: minimum = maximum = Filename Extension Filter:
XCP Commands/Standard Commands/TRANSPORT_LAYER_CMD	true	tBool	Activates / Deactivates XCP command: TRANSPORT_LAYER_CMD	Value Range: minimum = maximum = Filename Extension Filter:
XCP Commands/Standard Commands/UNLOCK	true	tBool	Activates / Deactivates XCP command: UNLOCK	Value Range: minimum = maximum = Filename Extension Filter:
XCP Commands/Standard Commands/UPLOAD	true	tBool	Activates / Deactivates XCP command: UPLOAD	Value Range: minimum = maximum = Filename Extension Filter:
XCP Commands/Standard Commands/USER_CMD	true	tBool	Activates / Deactivates XCP command: USER_CMD	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
slave_xcp_frames	adtf/calibtb/xcp_frames	Incoming XCP frames from an ECU
signal_writes	adtf/substreams	Incoming signal values that are written to the ECU (Substreams)

Output Pins

Name	Stream Type	Description
master_xcp_frames	adtf/calibtb/xcp_frames	Outgoing XCP frames to an ECU
record_xcp_frames	adtf/calibtb/xcp_frames	Can be used for recording all of the XCP communication between the master filter and the ECU
signal_updates	adtf/substreams	Signal values that have been read from the ECU (Substreams)

Runner Pins

Name	Activation Type	Data Triggered	Data Input	Thread Triggered	Thread Cyclic	Timer Triggered	Timer Interval	Description
process_xcp_frames	9	1	slave_xcp_frames	0	0	0	0	Runner that process xcp frames from the ECU.
process_signal_writes	9	1	signal_writes	0	0	0	0	Default runner port for the input pin 'signal_writes'

Input Binding Objects

Name	IID	Proxy OID	Description
xcp_master	xcp_master.aconcagua.calibtb.adtf.iid		Binding Proxy connection necessary for 'XCP En - / Decode' - Filter

Dynamic Pins

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

Required Interfaces

IID
xcp_service.aconcagua.calibtb.adtf.iid
kernel.penguin.services.adtf.iid

Input Pin Stream Types

Pin Name	slave_xcp_frames
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:

Pin Name	signal_writes
Meta Type Name	adtf/substreams
Stream Type Properties	Name Value Type Description Subproperties substreams true tBool Value Range: minimum = maximum = Filename Extension Filter:

Output Pin Stream Types

Pin Name	master_xcp_frames
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:

Pin Name	record_xcp_frames
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:

Pin Name	signal_updates
Meta Type Name	adtf/substreams
Stream Type Properties	Name Value Type Description Subproperties substreams true tBool Value Range: minimum = maximum = Filename Extension Filter: