Signed-off-by: Peter Hoyes <Peter.Hoyes@arm.com>

Robbie Cao authored Jun 21, 2023 and Peter Hoyes committed Jun 27, 2023

Major changes:

* For Debian installation, add steps after doing the GRUB workaround

* Add descriptions for finishing the installation and rebooting the
  installed Debian

Signed-off-by: Robbie Cao <robbie.cao@arm.com>
Signed-off-by: Ziad Elhanafy <ziad.elhanafy@arm.com>

The Kronos Reference Stack has only currently been tested directly in
a non-headless desktop environment so clarify the System Requirements
to this effect and add a note to the Limitations in the Changelog.

Increase the free disk space requirement to 300GiB to account for Linux
Distribution Installation.

Signed-off-by: Peter Hoyes <Peter.Hoyes@arm.com>

Add a short section on the HIPC Demo to the "Run" section of the
Reproduce page.

Add a link back to the Use-Cases from the "Reproducing the Use-Cases"
section.

Signed-off-by: Peter Hoyes <Peter.Hoyes@arm.com>

Introduce a list of use-cases in a new section near the top of the
Introduction page.

Update links on other pages to point to either the Use-Cases or the
Overview.

Signed-off-by: Peter Hoyes <Peter.Hoyes@arm.com>

Michael Zhao authored Jun 21, 2023 and Peter Hoyes committed Jun 27, 2023

Signed-off-by: Michael Zhao <michael.zhao@arm.com>

Robbie Cao authored Jun 21, 2023 and Peter Hoyes committed Jun 27, 2023

Signed-off-by: Robbie Cao <robbie.cao@arm.com>

Vineeth Raveendran authored Jun 21, 2023 and Peter Hoyes committed Jun 27, 2023

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

Vineeth Raveendran authored Jun 21, 2023 and Peter Hoyes committed Jun 27, 2023

This commit uses python3 and dependencies from the build sysroot path,
thus eliminating any dependencies on the python packages needed on the
host system.

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

Signed-off-by: Peter Hoyes <Peter.Hoyes@arm.com>

Introduce a variable to conf.py for the SystemReady IR ACS version and
reference it from the SystemReady IR page.

Signed-off-by: Peter Hoyes <Peter.Hoyes@arm.com>

Clarify how U-Boot boots GRUB2, Linux and Xen in the boot process
documentation.

Signed-off-by: Peter Hoyes <Peter.Hoyes@arm.com>

Improve the documentation by refreshing all the diagrams to use the same
styles and color schemes. Additionally, use outlined instead of solid
blocks to improve readability.

Signed-off-by: Diego Sueiro <diego.sueiro@arm.com>
Signed-off-by: Peter Hoyes <Peter.Hoyes@arm.com>

The presentation of "Full Software Reference Stack" alongside
"SystemReady IR Reference Stack" suggests than the "full" stack does not
contain the SystemReady IR-aligned firmware.

Change the second option to "Arm SystemReady IR Firmware Only" to
reflect the fact that it is only building the firmware (plus other
artifacts to support its validation).

Update the documentation to match the above and add more details to
introduce the two top-level build options.

Signed-off-by: Peter Hoyes <Peter.Hoyes@arm.com>

The OEQA SSH runner kills processes that do not output anything after a
timeout period (default 300s). If this timeout occurs, the exit code
will be either 255 (if the SSH process exits cleanly) or 0 (if the SSH
process does not terminate within 5s and has to be killed).

The BATS tests (executed by ptest-runner) contain a lengthly period of
silence while waiting for the DomUs to boot (>300s) so increase the
timeout.

Signed-off-by: Peter Hoyes <Peter.Hoyes@arm.com>

Signed-off-by: Diego Sueiro <diego.sueiro@arm.com>

The Use-Cases section for the Actuation Demo mentions the Virtualization
Architecture but omits some details about how to access the DomU
console.

Label the existing instructions "Baremetal Architecture" and add a short
"Virtualization Architecture" section below, referencing the above.

Signed-off-by: Peter Hoyes <Peter.Hoyes@arm.com>

Signed-off-by: Peter Hoyes <Peter.Hoyes@arm.com>

Arrange the words in dictionary file lexicographically
in ascending order.

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

Peter Hoyes authored Jun 10, 2023 and Diego Sueiro committed Jun 13, 2023

