diff mbox

dmaengine: usb-dmac: Add compatible string for r8a7743/5

Message ID 1507216771-8957-1-git-send-email-biju.das@bp.renesas.com (mailing list archive)
State Superseded
Delegated to: Geert Uytterhoeven
Headers show

Commit Message

Biju Das Oct. 5, 2017, 3:19 p.m. UTC
This patch adds support for r8a7743/5 SoC. The Renesas RZ/G1[ME]
(R8A7743/5) usbdmac engine is identical to the R-Car Gen2 family.

This doesn't change the driver, so it does nothing by itself.  But it does
mean that checkpatch won't complain about a future patch that adds
"renesas,r8a7743-usb-dmac" or "renesas,r8a7745-usb-dmac" to a DT,
which helps ensure that shipped DTs use documented compatibility strings.

Signed-off-by: Biju Das <biju.das@bp.renesas.com>
---
This patch is tested against Linux next tag next-20170929 

 Documentation/devicetree/bindings/dma/renesas,usb-dmac.txt | 2 ++
 1 file changed, 2 insertions(+)

Comments

Geert Uytterhoeven Oct. 6, 2017, 7:36 a.m. UTC | #1
Hi Biju,

On Thu, Oct 5, 2017 at 5:19 PM, Biju Das <biju.das@bp.renesas.com> wrote:
> This patch adds support for r8a7743/5 SoC. The Renesas RZ/G1[ME]
> (R8A7743/5) usbdmac engine is identical to the R-Car Gen2 family.
>
> This doesn't change the driver, so it does nothing by itself.  But it does

Wording it like this may give the wrong impression to the casual reader
that a driver change will be submitted separately.
No driver change is needed due to the fallback compatible value
"renesas,usb-dmac".

> mean that checkpatch won't complain about a future patch that adds
> "renesas,r8a7743-usb-dmac" or "renesas,r8a7745-usb-dmac" to a DT,
> which helps ensure that shipped DTs use documented compatibility strings.

Adding the SoC-specific compatible values here has two purposes:
  1. Document which SoCs have this hardware module,
  2. Allow checkpatch to validate compatible values.

> Signed-off-by: Biju Das <biju.das@bp.renesas.com>

Reviewed-by: Geert Uytterhoeven <geert+renesas@glider.be>

> --- a/Documentation/devicetree/bindings/dma/renesas,usb-dmac.txt
> +++ b/Documentation/devicetree/bindings/dma/renesas,usb-dmac.txt
> @@ -3,6 +3,8 @@
>  Required Properties:
>  -compatible: "renesas,<soctype>-usb-dmac", "renesas,usb-dmac" as fallback.
>         Examples with soctypes are:
> +         - "renesas,r8a7743-usb-dmac" (RZ/G1M)
> +         - "renesas,r8a7745-usb-dmac" (RZ/G1E)
>           - "renesas,r8a7790-usb-dmac" (R-Car H2)
>           - "renesas,r8a7791-usb-dmac" (R-Car M2-W)
>           - "renesas,r8a7793-usb-dmac" (R-Car M2-N)

Gr{oetje,eeting}s,

                        Geert

--
Geert Uytterhoeven -- There's lots of Linux beyond ia32 -- geert@linux-m68k.org

In personal conversations with technical people, I call myself a hacker. But
when I'm talking to journalists I just say "programmer" or something like that.
                                -- Linus Torvalds
Biju Das Oct. 6, 2017, 9 a.m. UTC | #2
> -----Original Message-----

> From: geert.uytterhoeven@gmail.com [mailto:geert.uytterhoeven@gmail.com]

> On Behalf Of Geert Uytterhoeven

> Sent: 06 October 2017 08:36

> To: Biju Das <biju.das@bp.renesas.com>

> Cc: Vinod Koul <vinod.koul@intel.com>; Rob Herring <robh+dt@kernel.org>;

> Mark Rutland <mark.rutland@arm.com>; Simon Horman

> <horms@verge.net.au>; Chris Paterson <Chris.Paterson2@renesas.com>;

> Fabrizio Castro <fabrizio.castro@bp.renesas.com>;

> devicetree@vger.kernel.org; Linux-Renesas <linux-renesas-

> soc@vger.kernel.org>; dmaengine@vger.kernel.org

> Subject: Re: [PATCH] dmaengine: usb-dmac: Add compatible string for

> r8a7743/5

>

> Hi Biju,

>

> On Thu, Oct 5, 2017 at 5:19 PM, Biju Das <biju.das@bp.renesas.com> wrote:

> > This patch adds support for r8a7743/5 SoC. The Renesas RZ/G1[ME]

> > (R8A7743/5) usbdmac engine is identical to the R-Car Gen2 family.

> >

> > This doesn't change the driver, so it does nothing by itself.  But it

> > does

>

> Wording it like this may give the wrong impression to the casual reader that a

> driver change will be submitted separately.

> No driver change is needed due to the fallback compatible value "renesas,usb-

> dmac".

>

> > mean that checkpatch won't complain about a future patch that adds

> > "renesas,r8a7743-usb-dmac" or "renesas,r8a7745-usb-dmac" to a DT,

> > which helps ensure that shipped DTs use documented compatibility strings.

>

> Adding the SoC-specific compatible values here has two purposes:

>   1. Document which SoCs have this hardware module,

>   2. Allow checkpatch to validate compatible values.


Thanks. I will send  v2 with above changes

> > Signed-off-by: Biju Das <biju.das@bp.renesas.com>

>

> Reviewed-by: Geert Uytterhoeven <geert+renesas@glider.be>

>




Renesas Electronics Europe Ltd, Dukes Meadow, Millboard Road, Bourne End, Buckinghamshire, SL8 5FH, UK. Registered in England & Wales under Registered No. 04586709.
diff mbox

Patch

diff --git a/Documentation/devicetree/bindings/dma/renesas,usb-dmac.txt b/Documentation/devicetree/bindings/dma/renesas,usb-dmac.txt
index 1be6941..f3d1f15 100644
--- a/Documentation/devicetree/bindings/dma/renesas,usb-dmac.txt
+++ b/Documentation/devicetree/bindings/dma/renesas,usb-dmac.txt
@@ -3,6 +3,8 @@ 
 Required Properties:
 -compatible: "renesas,<soctype>-usb-dmac", "renesas,usb-dmac" as fallback.
 	Examples with soctypes are:
+	  - "renesas,r8a7743-usb-dmac" (RZ/G1M)
+	  - "renesas,r8a7745-usb-dmac" (RZ/G1E)
 	  - "renesas,r8a7790-usb-dmac" (R-Car H2)
 	  - "renesas,r8a7791-usb-dmac" (R-Car M2-W)
 	  - "renesas,r8a7793-usb-dmac" (R-Car M2-N)