📚 课程目录第2章 ControlDesk工程创建与界面导航

2. ControlDesk工程创建与界面导航

ControlDesk的工程（Project）是测量与标定工作的顶层容器。它把硬件目标、实验、布局、变量描述文件、测量数据记录配置等资源组织在一起，形成可复用、可迁移的工作单元。理解工程创建流程与界面结构，是后续所有测量、标定、自动化操作的前提。本节围绕"新建工程—配置硬件目标—认识Ribbon界面—组织工具窗口—管理工程文件"这条主线展开，并给出可直接参照的操作细节。

一、新建工程：从模板到落盘

启动ControlDesk后，通过 File → New → Project 进入新建工程向导。向导第一步要求选择工程模板，常见选项包括空白工程（Empty Project）、基于平台的示例工程（如MicroAutoBox、SCALEXIO示例）以及自定义模板。对于初次搭建，建议选择空白工程，避免示例中预置的硬件配置与本地实际不符。

第二步指定工程名称与存储路径。工程名建议采用"平台_用途_日期"的命名约定，例如 MABX2_EngineECU_20240612，便于在多个工程间快速识别。路径应避免中文与空格，推荐使用纯英文短路径，如 D:\CD_Projects\，因为部分底层工具链对非ASCII路径支持不稳定。

第三步选择是否创建默认实验（Experiment）。实验是工程内组织测量与标定活动的逻辑单元，一个工程可包含多个实验。勾选创建默认实验后，ControlDesk会自动生成一个名为 Experiment1 的实验节点，并附带一个空白布局（Layout）。完成向导后，工程目录下会生成 .cdproj 工程文件以及配套的 Experiments、Layouts、Variables 等子目录。

二、配置硬件目标：让工程"连得上"

工程创建后，首要任务是配置硬件目标（Hardware Target）。在 Project Manager 窗口中右键 Hardware 节点，选择 Add Target，进入目标配置对话框。这里需要填写或选择三类信息：

目标类型：如MicroAutoBox II、SCALEXIO、DS1006等，决定后续可用的I/O与实时能力。
连接方式：通常为以太网（TCP/IP），需填写目标IP地址与端口。例如MicroAutoBox II默认IP为 192.168.140.1，端口 2000。
描述文件：即目标对应的 .sdf 或 .a2l 文件，用于向ControlDesk描述变量、测量量与标定参数。该文件通常由RTI或TargetLink在代码生成阶段产出。

配置完成后，点击 Test Connection 验证连通性。若返回"Connection successful"，说明工程已能与目标通信；若失败，需检查IP是否与主机同网段、防火墙是否放行、目标是否已上电并运行实时程序。硬件目标配置正确后，其下的变量描述文件会被自动解析，变量树中即可看到可测量的信号与可标定的参数。

建议在硬件目标配置完成后立即执行一次"变量导入检查"：展开变量树，确认关键测量信号（如转速、扭矩、温度）与标定参数（如喷油脉宽MAP）均可见。若缺失，多半是描述文件版本与目标程序不匹配。

三、理解Ribbon界面：功能区的组织逻辑

ControlDesk采用Ribbon风格的功能区界面，顶部按任务类别划分为多个选项卡，每个选项卡下再分组排列命令按钮。核心选项卡包括：

Home：工程与实验的常用操作，如新建、打开、保存、布局切换。
Measurement：测量相关命令，包括开始/停止记录、测量配置、数据导出。
Calibration：标定相关命令，如参数下载、标定编辑器、MAP编辑。
Layout：布局编辑工具，用于拖放仪表、示波器、表格等控件。
Hardware：硬件目标管理与连接状态查看。
Automation：自动化脚本与测试序列的入口。

Ribbon的设计意图是"按任务找命令"，而非"按菜单找命令"。例如要开始一次测量记录，直接在 Measurement 选项卡下点击 Start Recording 即可，无需层层展开菜单。熟悉Ribbon分组后，操作效率会显著提升。

四、工具窗口布局：可停靠的工作区

ControlDesk的主工作区由多个可停靠（Dockable）的工具窗口组成，常见窗口包括：

Project Manager：左侧，展示工程树结构，管理实验、布局、变量、硬件等节点。
Variable Browser：变量浏览器，按描述文件层级展示测量量与标定量。
Layout Editor：中央区域，用于设计测量与标定界面。
Instrument Selector：仪表选择器，提供示波器、表盘、数值显示、MAP编辑器等控件。
Output/Log：底部，显示连接日志、错误信息与脚本输出。

这些窗口支持拖拽停靠、浮动、自动隐藏与多显示器分布。一个实用的布局策略是：左侧固定Project Manager与Variable Browser，中央放Layout Editor，底部保留Output窗口，右侧可浮动Instrument Selector。布局调整后可通过 Layout → Save Layout 保存为自定义工作区，下次启动时自动恢复。

五、工程文件结构与管理

ControlDesk工程在磁盘上以目录树形式存在，理解其结构有助于备份、迁移与版本管理。典型工程目录如下：

MABX2_EngineECU_20240612/
├── MABX2_EngineECU_20240612.cdproj   # 工程主文件
├── Experiments/
│   └── Experiment1/
│       ├── Experiment1.exp            # 实验定义
│       └── Layouts/
│           └── Layout1.lay            # 布局文件
├── Variables/
│   └── Engine.a2l                     # 变量描述文件
├── Hardware/
│   └── MABX2.sdf                      # 硬件描述文件
└── Recordings/
    └── run01.mf4                      # 测量数据记录

其中 .cdproj 是工程入口，记录工程级配置与相对路径引用；.exp 定义实验内的测量配置与激活的布局；.lay 保存布局中控件的类型、位置、绑定变量与显示属性；.a2l 与 .sdf 分别描述变量与硬件，通常由代码生成工具产出，不应手动修改；.mf4 是测量数据记录文件，采用ASAM MDF4标准，可用ControlDesk自带工具或第三方软件（如CANape、INCA）打开。

工程管理中有几个实用习惯值得坚持：第一，定期备份整个工程目录，尤其是 .lay 与 .exp 文件，它们记录了人工编辑的布局与实验配置；第二，当变量描述文件更新时，应在工程中执行"重新加载描述文件"而非新建工程，以保留已有布局绑定；第三，测量数据记录文件体积较大，建议单独存放在 Recordings 目录并定期归档，避免工程目录膨胀。

不要直接修改 .a2l 或 .sdf 文件中的变量地址与数据类型。这些文件由代码生成工具维护，手动修改会导致变量解析错误，甚至引发标定参数写入错误地址的风险。

六、从工程到可运行工作区

完成上述配置后，一个可运行的ControlDesk工作区应具备以下状态：硬件目标显示为已连接；变量树中可见关键测量与标定变量；布局中已放置至少一个示波器与一个数值显示控件，并绑定到实际变量；Output窗口无错误信息。此时点击 Measurement → Start Recording，即可开始记录数据，并在 Recordings 目录下生成 .mf4 文件。

工程创建与界面导航看似是"准备工作"，但它决定了后续测量与标定能否稳定复现。一个结构清晰、命名规范、硬件配置正确的工程，能让实验切换、数据归档与团队协作都变得顺畅；反之，路径混乱、变量缺失、连接不稳的工程会在后续环节反复消耗时间。建议在正式开展测量任务前，先花十分钟检查工程结构与连接状态，这十分钟往往能避免后续数小时的排查。