[PATCH 1/2] kas: Add fvp-baser-aemv8r64 BSP evaluation build

[PATCH 1/2] kas: Add fvp-baser-aemv8r64 BSP evaluation build

[Diego Sueiro]

The kas/fvp-baser-aemv8r64-bsp.yml is intended to be used as an evaluation
build for the BSP components.

Signed-off-by: Diego Sueiro <diego.sueiro@arm.com>
Change-Id: Idce501224f4c8fbd6c53dc318db73dcd3100b57b
---
 kas/fvp-baser-aemv8r64-bsp.yml | 32 ++++++++++++++++++++++++++++++++
 1 file changed, 32 insertions(+)
 create mode 100644 kas/fvp-baser-aemv8r64-bsp.yml

diff --git a/kas/fvp-baser-aemv8r64-bsp.yml b/kas/fvp-baser-aemv8r64-bsp.yml
new file mode 100644
index 0000000..b08e1a9
--- /dev/null
+++ b/kas/fvp-baser-aemv8r64-bsp.yml
@@ -0,0 +1,32 @@
+header:
+  version: 9
+
+distro: poky
+machine: fvp-baser-aemv8r64
+
+defaults:
+  repos:
+    refspec: hardknott
+
+repos:
+  meta-arm:
+    layers:
+      meta-arm:
+      meta-arm-bsp:
+      meta-arm-toolchain:
+
+  poky:
+    url: https://git.yoctoproject.org/git/poky
+    layers:
+      meta:
+      meta-poky:
+
+local_conf_header:
+  base: |
+    CONF_VERSION = "1"
+    PACKAGE_CLASSES = "package_ipk"
+    PACKAGECONFIG_remove_pn-qemu-system-native = "gtk+ sdl"
+    EXTRA_IMAGE_FEATURES_append = " debug-tweaks"
+
+target:
+  - core-image-minimal
-- 
2.17.1

[PATCH 2/2] arm-bsp/docs: Updated documentation fvp-baser-aemv8r64 MACHINE

[Diego Sueiro]

Added quickstart instructions on how to build a BSP evaluation image using kas.
Updated FVP naming convention as well as information about where to download
and how to run the FVP.

Signed-off-by: Diego Sueiro <diego.sueiro@arm.com>
Change-Id: Ia6056194ed23d6e38769a3e300eadf77fc41beb2
---
 .../documentation/fvp-baser-aemv8r64.md       | 49 +++++++++++--------
 1 file changed, 29 insertions(+), 20 deletions(-)

diff --git a/meta-arm-bsp/documentation/fvp-baser-aemv8r64.md b/meta-arm-bsp/documentation/fvp-baser-aemv8r64.md
index 9701739..18a01af 100644
--- a/meta-arm-bsp/documentation/fvp-baser-aemv8r64.md
+++ b/meta-arm-bsp/documentation/fvp-baser-aemv8r64.md
@@ -1,4 +1,4 @@
-# AEM Armv8-R64 BaseR Platform FVP Support in meta-arm-bsp
+# Armv8-R AArch64 AEM FVP Support in meta-arm-bsp
 
 ## Overview
 Fixed Virtual Platforms (FVP) are complete simulations of an Arm system,
@@ -6,8 +6,8 @@ including processor, memory and peripherals. These are set out in a
 "programmer's view", which gives you a comprehensive model on which to build
 and test your software.
 
-The AEMv8-R BaseR Platform FVP is the Fixed Virtual Platform of the latest
-Armv8-R architecture features.
+The Armv8-R AEM FVP is a free of charge Armv8-R Fixed Virtual Platform. It
+supports the latest Armv8-R feature set.
 
 This BSP implements a reference stack for the AArch64 support in the R-class
 first announced with the Cortex-R82 processor:
@@ -17,38 +17,45 @@ Fast Models Fixed Virtual Platforms (FVP) Reference Guide:
 https://developer.arm.com/docs/100966/latest
 
 ## BSP Support
-Supported components:
+The fvp-baser-aemv8r64 Yocto MACHINE supports the following BSP components:
 
  - boot-wrapper-aarch64
  - Kernel: linux-yocto-5.10
 
-## Howto Build and Run
+## Quick start: Howto Build and Run
 
-### Configuration:
-In the local.conf file, MACHINE should be set as follow:
-`MACHINE ?= "fvp-baser-aemv8r64"`
+### Host environment setup
+Install the Required Packages for the Build Host:
+https://www.yoctoproject.org/docs/latest/mega-manual/mega-manual.html#required-packages-for-the-build-host
 
-If a quicker boot is required add the following line in the local.conf:
-`INIT_MANAGER = "mdev-busybox"`
+Install the kas setup tool for bitbake based projects:
+https://kas.readthedocs.io/en/latest/userguide.html#dependencies-installation
 
-### Build:
+### Fetch sources
+Fetch meta-arm repository:
 ```
-bitbake core-image-minimal
+mkdir -p ~/fvp-baser-aemv8r64-bsp
+cd ~/fvp-baser-aemv8r64-bsp
+git clone https://git.yoctoproject.org/git/meta-arm
 ```
 
-### Run:
+### Build
+```
+cd ~/fvp-baser-aemv8r64-bsp
+kas build meta-arm/kas/fvp-baser-aemv8r64-bsp.yml
+```
+
+### Run
 To Run the Fixed Virtual Platform simulation tool you must download "Armv8-R
-BaseR AEM FVP" from Arm developer (This might require the user to
-register) from this address:
+AEM FVP" from Arm developer (This might require the user to register) from this
+address:
 https://developer.arm.com/tools-and-software/simulation-models/fixed-virtual-platforms/arm-ecosystem-models
 and install it on your host PC.
-**DISCLAIMER:** The AEMv8-R BaseR Platform FVP package will be available for
-download soon.
 
-Once the build is done, do the following run an image:
+To run an image after the build is done:
 ```
-export YOCTO_DEPLOY_IMGS_DIR="<yocto-build-dir/tmp/deploy/images/fvp-baser-aemv8r64>"
-cd <path-to-FVP_BaseR_AEMv8R_pkg-dir/models/Linux64_GCC-X.X/>
+export YOCTO_DEPLOY_IMGS_DIR="~/fvp-baser-aemv8r64-bsp/build/tmp/deploy/images/fvp-baser-aemv8r64/"
+cd <path-to-AEMv8R_base_pkg>/models/Linux64_GCC-6.4/
 ./FVP_BaseR_AEMv8R \
 -C bp.dram_metadata.init_value=0 \
 -C bp.dram_metadata.is_enabled=true \
@@ -82,6 +89,8 @@ cd <path-to-FVP_BaseR_AEMv8R_pkg-dir/models/Linux64_GCC-X.X/>
 -C bp.virtioblockdevice.image_path=${YOCTO_DEPLOY_IMGS_DIR}/core-image-minimal-fvp-baser-aemv8r64.wic
 ```
 
+The terminal console login is `root` without password.
+
 ## Devices supported in the kernel
 - serial
 - virtio disk
-- 
2.17.1