diff --git a/source/references.rst b/source/references.rst index bb45eb1..5019555 100644 --- a/source/references.rst +++ b/source/references.rst @@ -23,6 +23,8 @@ References .. [OPTEECore] `OP-TEE Core Architecture v4.5 `__ +.. [TB_FW_CONFIG] `Trusted Boot Firmware Configuration bindings `__ + .. [TFAFFAMB] TF-A Secure Partition Manager: `FF-A manifest binding to device tree v2.12 `__ .. [TCG_EFI] `Trusted Computing Group EFI Protocol Specification v15 `__ diff --git a/source/transfer_list.rst b/source/transfer_list.rst index 55be5f9..636a581 100644 --- a/source/transfer_list.rst +++ b/source/transfer_list.rst @@ -883,6 +883,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 @@ -1416,5 +1419,43 @@ 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`