"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>

Rename the Introduction section to Overview and improve it,
The following changes are also included:
1- Move "Documentation Overview" to the top and rename it
   to "Audience".
2- Remove/Rework some sentences.
3- Rename RSS to RSE, but use RSS as an alias for it.
4- Use "Kronos Reference Design" as an alias for "Arm Reference
   Design-1 AE".

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

If an exception is thrown inside the 'with' context, the
__exit__ method will be called and the code inside it will
return False to re-raise the exception at the end of the
__exit__ function, but before that, the kill() method will
be called and some command will be sent to the console.

However in the case of an exception for timeout, for example
a command that runs indefinitely for any reason, the underlying
console is still busy with the overrun command and any subsequent
commands issued by the kill() function won't be executed.

To prevent this case, rework the __exit__ function to send a
signal through ctrl-C and try to stop the command running, wait
for the prompt to be available and only at this point start the
procedure to stop the background process.
Create a new helper function in LinuxTermUtils to stop the running
command and wait for the prompt.

Signed-off-by: Luca Fancellu <luca.fancellu@arm.com>

Bump critical-application-monitoring to the latest version
available that includes improvements to the cam testing and an event
alarm margin command line parameter changes.

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

Add the integration testing of Secure Firmware Update to both
reproduce and validation sections

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

Secure Firmware Update is only ran manually now.
Add an automated validation test to verify that
it works correctly.

This test only runs for CAM baremetal use case.

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

The currently used Secure Firmware Update is over complicated
and problematic as U-Boot seems to try to update the system
twice, causing TF-M to display error messages which might
be confusing to the end user.

It also requires the user to wait for Linux to fully boot
and causes unnecessary reboot times.

Replace the currently used method with the following commands
in U-Boot:
fatload mmc 0:1 0xa2000000 fw.cap
efidebug capsule update -v 0xa2000000

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

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

Set the Linux version patch to 73 to reflect the Linux version
6.1.73 used by the pinned Poky revision.

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

Set repo_url_pattern and meta_arm_url_pattern variables used
for references to repository paths to the correct URLs.

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

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

Pin the the used yocto layers and update the revision
used in the docuementation.

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

Ziad Elhanafy authored Feb 05, 2024 and Diego Sueiro committed Feb 07, 2024

Increase TEST_FVP_LINUX_BOOT_TIMEOUT because increasing the
RSS clock frequency causes the primary compute to slow down
during the linux boot while the RSS is performing the
necessary computations especially in the PSA Crypto use case.

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