从零搭建MATLAB与FlightGear飞行仿真环境：以HL20模型为例

1. 环境准备：软件安装与配置

第一次尝试搭建MATLAB和FlightGear联合仿真环境时，我花了整整两天时间才搞明白各个软件的版本兼容性问题。这里分享下我踩过的坑：FlightGear 2019.1.1和MATLAB 2017b这对组合确实能稳定运行，但如果你用了最新版MATLAB可能会遇到接口协议不匹配的问题。

软件下载清单：

• FlightGear官网下载的2019.1.1版本（约1.2GB）
• MATLAB 2017b安装包（建议准备20GB磁盘空间）
• Visual Studio 2010（注意必须是这个版本）

安装时有个细节容易被忽略：FlightGear的安装路径最好不要包含中文或空格。我试过装在"D:\飞行仿真"目录下，结果部署时总是报路径错误。推荐使用类似"G:\FG_Sim"这样的纯英文路径。

2. 关键文件部署

2.1 模型文件迁移

把MATLAB安装目录下的\toolbox\aero\astdemos整个文件夹复制到FlightGear的\data\Aircraft目录时，要注意检查文件权限。有次我在公司电脑上操作时，因为域账户权限问题导致HL20模型的纹理贴图没能完整复制，最后FlightGear里显示的飞机变成了"白模"。

2.2 工作路径设置

在MATLAB中设置工作路径这个步骤，新手常犯两个错误：

1. 直接点击界面上的"浏览"按钮选择路径，但实际需要在命令行输入：

cd 'G:\HL20test'

2. 忘记添加路径到MATLAB搜索路径列表，导致后续模型无法调用依赖文件。正确的做法是：

addpath(genpath('G:\HL20test')); savepath; % 保存路径设置

3. 模型编译与调试

3.1 编译HL20模型

运行asbhl20命令打开模型后，点击"Build Model"按钮前，建议先做三件事：

1. 检查Configuration Parameters中的Solver选项，确保是固定步长(fixed-step)
2. 确认Code Generation标签页的Toolchain选择的是Visual Studio 2010
3. 打开Diagnostics设置，将Data Validity和Type Conversion的报错等级调为Warning

编译过程中如果遇到"LNK1104: cannot open file 'kernel32.lib'"错误，这是因为VS2010的环境变量没配置好。解决方法是在开始菜单找到"Visual Studio 2010 Command Prompt"，从这里启动MATLAB。

3.2 FlightGear模块配置

双击模型中的FlightGear模块时，重点检查这几个参数：

• --fdm=null必须改为--fdm=external
• --native-fdm=socket,out,30,localhost,5501,udp这个端口号要记下来
• --aircraft=HL20必须与Aircraft目录下的文件夹名称完全一致

4. 场景部署与运行

4.1 地图场景安装

从FlightGear官网下载的地图场景包（约10GB）解压时，要注意：

1. 使用7-Zip而不是WinRAR解压，能避免文件损坏
2. 解压后的Scenery目录结构应该是：

Scenery ├── Objects ├── Terrain └── Models

如果发现多了一层父目录，需要手动调整。

4.2 启动顺序技巧

实测最稳定的启动方式是：

1. 先运行MATLAB中的HL20模型（点击Run）
2. 再双击work文件夹下的runfg.bat
3. 最后在FlightGear界面按V键切换视角

如果画面卡顿，可以尝试修改runfg.bat文件，在最后添加：

--disable-sound --disable-ai-models

5. 常见问题排查

5.1 连接失败问题

当FlightGear黑屏无响应时，按这个顺序检查：

1. 在MATLAB命令窗口输入aeroRoot = aeroot;查看是否正确返回路径
2. 检查5501端口是否被占用（用netstat -ano|findstr 5501）
3. 确认防火墙放行了MATLAB和FlightGear

5.2 可视化异常处理

如果飞机模型显示异常，可以尝试：

1. 在FlightGear启动参数中添加--enable-hud
2. 修改HL20-set.xml文件中的路径
3. 在MATLAB中重新生成BDF文件：

aero_write_fg_acmodel('HL20', 'G:\HL20test\HL20.bdf')

6. 进阶调试技巧

6.1 实时数据监控

在Simulink模型中添加这些模块可以增强调试：

• Flight Instrument Blockset里的姿态指示器
• Aerospace Blockset里的飞行参数显示器
• 用UDP Send模块向外部程序发送实时数据

6.2 性能优化

当帧率低于20fps时，可以：

1. 降低FlightGear的渲染设置（关闭阴影/云层）
2. 在MATLAB模型配置中增大Fixed-step size
3. 使用tic;toc命令定位性能瓶颈

记得定期清理work文件夹下的临时文件，特别是多次编译后会产生大量重复的中间文件。我通常会在每次新实验前执行：

clear mex delete('work/*.obj')