The FUMOLA co-simulation environment

About

FUMOLA is a co-simulation framework specifically designed to support the features offered by the FMI specification.
It provides a flexible platform dedicated to the investigation of the full range of possibilities offered by the FMI specification based on advanced simulation concepts.
FUMOLA is developed as a plug-in for the Ptolemy II framework and the FMI++ library, implementing an open and flexible environment for systematically studying the full potential of the FMI specification from a methodical point of view.

An online-manual for FUMOLA is available here.

Installation instructions (binary version)

Prerequisites

• A binary version of FUMOLA is available here, for compiling it from source please refer to the manual.
• The binary version of FUMOLA is intended to be installed on top of Ptolemy II 10.0.1 (32-bit) on Windows.
  Get the Windows 32-bit Installer here: http://ptolemy.eecs.berkeley.edu/ptolemyII/ptII10.0/index.htm
• Installation of Ptolemy II via the Windows Installer requires a Java Runtime Environment to be installed, e.g. from here: http://www.oracle.com/technetwork/java/javase/downloads/index.html
• The minimum Ptolemy II packs that need to be selected for installation are: Ptiny, Full & JRE.

FUMOLA installation

• Download file fumola-install.zip from here: http://fumola.sourceforge.net
• Unzip fumola-install.zip and change to folder fumola-install.
• In case you did not choose the default installation path for Ptolemy II (C:\Ptolemy\ptII10.0.1), you need to adapt install.bat:
• Open it in an editor and point variable PTII (line 4) to your Ptolemy II installation directory.
• For instance, in case your Ptolemy II installation directory is D:\My Development\ptII, then line 4 of install.bat should read like this: SET PTII="D:\My Development\ptII"
• Run install.bat by double-clicking it.
• Finally, add Ptolemy II's lib directory to the Windows system path.
• Look for instance here for instructions on how to do that.
• For instance, in case you chose the default installation path for Ptolemy II (C:\Ptolemy\ptII10.0.1), you have to add C:\Ptolemy\ptII10.0.1\lib to the Windows system path.
• Done.

Troubleshooting

In case Ptolemy II crashes without any warning or error message when starting a simulation, check if Windows Update KB2533623 has already been installed.

In case the installation was not successfull you may get the following error messages when starting vergil.exe:

  Error encountered in:
  <entity name="FMUDebugger" class="fumola.base.FMUDebugger">
  at/ait/fmipp/LogBuffer

This indicates that at the startup of vergil.exe the Java archive fmipp.jar is for some reason not found.
In such a case, the easiest solution is the following:
- Copy fmipp.jar, found in subfolder .ptolemyII of fumola-install, to the Ptolemy II installation directory (by default C:\Ptolemy\ptII10.0.1).
- Extract fmipp.jar directly in the Ptolemy II installation directory, using e.g. 7-zip.
- This creates a new folder called at in the Ptolemy II installation directory.
- Done.