Port SERVICEACCESS - SERVICE¶
Port zur aktiven Unterstützung von Ethernet-Services auf Grundlage eines LwIP-basierten Netzwerkstacks
Stimulation¶
Dieser Port besitzt keine Stimulus-Fähigkeiten.
Eigenschaften 🛈¶
Name |
Verfügbar wenn |
Standardwert |
Gültige Werte |
Typ |
Beschreibung |
|---|---|---|---|---|---|
TCP/IP-Stack |
LwIP + Vector XL API |
[LwIP + Vector XL API] |
string |
Diese Option dient nur zur Information und kann nicht geändert werden. |
|
Physical Layer ❲Netzwerkzugriff❳ |
|||||
Port |
string |
Name des Ports im Netzwerk. In der Vector Hardware Config muss hierzu der Network-based mode aktiviert sein. |
|||
Autom. Datenempfang bei Testausführung |
☑ |
bool |
Nur wirksam wenn links bei ‚Start‘ entweder ‚Immer‘ gewählt ist, oder ‚Wenn benötigt‘ und der Port in der Testkonfiguration verwendet wird. |
||
MAC-Adresse ❲Client❳ |
‚02:00:4C:4F:4F:50‘ |
string |
String (Format: 02:00:4C:4F:4F:50), ‚default‘ wenn eine Standard-MAC-Adresse verwendet werden soll |
||
VLAN-Einstellungen ❲IEEE 802.1Q❳ |
TCP/IP stack is LwIP |
||||
VLAN-Modus |
TCP/IP stack is LwIP |
auto |
[auto, disable, single tagging] |
string |
Mit ‚auto‘ wird die Einstellung aus der Datenbank übernommen. ‚disable‘ für deaktiviertes VLAN. Oder ‚single tagging‘, wenn eine feste VLAN-ID angegeben werden soll |
VLAN-ID |
TCP/IP stack is LwIP » VLAN-Modus: ‚single tagging‘ |
0 |
int |
Wenn eingehende Pakete ein VLAN-Tag besitzen, werden sie gefiltert und nur Pakete mit dieser VLAN-ID werden akzeptiert. Eingehende Pakete ohne VLAN-Tag werden ebenfalls akzeptiert. |
|
IP-Einstellungen |
Wenn kein Konsument im Service Mapping auswgewählt ist und das Mapping in einem Lese-Testschritt verwendet wird, werden die Einstellungen hier verwendet. |
||||
IP-Version |
IPv4 |
[IPv4, IPv6] |
string |
Auswahl der verwendeten IP Version |
|
Fallback-IP-Adresse ❲Client❳ |
TCP/IP stack is LwIP |
string |
IP-Adresse, die clientseitig verwendet werden soll. Sie muss sich im gleichen Subnetz befinden wie die IP-Adresse des Device under Test und darf nicht identisch sein mit der IP-Adresse eines anderen Teilnehmers oder der IP-Adresse, die das Betriebssystem für den ausgewählten Netzwerkadapter festgelegt hat. |
||
Subnetzmaske / Präfixlänge |
TCP/IP stack is LwIP |
‚default‘ |
string |
Für IPv4 Adressen kann eine Subnetzmaske oder eine Präfixlänge angeben werden (Format: ‚255.255.255.0‘ oder ‚24‘), ‚default‘ wenn die Standard-Subnetzmaske der Netzklasse zur angegebenen Fallback-IP-Adresse (Client) verwendet werden soll. Bei der Verwendung von IPv6 werden lediglich Präfixlängen akzeptiert. ‚default‘ wird für IPv6 nicht unterstützt. |
|
Gateway-Adresse |
TCP/IP stack is LwIP |
string |
IP-Adresse des Gateways, das das Erreichen von Hosts außerhalb des lokalen Subnetzes ermöglicht. Leer lassen falls kein Gateway benötigt wird |
||
Fallback TCP/UDP-Einstellungen |
Wenn kein Konsument im Service Mapping auswgewählt ist und das Mapping in einem Lese-Testschritt verwendet wird, werden die Einstellungen hier verwendet. |
||||
Source-Port-Range |
‚default‘ |
string |
Bereich an lokalen Ports, die beim Verbindungsaufbau verwendet werden sollen. Der Wert ‚default‘ führt dazu, dass zufällige Ports gewählt werden. Beispiel: 123,456-567,789 |
||
SOME/IP-Einstellungen |
|||||
SD-Multicast-IP |
‚auto‘ |
string |
Multicast-IP-Adresse für die Service-Discovery: ‚auto‘ wenn der Wert aus der Datenbank übernommen werden soll |
||
SD-Port |
‚auto‘ |
string |
UDP-Port für die Service-Discovery: ‚auto‘ wenn der Wert aus der Datenbank übernommen werden soll. |
||
Verhalten bei Protokollfehlern |
‚NotPresent‘ |
[‚ERROR‘, ‚NotPresent‘] |
string |
Verhalten des Testschritts wenn ein Protokollfehler auftritt (z.B. das Steuergerät antwortet nicht). Standardmäßig wird ‚NotPresent‘ zurück gegeben. Alternativ kann der Testschritt mit ‚ERROR‘ bewertet werden. |
|
Service Discovery automatisch starten |
☑ |
bool |
Die Service Discovery startet automatisch. Ansonsten muss sie durch Aufruf des Jobs StartServiceDiscovery manuell gestartet werden |
||
Platzhalterwert für automatische E2E-Berechnung |
int |
Wenn für ein E2E-Element (z.B. CRC) dieser Wert angegeben wird (im Testfall oder in der RBS), ersetzt ecu.test diesen beim Senden automatisch durch den korrekten, berechneten Wert. Diese Option dient dazu, beliebige feste Werte (ungleich dem hier eingestellten Wert) senden zu können. Diese Option leer zu lassen deaktiviert die Funktion komplett. Für mehr Informationen siehe Toolkategorien - Automatische E2E-Berechnung in der Dokumentation. |
|||
Simulierte Services |
TCP/IP stack is LwIP |
||||
MAC-Adresse ❲Server❳ |
TCP/IP stack is LwIP |
‚02:00:4C:4F:4F:40‘ |
string |
String (Format: 02:00:4C:4F:4F:40), muss von der MAC-Adresse des Clientsverschieden sein |
|
Simulierte Services aktiv lassen |
TCP/IP stack is LwIP |
☐ |
bool |
Simulierte Services bis zum Beenden der Konfiguration aktiv lassen, statt nur bis Testfallende. |
|
Simulierter Router |
TCP/IP stack is LwIP » IP-Version: ‚IPv6‘ |
☐ |
bool |
Simuliert einen IPv6-Router. Dem realen SuT wird dadurch vorgetäuscht, dass sich die simulierten Steuergeräte in einem anderen Subnetz befinden. Details zum Verhalten: Der simulierte Router beantwortet Neighbor Solicitations (NS) mit einem Neighbor Advertisement (NA). Die bei der NA verwendete Link-Layer-Adresse (MAC) hängt von der Zieladresse der NS ab. Wenn die NA als Zieladresse die ClientIP oder die RouterIP enthält, wird mit der Client MAC geantwortet. Wenn die Zieladresse eine IP aus den aktiven simulierten Services enthält, wird mit der Server MAC geantwortet. Unbekannte Zieladressen werden ignoriert. |
|
IP-Adresse ❲Router❳ |
TCP/IP stack is LwIP » IP-Version: ‚IPv6‘ » Simulierter Router: ‚True‘ |
string |
IP Adresse des simulierten Routers |
Jobs 🛈¶
GetActiveServices¶
Liefert eine Liste mit Tupeln aus (Service-Id, Instance-Id) für alle aktiven Services zurück. Es werden nur Service-IDs zurückgegeben, die im Testfall oder der Signalaufnahme verwendet werden.
Parametrierung
Rückgabewert
Name |
Verfügbar wenn |
Standardwert |
Gültige Werte |
Typ |
Beschreibung |
|---|---|---|---|---|---|
result |
string |
Liste mit Tupeln (Service-Id, Instance-Id) |
GetSubscriptionState¶
Gibt zurück, ob mindestens eine Subscription für eine Eventgroup eines Service existiert. Gilt nur für den Testschritt ‚Event senden (zyklisch)‘, nicht für die skriptbasierte Service-Simulation.
Parametrierung
Parameter
Name |
Verfügbar wenn |
Standardwert |
Gültige Werte |
Typ |
Beschreibung |
|---|---|---|---|---|---|
eventgroupId |
int |
Id der Eventgruppe |
|||
instanceId |
int |
Id der Instanz |
|||
serviceId |
int |
Id des Services |
Rückgabewert
Name |
Verfügbar wenn |
Standardwert |
Gültige Werte |
Typ |
Beschreibung |
|---|---|---|---|---|---|
result |
[False, True] |
bool |
True, wenn mindestens eine Subscription aktiv ist |
StartReceiving¶
Startet den Empfang von Netzwerkpaketen manuell
StartServiceDiscovery¶
Startet die Service Discovery, wenn sie nicht bereits läuft.
Parametrierung
Rückgabewert
Name |
Verfügbar wenn |
Standardwert |
Gültige Werte |
Typ |
Beschreibung |
|---|---|---|---|---|---|
result |
[False, True] |
bool |
True, wenn die Service Discovery gestartet wurde |
StartSomeIpManipulation¶
Startet eine SOME/IP-Manipulation (s. SOME/IP-Manipulation).
Parametrierung
Parameter
Name |
Verfügbar wenn |
Standardwert |
Gültige Werte |
Typ |
Beschreibung |
|---|---|---|---|---|---|
Manipulator |
object |
Ein ByteStream oder ein benutzerdefiniertes Manipulationsobjekt, welches dynamisch auf zu sendende SOME/IP-Pakete angewendet wird (s. SOME/IP-Manipulation). |
StartSomeIpSdManipulation¶
Startet eine SOME/IP-SD-Manipulation (s. SOME/IP-SD-Manipulation).
Parametrierung
Parameter
Name |
Verfügbar wenn |
Standardwert |
Gültige Werte |
Typ |
Beschreibung |
|---|---|---|---|---|---|
Manipulator |
object |
Ein ByteStream oder ein benutzerdefiniertes Manipulationsobjekt, welches dynamisch auf zu sendende SOME/IP-SD-Pakete angewendet wird (s. SOME/IP-SD-Manipulation). |
StopServiceDiscovery¶
Stoppt die Service Discovery, falls sie bereits läuft.
Parametrierung
Rückgabewert
Name |
Verfügbar wenn |
Standardwert |
Gültige Werte |
Typ |
Beschreibung |
|---|---|---|---|---|---|
result |
[False, True] |
bool |
True, wenn die Service Discovery gestoppt wurde |
StopSomeIpManipulation¶
Stoppt die SOME/IP-Manipulation (s. SOME/IP-Manipulation).
StopSomeIpSdManipulation¶
Stoppt die SOME/IP-SD-Manipulation (s. SOME/IP-SD-Manipulation).