Port SERVICEACCESS - SERVICE¶
Port to actively support Ethernet services based on a LwIP-based network stack
Stimulation¶
This port has no stimulus capabilities.
Properties 🛈¶
Name |
Available if |
Default value |
Valid values |
Type |
Description |
|---|---|---|---|---|---|
TCP/IP stack |
LwIP + Vector XL API |
[LwIP + Vector XL API] |
string |
This option is for information purposes only and cannot be changed. |
|
Physical Layer ❲Network Access❳ |
|||||
Port |
string |
Name of the port inside a network. In Vector Hardware Config, the network-based mode must be activated. |
|||
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. |
||
MAC address ❲client❳ |
‘02:00:4C:4F:4F:50’ |
string |
String (format: 02:00:4C:4F:4F:50), ‘default’ if a default MAC address should be used |
||
VLAN Settings ❲IEEE 802.1Q❳ |
TCP/IP stack is LwIP |
||||
VLAN mode |
TCP/IP stack is LwIP |
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 |
TCP/IP stack is LwIP » 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. |
|
IP Settings |
When no Consumer is chosen in Service Mapping and the mapping is used in a read test step, the settings here are used as a fallback. |
||||
IP version |
IPv4 |
[IPv4, IPv6] |
string |
Selection of the IP version used |
|
Fallback IP address ❲client❳ |
TCP/IP stack is LwIP |
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 or the IP address which the operating system assigned to the selected network interface. |
||
Subnet mask / prefix length |
TCP/IP stack is LwIP |
‘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 Fallback IP address (client). For IPv6 only a prefix length is accepted and the value ‘default’ is not supported. |
|
Gateway address |
TCP/IP stack is LwIP |
string |
IP address of the gateway that allows reaching hosts outside of the local subnet. Leave empty if no gateway is needed |
||
Fallback TCP/UDP Settings |
When no Consumer is chosen in Service Mapping and the mapping is used in a read test step, the settings here are used as a fallback. |
||||
Source port range |
‘default’ |
string |
Range of local ports to use for establishing connections. The value ‘default’ will select random ports. Example: 123,456-567,789 |
||
SOME/IP Settings |
|||||
SD Multicast IP |
‘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 |
‘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 |
‘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’. |
|
Start Service Discovery automatically |
☑ |
bool |
Service discovery starts automatically. Otherwise it must be started manually by calling the StartServiceDiscovery job |
||
Placeholder value for automatic E2E calculation |
int |
When this value is specified for an E2E element (e.g. CRC), upon transmission (in the test case or in the RBS) ecu.test automatically replaces it with the correct calculated value. The purpose of this option is to allow transmission of arbitrary fixed values (unequal to the value chosen here). Leaving this option empty completely disables the feature. For more information see the documentation at Tool categories - Automatic E2E calculation |
|||
Simulated Services |
TCP/IP stack is LwIP |
||||
MAC address ❲server❳ |
TCP/IP stack is LwIP |
‘02:00:4C:4F:4F:40’ |
string |
String (Format: 02:00:4C:4F:4F:40), must be different from the client address |
|
Leave simulated services active |
TCP/IP stack is LwIP |
☐ |
bool |
Leave simulated services active until the configuration is stopped, rather than just until the test case ends. |
|
Simulated router |
TCP/IP stack is LwIP » IP version: ‘IPv6’ |
☐ |
bool |
Simulates an IPv6 router. This fools the real SuT into thinking that the simulated ECUs are on a different subnet. Behavior details: The simulated router responds to Neighbor Solicitations (NS) with a Neighbor Advertisement (NA). The link layer address (MAC) used in the NA depends on the destination address of the NS. If the NA contains the clientIP or the routerIP as the destination address, the client MAC is used. If the destination address contains an IP from the active simulated services, the server MAC is used in response. Unknown destination addresses are ignored. |
|
IP address ❲router❳ |
TCP/IP stack is LwIP » IP version: ‘IPv6’ » Simulated router: ‘True’ |
string |
IP address of the simulated router |
Jobs 🛈¶
GetActiveServices¶
Returns a list of tuples (service id, instance id) for all active services. Only service IDs that are used in the test case or signal recording are returned.
Parameterization
Return value
Name |
Available if |
Default value |
Valid values |
Type |
Description |
|---|---|---|---|---|---|
result |
string |
List of tuples (Service-Id, Instance-Id) |
GetSubscriptionState¶
Returns whether at least one subscription exists for an event group of a service. Only applies to the test step ‘Send Event (cyclic)’, not to the script-based simulation of services.
Parameterization
Parameter
Name |
Available if |
Default value |
Valid values |
Type |
Description |
|---|---|---|---|---|---|
eventgroupId |
int |
Id of the event group |
|||
instanceId |
int |
Id of the instance |
|||
serviceId |
int |
Id of the service |
Return value
Name |
Available if |
Default value |
Valid values |
Type |
Description |
|---|---|---|---|---|---|
result |
[False, True] |
bool |
True if at least one subscription is active |
StartReceiving¶
Manually starts the reception of network packets
StartServiceDiscovery¶
Starts Service Discovery if it is not already running.
Parameterization
Return value
Name |
Available if |
Default value |
Valid values |
Type |
Description |
|---|---|---|---|---|---|
result |
[False, True] |
bool |
True if Service Discovery was started |
StartSomeIpManipulation¶
Starts a SOME/IP manipulation (s. SOME/IP manipulation).
Parameterization
Parameter
Name |
Available if |
Default value |
Valid values |
Type |
Description |
|---|---|---|---|---|---|
Manipulator |
object |
A ByteStream or user-defined manipulation object that is dynamically applied to SOME/IP packets to be sent (s. SOME/IP manipulation). |
StartSomeIpSdManipulation¶
Starts a SOME/IP-SD manipulation (s. SOME/IP-SD manipulation).
Parameterization
Parameter
Name |
Available if |
Default value |
Valid values |
Type |
Description |
|---|---|---|---|---|---|
Manipulator |
object |
A ByteStream or user-defined manipulation object that is dynamically applied to SOME/IP SD packets to be sent (s. SOME/IP-SD-Manipulation). |
StopServiceDiscovery¶
Stops the service discovery, if it is already running.
Parameterization
Return value
Name |
Available if |
Default value |
Valid values |
Type |
Description |
|---|---|---|---|---|---|
result |
[False, True] |
bool |
True, if the service discovery has been stopped |
StopSomeIpManipulation¶
Stops the SOME/IP manipulation (s. SOME/IP manipulation).
StopSomeIpSdManipulation¶
Stops SOME/IP-SD manipulation (s. SOME/IP-SD manipulation).