Skip to content

hw/arm: Introduce generic FDT-driven machine

Ruslan Ruslichenko qemu-arm qemu-devel 2 versions – In review

Get series with b4
b4 am [email protected]

Versions newest first · linked by author and title

  1. v3 Latest33 patches 2 repliesIn review
  2. v232 of 33 patches 10 repliesSuperseded

Patches in v3 No applies recorded yet

#Subject and filesSizeRepliesApplied
1/33system/device_tree: update qemu_fdt_getprop_cellhw/arm/boot.c hw/arm/raspi4b.c hw/arm/vexpress.c +2 more+20 -230 replies
2/33system/device_tree: add few parsing and traversal helpersinclude/system/device_tree.h system/device_tree.c+216 -02 replies
3/33util/log: add log entry for fdt generic utilsinclude/qemu/log.h util/log.c+2 -00 replies
4/33hw/core: introduce generic FDT device model registryhw/core/fdt_generic.c include/hw/core/fdt_generic.h+171 -00 replies
5/33hw/core/fdt_generic: implement FDT machine creation helpershw/core/fdt_generic.c include/hw/core/fdt_generic.h+112 -10 replies
6/33hw/core/fdt_generic: add cpu clusters managementhw/core/fdt_generic.c include/hw/core/fdt_generic.h+91 -00 replies
7/33hw/core/fdt_generic_util: implement main fdt parse routinehw/core/fdt_generic_util.c include/hw/core/fdt_generic_util.h+252 -00 replies
8/33hw/core/fdt_generic_util: implement fdt_init_qdevhw/core/fdt_generic_util.c+120 -00 replies
9/33qdev: Add qdev_prop_get_array_elem_type() helperhw/core/qdev-properties.c include/hw/core/qdev-properties.h+13 -00 replies
10/33qom/object: export object_resolve_link()include/qom/object.h qom/object.c+13 -10 replies
11/33hw/core/fdt_generic_util: initilize qdev properties from fdthw/core/fdt_generic_util.c+236 -00 replies
12/33hw/core/fdt_generic_util: actually realize devicehw/core/fdt_generic_util.c+30 -00 replies
13/33hw/core/fdt_generic_util: add TYPE_FDT_GENERIC_MMAPhw/core/fdt_generic_util.c include/hw/core/fdt_generic_util.h+55 -00 replies
14/33hw/core/fdt_generic_util: add TYPE_FDT_GENERIC_INTChw/core/fdt_generic_util.c include/hw/core/fdt_generic_util.h+66 -00 replies
15/33hw/core/fdt_generic_util: implement fdt_get_irq/_info APIhw/core/fdt_generic_util.c include/hw/core/fdt_generic_util.h+149 -00 replies
16/33hw/core/fdt_generic_util: map device memory regionshw/core/fdt_generic_util.c include/hw/core/fdt_generic_util.h+164 -00 replies
17/33hw/core/fdt_generic_util: Connect device irqshw/core/fdt_generic_util.c include/hw/core/fdt_generic.h+155 -00 replies
18/33hw/core/fdt_generic_util: realize cpu clustershw/core/fdt_generic_util.c+11 -00 replies
19/33hw/core: add fdt_generic to the buildhw/core/meson.build+2 -00 replies
20/33hw/arm: add generic ARM machine initialized by FDThw/arm/arm_generic_fdt.c hw/arm/meson.build+174 -00 replies
21/33hw/arm/arm_generic_fdt: Add support for host-backed RAM regionshw/arm/arm_generic_fdt.c+95 -10 replies
22/33hw/core/sysbus: implement FDT_GENERIC_MMAP_CLASS interfacehw/core/sysbus.c+28 -00 replies
23/33hw/intc/arm_gic: implement FDT_GENERIC_INTC and fdt supporthw/intc/arm_gic.c hw/intc/arm_gic_common.c+82 -00 replies
24/33target/arm/cpu: add fdt support for armv8-timertarget/arm/cpu.c+112 -00 replies
25/33system/memory: add setters for MemoryRegion propertiessystem/memory.c+216 -50 replies
26/33system/memory: implement FDT_GENERIC_MMAP interfacesystem/memory.c+58 -00 replies
27/33hw/core/fdt_generic_util: initialize serial deviceshw/core/fdt_generic_util.c+8 -00 replies
28/33system/memory: add QOM aliases for fdt supportsystem/memory.c+78 -00 replies
29/33hw/intc/arm_gicv3: Implement FDTGenericIntc interfacehw/intc/arm_gicv3.c hw/intc/arm_gicv3_common.c+113 -00 replies
30/33hw/core/fdt_generic_util: Add deferred device initialization supporthw/core/fdt_generic_util.c include/hw/core/fdt_generic.h+36 -00 replies
31/33hw/core/fdt_generic_util: Add blockdev binding supporthw/core/fdt_generic_util.c+77 -00 replies
32/33hw/pci-host: add gsi-irqs property arrayhw/pci-host/gpex.c include/hw/pci-host/gpex.h+9 -00 replies
33/33tests/functional: Add functional tests for arm-generic-fdt machinetests/data/dtb/aarch64/arm-generic-fdt/arm64-sbsa-guest.dtb tests/data/dtb/aarch64/arm-generic-fdt/arm64-sbsa-hw.dtb tests/functional/aarch64/meson.build +2 more+177 -00 replies

