Port SERVICEACCESS - ETHERNET-RAW¶
ETHERNET OSI layer 2 communication
Stimulation¶
此端口不具备激励能力。
Properties 🛈¶
Name |
在以下情况下可用 |
默认值 |
有效值 |
Type |
Description |
|---|---|---|---|---|---|
Port |
string |
Name of the port inside a network. In Vector Hardware Config, the network-based mode must be activated. |
|||
Filter in BPF format |
string |
Specify a BPF filter |
|||
VLAN settings |
‘no tagging’ |
[‘no tagging’, ‘single tagging’] |
string |
Used VLAN setting |
|
VLAN-VID |
1 |
int |
Integer, only used if VLAN tagging is enabled |
||
Receive buffer size |
1000 |
int |
Number of messages which can be recorded in the receive buffer (ring buffer) |
||
Automatic data reception on test run |
☑ |
bool |
Only operative if on the left for ‘Start’ either ‘Always’ is chosen, or ‘If necessary’ and the port is in use in the test configuration. |
||
Path / file name for the PCAP/PCAPNG output file |
Automatic data reception on test run |
string |
PCAP or PCAPNG file (with absolute path). Recording is done into this file. Leave blank if no recording is desired. |
||
Default source MAC address |
‘02:00:4C:4F:4F:50’ |
string |
Default MAC which will be used for ethernet frames. |
||
Keep cyclic sending active |
☐ |
bool |
If checked, cyclic transmission of packets will be stopped during port stop, or by explicitly calling ‘StopSendPacketCyclic’. Otherwise (default) cyclic transmission will be stopped when test case execution finishes. |
||
Leave PTP active |
☐ |
bool |
若勾选,则仅在配置关闭时或显式调用 ‘StopPtpMaster/Client’ 时才停止 PTP。否则(默认),在 test case 执行结束后停止 PTP。 |
||
IP address |
string |
IP address of the port, will be replaced for [IP] in the filter string |
Jobs 🛈¶
ClearReceiveBuffer¶
Clears the ecu.test high-level receive buffer. Low-level buffers in the driver are not cleared.
GetLinkState¶
Returns the Link status of this Ethernet channel as provided by the XL interface
Parameterization
返回值
Name |
在以下情况下可用 |
默认值 |
有效值 |
Type |
Description |
|---|---|---|---|---|---|
linkState |
string |
Possible values are: None: “Channel Status” event not yet received from XL interface or last “Channel Status” event was malformed or connection to XL interface closed. “down”: Link is down (e. g. no cable attached, not configured, remote station down). “up”: Link is up. “unknown”: Link status could not be determined (e. g. if connection to device is lost). “error”: Link is in error state (e. g. auto-negotiation failed). |
Playback¶
Plays back a PCAP or PCAPNG recording on the network adapter. The call returns immediately, the playback continues asynchronously.
Parameterization
Parameter
Name |
在以下情况下可用 |
默认值 |
有效值 |
Type |
Description |
|---|---|---|---|---|---|
PcapFile |
uri |
PCAP or PCAPNG file to play back: Absolute path or relative to the workspace. |
返回值
Name |
在以下情况下可用 |
默认值 |
有效值 |
Type |
Description |
|---|---|---|---|---|---|
Identifier |
int |
Instance identifier that can be used for StopPlayback |
ReceivePacket¶
Returns a packet from the receive buffer and removes it from there
Parameterization
返回值
Name |
在以下情况下可用 |
默认值 |
有效值 |
Type |
Description |
|---|---|---|---|---|---|
result |
string |
Return value of type PacketEthernet or NotPresent |
ReceiveSomeIpMessage¶
Parameterization
Parameter
Name |
在以下情况下可用 |
默认值 |
有效值 |
Type |
Description |
|---|---|---|---|---|---|
InterpretAs |
string |
||||
MessageId |
int |
||||
MultipleResults |
False |
[False, True] |
bool |
ResolveMac¶
Resolve MAC-address
Parameterization
Parameter
Name |
在以下情况下可用 |
默认值 |
有效值 |
Type |
Description |
|---|---|---|---|---|---|
EthSrcMac |
‘Default’ |
string |
String (format: 00:11:FF:1E:32:FF), leave ‘Default’ if the MAC from the port settings should be used |
||
IpDst |
‘192.168.0.1’ |
string |
String (format: 192.168.0.1) |
||
IpSrc |
‘Default’ |
string |
String (format: 192.168.0.1), leave ‘Default’ if the IP from the port settings should be used |
||
SrcSubnetMask |
‘Default’ |
string |
Subnet mask for IP network (necessary for broadcast detection, e.g. ARP), leave Default for using the primary NIC subnet mask |
||
VlanCfi |
0 |
int |
Integer, is only used if VLAN is configured |
||
VlanPcp |
0 |
int |
Integer, is only used if VLAN is configured |
||
VlanVid |
‘Default’ |
string |
Integer, Default if port setting should be used, only evaluated if VLAN is configured |
SendPacket¶
Parameterization
Parameter
Name |
在以下情况下可用 |
默认值 |
有效值 |
Type |
Description |
|---|---|---|---|---|---|
EthDestMac |
string |
String (format: 00:11:FF:1E:32:FF), Default if MAC address is resolved over ARP or multicast calculation |
|||
EthernetData |
string |
String, payload as a ByteStream (e.g. ByteStream(“00:00”)) |
|||
EthSrcMac |
‘Default’ |
string |
String (format: 00:11:FF:1E:32:FF), leave ‘Default’ if the MAC from the port settings should be used |
||
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 from selection or integer |
|
VlanCfi |
0 |
int |
Integer, is only used if VLAN is configured |
||
VlanPcp |
0 |
int |
Integer, is only used if VLAN is configured |
||
VlanVid |
‘Default’ |
string |
Integer, Default if port setting should be used, only evaluated if VLAN is configured |
StartPtpClient¶
启动 PTP 客户端功能。
Parameterization
Parameter
Name |
在以下情况下可用 |
默认值 |
有效值 |
Type |
Description |
|---|---|---|---|---|---|
ClockIdentity |
int |
消息字段:ClockIdentity |
|||
CorrectionNs |
0 |
int |
消息字段:CorrectionNs |
||
DestMac |
‘01:80:c2:00:00:0e’ |
string |
目标 MAC 地址 |
||
DomainNumber |
int |
报文字段:DomainNumber |
|||
HwTsOffsetNs |
0 |
int |
要加到所有硬件时间戳上的偏移量。 |
||
LogMessagePeriod |
0 |
int |
消息字段:LogMessagePeriod |
||
RequestIntervalNs |
1000000000 |
int |
发送 PeerDelayRequest 消息的间隔。 |
||
SequenceCounterFreeze |
False |
[False, True] |
bool |
防止 SC 递增。 |
|
SequenceCounterInit |
0 |
int |
序列计数器的初始值 |
||
SourceMac |
string |
源 MAC 地址 |
|||
SourcePortId |
int |
消息字段:SourcePortId |
StartPtpMaster¶
启动 PTP master 功能。必须先为该端口启动数据接收!
Parameterization
Parameter
Name |
在以下情况下可用 |
默认值 |
有效值 |
Type |
Description |
|---|---|---|---|---|---|
ClockIdentity |
int |
消息字段:ClockIdentity |
|||
CorrectionNs |
0 |
int |
消息字段:CorrectionNs |
||
CumulativeScaledRateOffset |
0 |
int |
消息字段:CumulativeScaledRateOffset |
||
DestMac |
‘01:80:c2:00:00:0e’ |
string |
目标 MAC 地址 |
||
DomainNumber |
int |
报文字段:DomainNumber |
|||
FupDelayNs |
0 |
int |
Sync 与 FollowUp 报文之间的最小时间间隔 |
||
GmTimebaseIndicator |
0 |
int |
消息字段:GmTimebaseIndicator |
||
HwTsOffsetFupNs |
0 |
int |
要加到 FollowUp 消息硬件时间戳上的偏移量。 |
||
HwTsOffsetNs |
0 |
int |
要加到所有硬件时间戳上的偏移量。 |
||
HwTsOffsetPeerDelayResponseFupNs |
0 |
int |
要加到 PeerDelayResponseFollowUp 消息的硬件时间戳上的偏移量。 |
||
HwTsOffsetPeerDelayResponseNs |
0 |
int |
要加到 PeerDelayResponse 消息的硬件时间戳上的偏移量。 |
||
LastGwPhaseChange |
0 |
int |
报文字段:LastGwPhaseChange |
||
LogMessagePeriod |
0 |
int |
消息字段:LogMessagePeriod |
||
PeerDelayResponseFupDelayNs |
0 |
int |
PeerDelayResponse 与 FollowUp 消息之间的最小时间间隔 |
||
ScaledLastGmFreqChange |
0 |
int |
消息字段:ScaledLastGmFreqChange |
||
SendFup |
True |
[False, True] |
bool |
发送 FollowUp 消息。 |
|
SendPeerDelayResponse |
True |
[False, True] |
bool |
发送 PeerDelayResponse 与 FollowUp 报文。 |
|
SendPeerDelayResponseFup |
True |
[False, True] |
bool |
发送 PeerDelayResponseFollowUp 消息。 |
|
SequenceCounterFreeze |
False |
[False, True] |
bool |
防止 SC 递增。 |
|
SequenceCounterFupOffset |
0 |
int |
Sync 与 FollowUp SequenceCounter 之间的偏移量。 |
||
SequenceCounterInit |
0 |
int |
序列计数器的初始值 |
||
SequenceCounterPeerDelayResponseFupOffset |
0 |
int |
PeerDelayRequest 与 ResponseFollowUp SequenceCounter 之间的偏移。 |
||
SequenceCounterPeerDelayResponseOffset |
0 |
int |
PeerDelayRequest 与 Response SequenceCounter 之间的偏移。 |
||
SourceMac |
string |
源 MAC 地址 |
|||
SourcePortId |
int |
消息字段:SourcePortId |
|||
SyncIntervalNs |
125000000 |
int |
发送同步消息的间隔。 |
StartReceiving¶
Starts manual data receiving
Parameterization
Parameter
Name |
在以下情况下可用 |
默认值 |
有效值 |
Type |
Description |
|---|---|---|---|---|---|
FilterString |
string |
Specify a BPF filter |
|||
PcapFileName |
string |
PCAP or PCAPNG file (with absolute path). Recording is done into this file. Leave blank if no recording is desired. |
|||
VlanVid |
‘Default’ |
string |
Integer, Default if port setting should be used, only evaluated if VLAN is configured |
StartSendPacketCyclic¶
Starts cyclic Transmission of a specified message
Parameterization
Parameter
Name |
在以下情况下可用 |
默认值 |
有效值 |
Type |
Description |
|---|---|---|---|---|---|
CycleTime |
500 |
int |
Cycle time [ms] |
||
CyclicHandle |
int |
CyclicHandle can be defined manually. It must be an integer value greater than 0. Collision detection against already defined handles will not be performed. |
|||
Payload |
object |
Payload of the message to be sent cyclically. Either a byte stream can be specified directly or an object from a UserPyModule defined class. Further information on using the payload can be found in the help (Tool tracetronic: Ethernet). |
返回值
Name |
在以下情况下可用 |
默认值 |
有效值 |
Type |
Description |
|---|---|---|---|---|---|
CyclicHandle |
int |
Handle for targeted deactivation of cyclic transmission of that particular message. |
StopPlayback¶
Stops playback of a PCAP/PCAPNG file
Parameterization
Parameter
Name |
在以下情况下可用 |
默认值 |
有效值 |
Type |
Description |
|---|---|---|---|---|---|
Identifier |
-1 |
int |
Instance identifier returned by the “Playback” job call |
StopPtpClient¶
停止 PTP 客户端功能
StopPtpMaster¶
停止 PTP 主站功能
StopReceiving¶
Stops data receiving manual
StopSendPacketCyclic¶
Stops cyclic transmission
Parameterization
Parameter
Name |
在以下情况下可用 |
默认值 |
有效值 |
Type |
Description |
|---|---|---|---|---|---|
CyclicHandle |
int |
Handle of a message to stop its cyclic transmission. If None is specified, cyclic transmission of all messages is stopped. |
UpdatePtpClient¶
更新 PTP 客户端功能的参数。必须为该端口启动数据接收!
Parameterization
Parameter
Name |
在以下情况下可用 |
默认值 |
有效值 |
Type |
Description |
|---|---|---|---|---|---|
ClockIdentity |
int |
消息字段:ClockIdentity |
|||
CorrectionNs |
0 |
int |
消息字段:CorrectionNs |
||
DestMac |
‘01:80:c2:00:00:0e’ |
string |
目标 MAC 地址 |
||
DomainNumber |
int |
报文字段:DomainNumber |
|||
HwTsOffsetNs |
0 |
int |
要加到所有硬件时间戳上的偏移量。 |
||
LogMessagePeriod |
0 |
int |
消息字段:LogMessagePeriod |
||
RequestIntervalNs |
1000000000 |
int |
发送 PeerDelayRequest 消息的间隔。 |
||
SequenceCounterFreeze |
False |
[False, True] |
bool |
防止 SC 递增。 |
|
SequenceCounterInit |
0 |
int |
序列计数器的初始值 |
||
SourceMac |
string |
源 MAC 地址 |
|||
SourcePortId |
int |
消息字段:SourcePortId |
UpdatePtpMaster¶
更新 PTP master 功能的参数。必须先为该端口启动数据接收!
Parameterization
Parameter
Name |
在以下情况下可用 |
默认值 |
有效值 |
Type |
Description |
|---|---|---|---|---|---|
ClockIdentity |
int |
消息字段:ClockIdentity |
|||
CorrectionNs |
0 |
int |
消息字段:CorrectionNs |
||
CumulativeScaledRateOffset |
0 |
int |
消息字段:CumulativeScaledRateOffset |
||
DestMac |
‘01:80:c2:00:00:0e’ |
string |
目标 MAC 地址 |
||
DomainNumber |
int |
报文字段:DomainNumber |
|||
FupDelayNs |
0 |
int |
Sync 与 FollowUp 报文之间的最小时间间隔 |
||
GmTimebaseIndicator |
0 |
int |
消息字段:GmTimebaseIndicator |
||
HwTsOffsetFupNs |
0 |
int |
要加到 FollowUp 消息硬件时间戳上的偏移量。 |
||
HwTsOffsetNs |
0 |
int |
要加到所有硬件时间戳上的偏移量。 |
||
HwTsOffsetPeerDelayResponseFupNs |
0 |
int |
要加到 PeerDelayResponseFollowUp 消息的硬件时间戳上的偏移量。 |
||
HwTsOffsetPeerDelayResponseNs |
0 |
int |
要加到 PeerDelayResponse 消息的硬件时间戳上的偏移量。 |
||
LastGwPhaseChange |
0 |
int |
报文字段:LastGwPhaseChange |
||
LogMessagePeriod |
0 |
int |
消息字段:LogMessagePeriod |
||
PeerDelayResponseFupDelayNs |
0 |
int |
PeerDelayResponse 与 FollowUp 消息之间的最小时间间隔 |
||
ScaledLastGmFreqChange |
0 |
int |
消息字段:ScaledLastGmFreqChange |
||
SendFup |
True |
[False, True] |
bool |
发送 FollowUp 消息。 |
|
SendPeerDelayResponse |
True |
[False, True] |
bool |
发送 PeerDelayResponse 与 FollowUp 报文。 |
|
SendPeerDelayResponseFup |
True |
[False, True] |
bool |
发送 PeerDelayResponseFollowUp 消息。 |
|
SequenceCounterFreeze |
False |
[False, True] |
bool |
防止 SC 递增。 |
|
SequenceCounterFupOffset |
0 |
int |
Sync 与 FollowUp SequenceCounter 之间的偏移量。 |
||
SequenceCounterInit |
0 |
int |
序列计数器的初始值 |
||
SequenceCounterPeerDelayResponseFupOffset |
0 |
int |
PeerDelayRequest 与 ResponseFollowUp SequenceCounter 之间的偏移。 |
||
SequenceCounterPeerDelayResponseOffset |
0 |
int |
PeerDelayRequest 与 Response SequenceCounter 之间的偏移。 |
||
SourceMac |
string |
源 MAC 地址 |
|||
SourcePortId |
int |
消息字段:SourcePortId |
|||
SyncIntervalNs |
125000000 |
int |
发送同步消息的间隔。 |