devicetree.vger.kernel.org archive mirror
 help / color / mirror / Atom feed
From: "Lad, Prabhakar" <prabhakar.csengg@gmail.com>
To: Krzysztof Kozlowski <krzk@kernel.org>
Cc: Andrew Lunn <andrew+netdev@lunn.ch>,
	"David S. Miller" <davem@davemloft.net>,
	 Eric Dumazet <edumazet@google.com>,
	Jakub Kicinski <kuba@kernel.org>, Paolo Abeni <pabeni@redhat.com>,
	 Rob Herring <robh@kernel.org>,
	Krzysztof Kozlowski <krzk+dt@kernel.org>,
	Conor Dooley <conor+dt@kernel.org>,
	 Maxime Coquelin <mcoquelin.stm32@gmail.com>,
	Alexandre Torgue <alexandre.torgue@foss.st.com>,
	 Russell King <linux@armlinux.org.uk>,
	Giuseppe Cavallaro <peppe.cavallaro@st.com>,
	 Jose Abreu <joabreu@synopsys.com>,
	Philipp Zabel <p.zabel@pengutronix.de>,
	 Geert Uytterhoeven <geert+renesas@glider.be>,
	Magnus Damm <magnus.damm@gmail.com>,
	 linux-renesas-soc@vger.kernel.org, netdev@vger.kernel.org,
	 devicetree@vger.kernel.org, linux-kernel@vger.kernel.org,
	 linux-stm32@st-md-mailman.stormreply.com,
	 linux-arm-kernel@lists.infradead.org,
	Biju Das <biju.das.jz@bp.renesas.com>,
	 Fabrizio Castro <fabrizio.castro.jz@renesas.com>,
	 Lad Prabhakar <prabhakar.mahadev-lad.rj@bp.renesas.com>
Subject: Re: [PATCH net-next 2/4] dt-bindings: net: renesas,rzv2h-gbeth: Document Renesas RZ/T2H and RZ/N2H SoCs
Date: Tue, 2 Sep 2025 16:47:09 +0100	[thread overview]
Message-ID: <CA+V-a8up6WfMzRCig=HCaU_QbC63FPCXyk1ZgJrNkGj+FsRbKA@mail.gmail.com> (raw)
In-Reply-To: <20250902-gainful-meerkat-of-prestige-dd4952@kuoka>

Hi Krzysztof,

Thank you for the review.

