From c4ebf545fa5eaefedc11323f64d8c9a7a3b5b82b Mon Sep 17 00:00:00 2001 From: Sujana-M <52772661+Sujana-M@users.noreply.github.com> Date: Thu, 21 Nov 2024 16:47:36 +0530 Subject: [PATCH] Changes to READMe and version (#401) - Changed the ACS version to 1.0.9 - Changes to READMe file on edk2 commit and release - change to checklist Signed-off-by: Sujana M --- README.md | 11 ++++++----- baremetal_app/BsaAcs.h | 2 +- docs/PCIe_Exerciser/README.md | 23 ++++++++++++++++++++++- docs/arm_bsa_testcase_checklist.rst | 2 +- linux_app/bsa-acs-app/include/bsa_app.h | 2 +- mem_test/README.md | 3 ++- uefi_app/BsaAcs.h | 2 +- 7 files changed, 34 insertions(+), 11 deletions(-) diff --git a/README.md b/README.md index 2fa14073..c5b9551c 100644 --- a/README.md +++ b/README.md @@ -5,21 +5,21 @@ ## Base System Architecture **Base System Architecture** (BSA) specification describes a hardware system architecture based on the Arm 64-bit architecture. System software such as operating systems, hypervisors, and firmware rely on this. It addresses PE features and key aspects of system architecture. -For more information, download the [BSA specification](https://developer.arm.com/documentation/den0094/c/?lang=en) +For more information, download the [BSA specification](https://developer.arm.com/documentation/den0094/d/?lang=en) ## BSA - Architecture Compliance Suite BSA **Architecture Compliance Suite** (ACS) is a collection of self-checking, portable C-based tests. -This suite includes a set of examples of the invariant behaviors that are provided by the [BSA](https://developer.arm.com/documentation/den0094/c/?lang=en) specification, so that you can verify if these behaviour have been interpreted correctly. +This suite includes a set of examples of the invariant behaviors that are provided by the [BSA](https://developer.arm.com/documentation/den0094/d/?lang=en) specification, so that you can verify if these behaviour have been interpreted correctly. Most of the tests are executed from UEFI (Unified Extensible Firmware Interface) Shell by executing the BSA UEFI shell application. A few tests are executed by running the BSA ACS Linux application which in turn depends on the BSA ACS Linux kernel module. The tests can also be executed in a Bare-metal environment. The initialization of the Bare-metal environment is specific to the environment and is out of scope of this document. ## Release details - - Code quality: v1.0.8 - - The tests are written for version 1.0 (c) of the BSA specification. + - Code quality: v1.0.9 + - The tests are written for version 1.1 of the BSA specification. - The tests can be run at both the Pre-Silicon and Silicon level. - For complete coverage of the BSA rules, availability of an Exerciser is required for Exerciser tests to be run during verficiation at Pre-Silicon level. - The compliance suite is not a substitute for design verification. @@ -55,7 +55,7 @@ Prebuilt images for each release are available in the prebuilt_images folder of Before you start the ACS build, ensure that the following requirements are met. - Any mainstream Linux-based OS distribution running on a x86 or AArch64 machine. -- git clone the [EDK2 tree](https://github.com/tianocore/edk2). Recommended edk2 tag is edk2-stable202402 +- git clone the [EDK2 tree](https://github.com/tianocore/edk2). Recommended edk2 commit is 836942fbadb629050b866a8052e6af755bcdf623 - git clone the [EDK2 port of libc](https://github.com/tianocore/edk2-libc) to local . - Install GCC-ARM 13.2 [toolchain](https://developer.arm.com/downloads/-/arm-gnu-toolchain-downloads). - Install the build prerequisite packages to build EDK2.
@@ -263,6 +263,7 @@ The Arm SystemReady ACS test suite may run at a higher privilege level. An attac -------------------------------------------------------------------------------------------- | BSA Spec Version | BSA ACS Version | BSA Tag ID | Pre-Si Support | |-----------------------|:-------------------:|:-------------------:|:--------------------:| +| BSA v1.1 | v1.0.9 | v24.11_REL1.0.9 | Yes | | BSA v1.0(c) | v1.0.8 | v24.03_REL1.0.8 | Yes | | BSA v1.0(c) | v1.0.7 | v23.12_REL1.0.7 | Yes | | BSA v1.0(c) | v1.0.6 |v23.11_BootFramework | Yes | diff --git a/baremetal_app/BsaAcs.h b/baremetal_app/BsaAcs.h index ffbb559e..717a3a37 100644 --- a/baremetal_app/BsaAcs.h +++ b/baremetal_app/BsaAcs.h @@ -25,7 +25,7 @@ #define BSA_ACS_MAJOR_VER 1 #define BSA_ACS_MINOR_VER 0 -#define BSA_ACS_SUBMINOR_VER 8 +#define BSA_ACS_SUBMINOR_VER 9 #define INVALID_MPIDR 0xffffffff diff --git a/docs/PCIe_Exerciser/README.md b/docs/PCIe_Exerciser/README.md index 9e6fb047..5d5957db 100644 --- a/docs/PCIe_Exerciser/README.md +++ b/docs/PCIe_Exerciser/README.md @@ -53,9 +53,30 @@ To run the BSA exerciser tests make the following change in ${rdn2_path}/model-s + -C pcie_group_0.pciex16.hierarchy_file_name="example_pcie_hierarchy_0.json" \ ``` +### Minimum requirement of PCIe Hierarchy + +The diagram below illustrates the minimal PCIe hierarchy structure necessary for comprehensive testing of an exerciser test case. + +``` + ________________________________ + | Root Bridge | + |________________________________| + | | | + | | | + ___|__ ____|____ ____|____ + | RCiEP| | RootPort| | RootPort| + |______| |_________| |_________| + | | + | | + ____|_____ ____|_____ + | Exerciser| | Exerciser| + | EndPoint | | EndPoint | + |__________| |__________| +``` + ## Useful links - For information on configuring the [PCIe Hierarchy](PCIeConfigurableHierarchy.md) - For more information on PCIe capabilities that exerciser supports, refer [Exerciser.md](Exerciser.md) -*Copyright (c) 2023 Arm Limited and Contributors. All rights reserved.* +*Copyright (c) 2023-2024 Arm Limited and Contributors. All rights reserved.* diff --git a/docs/arm_bsa_testcase_checklist.rst b/docs/arm_bsa_testcase_checklist.rst index 77af1461..8e3df63f 100644 --- a/docs/arm_bsa_testcase_checklist.rst +++ b/docs/arm_bsa_testcase_checklist.rst @@ -5,7 +5,7 @@ BSA ACS Testcase checklist The below table provides the following details #. BSA rules covered by a test. -#. SystemReady certification band(IR, ES and SR) for which test is required. +#. SystemReady band(IR, ES and SR) for which test is required. #. Runtime environment(UEFI, BareMetal and Linux) where test executes. #. Tests for which exerciser is required. diff --git a/linux_app/bsa-acs-app/include/bsa_app.h b/linux_app/bsa-acs-app/include/bsa_app.h index 40b3e6b7..15fc6ed7 100644 --- a/linux_app/bsa-acs-app/include/bsa_app.h +++ b/linux_app/bsa-acs-app/include/bsa_app.h @@ -22,7 +22,7 @@ #define BSA_APP_VERSION_MAJOR 1 #define BSA_APP_VERSION_MINOR 0 -#define BSA_APP_VERSION_SUBMINOR 8 +#define BSA_APP_VERSION_SUBMINOR 9 #define G_SW_OS 0 #define G_SW_HYP 1 diff --git a/mem_test/README.md b/mem_test/README.md index 679c253a..002535e4 100644 --- a/mem_test/README.md +++ b/mem_test/README.md @@ -16,8 +16,9 @@ might lead to unpredictable behavior in concurrent programs. ## Steps to build litmus tests into bsa-acs 1. Setup edk2 build directory -> git clone --branch edk2-stable202402 https://github.com/tianocore/edk2.git +> git clone https://github.com/tianocore/edk2.git > cd edk2 +> git checkout 836942fbadb629050b866a8052e6af755bcdf623 > git clone https://github.com/tianocore/edk2-libc.git > git submodule update --init --recursive diff --git a/uefi_app/BsaAcs.h b/uefi_app/BsaAcs.h index 42179b70..7d497f53 100755 --- a/uefi_app/BsaAcs.h +++ b/uefi_app/BsaAcs.h @@ -22,7 +22,7 @@ #define BSA_ACS_MAJOR_VER 1 #define BSA_ACS_MINOR_VER 0 - #define BSA_ACS_SUBMINOR_VER 8 + #define BSA_ACS_SUBMINOR_VER 9 #define G_PRINT_LEVEL ACS_PRINT_TEST