diff --git a/source/references.rst b/source/references.rst index 9a75ba5..32fd335 100644 --- a/source/references.rst +++ b/source/references.rst @@ -24,3 +24,5 @@ References .. [TF_BL31] `Data structures used in the BL31 cold boot interface v2.12 `__ .. [SPMCATTR] `The SPMC manifest v2.12: `__ + +.. [TB_FW_CONFIG] `Trusted Boot Firmware Configuration bindings `__ diff --git a/source/secondary_TE.rst b/source/secondary_TE.rst index e4321b8..9a3462d 100644 --- a/source/secondary_TE.rst +++ b/source/secondary_TE.rst @@ -43,6 +43,9 @@ including TF-A, OP-TEE and Hafnium. * - :ref:`0x109 ` - GPT Error Info + * - :ref:`0x10a ` + - DT Trusted Boot Firmware Configuration (``TB_FW_CONFIG``) + **OP-TEE pageable part address entry layout (XFERLIST_OPTEE_PAGEABLE_PART_ADDR)** This entry type holds the address of OP-TEE pageable part which is described in @@ -576,5 +579,42 @@ Bits [7:1] are reserved for future use. - hdr_size - The `gpt_error_info` field contains GPT error information. +**DT Trusted Boot Firmware Configuration entry layout +(XFERLIST_TB_FW_CONFIG)** + +The Trusted Boot Firmware Configuration (TB_FW_CONFIG) is a dynamic +configuration file used in TF-A to configure properties relating to trusted +firmware (i.e. IO policies, and Mbed TLS heap info) [TB_FW_CONFIG]_. This TE +contains in its data section the configuration file in DT format [DT]_. + +.. _tab_tb_fw_config: +.. list-table:: Trusted Boot Firmware Configuration entry type layout + :widths: 2 2 2 8 + + * - Field + - Size (bytes) + - Offset (bytes) + - Description + + * - tag_id + - 0x3 + - 0x0 + - The tag_id field must be set to **0x10a**. + + * - hdr_size + - 0x1 + - 0x3 + - |hdr_size_desc| + + * - data_size + - 0x4 + - 0x4 + - The size of the configuration file in bytes. + + * - tb_fw_config + - data_size + - hdr_size + - Holds a Trusted Boot Firmware Configuration file in DT format. + .. |hdr_size_desc| replace:: The size of this entry header in bytes must be set to `8`. .. |current_version| replace:: `0x1`