Re: [PATCH v2 04/20] dt-bindings:iio:adc: aspeed,ast2400 yaml conversion

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

 



On Wed, 16 Sep 2020 12:39:36 +0000
Joel Stanley <joel@xxxxxxxxx> wrote:

> On Wed, 16 Sep 2020 at 10:38, Jonathan Cameron
> <Jonathan.Cameron@xxxxxxxxxx> wrote:
> >
> > On Thu, 10 Sep 2020 02:32:19 +0000
> > Joel Stanley <joel@xxxxxxxxx> wrote:
> >  
> > > On Wed, 9 Sep 2020 at 18:02, Jonathan Cameron <jic23@xxxxxxxxxx> wrote:  
> > > >
> > > > From: Jonathan Cameron <Jonathan.Cameron@xxxxxxxxxx>
> > > >
> > > > Simple txt to yaml conversion. Part of a general move to convert
> > > > all the IIO bindings over to yaml.
> > > >
> > > > Signed-off-by: Jonathan Cameron <Jonathan.Cameron@xxxxxxxxxx>
> > > > Cc: Rick Altherr <raltherr@xxxxxxxxxx>
> > > > Cc: Joel Stanley <joel@xxxxxxxxx>
> > > > Cc: Andrew Jeffery <andrew@xxxxxxxx>  
> > >
> > > Acked-by: Joel Stanley <joel@xxxxxxxxx>
> > >
> > >  
> > > > ---
> > > >  .../bindings/iio/adc/aspeed,ast2400-adc.yaml  | 54 +++++++++++++++++++
> > > >  .../bindings/iio/adc/aspeed_adc.txt           | 22 --------
> > > >  2 files changed, 54 insertions(+), 22 deletions(-)
> > > >
> > > > diff --git a/Documentation/devicetree/bindings/iio/adc/aspeed,ast2400-adc.yaml b/Documentation/devicetree/bindings/iio/adc/aspeed,ast2400-adc.yaml
> > > > new file mode 100644
> > > > index 000000000000..09018487d690
> > > > --- /dev/null
> > > > +++ b/Documentation/devicetree/bindings/iio/adc/aspeed,ast2400-adc.yaml  
> > >
> > > This naming doesn't make sense, as the bindings are for the ast2500
> > > too (and they also apply for the ast2600).  
> >
> > Convention is to name after a supported device and not use
> > wild cards or generic names because the chances of it going
> > wrong in future is far too high. Will every aspeed adc look the same?
> > Seems impossible to predict so best we can do safely is to pick a
> > part number.  
> 
> It already supports three different generations of SoC, which I was
> bringing to your attention. Therefore having the name '2400' is
> already incorrect.

I'm happy to change it to a specific part number of your choice but you
have to chose one.  The file name is not a list of all the parts supported.

There are bindings that attach to hundreds of different part numbers but the
file is named after a specific one.  Normally the first part supported
is the one chosen (because the binding is normally written at that time).

Jonathan

> 
> >
> > There are enormous numbers of examples of this in dt bindings and
> > for that matter driver naming.
> >
> > Thanks,
> >
> > Jonathan
> >
> >  
> > >  
> > > > @@ -0,0 +1,54 @@
> > > > +# SPDX-License-Identifier: (GPL-2.0 OR BSD-2-Clause)
> > > > +%YAML 1.2
> > > > +---
> > > > +$id: http://devicetree.org/schemas/iio/adc/aspeed,ast2400-adc.yaml#
> > > > +$schema: http://devicetree.org/meta-schemas/core.yaml#
> > > > +
> > > > +title: ADC that forms part of an ASPEED server management processor.
> > > > +
> > > > +maintainers:
> > > > +  - Rick Altherr <raltherr@xxxxxxxxxx>
> > > > +
> > > > +description:
> > > > +  This device is a 10-bit converter for 16 voltage channels.  All inputs are
> > > > +  single ended.
> > > > +
> > > > +properties:
> > > > +  compatible:
> > > > +    enum:
> > > > +      - aspeed,ast2400-adc
> > > > +      - aspeed,ast2500-adc
> > > > +
> > > > +  reg:
> > > > +    maxItems: 1
> > > > +
> > > > +  clocks:
> > > > +    description:
> > > > +      Input clock used to derive the sample clock. Expected to be the
> > > > +      SoC's APB clock.
> > > > +
> > > > +  resets: true
> > > > +
> > > > +  "#io-channel-cells":
> > > > +    const: 1
> > > > +
> > > > +required:
> > > > +  - compatible
> > > > +  - reg
> > > > +  - clocks
> > > > +  - resets
> > > > +  - "#io-channel-cells"
> > > > +
> > > > +additionalProperties: false
> > > > +
> > > > +examples:
> > > > +  - |
> > > > +    #include <dt-bindings/clock/aspeed-clock.h>
> > > > +    adc@1e6e9000 {
> > > > +        compatible = "aspeed,ast2400-adc";
> > > > +        reg = <0x1e6e9000 0xb0>;
> > > > +        clocks = <&syscon ASPEED_CLK_APB>;
> > > > +        resets = <&syscon ASPEED_RESET_ADC>;
> > > > +        #io-channel-cells = <1>;
> > > > +    };
> > > > +...
> > > > diff --git a/Documentation/devicetree/bindings/iio/adc/aspeed_adc.txt b/Documentation/devicetree/bindings/iio/adc/aspeed_adc.txt
> > > > deleted file mode 100644
> > > > index 034fc2ba100e..000000000000
> > > > --- a/Documentation/devicetree/bindings/iio/adc/aspeed_adc.txt
> > > > +++ /dev/null
> > > > @@ -1,22 +0,0 @@
> > > > -Aspeed ADC
> > > > -
> > > > -This device is a 10-bit converter for 16 voltage channels.  All inputs are
> > > > -single ended.
> > > > -
> > > > -Required properties:
> > > > -- compatible: Should be "aspeed,ast2400-adc" or "aspeed,ast2500-adc"
> > > > -- reg: memory window mapping address and length
> > > > -- clocks: Input clock used to derive the sample clock. Expected to be the
> > > > -          SoC's APB clock.
> > > > -- resets: Reset controller phandle
> > > > -- #io-channel-cells: Must be set to <1> to indicate channels are selected
> > > > -                     by index.
> > > > -
> > > > -Example:
> > > > -       adc@1e6e9000 {
> > > > -               compatible = "aspeed,ast2400-adc";
> > > > -               reg = <0x1e6e9000 0xb0>;
> > > > -               clocks = <&syscon ASPEED_CLK_APB>;
> > > > -               resets = <&syscon ASPEED_RESET_ADC>;
> > > > -               #io-channel-cells = <1>;
> > > > -       };
> > > > --
> > > > 2.28.0
> > > >  
> >
> >  





[Index of Archives]     [Device Tree Compilter]     [Device Tree Spec]     [Linux Driver Backports]     [Video for Linux]     [Linux USB Devel]     [Linux PCI Devel]     [Linux Audio Users]     [Linux Kernel]     [Linux SCSI]     [XFree86]     [Yosemite Backpacking]


  Powered by Linux