dSPACE CONTROLDESK

ControlDesk
原廠範例(Demos)詳細說明

ControlDesk 安裝隨附一系列原廠範例,涵蓋量測校正、匯流排、ECU 診斷、儀表、訊號編輯、電氣錯誤模擬與自動化。多數範例不需連接真實硬體即可體驗。本文逐一詳解各範例的內容、所需模組與操作重點。

Demo Projects Automation Demos Demo Programs Release 2025-B

ControlDesk 是 dSPACE 用於量測、校正、監控與診斷的實驗與儀表工具。其安裝隨附三類原廠範例:Demo Projects(示範專案)、Automation Demos(自動化示範腳本)與 Demo Programs(示範程式)。本文整理自 dSPACE 手冊 ControlDesk Introduction and Overview(RLS2025-B)之「Demos for ControlDesk」章節。

1. 如何取得與開啟範例

使用範例前,須先將 demo 專案複製到使用者的 Documents 資料夾(每位使用者於安裝後僅需複製一次;若 Documents 已有 demo 則不覆寫,只補齊缺少者):

透過圖形介面

File ribbon → Options → User Settings 頁 → 按 Copy Demos。

透過自動化介面

於 ControlDesk Interpreter 窗格輸入:

Application.UserSettings.CopyDemos()
  • 開啟:File ribbon → Open → Project + Experiment → 於 Select a Project 對話框選取專案與 experiment → OK。
  • 還原:安裝目錄的 .\Demos\Backups 子資料夾為每個 demo 提供一個 ZIP 封存;以 Open Project + Experiment from Backup 指令解開還原。
  • 授權:ControlDesk 由多個模組組成,執行範例須先安裝對應授權(如 Bus Navigator、Signal Editor、Failure Simulation Package 等)。

2. Demo Projects 一覽

示範專案 重點 需真實硬體?
Bus Navigator Demo匯流排監控、記錄、重播、報文傳送(Bus Navigator 功能)否(模擬匯流排介面)
CalDemo量測與校正功能否(模擬 ECU)
ECU Diagnostics DemoECU 診斷功能(MCD-3D)否(模擬 ECU)
Instrumentation Demo3-D Viewer 儀表否
Real-Time Application Demos量測與校正,搭配 dSPACE 即時硬體 / VEOS是(或 VEOS)
Relay Maintenance DemoSCALEXIO 系統繼電器清潔是(SCALEXIO)
Signal Editor DemosSignal Editor 訊號產生器功能是(或 VEOS)
XIL API EESPort Demo電氣錯誤模擬(ASAM AE XIL API)否(Offline Mode)

功能涵蓋矩陣(節錄)

功能 Bus Nav CalDemo ECU Diag EESPort RT App Signal Ed Instr.
匯流排通訊✓—✓————
校正與量測—✓✓—✓——
ECU 診斷——✓————
電氣錯誤模擬———✓———
Signal Editor 激勵—————✓—
變數映射(Variable mapping)————✓——
3-D Viewer——————✓

3. 各 Demo Project 詳解

Bus Navigator Demo(BusNavigatorDemo)

需求模組:ControlDesk + Bus Navigator Module。專案含 Monitoring, Logging, Replay experiment,基於虛擬 CAN 匯流排(不需真實 CAN 介面)。

組成:兩個 CAN Bus Monitoring 裝置——Transceiver Node(發送端 ECU 控制器)與 Receiver Node(接收端)。Layouts:dashboard、mode signals、transmit messages。附 CANreplay.asc 重播檔與 CANlogging.asc 記錄檔。示範:Go Online 時由事件處理器自動啟動 CAN 重播(Transceiver)與監控/記錄(Receiver);透過 transmit messages layout 的 TX Instrument 單次或週期傳送 CAN 報文。

CalDemo

需求模組:僅 ControlDesk(不需 ECU Interface Module)。讓你在無真實 ECU 下體驗量測與校正。開啟時自動啟動內建的模擬 CalDemo ECU。

