diff mbox series

dt-bindings: usb: Add Marvell ac5

Message ID 20240107152557.3561341-1-enachman@marvell.com
State Superseded
Headers show
Series dt-bindings: usb: Add Marvell ac5 | expand

Checks

Context Check Description
robh/checkpatch success
robh/patch-applied success
robh/dtbs-check warning build log
robh/dt-meta-schema success

Commit Message

Elad Nachman Jan. 7, 2024, 3:25 p.m. UTC
From: Elad Nachman <enachman@marvell.com>

Add Marvell ac5 device tree bindings to generic EHCI.
This compatible enables the Marvell Orion platform code
to properly configure the DMA mask for the Marvell AC5 SOC.

Signed-off-by: Elad Nachman <enachman@marvell.com>
---
 Documentation/devicetree/bindings/usb/generic-ehci.yaml | 1 +
 1 file changed, 1 insertion(+)

Comments

Conor Dooley Jan. 8, 2024, 5:15 p.m. UTC | #1
On Sun, Jan 07, 2024 at 05:25:57PM +0200, Elad Nachman wrote:
> From: Elad Nachman <enachman@marvell.com>
> 
> Add Marvell ac5 device tree bindings to generic EHCI.
> This compatible enables the Marvell Orion platform code
> to properly configure the DMA mask for the Marvell AC5 SOC.
> 
> Signed-off-by: Elad Nachman <enachman@marvell.com>

Maybe I am dumb, but I don't understand how this does what the commit
message says. There's no fallback to generic-ehci or any other
compatible that is already understood by the driver.

What am I missing?

> ---
>  Documentation/devicetree/bindings/usb/generic-ehci.yaml | 1 +
>  1 file changed, 1 insertion(+)
> 
> diff --git a/Documentation/devicetree/bindings/usb/generic-ehci.yaml b/Documentation/devicetree/bindings/usb/generic-ehci.yaml
> index 87986c45be88..2ed178f16a78 100644
> --- a/Documentation/devicetree/bindings/usb/generic-ehci.yaml
> +++ b/Documentation/devicetree/bindings/usb/generic-ehci.yaml
> @@ -77,6 +77,7 @@ properties:
>            - const: usb-ehci
>        - enum:
>            - generic-ehci
> +          - marvell,ac5-ehci
>            - marvell,armada-3700-ehci
>            - marvell,orion-ehci
>            - nuvoton,npcm750-ehci
> -- 
> 2.25.1
>
Elad Nachman Jan. 8, 2024, 5:47 p.m. UTC | #2
> -----Original Message-----
> From: Conor Dooley <conor@kernel.org>
> Sent: Monday, January 8, 2024 7:15 PM
> To: Elad Nachman <enachman@marvell.com>
> Cc: gregkh@linuxfoundation.org; robh+dt@kernel.org;
> krzysztof.kozlowski+dt@linaro.org; conor+dt@kernel.org;
> devicetree@vger.kernel.org; linux-usb@vger.kernel.org; linux-
> kernel@vger.kernel.org
> Subject: [EXT] Re: [PATCH] dt-bindings: usb: Add Marvell ac5
> 
> External Email
> 
> ----------------------------------------------------------------------
> On Sun, Jan 07, 2024 at 05:25:57PM +0200, Elad Nachman wrote:
> > From: Elad Nachman <enachman@marvell.com>
> >
> > Add Marvell ac5 device tree bindings to generic EHCI.
> > This compatible enables the Marvell Orion platform code to properly
> > configure the DMA mask for the Marvell AC5 SOC.
> >
> > Signed-off-by: Elad Nachman <enachman@marvell.com>
> 
> Maybe I am dumb, but I don't understand how this does what the commit
> message says. There's no fallback to generic-ehci or any other compatible
> that is already understood by the driver.
> 
> What am I missing?

Following guidance by Andrew Lunn on my mmc patchset, I have split the patchset
Into a single patch for dt-bindings review and another for USB driver review.

