[PATCH 6/6] rtems-docs: Edit commands to build first app

Ida Delphine idadelm at gmail.com
Sat Mar 13 15:42:04 UTC 2021


---
 user/start/app.rst | 104 ++++++++++++++++++++++-----------------------
 1 file changed, 52 insertions(+), 52 deletions(-)

diff --git a/user/start/app.rst b/user/start/app.rst
index 8900f78..c343551 100644
--- a/user/start/app.rst
+++ b/user/start/app.rst
@@ -8,7 +8,7 @@ Build Your Application
 ======================
 
 You tested a BSP in the previous section.  We built the ``erc32`` BSP
-and it is installed under :file:`$HOME/quick-start/rtems/5`.
+and it is installed under :file:`$HOME/quick-start/rtems/6`.
 
 We will now create a simple Hello World application with a Git
 repository and using the `Waf <https://waf.io>`_ build system.
@@ -107,7 +107,7 @@ and copy the Waf script:
     #
     from __future__ import print_function
 
-    rtems_version = "5"
+    rtems_version = "6"
 
     try:
         import rtems_waf.rtems as rtems
@@ -142,52 +142,52 @@ Configure the application using Waf's ``configure`` command:
 
 .. code-block:: none
 
-    ./waf configure --rtems=$HOME/quick-start/rtems/5 --rtems-bsp=sparc/erc32
+    ./waf configure --rtems=$HOME/quick-start/rtems/6 --rtems-bsp=sparc/erc32 --rtems-version=6
 
 The output will be something close to:
 
 .. code-block:: none
 
-     Setting top to                           : $BASE/app/hello
-     Setting out to                           : $BASE/app/hello/build
-     RTEMS Version                            : 5
-     Architectures                            : sparc-rtems5
-     Board Support Package (BSP)              : sparc-rtems5-erc32
-     Show commands                            : no
-     Long commands                            : no
-     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-gcc'  : $BASE/rtems/5/bin/sparc-rtems5-gcc
-     Checking for program 'sparc-rtems5-ld'   : $BASE/rtems/5/bin/sparc-rtems5-ld
-     Checking for program 'sparc-rtems5-ar'   : $BASE/rtems/5/bin/sparc-rtems5-ar
-     Checking for program 'sparc-rtems5-nm'   : $BASE/rtems/5/bin/sparc-rtems5-nm
-     Checking for program 'sparc-rtems5-objdump' : $BASE/rtems/5/bin/sparc-rtems5-objdump
-     Checking for program 'sparc-rtems5-objcopy' : $BASE/rtems/5/bin/sparc-rtems5-objcopy
-     Checking for program 'sparc-rtems5-readelf' : $BASE/rtems/5/bin/sparc-rtems5-readelf
-     Checking for program 'sparc-rtems5-strip'   : $BASE/rtems/5/bin/sparc-rtems5-strip
-     Checking for program 'sparc-rtems5-ranlib'  : $BASE/rtems/5/bin/sparc-rtems5-ranlib
-     Checking for program 'rtems-ld'             : $BASE/rtems/5/bin/rtems-ld
-     Checking for program 'rtems-tld'            : $BASE/rtems/5/bin/rtems-tld
-     Checking for program 'rtems-syms'           : $BASE/rtems/5/bin/rtems-syms
-     Checking for program 'rtems-bin2c'          : $BASE/rtems/5/bin/rtems-bin2c
-     Checking for program 'tar'                  : /usr/bin/tar
-     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 '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 c flags '-MMD'                 : yes
-     Checking for cxx flags '-MMD'               : yes
-     Compiler version (sparc-rtems5-gcc)         : 7.5.0 20191114 (RTEMS 5, RSB 5.1.0, Newlib fbaa096)
-     Checking for a valid RTEMS BSP installation : yes
-     Checking for RTEMS_DEBUG                    : no
-     Checking for RTEMS_MULTIPROCESSING          : no
-     Checking for RTEMS_NEWLIB                   : yes
-     Checking for RTEMS_POSIX_API                : yes
-     Checking for RTEMS_SMP                      : no
-     Checking for RTEMS_NETWORKING               : no
-     'configure' finished successfully (0.686s)
+    Setting top to                           : $BASE/app/hello 
+    Setting out to                           : $BASE/app/hello/build 
+    RTEMS Version                            : 6 
+    Architectures                            : sparc-rtems6 
+    Board Support Package (BSP)              : sparc-rtems6-erc32 
+    Show commands                            : no 
+    Long commands                            : no 
+    Checking for program 'sparc-rtems6-gcc'  : $BASE/rtems/6/bin/sparc-rtems6-gcc 
+    Checking for program 'sparc-rtems6-g++'  : $BASE/rtems/6/bin/sparc-rtems6-g++ 
+    Checking for program 'sparc-rtems6-gcc'  : $BASE/rtems/6/bin/sparc-rtems6-gcc 
+    Checking for program 'sparc-rtems6-ld'   : $BASE/rtems/6/bin/sparc-rtems6-ld 
+    Checking for program 'sparc-rtems6-ar'   : $BASE/rtems/6/bin/sparc-rtems6-ar 
+    Checking for program 'sparc-rtems6-nm'   : $BASE/rtems/6/bin/sparc-rtems6-nm 
+    Checking for program 'sparc-rtems6-objdump' : $BASE/rtems/6/bin/sparc-rtems6-objdump 
+    Checking for program 'sparc-rtems6-objcopy' : $BASE/rtems/6/bin/sparc-rtems6-objcopy 
+    Checking for program 'sparc-rtems6-readelf' : $BASE/rtems/6/bin/sparc-rtems6-readelf 
+    Checking for program 'sparc-rtems6-strip'   : $BASE/rtems/6/bin/sparc-rtems6-strip 
+    Checking for program 'sparc-rtems6-ranlib'  : $BASE/rtems/6/bin/sparc-rtems6-ranlib 
+    Checking for program 'rtems-ld'             : $BASE/rtems/6/bin/rtems-ld 
+    Checking for program 'rtems-tld'            : $BASE/rtems/6/bin/rtems-tld 
+    Checking for program 'rtems-syms'           : $BASE/rtems/6/bin/rtems-syms 
+    Checking for program 'rtems-bin2c'          : $BASE/rtems/6/bin/rtems-bin2c 
+    Checking for program 'tar'                  : /usr/bin/tar 
+    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 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 c flags '-MMD'                 : yes 
+    Checking for cxx flags '-MMD'               : yes 
+    Compiler version (sparc-rtems6-gcc)         : 10.2.1 20210309 (RTEMS 6, RSB 5e449fb5c2cb6812a238f9f9764fd339cbbf05c2, Newlib d10d0d9) 
+    Checking for a valid RTEMS BSP installation : yes 
+    Checking for RTEMS_DEBUG                    : no 
+    Checking for RTEMS_MULTIPROCESSING          : no 
+    Checking for RTEMS_NEWLIB                   : yes 
+    Checking for RTEMS_POSIX_API                : no 
+    Checking for RTEMS_SMP                      : no 
+    Checking for RTEMS_NETWORKING               : no 
+    'configure' finished successfully (1.142s)
 
 Build the application:
 
