diff options
author | Robert Schwebel <r.schwebel@pengutronix.de> | 2017-06-13 17:38:19 +0200 |
---|---|---|
committer | Robert Schwebel <r.schwebel@pengutronix.de> | 2017-06-26 10:24:09 +0200 |
commit | ba9ebc41d68796af335f0fcce4888a332936cea8 (patch) | |
tree | 853f8493b3351b22898fbe955f8a47afffb3f5b9 /doc | |
parent | 4f3e49be463a1f08c6c0fcc61cf81bb7052edce4 (diff) | |
download | DistroKit-ba9ebc41d68796af335f0fcce4888a332936cea8.tar.gz DistroKit-ba9ebc41d68796af335f0fcce4888a332936cea8.tar.xz |
doc: add sphinx/rst based documentation
Signed-off-by: Robert Schwebel <r.schwebel@pengutronix.de>
Diffstat (limited to 'doc')
-rw-r--r-- | doc/guru.rst | 19 | ||||
-rw-r--r-- | doc/hardware.rst | 47 | ||||
-rw-r--r-- | doc/hardware_v7a_beaglebone_black.rst | 5 | ||||
-rw-r--r-- | doc/hardware_v7a_beaglebone_white.rst | 5 | ||||
-rw-r--r-- | doc/hardware_v7a_qemu.rst | 6 | ||||
-rw-r--r-- | doc/hardware_v7a_raspi2.rst | 5 | ||||
-rw-r--r-- | doc/hardware_v7a_raspi3.rst | 5 | ||||
-rw-r--r-- | doc/index.rst | 15 | ||||
-rw-r--r-- | doc/intro.rst | 48 |
9 files changed, 155 insertions, 0 deletions
diff --git a/doc/guru.rst b/doc/guru.rst new file mode 100644 index 0000000..89667ad --- /dev/null +++ b/doc/guru.rst @@ -0,0 +1,19 @@ +Welcome to the PTXdist Universe +=============================== + +.. toctree:: + :glob: + :numbered: 2 + :maxdepth: 3 + + welcome + environment + user_manual_section + dev_manual + ref_manual + daily_work_section + getting_help + +* :ref:`search` +* :ref:`genindex` + diff --git a/doc/hardware.rst b/doc/hardware.rst new file mode 100644 index 0000000..2691503 --- /dev/null +++ b/doc/hardware.rst @@ -0,0 +1,47 @@ +Hardware Platforms +================== + +DistroKit supports a range of hardware, supported by the ptxdist +platforms listed below. A platform can be built with one ``ptxdist +images`` and shares the same cross compiler and binary format. + + +v7a Platform +------------ + +The v7a platform is made for machines based on the ARMv7a architecture. +Select the platform with + +:: + + $ ptxdist platform configs/platform-v7a/platformconfig + info: selected platformconfig: + 'configs/platform-v7a/platformconfig' + +To use the platform, the arm-v7a-linux-gnueabihf toolchain needs to be +installed; if installed from the debian packages or tarballs, ptxdist +is able to find and select the right toolchain with + +:: + + $ ptxdist toolchain + found and using toolchain: + '/opt/OSELAS.Toolchain-2016.06.1/arm-v7a-linux-gnueabihf/gcc-5.4.0-glibc-2.23-binutils-2.26-kernel-4.6-sanitized/bin' + +Now everything is prepared to build the platform with + +:: + + $ ptxdist images + +Hardware for the v7a Platform +----------------------------- + +.. toctree:: + + hardware_v7a_qemu + hardware_v7a_beaglebone_white + hardware_v7a_beaglebone_black + hardware_v7a_raspi2 + hardware_v7a_raspi3 + diff --git a/doc/hardware_v7a_beaglebone_black.rst b/doc/hardware_v7a_beaglebone_black.rst new file mode 100644 index 0000000..ce10d0b --- /dev/null +++ b/doc/hardware_v7a_beaglebone_black.rst @@ -0,0 +1,5 @@ +Beaglebone Black +================ + +foo bar baz + diff --git a/doc/hardware_v7a_beaglebone_white.rst b/doc/hardware_v7a_beaglebone_white.rst new file mode 100644 index 0000000..c62522e --- /dev/null +++ b/doc/hardware_v7a_beaglebone_white.rst @@ -0,0 +1,5 @@ +Beaglebone White +================ + +foo bar baz + diff --git a/doc/hardware_v7a_qemu.rst b/doc/hardware_v7a_qemu.rst new file mode 100644 index 0000000..7352f8c --- /dev/null +++ b/doc/hardware_v7a_qemu.rst @@ -0,0 +1,6 @@ +QEmu +==== + +The v7a platform is ready to run in qemu, using the versatile express +hardware simulation. + diff --git a/doc/hardware_v7a_raspi2.rst b/doc/hardware_v7a_raspi2.rst new file mode 100644 index 0000000..f271772 --- /dev/null +++ b/doc/hardware_v7a_raspi2.rst @@ -0,0 +1,5 @@ +Raspberry Pi 2 +============== + +foo bar baz + diff --git a/doc/hardware_v7a_raspi3.rst b/doc/hardware_v7a_raspi3.rst new file mode 100644 index 0000000..0be6c52 --- /dev/null +++ b/doc/hardware_v7a_raspi3.rst @@ -0,0 +1,5 @@ +Raspberry Pi 3 +============== + +foo bar baz + diff --git a/doc/index.rst b/doc/index.rst new file mode 100644 index 0000000..2ce9c75 --- /dev/null +++ b/doc/index.rst @@ -0,0 +1,15 @@ +Welcome to DistroKit +==================== + +.. toctree:: + :glob: + :numbered: + :maxdepth: 2 + + intro + hardware + guru + +* :ref:`search` +* :ref:`genindex` + diff --git a/doc/intro.rst b/doc/intro.rst new file mode 100644 index 0000000..f02c4af --- /dev/null +++ b/doc/intro.rst @@ -0,0 +1,48 @@ +Introduction +============ + +DistroKit is a Board Support Package (BSP) for the `PTXdist +<http://www.ptxdist.org>`_ build system. It assembles a small (but not +minimalistic) Embedded Linux system with modern components: + +- barebox bootloader +- mainline kernel, as patch free as possible +- systemd based init +- NetworkManager for dbus based network configuration + +It can be used as a base for further BSP development. + +Installing the BSP +------------------ + +DistroKit is built with ptxdist. In order to install ptxdist, +`download the tarball <http://www.pengutronix.de/software/ptxdist/download/ptxdist-|ptxdistVendorVersion|.tar.bz2>`_ +from the PTXdist Download Area. + +Extract the tarball: + +:: + + $ tar xf ptxdist-|ptxdistVendorVersion|.tar.bz2 && cd ptxdist-|ptxdistVendorVersion| + +Go to the extracted directory and run + +:: + + $ ./configure && make && sudo make install + +Installing the Toolchain +------------------------ + +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. + |