Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/INTO-CPS-Association/FMI-VDM-Model

A formal model of the FMI specification in VDM
https://github.com/INTO-CPS-Association/FMI-VDM-Model

Last synced: 3 months ago
JSON representation

A formal model of the FMI specification in VDM

Awesome Lists containing this project

README 

        
# FMI-VDM-Model



This repository contains a VDM model of the FMI standard, plus supporting tools. The repository contains the following projects:



For FMI2:



* **fmi2.static-model** - a VDM-SL model of the static semantics of FMI 2.0 modelDescription XML files

* **fmi2.dynamic-model** - a VDM-SL model of the dynamic semantics of the FMI 2.0 API

* **fmi2.cosim-test** - a VDM-SL model to test the dynamic semantics of co-simulation FMUs

* **fmi2.modelex-test** - a VDM-SL model to test the dynamic semantics of model-exchange FMUs

* **fmi2.static-tests** - a set of test XML files for the static semantics

* **fmi2.vdmcheck** - a Java tool to convert FMI 2.0 modeDescription XML files to VDM-SL and check them



For FMI3



* **fmi3.static-model** - a VDM-SL model of the static semantics of FMI 3.0 modelDescription XML files

* **fmi3.dynamic-model** - a VDM-SL model of the dynamic semantics of the FMI 3.0 API

* **fmi3.dynamic-matrix** - a spreadsheet of the mode/state callability of the FMI3 API functions

* **fmi3.rules-model** - a new VDM-SL model of static semantics, suitable for integration with the FMI Standard

* **fmi3.ls-bus-model** - a VDM-SL model of the FMI3 Network Communication Layered Standard

* **fmi3.vdmcheck** - a Java tool to convert FMI 3.0 modeDescription XML files to VDM-SL and check them



General projects:



* **fmi2.cosim** - a VDM-SL model of the interaction of a set of FMUs

* **fmi2.cosim2vdm** - a Java tool to convert Maestro JSON configurations to VDM-SL.

* **xsd2vdm** - a Java tool to convert XSD schemas into VDM-SL schemas

* **fmuReader** - a VDMJ external format reader, to allow FMUs to be read directly by VDM tools.



The FMI\{2,3\} static semantic models and the FMI\{2,3\} VDM conversion tools are packaged in the release to create stand-alone tools for verifying FMU files, called **VDMCheck\{2,3\}**. These can be used to check existing FMI version 2 or 3 FMU files against the standard; a pure Java version of each tool is available, which does not depend on the bash shell (eg. for use on Windows).



## Licensing



The VDMCheck tools are issued under a GPLv3 licence. The VDM models sources themselves are issued under an MIT licence. Licence headers and text are included with the package.



## Installation



To install the VDMCheck package, unzip the distribution ZIP (the top level contains a folder called `vdmcheck-`, which you can rename). Add the top level folder to your PATH so that the script within is available.



## Execution

```

$ VDMCheck2.sh

Usage: VDMCheck2.sh [-v ] -x  | .fmu | .xml

$ VDMCheck3.sh 

Usage: VDMCheck3.sh [-v ] -x  | .fmu | .xml

$ VDMCheck3+.sh 

Usage: VDMCheck3.sh [-h ] [-v ] .fmu | .xml



or



C:\> java -jar /vdmcheck2.jar 

Usage: java -jar vdmcheck2.jar [-v ] -x  | .fmu | .xml

C:\> java -jar /vdmcheck3.jar 

Usage: java -jar vdmcheck3.jar [-v ] -x  | .fmu | .xml

C:\> java -cp /vdmcheck3.jar VDMCheckPlus

Usage: java -cp vdmcheck3.jar VDMCheckPlus [-h ] [-v ] .fmu | .xml



```

For normal use, the tool would be invoked with a single FMU file, though it is possible to analyse an extracted modelDescription.xml file.



It is possible to capture the VDM-SL version of the XML file that is produced by using the `-v` option, but this is mainly for working with the formal model itself.



If the FMU or XML has no errors, the tool will report `No errors found` and have an exit code of 0.



Otherwise errors are listed on standard output. They consist of a unique error number, followed by a section number in the FMI Standard that is relevant to the error, followed by an error message:



```

> VDMCheck2.sh invalidOutputs2.xml

Checking XML

1306: 2.2.7 Variable "v1" causality/variability/initial/start //nil/nil invalid at line 6

1305: 2.2.7 ScalarVariable "v1" invalid at line 6

1009: 2.2.1 ScalarVariables invalid

Errors found.

```

Here, error 1306 indicates a problem with the configuration of the "v1" variable. The line number indicates the location in the XML file. Then 1305 summarises that there were errors (possibly several) with v1, and error 1009 indicates that there were errors with the ScalarVariables in general. The exit code from the tool will be 1 rather than 0, since there were errors.



Version "3+" of the tools produces a slightly different output format, which includes the name of the rule that failed and a URL link to the FMI Standard section where the correct configuration is discussed:

```

> VDMCheck3+.sh transpose.fmu

validCSIntermediateUpdate: canReturnEarlyAfterIntermediateUpdate requires providesIntermediateUpdate at modelDescription.xml:22

See: https://fmi-standard.org/docs/3.0/#table-CoSimulation-details



Errors found.

```