Port SERVICEACCESS - SERVICE-PCAP-PASSIVE¶
Port zur passiven Unterstützung von Ethernet-Services auf Grundlage eines PCAP-basierten Netzwerkstacks
Dieser Port erfordert, dass ein PCAP-Treiber installiert ist.
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 |
|---|---|---|---|---|---|
Physical Layer ❲Netzwerkzugriff❳ |
|||||
Netzwerkadapter |
[ONLINE] |
string |
Netzwerkadapter, der zum Empfang von Netzwerkpaketen verwendet werden soll |
||
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. |
||
Loggerprotokoll-Einstellungen |
|||||
Loggerprotokoll |
[, ASAM CMP, PLP/TECMP] |
string |
Ein Loggerprotokoll wie z.B. ASAM CMP verwenden. In den Loggernachrichten enthaltene Ethernet-Frames werden dann extrahiert. |
||
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 |
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. |
||
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. |
||
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. |
||
IPC verwenden |
Loggerprotokoll: ‚PLP/TECMP‘ |
☐ |
bool |
IPC anstelle von SOME/IP verwenden |
|
Äußerer VLAN-Modus |
disable |
[disable, single tagging, single tagging (any ID)] |
string |
Wenn auf ‚single tagging‘ gesetzt, ein zusätzliches VLAN-Tag außerhalb des Loggerprotokolls beachten und auf die angegebene VLAN-ID filtern; bei ‚single tagging (any ID)‘ muss das Tag selbst zwar vorhanden sein, die VLAN-ID ist jedoch nicht relevant. |
|
Äußere VLAN-ID |
Äußerer VLAN-Modus: ‚single tagging‘ |
0 |
int |
Eingehende Pakete anhand dieser VLAN-ID filtern, sodass nur Pakete mit passender VLAN-ID beachtet werden. |
|
VLAN-Einstellungen ❲IEEE 802.1Q❳ |
IPC is disabled |
||||
VLAN-Modus |
IPC is disabled |
auto |
[auto, disable, single tagging] |
string |
Mit ‚auto‘ wird die Einstellung aus der Datenbank übernommen. ‚disable‘ für deaktiviertes VLAN. Oder ‚single tagging‘, wenn eine feste VLAN-ID angegeben werden soll |
VLAN-ID |
IPC is disabled » VLAN-Modus: ‚single tagging‘ |
0 |
int |
Wenn eingehende Pakete ein VLAN-Tag besitzen, werden sie gefiltert und nur Pakete mit dieser VLAN-ID werden akzeptiert. Eingehende Pakete ohne VLAN-Tag werden ebenfalls akzeptiert. |
|
SOME/IP-Einstellungen |
IPC is disabled |
||||
SD-Multicast-IP |
IPC is disabled |
‚auto‘ |
string |
Multicast-IP-Adresse für die Service-Discovery: ‚auto‘ wenn der Wert aus der Datenbank übernommen werden soll |
|
SD-Port |
IPC is disabled |
‚auto‘ |
string |
UDP-Port für die Service-Discovery: ‚auto‘ wenn der Wert aus der Datenbank übernommen werden soll. |
|
Verhalten bei Protokollfehlern |
IPC is disabled |
‚NotPresent‘ |
[‚ERROR‘, ‚NotPresent‘] |
string |
Verhalten des Testschritts wenn ein Protokollfehler auftritt (z.B. das Steuergerät antwortet nicht). Standardmäßig wird ‚NotPresent‘ zurück gegeben. Alternativ kann der Testschritt mit ‚ERROR‘ bewertet werden. |
Jobs 🛈¶
AddFilter¶
Die angegeben Interface-ID / BusSpec-ID zusätzlich zu den in der Testbench-Konfiguration angegebenen bis zum Testfallende empfangen
Parametrierung
Parameter
Name |
Verfügbar wenn |
Standardwert |
Gültige Werte |
Typ |
Beschreibung |
|---|---|---|---|---|---|
BusSpecID |
int |
Interface-ID / BusSpec-ID |
LearnBPFilter¶
Lernt für alle benötigten Services deren Endpunkte (Quell-IP-Adresse und -Port). Wandelt alle während des Timeouts erkannten nicht benötigten Endpunkte in einen negativen Berkeley-Packet-Filter um, der sowohl für den Empfang im Testfall als auch für die pcap(ng)-Aufzeichnung über diesen Port alle passenden Netzwerkpakete verwirft. Der Negativ-Filter kann in BPF-Syntax nutzerdefiniert erweitert werden. Läuft bereits die Aufnahme, so hat der gelernte Filter keinen Einfluss darauf.
Hinweis: Der Job wird nicht mehr unterstützt weil er nicht mehr nötig ist.
Parametrierung
Parameter
Name |
Verfügbar wenn |
Standardwert |
Gültige Werte |
Typ |
Beschreibung |
|---|---|---|---|---|---|
clearCache |
False |
[False, True] |
bool |
Setzt den Cache eines vorherigen Aufrufs zurück, sodass die im Netzwerk vorhandenen Endpunkte neu angelernt werden. Der Aufruf dauert hierdurch jedoch länger. |
|
timeout |
5 |
float |
Zeit in Sekunden (float) bis das Anlernen beendet wird |
||
userBpf |
string |
Optionale Erweiterung des Negativ-Filters. Hier bitte in BPF-Syntax positiv angeben, was zusätzlich weggefiltert werden soll, z.B. ‚vlan 42‘ |
Rückgabewert
Name |
Verfügbar wenn |
Standardwert |
Gültige Werte |
Typ |
Beschreibung |
|---|---|---|---|---|---|
result |
object |
Dictionary mit neededEndpoints, otherEndpoints (für den Negativ-Filter), bpf (resultierender Filterausdruck), bpfLearn (temporär verwendeter Filterausdruck während des Lernens) |
StartReceiving¶
Startet den Empfang von Netzwerkpaketen manuell