Mali 5th-Gen AM GPUs expose an AM_SYSTEM block for GPU-wide control outside the main GPU register window.
Document the system node compatible, register and interrupt resources, GPU clock, and optional GPU regulator supply used by the AM_SYSTEM platform driver. Signed-off-by: Karunika Choo <[email protected]> --- .../bindings/gpu/arm,mali-gen5-am-system.yaml | 67 +++++++++++++++++++ MAINTAINERS | 1 + 2 files changed, 68 insertions(+) create mode 100644 Documentation/devicetree/bindings/gpu/arm,mali-gen5-am-system.yaml diff --git a/Documentation/devicetree/bindings/gpu/arm,mali-gen5-am-system.yaml b/Documentation/devicetree/bindings/gpu/arm,mali-gen5-am-system.yaml new file mode 100644 index 0000000000000..f0689bb8f05a2 --- /dev/null +++ b/Documentation/devicetree/bindings/gpu/arm,mali-gen5-am-system.yaml @@ -0,0 +1,67 @@ +# SPDX-License-Identifier: GPL-2.0-only OR BSD-2-Clause +# Copyright 2026 ARM Limited. All rights reserved. +%YAML 1.2 +--- +$id: http://devicetree.org/schemas/gpu/arm,mali-gen5-am-system.yaml# +$schema: http://devicetree.org/meta-schemas/core.yaml# + +title: ARM Mali 5th-Gen GPU System Device + +maintainers: + - Liviu Dudau <[email protected]> + - Boris Brezillon <[email protected]> + +properties: + $nodename: + pattern: '^panthor-system@[a-f0-9]+$' + + compatible: + oneOf: + - items: + - const: arm,mali-gen5-am-system + + reg: + items: + - description: System register + + reg-names: + items: + - const: system + + interrupts: + items: + - description: System interrupt + + clocks: + maxItems: 1 + description: + Phandle to the GPU clock. + + gpu-supply: true + + dma-coherent: true + +required: + - compatible + - reg + - reg-names + - interrupts + - clocks + +additionalProperties: false + +examples: + - | + #include <dt-bindings/interrupt-controller/irq.h> + #include <dt-bindings/interrupt-controller/arm-gic.h> + + panthor_system: panthor-system@68000000 { + compatible = "arm,mali-gen5-am-system"; + reg = <0x68000000 0x10000>; + reg-names = "system"; + interrupts = <GIC_SPI 168 IRQ_TYPE_LEVEL_HIGH>; + clocks = <&mali_gpu_clk>; + gpu-supply = <&gpu_supply>; + }; + +... diff --git a/MAINTAINERS b/MAINTAINERS index 40fdb0ecc9c12..377156650580c 100644 --- a/MAINTAINERS +++ b/MAINTAINERS @@ -2324,6 +2324,7 @@ M: Liviu Dudau <[email protected]> L: [email protected] S: Supported T: git https://gitlab.freedesktop.org/drm/misc/kernel.git +F: Documentation/devicetree/bindings/gpu/arm,mali-gen5-am-*.yaml F: Documentation/devicetree/bindings/gpu/arm,mali-valhall-csf.yaml F: drivers/gpu/drm/ci/xfails/panthor* F: drivers/gpu/drm/panthor/ -- 2.43.0
