主要内容

FMU

包括功能模型单元(FMU)

  • 库:
  • 金宝appSimulink Extras / FMU导入

  • FMU块

描述

FMU块将现有的功能模型单元(FMUs)导入Simulink金宝app®.该块会根据你想导入的现有FMU自动选择一个FMU模式:

  • 联合仿真-集成实现功能模拟接口(FMI)联合仿真接口的FMUs。这些FMUs可能包含用于工具耦合的局部求解器。

  • 模型交换-集成实现FMI模型交换接口的FMUs。这些FMUs不包含局部求解器。相反,它们继承了Simulink的求解器。金宝app

此块支持FMI版本1.金宝app0和2.0。对于FMI 2.0版本,如果您的FMU同时包含Co-Simulation和Model Exchange元素,则块将检测到它们并提示您选择希望块在其中操作的模式。

要使用这个块,首先必须有一个现有的FMU,从另一个工具导出,或者用C语言编写。

港口

输出参数

全部展开

不产生输出的占位符端口。输入和输出端口是在将实际的FMU导入块时配置的。输入和输出端口都支持数值和字符串数据类型。金宝app

参数

全部展开

指定FMU的名称,带或不带文件扩展名。该条目区分大小写。FMU必须在MATLAB中存在®路径。

要指定FMU名称,请在FMU名字文本框中。

当你点击好吧,该块创建一个/ slprj / _fmu /unique_ID文件夹与解包文件和文件层次结构完整。

依赖关系

当您指定一个FMU名称时,块对话框更新为包含四个选项卡:

  • 参数

  • 模拟

  • 输入总线

  • 输出总线

编程使用

块参数:FMUName
类型:特征向量
价值观:FMU的名称,带或不带文件扩展名
默认值:' '

参数

该选项卡列出FMU中定义的参数。

  • 若要仅显示感兴趣的参数,请在筛选字段中键入搜索字符串。该字符串可以匹配描述中的参数名称或文本。

  • 在参数表中,可以修改参数的值价值字段。

属性可以更改结构化模型参数的层次结构FMUParamMapping块参数,使用set_param函数。此块参数可以设置为继承结构化.它被设置为继承默认情况下。设置为将结构化模型参数分离为具有相应参数名和值的单个参数。设置为结构化将模型参数组合成参数值结构。

模拟

选中此复选框可启用对FMU的公差值规范。否则,请清除此复选框。

依赖关系

仅当FMU版本或模式支持公差值时,此参数才适用。金宝app

编程使用

块参数:FMUIsToleranceUsed
类型:特征向量
价值观:On | off
默认值:“关闭”

FMU相对公差值(%),指定为标量。

依赖关系

仅当FMU版本或模式支持公差值时,此参数才适用。金宝app

编程使用

块参数:FMUToleranceValue
类型:特征向量
价值观:1 e - 3|标量
默认值:“1 e - 3”

模拟期间的通信步长,指定为标量。指定块的模拟时间瞬间之间的时间间隔。有关更多信息,请参见时间的考虑

在大多数情况下,为了防止意外行为,请将此值设置为正值。若要从驱动块或模型求解器继承采样时间,请将此参数设置为-1.有关更多信息,请参见指定采样时间

该块支持不同类型的采金宝app样时间,包括连续的、离散的和继承的。然而,常见的联合仿真FMUs仅支持无偏移量(如正标量)的周期性离散采样金宝app次数。

依赖关系

该参数仅在Co-Simulation模式下有效。

编程使用

块参数:FMUSampleTime
类型:特征向量
价值观:标量
默认值:' 1 '

要启用显示FMU调试日志,请选中此复选框。否则,请清除此复选框。

编程使用

块参数:FMUDebugLogging
类型:1xN单元数组的字符向量
价值观:On | off
默认值:“关闭”

根据类型过滤调试日志,通过选中这些复选框指定:

  • 好吧

  • 警告

  • 丢弃

  • 错误

  • 致命的

  • 等待

编程使用

块参数:FMUDebugLoggingFilter
类型:特征向量
价值观:好吧|警告|丢弃|错误|致命的|等待
默认值:“好吧”|“警告”|“丢弃”|“错误”|“致命”|“等待”

直接调试日志,指定为:

  • 文件-流至slprj / _fmu / _logs_modelname/modelname_FMUblockname. txt

  • 显示-流到MATLAB命令窗口。

依赖关系

将此参数设置为文件使打开FMU日志文件…链接。

编程使用

块参数:FMUDebugLoggingRedirect
类型:特征向量
价值观:文件|显示
默认值:“文件”

输入

这个选项卡列出了在FMU中指定的输入变量modelDescription.xml

为结构化输入端口指定变量。

若要按名称筛选变量,请在文本框中键入变量名称。

变量表列出了层次结构顶部节点及其子节点的变量及其值,您可以在此选项卡上编辑其中许多变量。

  • Name—变量名称。这是不可编辑的。

  • 可见性—选中此复选框可在该块上为变量启用输入端口。清除此复选框可删除端口。

    在顶级节点上选择此复选框将使子节点可见为块的一个端口。

    请注意

    当你点击应用时,块端口数变化。记住相应地添加或删除连接。

  • 开始-添加中定义的开始值modelDescription.xml.你不能:

    • 当相应的输入端口可见时,修改起始值。

    • 向非叶节点添加起始值。(只能为叶节点编辑起始值。)

  • 总线对象名称—设置与端口对应的总线对象变量。默认情况下,该变量使用中定义的结构化变量名modelDescription.xml.要在工作区中创建一个新变量,请使用fmudialog.createBusType

更改任何变量值将启用将输出恢复到默认设置按钮,单击可恢复原设置。

参数可以改变FMU模块输入端口的布局FMUInputMapping参数使用set_param函数。可设置为继承结构化.它被设置为继承默认情况下。将参数设置为将总线输入端口分离为单独的总线元件信号输入端口。将参数设置为结构化将各个总线元素输入端口组合为总线输入端口。

输出

这个选项卡列出了在FMU中指定的输出变量modelDescription.xml

为结构化输出端口指定变量。

若要按名称筛选变量,请在文本框中键入变量名称。

变量表列出了层次结构顶部节点及其子节点的变量及其值,您可以在此选项卡上编辑其中许多变量。

  • Name—变量名称。这是不可编辑的。

  • 可见性—选中此复选框可在该块上为变量启用输出端口。清除此复选框可删除端口。如果这个FMU中存在内部变量,您可以启用或禁用单个内部变量的可见性。如果选择了内部变量,它将创建一个额外的输出端口。

    在顶级节点上选择此复选框将使子节点可见为块的一个端口。

    请注意

    当你点击应用时,块端口数变化。记住相应地添加或删除连接。

  • 开始-添加中定义的开始值modelDescription.xml.不能更改或添加输出变量的起始值。

  • 总线对象名称—设置与端口对应的总线对象变量。默认情况下,该变量使用中定义的结构化变量名modelDescription.xml.要在工作区中创建一个新变量,请使用fmudialog.createBusType

更改任何变量值将启用将输出恢复到默认设置按钮,单击可恢复原设置。

参数可以改变FMU模块输出端口的布局FMUOutputMapping参数使用set_param函数。可设置为继承结构化.它被设置为继承默认情况下。将参数设置为将总线输出端口分离为单独的总线元件信号输出端口。将参数设置为结构化将各个总线元素输出端口组合为总线输出端口。

块特征

数据类型

字符串

直接引线

没有

讨论二阶导数过零检测

没有

版本历史

在R2017b中引入