[PATCH v3 3/7] dt-bindings: gpu: arm,mali-valhall-csf: Add system-cache policies
From: Cunyuan Liu
Date: Thu Nov 19 2026 - 07:39:43 EST
Describe system-cache allocation policies for Mali GPUs with SYSC_ALLOC
registers. The policy depends on how the GPU is integrated with the rest
of the system and belongs in DT rather than a platform table in the driver.
Use entries containing a source ID and separate read and write policies.
When the property is present, omitted sources use L2 allocation. Without
the property, the driver leaves the register settings unchanged.
Signed-off-by: Cunyuan Liu <cunyuan.liu@xxxxxxxxxxx>
---
.../bindings/gpu/arm,mali-valhall-csf.yaml | 24 +++++++++++++++++++
1 file changed, 24 insertions(+)
diff --git a/Documentation/devicetree/bindings/gpu/arm,mali-valhall-csf.yaml b/Documentation/devicetree/bindings/gpu/arm,mali-valhall-csf.yaml
index 8eccd4338a2b..4d50427edd87 100644
--- a/Documentation/devicetree/bindings/gpu/arm,mali-valhall-csf.yaml
+++ b/Documentation/devicetree/bindings/gpu/arm,mali-valhall-csf.yaml
@@ -97,6 +97,30 @@ properties:
dma-coherent: true
+ arm,sysc-alloc:
+ $ref: /schemas/types.yaml#/definitions/uint32-matrix
+ minItems: 1
+ maxItems: 32
+ items:
+ items:
+ - description: GPU internal source ID
+ minimum: 0
+ maximum: 31
+ - description: Read allocation policy
+ enum: [0, 2, 3, 4, 5]
+ - description: Write allocation policy
+ enum: [0, 2, 3, 4, 5]
+ description:
+ System-cache allocation policies for GPU architecture 11.0.3 and later.
+ Each entry contains a source ID, a read policy and a write policy.
+ Source IDs must be unique. Reserved source IDs and access directions
+ not supported by the GPU must use zero policies. Policy values are
+ 0 for L2 allocation, 2 for never allocate, 3 for always allocate,
+ 4 for partial allocation and 5 for L2 partial allocation. When present,
+ all source policies start at zero and the listed entries override them.
+ Omitted sources therefore use L2 allocation. If absent, the register
+ defaults are preserved.
+
required:
- compatible
- reg
--
2.53.0