Port SERVICEACCESS - ETHERNET-RAW 🛈¶

ETHERNET OSI-Schicht-2-Kommunikation

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	Verwendeter Netzwerkadapter
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		‚Default‘		string	Standard-MAC, die als Quelle für Ethernet-Frames verwendet wird. Default, wenn die primäre Adapter-MAC-Adresse verwendet werden soll
Loggerprotokoll			[, PLP/TECMP, ASAM CMP]	string	Ein Loggerprotokoll wie z.B. ASAM CMP verwenden. Der Port kann dann nur noch lesend verwendet werden. In den Loggernachrichten enthaltene Ethernet-Frames werden extrahiert und der Filter im BPF-Format (falls angegeben) wird auf diese Frames angewendet.
Device-IDs / Probe-IDs	Loggerprotokoll: ‚PLP/TECMP‘			string	Identifier der Devices / Probes: leer, wenn keine Filterung anhand der Probe-ID benötigt wird; mehrere können durch Komma getrennt werden.
Device- und Stream-IDs	Loggerprotokoll: ‚ASAM CMP‘			string	Identifier der Devices und Streams als Liste von Tupeln, jeweils bestehend aus Device-ID und Stream-ID, z.B.: (1,2),(3,4). Leer lassen, wenn keine Filterung anhand von Device- und Stream-ID benötigt wird.
Interface-IDs / Bus-Spec-IDs	Loggerprotokoll: ‚PLP/TECMP‘			string	Identifier der Interfaces / Busspezifikationen: leer, wenn keine Filterung anhand der Busspezifikation benötigt wird; mehrere können durch Komma getrennt werden.
Interface-IDs	Loggerprotokoll: ‚ASAM CMP‘			string	Identifier der Interfaces: leer, wenn keine Filterung anhand der Interface-ID benötigt wird; mehrere können durch Komma getrennt werden.
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.

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

Rückgabewert

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

ReceiveSomeIpMessage¶

Parameter

Name	Standardwert	Gültige Werte	Typ
InterpretAs			string
MessageId			int
MultipleResults	False	[False, True]	bool

ResolveMac¶

Löse MAC-Adresse auf

Parameter

Name	Standardwert	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¶

Parameter

Name	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

Parameter

Name	Standardwert	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

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.

StopPlayback¶

Beendet das Abspielen einer PCAP-/PCAPNG-Datei

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

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.