MATLAB Function

R2026b

在 Simulink 模型中包含 MATLAB 代码

库:
Simulink / User-Defined Functions
HDL Coder / User-Defined Functions

描述

MATLAB Function 模块使您能够编写在 Simulink^® 模型中执行的 MATLAB^® 函数。MATLAB 函数在仿真期间的每个时间步执行。有关将 MATLAB 代码集成到 Simulink 模型中的详细信息，请参阅使用 MATLAB Function 模块在 Simulink 中实现 MATLAB 函数。如果您有 Simulink Coder™ 许可证，您还可以从 MATLAB Function 模块为 Simulink Coder 目标生成 C/C++ 代码。

双击 MATLAB Function 模块可打开 MATLAB Function 模块编辑器，您可以在其中编写 MATLAB 函数。您还可以使用模型资源管理器或符号窗格来定义变量、添加输入触发器以及创建函数调用输出。有关详细信息，请参阅Create MATLAB Function Block Variables、Manage the Input Trigger of a MATLAB Function Block和Manage Function Call Outputs of a MATLAB Function Block。

在符号窗格中，您可以将模块输入声明为 Simulink 参数，而不是端口。MATLAB Function 模块还支持继承输入、输出和参数的类型及大小。您可以显式指定这些属性。请参阅指定 MATLAB Function 模块中变量的数据类型、指定 MATLAB Function 模块变量的大小和通过使用参数变量访问 MATLAB Function 模块中的工作区数据。

当您仿真包含 MATLAB Function 模块的模型时，软件会从该模块生成二进制代码或 C/C++ 语言的 MATLAB 可执行文件 (MEX) 代码，并将此代码与模型集成。MATLAB Function 模块使用与 MATLAB Coder 相同的基础架构，您可使用该基础架构从 Simulink 之外的 MATLAB 代码生成 C/C++ 代码。因此，MATLAB Function 模块代码必须使用代码生成支持的 MATLAB 约定。请参阅Code and Integration Limitations for MATLAB Function Blocks。

为支持数据可视化，MATLAB Function 模块仅支持调用 MATLAB 函数进行仿真。请参阅使用 MATLAB 引擎在生成的代码中执行函数调用 (MATLAB Coder)。如果使用 Simulink Coder 生成代码，并且函数调用不直接影响 Simulink 输入或输出，则调用不会出现在生成的代码中。

示例

全部展开

将输入信号乘以 2

将 MATLAB Function 添加到您的模型中以修改输入信号。

在仿真选项卡中，点击库浏览器。选择 Simulink > 用户定义的函数。将 MATLAB Function 模块拖到 Simulink 画布上。
双击模块以打开 MATLAB Function 模块编辑器。用以下代码替换函数体代码：
```
y = 2*u;
```
通过点击“向上到父级”按钮返回到模型。添加 Sine Wave 模块作为输入信号，并添加 Scope 模块来采集 MATLAB Function 模块的输入和输出。
运行仿真并打开 Scope 模块以查看代码的效果。

扩展示例

使用包含 MATLAB Function 模块的封装库子系统运行仿真并生成代码

使用带有库中自定义 MATLAB Function 模块的模型运行仿真并生成代码。

打开模型

Call MATLAB Function Files in MATLAB Function Blocks

Use MATLAB Function blocks to call and execute code written in MATLAB function files.

打开模型

Spiral Galaxy Formation Simulation Using MATLAB Function Blocks

Use MATLAB Function blocks to simulate and plot galaxy interactions.

打开模型

限制

虽然此模块的代码会尝试生成与 MATLAB 完全相同的结果，但由于存在舍入误差，因此仍可能产生差异。这些数值差异最初可能是几个 eps，在重复运算之后可能会放大。建议您不要依赖 nan 的行为。对于相同的计算，不同的 C 编译器可能产生不同的结果。
MATLAB Function 模块中不允许递归调用。

端口

输入

全部展开

Port_1 — 输入变量
标量 | 向量 | 矩阵

