All of lore.kernel.org
 help / color / mirror / Atom feed
From: Conor Dooley <conor@kernel.org>
To: Rob Herring <robh@kernel.org>
Cc: Tommaso Merciai <tommaso.merciai.xr@bp.renesas.com>,
	tomm.merciai@gmail.com, linux-renesas-soc@vger.kernel.org,
	biju.das.jz@bp.renesas.com, Vinod Koul <vkoul@kernel.org>,
	Kishon Vijay Abraham I <kishon@kernel.org>,
	Krzysztof Kozlowski <krzk+dt@kernel.org>,
	Conor Dooley <conor+dt@kernel.org>,
	Fabrizio Castro <fabrizio.castro.jz@renesas.com>,
	Lad Prabhakar <prabhakar.mahadev-lad.rj@bp.renesas.com>,
	Philipp Zabel <p.zabel@pengutronix.de>,
	Peter Rosin <peda@axentia.se>,
	Yoshihiro Shimoda <yoshihiro.shimoda.uh@renesas.com>,
	Geert Uytterhoeven <geert+renesas@glider.be>,
	Magnus Damm <magnus.damm@gmail.com>,
	Arnd Bergmann <arnd@arndb.de>,
	Greg Kroah-Hartman <gregkh@linuxfoundation.org>,
	linux-phy@lists.infradead.org, devicetree@vger.kernel.org,
	linux-kernel@vger.kernel.org
Subject: Re: [PATCH v3 04/21] dt-bindings: reset: renesas,rzv2h-usb2phy: Document VBUS_SEL mux
Date: Wed, 12 Nov 2025 18:48:16 +0000	[thread overview]
Message-ID: <20251112-launch-overcoat-18c3924b9b3f@spud> (raw)
In-Reply-To: <20251112163712.GA1850277-robh@kernel.org>


