mbox series

[V1,resend,0/6] Document r8a774a3 SoC bindings

Message ID 20240723110733.10988-1-oliver.rhodes.aj@renesas.com (mailing list archive)
Headers show
Series Document r8a774a3 SoC bindings | expand

Message

Oliver Rhodes July 23, 2024, 11:07 a.m. UTC
Hi all,

This patch series updates the renesas DT bindings documentation for core
components (SoC, SYSC, reset, clk, pinctrl, scif) on the RZ/G2M v3.0 (R8A774A3) SoC.
This SoC is similar to R-CAR M3-W+ (R8A77961) SoC.

v1->v1 resend:
* Fixed commit header for patch #4.

Oliver Rhodes (6):
  dt-bindings: soc: renesas: Document RZ/G2M v3.0 (r8a774a3) SoC
  dt-bindings: power: renesas: Document RZ/G2M v3.0 (r8a774a3) SYSC
    binding
  dt-bindings: clock: renesas: Document RZ/G2M v3.0 (r8a774a3) clock
  dt-bindings: reset: renesas: Document RZ/G2M v3.0 (r8a774a3) reset
    module
  dt-bindings: serial: renesas: Document RZ/G2M v3.0 (r8a774a3) scif
  dt-bindings: pinctrl: renesas: Document RZ/G2M v3.0 (r8a774a3) PFC
    support

 .../devicetree/bindings/clock/renesas,cpg-mssr.yaml  |  1 +
 .../devicetree/bindings/pinctrl/renesas,pfc.yaml     |  1 +
 .../devicetree/bindings/power/renesas,rcar-sysc.yaml |  1 +
 .../devicetree/bindings/reset/renesas,rst.yaml       |  1 +
 .../devicetree/bindings/serial/renesas,scif.yaml     |  1 +
 .../devicetree/bindings/soc/renesas/renesas.yaml     | 12 ++++++++++++
 6 files changed, 17 insertions(+)

Comments

Conor Dooley July 23, 2024, 2:05 p.m. UTC | #1
On Tue, Jul 23, 2024 at 12:07:27PM +0100, Oliver Rhodes wrote:
> Hi all,
> 
> This patch series updates the renesas DT bindings documentation for core
> components (SoC, SYSC, reset, clk, pinctrl, scif) on the RZ/G2M v3.0 (R8A774A3) SoC.
> This SoC is similar to R-CAR M3-W+ (R8A77961) SoC.

Your commit messages for any binding without a fallback compatible need
to mention why this device is not compatible with the !v3.0 SoC.
Oliver Rhodes July 23, 2024, 3:15 p.m. UTC | #2
Hi Conor,

Thank you for the comment.

> -----Original Message-----
> From: Conor Dooley <conor@kernel.org>
> Sent: Tuesday, July 23, 2024 3:05 PM
> To: Oliver Rhodes <oliver.rhodes.aj@renesas.com>
> Cc: Rob Herring <robh@kernel.org>; Krzysztof Kozlowski <krzk+dt@kernel.org>; Conor Dooley
> <conor+dt@kernel.org>; Geert Uytterhoeven <geert+renesas@glider.be>; Magnus Damm
> <magnus.damm@gmail.com>; linux-renesas-soc@vger.kernel.org; devicetree@vger.kernel.org
> Subject: Re: [PATCH V1 resend 0/6] Document r8a774a3 SoC bindings
>
> On Tue, Jul 23, 2024 at 12:07:27PM +0100, Oliver Rhodes wrote:
> > Hi all,
> >
> > This patch series updates the renesas DT bindings documentation for
> > core components (SoC, SYSC, reset, clk, pinctrl, scif) on the RZ/G2M v3.0 (R8A774A3) SoC.
> > This SoC is similar to R-CAR M3-W+ (R8A77961) SoC.
>
> Your commit messages for any binding without a fallback compatible need to mention why this device is
> not compatible with the !v3.0 SoC.

For SoC identification, it is a different SoC altogether, so we need to use a dedicated compatible.
For SYSC, it lacks the A2VC power area compared to the RZ/G2M v1.X so we cannot use family compatible.
Similarly for clock, it lacks some modules such as the FCPCI, so we need to use a dedicated compatible.

R-CAR M3-W (r8a77960) is similar to RZ/G2M (r8a774a1) and R-CAR M3-W+ (r8a77961) is similar to RZ/G2M v3.0(r8a774a3).
So, I referred R-CAR M3-W+ bindings and made similar changes for this SoC.

I will update the commit messages for SoC, SYSC and clk to reflect this.

Thank you,
Oliver