MATLAB 函数中的输入变量，指定为实数值标量、向量或矩阵。每个输入变量都有一个使用该变量名称的关联端口。

您不能在 Simulink 模型和 MATLAB Function 模块中的函数之间传递 MATLAB 支持但 Simulink 不支持的数据类型。您可以在 MATLAB Function 模块中使用这些数据类型。

有关此模块支持的定点数据类型的详细信息，请参阅Fixed-Point Data Types with MATLAB Function Block (Fixed-Point Designer)和Data Type Override with MATLAB Function Block (Fixed-Point Designer)。

依赖关系

要创建输入端口，请打开模块并在符号窗格中创建输入变量。请参阅Create MATLAB Function Block Variables。

输出

全部展开

Port_1 — 输出变量
标量 | 向量 | 矩阵

MATLAB 函数中的输出变量，指定为实数值标量、向量或矩阵。每个输出变量都有一个使用该变量名称的关联端口。

依赖关系

要创建输出端口，请打开模块并在符号窗格中创建输出变量。请参阅Create MATLAB Function Block Variables。

参数

全部展开

要以交互方式编辑模块参数，请使用属性检查器。在 Simulink 工具条中，在仿真选项卡的准备库中，选择属性检查器。

注意

MATLAB Function 模块也有 Subsystem 模块参数，您可以通过右键点击模块并点击“模块参数”按钮来访问这些参数。使用这些参数来指定模块代码生成参数。不推荐更新其他模块参数。

更新方法 — 用于激活模块的方法
继承 (默认) | 离散 | 连续

将激活 MATLAB Function 模块的方法指定为以下值之一：

继承 - 来自 Simulink 模型的输入激活 MATLAB Function 模块。
如果您定义输入触发器，则 MATLAB Function 模块会执行，以响应触发端口上的 Simulink 信号或函数调用事件。如果您没有定义输入触发器，则 MATLAB Function 模块将从模型中隐式继承触发器。这些隐式事件是向模块提供输入的信号的离散或连续采样时间。
如果您定义了数据输入，则 MATLAB Function 模块以最快的数据输入速率进行采样。如果未定义数据输入，则 MATLAB Function 模块以父级子系统的执行行为定义的速率进行采样。
离散 - MATLAB Function 模块使用您在模块的采样时间参数中指定的速率激活。该模块以对应于指定速率的固定时间间隔生成隐式事件。模型中的其他模块可以有不同采样时间。
连续 - MATLAB Function 模块仅在主时间步期间激活，在主时间步和子时间步内都会计算输出和局部连续变量。模块可以记录过零，这样，只要状态发生变化，Simulink 模型就可以对模块进行采样。模块计算局部连续变量的导数。

编程用法

要以编程方式设置模块参数值，请使用圆点表示法访问模块的 MATLABFunctionConfiguration 或 Stateflow.EMChart 对象和更改对象属性。

如果使用 MATLABFunctionConfiguration 对象，请使用以下选项指定属性：

参数:	`UpdateMethod`
值:	`"Inherited"` (默认) \| `"Continuous"` \| `"Discrete"`

如果使用 Stateflow.EMChart 对象，请使用以下选项指定属性：

参数:	`ChartUpdate`
值:	`"INHERITED"` (默认) \| `"CONTINUOUS"` \| `"DISCRETE"`

采样时间 — 仿真期间模块激活的时间间隔
`-1` (默认) | 标量 | 向量

指定在仿真期间 MATLAB Function 模块激活的时间间隔。默认值表示模块从 Simulink 继承采样时间。有关指定采样时间的详细信息，请参阅指定采样时间。

不要在 Subsystem 模块参数中使用采样时间参数。请改用属性检查器。

依赖关系

要启用此参数，请将更新方法设置为离散。

编程用法

要以编程方式设置模块参数值，请使用圆点表示法访问模块的 MATLABFunctionConfiguration 或 Stateflow.EMChart 对象和更改对象属性。

参数:	`SampleTime`
值:	`"-1"` (默认) \| scalar \| vector
数据类型:	`string` \| `char`

