summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorJuergen Borleis <jbe@pengutronix.de>2016-06-08 17:58:05 +0200
committerMichael Olbrich <m.olbrich@pengutronix.de>2016-06-20 15:04:50 +0200
commitdc5340e05f5759ee0fc5665f6d539f7c7d8ca115 (patch)
tree8d7c649169c7992e3a39b19f78e6110e496cec8a
parent113d053ff62bd621bb5a3c5812e1bb15f376a56d (diff)
downloadptxdist-dc5340e05f5759ee0fc5665f6d539f7c7d8ca115.tar.gz
Re-factor the adaption of the BSP
This section is now more generic to match most of the BSPs Signed-off-by: Juergen Borleis <jbe@pengutronix.de>
-rw-r--r--doc/user_manual.rst43
1 files changed, 43 insertions, 0 deletions
diff --git a/doc/user_manual.rst b/doc/user_manual.rst
index 71dc547..80976f1 100644
--- a/doc/user_manual.rst
+++ b/doc/user_manual.rst
@@ -565,21 +565,40 @@ Meaning of visual feedbacks in Kconfig
- Some entries need a free text to enter, they are marked with leading
brackets ``()`` and the free text in it
+Adapting Userland Settings
+~~~~~~~~~~~~~~~~~~~~~~~~~~
+To do so, we run:
+::
+ $ ptxdist menuconfig
+will show the following console output
+.. figure:: figures/menuconfig_intro.png
+ :alt: Main userland configuration menu
+ :align: center
+ Main userland configuration menu
+The main building blocks in the *userland configuration* menu are:
+- Host Options: Some parts of the project are build host relevant only.
+ For example PTXdist can build the DDD debugger to debug applications
+ running on the target.
+- Root Filesystem: Settings to arrange target’s root filesystem and to
+ select the main C run-time library
+- Applications: Everything we like to run on our target.
At this point it could be useful to walk to the whole menus and their
submenus to get an idea about the amount of features and applications
PTXdist currently supports.
+Note: don't forget to save your changes prior leaving this menu.
+
Adapting Platform Settings
~~~~~~~~~~~~~~~~~~~~~~~~~~
@@ -589,31 +608,55 @@ To do so, we run:
$ ptxdist menuconfig platform
+The main building blocks in the *platform configuration* menu are:
+- Architecture: Basic settings, like the main and sub architecture the
+ target system uses, the toolchain to be used to build everything and
+ some other architecture dependent settings.
+- Linux kernel: Which kernel revision and kernel configuration should
+ be used
+- Bootloader: Which bootloader (if any) should be built in the project
+- The kind of image to populate a root filesystem into the target
+ system
+Note: don't forget to save your changes prior leaving this menu.
Adapting Linux Kernel Settings
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+Just run the following command:
::
$ ptxdist menuconfig kernel
+Note: don't forget to save your changes prior leaving this menu.
+Adapting Bootloader Settings
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+Just run the following command:
::
+ $ ptxdist menuconfig barebox
+Note: don't forget to save your changes prior leaving this menu.
+Making Changes Real
+~~~~~~~~~~~~~~~~~~~
+After a change in whatever menu the next build-run will compile
+or re-compile the changed parts. Due to complex dependencies between these parts
+PTXdist might compile or re-compile more than the changed part.
+To apply the changes just run:
::
$ ptxdist go
+Note: If nothing was changed, ``ptxdist go`` also will do nothing.