1- Give a high-level overview of what the project is about.
2- Inform the user how to build and access the project's
   documentation.

Signed-off-by: Ziad Elhanafy <ziad.elhanafy@arm.com>

Replace the branch and revision values for the layers and
componenets in the release notes section by hardcoded values.

Signed-off-by: Ziad Elhanafy <ziad.elhanafy@arm.com>

Signed-off-by: Ziad Elhanafy <ziad.elhanafy@arm.com>

Bump the versions of the packages used in documentation.txt
file to the latest available versions.

Signed-off-by: Ziad Elhanafy <ziad.elhanafy@arm.com>

HTML document should use SVG image files and PDF document should
use PNG image files. To achieve this, replace the image file
type extension with ".*".

Also increase the size of some diagrams which appear a bit small
in the documentation.

Signed-off-by: Ziad Elhanafy <ziad.elhanafy@arm.com>

Signed-off-by: Ziad Elhanafy <ziad.elhanafy@arm.com>

Signed-off-by: Ziad Elhanafy <ziad.elhanafy@arm.com>

Change the numbered points to indented bullets in the Indentified
Non-Alignments section of SystemReady IR design document.

Signed-off-by: Ziad Elhanafy <ziad.elhanafy@arm.com>

Add alternative text as a short description of the image,
displayed by applications that cannot display images, or
spoken by applications for visually impaired users.

Signed-off-by: Ziad Elhanafy <ziad.elhanafy@arm.com>

1- Rename "Arm SystemReady IR Objective" section title to
   "Support on Kronos Reference Software Stack".
2- Remove the "Current Status" title.
3- Rephrase the text in this section.

Signed-off-by: Ziad Elhanafy <ziad.elhanafy@arm.com>

Signed-off-by: Ziad Elhanafy <ziad.elhanafy@arm.com>

Signed-off-by: Ziad Elhanafy <ziad.elhanafy@arm.com>

"Kronos Reference Stack" and "Kronos Reference Software Stack"
are both used in the documentation. Align the documentation
to only use "Kronos Reference Software Stack".

Signed-off-by: Ziad Elhanafy <ziad.elhanafy@arm.com>

The deisgn document contains a sentence which states that
"Trusted Firmware-A provides the initial, Secure world firmware,
which consists of BL2, BL31 and BL32", but this is misleading as
BL32 is part of OP-TEE and not TF-A.

Signed-off-by: Ziad Elhanafy <ziad.elhanafy@arm.com>

The design document contains a sentence which states that
"The Primary Compute is the Application Processor in the
Kronos Reference Design", this is misleading as the Application
Processor refers to the cores in the Primary Compute.

Signed-off-by: Ziad Elhanafy <ziad.elhanafy@arm.com>

1- The boot sequence for the RSS is being duplicated.
   Remove the initial description and leave the one under the
   boot process diagram only.
2- There is a sentence which starts with text in parenthesis.
   Move it to the end of the sentence.

Signed-off-by: Ziad Elhanafy <ziad.elhanafy@arm.com>

Debbie Martin authored Feb 22, 2024 and Diego Sueiro committed Feb 23, 2024

Add a Primary Compute PSA Crypto and Protected Storage section to the
user guide and reproduce sections.

Signed-off-by: Debbie Martin <Debbie.Martin@arm.com>

Debbie Martin authored Feb 21, 2024 and Diego Sueiro committed Feb 23, 2024

Add tests for PSA secure storage and crypto APIs architecture
tests on Primary Compute.

Signed-off-by: Debbie Martin <Debbie.Martin@arm.com>

The test for networking and cpu_hotplug occasionally fail on CI, despite
the expected output appearing in the logs so increase these timeouts
significantly

Signed-off-by: Divin Raj <divin.raj@arm.com>

Debbie Martin authored Feb 22, 2024 and Debbie Martin committed Feb 22, 2024

Move the common configuration to a class in the utility
folder for use between different test suites.

Signed-off-by: Debbie Martin <Debbie.Martin@arm.com>

Debbie Martin authored Feb 19, 2024 and Debbie Martin committed Feb 22, 2024

Fix a grammatical error repeated in the reproduce steps.

Signed-off-by: Debbie Martin <Debbie.Martin@arm.com>

Debbie Martin authored Feb 02, 2024 and Debbie Martin committed Feb 22, 2024

Add support for running multiple concurrent commands on different
terminals within the Linux terminal test utility.

Add support for spawning and closing DomU terminals within the
Xen test utility.

Restructure the testsuite into classes. Run the app tests,
calibration, analyze, pack, and deploy on DomU2 as well as DomU1
for virtualization builds.

Add integration tests which test multiple cam-app-example
instances running concurrently on separate VMs. Update the
expected test suite output in the documentation.

Signed-off-by: Debbie Martin <Debbie.Martin@arm.com>

Debbie Martin authored Feb 14, 2024 and Debbie Martin committed Feb 22, 2024

Run cam-app-example on multiple xen guests (DomU1 and DomU2)
concurrently to showcase cam-service support for multiple concurrent
connections.

Signed-off-by: Debbie Martin <Debbie.Martin@arm.com>

All lines that aren't in code or text blocks in reproduce.rst
are now less than 80 characters long.

Signed-off-by: Isaac Perry <isaac.perry@arm.com>

At the end of both sets of distro installation instructions, the user
is instructed to log in and issue a shutdown command before terminating
the FVP.

Signed-off-by: Isaac Perry <isaac.perry@arm.com>

