📚 课程目录第3章 ControlDesk软件安装与工程环境搭建

3. ControlDesk软件安装与工程环境搭建

ControlDesk 是 dSPACE 提供的实时实验与标定软件，它本身并不“独立工作”，而是与 MicroAutoBox 硬件、RTI 实时接口、编译器以及目标机固件共同构成一条工具链。安装与工程环境搭建的核心目标，是让这条链路上的每个环节版本一致、许可可用、通信可达，最终能够创建一个可加载应用、可在线标定的实验环境。本节按“版本匹配 → 许可证配置 → 目标机通信 → 工作空间与实验创建”的顺序展开，每一步都给出可判断的结果依据。

一、版本匹配：先对齐，再安装

ControlDesk 与 dSPACE 其他组件之间存在明确的版本对应关系。常见的匹配对象包括：ControlDesk 主版本（如 7.3、7.4、2021-A 等）、MicroAutoBox 的固件版本、RTI 版本（RTI1005/RTI1401 等对应不同硬件平台）、MATLAB/Simulink 版本，以及编译器（如 Microsoft Visual C++ 或 MinGW）。若 ControlDesk 版本高于目标机固件，可能出现无法识别硬件或下载失败；若 RTI 与 MATLAB 版本不匹配，则 Real-Time Interface 无法在 Simulink 中正常生成目标代码。

实际操作中，建议先确认 MicroAutoBox 型号与固件版本，再选择与之兼容的 ControlDesk 与 RTI 组合。例如，MicroAutoBox II 1401/1511 系列通常搭配 RTI1401 与对应版本的 ControlDesk；若使用 RapidPro 信号调理模块，还需确认其驱动版本。安装前应关闭 MATLAB、Simulink 及其他 dSPACE 进程，避免文件占用导致安装中断。

判断依据：安装完成后，在 ControlDesk 的 Help → About 中查看版本号；在 MATLAB 命令窗口执行 rti 相关命令或查看 Simulink 库中是否出现对应 RTI 模块，可确认 RTI 是否注册成功。

二、许可证配置：让功能可用

dSPACE 许可证通常通过硬件加密狗（Dongle）或软件许可证文件（License File）提供。安装完成后，需要将许可证与 ControlDesk 关联。若使用加密狗，插入 USB 加密狗并安装对应驱动，ControlDesk 启动时会自动识别；若使用软件许可证，则需在安装目录或许可证管理工具中指定许可证文件路径。

许可证决定了可用的功能范围，例如是否允许连接目标机、是否支持特定硬件平台、是否启用高级标定功能。若许可证缺失或过期，ControlDesk 可能以演示模式启动，无法连接 MicroAutoBox。此时应检查许可证管理器中的状态，确认许可证与当前 ControlDesk 版本、硬件平台一致。

常见检查点：
1. 加密狗指示灯是否点亮；
2. 设备管理器中是否出现 dSPACE Dongle 设备；
3. ControlDesk 启动时是否提示 License 错误；
4. 许可证文件中的 Feature 是否包含当前硬件平台。

三、目标机通信设置：建立物理与逻辑连接

MicroAutoBox 与上位机之间通常通过以太网通信。通信设置包括物理连接、IP 地址配置和 ControlDesk 中的目标机注册。物理层使用网线连接 MicroAutoBox 的以太网口与上位机网口，若使用交换机需确保链路正常。随后配置上位机网卡的 IP 地址，使其与 MicroAutoBox 处于同一网段。例如，MicroAutoBox 默认 IP 常为 192.168.0.1 或类似地址，上位机可设为 192.168.0.100，子网掩码 255.255.255.0。

在 ControlDesk 中，通过 Platform Manager 或 Target Manager 添加目标机，输入 MicroAutoBox 的 IP 地址，并选择正确的硬件平台类型。连接成功后，ControlDesk 会显示目标机状态为在线，并可读取目标机信息。若连接失败，应依次检查网线、IP 网段、防火墙设置以及目标机是否已上电并完成启动。

注意：上位机若同时连接公司网络和 MicroAutoBox，可能出现网段冲突。建议为 MicroAutoBox 单独配置一块网卡或使用独立网段，避免路由干扰。

四、工作空间与实验创建：从工程到可运行环境

工作空间（Workspace）是 ControlDesk 中管理实验资源的顶层容器，通常对应一个项目文件夹。创建实验（Experiment）时，需要指定工作空间路径、实验名称，并关联已编译的目标应用文件（.sdf 或 .ppc 等）。实验创建后，可添加仪表、示波器、标定变量等控件，形成可视化操作界面。

典型流程为：新建工作空间 → 新建实验 → 加载目标应用 → 连接目标机 → 下载应用 → 在线标定。下载应用时，ControlDesk 会将编译生成的实时代码传输到 MicroAutoBox，并启动实时运行。此时可在仪表中观察变量变化，验证通信与标定链路是否正常。

五、常见问题与判断依据

环境搭建过程中，最常见的问题集中在通信与版本两方面。若 ControlDesk 无法发现目标机，优先检查 IP 是否同网段、网线是否插好、防火墙是否拦截；若应用下载失败，检查目标应用文件是否与目标机固件版本匹配；若标定变量无法写入，检查许可证是否包含标定功能以及变量是否被设为只读。

一个可用的工程环境，最终应满足：ControlDesk 能识别目标机并显示在线；目标应用能成功下载并启动；仪表控件能实时刷新变量；标定变量能修改并立即生效。达到这四点，说明版本、许可证、通信、工作空间四个环节均已正确配置，可以进入后续的标定实验阶段。