The Xentara FMU Driver v1.2
User Manual
|
The Xentara FMU plugin makes use of the Functional Mock-up Interface (FMI 2.0), which defines a standardized interface for use in computer simulations to develop complex cyber-physical systems. The plugin only supports FMI 2.0 Co-Simulation from the two flavors (Co-Simulation & Model Exchange) of Functional Mock-up Units under the Functional Mock-up Interface (FMI) standard.
Each FMU (Functional Mock-up Unit) is distributed in a zip file with the extension ".fmu" which contains
All information about an FMU's functionality is stored in the text file modelDescription.xml in XML format as mentioned in the previous section. This file specifically stores the FMU variables and their attributes such as name, unit, start value, and so on. This XML file also contains the definition of all variables (Inputs, Outputs, Parameter and more) of the FMU in a standardized way. These variables from the XML files are used to configure the xentara model json file.
The modelPath configuration parameter in the xentara json model file must contain an absolute or relative path to the unzipped FMU file.
Under Linux, the Xentara FMU driver looks for FMU model in the xentara default directories. The following directories are searched in order:
For Windows, Xentara FMU driver will look for FMU in the following directories:
The Xentara FMU driver must perform the calculation step for the simulation. For that, a task called step is inserted into a Xentara execution pipeline to perform the calculations by taking the current Inputs and generating the Outputs.
In the Xentara operational stage, the step task uses the logic built into the FMU model to calculate the Outputs from the generated Inputs.
step | Computation of the model for the time steps |
In addition to the standard members of Xentara I/O Component, FMU have the following attributes:
key | The FMU’s primary key. |
name | The FMU’s name. The name is the last component of the primary key. |
UUID | The unique UUID of the FMU. |
type | The FMU’s element type. For FMUs, this is always “FMU”. |
category | The FMU’s category. For FMUs, this is always “microservice”. |
modelName | The name of the FMU model in simulation. |
modelGuid | The unique Guid of the FMU model in simulation. |
error | The error that occurred during the last step of the simulation. The attribute contains one of the error numbers listed in FMU Driver Error Numbers. |
errorMessages | The error message based on the FMU Driver Error Numbers. |