Port SERVICEACCESS - UDP-PCAP-SOCKET 🛈¶
UDP Netzwerkstack auf PCAP-Basis
Dieser Port ist nur verfügbar, wenn Npcap installiert ist.
Stimulation¶
Dieser Port besitzt keine Stimulus-Fähigkeiten.
Eigenschaften 🛈¶
Name |
Verfügbar wenn |
Standardwert |
Gültige Werte |
Typ |
Beschreibung |
|---|---|---|---|---|---|
Netzwerkadapter |
string |
Netzwerkadapter, der zum Empfang von Netzwerkpaketen verwendet werden soll |
|||
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. |
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 der verbundenen Gegenstelle zurück.
Parametrierung
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
Parametrierung
Parameter
Name |
Verfügbar wenn |
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 |
||
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 |
||
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 |
ReceivePacket¶
Liefert ein Paket aus dem Empfangspuffer zurück und entfernt es von dort
Parametrierung
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.
Parametrierung
Parameter
Name |
Verfügbar wenn |
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
Parametrierung
Parameter
Name |
Verfügbar wenn |
Standardwert |
Gültige Werte |
Typ |
Beschreibung |
|---|---|---|---|---|---|
Data |
string |
String, Payload als ByteStream (z.B. ByteStream(„00:00“) |
StartSendPacketCyclic¶
Startet das zyklische Senden einer übergebenen Nachricht
Parametrierung
Parameter
Name |
Verfügbar wenn |
Standardwert |
Gültige Werte |
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
Parametrierung
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. |