The USB driver patch utilizing this new dt bindings compatible string is here:

https://patchwork.kernel.org/project/linux-usb/patch/20240107163307.3677347-1-enachman@marvell.com/

> 
> > ---
> >  Documentation/devicetree/bindings/usb/generic-ehci.yaml | 1 +
> >  1 file changed, 1 insertion(+)
> >
> > diff --git a/Documentation/devicetree/bindings/usb/generic-ehci.yaml
> > b/Documentation/devicetree/bindings/usb/generic-ehci.yaml
> > index 87986c45be88..2ed178f16a78 100644
> > --- a/Documentation/devicetree/bindings/usb/generic-ehci.yaml
> > +++ b/Documentation/devicetree/bindings/usb/generic-ehci.yaml
> > @@ -77,6 +77,7 @@ properties:
> >            - const: usb-ehci
> >        - enum:
> >            - generic-ehci
> > +          - marvell,ac5-ehci
> >            - marvell,armada-3700-ehci
> >            - marvell,orion-ehci
> >            - nuvoton,npcm750-ehci
> > --
> > 2.25.1
> >

Elad.
Conor Dooley Jan. 8, 2024, 6:01 p.m. UTC | #3
On Mon, Jan 08, 2024 at 05:47:24PM +0000, Elad Nachman wrote:
> 
> 
> > -----Original Message-----
> > From: Conor Dooley <conor@kernel.org>
> > Sent: Monday, January 8, 2024 7:15 PM
> > To: Elad Nachman <enachman@marvell.com>
> > Cc: gregkh@linuxfoundation.org; robh+dt@kernel.org;
> > krzysztof.kozlowski+dt@linaro.org; conor+dt@kernel.org;
> > devicetree@vger.kernel.org; linux-usb@vger.kernel.org; linux-
> > kernel@vger.kernel.org
> > Subject: [EXT] Re: [PATCH] dt-bindings: usb: Add Marvell ac5
> > 
> > External Email
> > 
> > ----------------------------------------------------------------------
> > On Sun, Jan 07, 2024 at 05:25:57PM +0200, Elad Nachman wrote:
> > > From: Elad Nachman <enachman@marvell.com>
> > >
> > > Add Marvell ac5 device tree bindings to generic EHCI.
> > > This compatible enables the Marvell Orion platform code to properly
> > > configure the DMA mask for the Marvell AC5 SOC.
> > >
> > > Signed-off-by: Elad Nachman <enachman@marvell.com>
> > 
> > Maybe I am dumb, but I don't understand how this does what the commit
> > message says. There's no fallback to generic-ehci or any other compatible
> > that is already understood by the driver.
> > 
> > What am I missing?
> 
> Following guidance by Andrew Lunn on my mmc patchset, I have split the patchset
> Into a single patch for dt-bindings review and another for USB driver review.

I don't understand that advice. dt-bindings should (almost) always be
with the driver. Otherwise you just confuse people like me.

Perhaps Andrew meant sending dt*s* patches separately from the driver &
bindings?

Cheers,
Conor.

