Port BUSACCESS - CAPTURE-CAN(-FD)¶

Capture access to CAN or CAN FD

This port requires a PCAP driver to be installed.

Stimulation¶

This port supports all features described in Stimulation control.

Name	Available if	Default value	Valid values	Type	Description
Network interface card			[ONLINE]	string	Used network interface card
Logger protocol		PLP/TECMP	[PLP/TECMP, ASAM CMP]	string	Which logger protocol is used.
Probe ID / Device ID	Logger protocol: ‘PLP/TECMP’	0		int	Identifier of the probe / device
Bus Spec ID / Interface ID	Logger protocol: ‘PLP/TECMP’	0		int	Identifier of the bus specification / interface
Device-ID and Stream-ID	Logger protocol: ‘ASAM CMP’	‘(0,0)’		string	Tuple consisting of device ID and stream ID, e.g.: (0,0)
Interface-ID	Logger protocol: ‘ASAM CMP’	0		int	Identifier of the interface
Mode		Standard	[Standard, Extended, All]	string	Addressing mode (Standard = 11bit, Extended = 29bit)
Receive error frames		☐		bool	Receive error frames
Receive unacked frames		☐		bool	Enable reception of frames that have not been acknowledged by another node on the same bus.
Trace format		ASC	[ASC, MDF4, PCAPNG]	string	Default file format for bus recordings. PCAPNG for bus is not supported by trace analysis
Bus-DB				string
J1939 mode	Mode: ‘Extended’	☐		bool	Ignore the three most significant bits of the CAN-ID and J1939 source address. Extract signals from J1939-TP and ISOBus-ETP.

Erases the receiving buffer of given frame

Parameter

Name	Available if	Default value	Valid values	Type	Description
FrameId				int	Frame ID
isExtended		None	[False, True]	bool	Address format: True for 29 bit, False for 11 bit, None uses the setting “Mode” from the test bench configuration

Return value

Name	Available if	Default value	Valid values	Type	Description
result				ByteStream	ByteStream

Deregisters a frame that is streamed to the inbox

Parameter

Name	Default value	Valid values	Type	Description
FrameId			int	Frame ID
Inbox			object	Existing inbox
isExtended	None	[False, True]	bool	Address format: True for 29 bit, False for 11 bit, None uses the setting “Mode” from the test bench configuration

Returns the first value of the signal received since the test case started.

Parameter

Name	Default value	Valid values	Type	Description
FrameName			string	Frame name
NodeName			string	Name of the electronic control unit
RawValue	False	[False, True]	bool	If ‘True’, the Raw value is returned.
Reset	False	[False, True]	bool	If ‘True’ the first received value will be deleted after it has been read
SignalName			string	Signal name

Get the last reception timestamp in seconds

Registers the message ID for later use, e.g. ReadFrame

Parameter

Name	Available if	Default value	Valid values	Type	Description
FrameId				int	Frame ID
isExtended		None	[False, True]	bool	Address format: True for 29 bit, False for 11 bit, None uses the setting “Mode” from the test bench configuration

Reads the given frame ID (use InitFrame before!)

Parameter

Name	Default value	Valid values	Type	Description
doDelete	False	[False, True]	bool	Deletes the Frame after reading if “True”
FrameId			int	Frame ID
isExtended	None	[False, True]	bool	Address format: True for 29 bit, False for 11 bit, None uses the setting “Mode” from the test bench configuration

Return value

Name	Available if	Default value	Valid values	Type	Description
result				ByteStream	ByteStream

Reads the given frame ID (use InitFrame before!)

Parameter

Name	Default value	Valid values	Type	Description
doDelete	False	[False, True]	bool	Deletes the Frame after reading if “True”
FrameId			int	Frame ID
isExtended	None	[False, True]	bool	Address format: True for 29 bit, False for 11 bit, None uses the setting “Mode” from the test bench configuration

Return value

Name	Available if	Default value	Valid values	Type	Description
result				object	CanFrame

Registers a frame to be streamed to an inbox.

Parameter

Name	Default value	Valid values	Type	Description
FrameId			int	Frame ID
Inbox			object	Existing inbox
isExtended	None	[False, True]	bool	Address format: True for 29 bit, False for 11 bit, None uses the setting “Mode” from the test bench configuration
saveAsCanFrame	False	[False, True]	bool	If True, the frame is saved as a CanFrame object, else as a ByteStream

Erases the first received value of the given signal

Parameter

Name	Type	Description
FrameName	string	Frame name
NodeName	string	Name of the electronic control unit
SignalName	string	Signal name