On Tue, Sep 2, 2025 at 10:01 AM Krzysztof Kozlowski <krzk@kernel.org> wrote:
>
> On Tue, Sep 02, 2025 at 01:13:00AM +0100, Prabhakar wrote:
> > From: Lad Prabhakar <prabhakar.mahadev-lad.rj@bp.renesas.com>
> >
> > Document the Ethernet MAC (GMAC) IP present on the Renesas RZ/T2H
> > (R9A09G077) and RZ/N2H (R9A09G087) SoCs. The GMAC IP on RZ/N2H is
> > identical to that found on the RZ/T2H SoC.
> >
> > While the RZ/V2H(P), RZ/T2H, and RZ/N2H SoCs all integrate the Synopsys
> > DesignWare MAC (version 5.20), the hardware is synthesized with different
> > options compared to the RZ/V2H(P):
> >   - RZ/T2H requires only 3 clocks instead of 7
> >   - RZ/T2H supports 8 RX/TX queue pairs instead of 4
> >   - RZ/T2H needs 2 reset controls with reset-names property, vs. a single
> >     unnamed reset
> >   - RZ/T2H has the split header feature enabled, while it is disabled on
> >     RZ/V2H(P)
> >
> > To accommodate these differences, introduce a new generic compatible
> > string `renesas,rzt2h-gbeth`, used as a fallback for both RZ/T2H and
> > RZ/N2H SoCs.
> >
> > The DT schema is updated to validate the clocks, resets, reset-names,
> > interrupts, and interrupt-names properties accordingly. Also extend
> > `snps,dwmac.yaml` with the new `renesas,rzt2h-gbeth` compatible.
> >
> > Signed-off-by: Lad Prabhakar <prabhakar.mahadev-lad.rj@bp.renesas.com>
> > ---
> >  .../bindings/net/renesas,rzv2h-gbeth.yaml     | 177 ++++++++++++++----
> >  .../devicetree/bindings/net/snps,dwmac.yaml   |   1 +
> >  2 files changed, 138 insertions(+), 40 deletions(-)
> >
> > diff --git a/Documentation/devicetree/bindings/net/renesas,rzv2h-gbeth.yaml b/Documentation/devicetree/bindings/net/renesas,rzv2h-gbeth.yaml
> > index 23e39bcea96b..e01763389164 100644
> > --- a/Documentation/devicetree/bindings/net/renesas,rzv2h-gbeth.yaml
> > +++ b/Documentation/devicetree/bindings/net/renesas,rzv2h-gbeth.yaml
> > @@ -17,63 +17,112 @@ select:
> >            - renesas,r9a09g047-gbeth
> >            - renesas,r9a09g056-gbeth
> >            - renesas,r9a09g057-gbeth
> > +          - renesas,r9a09g077-gbeth
> > +          - renesas,r9a09g087-gbeth
> >            - renesas,rzv2h-gbeth
> >    required:
> >      - compatible
> >
> >  properties:
> >    compatible:
> > -    items:
> > -      - enum:
> > -          - renesas,r9a09g047-gbeth # RZ/G3E
> > -          - renesas,r9a09g056-gbeth # RZ/V2N
> > -          - renesas,r9a09g057-gbeth # RZ/V2H(P)
> > -      - const: renesas,rzv2h-gbeth
> > -      - const: snps,dwmac-5.20
> > +    oneOf:
> > +      - items:
> > +          - enum:
> > +              - renesas,r9a09g047-gbeth # RZ/G3E
> > +              - renesas,r9a09g056-gbeth # RZ/V2N
> > +              - renesas,r9a09g057-gbeth # RZ/V2H(P)
> > +          - const: renesas,rzv2h-gbeth
> > +          - const: snps,dwmac-5.20
> > +
> > +      - items:
> > +          - enum:
> > +              - renesas,r9a09g077-gbeth # RZ/T2H
> > +              - renesas,r9a09g087-gbeth # RZ/N2H
> > +          - const: renesas,rzt2h-gbeth
> > +          - const: snps,dwmac-5.20
> >
> >    reg:
> >      maxItems: 1
> >
> >    clocks:
> > -    items:
> > -      - description: CSR clock
> > -      - description: AXI system clock
> > -      - description: PTP clock
> > -      - description: TX clock
> > -      - description: RX clock
> > -      - description: TX clock phase-shifted by 180 degrees
> > -      - description: RX clock phase-shifted by 180 degrees
> > +    oneOf:
> > +      - items:
> > +          - description: CSR clock
> > +          - description: AXI system clock
> > +          - description: PTP clock
> > +          - description: TX clock
> > +          - description: RX clock
> > +          - description: TX clock phase-shifted by 180 degrees
> > +          - description: RX clock phase-shifted by 180 degrees
> > +
>
> Drop blank line
>
OK.

> > +      - items:
> > +          - description: CSR clock
> > +          - description: AXI system clock
> > +          - description: TX clock
> >
> >    clock-names:
> > -    items:
> > -      - const: stmmaceth
> > -      - const: pclk
> > -      - const: ptp_ref
> > -      - const: tx
> > -      - const: rx
> > -      - const: tx-180
> > -      - const: rx-180
> > -
> > -  interrupts:
> > -    minItems: 11
> > +    oneOf:
> > +      - items:
> > +          - const: stmmaceth
> > +          - const: pclk
> > +          - const: ptp_ref
> > +          - const: tx
> > +          - const: rx
> > +          - const: tx-180
> > +          - const: rx-180
> > +
>
> Drop blank line
>
OK.

> > +      - items:
> > +          - const: stmmaceth
> > +          - const: pclk
> > +          - const: tx
> > +
> >
>
> Just one blank line
>
OK.