高级

对整数溢出进行饱和处理 — 数据是否对整数溢出进行饱和处理
`on` (默认) | `off`

将 MATLAB Function 模块中的数据在发生整数溢出时是否进行饱和指定为以下值之一：

on - 模块通过将整数设置为字长允许的最大正值或负值对整数进行饱和处理。此设置匹配 MATLAB 行为。
off - 当发生溢出情况时，模块在仿真模式下生成运行时错误。当您使用 Simulink Coder 生成代码时，行为取决于您的 C 语言编译器。

提示

当此参数为 on 时，MATLAB 会在仿真期间添加额外的检查以检测整数上溢或下溢。如果 MATLAB Function 模块代码中没有发生整数溢出，则禁用此选项会更高效。
由 Simulink Coder 生成的代码不检查整数上溢或下溢，因此，当此参数为 off 时，可能会产生不可预测的结果。在这种情况下，请在生成代码之前仿真您的模型以测试上溢和下溢。
此参数设置仅与整数算术相关。它对定点或双精度算术不起作用。

编程用法

要以编程方式设置模块参数值，请使用圆点表示法访问模块的 MATLABFunctionConfiguration 或 Stateflow.EMChart 对象和更改对象属性。

参数:	`SaturateOnIntegerOverflow`
值:	`true` or `1` (默认) \| `false` or `0`
数据类型:	`logical`

支持可变大小数组 — 模块是否支持可变大小数据
`on` (默认) | `off`

指定 MATLAB Function 模块是否支持在仿真期间维度可变的输入和输出数据。当此参数为 on 时，您可以通过启用输出变量的可变大小属性来定义可变大小输出。有关详细信息，请参阅声明可变大小的 MATLAB Function 模块变量和Variable size。

编程用法

要以编程方式设置模块参数值，请使用圆点表示法访问模块的 MATLABFunctionConfiguration 或 Stateflow.EMChart 对象和更改对象属性。

参数:	`SupportVariableSizing`
值:	`true` or `1` (默认) \| `false` or `0`
数据类型:	`logical`

允许直接馈通 — 模块是否支持直接馈通语义
`on` (默认) | `off`

指定 MATLAB Function 模块是否支持直接馈通语义，以便输入的值直接控制模块的输出。当此参数为 off 时，模块输出仅依赖模块的当前状态。使用非直接馈通使您能够在反馈环中使用 MATLAB Function 模块并防止代数环。有关详细信息，请参阅 Use Nondirect Feedthrough in a MATLAB Function Block。

依赖关系

要禁用此参数，您必须将更新方法设置为继承或离散。

编程用法

要以编程方式设置模块参数值，请使用圆点表示法访问模块的 MATLABFunctionConfiguration 或 Stateflow.EMChart 对象和更改对象属性。

参数:	`AllowDirectFeedthrough`
值:	`true` or `1` (默认) \| `false` or `0`
数据类型:	`logical`

将输出列向量解释为一维数据 — 模块是否将输出 N×1 矩阵解释为一维信号
`off` (默认) | `on`

指定 MATLAB Function 模块是否将输出的 N×1 矩阵转换为一维向量信号，指定为以下值之一：

off - 模块将输出的大小为 N×1 的矩阵解释为 N×1 矩阵信号。
on - 模块将输出的大小为 N×1 的矩阵解释为 N 元素向量信号。

尽管您在 MATLAB Function 模块中编写的 MATLAB 代码像普通 MATLAB 代码一样计算数组维度，但 Simulink 会区分 N 元素向量与 1×N 和 N×1 矩阵。有关 Simulink 信号维度的详细信息，请参阅确定信号维度。

编程用法

要以编程方式设置模块参数值，请使用圆点表示法访问模块的 MATLABFunctionConfiguration 或 Stateflow.EMChart 对象和更改对象属性。

参数:	`VectorOutputs1D`
值:	`false` or `0` (默认) \| `true` or `1`
数据类型:	`logical`

