[PATCH 2/2] dt-bindings: dma: at_xdmac: document dma-channels property

From: Dharma Balasubiramani
Date: Wed Feb 05 2025 - 00:47:44 EST


Add document for the property "dma-channels" for XDMA controller.

Also reorder properties to group related items together.

Signed-off-by: Tony Han <tony.han@xxxxxxxxxxxxx>
Reviewed-by: Cristian Birsan <cristian.birsan@xxxxxxxxxxxxx>
Signed-off-by: Dharma Balasubiramani <dharma.b@xxxxxxxxxxxxx>
---
.../devicetree/bindings/dma/atmel,sama5d4-dma.yaml | 26 ++++++++++++++--------
1 file changed, 17 insertions(+), 9 deletions(-)

diff --git a/Documentation/devicetree/bindings/dma/atmel,sama5d4-dma.yaml b/Documentation/devicetree/bindings/dma/atmel,sama5d4-dma.yaml
index 9ca1c5d1f00f..b9fda35d2138 100644
--- a/Documentation/devicetree/bindings/dma/atmel,sama5d4-dma.yaml
+++ b/Documentation/devicetree/bindings/dma/atmel,sama5d4-dma.yaml
@@ -33,15 +33,6 @@ properties:
- microchip,sam9x7-dma
- const: atmel,sama5d4-dma

- "#dma-cells":
- description: |
- Represents the number of integer cells in the `dmas` property of client
- devices. The single cell specifies the channel configuration register:
- - bit 13: SIF (Source Interface Identifier) for memory interface.
- - bit 14: DIF (Destination Interface Identifier) for peripheral interface.
- - bit 30-24: PERID (Peripheral Identifier).
- const: 1
-
reg:
maxItems: 1

@@ -54,6 +45,23 @@ properties:
clock-names:
const: dma_clk

+ "#dma-cells":
+ description: |
+ Represents the number of integer cells in the `dmas` property of client
+ devices. The single cell specifies the channel configuration register:
+ - bit 13: SIF (Source Interface Identifier) for memory interface.
+ - bit 14: DIF (Destination Interface Identifier) for peripheral interface.
+ - bit 30-24: PERID (Peripheral Identifier).
+ const: 1
+
+ dma-channels:
+ $ref: /schemas/types.yaml#/definitions/uint32
+ description:
+ Represents the number of DMA channels available in XDMA controller. This
+ property is required when the channel count cannot be read from the
+ XDMAC_GTYPE register (which occurs when accessing from non-secure world
+ on certain devices).
+
required:
- compatible
- reg

--
2.43.0