Changes between Version 29 and Version 30 of Developer/Tools/RSB


Ignore:
Timestamp:
Apr 4, 2020, 6:17:28 PM (22 months ago)
Author:
Gedare Bloom
Comment:

Point to the docs.

Legend:

Unmodified
Added
Removed
Modified
  • Developer/Tools/RSB

    v29 v30  
    11= RTEMS Source Builder =
    22
    3 [[TOC(Developer/Tools/RSB, depth=3)]]
    4 
    5 The RTEMS Source Builder or RSB builds RTEMS tool sets for a range of hosts from source. It is an easy to use tool complete with [https://docs.rtems.org/rsb documentation] that gives you a ready to use RTEMS tool set for your architecture. It is actively being maintained so you get a current tool set that works with RTEMS releases as well as RTEMS's development branches.
    6 
    7 The RTEMS Source Builder builds using the source code for the tools by downloading it plus any patches. The source is left on disk after the build and you can archive it along with all the other source in your project. Any time in the future you can rebuild the exact tools and if you have a long life project and your build host need replacing you can rebuild the tools from source.
    8 
    9 The RSB is part of the [wiki:Developer/Tools RTEMS Tool Project].
    10 
    11 Source Builder was created and is maintained by Chris Johns. Feel free to ask about it on the RTEMS User and Development mailing lists.
    12 
    13 The RSB repository is https://git.rtems.org/rtems-source-builder.
    14 
    15 == Documentation ==
    16 
    17 The RSB documentation and the Quick Start to get going can be found at https://docs.rtems.org/branches/master/rsb/index.html.
    18 
    19 == Building a Tools set with RTEMS ==
    20 
    21 To build a tool set checkout the RSB repo and then get the RSB to build the tools and RTEMS.
    22 
    23 {{{
    24 $ cd
    25 $ mkdir -p development/rtems/rsb
    26 $ cd development/rtems/rsb
    27 $ git clone git://git.rtems.org/rtems-source-builder.git
    28 $ cd rtems-source-builder
    29 $ cd rtems
    30 $ ../source-builder/sb-set-builder --prefix=$HOME/development/rtems/5 5/rtems-sparc
    31 }}}
    32 
    33 == Supported Hosts ==
    34 
    35 === Linux distributions ===
    36 * Ubuntu (and its official derivatives)
    37 * Debian (if using Debian 8, see [#CentOS7andDebian8Jessie these notes])
    38 * Arch Linux (a Python 2 virtual environment may need to be set up, see [#ArchLinuxsettingupaPython2virtualenvironment this section])
    39 * CentOS (if using CentOS 7, see [#CentOS7andDebian8Jessie these notes])
    40 * Fedora
    41 * Linux Mint
    42 * openSUSE
    43 * Raspbian
    44 
    45 === BSD (and similar) ===
    46 * FreeBSD
    47 * NetBSD
    48 * Mac OS X
    49 
    50 === Other ===
    51 * Windows (using MSYS2)
    52 
    53 == Host operating system specific notes ==
    54 
    55 === CentOS 7 and Debian 8 (Jessie) ===
    56 
    57 The note below is valid if you plan to generate the tools for RTEMS 4.10 on CentOS 7 or Debian 8 (Jessie) using RTEMS Source Builder 0.5.0.
    58 
    59 The current version of CentOS 7 uses texinfo version 5.1 as its default textinfo package. Debian 8 uses version 5.2. The makeinfo >= 5.0 are currently not supported for 4.10/rtems-*, for instance. Use the following workaround if your compilation fails in consequence of incompatible makeinfo check on CentOS 7 and Debian 8:
    60 {{{
    61 $ cd ~/Downloads
    62 $ wget http://ftp.gnu.org/gnu/texinfo/texinfo-4.13.tar.gz
    63 $ tar -xzf texinfo-4.13.tar.gz
    64 $ cd texinfo-4.13
    65 $ ./configure --prefix=$HOME/development/texinfo-4.13
    66 $ make
    67 $ make install
    68 }}}
    69 If you succeeded to build texinfo 4.13:
    70 {{{
    71 $ export PATH=$HOME/development/texinfo-4.13/bin:$PATH
    72 }}}
    73 You are now ready to re-run RSB with 4.10/rtems-[your-favorite-arch].
    74 
    75 === Arch Linux – setting up a Python 2 virtual environment ===
    76 In modern versions of Arch Linux, `python` is now a shortcut to `python3` from the `python` package. RSB will not function in Python 3, but you can set up a virtual environment for RSP with Python 2.
    77 
    78 At a root terminal, install `python2-virtualenv` with `pacman`.
    79 {{{
    80 # pacman -S python2-virtualenv
    81 }}}
    82 
    83 Leave root and return to the user that you will be using to build RTEMS.
    84 
    85 Change to a directory which you have permissions for where you wish the virtual environment to be set up, and create it by using the `virtualenv2` command, like so:
    86 {{{
    87 $ cd development/rtems/rsb
    88 $ virtualenv2 venv
    89 }}}
    90 
    91 where ''venv'' is the folder that will be created with the environment set up inside.
    92 
    93 Activate it, and you should see the name of the virtual environment added to the prompt (PS1 variable):
    94 {{{
    95 $ source venv/bin/activate
    96 (venv)$
    97 }}}
    98 
    99 You can now continue to follow the build instructions.
     3Documentation for the RSB can be found in the user manual's section on [https://docs.rtems.org/branches/master/user/rsb/index.html Source Builder].