S-Function 示例

这些示例向您展示如何使用各种 S-Function 或使用 S-Function 的程序，包括 C/C++ S-function、Fortran S-Function、S-Function 生成器、Level 2 MATLAB^® S-Function 和 Blockset Designer。每个部分都解释了如何打开文件以及文件的内容。这些都是在学习基础知识之后继续加深对 S-Function 的理解的好地方。这些并不代表 S-Function 的所有可用示例，而只是相关的小节。

访问 S-Function 示例

大多数 S-Function 示例都是通过 sfundemos 运行的。此示例库包含 S-Function 模型，并按编码类型分组，例如 C S-Function 或 C++ S-Function。

要从 sfundemos 运行示例：

在 MATLAB 命令行窗口中，输入 sfundemos。
S-Function 示例库打开。
每个模块代表一类 S-Function 示例。
双击某个类别即可显示其包含的示例。例如，点击 C 文件。
双击一个模块以打开并运行它所代表的示例。

在阅读下一章时，检查一些示例 S-Function 可能会有所帮助。示例代码存储在 MATLAB 根文件夹下的以下文件夹中。

MATLAB 代码	`toolbox/simulink/sfuntemplates`
C、C++ 和 Fortran 代码	`toolbox/simulink/sfuntemplates/src`

2 级 MATLAB S-Function 示例

matlabroot/toolbox/simulink/sfuntemplates 文件夹（打开）包含许多 2 级 MATLAB S-Function。考虑先查看这些文件。有关 2 级 MATLAB S-function 的更多信息，请参阅编写 2 级 MATLAB S-Function。

文件名	模型名称	描述
`msfcn_dsc.m`	`msfcndemo_sfundsc1`	实现具有继承采样时间的 S-Function。
`msfcn_limintm.m`	`msfcndemo_limintm`	实现一个连续有限积分器，其中输出受下限和上限的限制，并包括初始条件。
`msfcn_multirate.m`	`msfcndemo_multirate`	实施多速率系统。
`msfcn_times_two.m`	`msfcndemo_timestwo`	实现一个使其输入加倍的 S-Function。
`msfcn_unit_delay.m`	`msfcndemo_sfundsc2`	实现单位延迟。
`msfcn_varpulse.m`	`msfcndemo_varpulse`	通过调用 2 级 MATLAB S-Function 中的 `set_param` 函数来实现可变脉冲宽度发生器。还演示了如何使用自定义设置和获取模块操作点的方法。
`msfcn_vs.m`	`msfcndemo_vsfunc`	实现一个可变采样时间模块，其中第一个输入延迟由第二个输入决定的时间量。

C S-Function 示例

matlabroot/toolbox/simulink/sfuntemplates/src 文件夹（打开）包含 C MEX S-Function 的示例，其中许多都有 MATLAB S-Function 对应项。下表列出了 C MEX S-Function。有关 C S-Function 的更多信息，请参阅 C/C++ S-Function 基础知识和 Build S-Functions Automatically Using S-Function Builder。

