Port SERVICEACCESS - ETHERNET-RAW

ETHERNET OSI-Schicht-2-Kommunikation

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

Stimulation

Dieser Port besitzt keine Stimulus-Fähigkeiten.

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

Empfangspuffergröße

1000

int

Anzahl der Botschaften die der Empfangspuffers (Ringbuffer) aufnehmen kann

Autom. Datenempfang bei Testausführung

☑

bool

Nur wirksam wenn links bei ‚Start‘ 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.

IP Adresse

string

IP-Adresse des Ports, wird im Filter für [IP] eingesetzt

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.