@@ -235,8 +235,17 @@ Hardware configuration information for bare-metal programming
The ``virt`` board automatically generates a device tree blob ("dtb")
which it passes to the guest. This provides information about the
addresses, interrupt lines and other configuration of the various devices
-in the system. Guest code can rely on and hard-code the following
-addresses:
+in the system.
+
+The optional ``-dtbi`` argument is used to specify a device tree blob to merge
+with this generated device tree, to add any properties required by the guest but
+not included by qemu. Properties are merged after the generated device tree is
+created, so take precedence over generated properties. This can be useful for
+overriding the ``stdout-path`` for Linux, for example, or to add configuration
+information needed by U-Boot. This is intended for simple nodes and properties
+and does not support use of phandles or device tree overlays.
+
+Guest code can rely on and hard-code the following addresses:
- Flash memory starts at address 0x0000_0000
@@ -41,6 +41,7 @@
#include "hw/vfio/vfio-calxeda-xgmac.h"
#include "hw/vfio/vfio-amd-xgbe.h"
#include "hw/display/ramfb.h"
+#include <libfdt.h>
#include "net/net.h"
#include "system/device_tree.h"
#include "system/numa.h"
@@ -349,6 +350,135 @@ static void create_fdt(VirtMachineState *vms)
}
}
+
+/*
+ * From U-Boot v2021.07 (under BSD-2-Clause license)
+ *
+ * This does not use the qemu_fdt interface because that requires node names.
+ * Here we are using offsets.
+ *
+ * overlay_apply_node - Merges a node into the base device tree
+ * @fdt: Base Device Tree blob
+ * @target: Node offset in the base device tree to apply the fragment to
+ * @fdto: Device tree overlay blob
+ * @node: Node offset in the overlay holding the changes to merge
+ *
+ * overlay_apply_node() merges a node into a target base device tree
+ * node pointed.
+ *
+ * This is part of the final step in the device tree overlay
+ * application process, when all the phandles have been adjusted and
+ * resolved and you just have to merge overlay into the base device
+ * tree.
+ *
+ * returns:
+ * 0 on success
+ * Negative error code on failure
+ */
+static int overlay_apply_node(void *fdt, int target, void *fdto, int node)
+{
+ int property;
+ int subnode;
+
+ fdt_for_each_property_offset(property, fdto, node) {
+ const char *name;
+ const void *prop;
+ int prop_len;
+ int ret;
+
+ prop = fdt_getprop_by_offset(fdto, property, &name, &prop_len);
+ if (prop_len == -FDT_ERR_NOTFOUND) {
+ return -FDT_ERR_INTERNAL;
+ }
+ if (prop_len < 0) {
+ return prop_len;
+ }
+
+ ret = fdt_setprop(fdt, target, name, prop, prop_len);
+ if (ret) {
+ return ret;
+ }
+ }
+
+ fdt_for_each_subnode(subnode, fdto, node) {
+ const char *name = fdt_get_name(fdto, subnode, NULL);
+ int nnode;
+ int ret;
+
+ nnode = fdt_add_subnode(fdt, target, name);
+ if (nnode == -FDT_ERR_EXISTS) {
+ nnode = fdt_subnode_offset(fdt, target, name);
+ if (nnode == -FDT_ERR_NOTFOUND) {
+ return -FDT_ERR_INTERNAL;
+ }
+ }
+
+ if (nnode < 0) {
+ return nnode;
+ }
+
+ ret = overlay_apply_node(fdt, nnode, fdto, subnode);
+ if (ret) {
+ return ret;
+ }
+ }
+
+ return 0;
+}
+
+/* Merge nodes and properties into fdt from fdto */
+static int merge_fdt(void *fdt, void *fdto)
+{
+ int err;
+
+ err = overlay_apply_node(fdt, 0, fdto, 0);
+ if (err) {
+ fprintf(stderr, "Device tree error %s\n", fdt_strerror(err));
+ return -1;
+ }
+
+ return 0;
+}
+
+/* Finish creating the device tree, merging in the -dtbi file if needed */
+static int complete_fdt(VirtMachineState *vms)
+{
+ MachineState *ms = MACHINE(vms);
+
+ if (ms->dtbi) {
+ char *filename;
+ void *fdt;
+ int size;
+ int ret;
+
+ filename = qemu_find_file(QEMU_FILE_TYPE_BIOS, ms->dtbi);
+ if (!filename) {
+ fprintf(stderr, "Couldn't open dtbi file %s\n", ms->dtbi);
+ goto fail;
+ }
+
+ fdt = load_device_tree(filename, &size);
+ if (!fdt) {
+ fprintf(stderr, "Couldn't open dtbi file %s\n", filename);
+ g_free(filename);
+ goto fail;
+ }
+
+ ret = merge_fdt(ms->fdt, fdt);
+ g_free(fdt);
+ if (ret) {
+ fprintf(stderr, "Failed to merge in dtbi file %s\n", filename);
+ g_free(filename);
+ goto fail;
+ }
+ g_free(filename);
+ }
+ return 0;
+
+fail:
+ return -1;
+}
+
static void fdt_add_timer_nodes(const VirtMachineState *vms)
{
/* On real hardware these interrupts are level-triggered.
@@ -2438,6 +2568,11 @@ static void machvirt_init(MachineState *machine)
create_platform_bus(vms);
+ if (complete_fdt(vms)) {
+ error_report("mach-virt: Failed to complete device tree");
+ exit(1);
+ }
+
if (machine->nvdimms_state->is_enabled) {
const struct AcpiGenericAddress arm_virt_nvdimm_acpi_dsmio = {
.space_id = AML_AS_SYSTEM_MEMORY,
@@ -375,6 +375,21 @@ static void machine_set_dtb(Object *obj, const char *value, Error **errp)
ms->dtb = g_strdup(value);
}
+static char *machine_get_dtbi(Object *obj, Error **errp)
+{
+ MachineState *ms = MACHINE(obj);
+
+ return g_strdup(ms->dtbi);
+}
+
+static void machine_set_dtbi(Object *obj, const char *value, Error **errp)
+{
+ MachineState *ms = MACHINE(obj);
+
+ g_free(ms->dtbi);
+ ms->dtbi = g_strdup(value);
+}
+
static char *machine_get_dumpdtb(Object *obj, Error **errp)
{
MachineState *ms = MACHINE(obj);
@@ -1143,6 +1158,11 @@ static void machine_class_init(ObjectClass *oc, void *data)
object_class_property_set_description(oc, "dtb",
"Linux kernel device tree file");
+ object_class_property_add_str(oc, "dtbi",
+ machine_get_dtbi, machine_set_dtbi);
+ object_class_property_set_description(oc, "dtbi",
+ "Linux kernel device tree file to merge with the generated device tree");
+
object_class_property_add_str(oc, "dumpdtb",
machine_get_dumpdtb, machine_set_dumpdtb);
object_class_property_set_description(oc, "dumpdtb",
@@ -400,6 +400,7 @@ struct MachineState {
void *fdt;
char *dtb;
+ char *dtbi; /* filename of device tree to merge with the generated one */
char *dumpdtb;
int phandle_start;
char *dt_compatible;
@@ -4294,6 +4294,14 @@ the guest image is:
ERST
+DEF("dtbi", HAS_ARG, QEMU_OPTION_dtbi, \
+ "-dtbi file merge 'file' with generated device tree\n", QEMU_ARCH_ARM)
+SRST
+``-dtbi file``
+ Merge a device tree binary (dtb) file into the generated device tree and
+ pass the result to the kernel on boot.
+ERST
+
DEFHEADING()
DEFHEADING(Debug/Expert options:)
@@ -3018,6 +3018,9 @@ void qemu_init(int argc, char **argv)
case QEMU_OPTION_dtb:
qdict_put_str(machine_opts_dict, "dtb", optarg);
break;
+ case QEMU_OPTION_dtbi:
+ qdict_put_str(machine_opts_dict, "dtbi", optarg);
+ break;
case QEMU_OPTION_cdrom:
drive_add(IF_DEFAULT, 2, optarg, CDROM_OPTS);
break;
At present qemu creates a device tree automatically with the 'virt' generic virtual platform. This is very convenient in most cases but there is not much control over what is generated. Add a way to provide a device tree binary file with additional properties to add before booting. This provides flexibility for situations where Linux needs some tweak to operate correctly. It also allows configuration information to be passed to U-Boot, supporting verified boot, for example. The term 'merge' is used here to avoid confusion with device tree overlays, which are a particular type of format. Link: https://docs.u-boot.org/en/latest/develop/devicetree/dt_qemu.html Link: https://patchwork.ozlabs.org/project/uboot/patch/20250405190711.365419-1-sjg@chromium.org/ Signed-off-by: Simon Glass <sjg@chromium.org> --- Changes in v3: - Rebase to master Changes in v2: - Rebase to master docs/system/arm/virt.rst | 13 +++- hw/arm/virt.c | 135 +++++++++++++++++++++++++++++++++++++++ hw/core/machine.c | 20 ++++++ include/hw/boards.h | 1 + qemu-options.hx | 8 +++ system/vl.c | 3 + 6 files changed, 178 insertions(+), 2 deletions(-)