4. Simulink模型到MicroAutoBox的代码生成

把在 Simulink 中验证过的控制算法真正跑在 MicroAutoBox 上，核心工作是把模型“翻译”成能在 dSPACE 实时硬件上执行的代码。这一过程并不是简单点一下 Build，而是由三件事共同决定成败：模型与硬件的接口（RTI）、求解器的时间基准（固定步长）、以及代码生成与下载链路（配置选项、编译、下载）。本节围绕这三条主线展开，给出可直接照做的配置与判断依据。

一、RTI 接口：让模型“接上”真实硬件

RTI（Real-Time Interface）是 dSPACE 提供的 Simulink 模块库，它把 MicroAutoBox 的 I/O 通道、CAN 通道、串口等硬件资源封装成 Simulink 模块。模型里放一个 RTI 的 ADC 模块，就相当于声明“这个信号从硬件某路模拟输入采集”；放一个 DAC 模块，就相当于声明“这个变量输出到某路模拟输出”。RTI 模块是模型与硬件之间的契约，编译时由它生成底层驱动调用。

配置 RTI 的关键是“通道—信号—量纲”三者对齐。以常见的 MicroAutoBox II（DS1401）为例，其模拟输入模块需要指定板卡槽位、通道号、输入电压范围（如 -10V～+10V 或 0～5V）以及分辨率。假设我们用一路 0～5V 的模拟输入采集踏板位置传感器，传感器输出 0.5V～4.5V 对应 0%～100%，那么在 RTI ADC 模块中应选择对应通道与 0～5V 量程，并在模型里做线性换算：

pedal_pct = (V_in - 0.5) / (4.5 - 0.5) * 100;   % 0.5V→0%，4.5V→100%
pedal_pct = min(max(pedal_pct, 0), 100);          % 限幅，防止越界

需要注意两点：一是 RTI 模块的采样时间必须与模型求解器步长一致或为其整数倍，否则会触发采样时间错误；二是数字输出、PWM 输出等模块要确认硬件通道的电气特性（如高边/低边、最大电流），避免驱动能力不足导致执行器不动作。RTI 配置完成后，建议先用 dSPACE ControlDesk 建立变量观测，确认每个通道的物理量读数与预期一致，再进入代码生成环节。

二、固定步长求解器：实时性的时间基准

MicroAutoBox 是实时系统，模型必须以确定的时间步长周期性执行，因此求解器必须选择固定步长（Fixed-step），离散求解器通常选 Fixed-step discrete (no continuous states)。步长的选择直接决定实时性：步长越小，控制精度越高，但单步计算量必须能在步长内完成，否则会“超时”（overrun）。

工程上常用的步长是 1ms（0.001s）或 0.5ms。以 1ms 为例，若模型包含较多查表、滤波或复杂运算，需要评估单步执行时间。一个实用的判断方法是：编译下载后，在 ControlDesk 中观察任务的执行时间（turnaround time）与超时计数。若执行时间接近或超过步长，应适当增大步长或优化模型（如减少连续状态、降低查表维度）。此外，模型中的连续状态（如连续传递函数、积分器）在固定步长下会被离散化，需确认离散化方法（如 Tustin、前向欧拉）对控制效果的影响，必要时在模型层面预先离散。

三、代码生成选项与编译下载流程

代码生成配置集中在 Simulink 的 Configuration Parameters 中。关键选项包括：

• System target file：选择 dSPACE 提供的目标文件（如 rti1401.tlc 对应 DS1401），这是生成 dSPACE 可执行代码的前提。
• Toolchain：选择 dSPACE 编译器链（通常为 dSPACE RTI 或对应 GCC/Diab 工具链），确保与 MicroAutoBox 的运行时环境匹配。
• Code Generation：勾选 Generate code only 可只生成代码不编译，便于检查；正常流程应关闭该选项，直接生成并编译。
• Interface：设置 Code interface packaging 为 Nonreusable 或按需选择，同时确认 MAT-file logging 是否开启，便于后续用 ControlDesk 记录数据。

配置完成后，点击 Build Model（或 Ctrl+B），Simulink 会依次执行：生成 C 代码 → 调用 dSPACE 编译器编译 → 链接生成 .sdf 或 .ppc 可执行文件 → 通过 RTI 下载到 MicroAutoBox。下载成功后，硬件上的实时任务开始运行，此时可在 ControlDesk 中连接目标机，加载对应的变量描述文件（.sdf），进行在线标定与观测。

整个链路可以用下面的信号与数据流图概括：从 Simulink 模型出发，经过 RTI 接口映射、固定步长求解器离散化、代码生成选项配置，最终编译下载到 MicroAutoBox 执行，并通过 ControlDesk 回读数据形成闭环。

四、实操中的常见问题与判断依据

编译下载过程中，最常遇到的是“编译通过但下载失败”或“下载成功但硬件无输出”。前者多与目标文件、工具链版本不匹配有关，应检查 dSPACE 安装目录下的 RTI 版本与 MATLAB 版本是否兼容；后者通常源于 RTI 通道配置错误或硬件接线问题，可用 ControlDesk 直接读取输入通道值来定位。另一个高频问题是超时（overrun），表现为 ControlDesk 中超时计数持续增加，此时应优先检查模型单步执行时间，而非盲目增大步长。

一个可复用的检查顺序是：先确认 RTI 模块通道与物理接线一致，再确认求解器为固定步长且步长与任务周期一致，然后检查 System target file 与 Toolchain 是否匹配，最后执行 Build 并观察下载日志。若下载成功，用 ControlDesk 建立最小观测集（至少包含一个输入通道、一个输出通道和一个内部关键变量），确认数据更新正常后再逐步扩展标定范围。

总结来说，RTI 解决“接什么硬件”，固定步长解决“多久算一次”，代码生成选项与编译下载解决“怎么变成可执行程序并跑起来”。三者环环相扣，任何一环配置不当都会导致模型无法在 MicroAutoBox 上正确运行。掌握这条链路后，后续的在线标定、数据记录和快速原型迭代才有可靠的基础。