diff mbox series

dt-bindings: marvell: Update Armada 37xx platform bindings

Message ID 20220713200123.22612-1-pali@kernel.org
State New
Headers show
Series dt-bindings: marvell: Update Armada 37xx platform bindings | expand

Commit Message

Pali Rohár July 13, 2022, 8:01 p.m. UTC
Distinguish between Armada 3700 family, Armada 3710 SoC and Armada 3720 SoC.
Armada 3720 DB is name of the board with Armada 3720 SoC, so correctly
indicate SoC in example.

Signed-off-by: Pali Rohár <pali@kernel.org>
---
 .../devicetree/bindings/arm/marvell/armada-37xx.txt        | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

Comments

Pali Rohár Aug. 9, 2022, 3:48 p.m. UTC | #1
On Tuesday 09 August 2022 18:46:04 Krzysztof Kozlowski wrote:
> On 09/08/2022 16:13, Pali Rohár wrote:
> > On Tuesday 09 August 2022 08:58:50 Krzysztof Kozlowski wrote:
> >> On 08/08/2022 23:23, Pali Rohár wrote:
> >>> PING?
> >>>
> >>> On Wednesday 13 July 2022 22:01:23 Pali Rohár wrote:
> >>>> Distinguish between Armada 3700 family, Armada 3710 SoC and Armada 3720 SoC.
> >>>> Armada 3720 DB is name of the board with Armada 3720 SoC, so correctly
> >>>> indicate SoC in example.
> >>>>
> >>>> Signed-off-by: Pali Rohár <pali@kernel.org>
> >>>> ---
> >>>>  .../devicetree/bindings/arm/marvell/armada-37xx.txt        | 7 ++++++-
> >>>>  1 file changed, 6 insertions(+), 1 deletion(-)
> >>>>
> >>>> diff --git a/Documentation/devicetree/bindings/arm/marvell/armada-37xx.txt b/Documentation/devicetree/bindings/arm/marvell/armada-37xx.txt
> >>>> index f6d6642d81c0..d2ca008de266 100644
> >>>> --- a/Documentation/devicetree/bindings/arm/marvell/armada-37xx.txt
> >>>> +++ b/Documentation/devicetree/bindings/arm/marvell/armada-37xx.txt
> >>>> @@ -4,6 +4,11 @@ Marvell Armada 37xx Platforms Device Tree Bindings
> >>>>  Boards using a SoC of the Marvell Armada 37xx family must carry the
> >>>>  following root node property:
> >>>>  
> >>>> + - compatible: must contain "marvell,armada3700"
> >>>> +
> >>>> +In addition, boards using the Marvell Armada 3710 SoC shall have the
> >>>> +following property before the previous one:
> >>>> +
> >>
> >> The change is an ABI break, which looks reasonable, but still platform
> >> maintainer should comment on it. Especially on the aspect why the
> >> marvell,armada3710 fallback was chosen at the first place.
> > 
> > I do not think this is ABI break but rather incorrect documentation and
> > bug in some board dts files.
> 
> This documentation is the ABI, especially if actually implemented in the
> DTS files, therefore by all definitions of DT ABI this is an ABI break.

Ok.

> What you are saying about "incorrect documentation and bug in some DTS
> files" is a good reason to break the ABI, but it is still a break.
> 
> Best regards,
> Krzysztof

I think it is now clear what we both mean, just we used different
terminology for the same thing.
Krzysztof Kozlowski Sept. 24, 2022, 1:50 p.m. UTC | #2
On 08/08/2022 22:23, Pali Rohár wrote:
> PING?
> 

You got the ack, what are you pinging us for?

Best regards,
Krzysztof
Pali Rohár Sept. 24, 2022, 2:30 p.m. UTC | #3
On Saturday 24 September 2022 15:50:38 Krzysztof Kozlowski wrote:
> On 08/08/2022 22:23, Pali Rohár wrote:
> > PING?
> > 
> 
> You got the ack, what are you pinging us for?
> 
> Best regards,
> Krzysztof
> 
So, who can take this patch?
Krzysztof Kozlowski Sept. 24, 2022, 4:53 p.m. UTC | #4
On 24/09/2022 16:30, Pali Rohár wrote:
> On Saturday 24 September 2022 15:50:38 Krzysztof Kozlowski wrote:
>> On 08/08/2022 22:23, Pali Rohár wrote:
>>> PING?
>>>
>>
>> You got the ack, what are you pinging us for?
>>
>> Best regards,
>> Krzysztof
>>
> So, who can take this patch?

This looks like platform bindings, so the platform maintainers. Would be
easier for them to pick it up, if they were CCed. :)

I actually hoped they will pick up also fix for maintainers entry:
https://lore.kernel.org/all/875yi5g96s.fsf@BL-laptop/
...

Best regards,
Krzysztof
Pali Rohár Oct. 9, 2022, 11:56 a.m. UTC | #5
Gregory: ping

