~~NOCACHE~~
===== Preface =====
<callout type="info" icon="true">The following instructions have been tested with Ubuntu @ubuntu_version@ (64 bit) in a VMWare virtual machine.</callout>

This page refers to the BSP and ancillary tools listed in the following table:
<grid>
<col sm="6">
<panel type="default" no-body="true">
^ BSP Revision  ^  @bsp_version@  ^
^++PTXdist|\\ version required by BSP++  |  @ptx_version@  |
^++OSELAS Toolchain|\\ cf. [[http://www.pengutronix.de/software/ptxdist/appnotes/AppNote_BuildingToolchain.pdf|Building OSELAS.Toolchains]]++  |  @oselas_version@.@oselas_patchlevel@  |
^ Platform  |  @platform_name@  |
^ U-Boot  |  @uboot_version@  |
^ Linux Kernel  |  @linux_kernel@  |     
</panel>
</col>
</grid>

<button collapse="bsp">Show details for previous revisions of the BSP</button>
<collapse id="bsp" collapsed="true">
<well>
{{section> @lang@:@mod_arch@:@mod_name@:data#ptxdist_bsp_version_matrix&noheader}}
</well>
</collapse>


<callout type="warning" icon="true">
PTXdist version @oselas_version@.0 is required to build the OSELAS.Toolchain-@oselas_version@.@oselas_patchlevel@.
This version may differ from the PTXdist version required to build the BSP itself.
Ubuntu @ubuntu_version@ is required for the toolchain. 
</callout>


===== Prerequisites  =====

The BSP is available as a project ready to use with the PTXdist((http://www.ptxdist.org)) build system.
As PTXdist runs on linux, first of all you need a development workstation (or a virtual machine) with a (preferably) recent Linux distribution installed. The distribution of your choice, however, may not have installed all required packages by default. Commonly missing packages (package names taken from Debian based systems) include: 

{{page>en:templates:packet-list}}



Although not required by PTXdist, we also recommend to configure and run a [[en:tftp|tftp server]] (for image download / update) and an [[en:nfs|nfs server]] (for network mounted rootfs) on your development host.

===== PTXdist set-up =====

<callout type="info" icon="true">
It is recommended to first install PTXdist @oselas_version@ in order to build the toolchain (see note above).\\  
Once the toolchain is compiled, install PTXdist @ptx_version@ is required to build the BSP.\\ 
You can always use a specific version of PTXdist by explicitly calling **ptxdist-<version>**.\\ 
__Example:__\\ $ ptxdist-@ptx_version@

__Please note:__\\
The link **/usr/local/bin/ptxdist** always calls the PTXdists version installed most recently.

Starting with PTXdist 2014.07, **ptxdist** calls a script which tries to automatically determine and call \\
 the required version by parsing the config files in the project directory.
</callout>

Make sure the development host meets the [[@lang@:@mod_arch@:@mod_name_code@:@bsp_name@:@build_system@:prepare#preface|prerequisites]] and download the required PTXdist tarball(s) (see [[@lang@:@mod_arch@:@mod_name_code@:@bsp_name@:@build_system@:Downloads|Downloads]] page for URLs).

==== Install PTXdist version for building the Toolchain ====

Extract the tarball ptxdist-@oselas_version@.@oselas_patchlevel@.tar.bz2 and install as follows:
<code bash>
$ tar xvf ptxdist-@oselas_version@.@oselas_patchlevel@.tar.bz2
$ cd ptxdist-@oselas_version@.@oselas_patchlevel@
$ ./configure
$ make
$ sudo make install
</code>

This will install PTXdist to ///usr/local/lib// by default. 
=== PTXdist configuration ===

After installing PTXdist it can be configured by:

<code bash>
$ ptxdist setup 
</code>
<code>
 .config - PTXdist @ptx_version@
 ──────────────────────────────────────────────────────────────────────────────
  ┌─────────────────────────── PTXdist @ptx_version@ ───────────────────────────┐
  │  Arrow keys navigate the menu.  <Enter> selects submenus --->.          │  
  │  Highlighted letters are hotkeys.  Pressing <Y> includes, <N> excludes, │  
  │  <M> modularizes features.  Press <Esc><Esc> to exit, <?> for Help, </> │  
  │  for Search.  Legend: [*] built-in  [ ] excluded  <M> module  < >       │  
  │ ┌─────────────────────────────────────────────────────────────────────┐ │  
  │ │    --- PTXDIST Setup Menu                                           │ │  
  │ │        User                --->                                     │ │  
  │ │        Proxies             --->                                     │ │  
  │ │        Project Searchpath  --->                                     │ │  
  │ │        Source Directories  --->                                     │ │  
  │ │        Source Download     --->                                     │ │  
  │ │        IPKG Repository     --->                                     │ │  
  │ │        Java SDK            --->                                     │ │  
  │ │        Developer Options   --->                                     │ │  
  │ │                                                                     │ │  
  │ └─────────────────────────────────────────────────────────────────────┘ │  
  ├─────────────────────────────────────────────────────────────────────────┤  
  │        <Select>    < Exit >    < Help >    < Save >    < Load >         │  
  └─────────────────────────────────────────────────────────────────────────┘  
</code>
To personalise your PTXdist installation, please fill out:
  * User (username and mail address)

Depending on your environment, the most important settings are:

  * Proxies (ftp / http / hhtps proxies)
  * Source Directories (path for archive of downloaded source packages (aka local package pool))

For further details on setup options, please see the PTXdist manual.

==== Building the toolchain ====

See [[@lang@:@mod_arch@:@mod_name_code@:@bsp_name@:@build_system@:downloads|download page]] for links to toolchain download. If using precompiled toolchain install to ///opt//. Otherwise carefully follow the documentation for building toolchains found [[http://www.pengutronix.de/software/ptxdist/appnotes/AppNote_BuildingToolchain.pdf|here]] or in the [[@lang@:@mod_arch@:@mod_name_code@:@bsp_name@:<label build_system></label>:downloads|download section]].\\ By default the toolchain will get installed to ///opt/OSELAS.Toolchain-<version>//.

Follow chapter "Building a toolchain" in the PTXdist manual and keep in mind:
  * When you are asked to run the command <code>$ ptxdist select ptxconfigs/...</code>select this ptxconfig: **ptxconfigs/@ptxconfig_arch@_gcc-<version>_glibc-<version>_binutils-<version>_kernel-<version>-sanitized.ptxconfig** (for @mod_name@)
  * To build the toolchain project you should install the corresponding PTXdist version for the Toolchain (as told in the documentation).


==== Install PTXdist version for building the BSP ====

Extract the tarball ptxdist-@ptx_version@.tar.bz2 and install as follows:
<code bash>
$ tar xvf ptxdist-@ptx_version@.tar.bz2
$ cd ptxdist-@ptx_version@
$ ./configure
$ make
$ sudo make install
</code>

Afterwards you can configure PTXdist  

==== Extract the BSP sources ====
<callout type="info" icon="true">
See the README file in the BSP archive for a detailed description of the zip contents 
</callout>

Extract the package @bsp_name_archive@@bsp_version@.zip to any directory (e.g. ///opt// or ///home//):

<code bash>
$ cd ~/home/workspace
$ tar -xvf @bsp_name_archive_src@.@bsp_version_src@.tar.gz
$ cd @bsp_name_archive_src@.@bsp_version_src@
</code>