Port SERVICEACCESS - SERVICE-PASSIVE¶

Port for passive support of Ethernet services

Stimulation¶

This port has no stimulus capabilities.

Properties 🛈¶

Name	Available if	Default value	Valid values	Type	Description
Physical Layer ❲Network Access❳
Network name				string	Name of the network. Must be the same like the network name used by other participants whose packets should be received if no Switches etc. are defined in the SIL Kit configuration.
Controller name				string	An arbitrary name to be used when registering the ethernet controller to SIL Kit.
Automatic data reception on test run		☑		bool	Only operative if on the left for ‘Start’ either ‘Always’ is chosen, or ‘If necessary’ and the port is in use in the test configuration.
VLAN Settings ❲IEEE 802.1Q❳	IPC is disabled
VLAN mode	IPC is disabled	auto	[auto, disable, single tagging]	string	Set to ‘auto’ if the VLAN id from the database should be used, ‘disable’ if no VLAN should be used or ‘single tagging’ if a fixed VLAN id should be specified
VLAN id	IPC is disabled » VLAN mode: ‘single tagging’	0		int	If incoming packets have a VLAN tag, they will be filtered and only packets having this VLAN id will pass. Incoming packets without any VLAN tag will also pass the filter.
SOME/IP Settings	IPC is disabled
SD Multicast IP	IPC is disabled	‘auto’		string	Multicast IP address to be used for Service Discovery. Set it to ‘auto’ if the value from the database should be used
SD Port	IPC is disabled	‘auto’		string	UDP port to be used for Service Discovery. Set it to ‘auto’ if the value from the database should be used.
Behavior in case of protocol errors	IPC is disabled	‘NotPresent’	[‘ERROR’, ‘NotPresent’]	string	Behavior of the test step when a protocol error occurs (e.g. the control unit does not respond). By default ‘NotPresent’ is returned. Alternatively, the test step can be evaluated with ‘ERROR’.

Jobs 🛈¶

LearnBPFilter¶

Learns the endpoints (source IP address and port) of all needed services. Endpoints that are encountered within the specified timeout, but are not needed, will be transformed into a negative Berkeley Packet Filter which drops corresponding network packets. This filter will be used for reception in the test case as well as for pcap(ng) recording via this port. The negative filter may be extended by a user-defined part using BPF syntax. If the recording is already running, the learned filter has no influence on it.

Note: The job is no longer supported as it is no longer needed.

Parameter

Name	Default value	Valid values	Type	Description
clearCache	False	[False, True]	bool	Resets the cache of a previous call. The endpoints which exist in the network will therefore be learned anew. But the call will take longer in this case.
timeout	5		float	Time in seconds (float) until learning will be stopped
userBpf			string	Optional extension of the negative filter. Please provide positive in BPF syntax what should also be discarded by the filter, e.g. ‘vlan 42’

Return value

Name	Available if	Default value	Valid values	Type	Description
result				object	Dictionary containing neededEndpoints, otherEndpoints (for the negative filter), bpf (the resulting filter Expression), bpfLearn (filter expression temporarily used while learning)

StartReceiving¶

Manually starts the reception of network packets