Cover Letter Detail
Show a cover letter.
GET /api/1.0/covers/2198208/?format=api
{ "id": 2198208, "url": "http://patchwork.ozlabs.org/api/1.0/covers/2198208/?format=api", "project": { "id": 14, "url": "http://patchwork.ozlabs.org/api/1.0/projects/14/?format=api", "name": "QEMU Development", "link_name": "qemu-devel", "list_id": "qemu-devel.nongnu.org", "list_email": "qemu-devel@nongnu.org", "web_url": "", "scm_url": "", "webscm_url": "" }, "msgid": "<20260219143332.3316679-1-ruslichenko.r@gmail.com>", "date": "2026-02-19T14:32:59", "name": "[v2,00/33] hw/arm: Introduce generic FDT-driven machine", "submitter": { "id": 92275, "url": "http://patchwork.ozlabs.org/api/1.0/people/92275/?format=api", "name": "Ruslan Ruslichenko", "email": "ruslichenko.r@gmail.com" }, "series": [ { "id": 492690, "url": "http://patchwork.ozlabs.org/api/1.0/series/492690/?format=api", "date": "2026-02-19T14:33:04", "name": "hw/arm: Introduce generic FDT-driven machine", "version": 2, "mbox": "http://patchwork.ozlabs.org/series/492690/mbox/" } ], "headers": { "Return-Path": "<qemu-devel-bounces+incoming=patchwork.ozlabs.org@nongnu.org>", "X-Original-To": "incoming@patchwork.ozlabs.org", "Delivered-To": "patchwork-incoming@legolas.ozlabs.org", "Authentication-Results": [ "legolas.ozlabs.org;\n\tdkim=pass (2048-bit key;\n unprotected) header.d=gmail.com header.i=@gmail.com header.a=rsa-sha256\n header.s=20230601 header.b=nZ6zeLKT;\n\tdkim-atps=neutral", "legolas.ozlabs.org;\n spf=pass (sender SPF authorized) smtp.mailfrom=nongnu.org\n (client-ip=209.51.188.17; helo=lists.gnu.org;\n envelope-from=qemu-devel-bounces+incoming=patchwork.ozlabs.org@nongnu.org;\n receiver=patchwork.ozlabs.org)" ], "Received": [ "from lists.gnu.org (lists.gnu.org [209.51.188.17])\n\t(using TLSv1.2 with cipher ECDHE-ECDSA-AES256-GCM-SHA384 (256/256 bits))\n\t(No client certificate requested)\n\tby legolas.ozlabs.org (Postfix) with ESMTPS id 4fGx1Z0X1Hz1xpY\n\tfor <incoming@patchwork.ozlabs.org>; Fri, 20 Feb 2026 01:42:42 +1100 (AEDT)", "from localhost ([::1] helo=lists1p.gnu.org)\n\tby lists.gnu.org with esmtp (Exim 4.90_1)\n\t(envelope-from <qemu-devel-bounces@nongnu.org>)\n\tid 1vt576-0008SF-34; Thu, 19 Feb 2026 09:34:44 -0500", "from eggs.gnu.org ([2001:470:142:3::10])\n by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256)\n (Exim 4.90_1) (envelope-from <ruslichenko.r@gmail.com>)\n id 1vt573-0008OT-Ut\n for qemu-devel@nongnu.org; Thu, 19 Feb 2026 09:34:41 -0500", "from mail-wr1-x42f.google.com ([2a00:1450:4864:20::42f])\n by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128)\n (Exim 4.90_1) (envelope-from <ruslichenko.r@gmail.com>)\n id 1vt571-0002tt-0X\n for qemu-devel@nongnu.org; Thu, 19 Feb 2026 09:34:41 -0500", "by mail-wr1-x42f.google.com with SMTP id\n ffacd0b85a97d-4359a302794so832101f8f.1\n for <qemu-devel@nongnu.org>; Thu, 19 Feb 2026 06:34:38 -0800 (PST)", "from thinkpad-t470s.. (93-143-129-182.adsl.net.t-com.hr.\n [93.143.129.182]) by smtp.googlemail.com with ESMTPSA id\n ffacd0b85a97d-43796abd259sm52022770f8f.24.2026.02.19.06.34.34\n (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256);\n Thu, 19 Feb 2026 06:34:35 -0800 (PST)" ], "DKIM-Signature": "v=1; a=rsa-sha256; c=relaxed/relaxed;\n d=gmail.com; s=20230601; t=1771511677; x=1772116477; darn=nongnu.org;\n h=content-transfer-encoding:mime-version:message-id:date:subject:cc\n :to:from:from:to:cc:subject:date:message-id:reply-to;\n bh=S0JjDE11mVwIXFaABEqQvYNM+21Z6KM91LtkR11YKjA=;\n b=nZ6zeLKTSkL0ramphyIGZSVR1oyT0vZ6PKkywuyyFCAJ5c2HYdCfE8gSegtoDzz+WM\n JbJPGAtmdIhOGIz8UEx7HjUnYvsV0YxY7pHc2gKqM7KSscFvbg4N54MI8q0aopw5ZCSc\n nqBl0Gc88lJRC6aw+Wv2hGcTtQo0bqFLe7qjZwG45R3y8DQBUUeD2ktTJ8PQKdcKDYvq\n NwsKtNDDWvfhKwNkNt9MuSHhX8pjR6kuHtvPppaiatDMVqAyv75FYHlp0Y4R9QYHVXlT\n gX8G7nppPSWOZyQGKZJAdy0nF/2NTr/N949n3liLaCxUQ52qujARb3wzsj72tA3khZUb\n a3iQ==", "X-Google-DKIM-Signature": "v=1; a=rsa-sha256; c=relaxed/relaxed;\n d=1e100.net; s=20230601; t=1771511677; x=1772116477;\n h=content-transfer-encoding:mime-version:message-id:date:subject:cc\n :to:from:x-gm-gg:x-gm-message-state:from:to:cc:subject:date\n :message-id:reply-to;\n bh=S0JjDE11mVwIXFaABEqQvYNM+21Z6KM91LtkR11YKjA=;\n b=XxQJfoejwEYp9erofoB0paCd9zlFStGK+9Q3AqU4Oy9xCA00B0iFSfj5nanKdRIi2m\n wzs8yhbzvWNabrPCZtEV3FV0mw5JIcdH3lXFVRtWpeIeyWtkXWV+uaZvZln6UomoXQJI\n UGyDKc0fEEkSBFs/b+fjh/I+1ESDbZS0LQDx0jyUMeedI69wvrJ41Znwj69WYAu5evwK\n ovTFUnhvXaLkAq2B75Ti7YuoaSl6fM1ORaJMI6e4dnQnhve86b1ZL2jdoYQECovUZQyC\n TicarQEtARYTj0BnHe0anM34N3UeEeFmbHZ/ntOCdbCX8iCTvKdV/78uoF3I3Wc6Ljcb\n uhMg==", "X-Gm-Message-State": "AOJu0YyiPLqk89AFj86ClhmtAsWWvCMRUBNyw9HFEICxBBu9Iqrnr3Qy\n r1qqcOzsX3SJ4GMrXaJWPxaOWcpgUrKn2hSy1BgdLzePO6SQIzDNG+NRMJnflsEU", "X-Gm-Gg": "AZuq6aIzU7VwgFLhSOQr1oYj2UbLwp7lNFS3Mkx4ew+VCze9Hv3Eq5WqIZ0Ou+Oihq/\n OehpFQUUTvQdlXTKEnKInf9iJyyf46+4hAw9McmDqTKJlyiv4Y4CRVUzQDz797KB8NPoPies7Pd\n nd9h7+sPtYwi/jsR9Vy1HzomWSZVUBLtPxxTysktekn9ZlQ6tdGoucq5wFlIRKEmrdYXhHGK4Ft\n YGz7pofnBn3mW8HeSsszcYj/jzHzvJyJA28j4KE7P+cE/ciqDl9qIdf3j6SBysGqjX6sbXwJfT6\n +UzuiUUoGaGq939hYwLAF9jz/CXLgzBRfDAdxEBePuj/ROtxELLCJ65UCBb3rUUsF0XUQgNZJid\n 2Dr09kFGTolGtQiI37lHpYFo7ZBY7wvsqvNj0i3TOSZs3kP2flsnPRYuNLbHIodY54FZqdHiXQv\n S71cp49d4quS/ewENAYFTDGN8Kr+429+CcxkrQ8CRf0RHAiKcPfz2WbDhFXupTMiNGyw2+", "X-Received": "by 2002:a5d:64c7:0:b0:437:6dac:4580 with SMTP id\n ffacd0b85a97d-4379dbb0c62mr34908050f8f.62.1771511676469;\n Thu, 19 Feb 2026 06:34:36 -0800 (PST)", "From": "Ruslan Ruslichenko <ruslichenko.r@gmail.com>", "To": "qemu-devel@nongnu.org", "Cc": "qemu-arm@nongnu.org, alex.bennee@linaro.org, peter.maydell@linaro.org,\n artem_mygaiev@epam.com, volodymyr_babchuk@epam.com,\n takahiro.nakata.wr@renesas.com,\n \"Edgar E . Iglesias\" <edgar.iglesias@gmail.com>,\n Ruslan_Ruslichenko@epam.com, balaton@eik.bme.hu", "Subject": "[PATCH v2 00/33] hw/arm: Introduce generic FDT-driven machine", "Date": "Thu, 19 Feb 2026 15:32:59 +0100", "Message-ID": "<20260219143332.3316679-1-ruslichenko.r@gmail.com>", "X-Mailer": "git-send-email 2.43.0", "MIME-Version": "1.0", "Content-Transfer-Encoding": "8bit", "Received-SPF": "pass client-ip=2a00:1450:4864:20::42f;\n envelope-from=ruslichenko.r@gmail.com; helo=mail-wr1-x42f.google.com", "X-Spam_score_int": "-20", "X-Spam_score": "-2.1", "X-Spam_bar": "--", "X-Spam_report": "(-2.1 / 5.0 requ) BAYES_00=-1.9, DKIM_SIGNED=0.1,\n DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, FREEMAIL_FROM=0.001,\n RCVD_IN_DNSWL_NONE=-0.0001, SPF_HELO_NONE=0.001,\n SPF_PASS=-0.001 autolearn=unavailable autolearn_force=no", "X-Spam_action": "no action", "X-BeenThere": "qemu-devel@nongnu.org", "X-Mailman-Version": "2.1.29", "Precedence": "list", "List-Id": "qemu development <qemu-devel.nongnu.org>", "List-Unsubscribe": "<https://lists.nongnu.org/mailman/options/qemu-devel>,\n <mailto:qemu-devel-request@nongnu.org?subject=unsubscribe>", "List-Archive": "<https://lists.nongnu.org/archive/html/qemu-devel>", "List-Post": "<mailto:qemu-devel@nongnu.org>", "List-Help": "<mailto:qemu-devel-request@nongnu.org?subject=help>", "List-Subscribe": "<https://lists.nongnu.org/mailman/listinfo/qemu-devel>,\n <mailto:qemu-devel-request@nongnu.org?subject=subscribe>", "Errors-To": "qemu-devel-bounces+incoming=patchwork.ozlabs.org@nongnu.org", "Sender": "qemu-devel-bounces+incoming=patchwork.ozlabs.org@nongnu.org" }, "content": "From: Ruslan Ruslichenko <Ruslan_Ruslichenko@epam.com>\n\nThis patch series introduces a new ARM machine model, arm-generic-fdt, and the underlying infrastructure required\nto instantiate a QEMU machine entirely from a Device Tree.\n\nKey Features in v2\nThis version add support for an sbsa-ref compatible platform. Major additions include:\n\nGICv3: via the FDTGenericIntc interface.\nGPEX PCI Host: Dynamic mapping of MMIO windows via aliases and irq routing via a new gsi-irqs property.\nBlock Devices: New support for binding QEMU block backends to FDT nodes using blockdev.\nTesting: Added two new functional tests ensuring the machine can boot successfully similar sbsa-ref platform.\n\nAlso addressed comments received in v1. \n\nOrigin & Motivation\nThis feature originates from the AMD QEMU repository (https://github.com/Xilinx/qemu).\n\nCurrently, adding support for a new ARM board in QEMU requires writing a dedicated C source file to define the memory map,\ninstantiate devices, and wire interrupts. Any modification to the board configuration requires a corresponding change in\nthe source code and a rebuild of the QEMU binary.\n\nThis series introduces an alternative approach: defining the board configuration via a Device Tree Blob (DTB) provided at\nthe command line. The new arm-generic-fdt machine parses this DTB at runtime to dynamically construct the system topology.\n\nBeyond providing more flexible board creation, this infrastructure is a prerequisite for enabling Hardware Co-Simulation\nworkflows (e.g., using the Remote-Port protocol: https://mail.gnu.org/archive/html/qemu-devel/2026-02/msg01760.html).\nIn mixed simulation environments where QEMU emulates the CPU subsystem and an external simulator (such as SystemC) handles\ncustom logic, the memory map and interrupt lines often need to change dynamically based on the external hardware configuration,\nmaking static C models impractical.\n\nImplementation Overview\nThe series implements an FDT loading framework in hw/core/fdt_generic_util.c capable of:\n\nParsing and creating device models from FDT nodes.\nSetting QOM properties based on FDT properties.\nConnecting IRQs for SysBus devices (via FDTGenericIntc).\nMapping memory regions for IO devices or system RAM (via FDTGenericMMap).\nAttaching block devices specified via blockdev interface.\nNOTE: GPIO wiring for non-SysBus devices is not supported yet.\n\nTesting\nTesting can be performed by two scripts within patch series.\nPre-compiled dtb binaries for tests are currently placed at tests/data/dtb/aarch64/arm-generic-fdt.\n\nThe Device Trees sources used for testing can be found by following links:\n\nHardware DTS (used with -hw-dtb): https://gist.github.com/ruslichenkor/82245d89fb2a64dc7f1b694504cb840e#file-arm64-sbsa-hw-dts\n\nGuest DTS (used with -dtb): https://gist.github.com/ruslichenkor/82245d89fb2a64dc7f1b694504cb840e#file-arm64-sbsa-guest-dts\n\nAlso example command to launch VM is following:\n\n/qemu/build/qemu-system-aarch64\n\t-machine arm-generic-fdt \\\n\t-hw-dtb arm64-sbsa-hw.dtb\n\t-dtb sbsa-ref.dtb\n\t-serial mon:stdio \\\n\t-netdev user,id=net0\n\t-device e1000e,netdev=net0 \\\n\t-device bochs-display \\\n\t-blockdev driver=file,filename=./SBSA_FLASH0.fd,node-name=pflash0 \\\n\t-blockdev driver=file,filename=./SBSA_FLASH1.fd,node-name=pflash1 \\\n\t-device usb-kbd -device usb-tablet \\\n\t-drive file=./alpine-standard-3.23.3-aarch64.iso,if=none,id=cdrom0,readonly=on \\\n\t-device ide-cd,bus=ahci.0,unit=0,drive=cdrom0\n\nOpen Questions\nLocation of Test Binaries:\nI have added the compiled Device Tree Blobs (DTB) required for the functional tests into tests/data/dtb.\n\nQuestion: Is this the preferred location for static test binaries, or should they be placed elsewhere?\n\nPatch Summary\nhw/core: Add Generic FDT parsing infrastructure and utility functions (fdt_generic_util)\nhw/arm: Add the arm-generic-fdt machine model\nhw/core/sysbus: Add IO memory mapping for standard SysBus devices\nsystem/memory: Allow MemoryRegions to be configured from FDT\nhw/intc: Add FDT support for ARM GICv3 (IRQ translation and default wiring)\nhw/pci-host: Add gsi-irqs property for INTx mapping\ntarget/arm: Add FDT support for CPU timers\n\nBR,\nRuslan Ruslichenko\n\nRuslan Ruslichenko (33):\n system/device_tree: update qemu_fdt_getprop_cell\n system/device_tree: add few parsing and traversal helpers\n util/log: add log entry for fdt generic utils\n hw/core: introduce generic FDT device model registry\n hw/core/fdt_generic: implement FDT machine creation helpers\n hw/core/fdt_generic: add cpu clusters management\n hw/core/fdt_generic_util: implement main fdt parse routine\n hw/core/fdt_generic_util: implement fdt_init_qdev\n qdev: Add qdev_prop_get_array_elem_type() helper\n hw/core/fdt_generic_util: initilize qdev properties from fdt\n hw/core/fdt_generic_util: actually realize device\n hw/core/fdt_generic_util: add TYPE_FDT_GENERIC_MMAP\n hw/core/fdt_generic_util: add TYPE_FDT_GENERIC_INTC\n hw/core/fdt_generic_util: implement fdt_get_irq/_info API\n hw/core/fdt_generic_util: map device memory\n hw/core/fdt_generic_util: Connect device irqs\n hw/core/fdt_generic_util: realize cpu clusters\n hw/core: add fdt_generic to the build\n hw/core/machine: add '-hw-dtb' option for machine\n hw/arm: add generic ARM machine initialized by FDT\n hw/core/sysbus: implement FDT_GENERIC_MMAP_CLASS interface\n hw/intc/arm_gic: implement FDT_GENERIC_INTC and fdt support\n target/arm/cpu: add fdt support for armv8-timer\n qom/object: export object_resolve_link()\n system/memory: add setters for MemoryRegion properties\n system/memory: implement FDT_GENERIC_MMAP interface\n hw/core/fdt_generic_util: initialize serial devices\n system/memory: add QOM aliases for fdt support\n hw/intc/arm_gicv3: Implement FDTGenericIntc interface\n hw/core/fdt_generic_util: Add deferred device initialization support\n hw/core/fdt_generic_util: Add blockdev binding support\n hw/pci-host: add gsi-irqs property array\n tests/functional: Add functional tests for arm-generic-fdt machine\n\n hw/arm/arm_generic_fdt.c | 180 +++\n hw/arm/boot.c | 8 +-\n hw/arm/meson.build | 2 +\n hw/arm/raspi4b.c | 8 +-\n hw/arm/vexpress.c | 4 +-\n hw/core/fdt_generic.c | 286 ++++\n hw/core/fdt_generic_util.c | 1414 +++++++++++++++++\n hw/core/machine.c | 19 +\n hw/core/meson.build | 2 +\n hw/core/qdev-properties.c | 12 +\n hw/core/sysbus.c | 28 +\n hw/intc/arm_gic.c | 32 +\n hw/intc/arm_gic_common.c | 50 +\n hw/intc/arm_gicv3.c | 45 +\n hw/intc/arm_gicv3_common.c | 68 +\n hw/pci-host/gpex.c | 6 +\n include/hw/core/boards.h | 1 +\n include/hw/core/fdt_generic.h | 135 ++\n include/hw/core/fdt_generic_util.h | 140 ++\n include/hw/core/qdev-properties.h | 1 +\n include/hw/pci-host/gpex.h | 3 +\n include/qemu/log.h | 1 +\n include/qom/object.h | 12 +\n include/system/device_tree.h | 35 +-\n qemu-options.hx | 9 +\n qom/object.c | 2 +-\n system/device_tree.c | 237 ++-\n system/memory.c | 378 ++++-\n system/vl.c | 3 +\n target/arm/cpu.c | 115 ++\n .../arm-generic-fdt/arm64-sbsa-guest.dtb | Bin 0 -> 673 bytes\n .../aarch64/arm-generic-fdt/arm64-sbsa-hw.dtb | Bin 0 -> 5414 bytes\n tests/functional/aarch64/meson.build | 2 +\n .../aarch64/test_arm_generic_fdt.py | 114 ++\n .../aarch64/test_arm_generic_fdt_alpine.py | 61 +\n util/log.c | 1 +\n 36 files changed, 3386 insertions(+), 28 deletions(-)\n create mode 100644 hw/arm/arm_generic_fdt.c\n create mode 100644 hw/core/fdt_generic.c\n create mode 100644 hw/core/fdt_generic_util.c\n create mode 100644 include/hw/core/fdt_generic.h\n create mode 100644 include/hw/core/fdt_generic_util.h\n create mode 100644 tests/data/dtb/aarch64/arm-generic-fdt/arm64-sbsa-guest.dtb\n create mode 100644 tests/data/dtb/aarch64/arm-generic-fdt/arm64-sbsa-hw.dtb\n create mode 100755 tests/functional/aarch64/test_arm_generic_fdt.py\n create mode 100755 tests/functional/aarch64/test_arm_generic_fdt_alpine.py" }