[-- Attachment #1.1: Type: text/plain, Size: 2927 bytes --]

On Wed, Nov 12, 2025 at 10:37:12AM -0600, Rob Herring wrote:
> On Tue, Nov 11, 2025 at 05:49:24PM +0000, Conor Dooley wrote:
> > Tommaso, Rob,
> > 
> > On Mon, Nov 10, 2025 at 11:43:37PM +0100, Tommaso Merciai wrote:
> > > Hi Conor,
> > > Thanks for your comment!
> > > 
> > > On Mon, Nov 10, 2025 at 06:56:31PM +0000, Conor Dooley wrote:
> > > > On Mon, Nov 10, 2025 at 01:08:04PM +0100, Tommaso Merciai wrote:
> > > > > Document the 'mux-controller' child node in the Renesas RZ/V2H(P)
> > > > > USB2PHY reset binding to support describing the USB VBUS_SEL
> > > > > multiplexer as a mux-controller.
> > > > > 
> > > > > This is required to properly configure the USB PHY VBUS source on
> > > > > RZ/V2H(P), RZ/G3E SoCs.
> > > > > 
> > > > > Signed-off-by: Tommaso Merciai <tommaso.merciai.xr@bp.renesas.com>
> > > > > ---
> > > > > v2->v3:
> > > > >  - Manipulate mux-controller as an internal node.
> > > > 
> > > > Why is it a child node, rather than just putting the cell in the parent
> > > > reset node?
> > > 
> > > Getting "make dt_binding_check errors" [1] in v2
> > > Adding #mux-state-cells = <1> into:
> > > 
> > > 	usb20phyrst: reset-controller@15830000
> > > 	usb21phyrst: reset-controller@15840000
> > > 
> > > Nodes.
> > > 
> > > Please correct me if I'm wrong.
> > 
> > I think that that binding is not working as intended. Why require a
> > node-name pattern, when it matches on other things too:
> > select:
> >   anyOf:
> >     - properties:
> >         $nodename:
> >           pattern: '^mux-controller'
> >     - required:
> >         - '#mux-control-cells'
> >     - required:
> >         - '#mux-state-cells'
> > if the node name always contained mux-controller, the second two here
> > would not be needed. Looks to me like the intention was for it to allow
> > putting these control/state-cells properties into mfd type nodes.
> > 
> > I'd delete the node name property tbh. Rob, you converted this to
> > schema, what do you think?
> 
> Yeah, I'd probably just comment it out and drop the select.

Is dropping the select okay to do, or should just the nodename portion
go? I think there's a couple users that would need to be fixed up if the
whole thing gets removed. E.g. gpio-mux and reg-mux bot rely on the
schema being applied automagically AFAICT, and maybe there's some others.
Although, 99% of mux-controllers seem to use gpio-mux, reg-mux and
mmio-mux which are covered by those two files.

> I'm not sure what to do here in general. Matching on node names was 
> useful early on, but that becomes less useful as we have schemas for 
> everything. I'd still like to document standard node names in schemas 
> somehow, but obviously we can't require a certain name when a node is 
> multiple providers. Ideally, every node name in the list in the DT spec 
> would be in schemas and we could generate that list.
> 
> Rob

[-- Attachment #1.2: signature.asc --]
[-- Type: application/pgp-signature, Size: 228 bytes --]

[-- Attachment #2: Type: text/plain, Size: 112 bytes --]

-- 
linux-phy mailing list
linux-phy@lists.infradead.org
https://lists.infradead.org/mailman/listinfo/linux-phy

WARNING: multiple messages have this Message-ID (diff)
From: Conor Dooley <conor@kernel.org>
To: Rob Herring <robh@kernel.org>
Cc: Tommaso Merciai <tommaso.merciai.xr@bp.renesas.com>,
	tomm.merciai@gmail.com, linux-renesas-soc@vger.kernel.org,
	biju.das.jz@bp.renesas.com, Vinod Koul <vkoul@kernel.org>,
	Kishon Vijay Abraham I <kishon@kernel.org>,
	Krzysztof Kozlowski <krzk+dt@kernel.org>,
	Conor Dooley <conor+dt@kernel.org>,
	Fabrizio Castro <fabrizio.castro.jz@renesas.com>,
	Lad Prabhakar <prabhakar.mahadev-lad.rj@bp.renesas.com>,
	Philipp Zabel <p.zabel@pengutronix.de>,
	Peter Rosin <peda@axentia.se>,
	Yoshihiro Shimoda <yoshihiro.shimoda.uh@renesas.com>,
	Geert Uytterhoeven <geert+renesas@glider.be>,
	Magnus Damm <magnus.damm@gmail.com>,
	Arnd Bergmann <arnd@arndb.de>,
	Greg Kroah-Hartman <gregkh@linuxfoundation.org>,
	linux-phy@lists.infradead.org, devicetree@vger.kernel.org,
	linux-kernel@vger.kernel.org
Subject: Re: [PATCH v3 04/21] dt-bindings: reset: renesas,rzv2h-usb2phy: Document VBUS_SEL mux
Date: Wed, 12 Nov 2025 18:48:16 +0000	[thread overview]
Message-ID: <20251112-launch-overcoat-18c3924b9b3f@spud> (raw)
In-Reply-To: <20251112163712.GA1850277-robh@kernel.org>

[-- Attachment #1: Type: text/plain, Size: 2927 bytes --]

On Wed, Nov 12, 2025 at 10:37:12AM -0600, Rob Herring wrote:
> On Tue, Nov 11, 2025 at 05:49:24PM +0000, Conor Dooley wrote:
> > Tommaso, Rob,
> > 
> > On Mon, Nov 10, 2025 at 11:43:37PM +0100, Tommaso Merciai wrote:
> > > Hi Conor,
> > > Thanks for your comment!
> > > 
> > > On Mon, Nov 10, 2025 at 06:56:31PM +0000, Conor Dooley wrote:
> > > > On Mon, Nov 10, 2025 at 01:08:04PM +0100, Tommaso Merciai wrote:
> > > > > Document the 'mux-controller' child node in the Renesas RZ/V2H(P)
> > > > > USB2PHY reset binding to support describing the USB VBUS_SEL
> > > > > multiplexer as a mux-controller.
> > > > > 
> > > > > This is required to properly configure the USB PHY VBUS source on
> > > > > RZ/V2H(P), RZ/G3E SoCs.
> > > > > 
> > > > > Signed-off-by: Tommaso Merciai <tommaso.merciai.xr@bp.renesas.com>
> > > > > ---
> > > > > v2->v3:
> > > > >  - Manipulate mux-controller as an internal node.
> > > > 
> > > > Why is it a child node, rather than just putting the cell in the parent
> > > > reset node?
> > > 
> > > Getting "make dt_binding_check errors" [1] in v2
> > > Adding #mux-state-cells = <1> into:
> > > 
> > > 	usb20phyrst: reset-controller@15830000
> > > 	usb21phyrst: reset-controller@15840000
> > > 
> > > Nodes.
> > > 
> > > Please correct me if I'm wrong.
> > 
> > I think that that binding is not working as intended. Why require a
> > node-name pattern, when it matches on other things too:
> > select:
> >   anyOf:
> >     - properties:
> >         $nodename:
> >           pattern: '^mux-controller'
> >     - required:
> >         - '#mux-control-cells'
> >     - required:
> >         - '#mux-state-cells'
> > if the node name always contained mux-controller, the second two here
> > would not be needed. Looks to me like the intention was for it to allow
> > putting these control/state-cells properties into mfd type nodes.
> > 
> > I'd delete the node name property tbh. Rob, you converted this to
> > schema, what do you think?
> 
> Yeah, I'd probably just comment it out and drop the select.

Is dropping the select okay to do, or should just the nodename portion
go? I think there's a couple users that would need to be fixed up if the
whole thing gets removed. E.g. gpio-mux and reg-mux bot rely on the
schema being applied automagically AFAICT, and maybe there's some others.
Although, 99% of mux-controllers seem to use gpio-mux, reg-mux and
mmio-mux which are covered by those two files.

> I'm not sure what to do here in general. Matching on node names was 
> useful early on, but that becomes less useful as we have schemas for 
> everything. I'd still like to document standard node names in schemas 
> somehow, but obviously we can't require a certain name when a node is 
> multiple providers. Ideally, every node name in the list in the DT spec 
> would be in schemas and we could generate that list.
> 
> Rob

[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 228 bytes --]

  reply	other threads:[~2025-11-12 18:48 UTC|newest]

Thread overview: 64+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2025-11-10 12:08 [PATCH v3 00/21] Add USB2.0 support for RZ/G3E Tommaso Merciai
2025-11-10 12:08 ` Tommaso Merciai
2025-11-10 12:08 ` [PATCH v3 01/21] phy: renesas: rcar-gen3-usb2: Use devm_pm_runtime_enable() Tommaso Merciai
2025-11-10 12:08   ` Tommaso Merciai
2025-11-10 12:08 ` [PATCH v3 02/21] phy: renesas: rcar-gen3-usb2: Factor out VBUS control logic Tommaso Merciai
2025-11-10 12:08   ` Tommaso Merciai
2025-11-10 12:08 ` [PATCH v3 03/21] reset: rzv2h-usb2phy: Keep PHY clock enabled for entire device lifetime Tommaso Merciai
2025-11-10 12:08   ` Tommaso Merciai
2025-11-10 12:08 ` [PATCH v3 04/21] dt-bindings: reset: renesas,rzv2h-usb2phy: Document VBUS_SEL mux Tommaso Merciai
2025-11-10 12:08   ` Tommaso Merciai
2025-11-10 18:56   ` Conor Dooley
2025-11-10 18:56     ` Conor Dooley
2025-11-10 22:43     ` Tommaso Merciai
2025-11-10 22:43       ` Tommaso Merciai
2025-11-11 17:49       ` Conor Dooley
2025-11-11 17:49         ` Conor Dooley
2025-11-12 16:37         ` Rob Herring
2025-11-12 16:37           ` Rob Herring
2025-11-12 18:48           ` Conor Dooley [this message]
2025-11-12 18:48             ` Conor Dooley
2025-11-17  7:00   ` Krzysztof Kozlowski
2025-11-17  7:00     ` Krzysztof Kozlowski
2025-11-17 14:44     ` Tommaso Merciai
2025-11-17 14:44       ` Tommaso Merciai
2025-11-10 12:08 ` [PATCH v3 05/21] mux: Add driver for Renesas RZ/V2H USB " Tommaso Merciai
2025-11-10 12:08   ` Tommaso Merciai
2025-11-10 12:08 ` [PATCH v3 06/21] reset: rzv2h-usb2phy: Add support for VBUS mux controller registration Tommaso Merciai
2025-11-10 12:08   ` Tommaso Merciai
2025-11-10 12:08 ` [PATCH v3 07/21] dt-bindings: phy: renesas,usb2-phy: Document USB VBUS regulator Tommaso Merciai
2025-11-10 12:08   ` Tommaso Merciai
2025-11-10 12:08 ` [PATCH v3 08/21] dt-bindings: phy: renesas,usb2-phy: Document mux-states property Tommaso Merciai
2025-11-10 12:08   ` Tommaso Merciai
2025-11-10 18:54   ` Conor Dooley
2025-11-10 18:54     ` Conor Dooley
2025-11-10 12:08 ` [PATCH v3 09/21] phy: renesas: rcar-gen3-usb2: Add regulator for OTG VBUS control Tommaso Merciai
2025-11-10 12:08   ` Tommaso Merciai
2025-11-10 12:08 ` [PATCH v3 10/21] phy: renesas: rcar-gen3-usb2: Use mux-state for phyrst management Tommaso Merciai
2025-11-10 12:08   ` Tommaso Merciai
2025-11-13 19:27   ` Geert Uytterhoeven
2025-11-13 19:27     ` Geert Uytterhoeven
2025-11-14  8:21     ` Tommaso Merciai
2025-11-14  8:21       ` Tommaso Merciai
2025-11-10 12:08 ` [PATCH v3 11/21] dt-bindings: usb: renesas,usbhs: Add RZ/G3E SoC support Tommaso Merciai
2025-11-10 12:08   ` Tommaso Merciai
2025-11-10 12:08 ` [PATCH v3 12/21] dt-bindings: phy: renesas,usb2-phy: Document RZ/G3E SoC Tommaso Merciai
2025-11-10 12:08   ` Tommaso Merciai
2025-11-10 12:08 ` [PATCH v3 13/21] dt-bindings: reset: Document RZ/G3E USB2PHY reset Tommaso Merciai
2025-11-10 12:08   ` Tommaso Merciai
2025-11-10 12:08 ` [PATCH v3 14/21] arm64: dts: renesas: r9a09g057: Add USB2.0 VBUS_SEL mux-controller support Tommaso Merciai
2025-11-10 12:08   ` Tommaso Merciai
2025-11-10 12:08 ` [PATCH v3 15/21] arm64: dts: renesas: r9a09g056: " Tommaso Merciai
2025-11-10 12:08   ` Tommaso Merciai
2025-11-10 12:08 ` [PATCH v3 16/21] arm64: dts: renesas: r9a09g056: Add USB2.0 PHY VBUS internal regulator node Tommaso Merciai
2025-11-10 12:08   ` Tommaso Merciai
2025-11-10 12:08 ` [PATCH v3 17/21] arm64: dts: renesas: r9a09g056n48-rzv2n-evk: Enable USB2 PHY0 VBUS support Tommaso Merciai
2025-11-10 12:08   ` Tommaso Merciai
2025-11-10 12:08 ` [PATCH v3 18/21] arm64: dts: renesas: r9a09g057: Add USB2.0 PHY VBUS internal regulator node Tommaso Merciai
2025-11-10 12:08   ` Tommaso Merciai
2025-11-10 12:08 ` [PATCH v3 19/21] arm64: dts: renesas: r9a09g057h44-rzv2h-evk: Enable USB2 PHY0 VBUS support Tommaso Merciai
2025-11-10 12:08   ` Tommaso Merciai
2025-11-10 12:08 ` [PATCH v3 20/21] arm64: dts: renesas: r9a09g047: Add USB2.0 support Tommaso Merciai
2025-11-10 12:08   ` Tommaso Merciai
2025-11-10 12:08 ` [PATCH v3 21/21] arm64: dts: renesas: r9a09g047e57-smarc: Enable " Tommaso Merciai
2025-11-10 12:08   ` Tommaso Merciai

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=20251112-launch-overcoat-18c3924b9b3f@spud \
    --to=conor@kernel.org \
    --cc=arnd@arndb.de \
    --cc=biju.das.jz@bp.renesas.com \
    --cc=conor+dt@kernel.org \
    --cc=devicetree@vger.kernel.org \
    --cc=fabrizio.castro.jz@renesas.com \
    --cc=geert+renesas@glider.be \
    --cc=gregkh@linuxfoundation.org \
    --cc=kishon@kernel.org \
    --cc=krzk+dt@kernel.org \
    --cc=linux-kernel@vger.kernel.org \
    --cc=linux-phy@lists.infradead.org \
    --cc=linux-renesas-soc@vger.kernel.org \
    --cc=magnus.damm@gmail.com \
    --cc=p.zabel@pengutronix.de \
    --cc=peda@axentia.se \
    --cc=prabhakar.mahadev-lad.rj@bp.renesas.com \
    --cc=robh@kernel.org \
    --cc=tomm.merciai@gmail.com \
    --cc=tommaso.merciai.xr@bp.renesas.com \
    --cc=vkoul@kernel.org \
    --cc=yoshihiro.shimoda.uh@renesas.com \
    /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 an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.