[v3] dt-bindings: arm: Convert nuvoton,npcm750 binding to YAML

The general trend is to have devicetree bindings in YAML format, to
allow automatic validation of bindings and devicetrees.

Convert the NPCM SoC family's binding to YAML before it accumulates more
entries.

Signed-off-by: Jonathan Neuschäfer <j.neuschaefer@gmx.net>
---

If someone else wants to be listed as the maintainer, please let me
know.


v3:
- In this version, I removed the nuvoton,npcm750-evb compatible string
  again. I had previously introduced it to simplify the binding a little
  bit, but Tomer Maimon suggested to keep /compatible of
  nuvoton-npcm750-evb.dts as-is (i.e. only use "nuvoton,npcm750", no
  board-specific string).
  Because of this change, I am not including Rob Herring's R-b tag.

v2:
- https://lore.kernel.org/lkml/20210116010907.3475405-1-j.neuschaefer@gmx.net/
  https://lore.kernel.org/lkml/20210303154622.3018839-1-j.neuschaefer@gmx.net/
- Fix indentation to satisfy yamllint
- Fix $schema line
---
 .../devicetree/bindings/arm/npcm/npcm.txt     |  6 ------
 .../devicetree/bindings/arm/npcm/npcm.yaml    | 20 +++++++++++++++++++
 2 files changed, 20 insertions(+), 6 deletions(-)
 delete mode 100644 Documentation/devicetree/bindings/arm/npcm/npcm.txt
 create mode 100644 Documentation/devicetree/bindings/arm/npcm/npcm.yaml

--
2.30.1

On Sat, Mar 13, 2021 at 06:53:20PM +0100, Jonathan Neuschäfer wrote:
> The general trend is to have devicetree bindings in YAML format, to
> allow automatic validation of bindings and devicetrees.
> 
> Convert the NPCM SoC family's binding to YAML before it accumulates more
> entries.
> 
> Signed-off-by: Jonathan Neuschäfer <j.neuschaefer@gmx.net>
> ---
> 
> If someone else wants to be listed as the maintainer, please let me
> know.
> 
> 
> v3:
> - In this version, I removed the nuvoton,npcm750-evb compatible string
>   again. I had previously introduced it to simplify the binding a little
>   bit, but Tomer Maimon suggested to keep /compatible of
>   nuvoton-npcm750-evb.dts as-is (i.e. only use "nuvoton,npcm750", no
>   board-specific string).
>   Because of this change, I am not including Rob Herring's R-b tag.

I think you should add nuvoton,npcm750-evb. Not so much for that board, 
but to ensure any additional boards get a board specific compatible.

> 
> v2:
> - https://lore.kernel.org/lkml/20210116010907.3475405-1-j.neuschaefer@gmx.net/
>   https://lore.kernel.org/lkml/20210303154622.3018839-1-j.neuschaefer@gmx.net/
> - Fix indentation to satisfy yamllint
> - Fix $schema line
> ---
>  .../devicetree/bindings/arm/npcm/npcm.txt     |  6 ------
>  .../devicetree/bindings/arm/npcm/npcm.yaml    | 20 +++++++++++++++++++
>  2 files changed, 20 insertions(+), 6 deletions(-)
>  delete mode 100644 Documentation/devicetree/bindings/arm/npcm/npcm.txt
>  create mode 100644 Documentation/devicetree/bindings/arm/npcm/npcm.yaml
> 
> diff --git a/Documentation/devicetree/bindings/arm/npcm/npcm.txt b/Documentation/devicetree/bindings/arm/npcm/npcm.txt
> deleted file mode 100644
> index 2d87d9ecea85b..0000000000000
> --- a/Documentation/devicetree/bindings/arm/npcm/npcm.txt
> +++ /dev/null
> @@ -1,6 +0,0 @@
> -NPCM Platforms Device Tree Bindings
> ------------------------------------
> -NPCM750 SoC
> -Required root node properties:
> -	- compatible = "nuvoton,npcm750";
> -
> diff --git a/Documentation/devicetree/bindings/arm/npcm/npcm.yaml b/Documentation/devicetree/bindings/arm/npcm/npcm.yaml
> new file mode 100644
> index 0000000000000..8cca0396a5d59
> --- /dev/null
> +++ b/Documentation/devicetree/bindings/arm/npcm/npcm.yaml
> @@ -0,0 +1,20 @@
> +# SPDX-License-Identifier: GPL-2.0-only OR BSD-2-Clause
> +%YAML 1.2
> +---
> +$id: http://devicetree.org/schemas/arm/npcm/npcm.yaml#
> +$schema: http://devicetree.org/meta-schemas/core.yaml#
> +
> +title: NPCM Platforms Device Tree Bindings
> +
> +maintainers:
> +  - Jonathan Neuschäfer <j.neuschaefer@gmx.net>
> +
> +properties:
> +  $nodename:
> +    const: '/'
> +  compatible:
> +    oneOf:
> +      - description: NPCM750 development board
> +        const: nuvoton,npcm750
> +
> +additionalProperties: true
> --
> 2.30.1
>

