~~NOCACHE~~


=====  Development Environment =====
===== Preface =====
<WRAP round info 50%>
The following instructions have been tested on Ubuntu <label ubuntu_version>UBUNTU_VERSION</label> \\ (64 bit) in a VMWare virtual machine.
</WRAP>

<WRAP round important 50%>
Some users have reported various issues using Ubuntu 16.04.\\
We recommend to use Ubuntu 14.04 
</WRAP>
This page always refers to the latest BSP revision (including ancillary tools) according to the following table:

{{section>.:version-matrix#version_matrix&noheader}}


<WRAP round important 50%>We recommend using PTXdist version <label oselas_version>OSELAS_VERSION</label>.0 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.</WRAP>


===== Prerequisites  =====

<WRAP round important 50%>Please note:\\ Ubuntu <label ubuntu_version>UBUNTU_VERSION</label> is required for the toolchain. </WRAP>



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 =====

<WRAP round important 60%>
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.
</WRAP>

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).

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>

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

<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.
==== Toolchain installation ====

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>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).

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

==== BSP installation ====

<WRAP round info 60%>
See the README in the zip package for a detailed description of the zip contents 
</WRAP>


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



<code bash>
$ cd /opt/projekte
$ 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>