[PATCH 4/6] rtems-docs: Edit command to build BSP and sample output

Ida Delphine idadelm at gmail.com
Sat Mar 13 16:27:10 UTC 2021


---
 user/start/bsp-build.rst | 74 ++++++++++++++++++++--------------------
 1 file changed, 37 insertions(+), 37 deletions(-)

diff --git a/user/start/bsp-build.rst b/user/start/bsp-build.rst
index 137b3ab..c4d6db6 100644
--- a/user/start/bsp-build.rst
+++ b/user/start/bsp-build.rst
@@ -11,7 +11,7 @@ Build a Board Support Package (BSP)
 You installed the tool suite in your installation prefix, made ready the source
 for two RTEMS source packages and if you are using a Git clone bootstrapped the
 RTEMS sources in the previous sections.  We installed the tool suite in
-:file:`$HOME/quick-start/rtems/5` and unpacked the source in
+:file:`$HOME/quick-start/rtems/6` and unpacked the source in
 :file:`$HOME/quick-start/src`.
 
 You are now able to build :ref:`Board Support Packages (BSPs) <BSPs>` for all
@@ -44,24 +44,24 @@ To build the BSP with all the tests run this command:
 .. code-block:: none
 
     cd $HOME/quick-start/src/rsb/rtems
-    ../source-builder/sb-set-builder --prefix=$HOME/quick-start/rtems/5 \
-        --target=sparc-rtems5 --with-rtems-bsp=erc32 --with-rtems-tests=yes 5/rtems-kernel
+    ../source-builder/sb-set-builder --prefix=$HOME/quick-start/rtems/6 \
+        --target=sparc-rtems6 --with-rtems-bsp=erc32 --with-rtems-tests=yes 6/rtems-kernel
 
 This command should output something like this:
 
 .. code-block:: none
 
-    RTEMS Source Builder - Set Builder, 5.1.0
-    Build Set: 5/rtems-kernel
+    RTEMS Source Builder - Set Builder, 6
+    Build Set: 6/rtems-kernel
     config: tools/rtems-kernel-5.cfg
-    package: sparc-rtems5-kernel-erc32-1
-    building: sparc-rtems5-kernel-erc32-1
-    sizes: sparc-rtems5-kernel-erc32-1: 2.279GB (installed: 44.612MB)
-    cleaning: sparc-rtems5-kernel-erc32-1
-    reporting: tools/rtems-kernel-5.cfg -> sparc-rtems5-kernel-erc32-1.txt
-    reporting: tools/rtems-kernel-5.cfg -> sparc-rtems5-kernel-erc32-1.xml
-    installing: sparc-rtems5-kernel-erc32-1 -> $BASE/
-    cleaning: sparc-rtems5-kernel-erc32-1
+    package: sparc-rtems6-kernel-erc32-1
+    building: sparc-rtems6-kernel-erc32-1
+    sizes: sparc-rtems6-kernel-erc32-1: 2.279GB (installed: 44.612MB)
+    cleaning: sparc-rtems6-kernel-erc32-1
+    reporting: tools/rtems-kernel-5.cfg -> sparc-rtems6-kernel-erc32-1.txt
+    reporting: tools/rtems-kernel-5.cfg -> sparc-rtems6-kernel-erc32-1.xml
+    installing: sparc-rtems6-kernel-erc32-1 -> $BASE/
+    cleaning: sparc-rtems6-kernel-erc32-1
     Build Set: Time 0:03:09.896961
 
 The RSB BSP build can be customised with following RSB command line options:
@@ -112,13 +112,13 @@ directory to your ``$PATH`` throughout the remaining steps. Run the command:
 
 .. code-block:: none
 
-    export PATH=$HOME/quick-start/rtems/5/bin:"$PATH"
+    export PATH=$HOME/quick-start/rtems/6/bin:"$PATH"
 
 Check your installed tools can be found by running:
 
 .. code-block:: none
 
-    command -v sparc-rtems5-gcc && echo "found" || echo "not found"
+    command -v sparc-rtems6-gcc && echo "found" || echo "not found"
 
 The output should be:
 
@@ -128,7 +128,7 @@ The output should be:
 
 If ``not found`` is printed the tools are not correctly installed or the path
 has not been correctly set. Check the contents of the path
-:file:`$HOME/quick-start/rtems/5/bin` manually and if :file:`sparc-rtems5-gcc`
+:file:`$HOME/quick-start/rtems/6/bin` manually and if :file:`sparc-rtems6-gcc`
 is present the path is wrong. If the file cannot be found return to
 :ref:`QuickStartTools` and install the tools again.
 
@@ -145,7 +145,7 @@ everything else.  For detailed information about the BSP build system, see
     cd $HOME/quick-start/src/rtems
     echo "[sparc/erc32]" > config.ini
     echo "BUILD_TESTS = True" >> config.ini
-    ./waf configure --prefix=$HOME/quick-start/rtems/5
+    ./waf configure --prefix=$HOME/quick-start/rtems/6
 
 The first invocation of ``./waf`` needs a bit of time (e.g. 10 seconds) since an
 internal cache file is populated.  This command should output something like
@@ -158,24 +158,24 @@ by ``$BASE``.
     Setting out to                           : $BASE/src/rtems/build
     Regenerate build specification cache (needs a couple of seconds)...
     Configure board support package (BSP)    : sparc/erc32
