===== Using PTXdist to create the BSP firmware =====

<grid>
<col sm="6">
<callout type="info" icon="true">
 we suggest to read the following page before you proceed with      this page\\
1. [[[[@lang@:@mod_arch@:@mod_name_code@:@bsp_name@:prepare|preparing Development Host]]
</callout> </col> </grid>


<grid>
<col sm="6">
<alert type="warning" icon="fa fa-warning">
We suggest to build the BSP with the default configuration for the fist time.
</alert> </col> </grid>

==== Getting help ====
<grid>
<col sm="6">
<callout type="tip" icon="true"> 1. The manual is your friend. See [[@lang@:@mod_arch@:@mod_name@:@bsp_name@:downloads|Downloads]] where to get it.\\
2. See the README in your BSP root folder\\
3.Executing **ptxdist -help** to see the available ptxdist commands
</callout> </col> </grid>





==== Compilation ====

{{page>en:arm:@mod_name_code@:@bsp_name@:compilation}}


PTXdist downloads some packages. If it reports some errors please

   * verify your internet connection or proxy settings.
   * make sure the package source is correct. Some package 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 (by default: <BSP project>\src))
   * some packages like bootloaders and kernels where you can select versions need to know about their hash sums. You have to calculate them using md5sum and enter the correct hash in the ptxdist configuration.
   * run <code>$ ptxdist get</code>
   
==== Configuration ====

To configure the system use the PTXdist menu:
<code bash>
$ ptxdist menuconfig    →   configure the project filesystem
$ ptxdist kernelconfig  →   configure the kernel
$ ptxdist platform      →   configure the platform
</code>

<grid>
<col sm="8">
<callout type="tip" icon="true">
PTXdist menu\\ \\
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.
</callout> </col> </grid>