Thread (9 messages) 9 messages, 2 authors, 2020-03-31

Re: [PATCH v3 1/6] dt-bindings: dma: uniphier-xdmac: Consolidate register region description

From: Kunihiko Hayashi <hayashi.kunihiko@socionext.com>
Date: 2020-03-31 10:29:00
Also in: linux-devicetree

On Mon, 30 Mar 2020 19:20:35 +0900 [off-list ref] wrote:
On Mon, Mar 23, 2020 at 6:33 PM Kunihiko Hayashi
[off-list ref] wrote:
quoted
The extension register region isn't currently referred from the driver, so
this consolidates the extension register region description into the base
register region, and spreads the region size in example.

You should not say this in the commit log.

The DT binding is hardware description.
Whether it is used or not in the driver is not a primary reason.
I see. I forgot that this also applies to commit logs.
I recommend you to read this:


Documentation/devicetree/bindings/writing-bindings.txt:

- DON'T refer to Linux or "device driver" in bindings. Bindings should be
  based on what the hardware has, not what an OS and driver currently support.
Thanks for your suggestion.
quoted
Fixes: b9fb56b6ba8a ("dt-bindings: dmaengine: Add UniPhier external DMA controller bindings")
Signed-off-by: Kunihiko Hayashi <hayashi.kunihiko@socionext.com>
---
 Documentation/devicetree/bindings/dma/socionext,uniphier-xdmac.yaml | 5 ++---
 1 file changed, 2 insertions(+), 3 deletions(-)
diff --git a/Documentation/devicetree/bindings/dma/socionext,uniphier-xdmac.yaml b/Documentation/devicetree/bindings/dma/socionext,uniphier-xdmac.yaml
index 86cfb59..830cd88 100644
--- a/Documentation/devicetree/bindings/dma/socionext,uniphier-xdmac.yaml
+++ b/Documentation/devicetree/bindings/dma/socionext,uniphier-xdmac.yaml
@@ -23,8 +23,7 @@ properties:

   reg:
     items:
-      - description: XDMAC base register region (offset and length)
-      - description: XDMAC extension register region (offset and length)
+      - description: XDMAC register region (offset and length)
Now that the reg is a single tuple,
the "items" is unneeded.
Okay, I'll notice it.
quoted
   interrupts:
     maxItems: 1
@@ -54,7 +53,7 @@ examples:
   - |
     xdmac: dma-controller@5fc10000 {
         compatible = "socionext,uniphier-xdmac";
-        reg = <0x5fc10000 0x1000>, <0x5fc20000 0x800>;
+        reg = <0x5fc10000 0x5100>;

Checking the datasheet (LD20), this seems still wrong.

The last register is XDMAID3 : 0x5fc1520c

So, reg = <0x5fc10000 0x5300>;
Hmm, You're right.
I missed the information somewhere.
I attached a patch, which I think more correct.
Please check it, and I will send it to the correct ML.
I checked it. This looks good to me and thanks for your help.
I'll fix the remaining patches next.

Thank you,

---
Best Regards,
Kunihiko Hayashi


_______________________________________________
linux-arm-kernel mailing list
linux-arm-kernel@lists.infradead.org
http://lists.infradead.org/mailman/listinfo/linux-arm-kernel
Keyboard shortcuts
hback out one level
jnext message in thread
kprevious message in thread
ldrill in
Escclose help / fold thread tree
?toggle this help