三個 experiment(各含一種存取裝置):XCP on CAN(虛擬 CAN 通道)、XCP on Ethernet(localhost loopback)、DCI-GSI2(無實體 DCI-GSI2 時仍可經 loopback 上線)。Layouts:bit signals、signal generator、throttle controller、working point(Table Editor)、xy plotter(XY Plotter)。示範:Start Measuring → 開啟 Working Page → 於 throttle controller layout 將 SignalForm 改為 triangle,於 Time Plotter 觀察變化。

ECU Diagnostics Demo(DiagDemo)

需求模組:僅 ControlDesk。含 ECU Diagnostics (MCD-3D v2.0.2) experiment,無真實 ECU 亦可執行 ECU 診斷與診斷變數量測校正。

裝置:ECU Diagnostics (MCD-3D v2.0.2) 裝置(經虛擬 CAN 存取 CalDemo ECU,自動載入 demo ODX 資料庫)+ CAN Bus Monitoring 裝置。Layouts:diagnostic trouble codes(含 Fault Memory Instrument)、diagnostic variables、diagnostics(Diagnostics Instrument)。示範:執行 UDS 診斷 job(如 Security Access:DiagnosticSessionControl → SecurityAccessRequestSeed → SendKey)、執行 WriteDataByIdentifier 服務改寫 CurrentGear、設定/清除 DTC、以 Bus Navigator 監控請求(0x001)/回應(0x002) 報文。

Instrumentation Demo

需求模組:ControlDesk。含 3-D Viewer experiment,示範 3-D Viewer 儀表。

Layouts:Spring Demo(以加在 Push Button 的 instrument script 計算彈簧質塊運動,點 Start/Stop Simulation 控制)與 Street Scene(自車在賽道上行駛超越他車,示範各類 item 型別與屬性,以 TimeCursorControl 群組控制)。

Real-Time Application Demos

需求模組:ControlDesk。搭配連接主機的 dSPACE 即時硬體或 VEOS,示範全部量測校正功能。應用實作一個節流閥控制(throttle control)。

各平台專案:DS1104、DS1202(MicroLabBox)、DS1401(MicroAutoBox II)、DS1403(MicroAutoBox III)、MicroLabBox II、Scalexio、Scalexio MC、VEOS。機制:開啟時自動載入描述量測變數/參數的 SDF 並參照可執行檔;採用變數映射(variable mapping)——以 framework labels 搭配 ASAM XIL mapping 檔,將 experiment 層變數名與模型層變數名解耦(layout/mapping 檔位於 .\Demos\RTApplications\)。執行:先依連接硬體設定 platform,再 Start Measuring 下載並啟動應用。

Relay Maintenance Demo

需求:SCALEXIO 系統。Relay Maintenance 專案用於在 SCALEXIO 系統執行繼電器清潔——為避免平常未切換的繼電器接點黏著,建議每月執行一次。

Signal Editor Demos

需求模組:ControlDesk + Signal Editor Module。示範以 Signal Editor 建立的訊號產生器對即時硬體進行激勵。

各平台專案:SignalEditor_DS1202、_MicroLabBox II、_DS1401、_DS1403、_SCALEXIO、_VEOS。機制:應用(衍生自 RT Application Demo 的節流閥控制)以 SignalForm 參數切換模型內建訊號產生器(1=鋸齒、2=方波、3=正弦)與外部 Signal Editor 產生器(5=激勵 Stimulus)。附 Simple.stz 產生器。執行:設定 platform → Go Online → 下載產生器 → Start Measuring → 啟動產生器。

XIL API EESPort Demo(XILAPIEESPortDemo)

需求模組:ControlDesk + Failure Simulation Package(若用 SCALEXIO 失效模擬單元,另需 ConfigurationDesk – SCALEXIO Failure Simulation)。示範基於 ASAM AE XIL API 的電氣錯誤模擬。

