fix(docs): update the instrumentation procedure
The current testing method does not involve manually building and
running the instrumentation tests. The ones listed have diverged from
what happens. The source of trust are the jobs in CI, so update the docs
to reflect that.
Change-Id: I332f85044a36aed9ef2d87485d90861c58875e4a
Signed-off-by: Boyan Karatotev <boyan.karatotev@arm.com>
diff --git a/docs/perf/psci-performance-n1sdp.rst b/docs/perf/psci-performance-n1sdp.rst
index 178d8e6..e8faae4 100644
--- a/docs/perf/psci-performance-n1sdp.rst
+++ b/docs/perf/psci-performance-n1sdp.rst
@@ -4,87 +4,16 @@
For this test we used the N1 System Development Platform (`N1SDP`_), which
contains an SoC consisting of two dual-core Arm N1 clusters.
-The following source trees and binaries were used:
+The following source trees were used:
- `TF-A v2.12-rc0`_
- `TFTF v2.12-rc0`_
-- SCP/MCP `Prebuilt Images`_
Please see the Runtime Instrumentation :ref:`Testing Methodology
-<Runtime Instrumentation Methodology>` page for more details.
-
-Procedure
----------
-
-#. Build TFTF with runtime instrumentation enabled:
-
- .. code:: shell
-
- make CROSS_COMPILE=aarch64-none-elf- PLAT=n1sdp \
- TESTS=runtime-instrumentation all
-
-#. Build TF-A with the following build options:
-
- .. code:: shell
-
- make CROSS_COMPILE=aarch64-none-elf- PLAT=n1sdp \
- ENABLE_RUNTIME_INSTRUMENTATION=1 fiptool all
-
-#. Fetch the SCP firmware images:
-
- .. code:: shell
-
- curl --fail --connect-timeout 5 --retry 5 \
- -sLS -o build/n1sdp/release/scp_rom.bin \
- https://downloads.trustedfirmware.org/tf-a/css_scp_2.12.0/n1sdp/release/n1sdp-bl1.bin
- curl --fail --connect-timeout 5 \
- --retry 5 -sLS -o build/n1sdp/release/scp_ram.bin \
- https://downloads.trustedfirmware.org/tf-a/css_scp_2.12.0/n1sdp/release/n1sdp-bl2.bin
-
-#. Fetch the MCP firmware images:
-
- .. code:: shell
-
- curl --fail --connect-timeout 5 --retry 5 \
- -sLS -o build/n1sdp/release/mcp_rom.bin \
- https://downloads.trustedfirmware.org/tf-a/css_scp_2.12.0/n1sdp/release/n1sdp-mcp-bl1.bin
- curl --fail --connect-timeout 5 --retry 5 \
- -sLS -o build/n1sdp/release/mcp_ram.bin \
- https://downloads.trustedfirmware.org/tf-a/css_scp_2.12.0/n1sdp/release/n1sdp-mcp-bl2.bin
-
-#. Using the fiptool, create a new FIP package and append the SCP ram image onto
- it.
-
- .. code:: shell
-
- ./tools/fiptool/fiptool create --blob \
- uuid=cfacc2c4-15e8-4668-82be-430a38fad705,file=build/n1sdp/release/bl1.bin \
- --scp-fw build/n1sdp/release/scp_ram.bin build/n1sdp/release/scp_fw.bin
-
-#. Append the MCP image to the FIP.
-
- .. code:: shell
-
- ./tools/fiptool/fiptool create \
- --blob uuid=54464222-a4cf-4bf8-b1b6-cee7dade539e,file=build/n1sdp/release/mcp_ram.bin \
- build/n1sdp/release/mcp_fw.bin
-
-#. Then, add TFTF as the Non-Secure workload in the FIP image:
-
- .. code:: shell
-
- make CROSS_COMPILE=aarch64-none-elf- PLAT=n1sdp \
- ENABLE_RUNTIME_INSTRUMENTATION=1 SCP_BL2=/dev/null \
- BL33=<path/to/tftf.bin> fip
-
-#. Load the following images onto the development board: ``fip.bin``,
- ``scp_rom.bin``, ``scp_ram.bin``, ``mcp_rom.bin``, and ``mcp_ram.bin``.
-
-.. note::
-
- These instructions presume you have a complete firmware stack. The N1SDP
- `user guide`_ provides a detailed explanation on how to get setup from
- scratch.
+<Runtime Instrumentation Methodology>` page for more details. The tests were ran
+using the
+`tf-psci-lava-instr/n1sdp-runtime-instrumentation,n1sdp-runtime-instrumentation:n1sdp-fip.tftf-firmware`
+configuration in CI.
Results
-------
@@ -274,10 +203,9 @@
--------------
-*Copyright (c) 2023-2024, Arm Limited. All rights reserved.*
+*Copyright (c) 2023-2025, Arm Limited. All rights reserved.*
.. _TF-A v2.12-rc0: https://review.trustedfirmware.org/plugins/gitiles/TF-A/trusted-firmware-a/+/refs/tags/v2.12-rc0
.. _TFTF v2.12-rc0: https://review.trustedfirmware.org/plugins/gitiles/TF-A/tf-a-tests/+/refs/tags/v2.12-rc0
.. _user guide: https://gitlab.arm.com/arm-reference-solutions/arm-reference-solutions-docs/-/blob/master/docs/n1sdp/user-guide.rst
-.. _Prebuilt Images: https://downloads.trustedfirmware.org/tf-a/css_scp_2.12.0/n1sdp/release/
.. _N1SDP: https://developer.arm.com/documentation/101489/latest