将长度为 1 的维度视为固定大小 — 模块是否将输出的可变维度视为固定大小
`on` (默认) | `off`

自 R2023a 起

指定模块是否将输出可变维度视为固定大小，指定为以下值之一：

on - 模块将长度为 1 的每个模块可变维度视为固定大小。对于超出 1 的其他维度，如果启用了模块变量的可变大小属性，则模块将这些维度视为可变大小。
off - 启用了可变大小属性的模块输出变量始终为可变大小。

有关详细信息，请参阅Variable size。

编程用法

要以编程方式设置模块参数值，请使用圆点表示法访问模块的 MATLABFunctionConfiguration 或 Stateflow.EMChart 对象和更改对象属性。

参数:	`TreatDimensionOfLengthOneAsFixedSize`
值:	`true` or `1` (默认) \| `false` or `0`
数据类型:	`logical`

定点属性

将这些继承的 Simulink 信号类型视为 fi 对象 — 模块如何处理输入整数和 `fi` 对象
`Fixed-point` (默认) | `Fixed-point & Integer`

选择是否将定点输入和整数输入视为 fi (Fixed-Point Designer) 对象。

Fixed-point - MATLAB Function 模块将定点输入视为 Fixed-Point Designer™ fi 对象。
Fixed-point & Integer - MATLAB Function 模块将定点和整数输入视为 Fixed-Point Designer fi 对象。

有关详细信息，请参阅Ways to Construct fi Objects (Fixed-Point Designer)。

编程用法

要以编程方式设置模块参数值，请使用圆点表示法访问模块的 MATLABFunctionConfiguration 或 Stateflow.EMChart 对象和更改对象属性。

参数:	`TreatAsFi`
值:	`"Fixed-point"` (默认) \| `"Fixed-point & Integer"`

MATLAB 函数 fimath — 默认 `fimath` 属性
`Same as MATLAB` (默认) | `Specify Other`

将 MATLAB Function 模块的默认 fimath (Fixed-Point Designer) 对象属性指定为以下值之一：

Same as MATLAB - 模块使用与当前默认 fimath 对象相同的 fimath 对象属性。文本框灰显，并以只读形式显示当前全局 fimath 对象。
Specify other - 以两种方式之一在文本框中指定您自己的 fimath 对象：
- 在文本框内构造 fimath 对象。
- 在 MATLAB 或模型工作区中构造 fimath 对象，然后在文本框中输入其变量名称。如果您使用此选项并计划与其他人共享您的模型，请在模型工作区中定义此变量。

有关详细信息，请参阅 fimath Object Construction (Fixed-Point Designer)和Fixed-Point Data Types with MATLAB Function Block (Fixed-Point Designer)。

提示

MATLAB Function 模块的 fimath 对象对于该模块的内容表现为 globalfimath (Fixed-Point Designer) 对象。该模块将此参数中的 fimath 对象属性与您选择视为 fi 对象的 MATLAB Function 模块的所有定点和整数输入信号相关联。在 MATLAB Function 模块中构造 fi 对象需要考虑其他注意事项。
- 如果在构造 fi 对象时没有与之相关联的 fimath 对象，则 fi 构造函数使用默认 fimath 对象设置，而不考虑 MATLAB 函数 fimath 中的属性。如果在构造 fi 对象后对其执行操作，该对象将采用 MATLAB 函数 fimath 中的属性。
- 如果您在 fi 构造函数中指定 fimath 对象，则 fi 构造函数在量化值时遵循该 fimath 对象。fi 构造函数中未指定的任何 fimath 对象设置都使用 MATLAB 函数 fimath 中的指定属性。

编程用法

要以编程方式设置模块参数值，请使用圆点表示法访问模块的 MATLABFunctionConfiguration 或 Stateflow.EMChart 对象和更改关联的对象属性。

如果使用 MATLABFunctionConfiguration 对象，请使用以下选项指定属性：

参数:	`FimathMode`
值:	`"SameAsMATLAB"` (默认) \| `"UserSpecified"`