文件名	模型名称	描述
`csfunc.c`	`sfcndemo_csfunc`	实行连续制度。
`dlimintc.c`	无可用模型	实现离散时间有限积分器。
`dsfunc.c`	`sfcndemo_dsfunc`	实施离散系统。
`limintc.c`	无可用模型	实现有限积分器。
`mixedm.c`	`sfcndemo_mixedm`	实现一个由连续积分器（1/s）和单位延迟（1/z）串联组成的混合动态系统。
`mixedmex.c`	`sfcndemo_mixedmex`	实现具有单输出和双输入的混合动态系统。
`slexQuantizeSFcn.c`	`sfcndemo_sfun_quantize`	实现向量化量化器。按照量化间隔参数 `q` 的指定步骤对输入进行量化。
`sdotproduct.c`	`sfcndemo_sdotproduct`	计算两个实数或复数向量的点积（乘法累加）。
`sfbuilder_bususage.c`	`sfbuilder_bususage`	使用总线输入和输出访问 S-Function Builder。
`sfbuilder_movingAverage.c`	`sfbuilder_movingAverage`	使用 Start 和 Terminate 实现简单的时间窗口移动平均值。
`sftable2.c`	`sfcndemo_sftable2`	实现二维表查找。
`sfun_atol.c`	`sfcndemo_sfun_atol`	为每个连续状态设置不同的绝对容差。
`sfun_cplx.c`	`sfcndemo_cplx`	为具有一个输入端口和一个参数的 S-Function 添加复杂数据。
`sfun_directlook.c`	无可用模型	实现直接一维查找。
`sfun_dtype_io.c`	`sfcndemo_dtype_io`	实现一个使用 Simulink^® 数据类型作为输入和输出的 S-Function。
`sfun_dtype_param.c`	`sfcndemo_dtype_param`	实现一个使用 Simulink 数据类型作为参数的 S-Function。
`sfun_dynsize.c`	`sfcndemo_sfun_dynsize`	实现动态大小的输出。
`sfun_errhdl.c`	`sfcndemo_sfun_errhdl`	使用 `mdlCheckParameters` S-Function 例程检查参数。
`sfun_fcncall.c`	`sfcndemo_sfun_fcncall`	在第一个和第二个输出元素上执行函数调用子系统。
`sfun_frmad.c`	`sfcndemo_frame`	实现基于帧的 A/D 转换器。
`sfun_frmda.c`	`sfcndemo_frame`	实现基于帧的 D/A 转换器。
`sfun_frmdft.c`	`sfcndemo_frame`	实现基于多通道帧的离散傅里叶变换（及其逆变换）。
`sfun_frmunbuff.c`	`sfcndemo_frame`	实现基于帧的非缓冲模块。
`sfun_multiport.c`	`sfcndemo_sfun_multiport`	配置多个输入和输出端口。
`sfun_manswitch_mode.c`	无可用模型	实现手动开关。
`sfun_matadd.c`	`sfcndemo_matadd`	在具有一个输入端口、一个输出端口和一个参数的 S-Function 中添加矩阵。
`sfun_multirate.c`	`sfcndemo_sfun_multirate`	演示如何指定基于端口的采样时间。
`sfun_port_constant.c`	`sfcndemo_port_constant`	演示如何指定基于端口的恒定采样时间。
`sfun_port_triggered.c`	`sfcndemo_port_triggered`	演示如何在触发子系统中使用基于端口的采样时间。
`sfun_runtime1.c`	`sfcndemo_runtime`	为所有可调参数实现运行时参数。
`sfun_runtime2.c`	`sfcndemo_runtime`	注册单独的运行时参数。
`sfun_runtime3.c`	`sfcndemo_runtime`	将对话框参数注册为运行时参数。
`sfun_runtime4.c`	`sfcndemo_runtime`	将运行时参数作为多个对话框参数的函数来实现。
`sfun_zc.c`	`sfcndemo_sfun_zc`	演示使用非采样零交叉来实现 `abs(u)`。此 S-Function 设计用于变步长求解器。
`sfun_zc_sat.c`	`sfcndemo_sfun_zc_sat`	演示饱和度的零交叉。
`sfun_zc_cstate_sat.c`	`sfcndemo_sfun_zc_cstate_sat`	实现具有饱和限制和过零检测的连续积分器。
`sfun_integrator_localsolver.c`	`sfcndemo_sfun_localsolver`	演示一个连续积分器，其中使用单独的局部求解器而不是模型使用的求解器来解决连续状态。
`sfun_angle_events.c`	`sfcndemo_angle_events`	实现一种稳健且有效的检测旋转体跨越指定角度的方法。
`sfun_angle_events.c`	无可用模型	演示角度检测并结合 Stateflow^® 来安排函数调用。
`sfunmem.c`	`sfcndemo_sfunmem`	实现单积分步延迟并保持 memory 函数。
`simomex.c`	`sfcndemo_simomex`	实现由状态空间方程描述的单输入、双输出状态空间动态系统： dx/dt = Ax + Bu y = Cx + Du 其中 `x` 是状态向量，`u` 是输入向量，`y` 是输出向量。
`stspace.c`	`sfcndemo_stspace`	实现一组状态空间方程。您可以使用 S-Function 模块和封装工具将其转换为新模块。此示例 MEX 文件执行与内置 State-Space 模块相同的功能。这是 MEX 文件的一个示例，其中输入、输出和状态的数量取决于从工作区传入的参数。
`stvctf.c`	`sfcndemo_stvctf`	实现连续时间传递函数，其传递函数多项式通过输入向量传入。这对于连续时间自适应控制应用很有用。
`stvdtf.c`	`sfcndemo_stvdtf`	实现离散时间传递函数，其传递函数多项式通过输入向量传入。这对于离散时间自适应控制应用很有用。
`stvmgain.c`	`sfcndemo_stvmgain`	实现时变矩阵增益。
`table3.c`	无可用模型	实现三维查找表。
`timestwo.c`	`sfcndemo_timestwo`	实现一个使其输入加倍的 C MEX S-Function。
`vdlmintc.c`	无可用模型	实现离散时间向量化有限积分器。
`vdpmex.c`	`sfcndemo_vdpmex`	实现范德波尔方程。
`vlimintc.c`	无可用模型	实现向量化有限积分器。
`vsfunc.c`	`sfcndemo_vsfunc`	说明如何创建可变采样时间模块。该模块实现了变步长延迟，其中第一个输入延迟的时间量由第二个输入决定。
`sfun_pwm.c`	`sfcndemo_pwm`	说明如何创建可控的采样时间模块。
`sfun_d2c`	`sfcndemo_d2c`	说明如何将离散输入信号转换为平滑的连续输出信号
`sfun_pulse_delay.c`	`sfcndemo_vco`	说明如何实现一种算法，以使用可变的采样时间有效地将离散值输入信号延迟可变的量。

