mirror of
https://codeberg.org/canoeboot/cbwww.git
synced 2024-11-22 10:24:44 +00:00
66 lines
2.4 KiB
Markdown
66 lines
2.4 KiB
Markdown
---
|
|
title: Building Canoeboot for Emulation
|
|
x-toc-enable: true
|
|
...
|
|
|
|
Introduction
|
|
============
|
|
|
|
Canoeboot supports building for qemu as a target board.
|
|
The resulting rom can then be tested using qemu.
|
|
|
|
The qemu board is mostly intended to speed up development by removing the need to flash to bare metal during initial tests.
|
|
Qemu may also be useful for end users who intend to make changes to their Canoeboot rom without having to flash and reboot their machine.
|
|
|
|
Building and Testing
|
|
====================
|
|
|
|
Canoeboot can be built for qemu just like any other board.
|
|
|
|
`./build boot roms qemu_x86_12mb`
|
|
|
|
In order to test the resulting roms, you must have qemu installed on the host machine.
|
|
Test the roms by pointing qemu to the rom in bios mode.
|
|
For example:
|
|
|
|
`qemu-system-x86_64 -bios bin/qemu_x86_12mb/grub_qemu_x86_12mb_libgfxinit_corebootfb_usqwerty.rom`
|
|
|
|
`qemu-system-x86_64 -bios bin/qemu_x86_12mb/uboot_payload_qemu_x86_12mb_libgfxinit_corebootfb.rom -serial stdio`
|
|
|
|
There is basic support for an arm64 virtual machine as well, although the payloads are not as developed as the x86 one:
|
|
|
|
./build boot roms qemu_arm64_12mb
|
|
|
|
```
|
|
qemu-system-aarch64 -bios bin/qemu_arm64_12mb/uboot_payload_qemu_arm64_12mb_libgfxinit_corebootfb.rom \
|
|
-M virt,secure=on,virtualization=on,acpi=on -cpu cortex-a53 -m 768M -serial stdio -vga none -display none
|
|
```
|
|
|
|
That command (above) does a serial console. Alper Nebi Yasak added this patch to Libreboot:
|
|
<https://browse.libreboot.org/lbmk.git/commit/?id=444f2899e69e9b84fd5428625aa04b00c1341804>
|
|
|
|
This enables a graphical display in qemu, like so (only works for releases on or
|
|
after Canoeboot 20231026, or Libreboot after release 20231021). Command:
|
|
|
|
```
|
|
qemu-system-aarch64 \
|
|
-machine virt,secure=on,virtualization=on \
|
|
-cpu cortex-a72 -m 1G \
|
|
-serial stdio -device VGA \
|
|
-device qemu-xhci \
|
|
-device usb-kbd -device usb-mouse \
|
|
-bios bin/qemu_arm64_12mb/*.rom
|
|
```
|
|
|
|
Use Cases
|
|
=========
|
|
|
|
While development is the primary motivation for qemu support, the board makes it easy to test minor changes to release roms.
|
|
For example one can use *cbfstool* from coreboot to edit the background image in a Canoeboot rom as follows:
|
|
|
|
```
|
|
cbfstool /path/to/rom remove -n background.png
|
|
cbfstool /path/to/rom add -f mynewbackground.png -n background.png -t raw
|
|
```
|
|
|
|
Using qemu allows the user to verify that the background image renders properly before performing the same operation on their release rom.
|