从‘飞机协同控制’案例失败到成功：我的Simulink模型导出FMU完整避坑实录

从‘飞机协同控制’案例失败到成功：我的Simulink模型导出FMU完整避坑实录

去年接手一个多飞行器协同仿真的项目时，我遇到了一个看似简单却让我折腾了两周的难题——如何将Simulink模型导出为FMU（Functional Mock-up Unit）格式。本以为按照官方文档和几个热门教程操作就能轻松搞定，没想到实际过程中踩的坑比预想的多得多。这篇文章将完整记录我从失败到成功的全过程，希望能帮到同样被困在这个环节的工程师们。

1. 项目背景与初期尝试

当时我们需要在多个仿真平台之间进行联合测试，FMU作为FMI（Functional Mock-up Interface）标准下的模块化封装格式，是跨平台协同仿真的理想选择。我选择了Matlab官网提供的飞行器协同控制案例作为起点，这个案例本身并不复杂，但导出过程却意外地坎坷。

最初我使用的是Matlab 2018b版本，按照以下常规步骤操作：

1. 从GitHub下载FMIKit-Simulink工具包（版本2.9）
2. 将工具包添加到Matlab路径并初始化
3. 配置Solver参数：
   • Type: Fixed-step
   • Solver: ode4 (Runge-Kutta)
   • Fixed-step size: 0.1
4. 在Code Generation中设置System target file为grtfmi.tlc

看起来一切都很标准，但点击生成按钮后，控制台却抛出了一连串红色错误信息：

The call to grtfmi_make_rtw_hook, during the after_make hook generated the following error: Failed to run CMake...

2. 错误分析与环境排查

2.1 编译器缺失问题

第一个显性错误提示是CMake运行失败。通过mex -setup检查发现，我的Matlab竟然没有配置任何C/C++编译器。这在做代码生成时是致命的，因为FMU导出本质上是一个代码生成和编译的过程。

解决方案：

• 安装Visual Studio 2017（注意不是VS Code）
• 确保勾选"使用C++的桌面开发"组件
• 在Matlab中重新运行mex -setup选择VS2017作为默认编译器

提示：Matlab不同版本对VS的支持不同，2018b官方推荐VS2015或VS2017，不要使用更高版本

2.2 CMake配置陷阱

解决了编译器问题后，又遇到了CMake配置错误。这里有几个关键细节容易被忽略：

1. CMake版本匹配：FMIKit自带的CMake可能不兼容，需要手动下载3.15+版本
2. 路径设置技巧：
   • 在Configuration Parameters > Code Generation > CMake Build中
   • CMake Command需填写完整路径（如D:\cmake-3.15.2\bin\cmake.exe）
3. Generator选择：
   • 必须与安装的VS版本严格对应
   • VS2017对应"Visual Studio 15 2017 Win64"

% 验证CMake是否配置正确 system('cmake --version') % 应返回3.15+版本号

3. Visual Studio版本迷思

最让我抓狂的是Visual Studio版本问题。错误日志中提到的"Visual Studio 16 2019"让我误以为需要某些运行时库，实际上它字面意思就是需要VS2019本身。我的开发机上装的是VS2017，这就导致了版本不匹配。

解决方案对比表：

最终我选择升级到Matlab 2020b，因为其内置了更完善的FMU导出支持，省去了大量配置工作。但如果你必须使用旧版本，以下是关键检查清单：

• [ ] 确认Matlab版本与VS版本的兼容性
• [ ] 检查CMake是否在系统PATH中
• [ ] 验证mex编译器配置是否正确
• [ ] 确保FMIKit路径不含中文或特殊字符

4. 成功导出后的经验总结

当终于看到"FMU export completed successfully"的提示时，我总结了几个非技术但同样重要的心得：

1. 环境隔离原则：为FMU导出创建干净的Matlab环境，避免与其他工具箱冲突
2. 日志分析技巧：不要只看最后一行错误，向上滚动查找第一个报错点
3. 版本控制策略：对FMIKit和CMake使用固定版本，不盲目追新
4. 备选方案：当传统方法失败时，可以尝试Simulink Compiler或直接使用2020b+版本

对于时间紧迫的项目，我的建议是直接升级到Matlab 2020b或更新版本，其原生FMU支持可以节省大量配置时间。但如果受限于环境，那么仔细检查编译工具链的每个环节，确保版本环环相扣，是成功导出的不二法门。