blob: 14e44581c10445479f0ddb919808eb0c0ce1649a [file] [log] [blame]
Jimmy Brissonca6bd892020-04-02 15:19:08 -05001Prerequisites & Requirements
2============================
3
4This document describes the software and hardware requiremnts for building TF-A
5Tests for AArch32 and AArch64 target platforms.
6
7It may be possible to build TF-A Tests with combinations of software and
8hardware that are different from those listed below. The software and hardware
9described in this document are officially supported.
10
11Build Host
12----------
13
14TF-A Tests may be built using a Linux build host machine with a recent Linux
Govindraj Raja5eceaa32023-05-12 15:03:02 -050015distribution. We have performed tests using Ubuntu 22.04 LTS (64-bit), but other
Jimmy Brissonca6bd892020-04-02 15:19:08 -050016distributions should also work fine, provided that the tools and libraries
17can be installed.
18
Soby Mathewc5f75b92024-11-26 04:39:38 +000019Dependencies
20------------
21
22This section lists the dependencies for TF-A-Tests which are added as
23as a git submodule.
24
25======================== =====================
26 Name Version
27======================== =====================
28Mbed TLS 3.6.2
29======================== =====================
30
Jimmy Brissonca6bd892020-04-02 15:19:08 -050031Toolchain
32---------
33
34Install the required packages to build TF-A Tests with the following command:
35
36::
37
Jim Ray7ba27bf2023-05-25 14:11:51 -070038 sudo apt-get install device-tree-compiler build-essential git python3
39
Harrison Mutai0199b6a2023-07-03 11:24:41 +010040Note that at least Python 3.8 is required.
Jimmy Brissonca6bd892020-04-02 15:19:08 -050041
Jayanth Dodderi Chidanand968c95f2023-04-18 10:46:21 +010042Download and install the GNU cross-toolchain from Arm. The TF-A Tests have
Jayanth Dodderi Chidanandb2fcf902024-09-30 18:15:55 +010043been tested with version 13.3.Rel1 (gcc 13.3):
Jimmy Brissonca6bd892020-04-02 15:19:08 -050044
45- `GCC cross-toolchain`_
46
47In addition, the following optional packages and tools may be needed:
48
Daniel Boulbycc8740b2022-05-20 10:21:55 +010049- For debugging, Arm `Development Studio (Arm-DS)`_.
Jimmy Brissonca6bd892020-04-02 15:19:08 -050050
Daniel Boulbycc8740b2022-05-20 10:21:55 +010051.. _GCC cross-toolchain: https://developer.arm.com/tools-and-software/open-source-software/developer-tools/gnu-toolchain/downloads
52.. _Development Studio (Arm-DS): https://developer.arm.com/Tools%20and%20Software/Arm%20Development%20Studio
Jimmy Brissonca6bd892020-04-02 15:19:08 -050053
54--------------
55
Jayanth Dodderi Chidanande9943642024-04-05 12:59:07 +010056*Copyright (c) 2019-2024, Arm Limited. All rights reserved.*