arm-bsp/fvp-baser-aemv8r64: Update documentation

Add information about PSCI support as well as known issues and limitations.

Also, update the fvp-baser-aemv8r64 kas config file to fetch the layers under
the layers directory and pin poky to a stable build revision.

Issue-Id: SCM-2989
Signed-off-by: Diego Sueiro <diego.sueiro@arm.com>
Change-Id: I8e2b30ba708f6ff7fdf43f29eede0e65aa3685ca
Signed-off-by: Jon Mason <jon.mason@arm.com>

kas/fvp-baser-aemv8r64-bsp.yml

@@ -10,6 +10,8 @@ defaults:
 
 repos:
   meta-arm:
+    url: https://git.yoctoproject.org/git/meta-arm
+    path: layers/meta-arm
     layers:
       meta-arm:
       meta-arm-bsp:
@@ -17,6 +19,8 @@ repos:
 
   poky:
     url: https://git.yoctoproject.org/git/poky
+    path: layers/poky
+    refspec: 1e2e9a84d6dd81d7f6dd69c0d119d0149d10ade1
     layers:
       meta:
       meta-poky:

kas/fvp-baser-aemv8r64-rt-bsp.yml

@@ -4,5 +4,5 @@ header:
     - fvp-baser-aemv8r64-bsp.yml
 
 local_conf_header:
-  base: |
+  base-rt: |
     PREFERRED_PROVIDER_virtual/kernel = "linux-yocto-rt"

meta-arm-bsp/documentation/fvp-baser-aemv8r64.md

@@ -27,7 +27,7 @@ The fvp-baser-aemv8r64 Yocto MACHINE supports the following BSP components,
 where either a standard or Real-Time Linux kernel (PREEMPT\_RT) can be built
 and run:
 
- - boot-wrapper-aarch64
+ - boot-wrapper-aarch64: provides PSCI support
  - Linux kernel: linux-yocto-5.10
  - Linux kernel with PREEMPT\_RT support: linux-yocto-rt-5.10
 
@@ -81,11 +81,15 @@ Fetch the meta-arm repository into a build directory:
 Building with the standard Linux kernel:
 
     cd ~/fvp-baser-aemv8r64-build
+    FVP_BASE_R_AEM_TARBALL_URI="file:///absolute/path/to/FVP_Base_AEMv8R_11.15_14.tgz" \
+    FVP_BASE_R_ARM_EULA_ACCEPT="True" \
     kas build meta-arm/kas/fvp-baser-aemv8r64-bsp.yml
 
 Building with the Real-Time Linux kernel (PREEMPT\_RT):
 
     cd ~/fvp-baser-aemv8r64-build
+    FVP_BASE_R_AEM_TARBALL_URI="file:///absolute/path/to/FVP_Base_AEMv8R_11.15_14.tgz" \
+    FVP_BASE_R_ARM_EULA_ACCEPT="True" \
     kas build meta-arm/kas/fvp-baser-aemv8r64-rt-bsp.yml
 
 ### Networking
@@ -121,7 +125,7 @@ To run an image after the build is done with the standard Linux kernel:
 
     kas shell --keep-config-unchanged \
        meta-arm/kas/fvp-baser-aemv8r64-bsp.yml \
-           --command "../meta-arm/scripts/runfvp \
+           --command "../layers/meta-arm/scripts/runfvp \
                 --console \
                 -- \
                     --parameter 'bp.smsc_91c111.enabled=1' \
@@ -132,7 +136,7 @@ To run an image after the build is done with the Real-Time Linux kernel
 
     kas shell --keep-config-unchanged \
        meta-arm/kas/fvp-baser-aemv8r64-rt-bsp.yml \
-           --command "../meta-arm/scripts/runfvp \
+           --command "../layers/meta-arm/scripts/runfvp \
                 --console \
                 -- \
                     --parameter 'bp.smsc_91c111.enabled=1' \
@@ -178,3 +182,10 @@ Devices supported in the kernel
 - virtio network
 - watchdog
 - rtc
+
+Known Issues and Limitations
+----------------------------
+
+- Only PSCI CPU\_ON and CPU\_OFF functions are supported
+- Booting Linux kernel from Secure EL2 is not supported on Armv8-R AArch64
+- Both VHE and non-VHE Linux-KVM are not supported on Armv8-R AArch64