Port APPLICATION - XCP-ETH 🛈¶

Port for application access via XCP

Stimulation¶

This port has no stimulus capabilities.

Properties 🛈¶

Name	Available if	Default value	Valid values	Type	Description
Port				string	Name of the port inside a network. In Vector Hardware Config, the network-based mode must be activated.
MAC address ❲client❳		‘02:00:4C:4F:4F:50’		string	String (format: 02:00:4C:4F:4F:50), ‘default’ if the adapter MAC address should be used
IP version		IPv4	[IPv4, IPv6]	string	Selection of the IP version used
IP address ❲client❳				string	IP address to be used as a client. It must be located in the same subnet as the IP address of the device under test, and must not be equal to the IP address of another participant.
Gateway address				string	IP address, leave empty if no gateway is needed
Subnet mask / prefix length		‘default’		string	For IPv4 addresses a subnet mask or prefix length can be given (format: ‘255.255.255.0’ or ‘24’). ‘default’ uses the default subnet mask of the network class of IP address (client). For IPv6 only a prefix length is accepted and the value ‘default’ is not supported.
VLAN ID		0		int	ID with which VLAN packets should be tagged. (0 -> VLAN is not used)
Transport Layer Settings		auto	[auto, manual] Display values: auto: auto manual: manual	string	In ‘auto’ mode, the transport-layer settings (protocol, server address and port) must be specified by the A2L file and transport layer selected in the test configuration. These values will then be used automatically. Choose ‘manual’ mode if you want to specify the values yourself or if any of them cannot be determined vie the test configuration.
IP address ❲server❳	Transport Layer Settings: ‘manual’			string	Address of the XCP server
Port ❲server❳	Transport Layer Settings: ‘manual’	5555		int	Port of the XCP server
Protocol	Transport Layer Settings: ‘manual’	‘TCP’	[‘UDP’, ‘TCP’]	string	Transport protocol for data transmission
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.

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”.

Return value

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

SwitchPage¶

Switches the active page.

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.

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.

Name

Available if

Default value

Valid values

Type

Description

requestedResourcesMask

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