From 86518bd3ddeecc23d93344f085b042246e4adfdf Mon Sep 17 00:00:00 2001 From: Chris Johns Date: Mon, 4 Jul 2016 12:30:09 +1000 Subject: Reorganisse the User Manual to make it easier to navigate. --- user/installation/developer.rst | 672 ++++++++++++++++++++++++++++++++++++++++ 1 file changed, 672 insertions(+) create mode 100644 user/installation/developer.rst (limited to 'user/installation/developer.rst') diff --git a/user/installation/developer.rst b/user/installation/developer.rst new file mode 100644 index 0000000..0db4a51 --- /dev/null +++ b/user/installation/developer.rst @@ -0,0 +1,672 @@ +.. comment SPDX-License-Identifier: CC-BY-SA-4.0 + +.. comment: Copyright (c) 2016 Chris Johns +.. comment: All rights reserved. + +.. _developer: +.. _development-version: +.. _unstable: + +Developer (Unstable) +-------------------- +.. index:: Git + +RTEMS provides open access to it's development processes. We call this the +developer set up. The project encouages all users to inspect, review, comment +and contribute to the code base. The processes described here are the same +processes the core development team use when developing and maintaining RTEMS. + +.. warning:: + + The development version is not for use in production and it can break from + time to time. + +Please read :ref:`development-host` before continuing. The following procedure +assumes you have installed and configured your host operating system. It also +assumes you have installed any dependent packages needed when building the +tools and the kernel. + +You need to select a location to build and install the RTEMS Tool chain and +RTEMS. Make sure there is plenty of disk space and a fast disk is +recommended. Our procedure will document building and installing the tools in a +home directory called :file:`development/rtems`. Using a home directory means +you can do this without needing to be root. You can also use +:file:`/opt/rtems/build` if you have access to that path. + +The location used to install the tools and kernel is called the `prefix`. It is +best to have a `prefix` for each different version of RTEMS you are using. If +you are using RTEMS 4.11 in production it is not a good idea to install a +development version of 4.12 over the top. A separate `prefix` for each version +avoids this. + +The RTEMS tool chain changes less often than the RTEMS kernel. One method of +working with development releases is to have a separate `prefix` for the RTEMS +tools and a different one for the RTEMS kernel. You can then update each +without interacting with the other. You can also have a number of RTEMS +versions available to test with. + +.. sidebar:: *Downloading the source* + + You need an internet connection to download the source. The downloaded source + is cached locally and the RSB checksums it. If you run a build again the + download output will be missing. Using the RSB from git will download the + source from the upstream project's home site and this could be `http`, `ftp`, + or `git`. + +.. _posix-host-tools-chain: +.. _macos-host-tools-chain: + +POSIX and OS X Host Tools Chain +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +This procedure will build a SPARC tool chain. + +Clone the RTEMS Source Builder (RSB) repository: + +.. code-block:: shell + + $ cd + $ mkdir -p development/rtems + $ cd development/rtems + $ git clone git://git.rtems.org/rtems-source-builder.git rsb + Cloning into 'rsb'... + remote: Counting objects: 5837, done. + remote: Compressing objects: 100% (2304/2304), done. + remote: Total 5837 (delta 4014), reused 5056 (delta 3494) + Receiving objects: 100% (5837/5837), 2.48 MiB | 292.00 KiB/s, done. + Resolving deltas: 100% (4014/4014), done. + Checking connectivity... done. + +Check all the host packages you need are present. Current libraries are not +checked and this includes checking for the python development libraries GDB +requires: + +.. code-block:: shell + + $ cd rsb + $ ./source-builder/sb-check + RTEMS Source Builder - Check, 4.12 (e645642255cc) + Environment is ok + +Build a tool chain for the SPARC architecure. We are using the SPARC +architecture because GDB has a good simulator that lets us run and test the +samples RTEMS builds by default. The current development version +is `4.12` and is on master: + +.. code-block:: shell + + $ cd rtems + $ ../source-builder/sb-set-builder \ + --prefix=/usr/home/chris/development/rtems/4.12 4.12/rtems-sparc + RTEMS Source Builder - Set Builder, 4.12 (e645642255cc) + Build Set: 4.12/rtems-sparc + Build Set: 4.12/rtems-autotools.bset + Build Set: 4.12/rtems-autotools-internal.bset + config: tools/rtems-autoconf-2.69-1.cfg + package: autoconf-2.69-x86_64-linux-gnu-1 + Creating source directory: sources + download: ftp://ftp.gnu.org/gnu/autoconf/autoconf-2.69.tar.gz -> sources/autoconf-2.69.tar.gz + downloading: sources/autoconf-2.69.tar.gz - 1.8MB of 1.8MB (100%) + building: autoconf-2.69-x86_64-linux-gnu-1 + config: tools/rtems-automake-1.12.6-1.cfg + package: automake-1.12.6-x86_64-linux-gnu-1 + download: ftp://ftp.gnu.org/gnu/automake/automake-1.12.6.tar.gz -> sources/automake-1.12.6.tar.gz + downloading: sources/automake-1.12.6.tar.gz - 2.0MB of 2.0MB (100%) + Creating source directory: patches + download: https://git.rtems.org/rtems-tools/plain/tools/4.12/automake/automake-1.12.6-bugzilla.redhat.com-1239379.diff -> patches/automake-1.12.6-bugzilla.redhat.com-1239379.diff + downloading: patches/automake-1.12.6-bugzilla.redhat.com-1239379.diff - 408.0 bytes of 408.0 bytes (100%) + building: automake-1.12.6-x86_64-linux-gnu-1 + cleaning: autoconf-2.69-x86_64-linux-gnu-1 + cleaning: automake-1.12.6-x86_64-linux-gnu-1 + Build Set: Time 0:00:17.465024 + Build Set: 4.12/rtems-autotools-base.bset + config: tools/rtems-autoconf-2.69-1.cfg + package: autoconf-2.69-x86_64-linux-gnu-1 + building: autoconf-2.69-x86_64-linux-gnu-1 + reporting: tools/rtems-autoconf-2.69-1.cfg -> autoconf-2.69-x86_64-linux-gnu-1.txt + reporting: tools/rtems-autoconf-2.69-1.cfg -> autoconf-2.69-x86_64-linux-gnu-1.xml + config: tools/rtems-automake-1.12.6-1.cfg + package: automake-1.12.6-x86_64-linux-gnu-1 + building: automake-1.12.6-x86_64-linux-gnu-1 + reporting: tools/rtems-automake-1.12.6-1.cfg -> automake-1.12.6-x86_64-linux-gnu-1.txt + reporting: tools/rtems-automake-1.12.6-1.cfg -> automake-1.12.6-x86_64-linux-gnu-1.xml + installing: autoconf-2.69-x86_64-linux-gnu-1 -> /usr/home/chris/development/rtems/4.12 + installing: automake-1.12.6-x86_64-linux-gnu-1 -> /usr/home/chris/development/rtems/4.12 + cleaning: autoconf-2.69-x86_64-linux-gnu-1 + cleaning: automake-1.12.6-x86_64-linux-gnu-1 + Build Set: Time 0:00:05.358624 + Build Set: Time 0:00:22.824422 + config: devel/expat-2.1.0-1.cfg + package: expat-2.1.0-x86_64-linux-gnu-1 + download: http://downloads.sourceforge.net/project/expat/expat/2.1.0/expat-2.1.0.tar.gz -> sources/expat-2.1.0.tar.gz + redirect: http://internode.dl.sourceforge.net/project/expat/expat/2.1.0/expat-2.1.0.tar.gz + downloading: sources/expat-2.1.0.tar.gz - 549.4kB of 549.4kB (100%) + building: expat-2.1.0-x86_64-linux-gnu-1 + reporting: devel/expat-2.1.0-1.cfg -> expat-2.1.0-x86_64-linux-gnu-1.txt + reporting: devel/expat-2.1.0-1.cfg -> expat-2.1.0-x86_64-linux-gnu-1.xml + config: tools/rtems-binutils-2.26-1.cfg + package: sparc-rtems4.12-binutils-2.26-x86_64-linux-gnu-1 + download: ftp://ftp.gnu.org/gnu/binutils/binutils-2.26.tar.bz2 -> sources/binutils-2.26.tar.bz2 + downloading: sources/binutils-2.26.tar.bz2 - 24.4MB of 24.4MB (100%) + download: https://git.rtems.org/rtems-tools/plain/tools/4.12/binutils/binutils-2.26-rtems-aarch64-x86_64.patch -> patches/binutils-2.26-rtems-aarch64-x86_64.patch + downloading: patches/binutils-2.26-rtems-aarch64-x86_64.patch - 3.2kB of 3.2kB (100%) + building: sparc-rtems4.12-binutils-2.26-x86_64-linux-gnu-1 + reporting: tools/rtems-binutils-2.26-1.cfg -> sparc-rtems4.12-binutils-2.26-x86_64-linux-gnu-1.txt + reporting: tools/rtems-binutils-2.26-1.cfg -> sparc-rtems4.12-binutils-2.26-x86_64-linux-gnu-1.xml + config: tools/rtems-gcc-6-20160228-newlib-2.3.0.20160226-1.cfg + package: sparc-rtems4.12-gcc-6-20160228-newlib-2.3.0.20160226-x86_64-linux-gnu-1 + download: ftp://gcc.gnu.org/pub/gcc/snapshots/6-20160228/gcc-6-20160228.tar.bz2 -> sources/gcc-6-20160228.tar.bz2 + downloading: sources/gcc-6-20160228.tar.bz2 - 90.8MB of 90.8MB (100%) + download: ftp://sourceware.org/pub/newlib/newlib-2.3.0.20160226.tar.gz -> sources/newlib-2.3.0.20160226.tar.gz + downloading: sources/newlib-2.3.0.20160226.tar.gz - 16.9MB of 16.9MB (100%) + download: http://www.mpfr.org/mpfr-2.4.2/mpfr-2.4.2.tar.bz2 -> + sources/mpfr-2.4.2.tar.bz2 + downloading: sources/mpfr-2.4.2.tar.bz2 - 1.0MB of 1.0MB (100%) + download: http://www.multiprecision.org/mpc/download/mpc-0.8.1.tar.gz -> sources/mpc-0.8.1.tar.gz + downloading: sources/mpc-0.8.1.tar.gz - 532.2kB of 532.2kB (100%) + download: ftp://ftp.gnu.org/gnu/gmp/gmp-4.3.2.tar.bz2 -> sources/gmp-4.3.2.tar.bz2 + downloading: sources/gmp-4.3.2.tar.bz2 - 1.8MB of 1.8MB (100%) + building: sparc-rtems4.12-gcc-6-20160228-newlib-2.3.0.20160226-x86_64-linux-gnu-1 + reporting: tools/rtems-gcc-6-20160228-newlib-2.3.0.20160226-1.cfg -> sparc-rtems4.12-gcc-6-20160228-newlib-2.3.0.20160226-x86_64-linux-gnu-1.txt + reporting: tools/rtems-gcc-6-20160228-newlib-2.3.0.20160226-1.cfg -> sparc-rtems4.12-gcc-6-20160228-newlib-2.3.0.20160226-x86_64-linux-gnu-1.xml + config: tools/rtems-gdb-7.9-1.cfg + package: sparc-rtems4.12-gdb-7.9-x86_64-linux-gnu-1 + download: http://ftp.gnu.org/gnu/gdb/gdb-7.9.tar.xz -> sources/gdb-7.9.tar.xz + downloading: sources/gdb-7.9.tar.xz - 17.0MB of 17.0MB (100%) + download: https://git.rtems.org/rtems-tools/plain/tools/4.12/gdb/gdb-sim-arange-inline.diff -> patches/gdb-sim-arange-inline.diff + downloading: patches/gdb-sim-arange-inline.diff - 761.0 bytes of 761.0 bytes (100%) + download: https://git.rtems.org/rtems-tools/plain/tools/4.12/gdb/gdb-sim-cgen-inline.diff -> patches/gdb-sim-cgen-inline.diff + downloading: patches/gdb-sim-cgen-inline.diff - 706.0 bytes of 706.0 bytes (100%) + download: https://git.rtems.org/rtems-tools/plain/tools/4.12/gdb/gdb-7.9-aarch64-x86_64.patch -> patches/gdb-7.9-aarch64-x86_64.patch + downloading: patches/gdb-7.9-aarch64-x86_64.patch - 1.7kB of 1.7kB (100%) + building: sparc-rtems4.12-gdb-7.9-x86_64-linux-gnu-1 + reporting: tools/rtems-gdb-7.9-1.cfg -> sparc-rtems4.12-gdb-7.9-x86_64-linux-gnu-1.txt + reporting: tools/rtems-gdb-7.9-1.cfg -> sparc-rtems4.12-gdb-7.9-x86_64-linux-gnu-1.xml + config: tools/rtems-tools-4.12-1.cfg + package: rtems-tools-HEAD-1 + Creating source directory: sources/git + git: clone: git://git.rtems.org/rtems-tools.git -> sources/git/rtems-tools.git + git: reset: git://git.rtems.org/rtems-tools.git + git: fetch: git://git.rtems.org/rtems-tools.git -> sources/git/rtems-tools.git + git: checkout: git://git.rtems.org/rtems-tools.git => HEAD + git: pull: git://git.rtems.org/rtems-tools.git + building: rtems-tools-HEAD-1 + reporting: tools/rtems-tools-4.12-1.cfg -> rtems-tools-HEAD-1.txt + reporting: tools/rtems-tools-4.12-1.cfg -> rtems-tools-HEAD-1.xml + installing: expat-2.1.0-x86_64-linux-gnu-1 -> /usr/home/chris/development/rtems/4.12 + installing: sparc-rtems4.12-binutils-2.26-x86_64-linux-gnu-1 -> /usr/home/chris/development/rtems/4.12 + installing: sparc-rtems4.12-gcc-6-20160228-newlib-2.3.0.20160226-x86_64-linux-gnu-1 -> /usr/home/chris/development/rtems/4.12 + installing: sparc-rtems4.12-gdb-7.9-x86_64-linux-gnu-1 -> /usr/home/chris/development/rtems/4.12 + installing: rtems-tools-HEAD-1 -> /usr/home/chris/development/rtems/4.12 + cleaning: expat-2.1.0-x86_64-linux-gnu-1 + cleaning: sparc-rtems4.12-binutils-2.26-x86_64-linux-gnu-1 + cleaning: sparc-rtems4.12-gcc-6-20160228-newlib-2.3.0.20160226-x86_64-linux-gnu-1 + cleaning: sparc-rtems4.12-gdb-7.9-x86_64-linux-gnu-1 + cleaning: rtems-tools-HEAD-1 + Build Set: Time 0:31:09.754219 + +.. _windows-tool-chain: + +Windows Host Tool Chain +~~~~~~~~~~~~~~~~~~~~~~~ +.. index:: Microsoft Windows Installation + +This section details how you create an RTEMS development environment on +Windows. The installation documented here is on `Windows 7 64bit +Professional`. Building on `Windows 10` has been reported as working. + +Please see :ref:`microsoft-windows` before continuing. + +.. note:: + + If the RSB reports ``error: no hosts defaults found; please add`` you have + probably opened an MSYS2 32bit Shell. Close all 32bit Shell windows and open + the MSYS2 64bit Shell. + +RTEMS Windows Tools +^^^^^^^^^^^^^^^^^^^ + +Create a workspace for RTEMS using the following shell command: + +.. sidebar:: *Creating Tool Archives* + + Add ``--bset-tar-file`` to the ``sb-set-builder`` command line to create + tar files of the built package set. + +.. code-block:: shell + + ~ + $ mkdir -p /c/opt/rtems + +The ``/c`` path is an internal MSYS2 mount point of the ``C:`` drive. The +command creates the RTEMS work space on the ``C:`` drive. If you wish to use +another drive please subsitute ``/c`` with your drive letter. + +We build and install all RTEMS packages under the `prefix` we just +created. Change to that directory and get a copy of the RSB: + +.. code-block:: shell + + ~ + $ cd /c/opt/rtems + /c/opt/rtems + $ git clone git://git.rtems.org/rtems-source-builder.git rsb + Cloning into 'rsb'... + remote: Counting objects: 5716, done. + remote: Compressing objects: 100% (2183/2183), done. + remote: Total 5716 (delta 3919), reused 5071 (delta 3494) + Receiving objects: 100% (5716/5716), 2.46 MiB | 656.00 KiB/s, done. + Resolving deltas: 100% (3919/3919), done. + Checking connectivity... done. + Checking out files: 100% (630/630), done. + /c/opt/rtems + $ cd rsb + +We are building RTEMS 4.11 tools so select the *4.11* branch: + +.. code-block:: shell + + /c/opt/rtems/rsb + $ git checkout 4.11 + Branch 4.11 set up to track remote branch 4.11 from origin. + Switched to a new branch '4.11' + /c/opt/rtems/rsb + $ + +Check the RSB has a valid environment: + +.. code-block:: shell + + /c/opt/rtems/rsb + $ cd rtems + /c/opt/rtems/rsb/rtems + $ ../source-builder/sb-check + RTEMS Source Builder - Check, 4.11 (01ac76f2f90f) + Environment is ok + /c/opt/rtems/rsb/rtems + $ + +To build a set of RTEMS tools for the Intel ``i386`` architecture. The build +runs a single job rather than a job per CPU in your machine and will take a +long time so please be patient. The RSB creates a log file containing all the +build output and it will be changing size. The RSB command to build ``i386`` +tools is: + +.. code-block:: shell + + /c/opt/rtems/rsb/rtems + $ ../source-builder/sb-set-builder --prefix=/c/opt/rtems/4.11 \ + --jobs=none 4.11/rtems-i386 + RTEMS Source Builder - Set Builder, 4.11 (01ac76f2f90f) + Build Set: 4.11/rtems-i386 + Build Set: 4.11/rtems-autotools.bset + Build Set: 4.11/rtems-autotools-internal.bset + config: tools/rtems-autoconf-2.69-1.cfg + package: autoconf-2.69-x86_64-w64-mingw32-1 + Creating source directory: sources + download: ftp://ftp.gnu.org/gnu/autoconf/autoconf-2.69.tar.gz -> sources/autoconf-2.69.tar.gz + downloading: sources/autoconf-2.69.tar.gz - 1.8MB of 1.8MB (100%) + building: autoconf-2.69-x86_64-w64-mingw32-1 + config: tools/rtems-automake-1.12.6-1.cfg + package: automake-1.12.6-x86_64-w64-mingw32-1 + download: ftp://ftp.gnu.org/gnu/automake/automake-1.12.6.tar.gz -> sources/automake-1.12.6.tar.gz + downloading: sources/automake-1.12.6.tar.gz - 2.0MB of 2.0MB (100%) + building: automake-1.12.6-x86_64-w64-mingw32-1 + cleaning: autoconf-2.69-x86_64-w64-mingw32-1 + cleaning: automake-1.12.6-x86_64-w64-mingw32-1 + Build Set: Time 0:00:42.515625 + Build Set: 4.11/rtems-autotools-base.bset + config: tools/rtems-autoconf-2.69-1.cfg + package: autoconf-2.69-x86_64-w64-mingw32-1 + building: autoconf-2.69-x86_64-w64-mingw32-1 + reporting: tools/rtems-autoconf-2.69-1.cfg -> autoconf-2.69-x86_64-w64-mingw32-1.txt + reporting: tools/rtems-autoconf-2.69-1.cfg -> autoconf-2.69-x86_64-w64-mingw32-1.xml + config: tools/rtems-automake-1.12.6-1.cfg + package: automake-1.12.6-x86_64-w64-mingw32-1 + building: automake-1.12.6-x86_64-w64-mingw32-1 + reporting: tools/rtems-automake-1.12.6-1.cfg -> automake-1.12.6-x86_64-w64-mingw32-1.txt + reporting: tools/rtems-automake-1.12.6-1.cfg -> automake-1.12.6-x86_64-w64-mingw32-1.xml + tarball: tar/rtems-4.11-autotools-x86_64-w64-mingw32-1.tar.bz2 + installing: autoconf-2.69-x86_64-w64-mingw32-1 -> C:\opt\rtems\4.11 + installing: automake-1.12.6-x86_64-w64-mingw32-1 -> C:\opt\rtems\4.11 + cleaning: autoconf-2.69-x86_64-w64-mingw32-1 + cleaning: automake-1.12.6-x86_64-w64-mingw32-1 + Build Set: Time 0:00:37.718750 + Build Set: Time 0:01:20.234375 + config: devel/expat-2.1.0-1.cfg + package: expat-2.1.0-x86_64-w64-mingw32-1 + download: http://downloads.sourceforge.net/project/expat/expat/2.1.0/expat-2.1.0.tar.gz -> sources/expat-2.1.0.tar.gz + redirect: http://iweb.dl.sourceforge.net/project/expat/expat/2.1.0/expat-2.1.0.tar.gz + downloading: sources/expat-2.1.0.tar.gz - 549.4kB of 549.4kB (100%) + building: expat-2.1.0-x86_64-w64-mingw32-1 + reporting: devel/expat-2.1.0-1.cfg -> expat-2.1.0-x86_64-w64-mingw32-1.txt + reporting: devel/expat-2.1.0-1.cfg -> expat-2.1.0-x86_64-w64-mingw32-1.xml + config: tools/rtems-binutils-2.24-1.cfg + package: i386-rtems4.11-binutils-2.24-x86_64-w64-mingw32-1 + download: ftp://ftp.gnu.org/gnu/binutils/binutils-2.24.tar.bz2 -> sources/binutils-2.24.tar.bz2 + downloading: sources/binutils-2.24.tar.bz2 - 21.7MB of 21.7MB (100%) + building: i386-rtems4.11-binutils-2.24-x86_64-w64-mingw32-1 + reporting: tools/rtems-binutils-2.24-1.cfg -> i386-rtems4.11-binutils-2.24-x86_64-w64-mingw32-1.txt + reporting: tools/rtems-binutils-2.24-1.cfg -> i386-rtems4.11-binutils-2.24-x86_64-w64-mingw32-1.xml + config: tools/rtems-gcc-4.9.3-newlib-2.2.0-20150423-1.cfg + package: i386-rtems4.11-gcc-4.9.3-newlib-2.2.0.20150423-x86_64-w64-mingw32-1 + download: ftp://ftp.gnu.org/gnu/gcc/gcc-4.9.3/gcc-4.9.3.tar.bz2 -> sources/gcc-4.9.3.tar.bz2 + downloading: sources/gcc-4.9.3.tar.bz2 - 85.8MB of 85.8MB (100%) + download: ftp://sourceware.org/pub/newlib/newlib-2.2.0.20150423.tar.gz -> sources/newlib-2.2.0.20150423.tar.gz + downloading: sources/newlib-2.2.0.20150423.tar.gz - 16.7MB of 16.7MB (100%) + download: http://www.mpfr.org/mpfr-3.0.1/mpfr-3.0.1.tar.bz2 -> sources/mpfr-3.0.1.tar.bz2 + downloading: sources/mpfr-3.0.1.tar.bz2 - 1.1MB of 1.1MB (100%) + download: http://www.multiprecision.org/mpc/download/mpc-0.8.2.tar.gz -> sources/mpc-0.8.2.tar.gz + downloading: sources/mpc-0.8.2.tar.gz - 535.5kB of 535.5kB (100%) + download: ftp://ftp.gnu.org/gnu/gmp/gmp-5.0.5.tar.bz2 -> sources/gmp-5.0.5.tar.bz2 + downloading: sources/gmp-5.0.5.tar.bz2 - 2.0MB of 2.0MB (100%) + building: i386-rtems4.11-gcc-4.9.3-newlib-2.2.0.20150423-x86_64-w64-mingw32-1 + reporting: tools/rtems-gcc-4.9.3-newlib-2.2.0-20150423-1.cfg -> + i386-rtems4.11-gcc-4.9.3-newlib-2.2.0.20150423-x86_64-w64-mingw32-1.txt + reporting: tools/rtems-gcc-4.9.3-newlib-2.2.0-20150423-1.cfg -> + i386-rtems4.11-gcc-4.9.3-newlib-2.2.0.20150423-x86_64-w64-mingw32-1.xml + config: tools/rtems-gdb-7.9-1.cfg + package: i386-rtems4.11-gdb-7.9-x86_64-w64-mingw32-1 + download: http://ftp.gnu.org/gnu/gdb/gdb-7.9.tar.xz -> sources/gdb-7.9.tar.xz + downloading: sources/gdb-7.9.tar.xz - 17.0MB of 17.0MB (100%) + download: https://git.rtems.org/rtems-tools/plain/tools/4.11/gdb/gdb-sim-arange-inline.diff -> patches/gdb-sim-arange-inline.diff + downloading: patches/gdb-sim-arange-inline.diff - 761.0 bytes of 761.0 bytes (100%) + download: https://git.rtems.org/rtems-tools/plain/tools/4.11/gdb/gdb-sim-cgen-inline.diff -> patches/gdb-sim-cgen-inline.diff + downloading: patches/gdb-sim-cgen-inline.diff - 706.0 bytes of 706.0 bytes (100%) + building: i386-rtems4.11-gdb-7.9-x86_64-w64-mingw32-1 + reporting: tools/rtems-gdb-7.9-1.cfg -> + i386-rtems4.11-gdb-7.9-x86_64-w64-mingw32-1.txt + reporting: tools/rtems-gdb-7.9-1.cfg -> + i386-rtems4.11-gdb-7.9-x86_64-w64-mingw32-1.xml + config: tools/rtems-tools-4.11-1.cfg + package: rtems-tools-4.11-1 + Creating source directory: sources/git + git: clone: git://git.rtems.org/rtems-tools.git -> sources/git/rtems-tools.git + git: reset: git://git.rtems.org/rtems-tools.git + git: fetch: git://git.rtems.org/rtems-tools.git -> sources/git/rtems-tools.git + git: checkout: git://git.rtems.org/rtems-tools.git => 4.11 + git: pull: git://git.rtems.org/rtems-tools.git + building: rtems-tools-4.11-1 + reporting: tools/rtems-tools-4.11-1.cfg -> rtems-tools-4.11-1.txt + reporting: tools/rtems-tools-4.11-1.cfg -> rtems-tools-4.11-1.xml + config: tools/rtems-kernel-4.11.cfg + installing: expat-2.1.0-x86_64-w64-mingw32-1 -> C:\opt\rtems\4.11 + installing: i386-rtems4.11-binutils-2.24-x86_64-w64-mingw32-1 -> C:\opt\rtems\4.11 + installing: i386-rtems4.11-gcc-4.9.3-newlib-2.2.0.20150423-x86_64-w64-mingw32-1 -> C:\opt\rtems\4.11 + installing: i386-rtems4.11-gdb-7.9-x86_64-w64-mingw32-1 -> C:\opt\rtems\4.11 + installing: rtems-tools-4.11-1 -> C:\opt\rtems\4.11 + cleaning: expat-2.1.0-x86_64-w64-mingw32-1 + cleaning: i386-rtems4.11-binutils-2.24-x86_64-w64-mingw32-1 + cleaning: i386-rtems4.11-gcc-4.9.3-newlib-2.2.0.20150423-x86_64-w64-mingw32-1 + cleaning: i386-rtems4.11-gdb-7.9-x86_64-w64-mingw32-1 + cleaning: rtems-tools-4.11-1 + Build Set: Time 1:32:58.972919 + /c/opt/rtems/rsb/rtems + $ + +.. _rtems-kernel-install: + +Building the Kernel +^^^^^^^^^^^^^^^^^^^ + +We can now build the RTEMS kernel using the RTEMS tools we have just +built. First we need to set the path to the tools: + +.. code-block:: shell + + /c + $ cd /c/opt/rtems + /c/opt/rtems + $ export PATH=/c/opt/rtems/4.11/bin:$PATH + /c/opt/rtems + $ + +We currently build RTEMS from the git release branch for 4.11: + +.. code-block:: shell + + /c/opt/rtems + $ mkdir kernel + /c/opt/rtems + $ cd kernel + /c/opt/rtems/kernel + $ git clone git://git.rtems.org/rtems.git rtems + Cloning into 'rtems'... + remote: Counting objects: 482766, done. + remote: Compressing objects: 100% (88781/88781), done. + remote: Total 482766 (delta 389610), reused 475155 (delta 383437) + Receiving objects: 100% (482766/482766), 69.77 MiB | 697.00 KiB/s, done. + Resolving deltas: 100% (389610/389610), done. + Checking connectivity... done. + Checking out files: 100% (10626/10626), done. + /c/opt/rtems/kernel + $ cd rtems + /c/opt/rtems/kernel/rtems + $ git checkout 4.11 + Checking out files: 100% (2553/2553), done. + Branch 4.11 set up to track remote branch 4.11 from origin. + Switched to a new branch '4.11' + /c/opt/rtems/kernel + $ + +The kernel code cloned from git needs to be `bootstrapped`. Bootstrapping +creates ``autoconf`` and ``automake`` generated files. To bootstrap we first +clean away any files, then generate the pre-install header file lists and +finally we generate the ``autoconf`` and ``automake`` files using the RSB's +bootstrap tool. First we clean any generated files that exist: + +.. code-block:: shell + + /c/opt/rtems/kernel/rtems + $ ./bootstrap -c + removing automake generated Makefile.in files + removing configure files + removing aclocal.m4 files + +Then we generate the pre-install header file automake make files: + +.. code-block:: shell + + /c/opt/rtems/kernel/rtems + $ ./bootstrap -p + Generating ./c/src/ada/preinstall.am + Generating ./c/src/lib/libbsp/arm/altera-cyclone-v/preinstall.am + Generating ./c/src/lib/libbsp/arm/atsam/preinstall.am + Generating ./c/src/lib/libbsp/arm/beagle/preinstall.am + Generating ./c/src/lib/libbsp/arm/csb336/preinstall.am + Generating ./c/src/lib/libbsp/arm/csb337/preinstall.am + Generating ./c/src/lib/libbsp/arm/edb7312/preinstall.am + Generating ./c/src/lib/libbsp/arm/gdbarmsim/preinstall.am + ....... + Generating ./cpukit/score/cpu/mips/preinstall.am + Generating ./cpukit/score/cpu/moxie/preinstall.am + Generating ./cpukit/score/cpu/nios2/preinstall.am + Generating ./cpukit/score/cpu/no_cpu/preinstall.am + Generating ./cpukit/score/cpu/or1k/preinstall.am + Generating ./cpukit/score/cpu/powerpc/preinstall.am + Generating ./cpukit/score/cpu/sh/preinstall.am + Generating ./cpukit/score/cpu/sparc/preinstall.am + Generating ./cpukit/score/cpu/sparc64/preinstall.am + Generating ./cpukit/score/cpu/v850/preinstall.am + Generating ./cpukit/score/preinstall.am + Generating ./cpukit/telnetd/preinstall.am + Generating ./cpukit/wrapup/preinstall.am + Generating ./cpukit/zlib/preinstall.am + /c/opt/rtems/kernel/rtems + +Finally we run the RSB's parallel ``bootstrap`` command: + +.. code-block:: shell + + $ /c/opt/rtems/rsb/source-builder/sb-bootstrap + RTEMS Source Builder - RTEMS Bootstrap, 4.11 (76188ee494dd) + 1/139: autoreconf: configure.ac + 2/139: autoreconf: c/configure.ac + 3/139: autoreconf: c/src/configure.ac + 4/139: autoreconf: c/src/ada-tests/configure.ac + 5/139: autoreconf: c/src/lib/libbsp/arm/configure.ac + 6/139: autoreconf: c/src/lib/libbsp/arm/altera-cyclone-v/configure.ac + 7/139: autoreconf: c/src/lib/libbsp/arm/atsam/configure.ac + 8/139: autoreconf: c/src/lib/libbsp/arm/beagle/configure.ac + 9/139: autoreconf: c/src/lib/libbsp/arm/csb336/configure.ac + 10/139: autoreconf: c/src/lib/libbsp/arm/csb337/configure.ac + 11/139: autoreconf: c/src/lib/libbsp/arm/edb7312/configure.ac + ....... + 129/139: autoreconf: testsuites/samples/configure.ac + 130/139: autoreconf: testsuites/smptests/configure.ac + 131/139: autoreconf: testsuites/sptests/configure.ac + 132/139: autoreconf: testsuites/tmtests/configure.ac + 133/139: autoreconf: testsuites/tools/configure.ac + 134/139: autoreconf: testsuites/tools/generic/configure.ac + 135/139: autoreconf: tools/build/configure.ac + 136/139: autoreconf: tools/cpu/configure.ac + 137/139: autoreconf: tools/cpu/generic/configure.ac + 138/139: autoreconf: tools/cpu/nios2/configure.ac + 139/139: autoreconf: tools/cpu/sh/configure.ac + Bootstrap time: 0:20:38.759766 + /c/opt/rtems/kernel/rtems + $ + +We will build the RTEMS kernel for the ``i386`` target and the ``pc686`` +BSP. You can check the available BSPs by running the ``rtems-bsps`` command +found in the top directory of the RTEMS kernel source. We build the Board +Support Package (BSP) outside the kernel source tree: + +.. code-block:: shell + + /c/opt/rtems/kernel/rtems + $ cd .. + /c/opt/rtems/kernel + $ mkdir pc686 + /c/opt/rtems/kernel + $ cd pc686 + /c/opt/rtems/kernel/pc686 + $ + +Configure the RTEMS kernel to build ``pc686`` BSP for the ``i386`` target with +networking disabled, We will build the external libBSD stack later: + +.. code-block:: shell + + /c/opt/rtems/kernel/pc686 + $ /c/opt/rtems/kernel/rtems/configure --prefix=/c/opt/rtems/4.11 \ + --target=i386-rtems4.11 --disable-networking --enable-rtemsbsp=pc686 + checking for gmake... no + checking for make... make + checking for RTEMS Version... 4.11.99.0 + checking build system type... x86_64-pc-mingw64 + checking host system type... x86_64-pc-mingw64 + checking target system type... i386-pc-rtems4.11 + checking for a BSD-compatible install... /usr/bin/install -c + checking whether build environment is sane... yes + checking for a thread-safe mkdir -p... /usr/bin/mkdir -p + checking for gawk... gawk + checking whether make sets $(MAKE)... yes + checking whether to enable maintainer-specific portions of Makefiles... no + checking that generated files are newer than configure... done + configure: creating ./config.status + configure: configuring in ./tools/build + ....... + checking whether make sets $(MAKE)... yes + checking whether to enable maintainer-specific portions of Makefiles... no + checking that generated files are newer than configure... done + configure: creating ./config.status + config.status: creating Makefile + + target architecture: i386. + available BSPs: pc686. + 'make all' will build the following BSPs: pc686. + other BSPs can be built with 'make RTEMS_BSP="bsp1 bsp2 ..."' + + config.status: creating Makefile + /c/opt/rtems/kernel/pc686 + $ + +Build the kernel: + +.. code-block:: shell + + /c/opt/rtems/kernel/pc686 + $ make + Making all in tools/build + make[1]: Entering directory '/c/opt/rtems/kernel/pc686/tools/build' + make all-am + make[2]: Entering directory '/c/opt/rtems/kernel/pc686/tools/build' + gcc -DHAVE_CONFIG_H -I. -I/c/opt/rtems/kernel/rtems/tools/build -g -O2 -MT + cklength.o -MD -MP -MF .deps/cklength.Tpo -c -o cklength.o + /c/opt/rtems/kernel/rtems/tools/build/cklength.c + gcc -DHAVE_CONFIG_H -I. -I/c/opt/rtems/kernel/rtems/tools/build -g -O2 -MT + eolstrip.o -MD -MP -MF .deps/eolstrip.Tpo -c -o eolstrip.o + /c/opt/rtems/kernel/rtems/tools/build/eolstrip.c + .......... + i386-rtems4.11-objcopy -O binary nsecs.nxe nsecs.bin + ../../../../../pc686/build-tools/bin2boot -v nsecs.ralf 0x00097E00 + ../../../../../pc686/lib/start16.bin 0x00097C00 0 nsecs.bin 0x00100000 0 + header address 0x00097e00, its memory size 0xzx + first image address 0x00097c00, its memory size 0x00000200 + second image address 0x00100000, its memory size 0x0003d800 + rm -f nsecs.nxe + make[6]: Leaving directory '/c/opt/rtems/kernel/pc686/i386-rtems4.11/c/pc686/testsuites/samples/nsecs' + make[5]: Leaving directory '/c/opt/rtems/kernel/pc686/i386-rtems4.11/c/pc686/testsuites/samples' + make[4]: Leaving directory '/c/opt/rtems/kernel/pc686/i386-rtems4.11/c/pc686/testsuites/samples' + make[4]: Entering directory '/c/opt/rtems/kernel/pc686/i386-rtems4.11/c/pc686/testsuites' + make[4]: Nothing to be done for 'all-am'. + make[4]: Leaving directory '/c/opt/rtems/kernel/pc686/i386-rtems4.11/c/pc686/testsuites' + make[3]: Leaving directory '/c/opt/rtems/kernel/pc686/i386-rtems4.11/c/pc686/testsuites' + make[2]: Leaving directory '/c/opt/rtems/kernel/pc686/i386-rtems4.11/c/pc686' + make[1]: Leaving directory '/c/opt/rtems/kernel/pc686/i386-rtems4.11/c' + make[1]: Entering directory '/c/opt/rtems/kernel/pc686' + make[1]: Nothing to be done for 'all-am'. + make[1]: Leaving directory '/c/opt/rtems/kernel/pc686' + /c/opt/rtems/kernel/pc696 + $ + +Install the kernel to our prefix: + +.. code-block:: shell + + /c/opt/rtems/kernel/pc686 + $ make install + Making install in tools/build + make[1]: Entering directory '/c/opt/rtems/kernel/pc686/tools/build' + make[2]: Entering directory '/c/opt/rtems/kernel/pc686/tools/build' + /usr/bin/mkdir -p '/c/opt/rtems/4.11/bin' + /usr/bin/install -c cklength.exe eolstrip.exe packhex.exe unhex.exe + rtems-bin2c.exe '/c/opt/rtems/4.11/bin' + /usr/bin/mkdir -p '/c/opt/rtems/4.11/bin' + /usr/bin/install -c install-if-change '/c/opt/rtems/4.11/bin' + make[2]: Nothing to be done for 'install-data-am'. + make[2]: Leaving directory '/c/opt/rtems/kernel/pc686/tools/build' + make[1]: Leaving directory '/c/opt/rtems/kernel/pc686/tools/build' + Making install in tools/cpu + make[1]: Entering directory '/c/opt/rtems/kernel/pc686/tools/cpu' + Making install in generic + make[2]: Entering directory '/c/opt/rtems/kernel/pc686/tools/cpu/generic' + make[3]: Entering directory '/c/opt/rtems/kernel/pc686/tools/cpu/generic' + make[3]: Nothing to be done for 'install-exec-am'. + make[3]: Nothing to be done for 'install-data-am'. + make[3]: Leaving directory '/c/opt/rtems/kernel/pc686/tools/cpu/generic' + make[2]: Leaving directory '/c/opt/rtems/kernel/pc686/tools/cpu/generic' + make[2]: Entering directory '/c/opt/rtems/kernel/pc686/tools/cpu' + make[3]: Entering directory '/c/opt/rtems/kernel/pc686/tools/cpu' + make[3]: Nothing to be done for 'install-exec-am'. + make[3]: Nothing to be done for 'install-data-am'. + .......... + make[2]: Entering directory '/c/opt/rtems/kernel/pc686' + make[2]: Nothing to be done for 'install-exec-am'. + /usr/bin/mkdir -p '/c/opt/rtems/4.11/make' + /usr/bin/install -c -m 644 /c/opt/rtems/kernel/rtems/make/main.cfg + /c/opt/rtems/kernel/rtems/make/leaf.cfg '/c/opt/rtems/4.11/make' + /usr/bin/mkdir -p '/c/opt/rtems/4.11/share/rtems4.11/make/Templates' + /usr/bin/install -c -m 644 + /c/opt/rtems/kernel/rtems/make/Templates/Makefile.dir + /c/opt/rtems/kernel/rtems/make/Templates/Makefile.leaf + /c/opt/rtems/kernel/rtems/make/Templates/Makefile.lib + '/c/opt/rtems/4.11/share/rtems4.11/make/Templates' + /usr/bin/mkdir -p '/c/opt/rtems/4.11/make/custom' + /usr/bin/install -c -m 644 /c/opt/rtems/kernel/rtems/make/custom/default.cfg + '/c/opt/rtems/4.11/make/custom' + make[2]: Leaving directory '/c/opt/rtems/kernel/pc686' + make[1]: Leaving directory '/c/opt/rtems/kernel/pc686' + /c/opt/rtems/kernel/pc686 + $ -- cgit v1.2.3