Port BUSACCESS - SOCKETADAPTOR 🛈¶

Aktive und passive Kommunikation mit per SocketAdaptor übertragenen AUTOSAR-PDUs.

Stimulation¶

Dieser Port besitzt keine Stimulus-Fähigkeiten.

Eigenschaften 🛈¶

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
Aktiver Modus		☐		bool	Ob der Port auch Netzwerkpakete versenden darf. Wenn nicht gesetzt, kann der Port nur passiv Pakete empfangen.
Physical Layer ❲Netzwerkzugriff❳
Port				string	Name des Ports im Netzwerk. In der Vector Hardware Config muss hierzu der Network-based mode aktiviert sein.
MAC-Adresse ❲Client❳	Active mode is enabled	‚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❳
VLAN-Modus		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	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	Active mode is enabled
IP-Version	Active mode is enabled	IPv4	[IPv4, IPv6]	string	Auswahl der verwendeten IP Version
IP-Adresse ❲Client❳	Active mode is enabled			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	Active mode is enabled	‚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 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	Active mode is enabled			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
UDP-Einstellungen	Active mode is enabled
Portnummer ❲Client❳	Active mode is enabled			int	Lokaler UDP-Port zum Senden und Empfangen
Socket-Adaptor-Einstellungen	Active mode is enabled
Remote-IP-Adresse	Active mode is enabled			string	IP-Adresse, an welche die Socket-Adaptor-Botschaften gesendet werden sollen - z.B. eine Multicast-Adresse
Remote-Portnummer	Active mode is enabled			int	UDP-Port an den Socket-Adaptor-Botschaften gesendet werden sollen
Platzhalterwert für automatische E2E-Berechnung	Active mode is enabled			int	Wenn für ein E2E-Signal (z.B. CRC) dieser Wert angegeben wird, 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.

Jobs 🛈¶

ClearFrame¶

Löscht den Empfangspuffer des angegebenen Frames

Hinweis: ClearFrame kann mit dem Job ClearPdu ersetzt werden

Parameter

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
FrameId				int	Frame ID
isExtended		None	[False, True]	bool	Adressformat: True für 29 Bit, False für 11 Bit, None übernimmt die Einstellung „Modus“ aus der Testbenchkonfiguration

Rückgabewert

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
result				ByteStream	ByteStream

ClearPdu¶

Löscht den Eingangspuffer der angegebenen Socket-Adaptor-PDU

Parameter

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
HeaderId				int	Header-ID der Socket-Adaptor-PDU

Rückgabewert

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
result				ByteStream	Gelesene Socket-Adaptor–PDU als ByteStream.

DeregisterFrameForInbox¶

Deregistriert ein Frame, das in die Inbox gestream wird

Hinweis: DeregisterFrameForInbox kann mit dem Job DeregisterPduForInbox ersetzt werden

Parameter

Name	Standardwert	Gültige Werte	Typ	Beschreibung
FrameId			int	Frame ID
Inbox			object	Bestehende Inbox
isExtended	None	[False, True]	bool	Adressformat: True für 29 Bit, False für 11 Bit, None übernimmt die Einstellung „Modus“ aus der Testbenchkonfiguration

DeregisterPduForInbox¶

Deregistriert eine Socket-Adaptor-PDU, die in die Inbox gestreamt wird

Parameter

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
HeaderId				int	Header-ID der Socket-Adaptor-PDU
Inbox				object	Bestehende Inbox

DisableSendPduCyclic¶

Zyklisches Senden einer Socket-Adaptor-PDU mit angegebener Header-ID deaktivieren

Parameter

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
HeaderId				int	Header-ID der Socket-Adaptor-PDU

GetFirstValue¶

Gibt den ersten Wert des Signals zurück, der seit Testfallbeginn empfangen wurde.

Parameter

Name	Standardwert	Gültige Werte	Typ	Beschreibung
FrameName			string	Frame-Name
NodeName			string	Name des Steuergeräts
RawValue	False	[False, True]	bool	Wenn ‚True‘ wird der Raw-Wert zurückgegeben.
Reset	False	[False, True]	bool	Wenn ‚True‘‘ wird der erste empfangene Wert nach dem Lesen gelöscht
SignalName			string	Signalname

GetLastReceptionTimestamp¶

Liefert den Zeitstempel des letzten Empfangs in Sekunden

InitFrame¶