@@ -199,24 +199,24 @@ The output will be something close to:
 
 .. code-block:: none
 
-    Waf: Entering directory `$BASE/app/hello/build/sparc-rtems5-erc32'
+    Waf: Entering directory `$BASE/app/hello/build/sparc-rtems6-erc32'
     [1/3] Compiling init.c
     [2/3] Compiling hello.c
-    [3/3] Linking build/sparc-rtems5-erc32/hello.exe
-    Waf: Leaving directory `$BASE/app/hello/build/sparc-rtems5-erc32'
-    'build-sparc-rtems5-erc32' finished successfully (0.183s)
+    [3/3] Linking build/sparc-rtems6-erc32/hello.exe
+    Waf: Leaving directory `$BASE/app/hello/build/sparc-rtems6-erc32'
+    'build-sparc-rtems6-erc32' finished successfully (0.183s)
 
 Run the executable:
 
 .. code-block:: none
 
-    $HOME/quick-start/rtems/5/bin/rtems-run --rtems-bsps=erc32-sis build/sparc-rtems5-erc32/hello.exe
+    $HOME/quick-start/rtems/6/bin/rtems-run --rtems-bsps=erc32-sis build/sparc-rtems6-erc32/hello.exe
 
 The output will be something close to:
 
 .. code-block:: none
 
-    RTEMS Testing - Run, 5.1.0
+    RTEMS Testing - Run, 6
      Command Line: $BASE/rtems/5/bin/rtems-run --rtems-bsps=erc32-sis build/sparc-rtems5-erc32/hello.exe
      Host: FreeBSD hihi 12.1-RELEASE-p2 FreeBSD 12.1-RELEASE-p2 GENERIC amd64
      Python: 3.7.6 (default, Jan 30 2020, 01:18:54) [Clang 6.0.1 (tags/RELEASE_601/final 335540)]
@@ -232,10 +232,10 @@ The output will be something close to:
     Hello World
 
     *** FATAL ***
-    fatal source: 5 (RTEMS_FATAL_SOURCE_EXIT)
+    fatal source: 6 (RTEMS_FATAL_SOURCE_EXIT)
     fatal code: 0 (0x00000000)
-    RTEMS version: 5.1.0
-    RTEMS tools: 7.5.0 20191114 (RTEMS 5, RSB 5.1.0, Newlib fbaa096)
+    RTEMS version: 6
+    RTEMS tools: 7.5.0 20191114 (RTEMS 6, RSB 6, Newlib fbaa096)
     executing thread ID: 0x08a010001
     executing thread name: UI1
     cpu 0 in error mode (tt = 0x101)
-- 
2.25.1



More information about the devel mailing list