From: Tao Tang <tangtao1634@phytium.com.cn>
Introduce a libqos helper module for the iommu-testdev
device used by qtests. This module provides some common functions to
all IOMMU test cases using iommu-testdev.
Wire the new sources into tests/qtest/libqos/meson.build so
they are built as part of the qtest support library.
Signed-off-by: Tao Tang <tangtao1634@phytium.com.cn>
Message-ID: <20260119161112.3841386-7-tangtao1634@phytium.com.cn>
Signed-off-by: Philippe Mathieu-Daudé <philmd@linaro.org>
---
MAINTAINERS | 5 ++
tests/qtest/libqos/qos-iommu-testdev.h | 43 ++++++++++++++
tests/qtest/libqos/qos-iommu-testdev.c | 82 ++++++++++++++++++++++++++
tests/qtest/libqos/meson.build | 3 +
4 files changed, 133 insertions(+)
create mode 100644 tests/qtest/libqos/qos-iommu-testdev.h
create mode 100644 tests/qtest/libqos/qos-iommu-testdev.c
diff --git a/MAINTAINERS b/MAINTAINERS
index 63a04350fb0..cc219e39b98 100644
--- a/MAINTAINERS
+++ b/MAINTAINERS
@@ -3578,6 +3578,11 @@ F: docs/devel/testing/qtest.rst
X: tests/qtest/bios-tables-test*
X: tests/qtest/migration-*
+QTest IOMMU helpers
+M: Tao Tang <tangtao1634@phytium.com.cn>
+S: Maintained
+F: tests/qtest/libqos/qos-iommu*
+
Device Fuzzing
M: Alexander Bulekov <alxndr@bu.edu>
R: Paolo Bonzini <pbonzini@redhat.com>
diff --git a/tests/qtest/libqos/qos-iommu-testdev.h b/tests/qtest/libqos/qos-iommu-testdev.h
new file mode 100644
index 00000000000..3713b89ea4c
--- /dev/null
+++ b/tests/qtest/libqos/qos-iommu-testdev.h
@@ -0,0 +1,43 @@
+/*
+ * IOMMU test device helpers for libqos qtests
+ *
+ * Copyright (c) 2026 Phytium Technology
+ *
+ * Author:
+ * Tao Tang <tangtao1634@phytium.com.cn>
+ *
+ * SPDX-License-Identifier: GPL-2.0-or-later
+ */
+
+#ifndef QTEST_LIBQOS_IOMMU_TESTDEV_H
+#define QTEST_LIBQOS_IOMMU_TESTDEV_H
+
+#include "pci.h"
+#include "hw/misc/iommu-testdev.h"
+
+typedef uint32_t (*QOSIOMMUTestdevSetupFn)(void *opaque);
+typedef uint32_t (*QOSIOMMUTestdevAttrsFn)(void *opaque);
+typedef bool (*QOSIOMMUTestdevValidateFn)(void *opaque);
+typedef void (*QOSIOMMUTestdevReportFn)(void *opaque, uint32_t dma_result);
+
+typedef struct QOSIOMMUTestdevDmaCfg {
+ QPCIDevice *dev;
+ QPCIBar bar;
+ uint64_t iova;
+ uint64_t gpa;
+ uint32_t len;
+} QOSIOMMUTestdevDmaCfg;
+
+uint32_t qos_iommu_testdev_trigger_dma(QPCIDevice *dev, QPCIBar bar,
+ uint64_t iova, uint64_t gpa,
+ uint32_t len, uint32_t attrs);
+
+void qos_iommu_testdev_single_translation(const QOSIOMMUTestdevDmaCfg *dma,
+ void *opaque,
+ QOSIOMMUTestdevSetupFn setup_fn,
+ QOSIOMMUTestdevAttrsFn attrs_fn,
+ QOSIOMMUTestdevValidateFn validate_fn,
+ QOSIOMMUTestdevReportFn report_fn,
+ uint32_t *dma_result_out);
+
+#endif /* QTEST_LIBQOS_IOMMU_TESTDEV_H */
diff --git a/tests/qtest/libqos/qos-iommu-testdev.c b/tests/qtest/libqos/qos-iommu-testdev.c
new file mode 100644
index 00000000000..91718a56738
--- /dev/null
+++ b/tests/qtest/libqos/qos-iommu-testdev.c
@@ -0,0 +1,82 @@
+/*
+ * IOMMU test device helpers for libqos qtests
+ *
+ * Copyright (c) 2026 Phytium Technology
+ *
+ * Author:
+ * Tao Tang <tangtao1634@phytium.com.cn>
+ *
+ * SPDX-License-Identifier: GPL-2.0-or-later
+ */
+
+#include "qemu/osdep.h"
+#include "../libqtest.h"
+#include "pci.h"
+#include "qos-iommu-testdev.h"
+
+uint32_t qos_iommu_testdev_trigger_dma(QPCIDevice *dev, QPCIBar bar,
+ uint64_t iova, uint64_t gpa,
+ uint32_t len, uint32_t attrs)
+{
+ uint32_t result = ITD_DMA_RESULT_BUSY;
+
+ qpci_io_writel(dev, bar, ITD_REG_DMA_GVA_LO, (uint32_t)iova);
+ qpci_io_writel(dev, bar, ITD_REG_DMA_GVA_HI, (uint32_t)(iova >> 32));
+ qpci_io_writel(dev, bar, ITD_REG_DMA_GPA_LO, (uint32_t)gpa);
+ qpci_io_writel(dev, bar, ITD_REG_DMA_GPA_HI, (uint32_t)(gpa >> 32));
+ qpci_io_writel(dev, bar, ITD_REG_DMA_LEN, len);
+ qpci_io_writel(dev, bar, ITD_REG_DMA_ATTRS, attrs);
+
+ qpci_io_writel(dev, bar, ITD_REG_DMA_DBELL, ITD_DMA_DBELL_ARM);
+ qpci_io_readl(dev, bar, ITD_REG_DMA_TRIGGERING);
+
+ for (int i = 0; i < 1000; i++) {
+ result = qpci_io_readl(dev, bar, ITD_REG_DMA_RESULT);
+ if (result != ITD_DMA_RESULT_BUSY) {
+ break;
+ }
+ g_usleep(1000);
+ }
+
+ if (result == ITD_DMA_RESULT_BUSY) {
+ return ITD_DMA_ERR_TX_FAIL;
+ }
+
+ return result;
+}
+
+void qos_iommu_testdev_single_translation(const QOSIOMMUTestdevDmaCfg *dma,
+ void *opaque,
+ QOSIOMMUTestdevSetupFn setup_fn,
+ QOSIOMMUTestdevAttrsFn attrs_fn,
+ QOSIOMMUTestdevValidateFn validate_fn,
+ QOSIOMMUTestdevReportFn report_fn,
+ uint32_t *dma_result_out)
+{
+ uint32_t config_result;
+ uint32_t dma_result;
+ uint32_t attrs_val;
+
+ g_assert(dma);
+ g_assert(setup_fn);
+ g_assert(attrs_fn);
+
+ config_result = setup_fn(opaque);
+ g_assert_cmpuint(config_result, ==, 0);
+
+ attrs_val = attrs_fn(opaque);
+ dma_result = qos_iommu_testdev_trigger_dma(dma->dev, dma->bar,
+ dma->iova, dma->gpa,
+ dma->len, attrs_val);
+ if (dma_result_out) {
+ *dma_result_out = dma_result;
+ }
+
+ if (report_fn) {
+ report_fn(opaque, dma_result);
+ }
+
+ if (validate_fn) {
+ g_assert_true(validate_fn(opaque));
+ }
+}
diff --git a/tests/qtest/libqos/meson.build b/tests/qtest/libqos/meson.build
index 1ddaf7b095b..9805d63a290 100644
--- a/tests/qtest/libqos/meson.build
+++ b/tests/qtest/libqos/meson.build
@@ -60,6 +60,9 @@ libqos_srcs = files(
'x86_64_pc-machine.c',
'riscv-virt-machine.c',
'loongarch-virt-machine.c',
+
+ # SMMU:
+ 'qos-iommu-testdev.c',
)
if have_virtfs
--
2.52.0