1. Output port info need '--verbose' option enabled
2. Update sample lines for the ports info
3. Ports 5000~5003 may be occupied by other programs
4. Fix starting port number to 5000
5. Add -k and --verbose option in command for consistency

Issue-Id: SCM-4502
Signed-off-by: Robbie Cao <robbie.cao@arm.com>
Change-Id: I9d6bbbd498b13077c29ae04e133bcb77670bb4e4

If there are multiple runfvp instances running, default ports
(5001~5003) will automatically increase by 4.Add descriptions for this
case in User Manual.
And fix typo as well.

Issue-Id: SCM-4502
Signed-off-by: Robbie Cao <robbie.cao@arm.com>
Change-Id: I1e63ccfe2cc0ee065891b9ed86508d2a56114faa

Robbie Cao authored Jun 23, 2022 and Diego Sueiro committed Jun 23, 2022

* Introduce the "meta-armv8r64-extras/kas/release/v4.0.yml"
* Have the "meta-armv8r64-extras/kas/include/base.yml" including the
  file above
* Update the "documentation/user-guide/reproduce.rst" to "git clone
  https://gitlab.arm.com/automotive-and-industrial/v8r64

 -b v4.0"
* Update the "documentation/changelog.rst" listing all the dependent
  layers for this release

Issue-Id: SCM-4268
Signed-off-by: Robbie Cao <robbie.cao@arm.com>
Change-Id: I63332b9ca26b5fd4f4917660763983e191a60640

Also, only included the layers when required by specific kas config files.

Issue-Id: SCM-4388
Signed-off-by: Diego Sueiro <diego.sueiro@arm.com>
Change-Id: I91c5482df619d236b04aab1e2fe98960dbb9d7a8

README.md will work as the project's portal with necessary info:
- Project information
- Link to the online documentation
- How to build local version documentation
- Repository license
- Contact

Issue-Id: SCM-4372
Signed-off-by: Robbie Cao <robbie.cao@arm.com>
Change-Id: Ia7c2f18dc16a940a66b240653d39fffb6159e722

As "dom0less" is a new set of features for Xen, some of which are still
being developed in the Xen community, there are some limitations in a
"dom0less" Linux domain. Power Management is a specific example.

Issue-Id: SCM-4372
Signed-off-by: Robbie Cao <robbie.cao@arm.com>
Change-Id: Ia541d1c78b7c317c12d0681db7501d615865156e

 * Add note to release 4.0 changelog
 * Update link to user mode networking page in FVP docs

Issue-Id: SCM-4388
Signed-off-by: Peter Hoyes <Peter.Hoyes@arm.com>
Change-Id: I64a119a95a3aeec679faac84d47ea232276b8c83

Jiamei Xie authored May 25, 2022 and Diego Sueiro committed Jun 22, 2022

As FVP 11.18 has fixed the secure hypervisor timer interrupt issue for
FVP_BaseR_AEMv8R, CONFIG_SECURE_HYP_TIMER_WORKAROUND can be removed.

Issue-Id: SCM-4596
Signed-off-by: Jiamei Xie <jiamei.xie@arm.com>
Change-Id: I9454bed4a79232c02dff672456db873820d87756

1. Add empty line to make image not too packed
2. Update armv8r64 yocto layer diagram
3. Consistent term on Armv8-R
4. Update EULA link
5. Add description to the entries in User Guide landing page

Signed-off-by: Robbie Cao <robbie.cao@arm.com>
Change-Id: I6375216b68975ccd6a09f39b29231c1ef605ee8d
Issue-Id: SCM-4371

Issue-Id: SCM-4371
Change-Id: If169929fcc5668a669e0acebdaef897b67bef754
Signed-off-by: Qi Feng <qi.feng@arm.com>
Signed-off-by: Peter Hoyes <Peter.Hoyes@arm.com>

Signed-off-by: Qi Feng <qi.feng@arm.com>
Issue-Id: SCM-4371
Change-Id: I91e978f9dea7aae6c8d1b0951ec2d1e13983d41f

1. Add description to validate Zephyr and output example
2. Rearrange the steps to validate Linux and add output example

Issue-Id: SCM-4371
Signed-off-by: Robbie Cao <robbie.cao@arm.com>
Change-Id: I6a6d14493072c3c0f388bbde3286db0861b9bf8f

Issue-Id: SCM-4371
Signed-off-by: Robbie Cao <robbie.cao@arm.com>
Change-Id: I9259b40711202d4d1ac46de790dcb734b10de8e2

Also update documentation, including pinning links to the "latest"
documentation to 3.1.0

Issue-Id: SCM-4304
Signed-off-by: Peter Hoyes <Peter.Hoyes@arm.com>
Change-Id: I7f3032b0b4722270962b5da89b28111a3239520d

Issue-Id: SCM-4371
Change-Id: I0d4d3d7a5ebfaec67d3622969a1c93feef4ae4aa
Signed-off-by: Qi Feng <qi.feng@arm.com>