如果使用 Stateflow.EMChart 对象，请使用以下选项指定属性：

参数:	`EmlDefaultFimath`
值:	`"Same as MATLAB Default"` (默认) \| `"Other:UserSpecified"`

模块特性

数据类型	`Boolean^a` \| `bus^a` \| `double^a` \| `enumerated^a` \| `fixed point^a` \| `half^a` \| `integer^a` \| `single^a` \| `string^a`
直接馈通	`是^a`
多维信号	`是^a`
可变大小信号	`是^a`
过零检测	`否`
^a 实际支持的数据类型或功能取决于模块实施。

提示

您可以调用在以下各项中定义的函数：
- Simulink Function 模块。
- 图中的 Stateflow^® 函数。要调用图中的函数，请启用导出图级别函数和将导出的函数视为全局可见属性。
默认情况下，MATLAB Function 模块不包括 %#codegen (MATLAB Coder) 指令，但在检查错误时就如果包含该指令一样。将 %#codegen 指令添加到 MATLAB Function 模块不会影响错误检查。

扩展功能

全部展开

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

实际数据类型或功能支持取决于模块实现。

如果您有 Embedded Coder^® 许可证，您可以生成 Halide 代码。有关详细信息，请参阅Speed Up Generated Code Execution with Halide Code (Embedded Coder)。

HDL 代码生成
使用 HDL Coder™ 为 FPGA 和 ASIC 设计生成 VHDL、Verilog 和 SystemVerilog 代码。

HDL Coder™ 提供影响 HDL 实现和综合逻辑的额外配置选项。数据类型和能力支持取决于模块实现。有关使用 MATLAB Function 模块的最佳做法，请参阅：

Use hdlfimath Setting and Specify fi Objects inside MATLAB Function Block (HDL Coder)
Design Guidelines for the MATLAB Function Block (HDL Coder)
Generate Instantiable Code for Functions (HDL Coder)
Optimize MATLAB Loops (HDL Coder)
Pipeline MATLAB Expressions (HDL Coder)

HDL 架构

MATLAB 函数（默认值）

此架构是使用定点数据类型的 MATLAB Function 模块的默认架构。当您使用此架构时，您可以对 MATLAB Function 模块周围的模块使用速度和面积优化。HDL Coder 不优化 MATLAB Function 模块内部的代码。

MATLAB Datapath

此架构是使用浮点数据类型的 MATLAB Function 模块的默认架构。当您使用此架构时，HDL Coder 将 MATLAB Function 模块视为 Subsystem 模块。对于定点数据类型，使用此架构在 MATLAB Function 模块内部以及跨 MATLAB Function 模块与其他 Simulink 模块的边界应用速度和面积优化。

通过此功能，您可以为 MATLAB Function 模块指定要为 Subsystem 模块指定的其他属性，例如 ClockRatePipelining 和 FlattenHierarchy。

HDL 模块属性