Registriert die Botschafts-ID für spätere Verwendung z.B. durch ReadFrame

Hinweis: InitFrame kann mit dem Job InitPdu ersetzt werden

Parameter

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
FrameId				int	Frame ID
isExtended		None	[False, True]	bool	Adressformat: True für 29 Bit, False für 11 Bit, None übernimmt die Einstellung „Modus“ aus der Testbenchkonfiguration

InitPdu¶

Registriert die Header-ID für spätere Verwendung z.B. durch ReadPdu

Parameter

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
HeaderId				int	Header-ID der Socket-Adaptor-PDU

ReadFrame¶

Liest die Botschaft mit der ID (vorher InitCanFrame notwendig!)

Hinweis: ReadFrame kann mit dem Job ReadPdu ersetzt werden

Parameter

Name	Standardwert	Gültige Werte	Typ	Beschreibung
doDelete	False	[False, True]	bool	Löscht Frame nach dem Lesen wenn „True“
FrameId			int	Frame ID
isExtended	None	[False, True]	bool	Adressformat: True für 29 Bit, False für 11 Bit, None übernimmt die Einstellung „Modus“ aus der Testbenchkonfiguration

Rückgabewert

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
result				ByteStream	ByteStream

ReadFrameEx¶

Liest die Botschaft mit der ID (vorher InitCanFrame notwendig!)

Hinweis: ReadFrameEx kann mit dem Job ReadPdu ersetzt werden (die Rückgabe eines Frames wird für SocketAdaptor nicht mehr unterstützt)

Parameter

Name	Standardwert	Gültige Werte	Typ	Beschreibung
doDelete	False	[False, True]	bool	Löscht Frame nach dem Lesen wenn „True“
FrameId			int	Frame ID
isExtended	None	[False, True]	bool	Adressformat: True für 29 Bit, False für 11 Bit, None übernimmt die Einstellung „Modus“ aus der Testbenchkonfiguration

Rückgabewert

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
result				object	CanFrame

ReadPdu¶

Liest eine Socket-Adaptor-PDU

Parameter

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
DoDelete			[False, True]	bool	Flag zum Löschen der letzten Nachricht: True: löschen, False: Nicht löschen (default)
HeaderId				int	Header-ID der Socket-Adaptor-PDU

Rückgabewert

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
result				ByteStream	Gelesene Socket-Adaptor–PDU als ByteStream.

RegisterFrameForInbox¶

Registriert ein Frame um in eine Inbox gestreamt zu werden.

Hinweis: RegisterFrameForInbox kann mit dem Job RegisterPduForInbox ersetzt werden

Parameter

Name	Standardwert	Gültige Werte	Typ	Beschreibung
FrameId			int	Frame ID
Inbox			object	Bestehende Inbox
isExtended	None	[False, True]	bool	Adressformat: True für 29 Bit, False für 11 Bit, None übernimmt die Einstellung „Modus“ aus der Testbenchkonfiguration
saveAsCanFrame	False	[False, True]	bool	Wenn True wird das Frame als CanFrame-Objekt gespeichert, sonst als ByteStream

RegisterPduForInbox¶

Registriert eine Socket-Adaptor-PDU um in eine Inbox gestreamt zu werden.

Parameter

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
HeaderId				int	Header-ID der Socket-Adaptor-PDU
Inbox				object	Bestehende Inbox

ResetFirstValue¶

Löscht den ersten empfangenen Wert des angegebenen Signals

Parameter

Name	Typ	Beschreibung
FrameName	string	Frame-Name
NodeName	string	Name des Steuergeräts
SignalName	string	Signalname

SendPdu¶

Sendet eine Socket-Adaptor-PDU an die angegebene Adresse

Parameter

Name	Typ	Beschreibung
DestinationIp	string	Ziel-IP-Adresse
DestinationPort	int	Zielport
HeaderId	int	Header-ID der Socket-Adaptor-PDU, fallssie mit Header gesendet werden soll
Payload	ByteStream	Zu sendende Payload als ByteStream.

SendPduCyclic¶

Zyklisches Senden einer Socket-Adaptor-PDU mit angegebener Header-ID und Daten

Parameter

Name	Typ	Beschreibung
Count	int	Anzahl der Sendewiederholungen
HeaderId	int	Header-ID der Socket-Adaptor-PDU
Interval	int	Zykluszeit in ms
Payload	ByteStream	Zu sendende Payload als ByteStream.