Changes between Version 22 and Version 23 of Developer/Tools/RSB


Ignore:
Timestamp:
Mar 15, 2015, 10:17:58 PM (4 years ago)
Author:
Chris Johns
Comment:

Clean up the page.

Legend:

Unmodified
Added
Removed
Modified
  • Developer/Tools/RSB

    v22 v23  
    11= RTEMS Source Builder =
    22
     3[[TOC(Developer/Tools/RSB, depth=2)]]
    34
     5The 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.
    46
    5 [[TOC(TBR/UserManual/RTEMS_Source_Builder, depth=2)]]
     7The 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.
    68
     9The RSB is part of the [wiki:Developer/Tools RTEMS Tool Project].
    710
    8 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 documentation that gives you an RTEMS tool set for your architecture ready to use. It is actively being maintained so you get a current tool set that works with RTEMS releases as well as RTEMS's development branches.
     11Source Builder was created and is maintained by Chris Johns. Feel free to ask about it on the RTEMS User and Development mailing lists.
    912
    10 The RTEMS Source Builder builds using the source code for the tools by downloading it plus any patches. The source is left there for you so you can rebuild the tools, change the source and remake the tools. You are not left with a binary blob and not way to rebuild it if you need too.
     13The RSB repository is https://git.rtems.org/rtems-source-builder.
    1114
    12  *  Head over the RSB documentation and the Quick Start to get going [https://docs.rtems.org/rsb/].
     15== Documentation ==
    1316
    14  *  Source Builder was created and is maintained by Chris Johns. Feel free to ask about it on the RTEMS User and Development mailing lists.
    15 = Building a Tools set with RTEMS =
     17The RSB documentation and the Quick Start to get going can be found at https://docs.rtems.org/rsb/.
    1618
     19== Building a Tools set with RTEMS ==
    1720
    1821To build a tool set checkout the RSB repo and then get the RSB to build the tools and RTEMS.
    1922
    20   $ cd
     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/4.11 4.11/rtems-sparc
     31}}}
    2132
    22   $ mkdir -p development/rtems/src
     33== Supported Hosts ==
    2334
    24   $ cd development/rtems/src
     35* Archlinux
     36* Centos
     37* Fedora
     38* FreeBSD
     39* NetBSD
     40* MacOS
     41* Linux Mint
     42* openSUSE
     43* Raspbian
     44* Ubuntu
     45* Windows (MSYS2)
     46* Xubuntu
    2547
    26   $ git clone git://git.rtems.org/rtems-source-builder.git
     48== CentOS 7 - Building Notes ==
    2749
    28   $ cd rtems-source-builder
    29 
    30   $ cd rtems
    31 
    32   $ ../source-builder/sb-set-builder --log=l-sparc.txt \
    33           --prefix=$HOME/development/rtems/4.11 --with-rtems 4.11/rtems-sparc
    34 = CentOS 7 - Building Notes =
    35 
     50''[Is this entry still valid]''
    3651
    3752The current version of CentOS 7 uses texinfo version 5.1 as its default textinfo package. 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:
     53{{{
     54$ cd ~/Downloads
     55$ wget http://ftp.gnu.org/gnu/texinfo/texinfo-4.13.tar.gz
     56$ tar -xzf texinfo-4.13.tar.gz
     57$ cd texinfo-4.13
     58$ ./configure --prefix=$HOME/development/textinfo-4.13
     59$ make
     60$ make install
     61}}}
     62If you succeeded to build textinfo 4.13:
     63{{{
     64$ export PATH=$HOME/development/textinfo-4.13/bin:$PATH
     65}}}
     66You are now ready to re-run RSB with 4.10/rtems-[your-favorite-arch].
    3867
    39   $ cd ~/Downloads
    40 
    41   $ wget http://ftp.gnu.org/gnu/texinfo/texinfo-4.13.tar.gz
    42 
    43   $ tar -xzf texinfo-4.13.tar.gz
    44 
    45   $ cd texinfo-4.13
    46 
    47   $ ./configure --prefix=$HOME/development/textinfo-4.13
    48 
    49   $ make
    50 
    51   $ make install
    52 
    53 If you succeeded to build textinfo 4.13:
    54   $ export PATH=$HOME/development/textinfo-4.13/bin:$PATH
    55 
    56 You are now ready to re-run RSB with 4.10/rtems-[your-favorite-arch].
    57 = Feedback from Students about using RSB for the [wiki:GSoC/GettingStarted GSoC Getting Started] =
    58 
    59 
    60 {| border="1" style="margin: 1em auto 1em auto;text-align: center;"
    61 |+
    62 |-
    63 |'''Student''' || '''Host OS''' || '''RTEMS Target''' ||  '''Feedback'''
    64 |-
    65 | Adit C. || Ubuntu 13.04 || sparc-rtems4.11 || Instructions were fairly straight forward, however I experience some trouble initially due to missing packages. I had to install the latest versions of bison, cvs, g++, flex, and texinfo. I may have had to do so since I am running Ubuntu 13.04 on a virtual machine in OSX Mavericks. I also had to python2.7-dev installed. Nonetheless, once these packages were installed, I was able to get things done relatively easily.
    66 (chrisj: I have updated the doco to go to the host setup before anything else)
    67 |-
    68 | Pavel Z. || Ubuntu 13.04 || sparc-rtems4.11 || Overall the wiki was clear on what was required. The configuration file did not accept --enable-tests=samples, so I had to consult documentation to build the hello world application found in the git repository myself. Also RTEMS was very specific with the automake version it wanted: I had to compile 1.12.2 from source
    69 (chrisj: The RSB should build a suitable automake)
    70 |-
    71 | Bryan D. || Arch Linux || sparc-rtems4.11 || While compiling the tools and RTEMS I only encountered two problems. The first one was with binutils; for some reason, it refused to compile outside the source directory, so I compiled it in the source directory. The second problem was with building RTEMS itself. The error was easy to fix though and just required removing the --disable-posix flag when calling ./configure.
    72 (chrisj: I have no idea about building in the source dir)
    73 |-
    74 | Chirayu D. || Arch Linux || sparc-rtems4.11 || I had to install an older version of texinfo, but other than that it worked fine. I did not use the --disable-posix flag when calling ./configure.
    75 |-
    76 | Kevin F. || Linux Mint 13 LTS || sparc-rtems4.11 || I made lots of errors myself, but overall the instructions were fairly clear. Perhaps the RSB Quick Start should explain moving executables a bit more (like where to find them) and the RTEMS Quick Start should have remarked that you should put export the PATH to the tools bin you compiled. I needed python2.7-dev installed.
    77 (chrisj: Add something about installing executables. The export path is already present in the documentation. I have tried to make it stand out a little more)
    78 |-
    79 | An Ha || Arch Linux || sparc-rtems4.11 || The directions were easy to follow, however, when running the source-builder, sb-check and sb-set-builder, I had to change the first lines from /usr/bin/env python, to /usr/bin/env python2, otherwise it would run the code in python 3, not 2. I also had to install texinfo-legacy from AUR instead of texinfo to fix the problem when building binutils (as stated in the documentation). I also did not have to use the --disable-posix flag when calling ./configure.
    80 (chrisj: Maybe the RSB need to work on both versions of Python. I need the commands to install packages as I have no idea)
    81 |-
    82 | Zsolt Sz. || Xubuntu || sparc-rtems4.11 || I was having some troubles at the beginning, but now I hope that everything will work out fine.
    83 |-
    84 | C. Tan || Ubuntu 13.10 64-bit|| sparc-rtems4.11 || I had some trouble getting the RTEMS compiler to be compiled from source code, mainly the binutils and gcc, even though I had followed the Quick Start closely. These required some Googling, and I eventually found out I had to downgrade texinfo ( alternatively I believed I could have installed the patch: http://www.rtems.com/pipermail/rtems-users/2013-November/012144.html ) and install python-dev respectively. Other than that, the Quick Start was very concise and clear.
    85 |-
    86 | Evan M. || Ubuntu || sparc-rtems4.11 || I found the directions straightforward, although I do admit I had some trouble from time to time. It also seemed like several pages contradicted each other, but that might have been on my side due to my lack of experience.
    87 (chrisj: I need more detail to understand the contradictions)
    88 |-
    89 | Kkvazar Q. || Fedora 20 || sparc-rtems4.11 || I wasn't able to finish the task, because I got lost in the documentation, the pages weren't well related and were contradicting. Some useful pages weren't easy to find such as the git README.
    90 I expected sb-check to tell me about missing devel libs, but it didn't. 'bootstrap' was hard to find and it failed on missing files. Most of the questions I had were asked online, but weren't answered.
    91 (chrisj: The documentation states the RSB is not package manager)
    92 |}