AdaptivePipelining	基于综合工具、目标频率和乘法器字长的自动流水线插入。默认值为 inherit。要指定此属性，请将架构设置为 `MATLAB Datapath`。另请参阅AdaptivePipelining (HDL Coder)。
BalanceDelays	检测沿一条路径引入的新延迟，并在其他路径上插入匹配的延迟。默认值为 inherit。要指定此属性，请将架构设置为 `MATLAB Datapath`。另请参阅BalanceDelays (HDL Coder)。
ClockRatePipelining	以较快的时钟频率而不是较慢的数据速率插入流水线寄存器。默认值为 inherit。要指定此属性，请将架构设置为 `MATLAB Datapath`。另请参阅ClockRatePipelining (HDL Coder)。
ConstMultiplierOptimization	正则有符号数 (CSD) 或因子化 CSD 优化。默认值为无。另请参阅ConstMultiplierOptimization (HDL Coder)。
ConstrainedOutputPipeline	通过移动设计中现有延迟的方式来放置在输出端的寄存器的数量。分布式流水线不会重新分发这些寄存器。默认值为 `0`。有关详细信息，请参阅ConstrainedOutputPipeline (HDL Coder)。
DistributedPipelining	流水线寄存器分配或寄存器重定时。默认值为 inherit。另请参阅DistributedPipelining (HDL Coder)。
FlattenHierarchy	从生成的 HDL 代码中删除 MATLAB Function 模块层次结构。默认值为 inherit。要指定此属性，请将架构设置为 `MATLAB Datapath`。另请参阅FlattenHierarchy (HDL Coder)。
GuardIndexVariables	选择是否将矩阵访问提升到条件 MATLAB 语句外部。默认值为 off。要指定此属性，请将架构设置为 `MATLAB Function`。另请参阅GuardIndexVariables (HDL Coder)。
InputPipeline	要在生成的代码中插入的输入流水线阶段数。分布式流水线和受限输出流水线可以移动这些寄存器。默认值为 `0`。有关详细信息，请参阅InputPipeline (HDL Coder)。
InstantiateFunctions	为每个函数生成 VHDL^® `entity` 或 Verilog^® `module`。默认值为 off。另请参阅InstantiateFunctions (HDL Coder)。
LoopOptimization	展开、流化或不优化循环。默认值为无。如果您将架构设置为 `MATLAB Datapath`，您只能展开循环。如果您要在 `MATLAB Datapath` 架构中使用循环流，可以通过指定 StreamingFactor 来使用流式处理优化。另请参阅LoopOptimization (HDL Coder)。
MapPersistentVarsToRAM	将持久数组映射到 RAM。默认值为 off。另请参阅MapPersistentVarsToRAM (HDL Coder)。
OutputPipeline	要在生成的代码中插入的输出流水线阶段数。分布式流水线和受限输出流水线可以移动这些寄存器。默认值为 `0`。有关详细信息，请参阅OutputPipeline (HDL Coder)。
ResetType	隐藏重置逻辑生成。默认值为默认，它生成重置逻辑。另请参阅ResetType (HDL Coder)。
SharingFactor	要映射到单个共享资源的功能等效的资源的数量。默认值为 0。另请参阅Resource Sharing (HDL Coder)。
StreamingFactor	并行数据路径或向量的数量，这些路径或向量通过时间多路复用的方式变换为串行标量数据路径。默认值为 0，表示实现完全并行的数据路径。要指定此属性，请将架构设置为 `MATLAB Datapath`。另请参阅Streaming (HDL Coder)。
VariablesToPipeline	警告不推荐使用 `VariablesToPipeline`。请改用 `coder.hdl.pipeline` (HDL Coder)。在一个或多个指定变量的输出端插入流水线寄存器。将变量列表指定为字符向量，变量之间用空格分隔。要指定此属性，请将架构设置为 `MATLAB Function`。
SynthesisAttributes	指定模型中模块和模块输出信号的综合属性。生成的 HDL 代码包含这些属性。有关详细信息，请参阅SynthesisAttributes (HDL Coder)。

数据类型支持

对于 MATLAB Function 模块中的以下函数，HDL 代码生成支持半精度数据类型：

`all`	`and, &`	`any`	`cast`	`conj`	`ctranspose`
`end`	`=`	`eq`	`==`	`ge, >=`	`gt, >`
`half`	`inf`	`int8`	`int16`	`int32`	`int64`
`isa`	`iscolumn`	`isempty`	`isequal`	`isfinite`	`isfloat`
`isinf`	`isinteger`	`islogical`	`isnan`	`isnumeric`	`isreal`
`isrow`	`isscalar`	`isvector`	`le, <=`	`length`	`logical`
`lt, <`	`max`	`min`	`minus, -`	`NaN`	`ndims`
`ne, ~=`	`not`	`numel`	`or, \|`	`plus, +`	`prod`
`reshape`	`single`	`size`	`sqrt`	`sum`	`times, .*`
`transpose`	`typecast`	`uint8`	`uint16`	`uint32`	`uint64`
`uminus`	`uplus`	`vertconcat`	-	-	-

