[86518bd] | 1 | .. comment SPDX-License-Identifier: CC-BY-SA-4.0 |
---|
| 2 | |
---|
| 3 | .. comment: Copyright (c) 2016 Chris Johns <chrisj@rtems.org> |
---|
| 4 | .. comment: All rights reserved. |
---|
| 5 | |
---|
| 6 | Quick Start Guide |
---|
| 7 | ================= |
---|
| 8 | |
---|
| 9 | .. index:: Quick Start |
---|
| 10 | |
---|
| 11 | The following is a quick start guide that provides you with the basic commands |
---|
| 12 | you need to build the RTEMS Tools and Kernel. |
---|
| 13 | |
---|
| 14 | You need to have your development host set up and ready, the |
---|
| 15 | :ref:`development-host` covers what you need. |
---|
| 16 | |
---|
| 17 | This procedure does a development (unstable) build from Git for a POSIX |
---|
| 18 | host. You can refer to the specific section that cover the specific part of the |
---|
| 19 | process in detail if you have an issue. The output from the commands has been |
---|
| 20 | removed and replaced with ``...``. |
---|
| 21 | |
---|
| 22 | Create a workspace, download the RTEMS Source Builder (RSB) and build a tool |
---|
| 23 | chain (See :ref:`rtems-tools-chain`): |
---|
| 24 | |
---|
| 25 | .. code-block:: shell |
---|
| 26 | |
---|
| 27 | $ cd |
---|
| 28 | $ mkdir -p development/rtems |
---|
| 29 | $ cd development/rtems |
---|
| 30 | $ git clone git://git.rtems.org/rtems-source-builder.git rsb |
---|
| 31 | ... |
---|
| 32 | $ cd rsb |
---|
| 33 | $ ./source-builder/sb-check |
---|
| 34 | ... |
---|
| 35 | $ cd rtems |
---|
| 36 | $ ../source-builder/sb-set-builder \ |
---|
| 37 | --prefix=/usr/home/chris/development/rtems/4.12 4.12/rtems-sparc |
---|
| 38 | ... |
---|
| 39 | |
---|
| 40 | Build the RTEMS Kernel (See :ref:`rtems-kernel`) by cloning the repository, |
---|
| 41 | running the ``bootstrap`` procecure, building and finally installing the |
---|
| 42 | kernel: |
---|
| 43 | |
---|
| 44 | .. code-block:: shell |
---|
| 45 | |
---|
| 46 | $ export PATH=$HOME/development/rtems/4.12/bin:$PATH |
---|
| 47 | $ cd |
---|
| 48 | $ cd development/rtems |
---|
| 49 | $ mkdir kernel |
---|
| 50 | $ cd kernel |
---|
| 51 | $ git clone git://git.rtems.org/rtems.git rtems |
---|
| 52 | ... |
---|
| 53 | $ cd rtems |
---|
| 54 | $ ./bootstrap -c && ./bootstrap -p && \ |
---|
| 55 | $HOME/development/rtems/rsb/source-builder/sb-bootstrap |
---|
| 56 | ... |
---|
| 57 | $ cd .. |
---|
| 58 | $ mkdir erc32 |
---|
| 59 | $ cd erc32 |
---|
| 60 | $ $HOME/development/rtems/kernel/rtems/configure --prefix=$HOME/development/rtems/4.12 \ |
---|
| 61 | --target=sparc-rtems4.12 --enable-rtemsbsp=erc32 --enable-posix \ |
---|
| 62 | --disable-networking |
---|
| 63 | ... |
---|
| 64 | $ make -j 8 |
---|
| 65 | ... |
---|
| 66 | $ make install |
---|
| 67 | |
---|
| 68 | You can now build a 3rd party library like LibBSD or an application. |
---|