xref: /rk3399_ARM-atf/docs/plat/arm/tc/index.rst (revision c76da4ecabce719c321ba27b323d04de4878894f)
16ec0c65bSUsama ArifTC Total Compute Platform
26ec0c65bSUsama Arif==========================
36ec0c65bSUsama Arif
46ec0c65bSUsama ArifSome of the features of TC platform referenced in TF-A include:
56ec0c65bSUsama Arif
66ec0c65bSUsama Arif- A `System Control Processor <https://github.com/ARM-software/SCP-firmware>`_
76ec0c65bSUsama Arif  to abstract power and system management tasks away from application
86ec0c65bSUsama Arif  processors. The RAM firmware for SCP is included in the TF-A FIP and is
96ec0c65bSUsama Arif  loaded by AP BL2 from FIP in flash to SRAM for copying by SCP (SCP has access
106ec0c65bSUsama Arif  to AP SRAM).
116ec0c65bSUsama Arif- GICv4
126ec0c65bSUsama Arif- Trusted Board Boot
136ec0c65bSUsama Arif- SCMI
146ec0c65bSUsama Arif- MHUv2
156ec0c65bSUsama Arif
1674606e76SIcen ZeyadaThe TF-A build is specified by the option `TARGET_PLATFORM` which represents
1774606e76SIcen Zeyadathe Total Compute platform number. The platforms support the CPU variants
1874606e76SIcen Zeyadalisted as below:
19eebd2c3fSRupinderjit Singh
2074606e76SIcen Zeyada-  TC3 has support for Cortex A520, Cortex A725 and Cortex x925.
2174606e76SIcen Zeyada
226ec0c65bSUsama ArifBoot Sequence
236ec0c65bSUsama Arif-------------
246ec0c65bSUsama Arif
256ec0c65bSUsama ArifThe execution begins from SCP_BL1. SCP_BL1 powers up the AP which starts
266ec0c65bSUsama Arifexecuting AP_BL1 and then executes AP_BL2 which loads the SCP_BL2 from
276ec0c65bSUsama ArifFIP to SRAM. The SCP has access to AP SRAM. The address and size of SCP_BL2
286ec0c65bSUsama Arifis communicated to SCP using SDS. SCP copies SCP_BL2 from SRAM to its own
296ec0c65bSUsama ArifRAM and starts executing it. The AP then continues executing the rest of TF-A
306ec0c65bSUsama Arifstages including BL31 runtime stage and hands off executing to
316ec0c65bSUsama ArifNon-secure world (u-boot).
326ec0c65bSUsama Arif
336ec0c65bSUsama ArifBuild Procedure (TF-A only)
346ec0c65bSUsama Arif~~~~~~~~~~~~~~~~~~~~~~~~~~~
356ec0c65bSUsama Arif
36eebd2c3fSRupinderjit Singh-  Obtain `Arm toolchain`_ and set the CROSS_COMPILE environment variable to
37eebd2c3fSRupinderjit Singh   point to the toolchain folder.
386ec0c65bSUsama Arif
396ec0c65bSUsama Arif-  Build TF-A:
406ec0c65bSUsama Arif
416ec0c65bSUsama Arif   .. code:: shell
426ec0c65bSUsama Arif
436ec0c65bSUsama Arif      make PLAT=tc BL33=<path_to_uboot.bin> \
4474606e76SIcen Zeyada      SCP_BL2=<path_to_scp_ramfw.bin> TARGET_PLATFORM={3} all fip
456ec0c65bSUsama Arif
466ec0c65bSUsama Arif   Enable TBBR by adding the following options to the make command:
476ec0c65bSUsama Arif
486ec0c65bSUsama Arif   .. code:: shell
496ec0c65bSUsama Arif
506ec0c65bSUsama Arif      MBEDTLS_DIR=<path_to_mbedtls_directory>  \
516ec0c65bSUsama Arif      TRUSTED_BOARD_BOOT=1 \
526ec0c65bSUsama Arif      GENERATE_COT=1 \
536ec0c65bSUsama Arif      ARM_ROTPK_LOCATION=devel_rsa  \
546ec0c65bSUsama Arif      ROT_KEY=plat/arm/board/common/rotpk/arm_rotprivk_rsa.pem
556ec0c65bSUsama Arif
56eebd2c3fSRupinderjit Singh--------------
57eebd2c3fSRupinderjit Singh
58*f036ddafSManish V Badarkhe*Copyright (c) 2020-2025, Arm Limited. All rights reserved.*
59eebd2c3fSRupinderjit Singh
60eebd2c3fSRupinderjit Singh.. _Arm Toolchain: https://developer.arm.com/tools-and-software/open-source-software/developer-tools/gnu-toolchain/downloads
61