2. 开发环境搭建：工欲善其事，必先利其器
说实话，做逆变器开发这么多年，我见过太多人一上来就急着写代码、调参数，结果环境没搭好，后面各种踩坑。我自己就吃过这个亏——有一次项目赶进度，我图省事跳过了环境验证，结果编译出来的代码在硬件上跑飞了，查了整整两天才发现是工具箱版本不匹配。嗯，从那以后，我再也不敢在环境搭建上偷懒了。
这一章，咱们就把开发环境从头到尾捋一遍。你跟着我走，保证不迷路。
2.1 MATLAB/Simulink 安装与配置
MATLAB 和 Simulink 是整个开发流程的基石。我建议你安装 R2021b 或更新的版本，因为从那个版本开始，对嵌入式代码生成的支持更稳定了。
安装要点：
- 安装路径不要有中文和空格。我习惯用
C:\MATLAB\R2023b这种简洁路径 - 选择「自定义安装」，别一股脑全装。你只需要：Simulink、Signal Processing Toolbox、Control System Toolbox
- 许可证激活时，选「激活主机ID绑定」——这个最稳，不会出现网络波动导致掉授权
配置方面，有几点我特别想提醒你：
- 设置工作路径：每次打开 MATLAB，第一件事就是
cd到你的项目文件夹。我一般会在启动脚本里写死这个路径。 - 调整仿真参数：对于逆变器这种电力电子系统，仿真步长建议设成固定步长，比如 1e-6 秒。变步长仿真在开关切换时容易出问题。
- 开启并行计算：如果你的电脑是多核的，记得在 Simulink 里开启并行仿真。我试过，四核机器能快 3 倍左右。
小技巧：安装完成后，运行一下 bench 命令，看看你的电脑跑 MATLAB 的性能。如果浮点运算得分低于 0.5，建议升级硬件——不然编译代码时会等到你怀疑人生。
2.2 嵌入式代码生成工具箱（Embedded Coder）安装
Embedded Coder 是咱们从模型生成 C 代码的关键。说白了，没有它，Simulink 模型就只是个画图工具。
安装其实很简单，但有几个坑我得提前告诉你：
我曾经踩过的坑：
- Embedded Coder 的版本必须和 MATLAB 主版本完全一致。比如 R2023b 的 MATLAB 配 R2023b 的 Embedded Coder，混搭会报错。
- 安装时记得勾选「支持包」——尤其是针对你目标芯片的。比如你要用 TI C2000，就装 Embedded Coder Support Package for TI C2000。
- 装完后，在 MATLAB 命令行输入
targetinstaller，检查所有支持包是否激活。灰色图标表示没装好，得重来。
配置方面，我建议你这样做：
% 在 MATLAB 命令行中执行
% 设置代码生成目标
configset = getActiveConfigSet('myModel');
set_param(configset, 'SystemTargetFile', 'ert.tlc');
% ert.tlc 是 Embedded Coder 的实时目标文件
% 开启代码生成报告
set_param(configset, 'GenerateCodeInfoReport', 'on');
set_param(configset, 'GenerateTraceInfo', 'on');
为什么要开代码生成报告？因为你可以看到生成的 C 代码和 Simulink 模块的对应关系。调试的时候，这个报告能救命。
2.3 硬件在环（HIL）仿真平台简介
HIL 仿真，说白了就是把你的控制器代码跑在真实的硬件上，但被控对象（比如电机、逆变器）是用仿真模型模拟的。为什么需要这个？
你想想看，直接拿真实逆变器做实验，万一代码有 bug，炸管子是分分钟的事。我有个同事，第一次调 PI 参数时没做 HIL，直接把 IGBT 模块烧了，一个模块好几千块。嗯，从那以后他比谁都老实。
常见的 HIL 平台有这些：
| 平台 | 特点 | 适用场景 |
|---|---|---|
| Speedgoat | 和 MATLAB 无缝集成，实时性高 | 中小型项目，快速原型验证 |
| NI PXI | 扩展性强，IO 通道多 | 大型系统，多通道测试 |
| dSPACE | 老牌厂商，生态成熟 | 汽车级应用，可靠性要求高 |
我个人比较推荐 Speedgoat，原因很简单——它和 Simulink 是同一家公司的，兼容性最好。你从 Simulink 模型生成代码，直接下载到 Speedgoat 就能跑，中间几乎不需要额外配置。
HIL 搭建小建议：刚开始做 HIL 时，别追求高保真模型。先用简单的 RLC 等效电路代替逆变器，等控制逻辑调通了，再换更精确的模型。这样能省下大量调试时间。
2.4 版本管理与项目文件结构
这个部分，我觉得是新手最容易忽视的。我见过太多人把模型文件命名为 final_v1.slx、final_v2.slx、final_真的最终版.slx……结果三个月后自己都分不清哪个是哪个。
我的建议是，用 Git 做版本管理。Simulink 模型虽然是二进制文件，但 Git 也能跟踪，只是不能做行级别的 diff。不过没关系，我们主要靠它做版本回退和分支管理。
项目文件结构，我推荐这样组织：
Inverter_Project/
├── 00_Docs/ # 文档
│ ├── requirements/ # 需求文档
│ └── design/ # 设计文档
├── 01_Models/ # Simulink 模型
│ ├── plant/ # 被控对象模型
│ ├── controller/ # 控制器模型
│ └── tests/ # 测试模型
├── 02_Code/ # 生成的代码
│ ├── src/ # 源文件
│ └── inc/ # 头文件
├── 03_Scripts/ # MATLAB 脚本
│ ├── init/ # 初始化脚本
│ ├── post_process/ # 后处理脚本
│ └── utils/ # 工具函数
├── 04_Results/ # 仿真结果
│ ├── sim/ # 仿真数据
│ └── hil/ # HIL 测试数据
└── README.md # 项目说明
为什么这么分？我跟你讲几个实际的好处：
- 模型和代码分开：生成的代码每次编译都会变，但模型是稳定的。分开后，Git 的提交记录会清晰很多。
- 脚本独立存放：初始化脚本里通常有参数定义，如果和模型混在一起，改参数时容易误改模型。
- 结果单独管理：仿真数据文件很大，放在 Git 里会拖慢速度。我一般把
04_Results加到.gitignore里。
注意：Simulink 模型文件（.slx）是压缩包格式，Git 没法做文本 diff。建议每次提交时，在 commit message 里写清楚改了哪个模块、为什么改。比如：「修改了 PI 控制器的积分限幅，防止 windup 现象」——这样三个月后回看，你还能想起来当时在想什么。
好了，环境搭建这部分就讲到这里。下一章咱们开始搭建第一个逆变器模型——从最简单的单相半桥开始。到时候我会手把手带你走一遍，保证你能跑起来。