Offline Mode:所有 EESPort 皆啟用離線模式,讓你在未連接失效插入硬體時仍能模擬故障的啟用與觸發(無法實際執行故障模擬,但可了解運作方式)。內含 EESPort:FullSizeVariant1(DS291 FIU)、FullSizeVariant2(DS293 FIU)、SCALEXIO(HighFlex & MultiCompact)、SCALEXIO_FSX(FSX 硬體)。

4. Automation Demos(自動化示範)

ControlDesk 提供以 Python 撰寫的自動化示範,分四類:

Tool Automation

自動化 ControlDesk 各功能並使用 ControlDesk 事件

MC3

經 ASAM MCD-3 MC 介面遠端控制量測校正(無需硬體)

D3

經 ASAM MCD-3 D 介面遠端控制 ECU 診斷(用 ECU Diagnostics 裝置設定,無需硬體)

Measurement Data API

載入、編輯、建立量測資料檔

Tool Automation Demos 清單

Demo 示範內容
BusNavigatorHandling設定並啟動匯流排重播/監控/記錄;建立含事件的自訂 Bus Instrument
CreateDefaultProjectOnStartUpControlDesk 啟動時以 Started 事件建立預設專案
CustomUI擴充 ribbon 新增分頁、擴充元素右鍵選單新增指令
DataSetHandling建立/複製 data set、設定 working/reference data set、匯出入
ECUDiagnosticsHandling建立 MCD-3D 裝置、匯入 ODX、執行診斷服務與 job、ECU flash、讀取 DTC 與環境資料
EventHandling在 Project/Experiment 事件情境中設定事件並觸發
ExperimentHandling建立/更名/移除/匯出入 experiment、新增 XCP on CAN 裝置
InterpreterHandling在內部直譯器執行外部腳本、匯入命名空間、執行/停止執行緒
LayoutAndInstrumentHandling新增/群組/匯出入 layout、加入與排列 instrument、編輯 Time Plotter/Variable Array/Table Editor(Bus Navigator Demo dashboard 即由此建立)
MeasuringAndRecording啟動/設定/停止量測與記錄、匯出入已記錄資料
PlatformHandling註冊/新增/編輯 platform、加入變數描述、連接、起停線上校正
ProgressbarHandling建立各式進度列(非模態/模態/含 Cancel)
ProjectHandling建立/載入/移除專案與 project root、備份與載入備份
SignalEditorHandling開啟含產生器的 experiment、下載/起停產生器、映射模型變數到訊號
StartControlDesk啟動 ControlDesk、讀取屬性、關閉
UserInterfaceHandling自訂主視窗與子視窗介面
VariableAccessHandling不透過 instrument 直接讀寫純量/多維變數、以 identifier path 存取

另附:模態對話框實作範例(Python 與 C#),位於 .\Demos\ToolAutomation\Python\DialogExamples。Python 入門與範例腳本另見手冊 ControlDesk Automation 之 Using Python / Python Demo Scripts。

5. Demo Programs(示範程式)

程式 用途
CalDemo ECU Program模擬 ECU,供 CalDemo 與 ECU Diagnostics Demo 存取;開啟相關 demo 時由 ControlDesk 自動啟動(亦可手動啟動)
CANGenerator ProgramCAN 報文產生程式,供匯流排相關示範使用

原始文件出處(dSPACE RLS2025-B)

文件 章節
ControlDesk Introduction and OverviewDemos for ControlDesk(Demo Projects / Automation Demos / Demo Programs),含各 demo 詳述與功能涵蓋矩陣
延伸參考ControlDesk Automation、ControlDesk Bus Navigator、ControlDesk ECU Diagnostics、ControlDesk Signal Editor、ControlDesk Electrical Error Simulation、ControlDesk Instrument/Variable/Platform Management

來源:dSPACE ControlDesk Introduction and Overview(RLS2025-B,November 2025)。範例位於 ControlDesk 安裝之 .\Demos 資料夾(含 Backups 子資料夾之 ZIP 封存)。實際選單、路徑與參數請以安裝版本為準。