Documentation / v1.0 / Installation

From emss Framework - iRobot Create C++ Framework

Jump to: navigation, search

You are here: Documentation / v1.0 / Installation and Build Instructions


[edit] Build Instructions

In order to successfully build the emss framework, the following requirements must be met:

  • GNU C++ Compiler, version 3.0 or newer
  • Qt Open Source Edition for C++, version 4.4 or newer

The emss software requires only the standard Qt build. No additional modules are required as everything is packaged within the emss source. Additionally, the Qt debug build is not required as long as emss software is linked against Qt with release binaries. All emss binaries are compiled to either /emss/Binaries/Unix and /emss/Binaries/Windows, depending on which environment the build is executed in.

To build the emss Core library, which is required for emss applications, the following commands can be used:

  cd <path>/emms/Core
  qmake
  make

To build any emss application, such as the emss Interface, the following commands can be used:

  cd <path>/emms/<application directory>
  qmake
  make

The following application directories are available for building:

  • Interface
  • COILTest
  • RotationTest
  • SensorTest
  • Simulation
  • SplineTest
  • TerrainMap
  • VectorTest

In order to execute any emss application, the following dependencies must be resolved (i.e. libraries in the path):

  • emssCore
  • QtCore4
  • QtGui4

When first starting an emss application which requires a configuration file, the path to the wanted configuration file is requested. Pre-defined configuration files can be found at /emss/Resources/emss<configuration>.config, such as /emss/Resources/emssCore.config.