Getting Started

Installation

On Windows host, installation is performed automatically by InstallShield. On Linux host, you will need first to unpack the package using tar utility and then launch the doinstall script located at the toplevel directory. In both cases, you will be prompted for an installation directory for the simulator and the example (later referred to as GNATEMULATOR_INSTALL_DIR).

Setting your environment

In order to set your environment for GNATemulator you need to do on Windows:

set PATH=%GNATEMULATOR_INSTALL_DIR%\bin;%PATH%

And on Linux:

export PATH=$GNATEMULATOR_INSTALL_DIR/bin:$PATH

Where GNATEMULATOR_INSTALL_DIR is the root directory of your installation.

If you need to build your own devices using GNATBus, then you should also do on Windows:

set GPR_PROJECT_PATH=%GNATEMULATOR_INSTALL_DIR%\share\gpr;%GPR_PROJECT_PATH%

And on Linux:

export GPR_PROJECT_PATH=$GNATEMULATOR_INSTALL_DIR/share/gpr:$GPR_PROJECT_PATH

Note that if GNATemulator has been installed in the same location as your native compiler then you don’t need to modify GPR_PROJECT_PATH environment variable.

Running the examples

In the following subsections, small examples are described for each supported platforms. The examples sources are located in %GNATEMULATOR_INSTALL_DIR%/share/examples/gnatemu/.