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

Gedare Bloom gedare at rtems.org
Mon Mar 15 19:50:31 UTC 2021


Hi Ida,

did you send the same set of patches twice, or are there changes
between the two sets?

On Sun, Mar 14, 2021 at 8:26 PM Ida Delphine <idadelm at gmail.com> wrote:
>
> ---
>  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
>
> _______________________________________________
> devel mailing list
> devel at rtems.org
> http://lists.rtems.org/mailman/listinfo/devel


More information about the devel mailing list