复数数据支持

此模块支持复信号的代码生成。

另请参阅Complex Data Type Support (HDL Coder)。

使用 hdlfimath 设置

hdlfimath 函数定义针对 HDL 代码生成优化的 fimath 属性。有关详细信息，请参阅Use hdlfimath Setting and Specify fi Objects inside MATLAB Function Block (HDL Coder)。

可调参数支持

HDL Coder 支持具有以下数据类型的可调和不可调参数：

标量
向量
复数
结构体
枚举

有关详细信息，请参阅Generate DUT Ports for Tunable Parameters (HDL Coder)和Design Guidelines for the MATLAB Function Block (HDL Coder)。

使用原子子系统和代数环生成 HDL 代码

要为包含具有原子子系统和代数环的 MATLAB Function 模块的模型生成 HDL 代码，请执行以下操作：

在“配置参数”对话框的诊断窗格中，将代数环和未消除人为代数环实例参数设置为无或警告。
在 MATLAB Function 模块的“模块参数”对话框中，选择视为原子单元和尽量减少出现人为代数环参数。

限制

如果模块包含 System object™，则模块输入不能包含常量或 Inf 采样时间。
HDL Coder 不支持将同一变量同时用作输入和输出参量的 MATLAB Function 模块。例如，不支持使用以下 MATLAB 代码：
```
function y = myFun(y)
%#codegen
y = 3 * y;
```
模块仅在原生浮点模式下支持浮点数据类型。
typecast 函数仅在源数据类型和目标数据类型具有相等位宽时才支持 HDL 代码生成。不支持逻辑值数据类型。支持的类型对包括：
- uint32, single
- int32, single
- uint64, double
- int64, double
- uint16, half
- int16, half

有关基于 MATLAB Function 模块的 HDL 代码生成支持的 MATLAB 语言子集，请参阅 Supported MATLAB Data Types, Operators, and Control Flow Statements (HDL Coder)。

PLC 代码生成
使用 Simulink® PLC Coder™ 生成结构化文本代码。

PLC 模块属性

UseExternalDefinition

在生成的代码中取消模块定义。默认值为 Off。另请参阅UseExternalDefinition (Simulink PLC Coder)。

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

实际数据类型或功能支持取决于模块实现。

版本历史记录

在 R2011a 中推出

全部展开

R2026b: 为嵌套总线数组输入和输出生成 HDL 代码

现在，您可以为使用嵌套总线数组作为输入或输出的 MATLAB Function 模块生成 HDL 代码，包括包含矩阵类型信号的总线元素。

R2026a: 指定模块和模块输出信号的综合属性

使用 SynthesisAttributes HDL 模块属性指定模块及其输出信号的综合属性。HDL Coder 在生成的 HDL 代码中包含这些属性。

R2026a: DSPStyle HDL 模块属性已删除

DSPStyle HDL 模块属性已删除。要为乘法器映射指定综合特性，请改用 SynthesisAttributes HDL 模块属性。

R2023a: 指定如何处理维度长度为 1 的输出变量

使用新的将长度为 1 的维度视为固定大小参数，您可以指定当至少一个维度的长度为 1 时，MATLAB Function 模块如何处理输出变量。在 R2023a 之前，MATLAB Function 模块将一个维度长度为 1 的输出变量视为固定大小，无论您是否将变量指定为具有可变大小。

R2021b: 将列向量输出为二维或一维数据

您可以使用将输出列向量解释为一维数据参数将 MATLAB Function 模块中的列向量输出为二维或一维数据。

R2021a: 报告 MATLAB Function 模块在快速加速模式下的运行时错误

通过将启用内存完整性检查配置参数设置为始终打开，报告在快速加速模式下进行仿真时 MATLAB Function 模块的运行时错误。

R2020a: 对 MATLAB Function 模块的 64 位整数类型支持

MATLAB Function 模块现在支持 64 位整数数据。该模块将 int64 和 uint64 数据类型实现为定点数，字长为 64 位，小数长度为 0。