On Mon, Mar 15, 2021 at 10:23:38AM -0600, Rob Herring wrote:
> On Sat, Mar 13, 2021 at 06:53:20PM +0100, Jonathan Neuschäfer wrote:
> > The general trend is to have devicetree bindings in YAML format, to
> > allow automatic validation of bindings and devicetrees.
> > 
> > Convert the NPCM SoC family's binding to YAML before it accumulates more
> > entries.
> > 
> > Signed-off-by: Jonathan Neuschäfer <j.neuschaefer@gmx.net>
> > ---
> > 
> > If someone else wants to be listed as the maintainer, please let me
> > know.
> > 
> > 
> > v3:
> > - In this version, I removed the nuvoton,npcm750-evb compatible string
> >   again. I had previously introduced it to simplify the binding a little
> >   bit, but Tomer Maimon suggested to keep /compatible of
> >   nuvoton-npcm750-evb.dts as-is (i.e. only use "nuvoton,npcm750", no
> >   board-specific string).
> >   Because of this change, I am not including Rob Herring's R-b tag.
> 
> I think you should add nuvoton,npcm750-evb. Not so much for that board, 
> but to ensure any additional boards get a board specific compatible.

I'm inclined to agree and go back to v2, but I'd like to hear Tomer
Maimon's opinion first.

> > v2:
> > - https://lore.kernel.org/lkml/20210116010907.3475405-1-j.neuschaefer@gmx.net/
> >   https://lore.kernel.org/lkml/20210303154622.3018839-1-j.neuschaefer@gmx.net/
> > - Fix indentation to satisfy yamllint
> > - Fix $schema line


Thanks,
Jonathan Neuschäfer

Hi,

Appreciate your help Jonathan and Rob,

Just seeing the following EVB device tree
https://github.com/torvalds/linux/blob/master/arch/arm/boot/dts/aspeed-ast2500-evb.dts#L8

And not a EVB board.
https://github.com/torvalds/linux/blob/master/arch/arm/boot/dts/aspeed-bmc-facebook-cmm.dts#L9

but still also option V2 is good for us.

Sorry it took that long.

Thanks a lot!

Tomer


On Mon, 15 Mar 2021 at 19:47, Jonathan Neuschäfer <j.neuschaefer@gmx.net>
wrote:

> On Mon, Mar 15, 2021 at 10:23:38AM -0600, Rob Herring wrote:
> > On Sat, Mar 13, 2021 at 06:53:20PM +0100, Jonathan Neuschäfer wrote:
> > > The general trend is to have devicetree bindings in YAML format, to
> > > allow automatic validation of bindings and devicetrees.
> > >
> > > Convert the NPCM SoC family's binding to YAML before it accumulates
> more
> > > entries.
> > >
> > > Signed-off-by: Jonathan Neuschäfer <j.neuschaefer@gmx.net>
> > > ---
> > >
> > > If someone else wants to be listed as the maintainer, please let me
> > > know.
> > >
> > >
> > > v3:
> > > - In this version, I removed the nuvoton,npcm750-evb compatible string
> > >   again. I had previously introduced it to simplify the binding a
> little
> > >   bit, but Tomer Maimon suggested to keep /compatible of
> > >   nuvoton-npcm750-evb.dts as-is (i.e. only use "nuvoton,npcm750", no
> > >   board-specific string).
> > >   Because of this change, I am not including Rob Herring's R-b tag.
> >
> > I think you should add nuvoton,npcm750-evb. Not so much for that board,
> > but to ensure any additional boards get a board specific compatible.
>
> I'm inclined to agree and go back to v2, but I'd like to hear Tomer
> Maimon's opinion first.
>
> > > v2:
> > > -
> https://lore.kernel.org/lkml/20210116010907.3475405-1-j.neuschaefer@gmx.net/
> > >
> https://lore.kernel.org/lkml/20210303154622.3018839-1-j.neuschaefer@gmx.net/
> > > - Fix indentation to satisfy yamllint
> > > - Fix $schema line
>
>
> Thanks,
> Jonathan Neuschäfer
>

On Tue, Mar 16, 2021 at 01:03:38PM +0200, Tomer Maimon wrote:
> Hi,
> 
> Appreciate your help Jonathan and Rob,
> 
> Just seeing the following EVB device tree
> https://github.com/torvalds/linux/blob/master/arch/arm/boot/dts/aspeed-ast2500-evb.dts#L8
> 
> And not a EVB board.
> https://github.com/torvalds/linux/blob/master/arch/arm/boot/dts/aspeed-bmc-facebook-cmm.dts#L9

I see.

> 
> but still also option V2 is good for us.

That's good to know.



Thanks,
Jonathan Neuschäfer