Reviews trailers per patch

No Reviewed-by, Acked-by or Tested-by trailers for v3 yet.

Read the v3 thread

Cover letter [PATCH v3 00/33] hw/arm: Introduce generic FDT-driven machine

From: Ruslan Ruslichenko <[email protected]>

This patch series introduces a new ARM machine model, arm-generic-fdt, and the underlying infrastructure required to instantiate a QEMU machine entirely from a Device Tree.

Updates in v3:
- Added support for binding host memory backends.
- Simplified the main qdev initialization logic.
- Reworked logging withing the FDT framework.
- Moved the 'hw-dtb' parameter to be a machine option.
- Addressed other comments from v2.

Updates in v2:
This version add support for an sbsa-ref compatible platform. Major additions include:

GICv3: via the FDTGenericIntc interface.
GPEX PCI Host: Dynamic mapping of MMIO windows via aliases and irq routing via a new gsi-irqs property. Block Devices: New support for binding QEMU block backends to FDT nodes using blockdev.
Testing: Added two new functional tests ensuring the machine can boot successfully similar sbsa-ref platform.

Also addressed comments received in v1.

Origin & Motivation
This feature originates from the AMD QEMU repository (https://github.com/Xilinx/qemu).

Currently, adding support for a new ARM board in QEMU requires writing a dedicated C source file to define the memory map, instantiate devices, and wire interrupts. Any modification to the board configuration requires a corresponding change in the source code and a rebuild of the QEMU binary.

This series introduces an alternative approach: defining the board configuration via a Device Tree Blob (DTB) provided at the command line. The new arm-generic-fdt machine parses this DTB at runtime to dynamically construct the system topology.

Beyond providing more flexible board creation, this infrastructure is a prerequisite for enabling Hardware Co-Simulation workflows (e.g., using the Remote-Port protocol: https://mail.gnu.org/archive/html/qemu-devel/2026-02/msg01760.html).
In mixed simulation environments where QEMU emulates the CPU subsystem and an external simulator (such as SystemC) handles custom logic, the memory map and interrupt lines often need to change dynamically based on the external hardware configuration, making static C models impractical.

Implementation Overview
The series implements an FDT loading framework in hw/core/fdt_generic_util.c capable of:

Parsing and creating device models from FDT nodes.
Setting QOM properties based on FDT properties.
Connecting IRQs for SysBus devices (via FDTGenericIntc). Mapping memory regions for IO devices or system RAM (via FDTGenericMMap). Attaching block devices specified via blockdev interface.
NOTE: GPIO wiring for non-SysBus devices is not supported.

Testing
Testing can be performed by two scripts within patch series.
Pre-compiled dtb binaries for tests are currently placed at tests/data/dtb/aarch64/arm-generic-fdt.

The Device Trees to emulate VM similar sources used for testing can be found by following links:

Hardware DTS: https://gist.github.com/ruslichenkor/82245d89fb2a64dc7f1b694504cb840e#file-arm64-sbsa-hw-dts
Guest DTS: https://gist.github.com/ruslichenkor/82245d89fb2a64dc7f1b694504cb840e#file-arm64-sbsa-guest-dts

Example command to launch a VM similar to SBSA-ref:

/qemu/build/qemu-system-aarch64 \
        --machine arm-generic-fdt,hw-dtb=arm64-sbsa-hw.dtb \
        -dtb arm64-sbsa-guest.dtb \
        -serial mon:stdio \
        -netdev user,id=net0 \
        -device e1000e,netdev=net0 \
        -device bochs-display \
        -blockdev driver=file,filename=./SBSA_FLASH0.fd,node-name=pflash0 \
        -blockdev driver=file,filename=./SBSA_FLASH1.fd,node-name=pflash1 \
        -device usb-kbd -device usb-tablet \
        -drive file=./alpine-standard-3.23.3-aarch64.iso,if=none,id=cdrom0,readonly=on \
        -device ide-cd,bus=ahci.0,unit=0,drive=cdrom0

Also it is possible to run simple ARM64 VM with direct kernel boot. The example device tree for minimal VM machine can be found here:

Hardware DTS: https://gist.github.com/ruslichenkor/19a1b7d937dbf889190e670cb677e43e#file-arm64-virt-hw-dts
Guest DTS: https://gist.github.com/ruslichenkor/19a1b7d937dbf889190e670cb677e43e#file-arm64-virt-guest-dts

Example command for direct kernel boot:

./qemu-system-aarch64 \
    -machine arm-generic-fdt,hw-dtb=arm64-virt-hw.dtb \
    -dtb arm64-virt-guest.dtb \
    -cpu cortex-a57 -smp 4 -m 256 \
    -drive id=disk0,file=./core-image-minimal-qemuarm64.rootfs-20251218190831.ext4,if=none,format=raw \
    -device virtio-blk-device,drive=disk0 \
    -kernel ./Image \
    -nographic \
    -append 'root=/dev/vda console=ttyAMA0 mem=256M swiotlb=0 '

Open Questions
Location of Test Binaries:
I have added the compiled Device Tree Blobs (DTB) required for the functional tests into tests/data/dtb.

Question: Is this the preferred location for static test binaries, or should they be placed elsewhere?

Patch Summary
hw/core: Add Generic FDT parsing infrastructure and utility functions (fdt_generic_util) hw/arm: Add the arm-generic-fdt machine model
hw/core/sysbus: Add IO memory mapping for standard SysBus devices system/memory: Allow MemoryRegions to be configured from FDT
hw/intc: Add FDT support for ARM GICv3 (IRQ translation and default wiring) hw/pci-host: Add gsi-irqs property for INTx mapping
target/arm: Add FDT support for CPU timers

Ruslan Ruslichenko (33):
system/device_tree: update qemu_fdt_getprop_cell system/device_tree: add few parsing and traversal helpers util/log: add log entry for fdt generic utils
hw/core: introduce generic FDT device model registry hw/core/fdt_generic: implement FDT machine creation helpers hw/core/fdt_generic: add cpu clusters management hw/core/fdt_generic_util: implement main fdt parse routine hw/core/fdt_generic_util: implement fdt_init_qdev
qdev: Add qdev_prop_get_array_elem_type() helper qom/object: export object_resolve_link() hw/core/fdt_generic_util: initilize qdev properties from fdt hw/core/fdt_generic_util: actually realize device hw/core/fdt_generic_util: add TYPE_FDT_GENERIC_MMAP hw/core/fdt_generic_util: add TYPE_FDT_GENERIC_INTC hw/core/fdt_generic_util: implement fdt_get_irq/_info API hw/core/fdt_generic_util: map device memory regions hw/core/fdt_generic_util: Connect device irqs hw/core/fdt_generic_util: realize cpu clusters
hw/core: add fdt_generic to the build
hw/arm: add generic ARM machine initialized by FDT hw/arm/arm_generic_fdt: Add support for host-backed RAM regions hw/core/sysbus: implement FDT_GENERIC_MMAP_CLASS interface hw/intc/arm_gic: implement FDT_GENERIC_INTC and fdt support target/arm/cpu: add fdt support for armv8-timer system/memory: add setters for MemoryRegion properties system/memory: implement FDT_GENERIC_MMAP interface hw/core/fdt_generic_util: initialize serial devices system/memory: add QOM aliases for fdt support hw/intc/arm_gicv3: Implement FDTGenericIntc interface hw/core/fdt_generic_util: Add deferred device initialization support hw/core/fdt_generic_util: Add blockdev binding support hw/pci-host: add gsi-irqs property array tests/functional: Add functional tests for arm-generic-fdt machine

 hw/arm/arm_generic_fdt.c                      |  266 ++++
 hw/arm/boot.c                                 |    8 +-
 hw/arm/meson.build                            |    2 +
 hw/arm/raspi4b.c                              |    8 +-
 hw/arm/vexpress.c                             |    4 +-
 hw/core/fdt_generic.c                         |  259 ++++
 hw/core/fdt_generic_util.c                    | 1194 +++++++++++++++++
 hw/core/meson.build                           |    2 +
 hw/core/qdev-properties.c                     |   12 +
 hw/core/sysbus.c                              |   28 +
 hw/intc/arm_gic.c                             |   32 +
 hw/intc/arm_gic_common.c                      |   50 +
 hw/intc/arm_gicv3.c                           |   45 +
 hw/intc/arm_gicv3_common.c                    |   68 +
 hw/pci-host/gpex.c                            |    6 +
 include/hw/core/fdt_generic.h                 |  134 ++
 include/hw/core/fdt_generic_util.h            |  145 ++
 include/hw/core/qdev-properties.h             |    1 +
 include/hw/pci-host/gpex.h                    |    3 +
 include/qemu/log.h                            |    1 +
 include/qom/object.h                          |   12 +
 include/system/device_tree.h                  |   27 +-
 qom/object.c                                  |    2 +-
 system/device_tree.c                          |  210 ++-
 system/memory.c                               |  357 ++++-
 target/arm/cpu.c                              |  112 ++
 .../arm-generic-fdt/arm64-sbsa-guest.dtb      |  Bin 0 -> 673 bytes
 .../aarch64/arm-generic-fdt/arm64-sbsa-hw.dtb |  Bin 0 -> 5290 bytes
 tests/functional/aarch64/meson.build          |    2 +
 .../aarch64/test_arm_generic_fdt.py           |  114 ++
 .../aarch64/test_arm_generic_fdt_alpine.py    |   61 +
 util/log.c                                    |    1 +
 32 files changed, 3138 insertions(+), 28 deletions(-)
 create mode 100644 hw/arm/arm_generic_fdt.c
 create mode 100644 hw/core/fdt_generic.c
 create mode 100644 hw/core/fdt_generic_util.c
 create mode 100644 include/hw/core/fdt_generic.h
 create mode 100644 include/hw/core/fdt_generic_util.h
 create mode 100644 tests/data/dtb/aarch64/arm-generic-fdt/arm64-sbsa-guest.dtb
 create mode 100644 tests/data/dtb/aarch64/arm-generic-fdt/arm64-sbsa-hw.dtb
 create mode 100755 tests/functional/aarch64/test_arm_generic_fdt.py
 create mode 100755 tests/functional/aarch64/test_arm_generic_fdt_alpine.py
Signature · 1 line
2.43.0