build-internals.rst 1.5 KB

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