[PATCH 4/6] rtems-docs: Edit command to build BSP and sample output
--- 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) ` 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 -Chec
[PATCH 4/6] rtems-docs: Edit command to build BSP and sample output
--- 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) ` 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 -Chec