Add FF-A SP binary TE type

Allocate a TE type in the Trusted Firmware range for FF-A SP binaries. Hafnium SPMC supports the SP's artefacts to be packaged as a Transfer List generated at build time (with TF-A's tlc tool). The respective Transfer List contents: SP binary/image, the FF-A manifest, and other optional resoures (e.g. HOB). Signed-off-by: J-Alves <[email protected]> Change-Id: I34fada0dca2b5d6f30fcf2b7a54d93028aa59727
J-Alves · Dec 19, 2024 · 551dc0b · 551dc0b
1 parent 9affba4
commit 551dc0b
Showing 1 changed file with 37 additions and 0 deletions.
diff --git a/source/transfer_list.rst b/source/transfer_list.rst
@@ -951,6 +951,43 @@ software running in Secure, Non-Secure, or Realm modes.
      - hdr_size
      - Holds a single `entry_point_info` structure.
 
+**FF-A SP binary (XFERLIST_FFA_SP_BINARY)**
+
+This entry holds a reference to an FF-A Secure Partition (SP) binary.
+
+This TE type is for an SPMC implementation to identify which entry
+relates to the SP's binary, such that it can install the binary and
+hand-over execution.
+
+.. _tab_ffa_sp_binary:
+.. list-table:: An FF-A SP binary 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 **0x103**.
+
+   * - hdr_size
+     - 0x1
+     - 0x3
+     - |hdr_size_desc|
+
+   * - data_size
+     - 0x4
+     - 0x4
+     - The size of the SP binary in bytes.
+
+   * - ffa_sp_binary
+     - data_size
+     - hdr_size
+     - Holds the FF-A SP binary.
+
 **Read-Write Memory Layout Entry Layout (XFERLIST_RW_MEM_LAYOUT64)**
 
 This entry type holds a structure that describes the layout of a read-write