[PATCH 1/2] dt-bindings: interrupt-controller: Add MT8196 SMMU wrapper

From: Alexandre Mergnat

Date: Tue Nov 17 2026 - 12:31:30 EST


On MT8196, a MediaTek wrapper holds the integration settings of the
multimedia SMMUv3 and merges its interrupts into one GIC line.

Describe it as an interrupt controller, in its own node next to
the SMMU.

Signed-off-by: Alexandre Mergnat <amergnat@xxxxxxxxxxxx>
---
.../mediatek,mt8196-smmu-wp.yaml | 70 ++++++++++++++++++++++
MAINTAINERS | 6 ++
2 files changed, 76 insertions(+)

diff --git a/Documentation/devicetree/bindings/interrupt-controller/mediatek,mt8196-smmu-wp.yaml b/Documentation/devicetree/bindings/interrupt-controller/mediatek,mt8196-smmu-wp.yaml
new file mode 100644
index 000000000000..b841d9d0e3fc
--- /dev/null
+++ b/Documentation/devicetree/bindings/interrupt-controller/mediatek,mt8196-smmu-wp.yaml
@@ -0,0 +1,70 @@
+# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
+%YAML 1.2
+---
+$id: http://devicetree.org/schemas/interrupt-controller/mediatek,mt8196-smmu-wp.yaml#
+$schema: http://devicetree.org/meta-schemas/core.yaml#
+
+title: MediaTek MT8196 SMMU Wrapper Interrupt Controller
+
+maintainers:
+ - Alexandre Mergnat <amergnat@xxxxxxxxxxxx>
+
+description:
+ The multimedia SMMUv3 of MT8196 is integrated with a wrapper block that
+ collects the interrupt outputs of the SMMU into a single interrupt line.
+ The wrapper latches each SMMU interrupt and keeps that line asserted
+ until the latched interrupts are acknowledged in the wrapper. The
+ wrapper also holds integration settings of the SMMU, such as clock
+ gating and system level cache attributes.
+
+properties:
+ compatible:
+ const: mediatek,mt8196-mm-smmu-wp
+
+ reg:
+ maxItems: 1
+
+ interrupts:
+ maxItems: 1
+
+ interrupt-controller: true
+
+ '#interrupt-cells':
+ const: 1
+ description: |
+ The SMMU interrupt source:
+ 0 - Global error
+ 1 - CMD_SYNC complete
+ 2 - Event queue not empty
+ 3 - PRI queue not empty
+ 4 - Performance monitor
+ 5 - RAS critical error
+ 6 - RAS error recovery
+ 7 - RAS fault handling
+
+ power-domains:
+ maxItems: 1
+
+required:
+ - compatible
+ - reg
+ - interrupts
+ - interrupt-controller
+ - '#interrupt-cells'
+ - power-domains
+
+additionalProperties: false
+
+examples:
+ - |
+ #include <dt-bindings/interrupt-controller/arm-gic.h>
+ #include <dt-bindings/power/mediatek,mt8196-power.h>
+
+ interrupt-controller@309e0000 {
+ compatible = "mediatek,mt8196-mm-smmu-wp";
+ reg = <0x309e0000 0x1000>;
+ interrupts = <GIC_SPI 477 IRQ_TYPE_LEVEL_HIGH>;
+ interrupt-controller;
+ #interrupt-cells = <1>;
+ power-domains = <&hfrpsys_hwv MT8196_POWER_DOMAIN_MM_INFRA1>;
+ };
diff --git a/MAINTAINERS b/MAINTAINERS
index fe23913b1e43..5cc65a753ad2 100644
--- a/MAINTAINERS
+++ b/MAINTAINERS
@@ -17223,6 +17223,12 @@ F: Documentation/devicetree/bindings/memory-controllers/mediatek,smi*
F: drivers/memory/mtk-smi.c
F: include/soc/mediatek/smi.h

+MEDIATEK SMMU WRAPPER INTERRUPT CONTROLLER DRIVER
+M: Alexandre Mergnat <amergnat@xxxxxxxxxxxx>
+L: linux-mediatek@xxxxxxxxxxxxxxxxxxx (moderated for non-subscribers)
+S: Maintained
+F: Documentation/devicetree/bindings/interrupt-controller/mediatek,mt8196-smmu-wp.yaml
+
MEDIATEK SWITCH DRIVER
M: Chester A. Unal <chester.a.unal@xxxxxxxxxx>
M: Daniel Golle <daniel@xxxxxxxxxxxxxx>

--
2.43.0