Configuration variables
=======================

CONFIG.COMMON
-------------

+-------------------------------+------------------------------------------------------+------------------------------------------+
| Variable                      | default value                                        | explanation                              |
+===============================+======================================================+==========================================+
| TOP                           | \`pwd\`                                              | The top directory of the project         |
+-------------------------------+------------------------------------------------------+------------------------------------------+
| INSTALL                       | ${TOP}                                               | The directory where image is installed   |
+-------------------------------+------------------------------------------------------+------------------------------------------+
| RTEMS_TARGET                  | powerpc-rtems${RTEMS_VERSION}                        | Target architecture                      |
+-------------------------------+------------------------------------------------------+------------------------------------------+
| RTEMS_TESTS                   | "no"                                                 | Change to "yes" in order to build        |
|                               |                                                      | RTEMS test programs                      |
+-------------------------------+------------------------------------------------------+------------------------------------------+
| SRCDIR                        | ${TOP}/src                                           | Source directory                         |
+-------------------------------+------------------------------------------------------+------------------------------------------+
| TOOL_BIN_PATH                 | /opt/rtems/crosstools/$RTEMS_VERSION/bin             | Directory where RTEMS cross tools are    |
|                               |                                                      | installed                                |
+-------------------------------+------------------------------------------------------+------------------------------------------+
| RTEMS_GIT_REPO                | "https://github.com/goetzpf/rtems-HZB-kernel.git"    | Source directory of RTEMS kernel         | 
+-------------------------------+------------------------------------------------------+------------------------------------------+
| CEXP_GIT_REPO                 | "https://github.com/goetzpf/rtems-HZB-cexpsh.git"    | Source directory of cexp shell           | 
+-------------------------------+------------------------------------------------------+------------------------------------------+
| BOOTLIB_GIT_REPO              | "https://github.com/goetzpf/rtems-HZB-bootlib.git"   | Source directory of bootlib              | 
+-------------------------------+------------------------------------------------------+------------------------------------------+
| BSPEXT_GIT_REPO               | "https://github.com/goetzpf/rtems-HZB-libbspext.git" | Source directory of bspext               | 
+-------------------------------+------------------------------------------------------+------------------------------------------+
| GESYS_GIT_REPO                | "https://github.com/goetzpf/rtems-HZB-gesys.git"     | Source directory of GeSys                | 
+-------------------------------+------------------------------------------------------+------------------------------------------+

CONFIG-RTEMS-NN
---------------

.. note::
   You usually don't have to change the variables in the CONFIG-RTEMS-NN files.

Common variables
++++++++++++++++

+-------------------------------+------------------------------------------+
| Variable                      | explanation                              |
+===============================+==========================================+
| RTEMS_VERSION                 | The RTEMS version                        |
+-------------------------------+------------------------------------------+
| BSPS                          | List of board support packages for which |
|                               | RTEMS is built                           |
+-------------------------------+------------------------------------------+

Variables for packages
++++++++++++++++++++++

These are the packages that may be used to create a boot image. Note that
package "RTEMS" is always used:

- RTEMS
- CEXP
- BOOTLIB
- BSPEXT
- GESYS

A package is only used (built) when variable [PACKAGE]_GIT_REV is defined.

Here are the package variables:

+-------------------------------+------------------------------------------+
| Variable                      | explanation                              |
+===============================+==========================================+
| [PACKAGE]_GIT_BRANCH          | Git branch that is used to check out     |
|                               | from git repository                      |
+-------------------------------+------------------------------------------+
| [PACKAGE]_GIT_REV             | Git revision that is used to check out   |
|                               | from git repository                      |
+-------------------------------+------------------------------------------+
| [PACKAGE]_PATCHES             | Patch files that are applied to the      |
|                               | source. These files are in directory     |
|                               | "patches"                                |
+-------------------------------+------------------------------------------+