blob: 81c55a5da09419c721792524067736af5bd6df43 [file] [log] [blame]
Paul Beesleyd2fcc4e2019-05-29 13:59:40 +01001Prerequisites
2=============
3
4This document describes the software requirements for building |TF-A| for
5AArch32 and AArch64 target platforms.
6
7It may possible to build |TF-A| with combinations of software packages that are
8different from those listed below, however only the software described in this
9document can be officially supported.
Sandrine Bailleuxb386f0a2022-07-11 10:53:42 +020010
Paul Beesleyd2fcc4e2019-05-29 13:59:40 +010011Build Host
12----------
13
14|TF-A| can be built using either a Linux or a Windows machine as the build host.
15
16A relatively recent Linux distribution is recommended for building |TF-A|. We
17have performed tests using Ubuntu 16.04 LTS (64-bit) but other distributions
18should also work fine as a base, provided that the necessary tools and libraries
19can be installed.
20
21.. _prerequisites_toolchain:
22
23Toolchain
24---------
25
26|TF-A| can be built with any of the following *cross-compiler* toolchains that
27target the Armv7-A or Armv8-A architectures:
28
Daniel Boulby901c53c2022-04-04 16:38:55 +010029- GCC >= 11.2-2022.02 (from the `Arm Developer website`_)
Harrison Mutai38a293a2022-02-23 11:37:12 +000030- Clang >= 14.0.0
31- Arm Compiler >= 6.18
Paul Beesleyd2fcc4e2019-05-29 13:59:40 +010032
33In addition, a native compiler is required to build the supporting tools.
34
35.. note::
36 The software has also been built on Windows 7 Enterprise SP1, using CMD.EXE,
37 Cygwin, and Msys (MinGW) shells, using version 5.3.1 of the GNU toolchain.
38
39.. note::
40 For instructions on how to select the cross compiler refer to
41 :ref:`Performing an Initial Build`.
42
43.. _prerequisites_software_and_libraries:
44
45Software and Libraries
46----------------------
47
48The following tools are required to obtain and build |TF-A|:
49
50- An appropriate toolchain (see :ref:`prerequisites_toolchain`)
51- GNU Make
52- Git
53
54The following libraries must be available to build one or more components or
55supporting tools:
56
Juan Pablo Conde7275a5a2022-03-02 18:10:08 -050057- OpenSSL >= 3.0
Paul Beesleyd2fcc4e2019-05-29 13:59:40 +010058
59 Required to build the cert_create tool.
60
Juan Pablo Conde52865522022-06-28 16:56:32 -040061 .. note::
62
63 OpenSSL 3.0 has to be built from source code, as it's not available in
64 the default package repositories in recent Ubuntu versions. Please refer
65 to the OpenSSL project documentation for more information.
66
Sandrine Bailleux878a9982022-04-22 15:47:31 +020067The following libraries are required for Trusted Board Boot and Measured Boot
68support:
Paul Beesleyd2fcc4e2019-05-29 13:59:40 +010069
Sandrine Bailleux878a9982022-04-22 15:47:31 +020070- mbed TLS == 2.28.0 (tag: ``mbedtls-2.28.0``)
Paul Beesleyd2fcc4e2019-05-29 13:59:40 +010071
72These tools are optional:
73
74- Device Tree Compiler (DTC) >= 1.4.6
75
76 Needed if you want to rebuild the provided Flattened Device Tree (FDT)
77 source files (``.dts`` files). DTC is available for Linux through the package
78 repositories of most distributions.
79
Daniel Boulbydf83a832022-05-03 16:46:16 +010080- Arm `Development Studio (Arm-DS)`_
Paul Beesleyd2fcc4e2019-05-29 13:59:40 +010081
82 The standard software package used for debugging software on Arm development
83 platforms and |FVP| models.
84
Chris Kay32b292d2021-11-02 10:19:37 +000085- Node.js >= 16
Chris Kay46e17f92020-12-09 12:56:27 +000086
87 Highly recommended, and necessary in order to install and use the packaged
88 Git hooks and helper tools. Without these tools you will need to rely on the
89 CI for feedback on commit message conformance.
90
Paul Beesleyd2fcc4e2019-05-29 13:59:40 +010091Package Installation (Linux)
92^^^^^^^^^^^^^^^^^^^^^^^^^^^^
93
94If you are using the recommended Ubuntu distribution then you can install the
95required packages with the following command:
96
97.. code:: shell
98
Juan Pablo Conde52865522022-06-28 16:56:32 -040099 sudo apt install build-essential git
Paul Beesleyd2fcc4e2019-05-29 13:59:40 +0100100
101The optional packages can be installed using:
102
103.. code:: shell
104
105 sudo apt install device-tree-compiler
106
Chris Kay46e17f92020-12-09 12:56:27 +0000107Additionally, to install an up-to-date version of Node.js, you can use the `Node
Chris Kay32b292d2021-11-02 10:19:37 +0000108Version Manager`_ to install a version of your choosing (we recommend 16, but
Chris Kay46e17f92020-12-09 12:56:27 +0000109later LTS versions might offer a more stable experience):
110
111.. code:: shell
112
Chris Kay32b292d2021-11-02 10:19:37 +0000113 curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | "$SHELL"
114 exec "$SHELL" -ic "nvm install 16; exec $SHELL"
Chris Kay46e17f92020-12-09 12:56:27 +0000115
116.. _Node Version Manager: https://github.com/nvm-sh/nvm#install--update-script
117
Paul Beesleyd2fcc4e2019-05-29 13:59:40 +0100118Supporting Files
119----------------
120
121TF-A has been tested with pre-built binaries and file systems from `Linaro
Zelalemc005fdf2021-06-01 17:05:16 -0500122Release 20.01`_. Alternatively, you can build the binaries from source using
Paul Beesleyd2fcc4e2019-05-29 13:59:40 +0100123instructions in :ref:`Performing an Initial Build`.
124
125.. _prerequisites_get_source:
126
127Getting the TF-A Source
128-----------------------
129
130Source code for |TF-A| is maintained in a Git repository hosted on
131TrustedFirmware.org. To clone this repository from the server, run the following
132in your shell:
133
134.. code:: shell
135
Chris Kay46e17f92020-12-09 12:56:27 +0000136 git clone "https://review.trustedfirmware.org/TF-A/trusted-firmware-a"
Paul Beesleyd2fcc4e2019-05-29 13:59:40 +0100137
Chris Kay46e17f92020-12-09 12:56:27 +0000138Additional Steps for Contributors
139^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Paul Beesleyd2fcc4e2019-05-29 13:59:40 +0100140
Chris Kay46e17f92020-12-09 12:56:27 +0000141If you are planning on contributing back to TF-A, there are some things you'll
142want to know.
Paul Beesleyd2fcc4e2019-05-29 13:59:40 +0100143
Chris Kay46e17f92020-12-09 12:56:27 +0000144TF-A is hosted by a `Gerrit Code Review`_ server. Gerrit requires that all
145commits include a ``Change-Id`` footer, and this footer is typically
146automatically generated by a Git hook installed by you, the developer.
147
148If you have Node.js installed already, you can automatically install this hook,
149along with any additional hooks and Javascript-based tooling that we use, by
150running from within your newly-cloned repository:
Paul Beesleyd2fcc4e2019-05-29 13:59:40 +0100151
152.. code:: shell
153
Chris Kay2ff006b2021-05-17 11:18:56 +0100154 npm install --no-save
Chris Kay46e17f92020-12-09 12:56:27 +0000155
156If you have opted **not** to install Node.js, you can install the Gerrit hook
157manually by running:
158
159.. code:: shell
160
161 curl -Lo $(git rev-parse --git-dir)/hooks/commit-msg https://review.trustedfirmware.org/tools/hooks/commit-msg
162 chmod +x $(git rev-parse --git-dir)/hooks/commit-msg
163
164You can read more about Git hooks in the *githooks* page of the Git
165documentation, available `here <https://git-scm.com/docs/githooks>`_.
Paul Beesleyd2fcc4e2019-05-29 13:59:40 +0100166
167--------------
168
Harrison Mutai38a293a2022-02-23 11:37:12 +0000169*Copyright (c) 2021-2022, Arm Limited. All rights reserved.*
Paul Beesleyd2fcc4e2019-05-29 13:59:40 +0100170
Sandrine Bailleuxe356a182022-04-15 11:17:40 +0200171.. _Arm Developer website: https://developer.arm.com/tools-and-software/open-source-software/developer-tools/gnu-toolchain/downloads
Chris Kay46e17f92020-12-09 12:56:27 +0000172.. _Gerrit Code Review: https://www.gerritcodereview.com/
Paul Beesleyd2fcc4e2019-05-29 13:59:40 +0100173.. _Linaro Release Notes: https://community.arm.com/dev-platforms/w/docs/226/old-release-notes
174.. _Linaro instructions: https://community.arm.com/dev-platforms/w/docs/304/arm-reference-platforms-deliverables
Daniel Boulbydf83a832022-05-03 16:46:16 +0100175.. _Development Studio (Arm-DS): https://developer.arm.com/Tools%20and%20Software/Arm%20Development%20Studio
Zelalemc005fdf2021-06-01 17:05:16 -0500176.. _Linaro Release 20.01: http://releases.linaro.org/members/arm/platforms/20.01