dSPACE: ControlDesk¶

Herstellerinformationen

Hersteller	Webseite	Produktname	Version
dSPACE	http://www.dspace.com	ControlDesk Next Generation	dSPACE Release 2019-A - 2026-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¶

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	Standardwert	Gültige Werte	Typ	Beschreibung
ControlDesk Version	‚<auto>‘	[‚26.1‘, ‚25.2‘, ‚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: ‚offline‘: ‚Offline‘ ‚online‘: ‚Online‘ ‚measurement started‘: ‚Messung gestartet‘	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.
XIL-Ports beim Start der Konfiguration schließen	☐		bool	Schließt alle nicht verworfenen XIL-Port-Instanzen, je nach Porttyp.
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.

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.

Parameter

Name	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.

Parameter

Name	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.

Parameter

Name	Standardwert	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.

Parameter

Name	Standardwert	Gültige Werte	Typ	Beschreibung
BehaviorIfFileExists	‚error‘	[‚nothing‘, ‚replace‘, ‚error‘] Anzeigewerte: ‚nothing‘: ‚nothing‘ ‚replace‘: ‚replace‘ ‚error‘: ‚error‘	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.

Parameter

Name	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.

StartBusNavigatorLogger¶

Startet einen Logger im BusNavigator.

Parameter

Name	Standardwert	Gültige Werte	Typ	Beschreibung
FileExtension	‚asc‘	[‚asc‘, ‚csv‘, ‚pcapng‘]	string	Dateiendung der zu erstellenden Aufzeichnungsdatei. Muss zum Typ des Loggers passen, beispielsweise asc für CAN oder pcapng für Ethernet.
LoggerName			string	Name des Loggers
SystemName			string	Name des Systems, auf dem sich der Logger befindet.

StartMeasurement¶

Startet die Messung

StartOnlineCalibration¶

Schaltet die Kalibrierung global auf „online“

StartRecorder¶

Startet die Aufnahme über den angegebenen Recorder.

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

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.

StopBusNavigatorLogger¶

Stoppt einen Logger im BusNavigator. Gibt den Pfad der aufgezeichneten Datei zurück, bzw. None falls der Logger nicht aktiv war.

Parameter

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
LoggerName				string	Name des Loggers
SystemName				string	Name des Systems, auf dem sich der Logger befindet.

StopMeasurement¶

Stoppt die Messung

StopOnlineCalibration¶

Schaltet die Kalibrierung global auf „offline“

StopRecorder¶

Stoppt die Aufnahme des angegebenen Recorders.

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.

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.