Issue-Id: SCM-4371
Change-Id: Ic94bb7298bb5ebb6b4b8d0b0b4bdbaf8207af0c1
Signed-off-by: Qi Feng <qi.feng@arm.com>

Issue-Id: SCM-4371
Change-Id: I031f373e84d87859b6d4c71194c37656f1c94aa3
Signed-off-by: Qi Feng <qi.feng@arm.com>

Issue-Id: SCM-4371
Change-Id: Iad796678e0183d53715e67907c909dd4e6b581ff
Signed-off-by: Qi Feng <qi.feng@arm.com>

Add a standalone recipe to generate the U-Boot boot script for Xen
dom0less instead of the bbappend and bbclass. This recipe calls mkimage
directly, instead of relying on do_compile in the U-Boot recipe in
OE-core.

Make xen_dom0less_image.bbclass depend on the new recipe, instead of
U-Boot itself. This ensures that the firmware is not recompiled after
modifying the configuration of the Xen dom0less stack.

Issue-Id: SCM-4304
Signed-off-by: Peter Hoyes <Peter.Hoyes@arm.com>
Change-Id: I865d049a9ef514fcf0ccbf051fd98ab06de1805d

The zephyr repository contains 3 "classic" sample applications which are
intended to run on all boards - hello_world, synchronization and
philosophers.

The first two are already supported in meta-armv8r64-extras, but there
was previously a defect related to use of the GIC in the Xen MPU branch
which prevented philosophers from working.

This has now been fixed (and the SRCREV updated in a previous patch), so
add a recipe for zephyr-philosophers.

zephyr-philosophers only supports running on a single-core, so force
ZEPHYR_NUM_CPUS to 1.

Issue-Id: SCM-4697
Signed-off-by: Peter Hoyes <Peter.Hoyes@arm.com>
Change-Id: I126eead7f43cfd4772634a0de7bf8f4f27179991

This patch makes the number of CPUs used by Zephyr applications
configurable using the variable ZEPHYR_NUM_CPUS.

This affects the CONFIG_MP_NUM_CPUS Zephyr config flag, as well as the
cluster0.NUM_CORES parameter of the FVP.

For the fvp-baser-aemv8r64, the Zephyr repository contains separate SMP
and non-SMP defconfig files. Move the Zephyr machine configuration from
the machine conf file to the bbappend so this can be modified on a
per-app basis. Dynamically set ZEPHYR_BOARD based on ZEPHYR_NUM_CPUS.

Issue-Id: SCM-4697
Signed-off-by: Peter Hoyes <Peter.Hoyes@arm.com>
Change-Id: Icf82cca4fbe4c8b082479b1c6ab6a54f44507f44

The Zephyr 3.0.x release branch now contains all the backports, so
switch to that branch and remove the downstream patches.

Issue-Id: SCM-4304
Signed-off-by: Peter Hoyes <Peter.Hoyes@arm.com>
Change-Id: Icedc6d814269cb0e731d8464086df26b6242b7b5

Update fvp-baser-aemv8r64 SRCREV to include two commits have been added
to the integration/mpu branch:
 * A fix to remove allocations from the first context switch.
 * A fix to ensure that guests correctly detect the active GIC.

Issue-Id: SCM-4387
Signed-off-by: Peter Hoyes <Peter.Hoyes@arm.com>
Change-Id: Id0389d7dfe5502ad6ef753c6d21761a5ece52098

Add additional documentation on the domain configuration variables and
their varflags.

Convert required_dom_varflags to a Bitbake variable.

Remove a reference to internal documentation.

Issue-Id: SCM-4387
Signed-off-by: Peter Hoyes <Peter.Hoyes@arm.com>
Change-Id: I5ba8300e6bba2c0934acf9cd4e5b4c59cf863493

Peter Hoyes authored May 12, 2022 and Diego Sueiro committed May 13, 2022

Address issues raised by the python, shell and license QA checks.

Issue-Id: SCM-4386
Signed-off-by: Peter Hoyes <Peter.Hoyes@arm.com>
Change-Id: I013dd212a6072fe4277b6040ac58cc07f2ea8848

Issue-Id: SCM-4254
Signed-off-by: Robbie Cao <robbie.cao@arm.com>
Change-Id: I6c957d0a9b8475446567bd09093e7f6dda04ac51

Shebang needs to be in the first line of the file.

Issue-Id: SCM-4357
Signed-off-by: Robbie Cao <robbie.cao@arm.com>
Change-Id: Ic3b903d4c84edf0b01ad3496f297c97ac823f035

The Zephyr implemention has only been tested and validated on the
fvp-baser-aemv8r64 MACHINE, so set COMPATIBLE_MACHINE to "invalid" in
zephyr-base.inc and override in the machine-specific include.

Issue-Id: SCM-4386
Signed-off-by: Peter Hoyes <Peter.Hoyes@arm.com>
Change-Id: Idcbb1b83a3944b14c0692546892f162b4e77f778

