1
0
mirror of https://git.yoctoproject.org/meta-arm synced 2026-05-07 04:58:57 +00:00

arm-bsp/docs: documentation improvements for fvp-baser-aemv8r64

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: Ie93a42c2a1ec595707fa7496edbf024650f7eb85
Signed-off-by: Jon Mason <jon.mason@arm.com>
This commit is contained in:
Hugo L'Hostis
2021-05-27 15:21:03 +01:00
committed by Jon Mason
parent 1a46824760
commit 6c857d39a6
@@ -39,8 +39,10 @@ Quick start: Howto Build and Run
-------------------------------- --------------------------------
### Host environment setup ### 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: 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/singleindex.html#required-packages-for-the-build-host
Install the kas setup tool for bitbake based projects: Install the kas setup tool for bitbake based projects:
@@ -48,6 +50,8 @@ Install the kas setup tool for bitbake based projects:
For more details on kas, see https://kas.readthedocs.io/. 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 sources
Fetch the meta-arm repository into a build directory: Fetch the meta-arm repository into a build directory:
@@ -68,6 +72,33 @@ Building with the Real-Time Linux kernel (PREEMPT\_RT):
cd ~/fvp-baser-aemv8r64-build cd ~/fvp-baser-aemv8r64-build
kas build meta-arm/kas/fvp-baser-aemv8r64-rt-bsp.yml kas build meta-arm/kas/fvp-baser-aemv8r64-rt-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 ### Run
To Run the Fixed Virtual Platform simulation tool you must download "Armv8-R To Run the Fixed Virtual Platform simulation tool you must download "Armv8-R
@@ -102,7 +133,6 @@ To run an image after the build is done:
-C gic_distributor.GITS_BASER0-type=1 \ -C gic_distributor.GITS_BASER0-type=1 \
-C gic_distributor.ITS-count=1 \ -C gic_distributor.ITS-count=1 \
-C gic_distributor.ITS-hardware-collection-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 gic_distributor.has-two-security-states=0 \
-C pctl.startup=0.0.0.* \ -C pctl.startup=0.0.0.* \
-C bp.virtio_net.enabled=1 \ -C bp.virtio_net.enabled=1 \
@@ -130,24 +160,3 @@ Devices not supported or not functional
- Only one CPU since SMP is not functional in boot-wrapper-aarch64 yet - 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