3. 开发环境搭建

MicroAutoBox 的快速控制原型开发不是“装一个软件就能跑”，而是由一条明确的工具链协同完成：MATLAB/Simulink 负责算法建模与代码生成，dSPACE 的 Real-Time Interface（RTI）把 Simulink 模型与实时硬件绑定，ConfigurationDesk 负责 I/O 配置与实时应用构建，ControlDesk 负责在线标定与测量，硬件驱动与固件则保证上位机与 MicroAutoBox 之间能正常通信。本节按“软件安装 → 工具入门 → 集成配置 → 硬件连接”的顺序，把这条链路的搭建过程讲清楚。

一、dSPACE 软件套件的安装顺序

dSPACE 软件套件通常包含 RTI、ConfigurationDesk、ControlDesk、AutomationDesk、MicroAutoBox 支持包以及硬件驱动。安装顺序建议遵循“先 MATLAB，再 dSPACE 主套件，最后 RTI 与硬件驱动”的原则，因为 RTI 安装时需要识别已安装的 MATLAB 版本并写入其路径。

以常见的 R2021b + dSPACE Release 2021-B 组合为例，安装前先确认三件事：MATLAB 已安装且版本在 dSPACE 支持列表内；MicroAutoBox 已通过以太网或 USB 与上位机物理连接；上位机已关闭杀毒软件的实时扫描，避免安装过程中驱动文件被拦截。安装时选择“完整安装”，并在组件列表中勾选 RTI、ConfigurationDesk、ControlDesk 与 MicroAutoBox II 驱动。安装完成后，在 MATLAB 命令窗口执行 rti 或查看 matlabroot/toolbox/dspace 是否存在，可初步判断 RTI 是否注册成功。

二、ConfigurationDesk 与 ControlDesk 入门

ConfigurationDesk 是面向实时硬件的配置工具，核心任务是定义 I/O 通道、绑定模型信号、生成可下载到 MicroAutoBox 的实时应用。打开 ConfigurationDesk 后，新建工程并选择对应的硬件平台（如 MicroAutoBox II 1401/1511），软件会自动加载该硬件的 I/O 资源树，包括 ADC、DAC、CAN、PWM、数字 I/O 等。此时需要把 Simulink 模型中的输入输出端口与硬件通道一一映射，例如把模型中的 Throttle_Cmd 输出绑定到 DAC1 通道，把 Engine_Speed 输入绑定到 CAN1 的某条报文信号。

ControlDesk 则是运行阶段的“驾驶舱”。它通过以太网与 MicroAutoBox 建立连接，加载 ConfigurationDesk 生成的 .sdf 描述文件后，可以实时观察变量、修改标定参数、记录测量数据。入门阶段建议先掌握三个操作：在 Instrumentation 中拖入 Plotter 观察信号波形；在 Calibration 中修改参数并立即生效；在 Measurement 中配置触发条件并保存 .mf4 数据文件。这三步构成了后续所有调试工作的基础。

三、MATLAB/Simulink 集成配置

RTI 安装完成后，Simulink 库浏览器中会出现 dSPACE RTI 库。集成配置的关键是让 Simulink 知道“这个模型要跑在 MicroAutoBox 上”。具体做法是：在模型配置参数（Configuration Parameters）中，将 System target file 选择为 rti1401.tlc（对应 MicroAutoBox II 1401 平台），Solver 选择定步长离散求解器，步长根据控制任务设定，例如 1 ms 或 0.5 ms。随后在模型中拖入 RTI 的 DS1401 DAC、DS1401 ADC、DS1401 CAN Setup 等模块，替代普通 Simulink 的输入输出端口。

一个常见的入门示例是“油门指令输出 + 转速采集”：模型中以 1 ms 步长运行一个简单比例控制，输出经 DS1401 DAC 模块送到 DAC1 通道，输入经 DS1401 CAN Read 模块读取 CAN1 上的发动机转速报文。配置完成后点击 Build，RTI 会自动调用编译器生成实时代码，并生成可供 ConfigurationDesk 使用的接口描述文件。若编译报错，优先检查 MATLAB 版本与 dSPACE Release 是否匹配、编译器是否为 dSPACE 推荐的版本。

四、硬件连接与驱动安装

硬件连接分为供电、通信和信号三部分。MicroAutoBox 通常使用 12 V 或 24 V 直流供电，接通后观察前面板电源指示灯是否常亮。通信方面，入门阶段推荐使用以太网直连：将上位机网口与 MicroAutoBox 的以太网口用网线连接，上位机 IP 设为 192.168.0.100，子网掩码 255.255.255.0，MicroAutoBox 默认 IP 为 192.168.0.10。设置完成后在命令提示符中执行 ping 192.168.0.10，若能收到回复，说明物理链路与网络配置正确。

驱动安装方面，dSPACE 套件安装过程中会自动安装 MicroAutoBox 的 USB 与以太网驱动。若设备管理器中仍出现未知设备，可手动指向 dSPACE 安装目录下的 Drivers 文件夹进行更新。驱动正常后，在 ControlDesk 的 Platform 管理器中应能自动识别到 MicroAutoBox 设备，并显示其固件版本与序列号。此时即可把 ConfigurationDesk 生成的应用下载到硬件，开始在线调试。

五、环境搭建完成后的验证清单