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.
Eigenschaften 🛈¶
Name |
Verfügbar wenn |
Standardwert |
Gültige Werte |
Typ |
Beschreibung |
|---|---|---|---|---|---|
Netzwerkadapter |
[ONLINE] |
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 |
||
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. |
||
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. |
||
PTP aktiv lassen |
☐ |
bool |
Falls angekreuzt wird PTP erst gestoppt wenn die Konfiguration heruntergefahren wird, oder durch expliziten Aufruf von ‚StopPtpMaster/Client‘. Sonst (default) wird PTP am Ende des Testfalls gestoppt. |
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 |
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. |