4. dSPACE软件工具链与工程创建

MicroAutoBox 电机控制原型开发并不是在单一软件里完成的，而是由一组分工明确的 dSPACE 工具协同支撑。理解每个工具“管什么、不管什么”，是避免工程创建阶段反复返工的前提。本节先梳理工具链的分工与数据流，再以一台永磁同步电机（PMSM）的磁场定向控制（FOC）原型为例，走完从模型到实时任务的工程创建过程。

一、工具链分工：谁负责什么

dSPACE 工具链可以按“离线建模—硬件配置—实时运行—在线标定”四个环节来理解，各工具的核心职责如下：

• MATLAB/Simulink + RTI：RTI（Real-Time Interface）是连接 Simulink 与实时硬件的桥梁。它把 Simulink 模型中的 I/O 模块映射到 MicroAutoBox 的实际硬件通道，并自动生成实时可执行代码。RTI 决定“模型里的信号接到哪个物理接口”。
• ConfigurationDesk：负责硬件层面的工程配置，包括 MicroAutoBox 的板卡识别、I/O 通道定义、任务与中断配置、模型与硬件资源的绑定，最终生成可下载到实时硬件的应用。它决定“硬件资源如何被组织和分配”。
• ControlDesk：运行阶段的在线工具，用于下载应用、启动/停止实时任务、观测变量、在线修改参数、记录实验数据。它决定“运行时如何观察和干预”。
• TargetLink：面向产品级代码生成的工具，把 Simulink 模型转换为高效、可追溯的 C 代码，常用于从原型向量产代码过渡。原型阶段可先用 RTI 自动代码，量产迁移时再引入 TargetLink。

四者的关系可以用一条数据流概括：Simulink 模型经 RTI 映射硬件接口，ConfigurationDesk 完成硬件与任务配置并生成应用，ControlDesk 下载运行并在线标定，TargetLink 则在需要产品级代码时介入。下图给出这一工具链的分工与数据流向。

二、创建 MicroAutoBox 电机控制原型工程

下面以 PMSM 的 FOC 原型为例，说明工程创建的关键环节。假设控制目标为：电流环 10 kHz、速度环 1 kHz，采用增量式编码器获取电角度，三相电流由 MicroAutoBox 的 ADC 通道采集。

第一步：在 Simulink 中搭建控制模型。模型至少包含 Clarke/Park 变换、两个 PI 电流环、一个 PI 速度环、SVPWM 调制、以及编码器角度解算。把需要与硬件交互的信号显式标注出来，例如三相电流 ia/ib/ic、母线电压 udc、编码器 enc_a/enc_b/enc_z、PWM 输出 pwm_a/pwm_b/pwm_c。这些信号名后续会直接出现在 RTI 的 I/O 映射和 ControlDesk 的变量列表中，命名应规范、可读。

第二步：用 RTI 完成 I/O 映射。在 Simulink 中插入 RTI 提供的硬件接口模块，把模型信号绑定到 MicroAutoBox 的实际通道。例如：

ADC 通道映射（示例）
  ia  -> DS1401 ADC Ch1
  ib  -> DS1401 ADC Ch2
  ic  -> DS1401 ADC Ch3
  udc -> DS1401 ADC Ch4

编码器接口
  enc_a/enc_b/enc_z -> DS1401 增量编码器接口

PWM 输出
  pwm_a/pwm_b/pwm_c -> DS1401 PWM Ch1/2/3
  载波频率 = 10 kHz，死区时间 = 1 us（示例值）

RTI 会根据这些映射自动生成实时代码框架，包括初始化、任务调度和 I/O 读写。此时模型已经具备“可编译为实时应用”的条件。

第三步：在 ConfigurationDesk 中配置硬件与任务。新建工程后，先识别并添加 MicroAutoBox 的板卡资源，再定义任务与中断。FOC 原型通常配置两个任务：

• 电流环任务：由 PWM 周期中断触发，采样周期 100 us（对应 10 kHz），执行电流采样、Clarke/Park、PI 调节、SVPWM 更新。
• 速度环任务：周期 1 ms（对应 1 kHz），执行转速计算与速度 PI，输出电流指令给电流环。

在 ConfigurationDesk 中把 Simulink 模型与这些任务绑定，指定每个任务的触发源、优先级和执行周期。电流环优先级应高于速度环，保证电流控制的实时性。配置完成后生成应用，得到可下载到 MicroAutoBox 的实时程序。

三、用 ControlDesk 运行与在线标定

应用生成后，通过 ControlDesk 建立与 MicroAutoBox 的连接，下载应用并启动实时任务。ControlDesk 的核心价值在于“在线可观测、可干预”：

• 变量观测：把 ia/ib/ic、id/iq、speed、theta_e 等信号拖入仪表或示波器控件，实时观察波形。
• 参数标定：在线修改电流环 PI 的 Kp/Ki、速度环 Kp/Ki、电流限幅值等，无需重新编译下载。
• 数据记录：启动数据采集，把实验过程保存为文件，便于离线分析阶跃响应、超调量和稳态误差。

一个典型的调试顺序是：先开电流环，给定 iq_ref = 0.5 A 的阶跃，观察 iq 的上升时间和超调；再投入速度环，给定 500 rpm 阶跃，观察转速响应。若电流环出现高频振荡，优先检查采样与 PWM 同步、PI 参数是否过大；若速度环响应过慢，可适当增大速度环 Kp，但需保证电流指令不超出限幅。

四、TargetLink 的介入时机

原型阶段用 RTI 自动生成的代码即可满足快速验证需求。当控制算法趋于稳定、需要向产品级 ECU 迁移时，再引入 TargetLink。TargetLink 的优势在于生成代码的效率、可追溯性和对定点/浮点的灵活支持，适合把经过验证的 Simulink 模型转换为可集成的产品代码。需要注意的是，TargetLink 生成代码的接口和数据类型约束比 RTI 更严格，迁移前应先把模型中的数据类型、采样时间和接口定义规范化。

把上述流程固化为可复用的检查清单，可以显著减少重复劳动。下表给出一份面向本节的工程创建检查表示例，字段可根据实际项目增删。

掌握这条工具链的分工与工程创建流程后，后续的电机控制算法调试、参数整定和实验分析才有稳定的运行基础。工具本身并不复杂，难点在于让模型、硬件配置和在线观测三者始终保持一致。