=======
Scripts
=======

.. _RTEMS: https://www.rtems.org

build-tool.sh
-------------

This is the script that downloads and compiles the software needed to create a bootable RTEMS image. 

For RTEMS_ 4.9 aside from the kernel, these packages are also needed:

- cexp
- bootlib
- bspext
- gesys

Newer RTEMS_ version do not need all these packages, "cexp" for example, is
only compatible with RTEMS_ 4.9. On version 4.10 it is instable and sometimes
crashes.

In general, when variable [PACKAGE]_GIT_REV is not defined in file
CONFIG-RTEMS-NN, this package is not built and not included in the generated
bootable image.

The script allows to download only some packages or all. 

You usually call the script with::

  ./build-tool.sh [CONFIG-RTEMS-NN] ALL build

If you want to build only a specific package or you only want to download the
package sources, the online help with::

  ./build-tool.sh -h

For information on the generated binaries, see :doc:`binaries <binaries>`.

cleanup.sh
----------

This removes all downloaded and created files. 

mvme2100-exe2boot.sh
--------------------

This is a script that creates bootable files from \*.exe files for the mvme2100
CPU. You may need this since RTEMS_ example programs are always of the type
"exe" which cannot be loaded on this CPU type directly.

For a usage example see :doc:`binaries <binaries>`.

mvme2500-exe2boot.sh
--------------------

This is a script that creates bootable files from \*.exe files for the mvme2500
CPU. You may need this since RTEMS_ example programs are always of the type
"exe" which cannot be loaded on this CPU type directly.

For a usage example see :doc:`binaries <binaries>`.