BUILD.md

OMSimulator Build Instructions

Dependencies

Required Tools

• C++ compiler with C++17 support
• CMake: Download here

Optional Tools

• Sphinx: for documentation (Download)
• Doxygen: for documentation (Download)
• GNU Flex: for test suite verification (GitHub)

Libraries

• readline (for Lua support): Download here

Compilation Instructions

Submodule Initialization

Ensure you have initialized OMSimulator submodules:

git submodule update --init --recursive

Or, when cloning:

git clone https://github.com/OpenModelica/OMSimulator.git --recurse-submodules

Build Instructions

Linux / macOS

1. Configure OMSimulator:

   cd OMSimulator
   cmake -S . -B build/ -DCMAKE_INSTALL_PREFIX=install/

2. Build and Install:

   cmake --build build/ --target install
   ./install/bin/OMSimulator --version

Windows (OMDev mingw)

1. Set Up OMDev:

   • Clone OMDev: https://gitlab.liu.se/OpenModelica/OMDevUCRT.git
   • Follow the setup instructions in OMDev/INSTALL.md

2. Configure OMSimulator:

   cd OMSimulator
   cmake -S . -B build/ -G "MSYS Makefiles" -DCMAKE_INSTALL_PREFIX=install/

3. Build and Install:

   cmake --build build/ --target install
   ./install/bin/OMSimulator --version

Windows (Visual Studio)

• Supported: Visual Studio 2017 and later.
• Required: Visual C++ Build Tools (Download)

1. Open Visual Studio Command Prompt

2. Configure OMSimulator:

   cd OMSimulator
   cmake -S . -B build/ -DCMAKE_INSTALL_PREFIX=install/

3. Build and Install:

   cmake --build build/ --config Release --target install
   ./install/bin/OMSimulator.exe --version

Testing the Build

Linux / macOS / Windows (OMDev mingw)

By default the testsuite is not enabled by the cmake build. To enable the testsuite run the following command

1. Configure testsuite :

   cmake -S . -B build/ -DOMS_ENABLE_TESTSUITE=ON

2. Build Test Dependencies:

   cmake --build build/ --target testsuite-depends

3. Run Tests:

   cd testsuite/partest/
   ./runtests.pl -j4

   • Use -jN to specify N threads.