简介：这份资源面向需要在Simulink仿真过程中动态调整模块参数的开发者与学习者，核心是用S函数实现对模型内部参数的实时修改，并以正弦波形作为验证对象，在线改变其幅值与频率，直观观察参数变化对输出的影响。压缩包共2个文件，包含1个m文件与1个slx模型文件，前者承载S函数的实现逻辑，后者为配套仿真模型，整体仅22KB，轻量易用，解压后直接运行即可复现效果。资源基于MATLAB 2019a制作，更低版本可能无法打开，使用时需留意版本兼容性。目前已有3258人学习下载，说明该思路在Simulink参数在线调节场景中具有一定参考价值。对于想理解S函数与Simulink交互机制、掌握仿真中实时改参方法的读者，可通过这份小例子快速上手，并在此基础上扩展至更复杂的控制系统调试与验证。
1. Simulink 实时修改参数：从「暂停—改—再跑」到「边跑边调」
很多做控制算法的同行都有过这种体验：模型跑一次仿真要十几分钟，想看看把某个增益从 1.2 调到 1.8 会怎样，只能停掉仿真、改参数、重新编译、再等一遍。一天下来真正用来分析结果的时间，还不如等仿真的时间长。Simulink 实时修改参数要解决的正是这件事——在仿真运行过程中，不中断、不重启，直接把新的参数值送进正在执行的模型里，让波形立刻响应变化。
这个能力对三类人价值最大：一是做 PID、LQR、MPC 这类控制器整定的工程师，需要反复试参数看响应；二是做硬件在环测试的团队，被控对象模型不能随便停；三是带学生做课程设计的导师，希望课堂上当场演示参数对系统的影响。核心机制并不神秘，Simulink 在 Normal 和 Accelerator 模式下支持运行时参数调整，关键是把「可调参数」和「不可调参数」分清楚，再用对交互入口。下面按选型、配置、脚本化、避坑、进阶的顺序讲透。
2. 先分清哪些参数能实时改：可调性判定与仿真模式选型
2.1 可调参数的判定规则
Simulink 能不能实时改一个参数，取决于它最终以什么形式进入生成代码或解释执行。经验上可以按下面的表快速判断：
| 参数类型 | Normal 模式 | Accelerator 模式 | 说明 |
|---|---|---|---|
| Gain 模块的 Gain 值 | 可调 | 可调 | 最典型的可调参数 |
| 传递函数分子分母系数 | 可调 | 可调 | 需在模块对话框直接改 |
| Saturation 上下限 | 可调 | 可调 | 限幅类参数一般可调 |
| 查表模块的断点与表值 | 可调 | 部分可调 | 断点维度变化不可调 |
| 状态初值 | 不可调 | 不可调 | 需重新初始化 |
| 采样时间 | 不可调 | 不可调 | 属于结构参数 |
| 模块的维度、端口数 | 不可调 | 不可调 | 改动触发重编译 |
判定原则一句话：影响求解器步长、代数环结构、状态维度的参数，基本都不可调；只影响计算数值、不改变方程结构的，通常可调。拿不准的时候，在 Normal 模式下试着改一次，如果弹出提示要求停止仿真，那它就属于不可调那一类。
2.2 Normal 与 Accelerator 的取舍
Normal 模式用解释方式执行模型，改参数响应最快，几乎无延迟，适合参数整定和教学演示。Accelerator 模式会把模型编译成 MEX 文件执行，速度快很多，但改参数时如果碰到需要重编译的情况，会有一段卡顿。Rapid Accelerator 模式性能最好，但可调参数范围最窄，很多参数改动都会触发重新编译。
我一般的做法是：整定阶段用 Normal，确认参数后再切 Accelerator 跑长时仿真验证。如果模型规模大、单次仿真超过五分钟，那 Accelerator 的编译开销可以接受，但要把可调参数提前规划好，避免频繁触发重编译。
2.3 用 Simulink.Parameter 对象管理可调参数
把散落在各个模块里的数值改成 Simulink.Parameter 对象，是让参数可脚本化、可批量修改的前提。下面这段脚本演示如何把模型里所有 Gain 模块的增益统一替换成参数对象：
% 打开目标模型 mdl = 'myControlModel'; load_system(mdl); % 找到所有 Gain 模块 gainBlks = find_system(mdl, 'BlockType', 'Gain'); % 为每个 Gain 创建独立的 Parameter 对象并绑定 for k = 1:numel(gainBlks) blkPath = gainBlks{k}; % 用模块路径生成合法变量名，替换非法字符 varName = matlab.lang.makeValidName(['gain_' blkPath]); p = Simulink.Parameter; p.Value = str2double(get_param(blkPath, 'Gain')); p.CoderInfo.StorageClass = 'Auto'; assignin('base', varName, p); set_param(blkPath, 'Gain', varName); end save_system(mdl);逻辑说明：find_system按 BlockType 过滤出所有 Gain 模块；matlab.lang.makeValidName把模块路径里的斜杠、空格转成合法变量名，避免命名冲突；Simulink.Parameter对象比裸数值多带了存储类、数据类型、取值范围等元信息，后续做代码生成或标定时都用得上。参数说明：StorageClass设为Auto表示由 Simulink 自行决定存储方式，如果要做在线标定可以改成ExportedGlobal，但那样会改变代码生成行为，需要同步调整。
3. 三种实时改参数的落地方式：手动、脚本、外部程序
3.1 手动在仿真运行中改参数
最直接的方式：点下运行按钮，仿真跑起来后，双击 Gain 模块，把值从 1.2 改成 1.8，点确定。如果参数可调，波形会在下一个时间步立刻体现变化，不需要停仿真。这里有个细节容易被忽略——改完之后模块对话框里的值变了，但工作区里的变量没变，如果此时保存模型，下次加载会以工作区变量为准，改动就丢了。所以手动改完要记得同步工作区，或者干脆用脚本改。
3.2 用 set_param 在脚本里动态改
脚本化改参数适合做批量扫描或自动化测试。下面这段代码在仿真运行过程中，每隔一秒改一次增益：
mdl = 'myControlModel'; load_system(mdl); % 启动仿真，不阻塞命令行 set_param(mdl, 'SimulationCommand', 'start'); % 在仿真运行期间循环修改参数 gains = [1.0, 1.5, 2.0, 2.5]; for k = 1:numel(gains) % 检查仿真是否还在跑 status = get_param(mdl, 'SimulationStatus'); if ~strcmp(status, 'running') break; end % 修改 Gain 模块的值 set_param([mdl '/Gain1'], 'Gain', num2str(gains(k))); pause(1.0); end % 等待仿真结束 while strcmp(get_param(mdl, 'SimulationStatus'), 'running') pause(0.5); end逻辑说明：set_param的SimulationCommand设为start后仿真在后台跑，命令行不被占用；循环里每次改参数前先查SimulationStatus，避免仿真已结束还在改导致报错；pause给仿真留出响应时间。参数说明：Gain属性接受字符串形式的数值，用num2str转换；如果要改的是 Parameter 对象，需要先改工作区变量再刷新，或者直接用set_param指向对象名。
3.3 通过外部程序接口改参数
当参数需要由外部优化算法或测试台架决定时，可以用 MATLAB Engine 或 Simulink 的 TCP/IP 接口。常见做法是在外部程序里调用 MATLAB Engine API，把新参数值传进去，再触发set_param。这种方式延迟比脚本内改高，通常在几十毫秒量级，对慢过程控制够用，对高频控制回路要谨慎。配置时要确保 MATLAB Engine 版本和 Simulink 版本匹配，否则连接会失败。
4. 避坑指南：实时改参数翻车的五个典型场景
4.1 改了参数波形没反应
现象：在运行中改了 Gain 值，波形纹丝不动。原因通常是这个 Gain 模块的增益被设成了不可调，或者模型跑在 Rapid Accelerator 模式下。解决：切回 Normal 或 Accelerator 模式，检查模块参数是否被标记为不可调，必要时把裸数值换成 Simulink.Parameter 对象。
4.2 改参数后仿真报代数环错误
现象：改完某个反馈增益，仿真立刻报代数环。原因：新参数值改变了系统的代数约束关系，原本不构成代数环的回路现在构成了。解决：在反馈路径上加 Unit Delay 或 Memory 模块打断代数环，或者改用变步长求解器。
4.3 脚本改参数时提示模型未加载
现象：set_param报错说找不到模型。原因：模型没有用load_system加载，或者被close_system关掉了。解决：改参数前先load_system，改完再决定是否close_system。如果模型是打开状态但没加载到内存，set_param也会失败。
4.4 参数改了但保存后丢失
现象：运行中改的参数，保存模型再打开又变回旧值。原因：模块对话框里的值被工作区变量覆盖了。解决：要么改工作区变量，要么把模块参数直接写成数值而不是变量名。用 Parameter 对象的话，改完要assignin回基础工作区。
4.5 高频改参数导致仿真变慢
现象：脚本里每秒改一次参数，仿真速度明显下降。原因：每次set_param都会触发一次参数更新和可能的缓存失效。解决：降低改参数频率，或者把多次改动合并成一次；如果参数之间有关联，尽量一次性改完再让仿真跑一段。
5. 进阶技巧：用回调函数做参数自适应调整
前面讲的都是外部主动改参数，进阶玩法是让模型自己根据运行状态改参数。Simulink 支持在模块或模型级别挂回调函数，比如StartFcn、StopFcn、OutputFcn。其中OutputFcn在每个时间步后被调用，可以在里面读取当前状态并决定是否改参数。
下面这个例子演示用OutputFcn实现增益自适应：当输出误差超过阈值时，自动把增益调大。
function status = adaptGain(t, y, flag, mdl) % 自适应增益回调函数 % t: 当前时间, y: 当前输出, flag: 回调阶段标志 persistent lastGain status = 0; if isempty(flag) % 正常时间步回调 err = abs(y(1) - 1.0); % 假设目标值为 1.0 if err > 0.1 newGain = min(3.0, lastGain + 0.1); else newGain = max(0.5, lastGain - 0.05); end if abs(newGain - lastGain) > 1e-3 set_param([mdl '/Gain1'], 'Gain', num2str(newGain)); lastGain = newGain; end elseif strcmp(flag, 'init') lastGain = 1.0; end end逻辑说明：OutputFcn在每个时间步后被调用，flag为空表示正常步，init表示初始化；用persistent变量保存上一次的增益值，避免频繁写set_param；误差大就加增益，误差小就减增益，形成简单的自适应律。参数说明：阈值 0.1 和步长 0.1、0.05 需要根据具体系统调整，增益上下限 0.5 和 3.0 是保护措施，防止参数跑飞。
配置方法：在模型属性里找到OutputFcn一栏，填入函数名adaptGain，确保函数在 MATLAB 路径上。运行仿真后，可以在示波器里看到增益随误差变化的过程。
这个技巧的边界在于：OutputFcn的调用频率和求解器步长相关，变步长求解器下调用间隔不固定，做自适应律时要考虑这一点。另外，频繁调用set_param会拖慢仿真，建议加一个最小改动阈值，只有变化超过阈值才真正写参数。
我自己的习惯是，任何自适应逻辑先在 Normal 模式下用小步长跑一遍，确认参数变化范围合理，再切 Accelerator 跑长时验证。有一次没做这一步，自适应增益在 Accelerator 下因为调用频率不同直接发散，波形飞到天上，血泪教训。希望帮到你。
本文还有配套的精品资源，点击获取
