blob: 4ebe64b853564a740162b4dc90b150572f41aadb [file] [log] [blame]
Paul Beesleyf3653a62019-05-22 11:22:44 +01001QEMU virt Armv8-A
2=================
Douglas Raillardd7c21b72017-06-28 15:23:03 +01003
Dan Handley610e7e12018-03-01 18:44:00 +00004Trusted Firmware-A (TF-A) implements the EL3 firmware layer for QEMU virt
5Armv8-A. BL1 is used as the BootROM, supplied with the -bios argument.
Douglas Raillardd7c21b72017-06-28 15:23:03 +01006When QEMU starts all CPUs are released simultaneously, BL1 selects a
7primary CPU to handle the boot and the secondaries are placed in a polling
8loop to be released by normal world via PSCI.
9
10BL2 edits the Flattened Device Tree, FDT, generated by QEMU at run-time to
11add a node describing PSCI and also enable methods for the CPUs.
12
Dan Handley610e7e12018-03-01 18:44:00 +000013An ARM64 defconfig v4.5 Linux kernel is known to boot, FDT doesn't need to be
Douglas Raillardd7c21b72017-06-28 15:23:03 +010014provided as it's generated by QEMU.
15
16Current limitations:
17
18- Only cold boot is supported
19- No build instructions for QEMU\_EFI.fd and rootfs-arm64.cpio.gz
20- No instructions for how to load a BL32 (Secure Payload)
21
22``QEMU_EFI.fd`` can be dowloaded from
23http://snapshots.linaro.org/components/kernel/leg-virt-tianocore-edk2-upstream/latest/QEMU-KERNEL-AARCH64/RELEASE_GCC49/QEMU_EFI.fd
24
25Boot binaries, except BL1, are primarily loaded via semi-hosting so all
26binaries has to reside in the same directory as QEMU is started from. This
27is conveniently achieved with symlinks the local names as:
28
29- ``bl2.bin`` -> BL2
30- ``bl31.bin`` -> BL31
31- ``bl33.bin`` -> BL33 (``QEMU_EFI.fd``)
32- ``Image`` -> linux/Image
33
34To build:
35
Paul Beesley493e3492019-03-13 15:11:04 +000036.. code:: shell
Douglas Raillardd7c21b72017-06-28 15:23:03 +010037
Paul Beesleyf3653a62019-05-22 11:22:44 +010038 make CROSS_COMPILE=aarch64-none-elf- PLAT=qemu
Douglas Raillardd7c21b72017-06-28 15:23:03 +010039
40To start (QEMU v2.6.0):
41
Paul Beesley493e3492019-03-13 15:11:04 +000042.. code:: shell
Douglas Raillardd7c21b72017-06-28 15:23:03 +010043
44 qemu-system-aarch64 -nographic -machine virt,secure=on -cpu cortex-a57 \
45 -kernel Image \
46 -append console=ttyAMA0,38400 keep_bootcon root=/dev/vda2 \
47 -initrd rootfs-arm64.cpio.gz -smp 2 -m 1024 -bios bl1.bin \
48 -d unimp -semihosting-config enable,target=native