基于功能模型接口的联合仿真模型描述文件完整规范、关键功能模型接口函数.docxVIP

附录A

（资料性附录）

模型描述文件完整规范

A.1根元素fmiModelDescription属性

表A.1fmiModelDescription属性

序号

属性

说明

必选性

示例/取值范围

1

fmiVersion

FMI规范版本号

必选

2.0?或?3.0

2

modelName

模型唯一标识名（字母、数字、下划线）

必选

ElectricMotor

3

guid

全局唯一标识符（UUID格式）

必选

{550e8400-e29b-41d4-a716-446655440000}

4

description

模型功能简短描述

可选

DCmotormodelwiththermaleffects

5

author

模型作者及组织

可选

JohnDoe,MyCompanyInc.

6

version

模型版本号（遵循语义化版本规范）

可选

1.2.3

7

copyright

版权声明

可选

?MyCompany2024

8

generationTool

生成此文件的工具名称及版本

可选

Dymola2024.1

9

generationDateAndTime

文件生成时间（ISO8601格式，UTC时区）

可选

2024-01-15T14:30:00Z

10

variableNamingConvention

变量命名规则：flat（无层级）或structured（使用.分隔）

可选

structured

11

numberOfEventIndicators

事件指标数量（仅FMIModelExchange必需）

可选

3

A.2根元素fmiModelDescription子标签

表A.2fmiModelDescription子标签

序号

子标签

说明

必选性

示例/结构

1

ModelExchange

声明功能模型单元支持模型交换模式

二选一

ModelExchangemodelIdentifier=Motor_ME/

2

CoSimulation

声明功能模型单元支持联合仿真模式

二选一

CoSimulationmodelIdentifier=Motor_CS/

3

UnitDefinitions

定义物理单位

可选

UnitDefinitions

Unitname=N·m

BaseUnitkg=1m=2s=-2/DisplayUnitname=kN·mfactor=1000/

/Unit

/UnitDefinitions

4

TypeDefinitions

自定义数据类型（如结构体、枚举）

可选

Typename=VoltageTypeReal//Type

5

LogCategories

定义日志分类（如debug,solver）

可选

Categoryname=control/

6

DefaultExperiment

默认仿真参数（时间范围、容差等）

可选

DefaultExperimentstartTime=0stopTime=10tolerance=1e-5/

7

VendorAnnotations

供应商自定义扩展数据

可选

Toolname=MyToolversion=1.0/

8

ModelVariables

定义所有输入/输出/参数变量

可选

ModelVariables

ScalarVariablename=input.voltagevalueReference=1causality=input

Realunit=Vmin=0max=48/

/ScalarVariable/ModelVariables

9

ModelStructure

声明模型依赖关系与结构（如代数环、状态变量）

可选

OutputsvalueReference=1/

A.3CoSimulation标签属性及子标签

表A.3CoSimulation标签属性及子标签

序号

子标签

说明

必选性

示例/结构

1

modelIdentifier

功能模型单元动态库的标识符

必选

modelIdentifier=Motor_CS

2

needsExecutionTool

是否需要外部执行工具（

可选

false（默认

3

canHandleVariableCommunicationStepSize

是否支持可变通信步长

可选

true（若支持动态步长调整）

4

canInterpolateInputs

是否支持输入插值（主控器可请求中间值）

可选

false（默认）

5

maxOutputDerivativeOrder

支持的最大输出导数阶数（若支持输出导数计算）

可