MATLAB Function

描述

示例

将输入信号乘以 2

扩展示例

使用包含 MATLAB Function 模块的封装库子系统运行仿真并生成代码

Call MATLAB Function Files in MATLAB Function Blocks

Spiral Galaxy Formation Simulation Using MATLAB Function Blocks

限制

端口

输入

Port_1 — 输入变量 标量 | 向量 | 矩阵

依赖关系

输出

Port_1 — 输出变量 标量 | 向量 | 矩阵

依赖关系

参数

更新方法 — 用于激活模块的方法 继承 (默认) | 离散 | 连续

编程用法

采样时间 — 仿真期间模块激活的时间间隔 -1 (默认) | 标量 | 向量

依赖关系

编程用法

高级

对整数溢出进行饱和处理 — 数据是否对整数溢出进行饱和处理 on (默认) | off

提示

编程用法

支持可变大小数组 — 模块是否支持可变大小数据 on (默认) | off

编程用法

允许直接馈通 — 模块是否支持直接馈通语义 on (默认) | off

依赖关系

编程用法

将输出列向量解释为一维数据 — 模块是否将输出 N×1 矩阵解释为一维信号 off (默认) | on

编程用法

将长度为 1 的维度视为固定大小 — 模块是否将输出的可变维度视为固定大小 on (默认) | off

编程用法

定点属性

将这些继承的 Simulink 信号类型视为 fi 对象 — 模块如何处理输入整数和 fi 对象 Fixed-point (默认) | Fixed-point & Integer

编程用法

MATLAB 函数 fimath — 默认 fimath 属性 Same as MATLAB (默认) | Specify Other

提示

编程用法

模块特性

提示

扩展功能

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

HDL 代码生成 使用 HDL Coder™ 为 FPGA 和 ASIC 设计生成 VHDL、Verilog 和 SystemVerilog 代码。

PLC 代码生成 使用 Simulink® PLC Coder™ 生成结构化文本代码。

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

版本历史记录

R2026b: 为嵌套总线数组输入和输出生成 HDL 代码

R2026a: 指定模块和模块输出信号的综合属性

R2026a: DSPStyle HDL 模块属性已删除

R2023a: 指定如何处理维度长度为 1 的输出变量

R2021b: 将列向量输出为二维或一维数据

R2021a: 报告 MATLAB Function 模块在快速加速模式下的运行时错误

R2020a: 对 MATLAB Function 模块的 64 位整数类型支持

R2019b: 对 MATLAB Function 模块的字符串支持

另请参阅

主题

Port_1 — 输入变量
标量 | 向量 | 矩阵

Port_1 — 输出变量
标量 | 向量 | 矩阵

更新方法 — 用于激活模块的方法
继承 (默认) | 离散 | 连续

采样时间 — 仿真期间模块激活的时间间隔
`-1` (默认) | 标量 | 向量

对整数溢出进行饱和处理 — 数据是否对整数溢出进行饱和处理
`on` (默认) | `off`

支持可变大小数组 — 模块是否支持可变大小数据
`on` (默认) | `off`

允许直接馈通 — 模块是否支持直接馈通语义
`on` (默认) | `off`

将输出列向量解释为一维数据 — 模块是否将输出 N×1 矩阵解释为一维信号
`off` (默认) | `on`

将长度为 1 的维度视为固定大小 — 模块是否将输出的可变维度视为固定大小
`on` (默认) | `off`

将这些继承的 Simulink 信号类型视为 fi 对象 — 模块如何处理输入整数和 `fi` 对象
`Fixed-point` (默认) | `Fixed-point & Integer`

MATLAB 函数 fimath — 默认 `fimath` 属性
`Same as MATLAB` (默认) | `Specify Other`

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

HDL 代码生成
使用 HDL Coder™ 为 FPGA 和 ASIC 设计生成 VHDL、Verilog 和 SystemVerilog 代码。

PLC 代码生成
使用 Simulink® PLC Coder™ 生成结构化文本代码。

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