Table of Contents

Development Environment

Preface

This page refers to the BSP and ancillary tools listed in the following table:

BSP Revision @bsp_version@
PTXdist @ptx_version@
OSELAS Toolchain @oselas_version@.@oselas_patchlevel@
Platform @mb_name_code@
U-Boot @uboot_version@
Linux Kernel @linux_kernel@

Show details for previous revisions of the BSP

Prerequisites

The BSP is available as a project ready to use with the PTXdist1) 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:

  • autoconf
  • bc
  • bison
  • build-essential
  • dialog
  • flex
  • g++
  • gawk
  • gettext
  • git
  • libncurses5-dev
  • libxml-parser-perl
  • python-dev
  • quilt
  • texinfo
  • zip
  • socat
  • pkg-config

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

PTXdist set-up

Make sure the development host meets the prerequisites and download the required PTXdist tarball(s) (see Downloads page for URLs).

Extract the tarball ptxdist-@ptx_version@.tar.bz2 and install as follows:

$ tar xvf ptxdist-@ptx_version@.tar.bz2
$ cd ptxdist-@ptx_version@
$ ./configure
$ make
$ sudo make install

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

$ ptxdist setup 
 .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 >         │  
  └─────────────────────────────────────────────────────────────────────────┘  

To personalise your PTXdist installation, please fill out:

Depending on your environment, the most important settings are:

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

Toolchain installation

See download page for links to toolchain download. If using precompiled toolchain install to /opt. Otherwise carefully follow the documentation for building toolchains found here or in the 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:

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

BSP installation

Please see the README in the zip package for a detailed description of the zip contents

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

 unzip TQ-TQMa6ULx-BSP-REV.0100.zip -d ~/projects/

After decompressing the BSP archive following archives are located in the destination folder:

Next step is to decompress the BSP source archive:

$ cd ~/projects
$ tar -xvf @bsp_archive_src@.@bsp_version_src@.tar.gz
$ cd @bsp_archive_src@.@bsp_version@