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

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

[Filipe Rinaldi]

From: Filipe Rinaldi <filipe.rinaldi@arm.com>

This update has mainly format related changes (no functional changes) to
improve readability when reading the non-rendered version of it.
- Use underlined style for headers level 1 and 2
- Use indentation to create blocks
- Use double space at the end of each section
- Add indentation to the FVP parameters
- Add pip command to install the kas tool

Signed-off-by: Filipe Rinaldi <filipe.rinaldi@arm.com>
Change-Id: I9d4b4dbcef6dc13638b62563ebdf90b6b9d5b686
---
 .../documentation/fvp-baser-aemv8r64.md       | 166 ++++++++++--------
 1 file changed, 91 insertions(+), 75 deletions(-)

diff --git a/meta-arm-bsp/documentation/fvp-baser-aemv8r64.md b/meta-arm-bsp/documentation/fvp-baser-aemv8r64.md
index 439e0f3..c091f15 100644
--- a/meta-arm-bsp/documentation/fvp-baser-aemv8r64.md
+++ b/meta-arm-bsp/documentation/fvp-baser-aemv8r64.md
@@ -1,6 +1,9 @@
-# Armv8-R AArch64 AEM FVP Support in meta-arm-bsp
+Armv8-R AArch64 AEM FVP Support in meta-arm-bsp
+===============================================
+
+Overview
+--------
 
-## Overview
 Fixed Virtual Platforms (FVP) are complete simulations of an Arm system,
 including processor, memory and peripherals. These are set out in a
 "programmer's view", which gives you a comprehensive model on which to build
@@ -16,7 +19,10 @@ https://developer.arm.com/ip-products/processors/cortex-r/cortex-r82
 Fast Models Fixed Virtual Platforms (FVP) Reference Guide:
 https://developer.arm.com/docs/100966/latest
 
-## BSP Support
+
+BSP Support
+-----------
+
 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:
@@ -28,36 +34,40 @@ and run:
 Note that the Real-Time Linux kernel (PREEMPT\_RT) does not use the real-time
 architectural extensions of the Armv8-R feature set.
 
-## Quick start: Howto Build and Run
+
+Quick start: Howto Build and Run
+--------------------------------
 
 ### Host environment setup
-Install the Required Packages for the Build Host:
+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
 
 Install the kas setup tool for bitbake based projects:
-https://kas.readthedocs.io/en/latest/userguide.html#dependencies-installation
+
+    pip3 install --user kas
+
+For more details on kas, see https://kas.readthedocs.io/.
+
 
 ### Fetch sources
 Fetch the meta-arm repository into a build directory:
-```
-mkdir -p ~/fvp-baser-aemv8r64-build
-cd ~/fvp-baser-aemv8r64-build
-git clone https://git.yoctoproject.org/git/meta-arm
-```
 
-### Build
+    mkdir -p ~/fvp-baser-aemv8r64-build
+    cd ~/fvp-baser-aemv8r64-build
+    git clone https://git.yoctoproject.org/git/meta-arm
+
 
+### Build
 Building with the standard Linux kernel:
-```
-cd ~/fvp-baser-aemv8r64-build
-kas build meta-arm/kas/fvp-baser-aemv8r64-bsp.yml
-```
+
+    cd ~/fvp-baser-aemv8r64-build
+    kas build meta-arm/kas/fvp-baser-aemv8r64-bsp.yml
 
 Building with the Real-Time Linux kernel (PREEMPT\_RT):
-```
-cd ~/fvp-baser-aemv8r64-build
-kas build meta-arm/kas/fvp-baser-aemv8r64-rt-bsp.yml
-```
+
+    cd ~/fvp-baser-aemv8r64-build
+    kas build meta-arm/kas/fvp-baser-aemv8r64-rt-bsp.yml
+
 
 ### Run
 To Run the Fixed Virtual Platform simulation tool you must download "Armv8-R
@@ -67,71 +77,77 @@ https://developer.arm.com/tools-and-software/simulation-models/fixed-virtual-pla
 and install it on your host PC.
 
 To run an image after the build is done:
