Getting Started =============== Installation ------------ On Windows host, installation is performed automatically by **InstallShield**. On Linux host, you will need first to unpack the package using :file:`tar` utility and then launch the :file:`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 :envvar:`GNATEMULATOR_INSTALL_DIR`). Setting your environment ------------------------ In order to set your environment for **GNATemulator** you need to do on Windows: .. code-block:: bat set PATH=%GNATEMULATOR_INSTALL_DIR%\bin;%PATH% And on Linux: .. code-block:: bash export PATH=$GNATEMULATOR_INSTALL_DIR/bin:$PATH Where :envvar:`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: .. code-block:: bat set GPR_PROJECT_PATH=%GNATEMULATOR_INSTALL_DIR%\lib\gnat;%GPR_PROJECT_PATH% And on Linux: .. code-block:: bash export GPR_PROJECT_PATH=$GNATEMULATOR_INSTALL_DIR/lib/gnat:$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 :envvar:`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 :file:`%GNATEMULATOR_INSTALL_DIR%/share/examples/gnatemu/`. .. toctree:: leon3-elf-example.rst ppc-elf-example.rst arm-elf-example.rst riscv64-elf-example.rst