Skip to content

Add Trusted Boot Firmware Configuration entry #2

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
harrisonmutai-arm wants to merge 1 commit into
base: main
Choose a base branch
from
Open

Add Trusted Boot Firmware Configuration entry #2

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 2 additions & 0 deletions source/references.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -24,3 +24,5 @@ References
.. [TF_BL31] `Data structures used in the BL31 cold boot interface v2.12 <https://trustedfirmware-a.readthedocs.io/en/v2.12.0/design/firmware-design.html#data-structures-used-in-the-bl31-cold-boot-interface>`__

.. [SPMCATTR] `The SPMC manifest v2.12: <https://hafnium.readthedocs.io/en/v2.12.0/secure-partition-manager/secure-partition-manager.html#spmc-manifest>`__

.. [TB_FW_CONFIG] `Trusted Boot Firmware Configuration bindings <https://review.trustedfirmware.org/plugins/gitiles/TF-A/trusted-firmware-a/+/c6c882a42795da82b18d2d7dff1265bf2a1a6aab/docs/components/fconf/tb_fw_bindings.rst>`__
40 changes: 40 additions & 0 deletions source/secondary_TE.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -43,6 +43,9 @@ including TF-A, OP-TEE and Hafnium.
* - :ref:`0x109 <tab_gpt_info>`
- GPT Error Info

* - :ref:`0x10a <tab_tb_fw_config>`
- 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
Expand Down Expand Up @@ -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`