Port SERVICEACCESS - SERVICE-PCAP-PASSIVE¶
Port that supports passive Ethernet service communication based on an own PCAP-based network stack
此端口要求安装 PCAP 驱动。
此端口要求安装 PCAP 驱动。
Stimulation¶
此端口不具备激励能力。
Properties 🛈¶
Name |
在以下情况下可用 |
默认值 |
有效值 |
Type |
Description |
|---|---|---|---|---|---|
物理层 ❲网络访问❳ |
|||||
网络接口卡 |
[ONLINE] |
string |
用于接收网络报文的网卡或网络适配器 |
||
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. |
||
Logger Protocol Settings |
|||||
Logger protocol |
[, ASAM CMP, PLP/TECMP] |
string |
Use a logger protocol such as ASAM CMP. Ethernet frames contained in the logger messages are then extracted. |
||
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 |
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. |
||
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. |
||
Interface IDs / Bus Spec IDs |
Logger protocol: ‘PLP/TECMP’ |
string |
Identifiers of the interfaces / bus specs: empty if no filtering based on interface / bus spec IDs is required; several can be separated by commas. |
||
Use IPC |
Logger protocol: ‘PLP/TECMP’ |
☐ |
bool |
Use IPC instead of SOME/IP |
|
Outer VLAN mode |
disable |
[disable, single tagging, single tagging (any ID)] |
string |
If set to ‘single tagging’, take an additional IEEE 802.1Q tag outside the logger protocol into account and filter by the specified VLAN id; or if set to ‘single tagging (any ID)’, the tag itself must be present but the VLAN id is not relevant. |
|
Outer VLAN id |
Outer VLAN mode: ‘single tagging’ |
0 |
int |
Filter incoming packets by this VLAN id, so only packets with a matching VLAN id will pass. |
|
VLAN Settings ❲IEEE 802.1Q❳ |
IPC is disabled |
||||
VLAN mode |
IPC is disabled |
auto |
[auto, disable, single tagging] |
string |
如果应使用数据库中的 VLAN ID,则设为 ‘auto’;如果不应使用 VLAN,则设为 ‘disable’;如果应指定固定的 VLAN ID,则设为 ‘single tagging’ |
VLAN id |
IPC is disabled » VLAN mode: ‘single tagging’ |
0 |
int |
如果传入的数据包带有 VLAN 标签,则会对其进行过滤,只有带有该 VLAN ID 的数据包才能通过。不带任何 VLAN 标签的传入数据包也会通过过滤器。 |
|
SOME/IP Settings |
IPC is disabled |
||||
SD Multicast IP |
IPC is disabled |
‘auto’ |
string |
Multicast IP address to be used for Service Discovery. Set it to ‘auto’ if the value from the database should be used |
|
SD Port |
IPC is disabled |
‘auto’ |
string |
UDP port to be used for Service Discovery. Set it to ‘auto’ if the value from the database should be used. |
|
Behavior in case of protocol errors |
IPC is disabled |
‘NotPresent’ |
[‘ERROR’, ‘NotPresent’] |
string |
Behavior of the test step when a protocol error occurs (e.g. the control unit does not respond). By default ‘NotPresent’ is returned. Alternatively, the test step can be evaluated with ‘ERROR’. |
Jobs 🛈¶
AddFilter¶
Receive the specified interface ID / Bus Spec ID in addition to those specified in the test bench configuration, until the end of the test
Parameterization
Parameter
Name |
在以下情况下可用 |
默认值 |
有效值 |
Type |
Description |
|---|---|---|---|---|---|
BusSpecID |
int |
Interface ID / Bus Spec ID |
LearnBPFilter¶
Learns the endpoints (source IP address and port) of all needed services. Endpoints that are encountered within the specified timeout, but are not needed, will be transformed into a negative Berkeley Packet Filter which drops corresponding network packets. This filter will be used for reception in the test case as well as for pcap(ng) recording via this port. The negative filter may be extended by a user-defined part using BPF syntax. If the recording is already running, the learned filter has no influence on it.
注意:该作业已不再需要,因此不再受支持。
Parameterization
Parameter
Name |
在以下情况下可用 |
默认值 |
有效值 |
Type |
Description |
|---|---|---|---|---|---|
clearCache |
False |
[False, True] |
bool |
Resets the cache of a previous call. The endpoints which exist in the network will therefore be learned anew. But the call will take longer in this case. |
|
timeout |
5 |
float |
Time in seconds (float) until learning will be stopped |
||
userBpf |
string |
Optional extension of the negative filter. Please provide positive in BPF syntax what should also be discarded by the filter, e.g. ‘vlan 42’ |
返回值
Name |
在以下情况下可用 |
默认值 |
有效值 |
Type |
Description |
|---|---|---|---|---|---|
result |
object |
Dictionary containing neededEndpoints, otherEndpoints (for the negative filter), bpf (the resulting filter Expression), bpfLearn (filter expression temporarily used while learning) |
StartReceiving¶
Manually starts the reception of network packets