On Wednesday 13 July 2022 22:01:23 Pali Rohár wrote:
> Distinguish between Armada 3700 family, Armada 3710 SoC and Armada 3720 SoC.
> Armada 3720 DB is name of the board with Armada 3720 SoC, so correctly
> indicate SoC in example.
> 
> Signed-off-by: Pali Rohár <pali@kernel.org>
> ---
>  .../devicetree/bindings/arm/marvell/armada-37xx.txt        | 7 ++++++-
>  1 file changed, 6 insertions(+), 1 deletion(-)
> 
> diff --git a/Documentation/devicetree/bindings/arm/marvell/armada-37xx.txt b/Documentation/devicetree/bindings/arm/marvell/armada-37xx.txt
> index f6d6642d81c0..d2ca008de266 100644
> --- a/Documentation/devicetree/bindings/arm/marvell/armada-37xx.txt
> +++ b/Documentation/devicetree/bindings/arm/marvell/armada-37xx.txt
> @@ -4,6 +4,11 @@ Marvell Armada 37xx Platforms Device Tree Bindings
>  Boards using a SoC of the Marvell Armada 37xx family must carry the
>  following root node property:
>  
> + - compatible: must contain "marvell,armada3700"
> +
> +In addition, boards using the Marvell Armada 3710 SoC shall have the
> +following property before the previous one:
> +
>   - compatible: must contain "marvell,armada3710"
>  
>  In addition, boards using the Marvell Armada 3720 SoC shall have the
> @@ -13,7 +18,7 @@ following property before the previous one:
>  
>  Example:
>  
> -compatible = "marvell,armada-3720-db", "marvell,armada3720", "marvell,armada3710";
> +compatible = "marvell,armada-3720-db", "marvell,armada3720", "marvell,armada3700";
>  
>  
>  Power management
> -- 
> 2.20.1
>
Pali Rohár Jan. 22, 2023, 11:29 a.m. UTC | #6
PING?

On Friday 16 December 2022 19:20:01 Pali Rohár wrote:
> PING?
> 
> On Monday 28 November 2022 19:18:29 Pali Rohár wrote:
> > PING?
> > 
> > On Tuesday 01 November 2022 23:43:00 Pali Rohár wrote:
> > > PING?
> > > 
> > > On Sunday 09 October 2022 13:56:58 Pali Rohár wrote:
> > > > Gregory: ping
> > > > 
> > > > On Wednesday 13 July 2022 22:01:23 Pali Rohár wrote:
> > > > > Distinguish between Armada 3700 family, Armada 3710 SoC and Armada 3720 SoC.
> > > > > Armada 3720 DB is name of the board with Armada 3720 SoC, so correctly
> > > > > indicate SoC in example.
> > > > > 
> > > > > Signed-off-by: Pali Rohár <pali@kernel.org>
> > > > > ---
> > > > >  .../devicetree/bindings/arm/marvell/armada-37xx.txt        | 7 ++++++-
> > > > >  1 file changed, 6 insertions(+), 1 deletion(-)
> > > > > 
> > > > > diff --git a/Documentation/devicetree/bindings/arm/marvell/armada-37xx.txt b/Documentation/devicetree/bindings/arm/marvell/armada-37xx.txt
> > > > > index f6d6642d81c0..d2ca008de266 100644
> > > > > --- a/Documentation/devicetree/bindings/arm/marvell/armada-37xx.txt
> > > > > +++ b/Documentation/devicetree/bindings/arm/marvell/armada-37xx.txt
> > > > > @@ -4,6 +4,11 @@ Marvell Armada 37xx Platforms Device Tree Bindings
> > > > >  Boards using a SoC of the Marvell Armada 37xx family must carry the
> > > > >  following root node property:
> > > > >  
> > > > > + - compatible: must contain "marvell,armada3700"
> > > > > +
> > > > > +In addition, boards using the Marvell Armada 3710 SoC shall have the
> > > > > +following property before the previous one:
> > > > > +
> > > > >   - compatible: must contain "marvell,armada3710"
> > > > >  
> > > > >  In addition, boards using the Marvell Armada 3720 SoC shall have the
> > > > > @@ -13,7 +18,7 @@ following property before the previous one:
> > > > >  
> > > > >  Example:
> > > > >  
> > > > > -compatible = "marvell,armada-3720-db", "marvell,armada3720", "marvell,armada3710";
> > > > > +compatible = "marvell,armada-3720-db", "marvell,armada3720", "marvell,armada3700";
> > > > >  
> > > > >  
> > > > >  Power management
> > > > > -- 
> > > > > 2.20.1
> > > > >
diff mbox series

Patch

diff --git a/Documentation/devicetree/bindings/arm/marvell/armada-37xx.txt b/Documentation/devicetree/bindings/arm/marvell/armada-37xx.txt
index f6d6642d81c0..d2ca008de266 100644
--- a/Documentation/devicetree/bindings/arm/marvell/armada-37xx.txt
+++ b/Documentation/devicetree/bindings/arm/marvell/armada-37xx.txt
@@ -4,6 +4,11 @@  Marvell Armada 37xx Platforms Device Tree Bindings
 Boards using a SoC of the Marvell Armada 37xx family must carry the
 following root node property:
 
+ - compatible: must contain "marvell,armada3700"
+
+In addition, boards using the Marvell Armada 3710 SoC shall have the
+following property before the previous one:
+
  - compatible: must contain "marvell,armada3710"
 
 In addition, boards using the Marvell Armada 3720 SoC shall have the
@@ -13,7 +18,7 @@  following property before the previous one:
 
 Example:
 
-compatible = "marvell,armada-3720-db", "marvell,armada3720", "marvell,armada3710";
+compatible = "marvell,armada-3720-db", "marvell,armada3720", "marvell,armada3700";
 
 
 Power management