+++ /dev/null
----
-title: Building for virtio
----
-
-Virtio is a standartized interface for implementing virtual I/O devices:
-
-* Russell, Rusty. "virtio: towards a de-facto standard for virtual I/O devices." ACM SIGOPS Operating Systems Review 42.5 (2008): 95-103.
-
-This section describes the steps you need to take to build the AGL demo image
-for virtio "platform". Later, the same image can be run on various emulators or
-hypervisors that provide virtio devices, for example, QEMU aarch64 emulation on
-PC, QEMU/KVM aarch64 virtualization on AGL Reference Hardware, etc.
-
-Below, AGL minimal image and Qt based IVI demo are used as example, but
-similiarly one can run HTML5 based demos, cluster demo, or other AGL images.
-
-## 1. Making Sure Your Build Environment is Correct
-
-The
-"[Initializing Your Build Environment](./3_Initializing_Your_Build_Environment.md)"
-section presented generic information for setting up your build environment
-using the `aglsetup.sh` script.
-If you are building the AGL demo image for virtio platform, you need to specify
-some specific options when you run the script:
-
-```sh
-$ source meta-agl/scripts/aglsetup.sh -m virtio-aarch64 -b build-virtio-aarch64 agl-demo
-```
-
-The "-m" option specifies the "virtio-aarch64" machine.
-
-The "-b" option sets custom build directory instead of default "build".
-
-The "-f" option might be added to override previously available configuration.
-By default, if there were already configuration files in build directory, they
-will not be overriden, as result, aglsetup.sh might not have desired effect.
-
-## 2. Using BitBake
-
-This section shows the `bitbake` command used to build the AGL image.
-
-Start the build using the `bitbake` command.
-
-**AGL minimal image :**
-The target is `agl-image-minimal`.
-
-```sh
-$ bitbake agl-image-minimal
-```
-
-**Qt Based IVI demo :**
-The target is `agl-demo-platform`.
-
-```sh
-$ bitbake agl-demo-platform
-```
-
-## 3. Deploying the AGL Demo Image
-
-This subsection describes AGL virtio-aarch64 image deployment under virtio
-platform provided by QEMU aarch64 emulator on PC, or QEMU/KVM hypervisor on AGL
-Reference Hardware board.
-
-**3.1 QEMU on PC**
-
-If shell from which AGL was built is closed, or new shell is opened, then it is
-needed to re-initialize build environment:
-
-```sh
-$ source $AGL_TOP/build-virtio-aarch64/agl-init-build-env
-```
-
-And further use `runqemu` to boot the image :
-
-```sh
-$ runqemu
-```
-
-**3.2 QEMU/KVM on AGL Reference Hardware**
-
-Follow these steps to run virtual AGL on bare-metal AGL (AGL-in-AGL) on AGL Reference Hardware board:
-
- 1. Partition eMMC or SD-Card to have two partitions, at least 1 GiB each.
- Actually, can be less but just rounded up to have a nice number.
-
- 2. Flash AGL minimal image root file system to the second partition on SD-Card
- or eMMC.
-
- 3. Build AGL minimal image for AGL Reference Hardware.
-
- ```sh
- source meta-agl/scripts/aglsetup.sh -m h3ulcb -b build-h3ulcb agl-refhw-h3
- ```
-
- In `build-h3ulcb/conf/local.conf` add
-
- ```
- AGL_DEFAULT_IMAGE_FSTYPES = "ext4"
- IMAGE_INSTALL_append = "qemu"
- ```
-
- CAUTION: Calling aglsetup.sh with "-f" flag will remove above modification
- in "local.conf", so they will be needed to be re-applied.
-
- Build image:
-
- ```sh
- bitbake agl-image-minimal
- ```
-
- Add virtio kernel to the AGL Reference Hardware Linux rootfs:
-
- ```sh
- cp build-virtio-aarch64/tmp/deploy/images/virtio-aarch64/Image build-h3ulcb/tmp/work/h3ulcb-agl-linux/agl-image-minimal/1.0-r0/rootfs/linux2
- bitbake agl-image-minimal -c image_ext4 -f
- bitbake agl-image-minimal -c image_complete
- ```
-
- Flash root file system to the first partition on SD-Card or eMMC.
-
- 4. Boot AGL Reference Hardware board using Linux located on the first partition of SD-Card or eMMC.
-
- 5. Run QEMU from Linux 1 command line
-
- ```sh
- qemu-system-aarch64 \
- -machine virt \
- -cpu cortex-a57 \
- -m 2048 \
- -serial mon:stdio \
- -global virtio-mmio.force-legacy=false \
- -drive id=disk0,file=/dev/mmcblk0p2,if=none,format=raw \
- -device virtio-blk-device,drive=disk0 \
- -object rng-random,filename=/dev/urandom,id=rng0 \
- -device virtio-rng-device,rng=rng0 \
- -nographic \
- -kernel /linux2
- -append 'root=/dev/vda rw mem=2048M'
- ```
-
- NOTE: mmcblk0p2 above is used for when root file system is flashed on eMMC.
- In case of SD-Card, mmcblk1p2 has to be used.
-
- 6. It is possible to exit from QEMU using monitor commands. Enter "Ctrl+a h" for help.
-
-Know issue: to enable hardware virtualization using KVM, option `-enable-kvm`
-could be added to QEMU command line, but it fails with:
-
-```
-qemu-system-aarch64: kvm_init_vcpu failed: Invalid argument
-```
Code Review / AGL / documentation.git / blobdiff