u-boot.git/doc/board/emulation, branch next

Merge patch series "m68k: Add support for QEMU virt machine"

2026-02-02T20:25:48+00:00

Kuan-Wei Chiu  says:

Add support for the QEMU 'virt' machine on the m68k architecture. The
QEMU virt machine models a generic system utilizing Goldfish virtual
peripherals and is capable of emulating various classic 68k CPUs.

Currently, U-Boot's m68k architecture support focuses on ColdFire
variants. This series expands support to include the classic M680x0
architecture, implementing the necessary exception vectors, startup
code, and a bootinfo parser compatible with the QEMU interface.

Drivers for Goldfish peripherals (TTY, Timer, RTC) and the QEMU
Virtual System Controller (sysreset) are also added to enable serial
console, timekeeping, and system reset functionality.

The implementation has been verified on QEMU targeting the M68040 CPU,
confirming successful hardware initialization and boot to the U-Boot
command shell. Additionally, the CI configuration was verified locally
using gitlab-ci-local "qemu_m68k_virt test.py", resulting in
PASS qemu_m68k_virt test.py.

Link: https://lore.kernel.org/r/20260107201838.3448806-1-visitorckw@gmail.com
[trini: Re-sort MAINTAINERS entries]
Signed-off-by: Tom Rini

board: Add QEMU m68k virt board support

2026-02-02T20:24:41+00:00

Add support for the QEMU 'virt' machine on the m68k architecture. This
board emulates a generic machine based on the Motorola 68040 CPU
equipped with Goldfish virtual peripherals.

Introduce the necessary board configuration and initialization
infrastructure. The implementation includes logic to parse the QEMU
bootinfo interface, enabling dynamic detection of system RAM size to
adapt to the virtual machine's configuration.

Enable the Goldfish TTY driver for serial console output. Additionally,
enable Goldfish RTC and timer drivers to support real-time clock
functionality and nanosecond-resolution delays. Include comprehensive
documentation covering build instructions and usage examples.

Signed-off-by: Kuan-Wei Chiu 
Tested-by: Daniel Palmer 
Reviewed-by: Simon Glass

doc: describe QEMU VGA emulation

2026-01-28T20:08:41+00:00

Describe how the QEMU defconfigs can be used with an emulated GPU.

Reviewed-by: Simon Glass 
Signed-off-by: Heinrich Schuchardt

doc: describe QEMU networking

2026-01-19T09:31:21+00:00

Add a chapter about networking to the QEMU board documentation.

Describe both different types of networking as well as different emulated
NICs.

Suggested-by: Manjae Cho 
Signed-off-by: Heinrich Schuchardt

Fix typo "addtional" -> "additional" in pflash section.

2026-01-19T09:31:21+00:00

%s/addtional/additional/

Signed-off-by: Manjae Cho 
Reviewed-by: Quentin Schulz 
Signed-off-by: Heinrich Schuchardt

doc: qemu-riscv: describe running as flash image

2025-08-08T06:45:05+00:00

Describe how to build U-Boot to be run by QEMU as an emulated flash image.

Signed-off-by: Heinrich Schuchardt

doc: describe creating a pflash file for qemu-system-riscv64

2025-01-26T10:06:56+00:00

U-Boot can be executed in place from a flash device.
Describe how this can be emulated on RISC-V QEMU.

Signed-off-by: Heinrich Schuchardt

doc: qemu-riscv: describe CONFIG_DEBUG_SBI_CONSOLE

2024-11-09T08:56:46+00:00

In main U-Boot the SBI DBCN extension can be used to supply a debug
console.

Signed-off-by: Heinrich Schuchardt

doc: semihosting can only be once in TOC

2024-10-30T20:44:38+00:00

Sphinx warns if a page is added to the table of contents twice.
Add a reference instead.

Signed-off-by: Heinrich Schuchardt

board: emulation: Add QEMU sbsa support

2024-10-27T23:24:13+00:00

Add support for Arm sbsa [1] v0.3+ that is supported by QEMU [2].

Unlike other Arm based platforms the machine only provides a minimal
FDT that contains number of CPUs, ammount of memory and machine-version.
The boot firmware has to provide ACPI tables to the OS.
Due to this design a full DTB is added here as well that allows U-Boot's
driver to properly function. The DTB is appended at the end of the U-Boot
image and will be merged with the QEMU provided DTB.

In addition provide documentation how to use, enable binman to fabricate both
ROMs that are required to boot and add ACPI tables to make it full compatible
to the EDK2 reference implementation.

The board was tested using Fedora 40 Aarch64 Workstation. It's able
to boot from USB and AHCI or network.

Tested and found working:
- serial
- PCI
- xHCI
- Bochs display
- AHCI
- network using e1000e
- CPU init
- Booting Fedora 40

1: Server Base System Architecture (SBSA)
2: https://www.qemu.org/docs/master/system/arm/sbsa.html

Signed-off-by: Patrick Rudolph 
Cc: Peter Robinson 
Cc: Simon Glass 
Cc: Tom Rini