From 27bcdfbf571a9454f6deccaa70d1f39480c65057 Mon Sep 17 00:00:00 2001 From: Chris Johns Date: Tue, 22 Mar 2016 12:54:39 +1100 Subject: Add a basics section to Getting Started. Rearrange the content. --- user/start/releases.rst | 22 ++++++++++------------ 1 file changed, 10 insertions(+), 12 deletions(-) (limited to 'user/start/releases.rst') diff --git a/user/start/releases.rst b/user/start/releases.rst index ceb6d8f..a5bbe99 100644 --- a/user/start/releases.rst +++ b/user/start/releases.rst @@ -4,7 +4,7 @@ .. _released-version: Released Version ----------------- +================ .. index:: tarball .. index:: release @@ -12,12 +12,7 @@ RTEMS releases provide a stable version of the kernel for the supported architectures. RTEMS maintaines the current and previous releases. Support for older releases is provided using the RTEMS support channels. -.. sidebar:: *GDB and Python* - - RTEMS uses Python in GDB to aid debugging which means GDB needs to be built - with Python development libraries. Please check the RSB documentation and - install the packages specified for your host. Make sure a python development - package is included. +Please read :ref:`development-hosts` before continuing. The following procedure assumes you have installed and configured your host operating. It also assumes you have installed any dependent packages needed @@ -49,7 +44,7 @@ RTEMS FTP the RSB will fall back to the packages home site. The RTEMS kernel is built by default for releases. To not build the RTEMS kernel add the ``--without-rtems`` option to the RSB command line. - By default all the BSPs for an architecture are build. If you only wish to + By default all the BSPs for an architecture are built. If you only wish to have a specific BSP build you can specify the BSP list by providing to the RSB the option ``--with-rtemsbsp``. For example to build two BSPs for the SPARC architecture you can supply ``--with-rtemsbsp="erc32 sis"``. @@ -57,7 +52,7 @@ RTEMS FTP the RSB will fall back to the packages home site. This procedure will build a SPARC tool chain. RTEMS Tools Chain -~~~~~~~~~~~~~~~~~ +----------------- Set up a suitable workspace to build the release in. On Unix: @@ -93,14 +88,15 @@ Download the RTEMS Source Builder (RSB) from the RTEMS FTP server: 2016-03-21 10:50:11 (173 KB/s) - 'rtems-source-builder-4.11.0.tar.xz' saved [967056/967056] -Unpack the RSB release tar file. On Unix: +On Unix unpack the RSB release tar file using: .. code-block:: shell $ tar Jxf rtems-source-builder-4.11.0.tar.xz $ cd rtems-source-builder-4.11.0/rtems/ -When building on Windowss you need to shorten the path: +On Windows you need to shorten the path (See :ref:`windows-path-length`) after +you have unpacked the tar file: .. code-block:: shell @@ -110,7 +106,9 @@ When building on Windowss you need to shorten the path: Build a tool chain for the SPARC architecure. We are using the SPARC architecture in our example because GDB has a good simulator that lets us run -and test the samples RTEMS builds by default: +and test the samples RTEMS builds by default + +If building on Windows add ``--jobs=none`` to avoid GNU make issues on Windows. .. code-block:: shell -- cgit v1.2.3