~~NOCACHE~~


===== Development Environment =====

the following information relates to BSP Rev.@bsp_version@

===== PTXdist =====
  * PTXdist @ptx_version@ 
=====Toolchain=====
  * OSELAS.Toolchain-@oselas_version@.@oselas_patchlevel@



++++ For older revisions of the BSP click here !!! |


{{page>:en:@mod_arch@:@mod_name@:linux:version-matrix&inline}}

++++



<WRAP round important 50%>This toolchain requires PTXdist version @ptx_version@.0 to built properly.</WRAP>


===== Preparing the Development Host =====

<WRAP round important 50%>Please note:\\ Ubuntu @ubuntu_version@ or newer required for the toolchain. </WRAP>

To install PTXdist you need Linux on your development workstation (or a virtual machine running Linux). The build system needs some additional packages which may be normally not installed by default. These packages are (names should match for Debian based systems): 

  * autoconf
  * bc
  * gawk
  * dialog
  * ncurses-dev
  * bison
  * flex
  * quilt
  * texinfo
  * gettext
  * g++
  * libxml-parser-perl
  * zip
  * git

For development it is also recommended to have a [[en:tftp|tftp server]] for image download and update and an [[en:nfs|nfs server]] for network mounted rootfs configured and running.

===== Build system installation =====

<WRAP round important 60%>First install the toolchain's ptxdist, then compile toolchain, then install BSP's ptxdist.\\ 
Later you can select which ptxdist to use by calling **ptxdist-<version>**.\\ \\ Example:\\ $ ptxdist-2012.07.0 version

The link **ptxdist** always calls the most recently installed ptxdist version.</WRAP>


After installing all packages download PTXdist source, configure, compile and install. See download page for links. 

Extract the package ptxdist-<version>.tar.bz2 to a temporary directory and call in that directory:
<code bash>
$ ./configure
$ make
$ sudo make install
</code>

This will install PTXdist to ///usr/local/lib// by default. Afterwards please setup PTXdist with:

<code bash>
$ ptxdist setup 
</code>

You have to setup the following things:

  * ftp / http proxies
  * username and mail address
  * path for archive of downloaded source packages (aka local package pool)
  * for further setup details see PTXdist manual ...

==== Toolchain installation ====

See [[.: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.ptxdist.de/software/ptxdist/appnotes/AppNote_BuildingToolchain.pdf|here]] or in the [[en:arm:tqma53:linux:ptxdist: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).

The Toolchain normally is already setup in the BSP project. So you can move on to the next step.

==== BSP installation ====

Extract the package OSELAS.BSP-TQ-@mod_name@.<version>.tgz to any directory (e.g. ///opt// or ///home//):

<code bash>
$ cd /opt/projekte
$ tar -xvf OSELAS.BSP-TQ-@mod_name@.<version>.tgz
$ cd OSELAS.BSP-TQ-@mod_name@
</code>