When the rm_work bbclass is used to reduce disk usage, an unwanted
dependency is inserted from domuX-image:do_rm_work on
domuX-image:do_testimage.

To prevent this, explicitly remove testimage from the DomU image
recipes.

Signed-off-by: Peter Hoyes <Peter.Hoyes@arm.com>

Peter Hoyes authored Jun 10, 2023 and Diego Sueiro committed Jun 13, 2023

There isn't currently enough space on the CI host to simultaneously
build all stack variants, so inherit rm_work on CI to conserve disk
space.

Exclude the testimage logs from work removal.

Signed-off-by: Peter Hoyes <Peter.Hoyes@arm.com>

Peter Hoyes authored Jun 09, 2023 and Diego Sueiro committed Jun 13, 2023

Use the BB_PRESSURE_MAX_CPU, BB_PRESSURE_MAX_MEMORY and
BB_PRESSURE_MAX_IO variables to monitor resource usage and prevent
additional jobs running if a threshold is exceeded.

Signed-off-by: Peter Hoyes <Peter.Hoyes@arm.com>

Peter Hoyes authored Jun 08, 2023 and Diego Sueiro committed Jun 13, 2023

24 Gi is proving insufficient for a full, no-cache build so increase to
32 Gi.

Signed-off-by: Peter Hoyes <Peter.Hoyes@arm.com>

Major changes:

* Separate SystemReady IR from Boot Process as a separate section.
* Add Linux distros installation implementation details.
* Add cross links based on the above adjustments.

Signed-off-by: Robbie Cao <robbie.cao@arm.com>

Add more details (include tips and solved problems) to help user to
reproduce Linux distros installation tests.

Signed-off-by: Robbie Cao <robbie.cao@arm.com>

Update the Reproduce section of the user manual: add steps to build and
run SystemReady IR Linux distros installation.

Signed-off-by: Robbie Cao <robbie.cao@arm.com>

Introduce arm-systemready-linux-distros-*.yml for running SystemReady
Linux distros installation tests.

Signed-off-by: Robbie Cao <robbie.cao@arm.com>

Update the Reproduce section of the user manual to match the kas menu
adjustments.

Signed-off-by: Robbie Cao <robbie.cao@arm.com>

Reorganize the Kas menu entries into two groups:

* Full Software Reference Stack
* Arm SystemReady IR Reference Stack

And add the relevant dependencies as well.

Signed-off-by: Robbie Cao <robbie.cao@arm.com>
Signed-off-by: Diego Sueiro <diego.sueiro@arm.com>

Ambroise Vincent authored Jun 12, 2023 and Peter Hoyes committed Jun 12, 2023

Document that there is a known issue with the feature and that
downstream patches are in place.

Signed-off-by: Ambroise Vincent <ambroise.vincent@arm.com>

Ambroise Vincent authored Jun 12, 2023 and Peter Hoyes committed Jun 12, 2023

Add the Zephyr repository URL to conf.py

Signed-off-by: Ambroise Vincent <ambroise.vincent@arm.com>

* Fix link to Xen downstream patches
* Add information about the Linux Kernel downstream patches
* Update U-boot to 2023.01 version

Signed-off-by: Diego Sueiro <diego.sueiro@arm.com>

Signed-off-by: Diego Sueiro <diego.sueiro@arm.com>

Signed-off-by: Diego Sueiro <diego.sueiro@arm.com>

* Set the to at least 32GiB of RAM memory as requirement for
  the Build Host
* Add installation of kas optional dependency

Signed-off-by: Diego Sueiro <diego.sueiro@arm.com>

The Integration page contains information about the Yocto Layers used
to build the Reference Stack.

Signed-off-by: Diego Sueiro <diego.sueiro@arm.com>

Signed-off-by: Diego Sueiro <diego.sueiro@arm.com>

Signed-off-by: Diego Sueiro <diego.sueiro@arm.com>

Also enable the headercheck to run for .svg files and exclude the
public/ directory.

Signed-off-by: Diego Sueiro <diego.sueiro@arm.com>

Peter Hoyes authored Jun 09, 2023 and Peter Hoyes committed Jun 12, 2023

Use the newly-created branch in both the user-facing and CI kas
configuration.

Signed-off-by: Peter Hoyes <Peter.Hoyes@arm.com>