summaryrefslogtreecommitdiffstats
path: root/README
blob: e9f980198d08df9fc873decbe19a684390703a1e (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
DistroKit
---------

This is the main repository for DistroKit, an Embedded Linux Board
Support Package (BSP) for the PTXdist [1] Build System.

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.


Installing PTXdist
------------------

DistroKit is built with ptxdist. In order to install ptxdist, download
the tarball from [2]:

$ wget \
  http://www.pengutronix.de/software/ptxdist/download/ptxdist-2016.01.0.tar.bz2

Extract the tarball:

$ tar xf ptxdist-2016.01.0 && cd ptxdist-2016.01.0

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

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 images

PTXdist determines the number of CPUs on your computer and runs the
compiler with <twice the number of CPUs> 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/