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 SIL Kit	[LwIP + Vector SIL Kit]	string	Diese Option dient nur zur Information und kann nicht geändert werden.
Physical Layer ❲Netzwerkzugriff❳
Netzwerkname				string	Name des Netzwerks. Muss der gleiche Netzwerkname sein, den andere Participants verwenden, deren Pakete empfangen werden sollen, solange keine Switches usw. in der SIL-Kit-Konfiguration definiert sind.
Kontrollername				string	Ein beliebiger Name, unter dem der Ethernet-Controller im SIL-Kit registriert wird.
Autom. Datenempfang bei Testausführung		☑		bool	Nur wirksam wenn links bei ‚Starting‘ 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	Source-Port-Range für die Service-Kommunikation. 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.
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	TCP/IP stack is LwIP			string	Liste Komma getrennter Services, die zur Laufzeit simuliert werden sollen. Sind die Berechnungsklassen in einem Projekt (Unterverzeichnis) angelegt, ist der Projektname voranzustellen. Notation: [<projektName>.]<ecuName>_<serviceName>
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.

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 Eventgruppe eines Services vorliegt.

Parameter

Name	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.

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).

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).

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.

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).