> >    interrupt-names:
> > -    items:
> > -      - const: macirq
> > -      - const: eth_wake_irq
> > -      - const: eth_lpi
> > -      - const: rx-queue-0
> > -      - const: rx-queue-1
> > -      - const: rx-queue-2
> > -      - const: rx-queue-3
> > -      - const: tx-queue-0
> > -      - const: tx-queue-1
> > -      - const: tx-queue-2
> > -      - const: tx-queue-3
> > +    oneOf:
> > +      - items:
> > +          - const: macirq
> > +          - const: eth_wake_irq
> > +          - const: eth_lpi
> > +          - const: rx-queue-0
> > +          - const: rx-queue-1
> > +          - const: rx-queue-2
> > +          - const: rx-queue-3
> > +          - const: tx-queue-0
> > +          - const: tx-queue-1
> > +          - const: tx-queue-2
> > +          - const: tx-queue-3
> > +
> > +      - items:
> > +          - const: macirq
> > +          - const: eth_wake_irq
> > +          - const: eth_lpi
> > +          - const: rx-queue-0
> > +          - const: rx-queue-1
> > +          - const: rx-queue-2
> > +          - const: rx-queue-3
> > +          - const: rx-queue-4
> > +          - const: rx-queue-5
> > +          - const: rx-queue-6
> > +          - const: rx-queue-7
> > +          - const: tx-queue-0
> > +          - const: tx-queue-1
> > +          - const: tx-queue-2
> > +          - const: tx-queue-3
> > +          - const: tx-queue-4
> > +          - const: tx-queue-5
> > +          - const: tx-queue-6
> > +          - const: tx-queue-7
> >
> >    resets:
> > -    items:
> > -      - description: AXI power-on system reset
> > +    oneOf:
> > +      - items:
> > +          - description: AXI power-on system reset
> > +
> > +      - items:
> > +          - description: GMAC stmmaceth reset
>
> That's the same as before, no?
>
Yes, I will update it.

> > +          - description: AHB reset
> > +
> > +  reset-names: true
>
> Does not look needed.
>
Agreed, I will drop it.

Cheers,
Prabhakar

  reply	other threads:[~2025-09-02 15:47 UTC|newest]

Thread overview: 12+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2025-09-02  0:12 [PATCH net-next 0/4] Add GMAC support for Renesas RZ/{T2H, N2H} SoCs Prabhakar
2025-09-02  0:12 ` [PATCH net-next 1/4] dt-bindings: net: dwmac: Increase 'maxItems' for 'interrupts' and 'interrupt-names' Prabhakar
2025-09-02  8:49   ` Krzysztof Kozlowski
2025-09-02 15:43     ` Lad, Prabhakar
2025-09-02 16:02       ` Krzysztof Kozlowski
2025-09-02  0:13 ` [PATCH net-next 2/4] dt-bindings: net: renesas,rzv2h-gbeth: Document Renesas RZ/T2H and RZ/N2H SoCs Prabhakar
2025-09-02  9:01   ` Krzysztof Kozlowski
2025-09-02 15:47     ` Lad, Prabhakar [this message]
2025-09-03  9:09   ` Geert Uytterhoeven
2025-09-03  9:56     ` Lad, Prabhakar
2025-09-02  0:13 ` [PATCH net-next 3/4] net: stmmac: dwmac-renesas-gbeth: Use OF data for configuration Prabhakar
2025-09-02  0:13 ` [PATCH net-next 4/4] net: stmmac: dwmac-renesas-gbeth: Add support for RZ/T2H SoC Prabhakar

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to='CA+V-a8up6WfMzRCig=HCaU_QbC63FPCXyk1ZgJrNkGj+FsRbKA@mail.gmail.com' \
    --to=prabhakar.csengg@gmail.com \
    --cc=alexandre.torgue@foss.st.com \
    --cc=andrew+netdev@lunn.ch \
    --cc=biju.das.jz@bp.renesas.com \
    --cc=conor+dt@kernel.org \
    --cc=davem@davemloft.net \
    --cc=devicetree@vger.kernel.org \
    --cc=edumazet@google.com \
    --cc=fabrizio.castro.jz@renesas.com \
    --cc=geert+renesas@glider.be \
    --cc=joabreu@synopsys.com \
    --cc=krzk+dt@kernel.org \
    --cc=krzk@kernel.org \
    --cc=kuba@kernel.org \
    --cc=linux-arm-kernel@lists.infradead.org \
    --cc=linux-kernel@vger.kernel.org \
    --cc=linux-renesas-soc@vger.kernel.org \
    --cc=linux-stm32@st-md-mailman.stormreply.com \
    --cc=linux@armlinux.org.uk \
    --cc=magnus.damm@gmail.com \
    --cc=mcoquelin.stm32@gmail.com \
    --cc=netdev@vger.kernel.org \
    --cc=p.zabel@pengutronix.de \
    --cc=pabeni@redhat.com \
    --cc=peppe.cavallaro@st.com \
    --cc=prabhakar.mahadev-lad.rj@bp.renesas.com \
    --cc=robh@kernel.org \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).