Port APPLICATION - XCP-CAN-FD 🛈

TOSUN-HW Calibration and Measurement

Stimulation

This port has no stimulus capabilities.

Properties 🛈

Name	Available if	Default value	Valid values	Type	Description
Channel number		‘1’		string	Selection of channel number if there is more than one controller of same type.
System clock frequency		‘40 MHz’		string	Frequency of the system clock
Activate terminating resistor		☐		bool	Activate internal 120 Ohm terminating resistor
TSEG1 ❲Arbitration phase❳				int	TSEG1 (needed for determining the sample point)
TSEG2 ❲Arbitration phase❳				int	TSEG2 (needed for determining the sample point)
SJW ❲Arbitration phase❳				int	Synchronization jump width
Bit rate ❲Arbitration phase❳				int	In bit/s. Find this value in the CAN-FD A2L file under the name BAUDRATE in the block XCP_ON_CAN.
TSEG1 ❲Data transmission phase❳				int	TSEG1 (needed for determining the sample point)
TSEG2 ❲Data transmission phase❳				int	TSEG2 (needed for determining the sample point)
SJW ❲Data transmission phase❳				int	Synchronization jump width
Bit rate ❲Data transmission phase❳				int	In bit/s. Find this value in the CAN-FD A2L file under the name CAN_FD_DATA_TRANSFER_BAUDRATE.
Mode		Standard	[Standard, Extended]	string	Addressing mode (Standard = 11bit, Extended = 29bit)
Receive error frames		☐		bool	Receive error frames
Transmission confirmation		☐		bool	Activates acknowledged sending. Bus-Write test steps and Send tool jobs block until the message was successfully transferred on the bus or the confirm timeout expired.
Timeout for transmission confirmation		1000		int	Period in miliseconds in which a message has to be sent successfully. Otherwise an error is created. (must not be larger than 64535ms). Is only used in active confirm mode.
CAN-ID Settings		auto	[auto, manual] Display values: auto: auto manual: manual	string	In ‘auto’ mode, the CAN-IDs (Master->Slave and Slave->Master) must be specified in the A2L file selected in the TCF. These values will then be used automatically. Choose ‘manual’ mode if you want to specify these values yourself, or if any of them are not provided in your A2L file.
Fill requests to max DLC		☐		bool	If this option is selected the data field of the message is filled to maximum length.
FillByte	Fill requests to max DLC: ‘True’			string	Byte used to fill data field to maximum length. Enter a byte as integer from 0x00 to 0xFF.
Connection setup		‘OnPortStart’	[‘OnPortStart’, ‘OnPortConfigure’, ‘Job’] Display values: ‘OnPortStart’: ‘At start of test execution’ ‘OnPortConfigure’: ‘At start of configuration’ ‘Job’: ‘manually via job’	string	Time at which the connection to the XCP slave shall be established OnPortConfigure: Online information is available as soon as configurations are started. OnPortStart and Job: Only information from the A2L files is available.
Default acquisition rate		‘Tool-Default’		string	Declaration of measurement acquisition rate used as alternative in case no acquisition rate is set in the test step (”*” and “?” can be used as wildcard). “Tool-Default” activates the use of the default acquisition rate of the tool
Skip value validity check		☐		bool	Activate this option in order to suppress the value limit check normally applied on conversion between physical and raw value.
Use seed and key		☐		bool	Define resources to get access permissions for and the file name of the 32-bit dll placed in the tool host path.
Seed and Key Library Path	Use seed and key: ‘True’	SeedNKeyXcp.dll		uri	Path to the library on the tool host containingthe Seed and Key functions.
Requested Resources	Use seed and key: ‘True’	29		int	Resources to unlock as bit mask CAL/PAG : 1 CAL/PAG DAQ : 5 CAL/PAG STIM : 9 CAL/PAG PGM : 17 CAL/PAG DAQ STIM : 13 CAL/PAG DAQ PGM : 21 CAL/PAG STIM PGM : 25 CAL/PAG DAQ STIM PGM: 29 DAQ : 4 DAQ STIM : 12 DAQ PGM : 20 DAQ STIM PGM : 28 STIM : 8 STIM PGM : 24 PGM : 16
Recording mode		‘immediate’	[‘immediate’, ‘two-stage’] Display values: ‘immediate’: ‘immediate’ ‘two-stage’: ‘two-stage’	string	immediate recording writes a signal-based MDF4 file right away during test execution. This mode uses XCP slave timestamps if available. two-stage recording first records raw bus/ethernet traffic and then post-processes it into a signal-based MDF4 file after the test execution is finished. This mode can cope better with a very large number of signals. It uses frame ingress timestamps even if XCP slave timestamps are available.
CAN-ID ❲Master->Slave❳	CAN-ID Settings: ‘manual’			string	CAN-ID for the direction from ecu.test to the ECU
CAN-ID ❲Slave->Master❳	CAN-ID Settings: ‘manual’			string	CAN-ID for the direction from the ECU to ecu.test

Jobs 🛈

Connect

Establishes the connection to the XCP slave.

Disconnect

Disconnects from the XCP slave.

GetStatus

Returns the resource protection status of the XCP slave. Locked resources can be unlocked using the job “UnlockResource”.

Parameterization

Return value

Name	Available if	Default value	Valid values	Type	Description
statusDict				object	Dictionary containing the protection status.

SwitchPage

Switches the active page.

Parameterization

Parameter

Name	Available if	Default value	Valid values	Type	Description
page			[ONLINE]	string	Page to switch to

UnlockResource

Unlocks a resource using the Seed and Key mechanism.

Parameterization

Parameter

Name	Available if	Default value	Valid values	Type	Description
requestedResourcesMask		29		int	Resources to unlock as bit mask CAL/PAG : 1 CAL/PAG DAQ : 5 CAL/PAG STIM : 9 CAL/PAG PGM : 17 CAL/PAG DAQ STIM : 13 CAL/PAG DAQ PGM : 21 CAL/PAG STIM PGM : 25 CAL/PAG DAQ STIM PGM: 29 DAQ : 4 DAQ STIM : 12 DAQ PGM : 20 DAQ STIM PGM : 28 STIM : 8 STIM PGM : 24 PGM : 16
seedNKeyLib		SeedNKeyXcp.dll		uri	Path to the library on the tool host containing the Seed and Key functions.

Return value

Name	Available if	Default value	Valid values	Type	Description
unlockedResourcesMask				int	Bit mask of unlocked resources

2025-12-05