The installation instructions for Debian and OpenSUSE have different
philosophies: Debian has screenshots for workarounds and OpenSUSE for
every user interaction.

Both sets of installation instructions now describe deviations from the
standard installation procedure and provide screenshots for more
complex steps. Links to their installation instructions have been moved
into each distro's respective section.

A new screenshot shows the console output following the instructions
after the grub failure in the debian installation section. To
maintain consistency in timestamps on the screenshots, new ones
replace their previous versions.

Remove png files which are no longer referenced in reproduce.rst.

Signed-off-by: Isaac Perry <isaac.perry@arm.com>

Reword CAM Introduction section, also update diagram to clarify the
event stream and deployment flow.

Signed-off-by: Vineeth Raveendran <vineeth.raveendran@arm.com>

Divin Raj authored Feb 20, 2024 and Diego Sueiro committed Feb 20, 2024

This commit adds a new check for the DOMU_INSTANCES before
proceeding with the domu2 test cases. The purpose of this check
is to ensure that domu2 instances available before running the
test case. If only one instance is available, the test case for
domu2 will be skipped.

Signed-off-by: Divin Raj <divin.raj@arm.com>

Create test_20_fvp_devices which inherits from fvp_devices
in meta-arm, It adds no changes to these tests at all but
it allows putting the tests in the correct order to avoid
restarting the FVP multiple times.

Signed-off-by: Ziad Elhanafy <ziad.elhanafy@arm.com>

Signed-off-by: Ziad Elhanafy <ziad.elhanafy@arm.com>

Previously, Kronos software stack did not differentiate between
reset and shutdown requests. A shutdown request resulted in
a system reset which was an incorrect behavior.

Now, a shutdown request using `shutdown now` in the Linux
console can successfully shutdown the system and eventually
terminate the FVP.

Add an OEQA test to verify this behavior which runs at the
end of automated validation in all use cases.

Signed-off-by: Ziad Elhanafy <ziad.elhanafy@arm.com>

`shutdown ---halt now` was previously used instead of
`shutdown now` as a workaround because doing
a power off caused a system reset.

This is now fixed and `shutdown now` terminates the FVP
so correct the corresponding reproduce section.

Signed-off-by: Ziad Elhanafy <ziad.elhanafy@arm.com>

Bump critical-application-monitoring to the latest version
available that includes improvements to the documentation and a fix for
multiple application test case.

Signed-off-by: Rahul Singh <rahul.singh@arm.com>

Ziad Elhanafy authored Feb 14, 2024 and Diego Sueiro committed Feb 20, 2024

As of meta-cassini v1.1.0, meta-secure-core layer is being cloned
outside the layers folder. Fix this by setting the correct path
until meta-cassini is fixed.

Signed-off-by: Ziad Elhanafy <ziad.elhanafy@arm.com>

Debbie Martin authored Feb 14, 2024 and Debbie Martin committed Feb 19, 2024

The status of only the first 20 build jobs was being checked to infer
pipeline success. This is because of a cap in the GitLab job get API.
It was causing some pipelines with build job failures to appear
green on the FVP summary report.

Fix this by checking all pages returned by the GitLab job API as
opposed to just the first.

Signed-off-by: Debbie Martin <Debbie.Martin@arm.com>

Remove Linux sleep command in test_player_to_analyzer.
This command was previously added because the FVP crashed when the
TCP client gets closed but this doesn't happen anymore.

Signed-off-by: Ziad Elhanafy <ziad.elhanafy@arm.com>

Debbie Martin authored Feb 12, 2024 and Debbie Martin committed Feb 15, 2024

Refine the remit of CAM usage to strictly within the Kronos
design and test area. This includes:
 1. Remove documentation references to running cam-service on
    the Primary Compute.
 2. Remove test cases which invoke cam-service on the Primary
    Compute and any references to them in the documentation.
 3. Remove test cases which only test the CAM utility help
    output and any references to them in the documentation.
 4. Remove cam-service from the Kronos FEATURE_PACKAGES since
    it should not be used on the Primary Compute.

Signed-off-by: Debbie Martin <Debbie.Martin@arm.com>

Debbie Martin authored Feb 09, 2024 and Debbie Martin committed Feb 15, 2024

Scan the cam-service logs for errors after running cam-app-example in
the positive test cases. This prevents false positive test results
whereby cam-app-example succeeds but cam-service has found errors.

Signed-off-by: Debbie Martin <Debbie.Martin@arm.com>

Debbie Martin authored Feb 01, 2024 and Debbie Martin committed Feb 15, 2024

Refactor the CAM integration tests to reflect the new CAM reproduce
workflow.

Remove mention of default and custom UUIDs since we are no
longer relying on a default one.

Extend the processing period from 3000 to 4000 milliseconds in line
with documentation.

Remove the output command line argument for cam-tool analyze and
cam-tool pack.

Signed-off-by: Debbie Martin <Debbie.Martin@arm.com>

Debbie Martin authored Feb 01, 2024 and Debbie Martin committed Feb 15, 2024

In the CAM reproduce documentation, make the data calibration workflow
the default flow rather than using the deployed example preset data
(.csd files). This allows for greater flexibility in the UUIDs and
parameters chosen, and also condenses the two workflows into a single
one.

Extend the processing period from 3000 to 4000 milliseconds to fix
temporal error on cam-service.

Fix copy-and-paste error where baremetal is referenced in the
virtualization section.

Remove the output command line argument for the cam-tool pack and
cam-tool analyze commands since it will infer the same by default
from the input argument.

Signed-off-by: Debbie Martin <Debbie.Martin@arm.com>