xref: /rk3399_ARM-atf/docs/getting_started/build-internals.rst (revision 0686a01b0cacb9aab840a5c334409b5739a95a97)
1f1910cc1SGovindraj RajaInternal Build Options
2f1910cc1SGovindraj Raja======================
3f1910cc1SGovindraj Raja
4f1910cc1SGovindraj Raja|TF-A| internally uses certain options that are not exposed directly through
5f1910cc1SGovindraj Raja:ref:`build-options <build options>` but enabled or disabled indirectly and
6f1910cc1SGovindraj Rajadepends on certain options to be enabled or disabled.
7f1910cc1SGovindraj Raja
8f1910cc1SGovindraj Raja.. _build_options_internal:
9f1910cc1SGovindraj Raja
10f1910cc1SGovindraj Raja-  ``CTX_INCLUDE_EL2_REGS``: This boolean option provides context save/restore
11f1910cc1SGovindraj Raja   operations when entering/exiting an EL2 execution context. This is of primary
12f1910cc1SGovindraj Raja   interest when Armv8.4-SecEL2 or RME extension is implemented.
13f1910cc1SGovindraj Raja   Default is 0 (disabled). This option will be set to 1 (enabled) when ``SPD=spmd``
14f1910cc1SGovindraj Raja   and ``SPMD_SPM_AT_SEL2`` is set or when ``ENABLE_RME`` is set to 1 (enabled).
15f87e54f7SManish Pandey
16f87e54f7SManish Pandey- ``FFH_SUPPORT``: This boolean option provides support to enable Firmware First
17f87e54f7SManish Pandey  handling (FFH) of External aborts and SError interrupts originating from lower
18f87e54f7SManish Pandey  ELs which gets trapped in EL3. This option will be set to 1 (enabled) if
19f87e54f7SManish Pandey  ``HANDLE_EA_EL3_FIRST_NS`` is set. Currently only NS world routes EA to EL3 but
20f87e54f7SManish Pandey  in future when Secure/Realm wants to use FFH then they can introduce new macros
21f87e54f7SManish Pandey  which will enable this option implicitly.
22*0686a01bSArunachalam Ganapathy
23*0686a01bSArunachalam Ganapathy-  ``OPTEE_SP_FW_CONFIG``: DTC build flag to include OP-TEE as SP in
24*0686a01bSArunachalam Ganapathy   tb_fw_config device tree. This flag is defined only when
25*0686a01bSArunachalam Ganapathy   ``ARM_SPMC_MANIFEST_DTS`` manifest file name contains pattern optee_sp.
26*0686a01bSArunachalam Ganapathy
27*0686a01bSArunachalam Ganapathy-  ``TRUSTY_SP_FW_CONFIG``: DTC build flag to include Trusty as SP in
28*0686a01bSArunachalam Ganapathy   tb_fw_config device tree. This flag is defined only when
29*0686a01bSArunachalam Ganapathy   ``ARM_SPMC_MANIFEST_DTS`` manifest file name contains pattern trusty_sp.
30