===== Using the build system =====

==== Getting help ====

<WRAP round tip 50% >The manual is your friend. See [[en:@mod_arch@:@mod_name@:linux:downloads|Downloads]] where to get it.</WRAP>

Compilation

To start compilation you have to select

    Hardware configuration (architecture, toolchain kernel, bootloader, image generation)
    Software configuration

The BSP contains reasonable configurations to enable quick start. Enter the following commands to select the configuration: 

<code bash>
$ ptxdist platform configs/platform-tq-@platform_name@/platformconfig
$ ptxdist select configs/ptxconfig
</code>

<code bash>
$ ptxdist go
$ ptxdist images
</code>

PTXdist downloads package source to your configured loacal source pool if needed. This pool can be shared by several workstations to minimize download times. If it reports some errors, please 

   * verify your internet connection and proxy settings.
   * make sure the package source is correct. Some packege source pages will change from time to time. (You can always try to download the source package manually and copy it to your package pool)
   * some packages like bootloaders and kernels where you can select versions need to know about there md5 hash sums. You have to enter the correct hash in the PTXdist configuration.

==== Configuration ====

To configure the system (e.g. add additional packages) you can start the PTXdist menu:
<code bash>
$ ptxdist menu
</code>

To add additional packages to your root filesystem simply use the ptxdist tool. The ncurses based UI is the same that is used by the linux kernel with "make menuconfig". It can be used the following way:

  * use the up / down arrow keys to navigate in the menu
  * use the left / right arrow keys to navigate between buttons
  * select / deselect packages and options using the SPACE key
  * enter submenus or press buttons using the ENTER key

Dependencies between packages should be “automagically” resolved. Software is organized in sections.