Port SERVICEACCESS - ETHERNET-RAW 🛈¶
ETHERNET OSI-Schicht-2-Kommunikation
Stimulation¶
Dieser Port besitzt keine Stimulus-Fähigkeiten.
Eigenschaften 🛈¶
Name |
Verfügbar wenn |
Standardwert |
Gültige Werte |
Typ |
Beschreibung |
|---|---|---|---|---|---|
Netzwerkname |
string |
Name des Netzwerkes, wie in SIL-Kit Config yaml definiert. |
|||
Kontrollername |
string |
Name des Kontrollers, wie in SIL-Kit Config yaml definiert. |
|||
Filter im BPF-Format |
string |
Angabe eines BPF-Filters |
|||
VLAN-Einstellung |
‚no tagging‘ |
[‚no tagging‘, ‚single tagging‘] |
string |
Verwendete VLAN-Einstellung |
|
VLAN-VID |
1 |
int |
Integer, wird nur bei aktiviertem VLAN-Tagging verwendet |
||
Deaktivere LibPcap-Pufferung |
☐ |
bool |
Deaktiviere interne Pufferung der LibPcap |
||
Empfangspuffergröße |
1000 |
int |
Anzahl der Botschaften die der Empfangspuffers (Ringbuffer) aufnehmen kann |
||
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. |
||
Pfad/Dateiname der PCAP/PCAPNG-Ausgabedatei |
Autom. Datenempfang bei Testausführung |
string |
PCAP- oder PCAPNG-Datei (mit absolutem Pfad). In diese Datei wird aufgezeichnet. Leer lassen wenn keine Aufzeichnung gewünscht ist. |
||
Standard-Quell-MAC-Adresse |
‚02:00:4C:4F:4F:50‘ |
string |
Standard-MAC, die als Quelle für Ethernet-Frames verwendet wird. |
||
Zyklisches Senden aktiv lassen |
☐ |
bool |
Wenn der Haken gesetzt ist, wird das zyklische Senden von Paketen erst beim Port-Stop 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.
Playback¶
Spielt eine PCAP- oder PCAPNG-Aufnahme auf dem Netzwerkadapter ab. Der Aufruf kehrt sofort zurück, das Abspielen läuft asynchron weiter.
Parametrierung
Parameter
Name |
Verfügbar wenn |
Standardwert |
Gültige Werte |
Typ |
Beschreibung |
|---|---|---|---|---|---|
PcapFile |
uri |
Abzuspielende PCAP- oder PCAPNG-Datei: Absoluter Pfad oder relativ zum Workspace. |
Rückgabewert
Name |
Verfügbar wenn |
Standardwert |
Gültige Werte |
Typ |
Beschreibung |
|---|---|---|---|---|---|
Identifier |
int |
Instanz-Bezeichner, der für StopPlayback verwendet werden kann |
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 vom Typ PacketEthernet oder NotPresent |
ReceiveSomeIpMessage¶
Parametrierung
Parameter
Name |
Verfügbar wenn |
Standardwert |
Gültige Werte |
Typ |
Beschreibung |
|---|---|---|---|---|---|
InterpretAs |
string |
||||
MessageId |
int |
||||
MultipleResults |
False |
[False, True] |
bool |
ResolveMac¶
Löse MAC-Adresse auf
Parametrierung
Parameter
Name |
Verfügbar wenn |
Standardwert |
Gültige Werte |
Typ |
Beschreibung |
|---|---|---|---|---|---|
EthSrcMac |
‚Default‘ |
string |
String (Format: 00:11:FF:1E:32:FF), Default wenn die im Port eingestellte MAC verwendet werden soll |
||
IpDst |
‚192.168.0.1‘ |
string |
String (Format: 192.168.0.1) |
||
IpSrc |
‚Default‘ |
string |
String (Format: 192.168.0.1), Default wenn die im Port eingestellte IP verwendet werden soll |
||
SrcSubnetMask |
‚Default‘ |
string |
Subnetzmaske für das verwendete IP-Netz (notwendig zur Erkennung von Broadcast-Adressen, z.B für ARP) Default wenn primäre Adapter-Subnetzmaske verwendet werden soll |
||
VlanCfi |
0 |
int |
Integer, wird nur bei aktivierter VLAN-Konfig. verwendet |
||
VlanPcp |
0 |
int |
Integer, wird nur bei aktivierter VLAN-Konfig. verwendet |
||
VlanVid |
‚Default‘ |
string |
Integer, Default wenn Porteinstellung übernommen werden soll, wird nur bei aktivierter VLAN-Konfig. verwendet |
SendPacket¶
Parametrierung
Parameter
Name |
Verfügbar wenn |
Standardwert |
Gültige Werte |
Typ |
Beschreibung |
|---|---|---|---|---|---|
EthDestMac |
string |
String (Format: 00:11:FF:1E:32:FF), Default wenn die MAC-Adresse über einen ARP-Request oder Multicast-Berechnung ermittelt werden soll |
|||
EthernetData |
string |
String, Payload als ByteStream (z.B. ByteStream(„00:00“) |
|||
EthSrcMac |
‚Default‘ |
string |
String (Format: 00:11:FF:1E:32:FF), Default wenn die im Port eingestellte MAC verwendet werden soll |
||
EthSrcType |
‚ETH_TYPE_IP‘ |
[‚ETH_TYPE_8021AD‘, ‚ETH_TYPE_8021Q‘, ‚ETH_TYPE_AOE‘, ‚ETH_TYPE_ARP‘, ‚ETH_TYPE_CDP‘, ‚ETH_TYPE_DTP‘, ‚ETH_TYPE_EDP‘, ‚ETH_TYPE_IP‘, ‚ETH_TYPE_IP6‘, ‚ETH_TYPE_IPX‘, ‚ETH_TYPE_LLDP‘, ‚ETH_TYPE_MPLS‘, ‚ETH_TYPE_MPLS_MCAST‘, ‚ETH_TYPE_PPP‘, ‚ETH_TYPE_PPPoE‘, ‚ETH_TYPE_PPPoE_DISC‘, ‚ETH_TYPE_PROFINET‘, ‚ETH_TYPE_PUP‘, ‚ETH_TYPE_QINQ1‘, ‚ETH_TYPE_QINQ2‘, ‚ETH_TYPE_REVARP‘, ‚ETH_TYPE_TEB‘, ‚ETH_TYPE_UNKNOWN‘] |
string |
String aus Auswahlfeld oder Integer |
|
VlanCfi |
0 |
int |
Integer, wird nur bei aktivierter VLAN-Konfig. verwendet |
||
VlanPcp |
0 |
int |
Integer, wird nur bei aktivierter VLAN-Konfig. verwendet |
||
VlanVid |
‚Default‘ |
string |
Integer, Default wenn Porteinstellung übernommen werden soll, wird nur bei aktivierter VLAN-Konfig. verwendet |
StartReceiving¶
Startet den Datenempfang manuell
Parametrierung
Parameter
Name |
Verfügbar wenn |
Standardwert |
Gültige Werte |
Typ |
Beschreibung |
|---|---|---|---|---|---|
FilterString |
string |
Angabe eines BPF-Filters |
|||
PcapFileName |
string |
PCAP- oder PCAPNG-Datei (mit absolutem Pfad). In diese Datei wird aufgezeichnet. Leer lassen wenn keine Aufzeichnung gewünscht ist. |
|||
VlanVid |
‚Default‘ |
string |
Integer, Default wenn Porteinstellung übernommen werden soll, wird nur bei aktivierter VLAN-Konfig. verwendet |
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. |
StopPlayback¶
Beendet das Abspielen einer PCAP-/PCAPNG-Datei
Parametrierung
Parameter
Name |
Verfügbar wenn |
Standardwert |
Gültige Werte |
Typ |
Beschreibung |
|---|---|---|---|---|---|
Identifier |
-1 |
int |
Instanz-Bezeichner, der beim Aufruf des Playback-Jobs zurückgegeben wurde |
StopReceiving¶
Beendet den Datenempfang manuell
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. |