diff --git a/docs/totalcompute/tc1/release_notes.rst b/docs/totalcompute/tc1/release_notes.rst index 1969b82ceb1d8b95afbdad162a647036392ddd3b..f0519550ccc74984454ae862ffec7957dae41107 100755 --- a/docs/totalcompute/tc1/release_notes.rst +++ b/docs/totalcompute/tc1/release_notes.rst @@ -50,14 +50,14 @@ Software Features - Verified u-boot for authenticating fit image (containing kernel + ramdisk) during poky boot. - Android Verified Boot (AVB) for authenticating boot and system image during Android boot. - Software rendering on Android with DRM Hardware Composer offloading composition to Mali D71 DPU. - - Hafnium as Secure Partition Manager (SPM) at S-EL2. + - Hafnium as Secure Partition Manager (SPM) at S-EL2 with the Virtual Host Extension support enabled. - OP-TEE as Secure Partition at S-EL1, managed by S-EL2 SPMC (Hafnium) - Arm FF-A driver and FF-A Transport support for OP-TEE driver in Android Common Kernel. - OP-TEE Support in Poky distribution. This includes OP-TEE client and OP-TEE test suite. - - Trusted Services (Crypto and Internal Trusted Storage) running at S-EL0. + - Trusted Services (Crypto, Internal Trusted Storage and Firmware Update) running at S-EL0. - Trusted Services test suite added to poky distribution. - - Shim Layer at S-EL1 running on top of S-EL2 SPMC (Hafnium) used by Trusted Services running in S-EL0. - Tracing - Added support for ETE and TRBE v1.0 in TF-A, kernel and simpleperf. Traces can be captured with simpleperf. However, to enable tracing, the libete plugin has to be loaded while executing the FVP with ``--plugin /libete-plugin.so`` + - Firware Update support Platform Support ---------------- diff --git a/docs/totalcompute/tc1/user-guide.rst b/docs/totalcompute/tc1/user-guide.rst index 693900eee91e5f9d004ea0461ac3864471b35d78..73697e33c589a4adf821cd67aa8491f0a681bbb9 100755 --- a/docs/totalcompute/tc1/user-guide.rst +++ b/docs/totalcompute/tc1/user-guide.rst @@ -382,6 +382,50 @@ and run command ``ts-demo`` for the demonstration client application. On Android distribution, Trusty provides a Trusted Execution Environment (TEE). The functionality of Trusty IPC can be tested using command ``tipc-test -t ta2ta-ipc`` with root privilege. +Firmware Update +--------------- + +Creating Capsule +################ + +Firmware Update in the total compute platform uses the capsule update mechanism. Hence, the Firmware Image Package (FIP) binary +has to be converted to a capsule. This can be done with ``GenerateCapsule`` which is present in ``BaseTools/BinWrappers/PosixLike`` +of the `edk2 project `__. + +:: + + GenerateCapsule -e -o efi_capsule --fw-version 1 --lsv 0 --guid 0d5c011f-0776-5b38-8e81-36fbdf6743e2 --verbose --update-image-index 0 --verbose fip-tc.bin + +| "fip-tc.bin" is the input fip file that has the firmware binaries of the total compute platform +| "efi_capsule" is the name of capsule to be generated +| "0d5c011f-0776-5b38-8e81-36fbdf6743e2" is the image type UUID for the FIP image + +Loading Capsule +############### + +The capsule generated using the above steps has to be loaded into memory during the execution of the model by providing the below FVP arguments. + +:: + + --data board.dram=/efi_capsule@0x2000000 + +This loads the capsule to be updated at address 0x82000000 + +Updating Firmware +################# + +During the normal boot of the platform, stop at the U-Boot prompt and execute the below commands. + +:: + + TOTAL_COMPUTE# efidebug capsule update -v 0x82000000 + +This will update the firmware. After it is completed, reboot the platform using the reset command. + +:: + + TOTAL_COMPUTE# reset + -------------- *Copyright (c) 2021-2022, Arm Limited. All rights reserved.*