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. |
---|