dSPACE: ControlDesk¶
Bisheriger/interner Bezeichner: CONTROLDESKNG
Herstellerinformationen
Hersteller |
Webseite |
Produktname |
Version |
|---|---|---|---|
dSPACE |
ControlDesk Next Generation |
dSPACE Release 2019-A - 2025-A |
Kategorien
MDL 🛈 |
APL 🛈 |
BAN 🛈 |
BMA 🛈 |
SVC 🛈 |
DGN 🛈 |
FIU 🛈 |
EES 🛈 |
FCT 🛈 |
DBG 🛈 |
IMG 🛈 |
AUDIO 🛈 |
ENVSIM 🛈 |
ENVCOM 🛈 |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
✓ |
✓ |
✓ |
✓ |
✓ |
✓ |
Datenquellen
Dateiformat |
Kommentar |
|---|---|
*.sdf, *.trc |
dSPACE Variablenbeschreibung |
Signalaufnahmen 🛈
Dateiformat |
Kommentar |
|---|---|
*.mf4, *.mdf, *.mat, *.csv, *.idf |
Zur Verwendung in der Traceanalyse wird MDF4 (.mf4) empfohlen. Erzeugte CSV- und IDF-Dateien können nicht analysiert werden. |
Plattform
Betriebssystem |
Unterstützung |
|---|---|
Windows |
✓ |
Linux |
Ports¶
- Port BUSACCESS - GENERIC 🛈
- Port BUSACCESS - GENERIC_MAPPINGFILE 🛈
- Port BUSACCESS - GENERIC_SOCKETADAPTOR 🛈
- Port BUSACCESS - BUS_MANAGER 🛈
- Port SERVICEACCESS - SERVICE_MANAGER 🛈
- Port MODELACCESS - DEFAULT 🛈
- Port MODELACCESS - NO_HILAPI 🛈
- Port ELECTRICERRORSIM - DEFAULT 🛈
- Port FAILURESIM - DEFAULT 🛈
- Port FAILURESIM - CANWAY 🛈
- Port FAILURESIM - CANWAY BUSMANAGER 🛈
- Port APPLICATION 🛈
Besonderheiten¶
Standardmäßig verwendet ecu.test Zugriffe sowohl via XIL API als auch via ControlDesk API.
Der Port NO_HILAPI verwendet ausschließlich die ControlDesk API. Die Anbindung von ControlDesk 32 bit ist ausschließlich über den NO_HILAPI-Port möglich.
Um ein dSPACE Modell nur über die ASAM:XIL Schnittstelle anzusteuern, muss das Tool „dSPACE XIL API“ in der Testbenchkonfiguration verwendet werden.
Die BUS-Ports können nur verwendet werden, wenn gleichzeitig auch mindestens 1 Modellport angelegt wurde.
Standardmäßig werden alle aktivierten Plattformen des Experiments verbunden. Bitte beachten Sie, dass für ältere ControlDesk-Versionen teilweise nicht ermittelbar ist, ob eine Platform aktiviert wurde. In dem Fall kann die Tool-Einstellung „Toleriere deaktivierte Plattformen“ verwendet werden.
Einrichtung
Um sich mit einem bereits geöffneten ControlDesk zu verbinden, sollten ControlDesk Experiment und
ControlDesk Projekt auf dem Standardwert belassen werden. Das ControlDesk Modellverzeichnis muss
gesetzt sein, um es ecu.test zu ermöglichen, über die Testkonfiguration nach entsprechenden
sdf Dateien zu suchen. Alle anderen Einstellungen sind optional.
Eigenschaften 🛈¶
Name |
Verfügbar wenn |
Standardwert |
Gültige Werte |
Typ |
Beschreibung |
|---|---|---|---|---|---|
ControlDesk Version |
‚<auto>‘ |
[‚25.1‘, ‚24.2‘, ‚24.1‘, ‚23.2‘, ‚23.1‘, ‚22.2‘, ‚7.6‘, ‚7.5‘, ‚7.4‘, ‚7.3‘, ‚7.2‘, ‚7.1‘, ‚7.0‘, ‚6.4‘, ‚6.3‘, ‚6.2‘, ‚6.1‘, ‚6.0‘, ‚5.6‘, ‚5.5‘, ‚5.4‘, ‚5.3‘, ‚<auto>‘] |
string |
Produktversion von ControlDesk. |
|
Toolstate nach Laden des Experiments |
‚offline‘ |
[‚offline‘, ‚online‘, ‚measurement started‘] Anzeigewerte:
|
string |
Lässt ControlDesk im Offline Zustand, startet Online Kalibrierung oder startet die Messung. |
|
Aufnahmeformat |
‚MF4‘ |
[‚MF4‘, ‚MDF‘, ‚MAT‘, ‚CSV‘, ‚IDF‘] |
string |
Dateiformat der Aufzeichnung |
|
Fehlersimulationsverzeichnis |
<n/a> |
uri |
Basisverzeichnis für die Suche von Fehlersimulationsdateien. Optional, muss nur angegeben werden, wenn ein FIU- oder EES-Port verwendet wird. |
||
Simulation auf allen Plattformen starten |
☐ |
bool |
Simulation auf allen im Experiment registrierten Plattformen starten |
||
Duration-Trigger deaktivieren |
☐ |
bool |
Alle Duration-Trigger in der Messkonfiguration werden deaktiviert. |
||
Deaktivierte Plattformen tolerieren |
☐ |
bool |
Wenn diese Option gesetzt ist, werden die Ports auch gestartet, wenn eine Plattform deaktiviert ist. Andernfalls wird beim Start des Ports ein Fehler ausgegeben. |
||
ControlDesk Modell-Verzeichnis |
uri |
Basisverzeichnis für die Suche von Modelldateien (*.sdf) und ControlDesk Projektdateien (*.cdp) auf dem Toolhost. Pfad kann absolut oder relativ zum Basispfad des Toolhosts angegeben werden. |
|||
ControlDesk Projektdatei |
Bereits geladenes Projekt verwenden. |
uri |
ControlDesk Projektdatei (*.cdp), die geladen werden soll (relativ zum Modell-Verzeichnis oder absoluter Pfad) Der Platzhalter „<ModelFileDir>“ kann verwendet werden, um den Pfad relativ zum gewählten Modell anzugeben. |
||
ControlDesk Experiment |
‚Bereits geladenes Experiment verwenden.‘ |
string |
Name des ControlDesk Experiments (ohne Dateiendung) im angegebenen ControlDesk Projekt, das aktiviert werden soll. |
||
Tool beenden |
☐ |
bool |
Beendet ControlDesk beim Entladen der Konfiguration |
||
Timeout für Toolzugriffe ❲in Sek.❳ |
‚600‘ |
string |
Zeit nach der eine Anfrage an das Tool abgebrochen wird. |
Jobs 🛈¶
ActivateDCMFileAsWorkingPage¶
Lädt eine DCM- oder CDFX-Datei auf den ControlDesk-Rechner und aktiviert diese als aktive Working-Page.
Parametrierung
Parameter
Name |
Verfügbar wenn |
Standardwert |
Gültige Werte |
Typ |
Beschreibung |
|---|---|---|---|---|---|
DCMFile |
string |
Absoluter Pfad der DCM- oder CDFX-Datei, die in ControlDesk als aktive Working-Page geladen werden soll. |
|||
Platform |
[ONLINE] |
string |
Name der Plattform. Sub-Plattformen werden in der Darstellung <master>:<sub> angegeben. |
CallPyFunc¶
Aufruf von eigenen Pythonfunktionen im ControlDesk Interpreter. Ergebnis ist True, wenn die Funktion ausgeführt werden konnte, sonst False.
Parametrierung
Parameter
Name |
Verfügbar wenn |
Standardwert |
Gültige Werte |
Typ |
Beschreibung |
|---|---|---|---|---|---|
arg0 |
int |
Optional, 0. Python Funktionsargument |
|||
arg1 |
int |
Optional, 1. Python Funktionsargument |
|||
arg2 |
int |
Optional, 2. Python Funktionsargument |
|||
arg3 |
int |
Optional, 3. Python Funktionsargument |
|||
arg4 |
int |
Optional, 4. Python Funktionsargument |
|||
arg5 |
int |
Optional, 5. Python Funktionsargument |
|||
arg6 |
int |
Optional, 6. Python Funktionsargument |
|||
FilePath |
string |
Absoluter Pfad zur Python Datei |
|||
FuncName |
string |
Python Funktionsname |
|||
RunInThread |
False |
[False, True] |
bool |
Optional - für Ausführung in separatem Thread auf True setzen |
ExecPyFile¶
Ausführung einer Python-Datei im ControlDesk Interpreter. Ergebnis ist True, wenn das Skript ausgeführt werden konnte, sonst False.
Parametrierung
Parameter
Name |
Verfügbar wenn |
Standardwert |
Gültige Werte |
Typ |
Beschreibung |
|---|---|---|---|---|---|
FilePath |
uri |
Absoluter Pfad zur Python Datei |
|||
RunInThread |
False |
[False, True] |
bool |
Optional - für Ausführung in separatem Thread auf True setzen |
|
WorkingDirectory |
string |
Optional - Verzeichnis, in dem die Python-Datei ausgeführt werden soll |
FinishRecording¶
Überträgt die Aufnahme und löscht sie wahlweise aus dem Projektverzeichnis.
Parametrierung
Parameter
Name |
Verfügbar wenn |
Standardwert |
Gültige Werte |
Typ |
Beschreibung |
|---|---|---|---|---|---|
DownloadFile |
☑ |
bool |
Legt fest ob die Aufnahme aus dem Projektverzeichnis kopiert werden soll. |
||
RecorderName |
string |
Der Name des Recorders in ControlDesk |
|||
RemoveFile |
☐ |
bool |
Legt fest ob die Aufnahme aus dem Projektverzeichnis entfernt werden soll. |
||
TargetDir |
string |
Legt fest wo die übertragene Aufnahme abgelegt werden soll. Angabe als absoluter Pfad oder leer zur Ablage im Reportverzeichnis. |
ImportDCMFile¶
Lädt eine DCM- oder CDFX-Datei auf den ControlDesk-Rechner und importiert diese als neues Data Set.
Parametrierung
Parameter
Name |
Verfügbar wenn |
Standardwert |
Gültige Werte |
Typ |
Beschreibung |
|---|---|---|---|---|---|
BehaviorIfFileExists |
‚error‘ |
[‚nothing‘, ‚replace‘, ‚error‘] Anzeigewerte:
|
string |
Falls die Datei bereits als Data-Set in ControlDesk existiert, soll der Job entweder nichts tun, das Data-Set ersetzen oder einen Fehler werfen. |
|
DCMFile |
string |
Absoluter Pfad der DCM- oder CDFX-Datei, die in ControlDesk importiert werden soll. |
|||
DownloadOnCalibStart |
☑ |
bool |
Ist diese Eigenschaft auf „True“ gesetzt, wird die Option „Download on Calibration Start“ für das importierte Data Set gesetzt. |
||
Platform |
[ONLINE] |
string |
Name der Plattform. Sub-Plattformen werden in der Darstellung <master>:<sub> angegeben. |
||
WriteToWorkingDataSet |
☐ |
bool |
Ist diese Eigenschaft auf „True“ gesetzt, wird die Methode „Write to working data set“ für das importierte Data Set ausgeführt. |
RemoveDataSet¶
Entfernt DataSet(s) aus dem aktuellen Projekt.
Parametrierung
Parameter
Name |
Verfügbar wenn |
Standardwert |
Gültige Werte |
Typ |
Beschreibung |
|---|---|---|---|---|---|
DataSetPattern |
string |
Dateiname des DataSet. (‘*‘ und ‚?‘ können als Wildcard verwendet werden) Trifft Ausdruck auf mehrere Einträge zu, so werden alle entfernt |
|||
Platform |
[ONLINE] |
string |
Name der Plattform. Sub-Plattformen werden in der Darstellung <master>:<sub> angegeben. |
||
removeFromDisk |
☑ |
bool |
Ist diese Eigenschaft auf „True“ gesetzt, wird ebenfalls von der Festplatte gelöscht, sonst nur aus dem Projekt entfernt. |
StartMeasurement¶
Startet die Messung
StartOnlineCalibration¶
Schaltet die Kalibrierung global auf „online“
StartRecorder¶
Startet die Aufnahme über den angegebenen Recorder.
Parametrierung
Parameter
Name |
Verfügbar wenn |
Standardwert |
Gültige Werte |
Typ |
Beschreibung |
|---|---|---|---|---|---|
RecorderName |
string |
Der Name des Recorders in ControlDesk |
StartSimulation¶
Startet die Simulation, welche auf der angegebenen Plattform läuft
Parametrierung
Parameter
Name |
Verfügbar wenn |
Standardwert |
Gültige Werte |
Typ |
Beschreibung |
|---|---|---|---|---|---|
PlatformName |
string |
Der Name der Plattform im Platform Manager von ControlDesk. „ALL“ für alle im Experiment registrierten Plattformen. |
StopMeasurement¶
Stoppt die Messung
StopOnlineCalibration¶
Schaltet die Kalibrierung global auf „offline“
StopRecorder¶
Stoppt die Aufnahme des angegebenen Recorders.
Parametrierung
Parameter
Name |
Verfügbar wenn |
Standardwert |
Gültige Werte |
Typ |
Beschreibung |
|---|---|---|---|---|---|
RecorderName |
string |
Der Name des Recorders in ControlDesk |
StopSimulation¶
Stoppt die Simulation, welche auf der angegebenen Plattform läuft.
Parametrierung
Parameter
Name |
Verfügbar wenn |
Standardwert |
Gültige Werte |
Typ |
Beschreibung |
|---|---|---|---|---|---|
PlatformName |
string |
Der Name der Plattform im Platform Manager von ControlDesk. „ALL“ für alle im Experiment registrierten Plattformen. |