> 
> The USB driver patch utilizing this new dt bindings compatible string is here:
> 
> https://patchwork.kernel.org/project/linux-usb/patch/20240107163307.3677347-1-enachman@marvell.com/
> 
> > 
> > > ---
> > >  Documentation/devicetree/bindings/usb/generic-ehci.yaml | 1 +
> > >  1 file changed, 1 insertion(+)
> > >
> > > diff --git a/Documentation/devicetree/bindings/usb/generic-ehci.yaml
> > > b/Documentation/devicetree/bindings/usb/generic-ehci.yaml
> > > index 87986c45be88..2ed178f16a78 100644
> > > --- a/Documentation/devicetree/bindings/usb/generic-ehci.yaml
> > > +++ b/Documentation/devicetree/bindings/usb/generic-ehci.yaml
> > > @@ -77,6 +77,7 @@ properties:
> > >            - const: usb-ehci
> > >        - enum:
> > >            - generic-ehci
> > > +          - marvell,ac5-ehci
> > >            - marvell,armada-3700-ehci
> > >            - marvell,orion-ehci
> > >            - nuvoton,npcm750-ehci
> > > --
> > > 2.25.1
> > >
> 
> Elad.
Elad Nachman Jan. 8, 2024, 6:15 p.m. UTC | #4
> -----Original Message-----
> From: Conor Dooley <conor@kernel.org>
> Sent: Monday, January 8, 2024 8:01 PM
> To: Elad Nachman <enachman@marvell.com>
> Cc: gregkh@linuxfoundation.org; robh+dt@kernel.org;
> krzysztof.kozlowski+dt@linaro.org; conor+dt@kernel.org;
> devicetree@vger.kernel.org; linux-usb@vger.kernel.org; linux-
> kernel@vger.kernel.org
> Subject: Re: [EXT] Re: [PATCH] dt-bindings: usb: Add Marvell ac5
> 
> On Mon, Jan 08, 2024 at 05:47:24PM +0000, Elad Nachman wrote:
> >
> >
> > > -----Original Message-----
> > > From: Conor Dooley <conor@kernel.org>
> > > Sent: Monday, January 8, 2024 7:15 PM
> > > To: Elad Nachman <enachman@marvell.com>
> > > Cc: gregkh@linuxfoundation.org; robh+dt@kernel.org;
> > > krzysztof.kozlowski+dt@linaro.org; conor+dt@kernel.org;
> > > devicetree@vger.kernel.org; linux-usb@vger.kernel.org; linux-
> > > kernel@vger.kernel.org
> > > Subject: [EXT] Re: [PATCH] dt-bindings: usb: Add Marvell ac5
> > >
> > > External Email
> > >
> > > --------------------------------------------------------------------
> > > -- On Sun, Jan 07, 2024 at 05:25:57PM +0200, Elad Nachman wrote:
> > > > From: Elad Nachman <enachman@marvell.com>
> > > >
> > > > Add Marvell ac5 device tree bindings to generic EHCI.
> > > > This compatible enables the Marvell Orion platform code to
> > > > properly configure the DMA mask for the Marvell AC5 SOC.
> > > >
> > > > Signed-off-by: Elad Nachman <enachman@marvell.com>
> > >
> > > Maybe I am dumb, but I don't understand how this does what the
> > > commit message says. There's no fallback to generic-ehci or any
> > > other compatible that is already understood by the driver.
> > >
> > > What am I missing?
> >
> > Following guidance by Andrew Lunn on my mmc patchset, I have split the
> > patchset Into a single patch for dt-bindings review and another for USB
> driver review.
> 
> I don't understand that advice. dt-bindings should (almost) always be with
> the driver. Otherwise you just confuse people like me.
> 
> Perhaps Andrew meant sending dt*s* patches separately from the driver &
> bindings?

The rational was different people making the actual merge, into different intermediate git REPOs, before mering into linux-next.

> 
> Cheers,
> Conor.
> 
> >
> > The USB driver patch utilizing this new dt bindings compatible string is here:
> >
> > https://patchwork.kernel.org/project/linux-usb/patch/20240107163307.36
> > 77347-1-enachman@marvell.com/
> >
> > >
> > > > ---
> > > >  Documentation/devicetree/bindings/usb/generic-ehci.yaml | 1 +
> > > >  1 file changed, 1 insertion(+)
> > > >
> > > > diff --git
> > > > a/Documentation/devicetree/bindings/usb/generic-ehci.yaml
> > > > b/Documentation/devicetree/bindings/usb/generic-ehci.yaml
> > > > index 87986c45be88..2ed178f16a78 100644
> > > > --- a/Documentation/devicetree/bindings/usb/generic-ehci.yaml
> > > > +++ b/Documentation/devicetree/bindings/usb/generic-ehci.yaml
> > > > @@ -77,6 +77,7 @@ properties:
> > > >            - const: usb-ehci
> > > >        - enum:
> > > >            - generic-ehci
> > > > +          - marvell,ac5-ehci
> > > >            - marvell,armada-3700-ehci
> > > >            - marvell,orion-ehci
> > > >            - nuvoton,npcm750-ehci
> > > > --
> > > > 2.25.1
> > > >
> >
> > Elad.

