From 1efb6cc0c3d6df59c6b56c97616495e8cd316e51 Mon Sep 17 00:00:00 2001 From: Jan Luebbe Date: Sun, 14 Jul 2013 12:42:35 +0200 Subject: distrokit: add README files for DistroKit and platforms Signed-off-by: Jan Luebbe --- README | 83 +++++++++++++++++++++++++++++++++++++++++++++++++++++------------- 1 file changed, 67 insertions(+), 16 deletions(-) (limited to 'README') diff --git a/README b/README index c9a3b2b..c6a9d4b 100644 --- a/README +++ b/README @@ -1,26 +1,77 @@ -OSELAS.BSP-Pengutronix-Generic-2011.01.0: +DistroKit +--------- -This PTXdist[1] based project combines two reference board support packages: +This is the main repository for DistroKit, an Embedded Linux Board +Support Package (BSP) for the PTXdist [1] Build System. -- ARM based "versatilepb" -- X86 generic PC +The main task for PTXdist is to build a root filesystem and a flash +image for the embedded system. PTXdist has a concept of separating the +software configuration from the hardware platforms, so the first +decision to be made is to select for which hardware DistroKit shall be +built. -They are intended to show new users of ptxdist how to prepare and build all -required components for an embedded device. -For further information please read the following documents (part of this -archive): +Installing PTXdist +------------------ -For the generic PC (x86 architecture): -documentation/OSELAS.BSP-Pengutronix-Generic-x86-Quickstart.pdf +DistroKit is built with ptxdist. In order to install ptxdist, download +the tarball from [2]: -For the "versatilepb" (ARM architecture): -documentation/OSELAS.BSP-Pengutronix-Generic-arm-Quickstart.pdf +$ wget \ + http://www.pengutronix.de/software/ptxdist/download/ptxdist-2013.05.0.tar.bz2 -More PTXdist related information can be found at [1]. +Extract the tarball: -Enjoy! +$ tar xf ptxdist-2013.05.0 && cd ptxdist-2013.05.0 -Your Pengutronix Development Team +Go to the extracted directory and run + +$ ./configure && make && sudo make install + + +Selecting the Platform +---------------------- + +For the different hardware platforms, see the instructions about + +- how to install the toolchain +- how to select the right platform +- how to build the rootfs + +in README.. + +In order to build a BSP, you need a toolchain. The easiest way to get a +toolchain is to install the debian packages for OSELAS.Toolchain: + + http://www.pengutronix.de/oselas/toolchain/ + +If you want to build the toolchain yourself, you can download the +toolchain sources from + + http://www.pengutronix.de/oselas/toolchain/download/ + +and build them manually. + + +Building DistroKit +------------------ + +Now everything is prepared to build the BSP: + +$ ptxdist go + +PTXdist determines the number of CPUs on your computer and runs the +compiler with instances in parallel. +Nevertheless, building a root filesystem from the sources needs some +time. + + +References +---------- + +[1] PTXdist + http://www.pengutronix.de/software/ptxdist/ + +[2] PTXdist Download Area + http://www.pengutronix.de/software/ptxdist/download/ -[1] http://www.pengutronix.de/software/ptxdist/index_en.html -- cgit v1.2.3