Changes between Version 20 and Version 21 of TBR/UserManual/Quick_Start


Ignore:
Timestamp:
Apr 5, 2015, 5:19:28 AM (5 years ago)
Author:
Chris Johns
Comment:

Quick update.

Legend:

Unmodified
Added
Removed
Modified
  • TBR/UserManual/Quick_Start

    v20 v21  
    88 * You may also like the GSoC/GettingStarted tutorial.
    99
    10  *  Installing the Tools. You can get the tools from [wiki:TBR/UserManual/RTEMS_Source_Builder  RTEMS Source Builder (RSB)]. Select the ''sparc'' CPU toolset since that is the sample BSP we will be building.  Don't worry, you can easily remove the tools later if you decide you don't want a simulator environment to play with.
     10 *  Installing the Tools. You can get the tools from [wiki:Developer/Tools/RSB  RTEMS Source Builder (RSB)]. Select the ''sparc'' CPU toolset since that is the sample BSP we will be building.  Don't worry, you can easily remove the tools later if you decide you don't want a simulator environment to play with.
    1111
    1212 *  Download RTEMS.  Use either a release image or checkout from [wiki:Developer/Git Git].  Either way, make sure you get the right toolset for your RTEMS version. The RSB will help you here.
     
    1616 *  RTEMS is designed to be compiled outside the source tree.  Assuming you used the 4.11 head, you would need to do something like the following to configure and compile RTEMS.  Be sure to watch versions and install points:
    1717
     18Note, the following is for RTEMS 4.11.
     19
    1820{{{
    1921cd rtems
    20 export PATH=/opt/rtems-4.11/bin:$PATH
     22export PATH=/opt/rtems/4.11/bin:$PATH
    2123./bootstrap
    2224cd ..
     
    2628  --enable-tests=samples --disable-posix
    2729make
    28 sudo PATH=/opt/rtems-4.11/bin:${PATH} make install
     30sudo PATH=/opt/rtems/4.11/bin:${PATH} make install
    2931}}}
    3032
    31 WARNING: It is absolutely critical that the target name provided to the RTEMS configure command be that same as that used to build binutils, gcc, newlib, and gdb.  The binaries provided by the RTEMS Project will use a target name of the form CPU-rtemsVERSION where CPU is sparc in the above example and VERSION is 4.11.
     33If you experience a "''C compiler cannot create executables''" error, try fixing your compiler by getting libc-dev:
     34{{{apt-get install libc-dev}}}
     35This has happened on Debian and Debian-based (like Ubuntu) systems.
    3236
    33 ( Getting a "''C compiler cannot create executables''" error ?{{ref|abc}} )
     37WARNING: It is absolutely critical that the target name provided to the RTEMS configure command be that same as that used to build binutils, gcc, newlib, and gdb.  The binaries provided by the RTEMS Project will use a target name of the form `CPU-rtemsVERSION` where CPU is `sparc` in the above example and VERSION is 4.11.
    3438
    3539When this completes, you should have a few sample test executables in the build tree.   This shows how to run the ticker.exe example in gdb:
     
    4347There is NO WARRANTY, to the extent permitted by law.  Type "show copying"
    4448and "show warranty" for details.
    45 This GDB was configured as "--host=i686-pc-linux-gnu --target=sparc-rtems4.9"...
     49This GDB was configured as "--host=i686-pc-linux-gnu --target=sparc-rtems4.11"...
    4650GDB can't read core files on this machine.
    4751(gdb) tar sim
     
    7882----
    7983
    80 {{note|abc}}If you experience a "''C compiler cannot create executables''" error, try fixing your compiler by getting libc-dev:
    81 {{{apt-get install libc-dev}}}
    82 This has happened on Debian and Debian-based (like Ubuntu) systems.
    8384= Example Application Compiling =
    8485
    8586
    8687There are example applications in [wiki:Developer/Git RTEMS GIT Repository]. [wiki:TBR/UserManual/Example_Application_Compiling Example Application Compiling] provides the steps to compile them.
     88
    8789= Example Library Compiling =
    8890
     
    9092
    9193http://www.rtems.org/wiki/index.php/RTEMS_Add-On_Packages
     94
    9295==  Where to get RTEMS Application Makefile documentation  ==
    9396