[PATCH v2 1/4] dt-bindings: dma: ti: k3-*: Add descriptions for register regions

From: Vignesh Raghavendra
Date: Wed Nov 22 2023 - 10:45:02 EST


In preparation for introducing more register regions, add description
for existing register regions so that its easier to map reg-names to
that of SoC Documentations/TRMs.

Signed-off-by: Vignesh Raghavendra <vigneshr@xxxxxx>
---
.../devicetree/bindings/dma/ti/k3-bcdma.yaml | 26 +++++++++++--------
.../devicetree/bindings/dma/ti/k3-pktdma.yaml | 6 ++++-
.../devicetree/bindings/dma/ti/k3-udma.yaml | 5 +++-
3 files changed, 24 insertions(+), 13 deletions(-)

diff --git a/Documentation/devicetree/bindings/dma/ti/k3-bcdma.yaml b/Documentation/devicetree/bindings/dma/ti/k3-bcdma.yaml
index 4ca300a42a99..b5444800b036 100644
--- a/Documentation/devicetree/bindings/dma/ti/k3-bcdma.yaml
+++ b/Documentation/devicetree/bindings/dma/ti/k3-bcdma.yaml
@@ -35,14 +35,6 @@ properties:
- ti,am64-dmss-bcdma
- ti,j721s2-dmss-bcdma-csi

- reg:
- minItems: 3
- maxItems: 5
-
- reg-names:
- minItems: 3
- maxItems: 5
-
"#dma-cells":
const: 3
description: |
@@ -141,7 +133,10 @@ allOf:
ti,sci-rm-range-tchan: false

reg:
- maxItems: 3
+ items:
+ - description: BCDMA Control /Status Registers region
+ - description: RX Channel Realtime Registers region
+ - description: Ring Realtime Registers region

reg-names:
items:
@@ -160,7 +155,12 @@ allOf:
then:
properties:
reg:
- minItems: 5
+ items:
+ - description: BCDMA Control /Status Registers region
+ - description: Block Copy Channel Realtime Registers region
+ - description: RX Channel Realtime Registers region
+ - description: TX Channel Realtime Registers region
+ - description: Ring Realtime Registers region

reg-names:
items:
@@ -184,7 +184,11 @@ allOf:
ti,sci-rm-range-bchan: false

reg:
- maxItems: 4
+ items:
+ - description: BCDMA Control /Status Registers region
+ - description: RX Channel Realtime Registers region
+ - description: TX Channel Realtime Registers region
+ - description: Ring Realtime Registers region

reg-names:
items:
diff --git a/Documentation/devicetree/bindings/dma/ti/k3-pktdma.yaml b/Documentation/devicetree/bindings/dma/ti/k3-pktdma.yaml
index a69f62f854d8..3580b08f65c6 100644
--- a/Documentation/devicetree/bindings/dma/ti/k3-pktdma.yaml
+++ b/Documentation/devicetree/bindings/dma/ti/k3-pktdma.yaml
@@ -45,7 +45,11 @@ properties:
The second cell is the ASEL value for the channel

reg:
- maxItems: 4
+ items:
+ - description: Packet DMA Control /Status Registers region
+ - description: RX Channel Realtime Registers region
+ - description: TX Channel Realtime Registers region
+ - description: Ring Realtime Registers region

reg-names:
items:
diff --git a/Documentation/devicetree/bindings/dma/ti/k3-udma.yaml b/Documentation/devicetree/bindings/dma/ti/k3-udma.yaml
index 22f6c5e2f7f4..ded588bd079a 100644
--- a/Documentation/devicetree/bindings/dma/ti/k3-udma.yaml
+++ b/Documentation/devicetree/bindings/dma/ti/k3-udma.yaml
@@ -69,7 +69,10 @@ properties:
- ti,j721e-navss-mcu-udmap

reg:
- maxItems: 3
+ items:
+ - description: UDMA-P Control /Status Registers region
+ - description: RX Channel Realtime Registers region
+ - description: TX Channel Realtime Registers region

reg-names:
items:
--
2.42.0