opensbi.git/docs/platform/qemu_virt.md, branch master

docs: platform: update qemu_virt.md

2026-05-11T04:56:36Z

When using GDB for debugging, if FW_TEXT_START is not set to 0x80000000 during compilation, the following error occurs: Reading symbols from build/platform/generic/firmware/fw_payload.elf... Remote debugging using localhost:1234 mips_warm_boot () at /home/zrmin/opensbi/platform/generic/mips/mips_warm_boot.S:11 11 j _start_warm (gdb) b _start Breakpoint 1 at 0x0: file /home/zrmin/opensbi/firmware/fw_base.S, line 50. (gdb) c Continuing. Remote connection closed (gdb) With FW_TEXT_START=0x80000000, debugging works correctly: Reading symbols from build/platform/generic/firmware/fw_payload.elf... Remote debugging using localhost:1234 0x0000000000001000 in ?? () (gdb) b _start Breakpoint 1 at 0x80000000: file /home/zrmin/opensbi/firmware/fw_base.S, line 50. (gdb) c Continuing. Breakpoint 1, _start () at /home/zrmin/opensbi/firmware/fw_base.S:50 50 MOV_3R s0, a0, s1, a1, s2, a2 (gdb) This is because QEMU loads OpenSBI at address 0x80000000. When FW_TEXT_START does not match this address, the debug symbols are incorrectly offset, causing GDB to fail to set breakpoints properly. Signed-off-by: Zhang RunMin Reviewed-by: Anup Patel Link: https://lore.kernel.org/r/20260319125641.480161-1-runmin.zhang@ingenic.com Signed-off-by: Anup Patel

docs: add example of building the Linux kernel

2024-11-09T09:00:41Z

Slightly expand the QEMU docs to explain how to build the flat Linux kernel image. Signed-off-by: Tim Hutt Reviewed-by: Samuel Holland Reviewed-by: Anup Patel

docs: debugging OpenSBI

2021-06-02T11:34:07Z

Describe how to debug OpenSBI on QEMU with GDB. Signed-off-by: Heinrich Schuchardt Reviewed-by: Atish Patra

docs/platform: Update QEMU parameter for fw_payload

2020-06-29T03:46:40Z

Since QEMU v5.1, if there is no "-bios" option provided, the default OpenSBI firmware will be loaded by QEMU as the BIOS automatically, hence to load fw_payload type image, we should explicitly pass the "-bios" option to QEMU. Signed-off-by: Bin Meng Reviewed-by: Atish Patra

platform: Remove qemu/virt directory

2020-05-04T04:39:23Z

The OpenSBI generic platform works perfectly fine on the QEMU virt machine so let's remove dedicated QEMU virt machine platform from OpenSBI. All QEMU virt machine related documentation in OpenSBI will now suggest using OpenSBI generic platform. Signed-off-by: Anup Patel Reviewed-by: Bin Meng Reviewed-by: Alistair Francis

doc: qemu_virt: Fix doc styles

2020-02-18T03:38:44Z

Remove the unnecessary blank line at the end of the doc. Signed-off-by: Bin Meng Reviewed-by: Anup Patel

treewide: Use conventional names for 32-bit and 64-bit

2019-07-25T03:44:58Z

There are several places in the source tree that have: 32bit, 32 bit, 64bit, 64 bit Fix by using the conventional names with a hyphen. Signed-off-by: Bin Meng Reviewed-by: Lukas Auer Acked-by: Anup Patel

docs: qemu/virt platform documentation fixes and updates

2019-04-15T03:22:59Z

- Correct the payload address in the RV64 examples that use fw_jump.elf. - Change the qemu console configuration in the examples from "-display none -serial stdio" to "-nographic". This results in qemu handing down a CTRL-C on the emulated console to the VM instead of terminating the qemu process. - Provide examples for RV32. - Various text corrections. Signed-off-by: Karsten Merker Reviewed-by: Alistair Francis

platform: qemu/virt: Move kernel start address to 4MB alligned

2019-02-08T03:48:46Z

In order to support 32-bit guests move the start address to a 4MB allignment. As 64-bit kernels have a requirement on being 2MB alligned let's just make this the default for both 32 and 64 bit kernels. Signed-off-by: Alistair Francis

docs: Typo fixes

2019-01-29T01:47:14Z

Signed-off-by: Atish Patra