ControlDesk 測試腳本
撰寫方式與語言介紹

ControlDesk 的自動化介面（Automation API）實作為 Microsoft COM（Component Object Model），因此與開發語言無關，任何 COM 相容語言皆可使用。COM 為 out-of-process server（ControlDesk.exe），自動化一定是驅動真正的 ControlDesk 應用程式；連線時若未啟動會自動啟動，並可將主視窗隱藏至背景。根介面為 Application / IXaApplication。本頁內容整理自 dSPACE 原廠 ControlDesk Automation 手冊（ControlDesk 2025-A）。

1. 撰寫方式總覽

ControlDesk 的腳本可依「執行情境」分為六類，其中外部腳本（External）是最常用的自動化測試方式：

2. 支援的腳本語言與程式語言

3. 內部直譯器 vs 外部直譯器（Python）

4. 建立 COM 連線（各語言）

# Python — late binding（最常用）
from win32com.client import Dispatch
app = Dispatch("ControlDeskNG.Application")            # 作用中版本
app = Dispatch("ControlDeskNG.Application.2025-A")     # 指定版本

# Python — early binding（型別庫包裝，支援常數/IntelliSense）
from win32com.client import gencache
app = gencache.EnsureDispatch("ControlDeskNG.Application.2025-A")

# Python — 取用已執行實例（未執行會丟例外）
from win32com.client import GetActiveObject
app = GetActiveObject("ControlDeskNG.Application.2025-A")

版本引數如 .2025-A / .2024-B / … / .7.0；最新安裝版為預設「作用中版本」，可用 dSPACE Installation Manager 切換。

5. 可自動化的功能範圍

6. 典型外部腳本工作流程（以 VEOS 為例）

from win32com.client import Dispatch
from dspace.com import Enums          # Python 3.12
app = Dispatch("ControlDeskNG.Application.2025-A")
E = Enums(app)

# 開專案 + 啟用實驗
app.ProjectRoots.Item(r"C:\...\Demo_CD").Activate()
active = app.Projects.Item("autoTEST_CD").Open()
active.Experiments.Item(0).Activate()
platform = app.ActiveExperiment.Platforms.Item(0)

# 連線 + online calibration（VEOS 單一記憶體頁）
platform.Disconnect()
platform.GeneralSettings.StartOnlineCalibrationBehavior = E.OnlineCalibrationBehavior.Upload
platform.Connect()
app.CalibrationManagement.StartOnlineCalibration()
platform.ActiveVariableDescription.DataSets.WorkingDataSet.Activate()

# 讀（監視）/ 寫（注入）
v = platform.ActiveVariableDescription.Variables.Item(r"Platform()://Model Root/.../Value")
print(v.ValueConverted)     # 監視
v.ValueConverted = 1        # 注入

7. 事件機制（Event Handlers）

• 
  綁定事件可將 Python event handler 綁到特定事件（如 ControlDesk 啟動、專案建立、實驗啟用、參數變更）。
• 
  三種 Event ContextUser（跨專案、隨 Windows 使用者）、Project、Experiment（隨專案/實驗儲存）。
• 
  由內部直譯器執行ControlDesk 會等待 handler 完成，故勿在事件腳本中使用 sleep。可經 Event Configuration Dialog 設定並匯入/匯出。

8. 另一條介面：ASAM MCD-3

9. 腳本語言介紹

10. 注意事項

• 僅支援 64-bit 自動化 client，不支援 32-bit。
• 腳本大小寫敏感，須與 API 文件拼寫一致。
• 無鎖定機制：不會防止多個自動化來源（AutomationDesk、MCD-3…）同時存取，須自行協調。
• online calibration 時勿選 PromptUser（會跳對話框卡住自動化），改用 Upload 等。
• 兩記憶體頁裝置（如 XCP ECU）需 WorkingDataSet.Activate() 才能寫值。
• 無 license 時只能用 Application 的少數方法（Version、Quit、Execute、Log…）。

11. 原廠範例位置

C:\dSPACE\dSPACE ControlDesk 2025-A\Demos\ToolAutomation\
├── Python\AutomatingControlDesk\    StartControlDesk.py 等
├── Python\CustomUI\                 ribbon / context menu 範例
├── Python\DialogExamples\
└── C#\AutomatingControlDesk\        AutomatingControlDesk.sln

API 參考進入點：Application / IXaApplication。

 延伸閱讀：AutomationDesk 測試腳本撰寫方式與語言。

原始文件出處（dSPACE）

來源：ControlDesk 2025-A（Release 2025-A）；路徑：C:\Users\Public\Acolada\Cobrili\HelpSetStorage\dSPACEPDF\RLS2025-A\en\