Main Content

本页对应的英文页面已更新,但尚未翻译。 若要查看最新内容,请点击此处访问英文页面。

MATLAB System

在模型中包含 System object

  • 库:
  • Simulink / User-Defined Functions

    HDL Coder / User-Defined Functions

说明

MATLAB System 模块将现有的 System object(基于 matlab.System)添加到 Simulink® 中。它还允许您使用 System object API 为 Simulink 开发新模块。有关此模块的详细信息,请参阅MATLAB System 模块

对于解释执行,模型使用 MATLAB® 执行引擎进行模块仿真。

对于代码生成,模型使用代码生成进行模块仿真(使用代码生成支持的 MATLAB 代码子集)。MATLAB System 模块仅支持 MATLAB 中的部分可用函数。有关完整的函数列表,请参阅 C/C++ 代码生成支持的函数和对象。这些函数包括那些常见类别的函数,例如:

System object

要使用 MATLAB System 模块,您必须先创建新的 System object™,或者使用现有的 System object。有关详细信息,请参阅使用 MATLAB System 模块集成 System object

端口

输入

全部展开

MATLAB System 模块接受模块特性表中所列类型的输入。该模块不支持使用虚拟总线作为输入或输出。它不支持包含可变大小信号的非虚拟总线。有关详细信息,请参阅 Simulink 支持的数据类型

有关此模块是否支持定点类型的详细信息,请参阅Code Acceleration and Code Generation from MATLAB (Fixed-Point Designer)

MATLAB System 模块支持 Simulink 帧。有关详细信息,请参阅Sample- and Frame-Based Concepts (DSP System Toolbox)

数据类型: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | fixed point

输出

全部展开

System object 返回的 MATLAB System 模块的信号输出。

数据类型: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | Boolean | fixed point | enumerated | bus

参数

全部展开

指定用户定义的 System object 类的完整名称,不包含文件扩展名。此输入区分大小写。类名称必须存在于 MATLAB 路径中。

可以通过以下方式之一来指定 System object:

  • 在文本框中输入名称。

  • 点击文本框中的列表箭头。如果当前文件夹中存在有效的 System object,其名称将出现在列表中。从此列表中选择一个 System object。

  • 浏览到包含有效 System object 的文件夹。如果该文件夹不在您的 MATLAB 路径中,本软件将提示您添加它。

如果您需要创建 System object,可以通过点击 New,使用模板进行创建。

当您保存 System object 之后,名称显示在 System object name 文本框中。

使用用户定义的 System object 类名的完整名称。此模块不接受您已分配给 System object 类名的 MATLAB 变量。

编程用法

模块参数System
类型:字符向量
Value:System object 的名称
默认值:' '

对 System object 模板选择下列选项之一。

Basic

启动 MATLAB 编辑器并显示一个模板,用最少的 System object 方法创建一个简单的 System object。

Advanced

启动 MATLAB 编辑器并显示一个模板,用最多的 System object 方法创建一个更高级的 System object。

Simulink Extension

启动 MATLAB 编辑器并显示一个文件,其中包含为 Simulink 自定义模块的实用工具。此文件与您在 MATLAB 中选择 New > System Object > Simulink Extension 扩展时所看到的文件相同。

当您保存 System object 之后,可在 System object name 文本框中输入其名称。

选择仿真模式。

Code generation

在第一次运行模型时,仅使用代码生成支持的 MATLAB 函数对 MATLAB System 模块进行仿真和生成代码。如果模块的结构未改变,后续模型运行将不会重新生成代码。

如果仿真模式是 “Code generation”,System object 最多接受 32 个输入。

Interpreted execution

使用支持的所有 MATLAB 函数进行模型仿真。选择此选项可能会降低仿真性能。

当您为模块分配有效的 System object 类名后,下次打开模块对话框时,即可看到此参数。每个 MATLAB System 模块都会出现此参数。您无法将其删除。

  • 如果模块没有选项卡,此参数将出现在对话框的底部。

  • 如果模块有多个选项卡,此参数将出现在对话框中第一个选项卡的底部。

On

将溢出饱和处理为数据类型能够表示的最小值或最大值。例如,一个有符号的 8 位整数的溢出可以饱和处理为 -128 或 127。

Off

溢出将绕回到数据类型可以表示的合适值。例如,数字 130 不适合一个有符号的 8 位整数,因此绕回 -126。

提示

  • 如果您的模型存在可能的溢出,而您希望在生成的代码中进行显式饱和保护,请考虑选中此复选框。

  • 如果您希望优化生成的代码的效率,请考虑清除此复选框。清除此复选框还可以帮助您避免过度地指定信号超出范围时的处理方式。有关详细信息,请参阅信号范围错误故障排除

  • 如果选中此复选框,饱和将应用于模块中的每个内部操作,而不仅仅应用于输出或结果。

  • 一般情况下,代码生成进程可以检测到何时不可能发生溢出。在这种情况下,代码生成器不会生成饱和代码。

依存关系

当您在 System object 中使用 showFiSettingsImpl 方法时,将出现此复选框。

编程用法

模块参数:SaturateOnIntegerOverflow
类型:字符向量
值:'off' | 'on'
默认值:'off'

选择将哪些继承的数据类型视为 fi 数据类型。

Fixed-point

将定点数据类型视为 fi 数据类型。

Fixed-point & Integer

将定点和整数数据类型视为 fi 数据类型。

依存关系

当您在 System object 中使用 showFiSettingsImpl 方法时,将出现此复选框。

选择要使用哪些定点数学运算设置。

Same as MATLAB

使用当前 MATLAB 定点数学运算设置。

Specify Other

启用编辑框,用于指定所需的定点数学运算设置。有关设置定点数学运算的信息,请参阅 fimath (Fixed-Point Designer)

依存关系

当您在 System object 中使用 showFiSettingsImpl 方法时,将出现此复选框。

模块特性

数据类型

Boolean[a] | bus[b][a] | double[a] | enumerated[a] | fixed point[a] | integer[a] | single[a]

直接馈通

多维信号

有限[a]

可变大小信号

有限[c][a]

过零检测

[a] 实际支持的数据类型或功能取决于模块实施。

[b] 有关详细信息,请参阅非虚拟总线和 MATLAB System 模块。

[c] 有关详细信息,请参阅“可变大小信号”。

扩展功能

在 R2013b 中推出