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 |
|---|---|---|---|---|---|
Port |
string |
Name des Ports im Netzwerk. In der Vector Hardware Config muss hierzu der Network-based mode aktiviert sein. |
|||
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. |
||
PTP aktiv lassen |
☐ |
bool |
Wenn der Haken gesetzt ist, wird PTP erst beim Port-Stop oder durch den expliziten Aufruf von ‚StopPtpMaster/Client‘ beendet. Andernfalls (default) wird PTP bereits beim Testfallende beendet. |
Jobs 🛈¶
ClearReceiveBuffer¶
Leert den ecu.test-Empfangspuffer auf oberer Ebene. Tiefer gelegene Puffer im Treiber werden nicht geleert.
GetLinkState¶
Gibt den Link-Status dieses Ethernet-Kanals zurück, wie vom XL-Interface bereitgestellt
Parametrierung
Rückgabewert
Name |
Verfügbar wenn |
Standardwert |
Gültige Werte |
Typ |
Beschreibung |
|---|---|---|---|---|---|
linkState |
string |
Mögliche Werte sind: None: „Channel Status“-Ereignis wurde von der XL-Schnittstelle noch nicht empfangen oder das letzte „Channel Status“-Ereignis war korrupt oder die Verbindung zur XL-Schnittstelle wurde geschlossen. „down“: nicht verbunden (z.B. kein Kabel verbunden, nicht konfiguriert, Gegenstelle ausgeschaltet). „up“: verbunden „unknown“: Verbindungszustand konnte nicht ermittelt werden (z.B. wenn die Verbindung zum Gerät unterbrochen wurde). „error“: Verbindung fehlerhaft (e.g. automatisches Aushandeln fehlgeschlagen). |
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 |
StartPtpClient¶
Startet die PTP-Client-Funktionalität.
Parametrierung
Parameter
Name |
Verfügbar wenn |
Standardwert |
Gültige Werte |
Typ |
Beschreibung |
|---|---|---|---|---|---|
ClockIdentity |
int |
Nachrichtenfeld: ClockIdentity |
|||
CorrectionNs |
0 |
int |
Nachrichtenfeld: CorrectionNs |
||
DestMac |
‚01:80:c2:00:00:0e‘ |
string |
Ziel-MAC-Adresse |
||
DomainNumber |
int |
Nachrichtenfeld: DomainNumber |
|||
HwTsOffsetNs |
0 |
int |
Offset, der zu allen Zeitstempeln der Hardware addiert wird. |
||
LogMessagePeriod |
0 |
int |
Nachrichtenfeld: LogMessagePeriod |
||
RequestIntervalNs |
1000000000 |
int |
Intervall, in dem PeerDelayRequest-Nachrichten verschickt werden. |
||
SequenceCounterFreeze |
False |
[False, True] |
bool |
Inkrementieren des SC verhindern. |
|
SequenceCounterInit |
0 |
int |
Initialwert der Sequence Counter |
||
SourceMac |
string |
Quell-MAC-Adresse |
|||
SourcePortId |
int |
Nachrichtenfeld: SourcePortId |
StartPtpMaster¶
Startet die PTP-Master-Funktionalität. Der Datenempfang muss für den Port gestartet sein!
Parametrierung
Parameter
Name |
Verfügbar wenn |
Standardwert |
Gültige Werte |
Typ |
Beschreibung |
|---|---|---|---|---|---|
ClockIdentity |
int |
Nachrichtenfeld: ClockIdentity |
|||
CorrectionNs |
0 |
int |
Nachrichtenfeld: CorrectionNs |
||
CumulativeScaledRateOffset |
0 |
int |
Nachrichtenfeld: CumulativeScaledRateOffset |
||
DestMac |
‚01:80:c2:00:00:0e‘ |
string |
Ziel-MAC-Adresse |
||
DomainNumber |
int |
Nachrichtenfeld: DomainNumber |
|||
FupDelayNs |
0 |
int |
Minimaler zeitlicher Abstand zwischen Sync- und FollowUp-Nachricht |
||
GmTimebaseIndicator |
0 |
int |
Nachrichtenfeld: GmTimebaseIndicator |
||
HwTsOffsetFupNs |
0 |
int |
Offset, der zu Zeitstempeln der Hardware bei FollowUp-Nachrichten addiert wird. |
||
HwTsOffsetNs |
0 |
int |
Offset, der zu allen Zeitstempeln der Hardware addiert wird. |
||
HwTsOffsetPeerDelayResponseFupNs |
0 |
int |
Offset, der zu Zeitstempeln der Hardware bei Peer-Delay-Response-FollowUp-Nachrichten addiert wird. |
||
HwTsOffsetPeerDelayResponseNs |
0 |
int |
Offset, der zu Zeitstempeln der Hardware bei Peer-Delay-Response-Nachrichten addiert wird. |
||
LastGwPhaseChange |
0 |
int |
Nachrichtenfeld: LastGwPhaseChange |
||
LogMessagePeriod |
0 |
int |
Nachrichtenfeld: LogMessagePeriod |
||
PeerDelayResponseFupDelayNs |
0 |
int |
Minimaler zeitlicher Abstand zwischen PeerDelayResponse- und FollowUp-Nachricht |
||
ScaledLastGmFreqChange |
0 |
int |
Nachrichtenfeld: ScaledLastGmFreqChange |
||
SendFup |
True |
[False, True] |
bool |
Versende FollowUp-Nachrichten. |
|
SendPeerDelayResponse |
True |
[False, True] |
bool |
Versende Peer-Delay-Response- und -FollowUp-Nachrichten. |
|
SendPeerDelayResponseFup |
True |
[False, True] |
bool |
Versende Peer-Delay-Response-FollowUp-Nachrichten. |
|
SequenceCounterFreeze |
False |
[False, True] |
bool |
Inkrementieren des SC verhindern. |
|
SequenceCounterFupOffset |
0 |
int |
Offset, zwischen Sync und FollowUp SequenceCounter. |
||
SequenceCounterInit |
0 |
int |
Initialwert der Sequence Counter |
||
SequenceCounterPeerDelayResponseFupOffset |
0 |
int |
Offset, zwischen Peer-Delay-Request und Response-FollowUp SequenceCounter. |
||
SequenceCounterPeerDelayResponseOffset |
0 |
int |
Offset, zwischen Peer-Delay-Request und Response SequenceCounter. |
||
SourceMac |
string |
Quell-MAC-Adresse |
|||
SourcePortId |
int |
Nachrichtenfeld: SourcePortId |
|||
SyncIntervalNs |
125000000 |
int |
Intervall, in dem Sync-Nachrichten verschickt werden. |
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 |
StopPtpClient¶
Stoppt die PTP-Client-Funktionalität
StopPtpMaster¶
Stoppt die PTP-Master-Funktionalität
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. |
UpdatePtpClient¶
Aktualisiert die Parameter der PTP-Client-Funktionalität. Der Datenempfang muss für den Port gestartet sein!
Parametrierung
Parameter
Name |
Verfügbar wenn |
Standardwert |
Gültige Werte |
Typ |
Beschreibung |
|---|---|---|---|---|---|
ClockIdentity |
int |
Nachrichtenfeld: ClockIdentity |
|||
CorrectionNs |
0 |
int |
Nachrichtenfeld: CorrectionNs |
||
DestMac |
‚01:80:c2:00:00:0e‘ |
string |
Ziel-MAC-Adresse |
||
DomainNumber |
int |
Nachrichtenfeld: DomainNumber |
|||
HwTsOffsetNs |
0 |
int |
Offset, der zu allen Zeitstempeln der Hardware addiert wird. |
||
LogMessagePeriod |
0 |
int |
Nachrichtenfeld: LogMessagePeriod |
||
RequestIntervalNs |
1000000000 |
int |
Intervall, in dem PeerDelayRequest-Nachrichten verschickt werden. |
||
SequenceCounterFreeze |
False |
[False, True] |
bool |
Inkrementieren des SC verhindern. |
|
SequenceCounterInit |
0 |
int |
Initialwert der Sequence Counter |
||
SourceMac |
string |
Quell-MAC-Adresse |
|||
SourcePortId |
int |
Nachrichtenfeld: SourcePortId |
UpdatePtpMaster¶
Aktualisiert die Parameter der PTP-Master-Funktionalität. Der Datenempfang muss für den Port gestartet sein!
Parametrierung
Parameter
Name |
Verfügbar wenn |
Standardwert |
Gültige Werte |
Typ |
Beschreibung |
|---|---|---|---|---|---|
ClockIdentity |
int |
Nachrichtenfeld: ClockIdentity |
|||
CorrectionNs |
0 |
int |
Nachrichtenfeld: CorrectionNs |
||
CumulativeScaledRateOffset |
0 |
int |
Nachrichtenfeld: CumulativeScaledRateOffset |
||
DestMac |
‚01:80:c2:00:00:0e‘ |
string |
Ziel-MAC-Adresse |
||
DomainNumber |
int |
Nachrichtenfeld: DomainNumber |
|||
FupDelayNs |
0 |
int |
Minimaler zeitlicher Abstand zwischen Sync- und FollowUp-Nachricht |
||
GmTimebaseIndicator |
0 |
int |
Nachrichtenfeld: GmTimebaseIndicator |
||
HwTsOffsetFupNs |
0 |
int |
Offset, der zu Zeitstempeln der Hardware bei FollowUp-Nachrichten addiert wird. |
||
HwTsOffsetNs |
0 |
int |
Offset, der zu allen Zeitstempeln der Hardware addiert wird. |
||
HwTsOffsetPeerDelayResponseFupNs |
0 |
int |
Offset, der zu Zeitstempeln der Hardware bei Peer-Delay-Response-FollowUp-Nachrichten addiert wird. |
||
HwTsOffsetPeerDelayResponseNs |
0 |
int |
Offset, der zu Zeitstempeln der Hardware bei Peer-Delay-Response-Nachrichten addiert wird. |
||
LastGwPhaseChange |
0 |
int |
Nachrichtenfeld: LastGwPhaseChange |
||
LogMessagePeriod |
0 |
int |
Nachrichtenfeld: LogMessagePeriod |
||
PeerDelayResponseFupDelayNs |
0 |
int |
Minimaler zeitlicher Abstand zwischen PeerDelayResponse- und FollowUp-Nachricht |
||
ScaledLastGmFreqChange |
0 |
int |
Nachrichtenfeld: ScaledLastGmFreqChange |
||
SendFup |
True |
[False, True] |
bool |
Versende FollowUp-Nachrichten. |
|
SendPeerDelayResponse |
True |
[False, True] |
bool |
Versende Peer-Delay-Response- und -FollowUp-Nachrichten. |
|
SendPeerDelayResponseFup |
True |
[False, True] |
bool |
Versende Peer-Delay-Response-FollowUp-Nachrichten. |
|
SequenceCounterFreeze |
False |
[False, True] |
bool |
Inkrementieren des SC verhindern. |
|
SequenceCounterFupOffset |
0 |
int |
Offset, zwischen Sync und FollowUp SequenceCounter. |
||
SequenceCounterInit |
0 |
int |
Initialwert der Sequence Counter |
||
SequenceCounterPeerDelayResponseFupOffset |
0 |
int |
Offset, zwischen Peer-Delay-Request und Response-FollowUp SequenceCounter. |
||
SequenceCounterPeerDelayResponseOffset |
0 |
int |
Offset, zwischen Peer-Delay-Request und Response SequenceCounter. |
||
SourceMac |
string |
Quell-MAC-Adresse |
|||
SourcePortId |
int |
Nachrichtenfeld: SourcePortId |
|||
SyncIntervalNs |
125000000 |
int |
Intervall, in dem Sync-Nachrichten verschickt werden. |