1 | .. SPDX-License-Identifier: CC-BY-SA-4.0 |
---|
2 | |
---|
3 | .. Copyright (C) 2019 embedded brains GmbH |
---|
4 | .. Copyright (C) 2019 Sebastian Huber |
---|
5 | |
---|
6 | .. _QuickStartSources: |
---|
7 | |
---|
8 | Obtain the Sources |
---|
9 | ================== |
---|
10 | |
---|
11 | You chose an installation prefix previous section. We chose |
---|
12 | :file:`$HOME/quick-start/rtems/5` as the installation prefix. |
---|
13 | |
---|
14 | You need at least two source archives or Git repositories to work with RTEMS. |
---|
15 | You can download the source archives for a released RTEMS version or you can |
---|
16 | clone Git repositories to get all versions of RTEMS including the development |
---|
17 | head. |
---|
18 | |
---|
19 | We will clone the Git repositories into :file:`$HOME/quick-start/src`. |
---|
20 | |
---|
21 | .. code-block:: none |
---|
22 | |
---|
23 | mkdir -p $HOME/quick-start/src |
---|
24 | cd $HOME/quick-start/src |
---|
25 | git clone git://git.rtems.org/rtems-source-builder.git rsb |
---|
26 | git clone git://git.rtems.org/rtems.git |
---|
27 | |
---|
28 | The :file:`rsb` repository clone contains the |
---|
29 | :ref:`RTEMS Source Builder (RSB) <RSB>`. We clone it into |
---|
30 | :file:`rsb` to get shorter paths during the tool suite build. The |
---|
31 | :file:`rtems` repository clone contains the RTEMS sources. These two |
---|
32 | repositories are enough to get started. There are |
---|
33 | `more repositories <https://git.rtems.org>`_ available. |
---|
34 | |
---|
35 | Alternatively, you can download the source archives of a released RTEMS |
---|
36 | version. |
---|
37 | |
---|
38 | .. code-block:: none |
---|
39 | |
---|
40 | mkdir -p $HOME/quick-start/src |
---|
41 | cd $HOME/quick-start/src |
---|
42 | curl https://ftp.rtems.org/pub/rtems/releases/4.11/4.11.3/rtems-4.11.3.tar.xz | tar xJf - |
---|
43 | curl https://ftp.rtems.org/pub/rtems/releases/4.11/4.11.3/rtems-source-builder-4.11.3.tar.xz | tar xJf - |
---|
44 | |
---|
45 | This quick start chapter focuses on working with the Git repository clones |
---|
46 | since this gives you some flexibility. You can switch between branches to try |
---|
47 | out different RTEMS versions. You have access to the RTEMS source history. |
---|
48 | The RTEMS Project welcomes contributions. The Git repositories enable you to |
---|
49 | easily create patches and track local changes. If you prefer to work with |
---|
50 | archives of a released RTEMS version, then simply replace the version number 5 |
---|
51 | used throughout this chapter with the version number you selected, e.g. 4.11. |
---|