-```
-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 \
--C bp.dram_size=8 \
--C bp.exclusive_monitor.monitor_access_level=1 \
--C bp.pl011_uart0.unbuffered_output=1 \
--C bp.pl011_uart0.untimed_fifos=true \
--C bp.refcounter.non_arch_start_at_default=1 \
--C bp.smsc_91c111.enabled=0 \
--C bp.ve_sysregs.mmbSiteDefault=0 \
--C cache_state_modelled=true \
--C cluster0.gicv3.cpuintf-mmap-access-level=2 \
--C cluster0.gicv3.SRE-enable-action-on-mmap=2 \
--C cluster0.gicv3.SRE-EL2-enable-RAO=1 \
--C cluster0.gicv3.extended-interrupt-range-support=1 \
--C cluster0.has_aarch64=1 \
--C cluster0.NUM_CORES=4 \
--C cluster0.stage12_tlb_size=512 \
--C gic_distributor.GICD_CTLR-DS-1-means-secure-only=1 \
--C gic_distributor.GITS_BASER0-type=1 \
--C gic_distributor.ITS-count=1 \
--C gic_distributor.ITS-hardware-collection-count=1 \
--C gic_distributor.direct-lpi-support=1 \
--C gic_distributor.has-two-security-states=0 \
--C pctl.startup=0.0.0.* \
--C bp.virtio_net.enabled=1 \
--C cache_state_modelled=0 \
--C bp.vis.rate_limit-enable=0 \
--C bp.virtio_net.hostbridge.interfaceName=tap0 \
--a cluster0*=${YOCTO_DEPLOY_IMGS_DIR}/linux-system.axf \
--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
+
+    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 \
+        -C bp.dram_size=8 \
+        -C bp.exclusive_monitor.monitor_access_level=1 \
+        -C bp.pl011_uart0.unbuffered_output=1 \
+        -C bp.pl011_uart0.untimed_fifos=true \
+        -C bp.refcounter.non_arch_start_at_default=1 \
+        -C bp.smsc_91c111.enabled=0 \
+        -C bp.ve_sysregs.mmbSiteDefault=0 \
+        -C cache_state_modelled=true \
+        -C cluster0.gicv3.cpuintf-mmap-access-level=2 \
+        -C cluster0.gicv3.SRE-enable-action-on-mmap=2 \
+        -C cluster0.gicv3.SRE-EL2-enable-RAO=1 \
+        -C cluster0.gicv3.extended-interrupt-range-support=1 \
+        -C cluster0.has_aarch64=1 \
+        -C cluster0.NUM_CORES=4 \
+        -C cluster0.stage12_tlb_size=512 \
+        -C gic_distributor.GICD_CTLR-DS-1-means-secure-only=1 \
+        -C gic_distributor.GITS_BASER0-type=1 \
+        -C gic_distributor.ITS-count=1 \
+        -C gic_distributor.ITS-hardware-collection-count=1 \
+        -C gic_distributor.direct-lpi-support=1 \
+        -C gic_distributor.has-two-security-states=0 \
+        -C pctl.startup=0.0.0.* \
+        -C bp.virtio_net.enabled=1 \
+        -C cache_state_modelled=0 \
+        -C bp.vis.rate_limit-enable=0 \
+        -C bp.virtio_net.hostbridge.interfaceName=tap0 \
+        -a cluster0*=${YOCTO_DEPLOY_IMGS_DIR}/linux-system.axf \
+        -C bp.virtioblockdevice.image_path=${YOCTO_DEPLOY_IMGS_DIR}/core-image-minimal-fvp-baser-aemv8r64.wic
+
+**Note:** The terminal console login is `root` without password.
+
+
+Devices supported in the kernel
+-------------------------------
+
 - serial
 - virtio disk
 - virtio network
 - watchdog
 - rtc
 
-## Devices not supported or not functional
+
+Devices not supported or not functional
+---------------------------------------
+
 - Only one CPU since SMP is not functional in boot-wrapper-aarch64 yet
 
-## Networking
+
+Networking
+----------
 
 To enable networking on the FVP via a host network interface, set up tap0 using
 the following commands (Ubuntu 18.04 Host):
-```
-sudo apt-get install libvirt-bin
-sudo virsh net-start default
-sudo ip tuntap add dev tap0 mode tap user $(whoami)
-sudo ifconfig tap0 0.0.0.0 promisc up
-sudo brctl addif virbr0 tap0
-```
+
+    sudo apt-get install libvirt-bin
+    sudo virsh net-start default
+    sudo ip tuntap add dev tap0 mode tap user $(whoami)
+    sudo ifconfig tap0 0.0.0.0 promisc up
+    sudo brctl addif virbr0 tap0
+
 
 To clean up the tap0 interface on the host use the following commands:
-```
-sudo brctl delif virbr0 tap0
-sudo ip link set virbr0 down
-sudo brctl delbr virbr0
-sudo virsh net-destroy default
-sudo ip link delete tap0
-```
+
+    sudo brctl delif virbr0 tap0
+    sudo ip link set virbr0 down
+    sudo brctl delbr virbr0
+    sudo virsh net-destroy default
+    sudo ip link delete tap0
-- 
2.30.1 (Apple Git-130)