R-Car/Boards/ATF-Gen3

Introduction
This is the Wiki for the ATF on Renesas R-Car Gen3 SoCs and boards. Refer to the R-Car page for information about Renesas' R-Car SoC family.

Supported boards
As of ATF git commit 5ba32a7660051464ed1d56129adf2606db54b5e3, the following boards are supported:

! WARNING: R-Car R8A7795 H3 ES1.x is NOT supported!

Building ATF manually
Building ATF can be done manually by using the ATF sources.

Prerequisites

 * ARM cross-compiler is mandatory to build ATF.
 * mbedtls is mandatory to build ATF.

ARM cross-compiler
Debian and Ubuntu includes an ARM cross-compiler in its standard package feed. You can install it as follows:

apt-get install gcc-aarch64-linux-gnu

Other distributions likely also provide ARM cross-compilers. Consult distro-specific documentation for details.

Obtain ATF sources
The preferred method of obtaining ATF sources is through git VCS, using git protocol:

git clone https://github.com/ARM-software/arm-trusted-firmware.git

Check out the version of ATF that will be used for the build:

cd arm-trusted-firmware git checkout -b my_working_branch origin/master

ATF git hosting also provides snapshots.

Obtain mbedtls sources
The preferred method of obtaining mbedtls sources is through git VCS, using git protocol:

git clone https://github.com/ARMmbed/mbedtls.git

Check out the version of mbedtls that will be used for the build:

cd mbedtls git checkout -b my_working_branch origin/master

mbedtls git hosting also provides snapshots.

Prepare build environment
Before building ATF for R-Car Gen3 system, the following environment variables need to be configured:

export MBEDTLS_DIR="/path/to/mbedtls/" export ARCH=arm64 export CROSS_COMPILE=aarch64-linux-gnu-

The later variable must match the prefix of the Aarch64 cross-toolchain installed on your system, the example above is valid for Debian and Ubuntu,

Build ATF
Specific variables must be passed to make(1) to build ATF for a particular supported platform. There are common variables required for all R-Car Gen3 platforms and SoC/board specific ones. List of supported platforms and matching SoC/board variables is available at supported boards. Common variables are "PLAT=rcar RCAR_BL33_EXECUTION_EL=1 LOG_LEVEL=50 RCAR_DEBUG=0 SPD=opteed".

Below is an example of building the ATF for R8A7795 H3 ULCB board:

make CC=aarch64-linux-gnu-gcc bl2 bl31 rcar \ PLAT=rcar RCAR_BL33_EXECUTION_EL=1 LOG_LEVEL=50 RCAR_DEBUG=0 SPD=opteed \ LSI=H3 RCAR_DRAM_SPLIT=1 MACHINE=ulcb RCAR_GEN3_ULCB=1 PMIC_LEVEL_MODE=0 RCAR_DRAM_LPDDR4_MEMCONF=0

Flashing ATF
Each platform has a slightly different process for updating the content of the flash. The list of supported boards contains links to instructions for updating each supported board.