S-Function

在模型中包含 S-Function

库:
Simulink / User-Defined Functions

描述

通过 S-Function 模块，可以从模块图中访问 S-Function。由 S-Function 名称参数指定的 S-Function 可以是 1 级或 2 级 C MEX S-Function（有关如何创建 S-Function 的信息，请参阅MATLAB S-Function 基础知识）。

注意

使用 Level-2 MATLAB S-Function 模块，在模块图中包含一个 2 级 MATLAB^® S-Function。

S-Function 模块显示指定的 S-Function 的名称，以及该 S-Function 指定的输入和输出端口的数量。连接输入端口的信号必须具有 S-Function 为输入端口指定的维度。

示例

用动画演示倒立摆

此示例说明如何使用 Simulink® 对倒立摆系统建模进行动画演示。倒立摆的质心在枢轴点上方。为了稳定地保持此位置，当钟摆开始下落时，系统执行控制逻辑以将枢轴点移至质心下方。倒立摆是用于测试控制策略的经典动力学问题。

打开模型

使用 S-Function API 的自定义代码和手写代码块

此库提供不同类型的 Simulink® S-Function 示例。Simulink S-Function 允许您使用新的手动编码模块扩展 Simulink，与自定义外部代码对接，并创建与其他程序的实时接口。使用此示例在 C、C++、M 和 Fortran® 中访问包含 S-Function 的模型。

打开脚本

Run Quality Checks on S-Functions

Use S-Function analyzer programmatic interfaces to check S-functions for potential problems and improvements.

打开模型

端口

输入

全部展开

In — S-Function 模块的信号输入
标量 | 向量 | 矩阵

您可以使用 mdlInitializeSizes 回调函数来配置输入端口。使用 mdlInitializeSizes 函数指定输入端口的数量、输入信号的维度、每个端口的采样时间以及端口是否为直接馈通。

输出

全部展开

Out — S-Function 模块的信号输出
标量 | 向量 | 矩阵

您可以使用 mdlInitializeSizes 回调函数来配置输出端口。使用 mdlInitializeSizes 函数指定输出端口的数量、输出信号的维度以及每个端口的采样时间。

参数

全部展开

S-Function 名称 — S-Function 的名称
字符数组 (默认)

使用此参数指定 S-Function 的名称。

编程用法

模块参数：FunctionName

类型：字符向量

值：S-Function 的名称

默认值：'system'

S-Function 参数 — 其他 S-Function 参数。
元胞数组 (默认)

指定其他 S-Function 参数。

函数参数可以指定为 MATLAB 表达式或以逗号分隔的变量。例如，

A, B, C, D, [eye(2,2);zeros(2,2)]

请注意，尽管单个参数可以用括号括起来，但参数列表一定不能用括号括起来。

编程用法

模块参数：Parameters

类型：字符向量

值：S-Function 参数

默认值：' '

S-Function 模块 — 列出用于代码生成的其他文件
元胞数组 (默认)

仅当此模块代表 C MEX S-Function，并且您打算使用 Simulink^® Coder™ 软件从包含该模块的模型中生成代码时，此参数才适用。如果您使用此参数，当您准备好生成代码时，必须按照Control Regeneration of Top Model Code (Simulink Coder)中所述，强制代码生成器重新生成顶层模型。

有关使用此参数的详细信息，请参阅为 S-Function 指定其他源文件 (Simulink Coder)。

编程用法

模块参数：SFunctionModules

类型：字符向量

值：文件名字符向量

默认值：' '

模块特性

数据类型	`Boolean^a` \| `bus^a` \| `double^a` \| `fixed point^b^a` \| `half^a` \| `integer^a` \| `single^a` \| `string^a`
直接馈通	`是^a`
多维信号	`是^a`
可变大小信号	`是^a`
过零检测	`是^a`
^a 实际支持的数据类型或功能取决于模块实施。 ^b 有关在 S-Function 中使用定点数据类型的详细信息，请参阅 "编写定点 S-Function"。

扩展功能

C/C++ 代码生成
使用 Simulink® Coder™ 生成 C 代码和 C++ 代码。

实际代码生成支持取决于模块实现。
调用 MATLAB 的 S-Function 不支持代码生成。

定点转换
使用 Fixed-Point Designer™ 设计和仿真定点系统。

实际数据类型支持取决于模块实现。
有关在 S-Function 中使用定点数据类型的详细信息，请参阅集成外部代码 (Fixed-Point Designer)。

S-Function

描述