主要内容

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包含联合仿真和模型交换元素,块检测它们并提示您选择您想要块运行的模式。

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

港口

输出参数

全部展开

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

参数

全部展开

指定一个FMU的名称,包括或不包括文件扩展名。这个条目是区分大小写的。FMU必须在MATLAB中存在®路径。

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

当你点击好吧时,块创建一个/ slprj / _fmu /unique_ID已解压缩的文件和文件层次结构完整的文件夹。

依赖关系

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

  • 参数

  • 模拟

  • 输入总线

  • 输出总线

编程使用

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

参数

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

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

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

模拟

选中此复选框可使FMU的公差值的规格生效。否则,清除此复选框。

依赖关系

仅当您的FMU版本或模式支持容差值时,此参数有效。金宝app

编程使用

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

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

依赖关系

仅当您的FMU版本或模式支持容差值时,此参数有效。金宝app

编程使用

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

仿真过程中的通信步长,指定为标量。指定块的模拟时间间隔。有关更多信息,请参见时间的考虑

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

该块支持不同类型的采金宝app样时间,包括连续、离散和继承。然而,一般的协同模拟FMUs只支持周期性离散采样时间,不支持偏移(如正金宝app标量)。

依赖关系

该参数仅在协同仿真模式下有效。

编程使用

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

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

编程使用

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

按类型过滤调试日志,通过选择以下复选框指定:

  • 好吧

  • 警告

  • 丢弃

  • 错误

  • 致命的

  • 等待

编程使用

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

直接调试日志,指定为:

  • 文件——流slprj / _fmu / _logs_modelname/modelname_FMUblockname. txt

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

依赖关系

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

编程使用

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

输入

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

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

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

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

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

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

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

    请注意

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

  • 中定义的起始值modelDescription.xml.你不能:

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

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

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

更改任何变量值使恢复输出到默认设置按钮,单击该按钮可恢复初始设置。

输出

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

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

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

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

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

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

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

    请注意

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

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

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

更改任何变量值使恢复输出到默认设置按钮,单击该按钮可恢复初始设置。

介绍了R2017b