-    Checking for program 'sparc-rtems5-gcc'  : $BASE/rtems/5/bin/sparc-rtems5-gcc
-    Checking for program 'sparc-rtems5-g++'  : $BASE/rtems/5/bin/sparc-rtems5-g++
-    Checking for program 'sparc-rtems5-ar'   : $BASE/rtems/5/bin/sparc-rtems5-ar
-    Checking for program 'sparc-rtems5-ld'   : $BASE/rtems/5/bin/sparc-rtems5-ld
-    Checking for program 'ar'                : $BASE/rtems/5/bin/sparc-rtems5-ar
-    Checking for program 'g++, c++'          : $BASE/rtems/5/bin/sparc-rtems5-g++
-    Checking for program 'ar'                : $BASE/rtems/5/bin/sparc-rtems5-ar
-    Checking for program 'gas, gcc'          : $BASE/rtems/5/bin/sparc-rtems5-gcc
-    Checking for program 'ar'                : $BASE/rtems/5/bin/sparc-rtems5-ar
-    Checking for program 'gcc, cc'           : $BASE/rtems/5/bin/sparc-rtems5-gcc
-    Checking for program 'ar'                : $BASE/rtems/5/bin/sparc-rtems5-ar
+    Checking for program 'sparc-rtems5-gcc'  : $BASE/rtems/6/bin/sparc-rtems6-gcc
+    Checking for program 'sparc-rtems5-g++'  : $BASE/rtems/6/bin/sparc-rtems6-g++
+    Checking for program 'sparc-rtems5-ar'   : $BASE/rtems/6/bin/sparc-rtems6-ar
+    Checking for program 'sparc-rtems5-ld'   : $BASE/rtems/6/bin/sparc-rtems6-ld
+    Checking for program 'ar'                : $BASE/rtems/6/bin/sparc-rtems6-ar
+    Checking for program 'g++, c++'          : $BASE/rtems/6/bin/sparc-rtems6-g++
+    Checking for program 'ar'                : $BASE/rtems/6/bin/sparc-rtems6-ar
+    Checking for program 'gas, gcc'          : $BASE/rtems/6/bin/sparc-rtems6-gcc
+    Checking for program 'ar'                : $BASE/rtems/6/bin/sparc-rtems6-ar
+    Checking for program 'gcc, cc'           : $BASE/rtems/6/bin/sparc-rtems6-gcc
+    Checking for program 'ar'                : $BASE/rtems/6/bin/sparc-rtems6-ar
     Checking for c flags '-MMD'              : yes
     Checking for cxx flags '-MMD'            : yes
-    Checking for program 'rtems-bin2c'       : $BASE/rtems/5/bin/rtems-bin2c
+    Checking for program 'rtems-bin2c'       : $BASE/rtems/6/bin/rtems-bin2c
     Checking for program 'gzip'              : /usr/bin/gzip
     Checking for program 'pax'               : /usr/bin/pax
-    Checking for program 'rtems-ld'          : $BASE/rtems/5/bin/rtems-ld
-    Checking for program 'rtems-syms'        : $BASE/rtems/5/bin/rtems-syms
+    Checking for program 'rtems-ld'          : $BASE/rtems/6/bin/rtems-ld
+    Checking for program 'rtems-syms'        : $BASE/rtems/6/bin/rtems-syms
     Checking for program 'xz'                : /usr/bin/xz
     'configure' finished successfully (11.069s)
 
@@ -220,12 +220,12 @@ by ``$BASE``.
     Waf: Leaving directory `$BASE/src/rtems/build'
     'install' finished successfully (0.544s)
     Waf: Entering directory `$BASE/src/rtems/build/sparc/erc32'
-    + install $BASE/rtems/5/sparc-rtems5/erc32/lib/start.o (from build/sparc/erc32/start.o)
-    + install $BASE/rtems/5/sparc-rtems5/erc32/lib/include/bspopts.h (from build/sparc/erc32/bsps/include/bspopts.h)
-    + install $BASE/rtems/5/sparc-rtems5/erc32/lib/include/rtems/zilog/z8036.h (from bsps/include/rtems/zilog/z8036.h)
+    + install $BASE/rtems/6/sparc-rtems6/erc32/lib/start.o (from build/sparc/erc32/start.o)
+    + install $BASE/rtems/6/sparc-rtems6/erc32/lib/include/bspopts.h (from build/sparc/erc32/bsps/include/bspopts.h)
+    + install $BASE/rtems/6/sparc-rtems6/erc32/lib/include/rtems/zilog/z8036.h (from bsps/include/rtems/zilog/z8036.h)
     ...
-    + install $BASE/rtems/5/sparc-rtems5/erc32/lib/include/rtems/score/watchdogimpl.h (from cpukit/include/rtems/score/watchdogimpl.h)
-    + install $BASE/rtems/5/sparc-rtems5/erc32/lib/include/rtems/score/watchdogticks.h (from cpukit/include/rtems/score/watchdogticks.h)
-    + install $BASE/rtems/5/sparc-rtems5/erc32/lib/include/rtems/score/wkspace.h (from cpukit/include/rtems/score/wkspace.h)
+    + install $BASE/rtems/6/sparc-rtems6/erc32/lib/include/rtems/score/watchdogimpl.h (from cpukit/include/rtems/score/watchdogimpl.h)
+    + install $BASE/rtems/6/sparc-rtems6/erc32/lib/include/rtems/score/watchdogticks.h (from cpukit/include/rtems/score/watchdogticks.h)
+    + install $BASE/rtems/6/sparc-rtems6/erc32/lib/include/rtems/score/wkspace.h (from cpukit/include/rtems/score/wkspace.h)
     Waf: Leaving directory `$BASE/src/rtems/build/sparc/erc32'
     'install_sparc/erc32' finished successfully (2.985s)
-- 
2.25.1



More information about the devel mailing list