Elad.
Conor Dooley Jan. 8, 2024, 6:23 p.m. UTC | #5
On Mon, Jan 08, 2024 at 06:15:51PM +0000, Elad Nachman wrote:
> > -----Original Message-----
> > From: Conor Dooley <conor@kernel.org>
> > On Mon, Jan 08, 2024 at 05:47:24PM +0000, Elad Nachman wrote:
> > > > -----Original Message-----
> > > > From: Conor Dooley <conor@kernel.org>
> > > > -- On Sun, Jan 07, 2024 at 05:25:57PM +0200, Elad Nachman wrote:
> > > > > From: Elad Nachman <enachman@marvell.com>
> > > > >
> > > > > Add Marvell ac5 device tree bindings to generic EHCI.
> > > > > This compatible enables the Marvell Orion platform code to
> > > > > properly configure the DMA mask for the Marvell AC5 SOC.
> > > > >
> > > > > Signed-off-by: Elad Nachman <enachman@marvell.com>
> > > >
> > > > Maybe I am dumb, but I don't understand how this does what the
> > > > commit message says. There's no fallback to generic-ehci or any
> > > > other compatible that is already understood by the driver.
> > > >
> > > > What am I missing?
> > >
> > > Following guidance by Andrew Lunn on my mmc patchset, I have split the
> > > patchset Into a single patch for dt-bindings review and another for USB
> > driver review.
> > 
> > I don't understand that advice. dt-bindings should (almost) always be with
> > the driver. Otherwise you just confuse people like me.
> > 
> > Perhaps Andrew meant sending dt*s* patches separately from the driver &
> > bindings?
> 
> The rational was different people making the actual merge, into different
> intermediate git REPOs, before mering into linux-next.

Which almost certainly means he was talking about dts patches, not
dt-bindings. bindings (almost) always go through the same tree as the
driver that uses them.

Cheers,
Conor.

