source: rtems-docs/user/start/quick.rst @ 86518bd

4.115
Last change on this file since 86518bd was 86518bd, checked in by Chris Johns <chrisj@…>, on 07/04/16 at 02:30:09

Reorganisse the User Manual to make it easier to navigate.

  • Property mode set to 100644
File size: 2.0 KB
Line 
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
6Quick Start Guide
7=================
8
9.. index:: Quick Start
10
11The following is a quick start guide that provides you with the basic commands
12you need to build the RTEMS Tools and Kernel.
13
14You need to have your development host set up and ready, the
15:ref:`development-host` covers what you need.
16
17This procedure does a development (unstable) build from Git for a POSIX
18host. You can refer to the specific section that cover the specific part of the
19process in detail if you have an issue. The output from the commands has been
20removed and replaced with ``...``.
21
22Create a workspace, download the RTEMS Source Builder (RSB) and build a tool
23chain (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
40Build the RTEMS Kernel (See :ref:`rtems-kernel`) by cloning the repository,
41running the ``bootstrap`` procecure, building and finally installing the
42kernel:
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
68You can now build a 3rd party library like LibBSD or an application.
Note: See TracBrowser for help on using the repository browser.