tests.yml contains the Kas configuration for test suites. It works as an
additional configuration can be included, examples:

    kas build baremetal-linux.yml:tests.yml
    kas build virtualization.yml:tests.yml

Issue-Id: SCM-4357
Signed-off-by: Robbie Cao <robbie.cao@arm.com>
Change-Id: I72b2f95c7ea459513e5469fe6dd1c8a97f55ec3f

Basic test cases are based on bats and include 2 categories:

- network
- SMP

The tests can be included in the build by appending 'refstack-tests'
to the build configuration's DISTRO_FEATURES.

Issue-Id: SCM-4357
Signed-off-by: Robbie Cao <robbie.cao@arm.com>
Change-Id: Ibec136d75f82833917215559dee67b7544eafb49

sysinfo: check system information, e.g. kernel version, hostname.

Issue-Id: SCM-4357
Signed-off-by: Robbie Cao <robbie.cao@arm.com>
Change-Id: I841b70db9b1f31fdf2346ba1b2082ee1ada6379c

To make it easier to make simple changes to the virtualization
stack, expose the following environment variables through the Kas
configuration:
 * XEN_DOM0LESS_DOMAINS, so the list of domains can be configured.
 * XEN_DOM0LESS_LINUX_IMAGE, so the included Linux image can be
   configured.
 * XEN_DOM0LESS_ZEPHYR_APPLICATION, so the included Zephyr application
   can be configured.

Issue-Id: SCM-4387
Signed-off-by: Peter Hoyes <Peter.Hoyes@arm.com>
Change-Id: I11a229963bb1fc37591d11b6a85b904f43a4a0e0

The kirkstone branch has now been created in meta-virtualization, so
remove the refspec master override in virtualization.yml

Issue-Id: SCM-4386
Signed-off-by: Peter Hoyes <Peter.Hoyes@arm.com>
Change-Id: Id70f0d94fd4f8540e930f15a31aa8d0c7cf8c7de

bsp.yml contains the Kas configuration migrated from meta-arm, which
contains both bsp- and non-bsp-specific configuration. It is only
included from base.yml, so to avoid confusion merge it into base.yml
and remove the include.

Issue-Id: SCM-4386
Signed-off-by: Peter Hoyes <Peter.Hoyes@arm.com>
Change-Id: Iece1bc92d89fd1e73866f8e4ae5bb47f082006ed

There is a bug in Kas which means that a repo URL cannot be overridden
(e.g. to use an internal mirror) if the original repo definition is a
local layer. Therefore migrate the contents of
kas/fvp-baser-aemv8r64-bsp.yml in meta-arm to
meta-armv8r64-extras/kas/include/bsp.yml

Issue-Id: SCM-4386
Signed-off-by: Peter Hoyes <Peter.Hoyes@arm.com>
Change-Id: I184ddade69b712f8709e81ea56c64baf56936806

The kirkstone branch has now been created in meta-arm, so the master
override is no longer needed.

Issue-Id: SCM-4386
Signed-off-by: Peter Hoyes <Peter.Hoyes@arm.com>
Change-Id: Ib4cd88aa7264a42ea6ed27d2140ec062b638fe18

Add configuration for a Zephyr domain to xen_dom0less_config.bbclass

Add the Zephyr passthrough device tree to xen-dom0less-devicetree.

Issue-Id: SCM-4386
Signed-off-by: Peter Hoyes <Peter.Hoyes@arm.com>
Change-Id: I79b9a3ec1b37b46caac85326ff6cb7bace6d1cec

Zephyr requires some specific configuration when running on Xen on the
fvp-baser-aemv8r64. It is necessary to disable Zephyr's S-EL2 SMP logic
and define the number of CPUS allocated (to match the domain
configuration).

It is also necessary to match the DRAM and UART configuration in the
device tree using the domain configuration.

Apply the above using overlays in a Xen-and-machine-specific bbappend.

Issue-Id: SCM-4386
Signed-off-by: Peter Hoyes <Peter.Hoyes@arm.com>
Change-Id: I575c68cf65011b27d18926618f0e44b7bb044e7a

Create a helper recipe which builds the linked image defined in
XEN_DOM0LESS_LINUX_IMAGE and its dependencies.

Set IMAGE_LINK_NAME to the same name in xen_dom0less_image.bbclass

Make this recipe the target of the virtualization Kas file.

Issue-Id: SCM-4386
Signed-off-by: Peter Hoyes <Peter.Hoyes@arm.com>
Change-Id: I0d40cb35db6788c5ff80a7cedfa9de17ff0de307

Modify xen_dom0less_image.bbclass to dynamically add the Xen binaries
and passthrough device trees to the boot partition.

In xen_dom0less_uboot_script.bbclass, re-use xen_dom0less_template to
turn the boot script into a boot script template. Dynamically generate
boot script commands to load the Xen binaries and passthrough device
trees at boot.

Issue-Id: SCM-4386
Signed-off-by: Peter Hoyes <Peter.Hoyes@arm.com>
Change-Id: I1a4a5f5328f9762dfc3650a172f2d29ea8fb0b0b