totalcompute/tc0: update doc for TC0-2021.07.31 release

Updated change-log, release_notes, user-guide for tc0 with new
software/hardware features added and its changes from the previous release.

Signed-off-by: Avinash Mehta <avinash.mehta@arm.com>
Change-Id: I5fe0b836721441861ecad5cdeeab1c0a49c9b99c

docs/totalcompute/tc0/change-log.rst

@@ -4,6 +4,25 @@ Change Log
 This document contains a summary of the new features, changes and
 fixes in each release of TC0 software stack.
 
+Version 2021.07.31
+------------------
+
+Features added
+~~~~~~~~~~~~~~
+- Memory Tagging Extension (MTE)
+- Pointer Authentication Code (PAC)
+- Branch Target Identification (BTI)
+
+Changes
+~~~~~~~
+- Updated Android AOSP to master (May21)
+- Updated Android Common Kernel to v5.10
+- Updated Trusted Firmware-A & Hafnium to v2.5
+- Updated OP-TEE to v3.14.0
+- Updated SCP firmware to v2.8
+- Updated U-boot to v2021.07
+- Updated Yocto to master
+
 Version 2021.04.23
 ------------------
 

docs/totalcompute/tc0/release_notes.rst

-Release notes - 2021.04.23
+.. _docs/totalcompute/tc0/release_notes:
+Release notes - 2021.07.31
 ==========================
 
 .. section-numbering::
@@ -8,7 +9,7 @@ Release notes - 2021.04.23
 
 Release tag
 -----------
-The manifest tag for this release is TC0-2021.04.23
+The manifest tag for this release is TC0-2021.07.31
 
 Components
 ----------
@@ -19,6 +20,7 @@ The following is a summary of the key software features of the release:
  - U-Boot bootloader.
  - Hafnium for S-EL2 Secure Partition Manager core.
  - OP-TEE for Trusted Execution Environment (TEE).
+ - Crypto and Storage Trusted Services running at S-EL0.
 
 Hardware Features
 -----------------
@@ -33,37 +35,38 @@ Hardware Features
 Software Features
 -----------------
  - Poky Distribution support.
- - Android R/11 Support.
- - Android Common Kernel 5.4.
- - Trusted Firmware-A.
+ - Android AOSP Support (May21).
+ - Android Common Kernel 5.10 with PAC/BTI/MTE
+ - Trusted Firmware-A & Hafnium v2.5
+ - OP-TEE 3.14.0
  - Support secure boot based on TBBR specification https://developer.arm.com/documentation/den0006/latest
- - System Control Processor firmware.
- - Yocto based build system.
- - U-Boot bootloader.
+ - System Control Processor (SCP) firmware v2.8
+ - Build system based on Yocto master
+ - U-Boot bootloader v2021.07
  - Power management features: cpufreq and cpuidle.
  - SCMI (System Control and Management Interface) support.
  - 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.
- - Trusted OS 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. This is an experimental feature.
+ - 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.
  - Crypto and Storage Trusted Services 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).
+ - Shim Layer at S-EL1 running on top of S-EL2 SPMC (Hafnium) used by Trusted Services running in S-EL0.
 
 Platform Support
 ----------------
  - This Software release is tested on TC0 Fast Model platform (FVP).
-   - Supported Fast model version for this release is 11.14.32
+   - Supported Fast model version for this release is 11.15.20
 
 Known issues or Limitations
 ---------------------------
 1. At the U-Boot prompt press enter and type "boot" to continue booting else wait
-   for ~15 secs for boot to continue automatically.This is because of the time
-   differrence in CPU frequency and FVP operating frequency.
-2. OPTEE Test (xtest) sometimes throw some failures ,issue is under investigation.
+   for ~15 secs for boot to continue automatically. This is because of the time
+   difference in CPU frequency and FVP operating frequency.
+2. OP-TEE test suite xtest, fails for Storage concurrency test case. This issue is under investigation.
 
 
 Support

docs/totalcompute/tc0/user-guide.rst

@@ -74,7 +74,7 @@ in these instructions.
 
     mkdir <tc0_workspace>
     cd <tc0_workspace>
-    export TC0_RELEASE=refs/tags/TC0-2021.04.23
+    export TC0_RELEASE=refs/tags/TC0-2021.07.31
 
 To sync BSP only without Android, run the repo command.
 
@@ -247,18 +247,17 @@ S-EL0 trusted-services
 
 Based on `Trusted Services <https://www.trustedfirmware.org/projects/trusted-services/>`__
 
-+--------+------------------------------------------------------------------------------------------------------+
-| Recipe | <tc0_workspace>/bsp/layers/meta-arm/meta-arm/recipes-security/trusted-services/secure-storage_git.bb |
-|        | <tc0_workspace>/bsp/layers/meta-arm/meta-arm/recipes-security/trusted-services/crypto-sp_git.bb      |
-+--------+------------------------------------------------------------------------------------------------------+
-| Files  | * <tc0_workspace>/bsp/build-poky/tmp-poky/deploy/images/tc0/firmware/crypto-sp.bin                   |
-|        | * <tc0_workspace>/bsp/build-poky/tmp-poky/deploy/images/tc0/firmware/secure-storage.bin              |
-+--------+------------------------------------------------------------------------------------------------------+
++--------+-----------------------------------------------------------------------------------------------+
+| Recipe | <tc0_workspace>/bsp/layers/meta-tc/recipes-security/trusted-services/secure-partitions_git.bb |
++--------+-----------------------------------------------------------------------------------------------+
+| Files  | * <tc0_workspace>/bsp/build-poky/tmp-poky/deploy/images/tc0/firmware/crypto-sp.bin            |
+|        | * <tc0_workspace>/bsp/build-poky/tmp-poky/deploy/images/tc0/firmware/secure-storage.bin       |
++--------+-----------------------------------------------------------------------------------------------+
 
 Linux
 *****
 
-The recipe responsible for building a 5.4 version of the Android Common kernel (`ACK <https://android.googlesource.com/kernel/common/>`__).
+The recipe responsible for building a 5.10 version of the Android Common kernel (`ACK <https://android.googlesource.com/kernel/common/>`__).
 
 +--------+-----------------------------------------------------------------------------------------------+
 | Recipe | <tc0_workspace>/bsp/layers/meta-arm/meta-arm-bsp/recipes-kernel/linux/linux-arm-platforms.inc |
@@ -273,11 +272,11 @@ Poky Linux distro
 The layer is based on the `poky <https://www.yoctoproject.org/software-item/poky/>`__ Linux distribution.
 The provided distribution is based on BusyBox and built using glibc.
 
-+--------+---------------------------------------------------------------------------------------------------+
-| Recipe | <tc0_workspace>/bsp/layers/openembedded-core/meta/recipes-core/images/core-image-minimal.bb       |
-+--------+---------------------------------------------------------------------------------------------------+
-| Files  | * <tc0_workspace>/bsp/build-poky/tmp-poky/deploy/images/tc0/fitImage-core-image-minimal-tc0-tc0   |
-+--------+---------------------------------------------------------------------------------------------------+
++--------+-------------------------------------------------------------------------------------------------+
+| Recipe | <tc0_workspace>/bsp/layers/openembedded-core/meta/recipes-core/images/core-image-minimal.bb     |
++--------+-------------------------------------------------------------------------------------------------+
+| Files  | * <tc0_workspace>/bsp/build-poky/tmp-poky/deploy/images/tc0/fitImage-core-image-minimal-tc0-tc0 |
++--------+-------------------------------------------------------------------------------------------------+
 
 
 Android