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 <[email protected]>
---
 .../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

Reply via email to