blob: e5c127822172c9d30361881c58b7fc4834ea9245 [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======================== =====================
Slava Andrianovfa0259b2025-10-16 14:32:48 -050028Mbed TLS 3.6.5
Harrison Mutai95a7af12025-08-28 13:02:44 +000029Transfer List Library 0.0.1
Harrison Mutai04315992025-08-26 13:55:51 +000030Event Log Library 0.0.1
Soby Mathewc5f75b92024-11-26 04:39:38 +000031======================== =====================
32
Jimmy Brissonca6bd892020-04-02 15:19:08 -050033Toolchain
34---------
35
36Install the required packages to build TF-A Tests with the following command:
37
38::
39
Jim Ray7ba27bf2023-05-25 14:11:51 -070040 sudo apt-get install device-tree-compiler build-essential git python3
41
Harrison Mutai0199b6a2023-07-03 11:24:41 +010042Note that at least Python 3.8 is required.
Jimmy Brissonca6bd892020-04-02 15:19:08 -050043
Jayanth Dodderi Chidanand968c95f2023-04-18 10:46:21 +010044Download and install the GNU cross-toolchain from Arm. The TF-A Tests have
Jayanth Dodderi Chidanand7919d6d2025-10-02 15:06:51 +010045been tested with version 14.3.Rel1 (GCC 14.3):
Jimmy Brissonca6bd892020-04-02 15:19:08 -050046
47- `GCC cross-toolchain`_
48
49In addition, the following optional packages and tools may be needed:
50
Daniel Boulbycc8740b2022-05-20 10:21:55 +010051- For debugging, Arm `Development Studio (Arm-DS)`_.
Jimmy Brissonca6bd892020-04-02 15:19:08 -050052
Daniel Boulbycc8740b2022-05-20 10:21:55 +010053.. _GCC cross-toolchain: https://developer.arm.com/tools-and-software/open-source-software/developer-tools/gnu-toolchain/downloads
54.. _Development Studio (Arm-DS): https://developer.arm.com/Tools%20and%20Software/Arm%20Development%20Studio
Jimmy Brissonca6bd892020-04-02 15:19:08 -050055
56--------------
57
Jayanth Dodderi Chidanandb33efce2025-04-04 15:55:24 +010058*Copyright (c) 2019-2025, Arm Limited. All rights reserved.*