2. 安装与授权

ConfigurationDesk 是 dSPACE 面向实时硬件(如 SCALEXIO、MicroAutoBox、DS1006 等)进行 I/O 配置、模型集成与实验管理的核心工具。它并不是一个可以“双击即用”的独立软件,而是与 MATLAB/Simulink、dSPACE 实时平台、RTI(Real-Time Interface)以及许可证服务器共同构成一套工具链。因此,安装与授权环节的任何一个细节出错,都会在后续建模或下载阶段才暴露出来。本节围绕安装流程、许可证配置、版本兼容性检查与常见问题排查展开,帮助你把问题挡在工程开始之前。

一、安装前的准备与版本兼容性检查

ConfigurationDesk 的安装包通常随 dSPACE 发行版(Release)一起提供,例如 Release 2023-A、2024-A 等。安装前必须先确认三件事:操作系统版本、MATLAB 版本、以及目标实时硬件的支持范围。dSPACE 对每个 Release 都发布了明确的兼容性矩阵,其中会列出支持的 Windows 版本(如 Windows 10 22H2、Windows 11 23H2)、支持的 MATLAB 版本(如 R2021b~R2023b)以及对应的 RTI 版本。

需要特别注意的是,ConfigurationDesk 与 MATLAB 的绑定关系是“按 Release 锁定”的。例如 ConfigurationDesk 2023-A 通常只支持特定区间的 MATLAB 版本,若你安装了更新的 MATLAB,可能在启动时提示找不到接口或无法加载 Simulink 模型。因此建议在安装前先记录当前 MATLAB 的版本号(在 MATLAB 命令窗口执行 version),再对照 dSPACE 官方兼容性列表确认。

建议在同一台机器上只保留一个“主用”MATLAB 版本用于 dSPACE 工具链,避免多个版本共存导致注册表与路径冲突。若必须多版本共存,应在安装时明确指定 ConfigurationDesk 关联的 MATLAB 路径。

二、安装流程的关键步骤

ConfigurationDesk 的安装通常包含以下几个阶段:

  1. 安装 dSPACE 基础环境:运行 dSPACE 安装程序,选择安装目录(建议使用默认路径,避免中文或空格路径)。安装程序会同时部署 ConfigurationDesk、RTI、ControlDesk 等组件。
  2. 选择组件:在组件选择界面中,至少勾选 ConfigurationDesk、对应的 RTI 版本以及硬件驱动。若使用 SCALEXIO,还需勾选 SCALEXIO 相关驱动与固件。
  3. 关联 MATLAB:安装过程中会提示选择 MATLAB 安装路径。此处必须指向与兼容性矩阵一致的 MATLAB 版本根目录,例如 D:\MATLAB\R2022b。
  4. 完成安装并重启:安装结束后建议重启计算机,使驱动与环境变量生效。

安装完成后,可通过开始菜单中的 ConfigurationDesk 快捷方式启动。首次启动时,软件会检查许可证与 MATLAB 关联状态。若一切正常,会进入主界面并显示可用的硬件配置模板。

三、许可证配置:本地与网络两种模式

dSPACE 的许可证通常有两种形式:本地许可证(绑定到本机)和网络许可证(通过许可证服务器分发)。本地许可证一般以文件形式提供,需要在 dSPACE License Manager 中导入;网络许可证则需要配置服务器地址与端口。

配置网络许可证时,需要在 License Manager 中填写许可证服务器的 IP 或主机名,以及端口号(默认通常为 27000 或由管理员指定)。配置完成后,点击“Check”或“Refresh”按钮,软件会向服务器请求授权。若成功,会显示可用的功能模块列表,例如 ConfigurationDesk Base、RTI 等。

一个常见误区是:许可证配置成功后,并不代表所有功能都可用。某些高级功能(如特定硬件支持包)可能需要额外的授权项。因此建议在配置完成后,打开 ConfigurationDesk 的“Help → License Information”查看已授权的功能清单,确认与项目需求匹配。

