Port SERVICEACCESS - TCP-CLIENT-PCAP-SOCKET¶

TCP-Client Netzwerkstack auf PCAP-Basis

Dieser Port erfordert, dass ein PCAP-Treiber installiert ist.

Stimulation¶

Dieser Port besitzt keine Stimulus-Fähigkeiten.

Eigenschaften 🛈¶

Name	Standardwert	Gültige Werte	Typ	Beschreibung
Netzwerkadapter		[ONLINE]	string	Verwendeter Netzwerkadapter
Empfangspuffergröße	1000		int	Anzahl der Botschaften die der Empfangspuffers (Ringbuffer) aufnehmen kann
Zyklisches Senden aktiv lassen	☐		bool	Wenn der Haken gesetzt ist, wird das zyklsiche Senden von Paketen erst beim Portstop oder durch den expliziten Aufruf von ‚StopSendPacketCyclic‘ beendet. Andernfalls (default) wird das zyklische Senden bereits beim Testfallende beendet.
TLS		[ONLINE]	string	[Optional] Name des TLS-Ports, wenn die Verbindung mit TLS geschützt werden soll. Der TLS-Port muss dazu auf diesem Tool erstellt werden.

Jobs 🛈¶

ClearReceiveBuffer¶

Leert den ecu.test-Empfangspuffer auf oberer Ebene. Tiefer gelegene Puffer im Treiber werden nicht geleert.

CloseConnection¶

Beendet geöffnete TCP-Verbindung

Connect¶

Öffnet eine TCP-Verbindung

Parameter

Name	Standardwert	Gültige Werte	Typ	Beschreibung
DevGw			string	String (Format: 192.168.0.1 / fd48:a7e0:36c1:42b6::1), Leer wenn das Gateway nicht benötigt wird
DevIp			string	Eigene IP-Adresse als String (Format: 192.168.0.1 / fd48:a7e0:36c1:42b6::1). 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 in der TBC ausgewählten Netzwerkadapter festgelegt hat.
DevSubnetMask	‚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 (DevIp) verwendet werden soll. Bei der Verwendung von IPv6 werden lediglich Präfixlängen akzeptiert. ‚default‘ wird für IPv6 nicht unterstützt.
EthSrcMac	‚Default‘		string	String (Format: 00:11:FF:1E:32:FF), Default wenn die Adapter-MAC-Adresse verwendet werden soll
SoKeepAlive	None		int	Keep Alive: None= Alle Keep Alive Parameter ignorieren, 0= KeepAlive inaktiv, 1= KeepAlive aktiv
TargetHost	‚192.168.0.1‘		string	Hostname oder IP-Adresse zu dem TCP-Verbindung aufgebaut werden sollen
TargetPort	30490		int	TCP-Port zu dem TCP-Verbindung aufgebaut werden sollen
TcpKeepIdle	None		int	ist der Zeitraum in Sekunden ohne Empfang von Daten- oder Bestätigungspaketen für die Verbindung bis zum ersten Senden eines KeepAlive-Packetes. Bei None wird die Option nicht gesetzt.
TcpKeepIntvl	None		int	Das Keepalive-Intervall in Sekunden ist die Dauer zwischen zwei aufeinanderfolgenden Keepalive-Wiederholungen, wenn keine Bestätigung der vorherigen Keepalive-Übertragung empfangen wird.Bei None wird die Option nicht gesetzt.
VlanCfi	0		int	Integer, wird nur bei aktivierter VLAN-Konfig. verwendet
VlanOption	‚no tagging‘	[‚no tagging‘, ‚single tagging‘]	string	Verwendete VLAN-Einstellung
VlanPcp	0		int	Integer, wird nur bei aktivierter VLAN-Konfig. verwendet
VlanVid	1		int	Integer, wird nur bei aktiviertem VLAN-Tagging verwendet

ConnectionInfo¶

Liefert IP-Adresse und Port einer verbundenen Gegenstelle zurück.

Rückgabewert

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
result				string	Tupel aus IP-Adresse (str) und Port (int) oder NotPresent

ReceivePacket¶

Liefert ein Paket aus dem Empfangspuffer zurück und entfernt es von dort

Rückgabewert

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
result				string	Rückgabewert als ByteStream oder NotPresent

ReceiveSomeIpMessage¶

Liefert ein Paket aus dem Empfangspuffer zurück, das als angegebener Typ interpretiert wird und dessen MessageId ggf. mit der Angegebenen übereinstimmt. Wenn MultipleResults aktiviert wird, entsteht eine Liste aus ggf. mehreren Objekten. Das entsprechende Paket wird aus dem Empfangspuffer entfernt.

Parameter

Name	Standardwert	Gültige Werte	Typ	Beschreibung
InterpretAs	‚PacketSomeIp‘	[‚PacketSomeIp‘, ‚PacketSomeIpSd‘]	string	Gibt an von welcher Datenklasse ein Paket interpretiert werden soll. Zurückgegeben wird ein Paket nur, wenn es erfolgreich interpretiert werden konnte.
MessageId			object	Zu filternde MessageId’s (Leer / Integer / Liste von Integern)
MultipleResults	False	[False, True]	bool	Boolean, wenn aktiviert, wird eine Liste mit Ergebnisobjekten zurückgegeben

Rückgabewert

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
result				string	Rückgabewert vom angegebenen Typ, Liste davon oder NotPresent

SendPacket¶

Daten senden

Parameter

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
Data				string	String, Payload als ByteStream

StartSendPacketCyclic¶

Startet das zyklische Senden einer übergebenen Nachricht

Parameter

Name	Standardwert	Typ	Beschreibung
CycleTime	500	int	Zykluszeit [ms]
CyclicHandle		int	Optional kann das CyclicHandle manuell vergeben werden. Dabei muss das Handle eine Ganzzahl größer 0 sein. Eine Kollisionserkennung mit bereits vergebenen Handles wird nicht durchgeführt.
Payload		object	Payload der Nachricht, welche zyklisch versendet werden soll. Es kann entweder direkt ein Bytestream angegeben werden oder ein Objekt aus einem UserPyModule definierten Klasse. Weitere Informationen zur Verwendung des Payloads können der Hilfe entnommen werden (Tool tracetronic: Ethernet).

Rückgabewert

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
CyclicHandle				int	Handle um das zyklische Senden der Nachricht wieder gezielt deaktiveren zu können.

StopSendPacketCyclic¶

Stoppt das zyklische Senden

Parameter

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
CyclicHandle				int	Handle einer Nachricht um deren zyklisches Senden zu beenden. Wird None angegeben, wird das zyklische Senden aller Nachrichten beendet.