Port APPLICATION - XCP-ETH ✦¶
Port für Applikationszugriff mit XCP über Ethernet.
Stimulation¶
Dieser Port besitzt keine Stimulus-Fähigkeiten.
Eigenschaften 🛈¶
Name |
Verfügbar wenn |
Standardwert |
Gültige Werte |
Typ |
Beschreibung |
|---|---|---|---|---|---|
TCP/IP-Stack |
LwIP + Vector XL API |
[LwIP + Vector XL API] |
string |
Diese Option dient nur zur Information und kann nicht geändert werden. |
|
Physical Layer ❲Netzwerkzugriff❳ |
|||||
Port |
string |
Name des Ports im Netzwerk. In der Vector Hardware Config muss hierzu der Network-based mode aktiviert sein. |
|||
MAC-Adresse ❲Client❳ |
‚02:00:4C:4F:4F:50‘ |
string |
String (Format: 02:00:4C:4F:4F:50), ‚default‘ wenn eine Standard-MAC-Adresse verwendet werden soll |
||
VLAN-Einstellungen ❲IEEE 802.1Q❳ |
TCP/IP stack is LwIP |
||||
VLAN-Modus |
TCP/IP stack is LwIP |
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 |
TCP/IP stack is LwIP » 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. |
|
IP-Einstellungen |
|||||
IP-Version |
IPv4 |
[IPv4, IPv6] |
string |
Auswahl der verwendeten IP Version |
|
IP-Adresse ❲Client❳ |
TCP/IP stack is LwIP |
string |
IP-Adresse, die clientseitig verwendet werden soll. Sie muss sich im gleichen Subnetz befinden wie die IP-Adresse des Device under Test und darf nicht identisch sein mit der IP-Adresse eines anderen Teilnehmers oder der IP-Adresse, die das Betriebssystem für den ausgewählten Netzwerkadapter festgelegt hat. |
||
Subnetzmaske / Präfixlänge |
TCP/IP stack is LwIP |
‚default‘ |
string |
Für IPv4 Adressen kann eine Subnetzmaske oder eine Präfixlänge angeben werden (Format: ‚255.255.255.0‘ oder ‚24‘), ‚default‘ wenn die Standard-Subnetzmaske der Netzklasse zur angegebenen IP-Adresse (Client) verwendet werden soll. Bei der Verwendung von IPv6 werden lediglich Präfixlängen akzeptiert. ‚default‘ wird für IPv6 nicht unterstützt. |
|
Gateway-Adresse |
TCP/IP stack is LwIP |
string |
IP-Adresse des Gateways, das das Erreichen von Hosts außerhalb des lokalen Subnetzes ermöglicht. Leer lassen falls kein Gateway benötigt wird |
||
TCP/UDP-Einstellungen |
|||||
Source-Port-Range |
‚default‘ |
string |
Bereich an lokalen Ports, die beim Verbindungsaufbau verwendet werden sollen. Der Wert ‚default‘ führt dazu, dass zufällige Ports gewählt werden. Beispiel: 123,456-567,789 |
||
XCP-Einstellungen |
|||||
Transportschicht-Einstellungen |
auto |
[auto, manual] Anzeigewerte:
|
string |
Im ‚auto‘-Modus müssen die Einstellungen für die Transportschicht (Protokoll, Serveradresse und Port) in der A2L-Datei spezifiziert und in der Testkonfiguration die Transportschicht ausgewählt werden. Diese Werte werden dann automatisch verwendet. Im Modus ‚manuell‘ können die Werte selbst festgelegen werden, insbesondere wenn einige dieser Werte nicht über die Testkonfiguration ermittelt werden können. |
|
IP-Adresse ❲Server❳ |
Transportschicht-Einstellungen: ‚manual‘ |
string |
Adresse des XCP-Servers |
||
Port ❲Server❳ |
Transportschicht-Einstellungen: ‚manual‘ |
5555 |
int |
Port des XCP-Servers |
|
Protokoll |
Transportschicht-Einstellungen: ‚manual‘ |
‚TCP‘ |
[‚UDP‘, ‚TCP‘] |
string |
Transportprotokoll für die Datenübertragung |
Verbindungsaufbau |
‚OnPortStart‘ |
[‚OnPortStart‘, ‚OnPortConfigure‘, ‚Job‘] Anzeigewerte:
|
string |
Zeitpunkt, zu dem die Verbindung zum XCP-Slave hergestellt werden soll OnPortConfigure: Online-Informationen sind verfügbar, sobald die Konfigurationen gestartet werden. OnPortStart und Job: Es sind nur Informationen aus den A2L-Dateien verfügbar. |
|
Auto-Reconnect |
☐ |
bool |
Wenn diese Option aktiviert ist, wird die Verbindung zum XCP-Slave vor jedem Lese-/Schreib-Testschritt geprüft. Falls die Verbindung nicht mehr besteht, wird versucht, sie wiederherzustellen. Gelingt dies, werden alle Puffer gelöscht, die letzte Calibration-Page wiederhergestellt, die Messungen und Aufzeichnungen fortgesetzt und anschließend der Testschritt ausgeführt. Schlägt die Wiederherstellung der Verbindung fehl, wird bei Lese-Testschritten NotPresent zurückgegeben, während bei Schreib-Testschritten ein Fehler gemeldet wird. Die Aktivierung dieser Funktion kann die Ausführung der betroffenen Testschritte verlangsamen. |
||
DAQ-Variablen erst bei Disconnect abmelden |
☐ |
bool |
Registriert DAQ-Variablen, sobald die Portverbindung hergestellt ist. Sobald die DAQ-Variablen registriert sind, stehen sie die gesamte Testausführung zur Verfügung. Nach der Trennung der Verbindung werden die DAQ-Variablen entladen. |
||
XAM-Datei |
DAQ-Variablen erst bei Disconnect abmelden: ‚True‘ |
string |
Alle in der .xam-Datei enthaltenen Mess- und Kalibriervariablen werden bei Herstellung der Portverbindung zur Aufzeichnung und als DAQ-Variablen registriert. Variablen mit derselben Kennung werden nicht doppelt registriert. |
||
Standardmessraster |
‚Tool-Default‘ |
string |
Angabe des Messrasters, das als Ausweichlösung verwendet wird, falls für den Testschritt kein Raster angegeben ist (“*“ und „?“ können als Wildcard verwendet werden). „Tool-Default“ führt zur Verwendung des Standardrasters des Tools |
||
Wertebereichsprüfung überspringen |
☐ |
bool |
Diese Option aktivieren um die normalerweise bei der Umrechnung zwischen physikalischem Zahlenwert und Rohwert durchgeführte Prüfung auf Wertebereichsgrenzen zu unterdrücken. |
||
Verwende Seed und Key |
☐ |
bool |
Definieren Sie die Ressourcen, für die Sie Zugriffsrechte erhalten möchten, und den Dateinamen der 32-Bit-DLL, die im Toolhost-Pfad platziert ist. |
||
Seed-and-Key Library Pfad ❲dll❳ |
Verwende Seed und Key: ‚True‘ |
SeedNKeyXcp.dll |
uri |
Pfad zu der Bibliothek auf dem Toolhost, die die Funktionen Seed und Key enthält. Die Verwendung der DLL verlängert die Startzeit der Konfiguration. |
|
Freizuschaltende Ressourcen |
Verwende Seed und Key: ‚True‘ |
5 |
int |
Freischaltung der Ressourcen als Bitmaske: CAL/PAG : 1 CAL/PAG DAQ : 5 CAL/PAG STIM : 9 CAL/PAG PGM : 17 CAL/PAG DAQ STIM : 13 CAL/PAG DAQ PGM : 21 CAL/PAG STIM PGM : 25 CAL/PAG DAQ STIM PGM: 29 DAQ : 4 DAQ STIM : 12 DAQ PGM : 20 DAQ STIM PGM : 28 STIM : 8 STIM PGM : 24 PGM : 16 Die Dauer der Freischaltung ist Abhändig von der Anzahl an freizuschaltenden Ressourcen. |
|
Aufnahmemodus |
‚immediate‘ |
[‚immediate‘, ‚two-stage‘] Anzeigewerte:
|
string |
Aufnahmemodus ‚direkt‘ schreibt eine signalbasierte MDF4-Datei während der Testausführung. Dieser Modus verwendet XCP-Slave-Zeitstempel, wenn möglich. Aufnahmemodus ‚zweistufig‘ erzeugt erst eine rohe Bus/Ethernet-Aufnahme und wandelt diese nach Ende der Testausführung in eine signalbasierte MDF4-Datei um. Dieser Modus kann besser mit sehr vielen Signalen umgehen. Er verwendet die Eingangszeitstempel der Frames, auch wenn XCP-Slave-Zeitstempel verfügbar wären. Der Testfallstart wird als Startzeitpunkt in den Metadaten der MDF4-Datei gespeichert. |
|
Standard-Polling-Zyklus [ms] |
-1 |
int |
Standard Pollingzyklus in Millisekunden. Alle Aufnahmen mit dem Raster „Polling“ nutzen den hier angegebenen Wert, er wird verwendet wenn im Mapping kein Pollingzyklus im Raster angegeben wird. Der Wert -1 deaktiviert die betreffende Abfrage (Ergebnisse aus expliziten Lesevorgängen im Testfall werden jedoch weiterhin in die Aufzeichnung übernommen). |
Jobs 🛈¶
Connect¶
Baut die Verbindung zum XCP-Slave auf.
Disconnect¶
Trennt die Verbindung zum XCP-Slave.
FreezeCalibrationParameters¶
Setzt alle angegebenen Segmente am Slave in den Modus „Freeze“ und fordert den Slave anschließend auf, die Kalibrierungsdaten im nichtflüchtigen Speicher zu speichern.
Parametrierung
Parameter
Name |
Verfügbar wenn |
Standardwert |
Gültige Werte |
Typ |
Beschreibung |
|---|---|---|---|---|---|
segments |
[0] |
object |
Liste ganzzahliger Segment-IDs |
Rückgabewert
Name |
Verfügbar wenn |
Standardwert |
Gültige Werte |
Typ |
Beschreibung |
|---|---|---|---|---|---|
Return |
[False, True] |
bool |
True wenn alles geklappt hat. False falls irgendein Fehler aufgetreten ist (Details siehe Log-Ausgaben). |
GetEPKFromECU¶
Gibt die EPROM ID (EPK) der ECU zurück.
Parametrierung
Rückgabewert
Name |
Verfügbar wenn |
Standardwert |
Gültige Werte |
Typ |
Beschreibung |
|---|---|---|---|---|---|
epk |
ByteStream |
ByteStream, der die ID enthält |
GetStatus¶
Gibt den Schutzstatus der Ressourcen des XCP Slave zurück. Blockierte Ressourcen können über die TBC Settings oder mit dem Job „UnlockRessource“ freigeschalten werden.
Parametrierung
Rückgabewert
Name |
Verfügbar wenn |
Standardwert |
Gültige Werte |
Typ |
Beschreibung |
|---|---|---|---|---|---|
statusDict |
object |
Dictionary mit dem Zugriffschutzstatus. |
ReadDataByAddress¶
Liest Daten aus dem Speicher, beginnend an der angegebenen Adresse.
Parametrierung
Parameter
Name |
Verfügbar wenn |
Standardwert |
Gültige Werte |
Typ |
Beschreibung |
|---|---|---|---|---|---|
address |
int |
Startadresse von der gelesen wird |
|||
addrExt |
0 |
int |
Adresserweiterung des Segments, zu dem die Adresse gehört |
||
length |
int |
Anzahl der zu lesenden Bytes |
Rückgabewert
Name |
Verfügbar wenn |
Standardwert |
Gültige Werte |
Typ |
Beschreibung |
|---|---|---|---|---|---|
data |
ByteStream |
Gelesene Daten als ByteStream |
ReadValue¶
Liest eine bestimmte Mess- oder Kalibriergröße und gibt deren logischen Wert zurück.
Parametrierung
Parameter
Name |
Verfügbar wenn |
Standardwert |
Gültige Werte |
Typ |
Beschreibung |
|---|---|---|---|---|---|
name |
string |
Symbolischer Name der Mess- oder Kalibriergröße, wie in der A2L-Datei definiert. |
Rückgabewert
Name |
Verfügbar wenn |
Standardwert |
Gültige Werte |
Typ |
Beschreibung |
|---|---|---|---|---|---|
value |
float |
Logischer Wert der Mess- oder Kalibriergröße. |
SwitchPage¶
Wechselt die aktive Seite.
Parametrierung
Parameter
Name |
Verfügbar wenn |
Standardwert |
Gültige Werte |
Typ |
Beschreibung |
|---|---|---|---|---|---|
page |
[ONLINE] |
string |
Seite, auf die gewechselt werden soll |
UnlockResource¶
Schaltet eine Ressource über den Seed-and-Key Mechanismus frei.
Parametrierung
Parameter
Name |
Verfügbar wenn |
Standardwert |
Gültige Werte |
Typ |
Beschreibung |
|---|---|---|---|---|---|
requestedResourcesMask |
5 |
int |
Ressourcen, die freigeschaltet werden sollen, als Bitmaske CAL/PAG : 1 CAL/PAG DAQ : 5 CAL/PAG STIM : 9 CAL/PAG PGM : 17 CAL/PAG DAQ STIM : 13 CAL/PAG DAQ PGM : 21 CAL/PAG STIM PGM : 25 CAL/PAG DAQ STIM PGM: 29 DAQ : 4 DAQ STIM : 12 DAQ PGM : 20 DAQ STIM PGM : 28 STIM : 8 STIM PGM : 24 PGM : 16 |
||
seedNKeyLib |
SeedNKeyXcp.dll |
uri |
Pfad zu der Bibliothek auf dem Toolhost, die die Funktionen Seed und Key enthält. |
Rückgabewert
Name |
Verfügbar wenn |
Standardwert |
Gültige Werte |
Typ |
Beschreibung |
|---|---|---|---|---|---|
unlockedResourcesMask |
int |
Bitmaske der freigeschalteten Ressourcen |
WriteDataByAddress¶
Schreibt Daten in den Speicher beginnend an der angegebenen Adresse. Mit Vorsicht verwenden und Eingabe gegenprüfen. Fehler können zu ernsthaften Problemen mit dem XCP-Slave führen.
Parametrierung
Parameter
Name |
Verfügbar wenn |
Standardwert |
Gültige Werte |
Typ |
Beschreibung |
|---|---|---|---|---|---|
address |
int |
Startadresse, an die geschrieben wird |
|||
addrExt |
0 |
int |
Adresserweiterung des Segments, zu dem die Adresse gehört |
||
data |
ByteStream |
Zu schreibende Daten als ByteStream |
WriteValue¶
Schreibt einen logischen Wert in eine bestimmte Mess- oder Kalibriergröße.
Parametrierung
Parameter
Name |
Verfügbar wenn |
Standardwert |
Gültige Werte |
Typ |
Beschreibung |
|---|---|---|---|---|---|
name |
string |
Symbolischer Name der Mess- oder Kalibriergröße, wie in der A2L-Datei definiert. |
|||
value |
float |
Logischer Wert der Mess- oder Kalibriergröße. |