Port SERVICEACCESS - ETHERNET-RAW¶
ETHERNET OSI layer 2 communication
此端口要求安装 PCAP 驱动。
Stimulation¶
此端口不具备激励能力。
Properties 🛈¶
Name |
在以下情况下可用 |
默认值 |
有效值 |
Type |
Description |
|---|---|---|---|---|---|
网络接口卡 |
[ONLINE] |
string |
Used network interface card |
||
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. |
||
Default source MAC address |
‘Default’ |
string |
Default MAC which will be used for ethernet frames. Uses the primary MAC address of the adapter by default |
||
Logger protocol |
[, PLP/TECMP, ASAM CMP] |
string |
Use a logger protocol such as ASAM CMP. The port can then only be used for reading. Ethernet frames contained in the logger messages are extracted and the filter in BPF format (if specified) is applied to these frames. |
||
Device-IDs / Probe-IDs |
Logger protocol: ‘PLP/TECMP’ |
string |
Identifiers of the devices / probes: empty if no filtering based on device / probe IDs is required; several can be separated by commas. |
||
Device and Stream IDs |
Logger protocol: ‘ASAM CMP’ |
string |
Identifiers of the devices and streams as a list of tuples, each consisting of device ID and stream ID, e.g.: (1,2),(3,4). Leave empty if no filtering based on device and stream ID is needed. |
||
Interface-IDs / Bus-Spec-IDs |
Logger protocol: ‘PLP/TECMP’ |
string |
Identifiers of the interfaces / bus specs: empty if no filtering based on bus interface / spec IDs is required; several can be separated by commas. |
||
Interface IDs |
Logger protocol: ‘ASAM CMP’ |
string |
Identifiers of the interfaces: empty if no filtering based on interface IDs is required; several can be separated by commas. |
||
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。 |
Jobs 🛈¶
ClearReceiveBuffer¶
Clears the ecu.test high-level receive buffer. Low-level buffers in the driver are not cleared.
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 |
发送同步消息的间隔。 |