4. dSPACE工具链与项目工程创建
MicroAutoBox原型项目的交付质量，很大程度上取决于对dSPACE工具链协同关系的理解是否清晰。很多初学者会把ConfigurationDesk、ControlDesk、AutomationDesk、RTI和TargetLink当成五个彼此独立的软件，结果在工程创建阶段反复切换、重复配置，甚至出现“模型能编译但无法部署”或“变量在ControlDesk中找不到”的问题。实际上，这五个工具围绕同一个实时应用形成了明确的分工：TargetLink负责把Simulink模型生成产品级C代码，RTI提供模型与MicroAutoBox硬件I/O之间的接口，ConfigurationDesk完成硬件配置与实时应用构建，ControlDesk负责在线标定与测量，AutomationDesk则把重复的测试与标定过程自动化。理解这条链路，是创建可部署工程的前提。
工具链的分工与协同关系
先看整体关系。RTI（Real-Time Interface）是dSPACE实时系统的核心接口层，它以Simulink模块库的形式提供，包含ADC、DAC、CAN、PWM、数字I/O等硬件访问模块。在模型中加入RTI模块，就等于声明了“这个信号要接到MicroAutoBox的哪个物理通道”。TargetLink则位于代码生成环节，它把Simulink/Stateflow模型转换为符合MISRA等规范的C代码，并生成对应的A2L标定文件和变量描述。ConfigurationDesk读取模型生成的代码与RTI配置信息，结合具体的MicroAutoBox硬件型号（如MicroAutoBox II 1401/1511/1512等）和I/O板卡，生成完整的实时应用并下载到目标机。ControlDesk通过变量描述文件（.sdf或.a2l）与运行中的实时应用建立连接，实现信号观测和参数在线修改。AutomationDesk则通过Python或图形化脚本调用ControlDesk的接口，自动执行测试序列。
创建MicroAutoBox工程的完整流程
下面以一个典型的电机控制原型项目为例，说明从零创建可部署工程的步骤。假设目标硬件为MicroAutoBox II 1401，需要采集两路模拟量（母线电压、相电流）、输出一路PWM、通过CAN发送转速报文。
第一步：在Simulink中搭建模型并插入RTI模块。打开Simulink，新建模型，从dSPACE RTI库中拖入以下模块：DS1401_ADC_C1（配置为通道1和通道2，对应母线电压和相电流）、DS1401_PWM_C1（配置为通道1，频率设为10 kHz，死区时间2 μs）、DS1401_CAN_SETUP_C1（波特率500 kbps）和DS1401_CAN_WRITE_C1（发送ID为0x100的报文）。RTI模块的对话框里需要填写通道号、电压范围（如-10 V～+10 V）、采样时间等参数。这些参数直接决定了硬件行为，必须与接线一致。
第二步：配置TargetLink代码生成选项。在模型配置参数中，将系统目标文件选择为TargetLink的tl_grt.tlc，设置目标语言为C，优化等级为-O2，并勾选“生成A2L文件”。TargetLink会为每个信号和参数生成带描述信息的变量，例如母线电压信号命名为V_bus，相电流为I_phase，PWM占空比参数为duty_cycle。这些名称将出现在后续的变量描述文件中，是ControlDesk识别变量的依据。
第三步：在ConfigurationDesk中建立工程并导入模型。启动ConfigurationDesk，新建工程，选择硬件平台MicroAutoBox II 1401。在“模型”节点下导入上一步生成的代码文件夹（包含.c、.h和.a2l文件）。ConfigurationDesk会自动解析RTI配置，在“I/O”视图中列出已声明的ADC、PWM和CAN通道。此时需要检查通道映射是否与硬件接线一致，例如确认ADC通道1对应母线电压传感器输出。确认无误后，点击“构建”按钮，ConfigurationDesk会编译代码、链接RTI驱动，生成可下载的实时应用文件（通常为.sdf和.ppc文件）。构建过程中若出现“未解析的RTI模块”错误，通常是因为模型中的RTI模块版本与ConfigurationDesk中的硬件描述不匹配，需要检查dSPACE安装版本是否一致。
第四步：下载并运行实时应用。通过ControlDesk连接MicroAutoBox，在“平台”菜单中选择目标机，加载.sdf文件，点击“下载”将应用写入目标机内存。下载完成后，点击“启动”使实时应用运行。此时MicroAutoBox开始以模型设定的采样周期执行控制算法，ADC采集、PWM输出和CAN发送同步进行。
第五步：在ControlDesk中建立变量观测与标定界面。ControlDesk加载.a2l文件后，可以在“变量浏览器”中看到V_bus、I_phase、duty_cycle等变量。将它们拖入仪表盘，创建示波器显示母线电压和相电流波形，创建滑块控制duty_cycle。运行中修改滑块值，可以实时观察PWM占空比变化对电流的影响。这一步是原型开发中迭代验证控制算法的关键环节。
第六步：用AutomationDesk固化测试序列。当需要反复执行“设定占空比→采集电流→判断是否超限”的测试时，在AutomationDesk中新建测试序列，调用ControlDesk的COM接口，依次执行：设置duty_cycle为0.3、等待200 ms、读取I_phase最大值、与阈值比较并记录结果。这样就把手动操作转化为可重复的自动化测试，适合回归验证。
常见问题与判断依据
工程创建阶段最容易出现三类问题。第一类是“变量在ControlDesk中找不到”，原因通常是TargetLink未生成A2L文件，或ConfigurationDesk构建时未包含变量描述。判断方法是检查构建输出目录中是否存在.a2l文件，以及ControlDesk加载的.sdf是否与当前运行的实时应用版本一致。第二类是“RTI通道无输出”，需要确认RTI模块的通道号与硬件板卡实际通道对应，并检查ConfigurationDesk的I/O视图中该通道是否被正确分配。第三类是“下载后目标机不运行”，常见原因是.sdf文件与目标机硬件型号不匹配，或实时应用构建时未包含必要的启动任务。此时应查看ControlDesk的“平台信息”中的目标机状态，确认硬件型号和固件版本。
掌握这条工具链的协同关系后，MicroAutoBox原型项目的工程创建就不再是零散操作的堆叠，而是一条从模型到实时运行的清晰数据流。后续的标定、测试和迭代都建立在这个可部署、可观测的实时应用之上。