> > > The USB driver patch utilizing this new dt bindings compatible string is here:
> > >
> > > https://patchwork.kernel.org/project/linux-usb/patch/20240107163307.36
> > > 77347-1-enachman@marvell.com/
> > >
> > > >
> > > > > ---
> > > > >  Documentation/devicetree/bindings/usb/generic-ehci.yaml | 1 +
> > > > >  1 file changed, 1 insertion(+)
> > > > >
> > > > > diff --git
> > > > > a/Documentation/devicetree/bindings/usb/generic-ehci.yaml
> > > > > b/Documentation/devicetree/bindings/usb/generic-ehci.yaml
> > > > > index 87986c45be88..2ed178f16a78 100644
> > > > > --- a/Documentation/devicetree/bindings/usb/generic-ehci.yaml
> > > > > +++ b/Documentation/devicetree/bindings/usb/generic-ehci.yaml
> > > > > @@ -77,6 +77,7 @@ properties:
> > > > >            - const: usb-ehci
> > > > >        - enum:
> > > > >            - generic-ehci
> > > > > +          - marvell,ac5-ehci
> > > > >            - marvell,armada-3700-ehci
> > > > >            - marvell,orion-ehci
> > > > >            - nuvoton,npcm750-ehci
> > > > > --
> > > > > 2.25.1
> > > > >
> > >
> > > Elad.
> 
> Elad.
Krzysztof Kozlowski Jan. 9, 2024, 9:32 a.m. UTC | #6
On 08/01/2024 19:15, Elad Nachman wrote:
> 
> 
>> -----Original Message-----
>> From: Conor Dooley <conor@kernel.org>
>> Sent: Monday, January 8, 2024 8:01 PM
>> To: Elad Nachman <enachman@marvell.com>
>> Cc: gregkh@linuxfoundation.org; robh+dt@kernel.org;
>> krzysztof.kozlowski+dt@linaro.org; conor+dt@kernel.org;
>> devicetree@vger.kernel.org; linux-usb@vger.kernel.org; linux-
>> kernel@vger.kernel.org
>> Subject: Re: [EXT] Re: [PATCH] dt-bindings: usb: Add Marvell ac5
>>
>> On Mon, Jan 08, 2024 at 05:47:24PM +0000, Elad Nachman wrote:
>>>
>>>
>>>> -----Original Message-----
>>>> From: Conor Dooley <conor@kernel.org>
>>>> Sent: Monday, January 8, 2024 7:15 PM
>>>> To: Elad Nachman <enachman@marvell.com>
>>>> Cc: gregkh@linuxfoundation.org; robh+dt@kernel.org;
>>>> krzysztof.kozlowski+dt@linaro.org; conor+dt@kernel.org;
>>>> devicetree@vger.kernel.org; linux-usb@vger.kernel.org; linux-
>>>> kernel@vger.kernel.org
>>>> Subject: [EXT] Re: [PATCH] dt-bindings: usb: Add Marvell ac5
>>>>
>>>> External Email
>>>>
>>>> --------------------------------------------------------------------
>>>> -- On Sun, Jan 07, 2024 at 05:25:57PM +0200, Elad Nachman wrote:
>>>>> From: Elad Nachman <enachman@marvell.com>
>>>>>
>>>>> Add Marvell ac5 device tree bindings to generic EHCI.
>>>>> This compatible enables the Marvell Orion platform code to
>>>>> properly configure the DMA mask for the Marvell AC5 SOC.
>>>>>
>>>>> Signed-off-by: Elad Nachman <enachman@marvell.com>
>>>>
>>>> Maybe I am dumb, but I don't understand how this does what the
>>>> commit message says. There's no fallback to generic-ehci or any
>>>> other compatible that is already understood by the driver.
>>>>
>>>> What am I missing?
>>>
>>> Following guidance by Andrew Lunn on my mmc patchset, I have split the
>>> patchset Into a single patch for dt-bindings review and another for USB
>> driver review.
>>
>> I don't understand that advice. dt-bindings should (almost) always be with
>> the driver. Otherwise you just confuse people like me.
>>
>> Perhaps Andrew meant sending dt*s* patches separately from the driver &
>> bindings?
> 
> The rational was different people making the actual merge, into different intermediate git REPOs, before mering into linux-next.

Sorry, but NAK. The submitting-patches for bindings expresses this as
well: bindings go with the driver.

There was never an advice from Andrew about splitting binding. He
clearly said that FIRST PATCH, so the DTS, goes via separate tree.
Absolutely nothing about splitting the binding.

https://lore.kernel.org/all/cfbbe706-5953-488c-9bff-f72f6d00b44f@lunn.ch/


Best regards,
Krzysztof
diff mbox series

Patch

diff --git a/Documentation/devicetree/bindings/usb/generic-ehci.yaml b/Documentation/devicetree/bindings/usb/generic-ehci.yaml
index 87986c45be88..2ed178f16a78 100644
--- a/Documentation/devicetree/bindings/usb/generic-ehci.yaml
+++ b/Documentation/devicetree/bindings/usb/generic-ehci.yaml
@@ -77,6 +77,7 @@  properties:
           - const: usb-ehci
       - enum:
           - generic-ehci
+          - marvell,ac5-ehci
           - marvell,armada-3700-ehci
           - marvell,orion-ehci
           - nuvoton,npcm750-ehci