# 示例:网络许可证服务器配置(在 License Manager 中填写)
Server: 192.168.10.25
Port: 27000
Vendor: dSPACE
Status: Connected

四、常见安装与授权问题排查

在实际工程中,安装与授权阶段最常见的问题可以归纳为以下几类:

  • 启动时报“MATLAB not found”:通常是安装时未正确关联 MATLAB,或 MATLAB 版本不兼容。解决方法是重新运行 dSPACE 安装程序中的“Modify”选项,重新指定 MATLAB 路径;或检查系统环境变量中是否包含 MATLAB 的 bin 目录。
  • 许可证无法获取:先确认网络是否可达许可证服务器(可用 ping 或 telnet 测试端口),再检查防火墙是否拦截了许可证服务端口。若使用本地许可证,确认许可证文件是否与当前机器的主机名或 MAC 地址匹配。
  • 安装过程中断或回滚:常见原因是杀毒软件拦截了驱动安装,或安装路径包含中文/特殊字符。建议临时关闭杀毒软件,并使用纯英文路径重新安装。
  • ConfigurationDesk 启动后界面空白或报错:可能是 .NET 运行库或 Visual C++ 运行库缺失。可尝试安装 dSPACE 安装包中附带的运行库,或从微软官网下载对应版本。
若在安装后修改了 MATLAB 版本或路径,必须重新运行 dSPACE 安装程序的“Modify”流程重新关联,直接修改环境变量往往不能完全生效。

五、安装与授权检查清单

为了便于在项目开始前快速核对,下面给出一份可直接使用的检查清单。建议在每台新装机器上逐项确认。

检查项 预期状态 确认方式
操作系统版本 在兼容性矩阵支持范围内 系统信息中查看 Windows 版本
MATLAB 版本 与当前 dSPACE Release 匹配 MATLAB 中执行 version
ConfigurationDesk 安装路径 纯英文、无空格 安装目录确认
MATLAB 关联 已正确指向兼容版本 ConfigurationDesk 启动时无报错
许可证状态 已连接且功能完整 License Manager 中查看授权列表
硬件驱动 已安装对应实时硬件驱动 设备管理器中无未知设备

完成以上检查后,ConfigurationDesk 的安装与授权环节基本就绪。此时可以尝试新建一个空的硬件配置工程,确认软件能够正常识别目标硬件并加载 RTI 模块。若这一步顺利通过,后续的 I/O 配置与模型集成工作就有了可靠的基础。

ConfigurationDesk 安装与授权流程及关键检查点 ① 安装前兼容性检查 • Windows 版本是否在支持列表 • MATLAB 版本与 Release 匹配 • 目标硬件驱动是否可用 • 安装路径:纯英文、无空格 ② 安装执行 • 运行 dSPACE 安装程序 • 勾选 ConfigurationDesk / RTI • 关联兼容的 MATLAB 路径 • 安装后重启计算机 ③ 许可证配置 • 本地许可证:导入文件 • 网络许可证:填服务器 IP/端口 • 点击 Check 验证连接 • 查看已授权功能清单 ④ 常见问题排查路径 MATLAB 未找到 重新关联 MATLAB 路径 检查环境变量 bin 目录 许可证获取失败 ping / telnet 测试端口 检查防火墙与主机名绑定 安装中断/回滚 关闭杀毒软件后重装 确认路径无中文/特殊字符 界面空白/报错 安装 .NET / VC++ 运行库 检查安装包完整性 ⑤ 安装与授权最终检查清单 ✓ 操作系统版本 ✓ MATLAB 版本 ✓ 安装路径规范 ✓ 许可证状态 ✓ 硬件驱动就绪 全部通过后,可新建空工程验证 ConfigurationDesk 与目标硬件的通信

总的来说,ConfigurationDesk 的安装与授权并不是一个孤立的“下一步”操作,而是与 MATLAB 版本、dSPACE Release、硬件驱动和许可证服务器紧密耦合的系统工程。把兼容性检查做在前面,把许可证配置做扎实,再配合一份可执行的检查清单,就能显著减少后续调试阶段因环境问题导致的返工。