Port BUSACCESS - LIN¶

TOSUN-HW access to LIN

Stimulation¶

This port has no stimulus capabilities.

Properties 🛈¶

Name	Default value	Valid values	Type	Description
Channel number	‘1’		string	Selection of channel number if there is more than one controller of same type.
Baud rate	19200		float	Baudrate. Numbers lesser than 100 are interpreted as kbit/s, numbers larger than 100 as bit/s
Do not stop RBS	☐		bool	Restbus simulation stays active beyond test case execution.
LIN version	‘1.3’	[‘1.3’, ‘2.0’]	string	LIN protocol version to be used. Only affects calculation and validation of the frame checksum. 1.3 = received frames must have a classic checksum. 2.0 = received frames may have enhanced or classic checksum. If the database does not define a checksum mode for a specific frame to be sent, this option will be taken into account to use either classic (1.3) or enhanced (2.0) checksum mode.
LIN master	☐		bool	Selection whether the port acts as a master (True) or a slave (False).
Bus-DB			string

Jobs 🛈¶

ClearFrame¶

Erases the receiving buffer of given frame

Parameter

Name	Available if	Default value	Valid values	Type	Description
FrameId				int	Frame ID

Return value

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

DeregisterFrameForInbox¶

Ungeristers a frame that is being streamed to an inbox

Parameter

Name	Available if	Default value	Valid values	Type	Description
FrameId				int	Frame ID
Inbox				object	Existing inbox

EnableFrame¶

Makes this slave respond (or not respond) to the specified ID. You can use this instead of “Change PDU timing”. The frame must have been initialized via “InitFrame”.

Parameter

Name	Available if	Default value	Valid values	Type	Description
enable			[False, True]	bool	Enable or disable
frameId				int	Frame ID

GetFirstValue¶

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

InitFrame¶

Registers the frame for use with other jobs

Parameter

Name	Available if	Default value	Valid values	Type	Description
FrameId				int	Frame ID

ReadFrame¶

Reads the given frame ID (use InitLinFrame before!)

Parameter

Name	Available if	Default value	Valid values	Type	Description
doDelete		False	[False, True]	bool	Deletes the Frame after reading if “True”
FrameId				int	Frame ID

Return value

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

ReadFrameEx¶

Reads the given frame ID (use InitLinFrame before!)

Parameter

Name	Available if	Default value	Valid values	Type	Description
doDelete		False	[False, True]	bool	Deletes the Frame after reading if “True”
FrameId				int	Frame ID

Return value

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

RegisterFrameForInbox¶

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
saveAsLinFrame	False	[False, True]	bool	If True, the frame is saved as a LinFrame object, else as a ByteStream

ResetFirstValue¶

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

SendFrame¶

All in one: Set data, temporarily enable a frame, and send a master request. Frame ID must be registered in advance via the job “InitFrame”.

Parameter

Name	Default value	Valid values	Type	Description
checkSumMode	‘Default’	[‘Default’]	string	Mode of the checksum calculation. With default the LIN version from the TBC is used for the determination.
DataByteStream			ByteStream	data to be send
FrameId			int	Frame ID

SendMasterRequest¶

Transmits the message header with the given frame id as master.

Parameter

Name	Available if	Default value	Valid values	Type	Description
frameId				int	Frame ID

SetFrame¶

Sets the data to be sent for the entire message at once (instead of for each individual signal). Additionally, the message has to be activated via “Change PDU timing” or the job “EnableFrame”.

Parameter

Name	Default value	Valid values	Type	Description
checkSumMode	‘Default’	[‘Default’]	string	Mode of the checksum calculation. With default the LIN version from the TBC is used for the determination.
data			ByteStream	Data as ByteStream
frameId			int	Frame ID