📚 课程目录第4章 MicroAutoBox开发环境搭建

4. MicroAutoBox开发环境搭建

MicroAutoBox 是 dSPACE 面向快速控制原型（Rapid Control Prototyping, RCP）的实时硬件平台，其开发环境并不是单一软件，而是一条从模型到实时运行的完整工具链。典型链路为：MATLAB/Simulink 负责控制算法建模与离线仿真，RTI（Real-Time Interface）把 Simulink 模型自动转换为可在 MicroAutoBox 上运行的实时代码框架，TargetLink 或 Simulink Coder 负责代码生成，编译工具链把生成代码编译为可执行目标文件，ConfigurationDesk 负责 I/O 硬件配置与实时应用构建，ControlDesk 负责在线标定、测量与实验管理。理解这条链路的依赖关系，是环境搭建能否一次成功的关键。

4.1 工具链的版本匹配与安装顺序

dSPACE 工具对 MATLAB 版本有严格对应关系。例如 RTI 与 ConfigurationDesk 的某个发行版通常只支持特定区间的 MATLAB 版本，若版本不匹配，RTI 安装时可能无法注册 Simulink 模块库，或在编译阶段报出找不到 rti_*.tlc 目标文件。因此安装前应先确认三件事：MicroAutoBox 硬件型号（如 DS1401/DS1511 等）、dSPACE 发行版（如 R2022-B 之类）、以及本机 MATLAB 版本。三者确定后，再按“MATLAB → 编译器 → dSPACE 基础软件 → RTI/ConfigurationDesk → ControlDesk → TargetLink”的顺序安装，避免后装组件找不到前置路径。

编译工具链方面，Windows 平台常用 Microsoft Visual Studio（MSVC）作为 C 编译器。需要注意：MATLAB 的 mex 编译与 dSPACE 实时目标编译可能使用不同编译器配置，建议在 MATLAB 中执行 mex -setup c 明确选择与 dSPACE 发行版兼容的 MSVC 版本。若使用 TargetLink，还需确认其支持的编译器版本，因为 TargetLink 生成的生产级代码对编译器标准（如 C99）有要求。

4.2 环境变量与路径配置

安装完成后，需要让 MATLAB 能找到 dSPACE 的 RTI 库与目标配置。通常 dSPACE 安装程序会写入系统环境变量，如 DSPACE_ROOT 指向安装根目录。可在 MATLAB 命令窗口验证：

getenv('DSPACE_ROOT')
% 期望输出类似：C:\Program Files\dSPACE\R2022-B
addpath(fullfile(getenv('DSPACE_ROOT'),'MATLAB','RTI'))
which rti1001
% 若返回 rti1001.m 路径，说明 RTI 路径已生效

若 which rti1001 返回空，说明 RTI 未注册到 MATLAB 搜索路径，需要在 Simulink 中检查 dSPACE 模块库是否出现在 Library Browser 中。ConfigurationDesk 与 ControlDesk 是独立可执行程序，不依赖 MATLAB 路径，但它们通过 .sdf、.a2l、.trc 等文件与模型和实时应用交互，因此工程目录结构应统一规划。

4.3 从 Simulink 模型到实时应用的构建流程

下面这张图给出本节最核心的工具链数据流与文件依赖关系，便于在搭建环境时对照检查每一步的输入输出。

图中橙色虚线表示 ControlDesk 采集到的标定与测量数据会反馈回 Simulink 模型，形成“建模—生成—运行—标定—再迭代”的闭环。实际搭建时，最容易出问题的环节往往不是模型本身，而是 RTI 目标配置与 ConfigurationDesk 的 I/O 描述不一致，导致编译通过但运行时报 I/O 通道映射错误。

4.4 一个可复现的最小验证流程

为确认环境可用，建议先做一个最小闭环，而不是直接上复杂模型。示例目标：让 MicroAutoBox 以 1 kHz 采样一个模拟输入，乘以增益 2 后从模拟输出送出，并在 ControlDesk 中观察输入输出波形。

在 Simulink 中新建模型，采样时间设为 0.001 s，加入 dSPACE RTI 库中的 ADC 与 DAC 模块，分别绑定到实际硬件通道（例如 ADC 通道 1、DAC 通道 1）。
在 ConfigurationDesk 中新建工程，选择与硬件一致的板卡配置，确认 ADC/DAC 通道号与 Simulink 中一致，生成实时应用描述文件。
在 Simulink 中设置 RTI 目标，选择对应硬件平台，执行 Build。若编译成功，会在工作目录生成目标文件与 .sdf 描述文件。
用 ControlDesk 新建实验，加载 .sdf，把 ADC 输入与 DAC 输出拖入示波器或仪表控件，下载应用并启动。
给 ADC 通道输入一个已知电压（例如 1.0 V），观察 DAC 输出是否约为 2.0 V。若偏差明显，先检查通道映射与增益，再检查参考电压与量程配置。

验证阶段建议把采样周期、通道号、增益等关键参数记录在工程说明中。MicroAutoBox 的 I/O 通道编号与 ConfigurationDesk 中的逻辑通道号必须一一对应，这是后续排障时最先核对的内容。

4.5 常见配置问题与判断依据

环境搭建中的问题通常有明确症状。若 Simulink 中找不到 dSPACE 模块库，优先检查 RTI 是否安装到当前 MATLAB 版本对应的目录，以及 MATLAB 路径是否包含 RTI 库。若 Build 阶段报“cannot open source file rti_*.h”，说明编译器包含路径未加入 dSPACE 头文件目录，需要在 RTI 目标配置中确认 include 路径。若下载后 ControlDesk 无法连接，检查目标机 IP、网线连接与 ControlDesk 中的平台配置是否一致。若运行后 I/O 无响应，检查 ConfigurationDesk 生成的 .sdf 是否与当前下载的应用匹配，以及通道是否被其他应用占用。

TargetLink 的使用场景与 Simulink Coder 不同：前者面向生产级代码，强调代码效率、可追溯性与 MISRA 等规范，通常用于从原型向 ECU 代码迁移；后者更偏向快速原型与仿真验证。在 MicroAutoBox 原型阶段，可以先用 Simulink Coder + RTI 快速跑通闭环，待算法稳定后再用 TargetLink 生成生产代码。两者对编译器、代码标准与配置项的要求不同，建议在同一个工程中明确区分“原型配置”与“生产配置”，避免混用导致构建结果不可复现。

不要在同一 MATLAB 会话中混用多个 dSPACE 发行版的 RTI 路径。若必须切换版本，应重启 MATLAB 并重新设置路径，否则可能出现模块库版本与目标文件版本不一致，表现为编译通过但运行异常。

完成上述配置后，开发环境应达到三个可验证状态：Simulink 能识别 dSPACE RTI 模块库；模型能成功 Build 并生成目标文件与描述文件；ControlDesk 能连接目标机并在线观察变量。达到这三点，后续的底盘控制算法原型开发才有稳定的运行基础。