========================
========================
TQ Systems ARM Linux BSP
========================
========================



===========================
Installation and Quickstart
===========================


preconditions / environment
===========================

Tested on Ubuntu 12.04 and 10.04

Buildtool: ptxdist, current Version 2012.07
Compiler:  GCC from OSELAS Toolchain 2011.11.1 and 2011.11.1
           gcc-4.6.2 glibc-2.14.1 binutils-2.21.1a kernel API 2.6.39

additional host packages:
	- gawk
	- dialog
	- ncurses-dev
	- bison
	- flex
	- quilt
	- git (for TQMa335x BSP)

use README from ptxdist to install and toolchain generation

http://www.ptxdist.org/software/ptxdist/appnotes_en.html

It is a good idea, to have the build system in your .profile or to have a script
that extends the path to ptxdist. You also can setup a link in your BSP directory
to the ptxdist binary if you are working with different ptxdsit versions in parallel. 

configure the build system:
===========================

ptxdist setup (setup project global stuff)

-> ftp / http proxies
-> set username and Mailaddress
-> set path for archive of downloaded source packages
-> some more features ...

to start using a configuration:
===============================

ptxdist select configs/systems/<software config>/ptxconfig
ptxdist platform configs/platforms/<hardware platform>/platformconfig

Only if the OSELAS toolchain configured in the platform is not installed:

ptxdist toolchain </path/to/toolchain>

to start build:

ptxdist go (compile all)
ptxdist images (generate rootfs images)

project structure:
==================

+-documentation: project documentation
|
+-configs: target configs
|      |
|      +-systems: software system configurations (ptxconfig)
|      |      |
|      |      +-minimal: console only rootfs, busybox, lot of console tools to
|      |      |          make basic use of hardware like i2c, can, fb, ...
|      |      |
|      |      +-qt: minimal plus qt, qt demos, qwt, dbus, expat, freetype
|      |      |
|      |      +-<config_name>: TBD
|      |
|      +-platforms: platform configurations (platformconfig)
|            |
|            +-sample: empty template 
|            | 
|            +-tqma35: platforms based on TQMa35
|            |     |
|            |     +-tqma35-aa: TQMa35 (AA variant) on MBa35 kernel 3.2.28
|            |     | 
|            |     +-tqma35-ab: TQMa35 (AB variant) on MBa35 kernel 3.2.28
|            |     | 
|            |     +-tqma35-mba35ca: TQMa35 (AB variant) on MBa35-CA kernel 3.2.28
|            | 
|            +-tqma28: platforms based on tqma28
|            |    |
|            |    +-tqma28-fsl-0101: TQMa28 on MBa28 kernel 2.6.35.y (Freescale)
|            |
|            +-tqma335x: platforms based on TQMa335x
|                 |
|                 +-mba335x: Mainboard MBA335x for TQMa335x
|
|
+-patches: project specific patches
|
+-rules: rules for project specific packages (<package>.in and <package>.make)
|
+-local_src: sources of project specific packages
|
+-platforms: <package>.in scripts for hardware-specific packages (Kconfig)
|
+-projectroot: project specific config files for root file system or
               overwritten config files (takes precedence over ptxdist supplied 
               files


=====
HOWTO
=====

Download the document "OSELAS.BSP-Pengutronix-Generic-arm-Quickstart.pdf"
from http://www.ptxdist.org/software/ptxdist/appnotes_en.html (the link is named 
How to become a PTXdist Guru)

start a platform based on an existing one
=========================================

The quick and dirty way is to copy platform config file and kernel config file 
of n working platform, select the copied platform and modify it using

ptxdist menu => configure hardware platform

To keep the original BSP project clean you can use

ptxdist clone

See ptxdist documentation for details.

start an empty project or configuration:
========================================

- create an empty platformconfig-file in a new directory under config/platforms

8< ----------------------------------------------------------------------------
#
# Automatically generated make config: don't edit
# ptxdist version: <version>
#
PTXCONF_PLATFORMCONFIG_VERSION="<version>"
PTXCONF__platformconfig_MAGIC__=y

#
# ------------------------------------
#

#
# Target Platform Configuration 
#
8< ----------------------------------------------------------------------------
 
- create an empty ptxconfig-file in a new directory under config/systems

8< ----------------------------------------------------------------------------
#
# Automatically generated make config: don't edit
# PTXdist 2012.04.0
#
#
# PTXdist Base Configuration       
#
PTXCONF_CONFIGFILE_VERSION="2012.04.0"
PTXCONF__ptxconfig_MAGIC__=y
8< ----------------------------------------------------------------------------

ptxdist --force select configs/systems/<software config>/ptxconfig
ptxdist platform configs/platforms/<hardware platform>/platformconfig
