* [PATCH hardknott 1/2] arm-bsp/docs: Updated documentation fvp-baser-aemv8r64 MACHINE
@ 2021-05-27 14:29 Hugo L'Hostis
2021-05-27 14:29 ` [PATCH hardknott 2/2] arm-bsp/docs: documentation improvements for fvp-baser-aemv8r64 Hugo L'Hostis
0 siblings, 1 reply; 2+ messages in thread
From: Hugo L'Hostis @ 2021-05-27 14:29 UTC (permalink / raw)
To: meta-arm; +Cc: nd, 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
Issue-Id: SCM-2665
Signed-off-by: Filipe Rinaldi <filipe.rinaldi@arm.com>
Change-Id: I9d4b4dbcef6dc13638b62563ebdf90b6b9d5b686
Signed-off-by: Jon Mason <jon.mason@arm.com>
---
.../documentation/fvp-baser-aemv8r64.md | 160 ++++++++++--------
1 file changed, 89 insertions(+), 71 deletions(-)
diff --git a/meta-arm-bsp/documentation/fvp-baser-aemv8r64.md b/meta-arm-bsp/documentation/fvp-baser-aemv8r64.md
index 18a01af..5034de1 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,34 +19,43 @@ 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:
- boot-wrapper-aarch64
- Kernel: linux-yocto-5.10
-## 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 meta-arm repository:
-```
-mkdir -p ~/fvp-baser-aemv8r64-bsp
-cd ~/fvp-baser-aemv8r64-bsp
-git clone https://git.yoctoproject.org/git/meta-arm
-```
+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
-```
-cd ~/fvp-baser-aemv8r64-bsp
-kas build meta-arm/kas/fvp-baser-aemv8r64-bsp.yml
-```
+Building with the standard Linux kernel:
+
+ cd ~/fvp-baser-aemv8r64-build
+ kas build meta-arm/kas/fvp-baser-aemv8r64-bsp.yml
+
### Run
To Run the Fixed Virtual Platform simulation tool you must download "Armv8-R
@@ -53,71 +65,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.25.1
^ permalink raw reply related [flat|nested] 2+ messages in thread
* [PATCH hardknott 2/2] arm-bsp/docs: documentation improvements for fvp-baser-aemv8r64
2021-05-27 14:29 [PATCH hardknott 1/2] arm-bsp/docs: Updated documentation fvp-baser-aemv8r64 MACHINE Hugo L'Hostis
@ 2021-05-27 14:29 ` Hugo L'Hostis
0 siblings, 0 replies; 2+ messages in thread
From: Hugo L'Hostis @ 2021-05-27 14:29 UTC (permalink / raw)
To: meta-arm; +Cc: nd
This patch updates the documentation for fvp-baser-aemv8r64 :
- Update link to the yocto documentation.
- Add details about what Host OS version are supported. Add Ubuntu
20.04 specific instructions.
- Warn user about disk space.
Issue-Id: SCM-2665
Signed-off-by: Hugo L'Hostis <hugo.lhostis@arm.com>
Change-Id: I37e6bd3ae0a04258743a5bf1dfc80e515078d524
---
.../documentation/fvp-baser-aemv8r64.md | 59 +++++++++++--------
1 file changed, 34 insertions(+), 25 deletions(-)
diff --git a/meta-arm-bsp/documentation/fvp-baser-aemv8r64.md b/meta-arm-bsp/documentation/fvp-baser-aemv8r64.md
index 5034de1..ed6f392 100644
--- a/meta-arm-bsp/documentation/fvp-baser-aemv8r64.md
+++ b/meta-arm-bsp/documentation/fvp-baser-aemv8r64.md
@@ -32,8 +32,11 @@ Quick start: Howto Build and Run
--------------------------------
### Host environment setup
+The following instructions have been tested on hosts running Ubuntu 18.04 and
+Ubuntu 20.04.
+
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
+https://docs.yoctoproject.org/3.3.1/singleindex.html#required-packages-for-the-build-host
Install the kas setup tool for bitbake based projects:
@@ -41,6 +44,8 @@ Install the kas setup tool for bitbake based projects:
For more details on kas, see https://kas.readthedocs.io/.
+**Note:** The host machine should have at least 50 GBytes of free disk space
+for the next steps to work correctly.
### Fetch sources
Fetch the meta-arm repository into a build directory:
@@ -49,13 +54,40 @@ Fetch the meta-arm repository into a build directory:
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
+### Networking
+To enable networking on the FVP via a host network interface, you will need to
+install the following package(s):
+
+**Ubuntu 18.04:**
+
+ sudo apt-get install libvirt-bin
+
+**Ubuntu 20.04:**
+
+ sudo apt-get install libvirt-dev libvirt-daemon qemu-kvm libvirt-daemon-system libvirt-clients bridge-utils
+
+Once that is installed for your OS version, setup tap0 using the following
+commands:
+
+ 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
### Run
To Run the Fixed Virtual Platform simulation tool you must download "Armv8-R
@@ -90,7 +122,6 @@ To run an image after the build is done:
-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 \
@@ -117,25 +148,3 @@ Devices not supported or not functional
---------------------------------------
- Only one CPU since SMP is not functional in boot-wrapper-aarch64 yet
-
-
-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
-
-
-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
--
2.25.1
^ permalink raw reply related [flat|nested] 2+ messages in thread
end of thread, other threads:[~2021-05-27 14:29 UTC | newest]
Thread overview: 2+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2021-05-27 14:29 [PATCH hardknott 1/2] arm-bsp/docs: Updated documentation fvp-baser-aemv8r64 MACHINE Hugo L'Hostis
2021-05-27 14:29 ` [PATCH hardknott 2/2] arm-bsp/docs: documentation improvements for fvp-baser-aemv8r64 Hugo L'Hostis
This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.