From ba9ebc41d68796af335f0fcce4888a332936cea8 Mon Sep 17 00:00:00 2001 From: Robert Schwebel Date: Tue, 13 Jun 2017 17:38:19 +0200 Subject: doc: add sphinx/rst based documentation Signed-off-by: Robert Schwebel --- doc/guru.rst | 19 ++++++++++++++ doc/hardware.rst | 47 ++++++++++++++++++++++++++++++++++ doc/hardware_v7a_beaglebone_black.rst | 5 ++++ doc/hardware_v7a_beaglebone_white.rst | 5 ++++ doc/hardware_v7a_qemu.rst | 6 +++++ doc/hardware_v7a_raspi2.rst | 5 ++++ doc/hardware_v7a_raspi3.rst | 5 ++++ doc/index.rst | 15 +++++++++++ doc/intro.rst | 48 +++++++++++++++++++++++++++++++++++ 9 files changed, 155 insertions(+) create mode 100644 doc/guru.rst create mode 100644 doc/hardware.rst create mode 100644 doc/hardware_v7a_beaglebone_black.rst create mode 100644 doc/hardware_v7a_beaglebone_white.rst create mode 100644 doc/hardware_v7a_qemu.rst create mode 100644 doc/hardware_v7a_raspi2.rst create mode 100644 doc/hardware_v7a_raspi3.rst create mode 100644 doc/index.rst create mode 100644 doc/intro.rst (limited to 'doc') 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 +`_ 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 `_ +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: + + ``_ + +If you want to build the toolchain yourself, you can download the +toolchain sources from + + ``_ + +and build them manually. + -- cgit v1.2.3