ControlDesk
原廠範例(Demos)詳細說明
ControlDesk 安裝隨附一系列原廠範例,涵蓋量測校正、匯流排、ECU 診斷、儀表、訊號編輯、電氣錯誤模擬與自動化。多數範例不需連接真實硬體即可體驗。本文逐一詳解各範例的內容、所需模組與操作重點。
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 Demo | ECU 診斷功能(MCD-3D) | 否(模擬 ECU) |
| Instrumentation Demo | 3-D Viewer 儀表 | 否 |
| Real-Time Application Demos | 量測與校正,搭配 dSPACE 即時硬體 / VEOS | 是(或 VEOS) |
| Relay Maintenance Demo | SCALEXIO 系統繼電器清潔 | 是(SCALEXIO) |
| Signal Editor Demos | Signal 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 |
| CreateDefaultProjectOnStartUp | ControlDesk 啟動時以 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 Program | CAN 報文產生程式,供匯流排相關示範使用 |
原始文件出處(dSPACE RLS2025-B)
| 文件 | 章節 |
|---|---|
| ControlDesk Introduction and Overview | Demos 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 封存)。實際選單、路徑與參數請以安裝版本為準。