Skip to content
Functional Mockup Interface (FMI) for Unity
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
Assets
Packages
ProjectSettings
.gitattributes
.gitignore
BouncingBall-Scene.png
CHANGELOG.md
CONTRIBUTING.md
LICENSE.md
README.md

README.md

Unity FMI Add-on

Functional Mock-up Interface for Unity

Getting Started

Download and import the Unity package. Select Assets > Import FMU to import the FMU. This creates the model description in Resources that lists the available variables and extracts the FMU to the StreamingAssets folder.

Now you can use the FMU the in your scripts (see BouncingBall.cs for a complete example):

public class BouncingBall : MonoBehaviour {

    FMU fmu;

    void Start () {
        fmu = new FMU2("bouncingBall");
        fmu.SetupExperiment(Time.time);
        fmu.EnterInitializationMode();
        fmu.ExitInitializationMode();
    }

    void FixedUpdate() {
        fmu.DoStep(Time.time, Time.deltaTime);
        transform.position = Vector3.up * (float)fmu.GetReal("h");
    }

}

The example scene SampleScenes/BouncingBall shows you how to instantiate and reset the model, set input and get output.

BouncingBall Scene

Values.cs demonstrates how to use value references and to get and set Real, Integer, Boolean and String variables.

Limitations

Currently the FMI add-on supports only a limited subset of FMI 2.0 for co-simulation API. It runs on Mac and 64-bit Windows (make sure you select x86_64 as architecture when exporting the player on Windows).

Get DotNetZip.dll

If you've cloned the repository you need to download dotnetzip.1.11.0.nupgk, extract it (it's a ZIP archive) and copy DotNetZip.dll in lib/net20 to Unity/Assets/FMI/Editor/Plugins. This library is required to extract FMUs during the import. DotNetZip.dll is already included in the pre-built Unity package.

Contributing

You've found a problem? Fantastic, a problem found is a problem fixed. Please take a moment to read the contributing guide before you open an issue.

License

The code is licensed under the BSD 3-clause license. Copyright © 2018 Dassault Systèmes. All rights reserved.

You can’t perform that action at this time.