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).

If you are using GNATemulator for VxWorks 653 then once the product is installed, you should install the BSP in the VxWorks 653 installation. In order to do that you need to copy the %GNATEMULATOR_INSTALL_DIR%\share\gnatemulator\ppc-vx653\bsp\qemu directory as %WIND_BASE%\target\config\qemu.

Note that the PATH to the target BSP directory that you are copying to may be slighty different depending on your version of VxWorks 653. Note in particular that this BSP uses the PPC604gnu toolchain, which is not available on 653 2.4; so this version of 653 is not supported. On 653 2.5, you will also need to add ne2000End.o to the library, for instance by doing the following:

cd %WIND_BASE%\target\lib
arppc x libPPC604gnuvx.a ne2000End.o
cp ne2000End.o objPPC604gnuvx\ne2000End.o

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 ADA_PROJECT_PATH=%GNATEMULATOR_INSTALL_DIR%\lib\gnat;%ADA_PROJECT_PATH%

And on Linux:

export ADA_PROJECT_PATH=$GNATEMULATOR_INSTALL_DIR/lib/gnat:$ADA_PROJECT_PATH

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