~~NOCACHE~~
===== Preface =====
<callout type="info" icon="true">The following instructions have been tested with Ubuntu <label ubuntu_version>UBUNTU_VERSION</label> (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  ^  <label bsp_version>BSP_VERSION</label>  ^
^++PTXdist|\\ version required by BSP++  |  <label ptx_version>PTX_VERSION</label>  |
^++OSELAS Toolchain|\\ cf. [[http://www.pengutronix.de/software/ptxdist/appnotes/AppNote_BuildingToolchain.pdf|Building OSELAS.Toolchains]]++  |  <label oselas_version>OSELAS_VERSION</label>.<label oselas_patchlevel>OSELAS_PATCHLEVEL</label>  |
^ Platform  |  <label mb_name_code>MB_NAME_CODE</label>  |
^ U-Boot  |  <label uboot_version>UBOOT_VERSION</label>  |
^ Linux Kernel  |  <label linux_kernel>LINUX_KERNEL</label>  |     
</panel>
</col>
</grid>

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


<callout type="warning" icon="true">
PTXdist version <label oselas_version>OSELAS_VERSION</label>.0 is required to build the OSELAS.Toolchain-<label oselas_version>OSELAS_VERSION</label>.<label oselas_patchlevel>OSELAS_PATCHLEVEL</label>.
This version may differ from the PTXdist version required to build the BSP itself.
Ubuntu <label ubuntu_version>UBUNTU_VERSION</label> 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 <label oselas_version>OSELAS_VERSION</label> in order to build the toolchain (see note above).\\  
Once the toolchain is compiled, install PTXdist <label ptx_version>PTX_VERSION</label> is required to build the BSP.\\ 
You can always use a specific version of PTXdist by explicitly calling **ptxdist-<version>**.\\ 
__Example:__\\ $ ptxdist-<label ptx_version>PTX_VERSION</label>

__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 [[<label lang>LANG</label>:<label mod_arch>MOD_ARCH</label>:<label mod_name_code>MOD_NAME_CODE</label>:<label bsp_name>BSP_NAME</label>:<label build_system>BUILD_SYSTEM</label>:prepare#preface|prerequisites]] and download the required PTXdist tarball(s) (see [[<label lang>LANG</label>:<label mod_arch>MOD_ARCH</label>:<label mod_name_code>MOD_NAME_CODE</label>:<label bsp_name>BSP_NAME</label>:<label build_system>BUILD_SYSTEM</label>:Downloads|Downloads]] page for URLs).

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

Extract the tarball ptxdist-<label oselas_version>OSELAS_VERSION</label>.<label oselas_patchlevel>OSELAS_PATCHLEVEL</label>.tar.bz2 and install as follows:
<code bash>
$ tar xvf ptxdist-<label oselas_version>OSELAS_VERSION</label>.<label oselas_patchlevel>OSELAS_PATCHLEVEL</label>.tar.bz2
$ cd ptxdist-<label oselas_version>OSELAS_VERSION</label>.<label oselas_patchlevel>OSELAS_PATCHLEVEL</label>
$ ./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 <label ptx_version>PTX_VERSION</label>
 ──────────────────────────────────────────────────────────────────────────────
  ┌─────────────────────────── PTXdist <label ptx_version>PTX_VERSION</label> ───────────────────────────┐
  │  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 [[<label lang>LANG</label>:<label mod_arch>MOD_ARCH</label>:<label mod_name_code>MOD_NAME_CODE</label>:<label bsp_name>BSP_NAME</label>:<label build_system>BUILD_SYSTEM</label>: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 [[<label lang>LANG</label>:<label mod_arch>MOD_ARCH</label>:<label mod_name_code>MOD_NAME_CODE</label>:<label bsp_name>BSP_NAME</label>:<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/<label ptxconfig_arch>PTXCONFIG_ARCH</label>_gcc-<version>_glibc-<version>_binutils-<version>_kernel-<version>-sanitized.ptxconfig** (for <label mod_name>MOD_NAME</label>)
  * 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-<label ptx_version>PTX_VERSION</label>.tar.bz2 and install as follows:
<code bash>
$ tar xvf ptxdist-<label ptx_version>PTX_VERSION</label>.tar.bz2
$ cd ptxdist-<label ptx_version>PTX_VERSION</label>
$ ./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 <label bsp_name_archive>.</label><label bsp_version>.</label>.zip to any directory (e.g. ///opt// or ///home//):

<code bash>
$ cd ~/home/workspace
$ tar -xvf <label bsp_name_archive_src>BSP_NAME_ARCHIVE_SRC</label>.<label bsp_version_src>BSP_VERSION_SRC</label>.tar.gz
$ cd <label bsp_name_archive_src>BSP_NAME_ARCHIVE_SRC</label>.<label bsp_version>BSP_VERSION</label>
</code>