Port SERVICEACCESS - UDP-SOCKET 🛈¶

UDP Kommunikation socketbasiert

Stimulation¶

Dieser Port besitzt keine Stimulus-Fähigkeiten.

Eigenschaften 🛈¶

Name	Standardwert	Gültige Werte	Typ	Beschreibung
Empfangspuffergröße	1000		int	Anzahl der Botschaften die der Empfangspuffers (Ringbuffer) aufnehmen kann
IP-Version	IPv4	[IPv4, IPv6]	string	Auswahl der verwendeten IP Version
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.

Jobs 🛈¶

ClearReceiveBuffer¶

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

CloseConnection¶

Beendet geöffnete UDP-Verbindung

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

OpenConnection¶

Öffnet eine UDP-Verbindung

Parameter

Name	Standardwert	Typ	Beschreibung
ListenPort	30490	int	Port auf dem UDP-Segmente empfangen werden
TargetHost	‚192.168.0.1‘	string	Hostname oder IP-Adresse an den UDP-Segmente adressiert werden
TargetPort	30490	int	Port an den UDP-Segmente adressiert werden

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.