Fortran S-Function 示例

下表列出了 matlabroot/toolbox/simulink/sfuntemplates/src 文件夹（打开）中可用的示例 Fortran^® S-Function。有关 Fortran S-Function的更多信息，请参阅 Create Level-2 Fortran S-Functions。

文件名	模型名称	描述
`sfun_atmos.c` `sfun_atmos_sub.F`	`sfcndemo_atmos`	使用 Fortran 子程序计算 1976 年标准大气至 86 公里。

C++ S-Function 示例

下表列出了 matlabroot/toolbox/simulink/sfuntemplates/src 文件夹（打开）中可用的示例 C++ S-Function。有关 C++ S-Function 的更多信息，请参阅 C/C++ S-Function 基础知识和 Build S-Functions Automatically Using S-Function Builder。

文件名	模型名称	描述
`sfun_counter_cpp.cpp`	`sfcndemo_counter_cpp`	将 C++ 对象存储在指针向量 `PWork` 中。
`sfbuilder_permute.cpp`	`sfbuilder_permutation`	通过使用 Start 和 Terminate 调用外部 C++ 类来实现排列。
`sfbuilder_linfilt.cpp`	`sfbuilder_upsampling`	使用 C++ STL 算法实现线性滤波，对符号波进行上采样。

在工程中组织 S-Function

以下示例显示如何将 S-Function 工件安排到工程中。这是使用 Blockset Designer 功能实现的。有关 Blockset Designer 的更多信息，请参阅 Create a Blockset Project。

文件名	描述
`slexBlocksetDesignerExample`	使用 Blockset Designer 将 S-Function 工件组织到单个工程中。

另请参阅

Level-2 MATLAB S-Function | S-Function Builder | S-Function | MATLAB Function