| Message ID | 20200809111753.156236-11-jic23@kernel.org |
|---|---|
| State | Superseded |
| Headers | show |
| Series | dt-bindings: yaml conversions of some simple ADC bindings. | expand |
On 8/9/20 6:17 AM, Jonathan Cameron wrote: > From: Jonathan Cameron <Jonathan.Cameron@huawei.com> > > Simple conversion. This binding already had the > that is necessary, I'm happy to leave it as previously documented. This commit message doesn't make sense to me. It should probably just say "this converts the device tree bindings to yml" or so. > > Signed-off-by: Jonathan Cameron <Jonathan.Cameron@huawei.com> > Cc: David Lechner <david@lechnology.com> > --- > .../bindings/iio/adc/ti,ads7950.yaml | 64 +++++++++++++++++++ > .../bindings/iio/adc/ti-ads7950.txt | 23 ------- > 2 files changed, 64 insertions(+), 23 deletions(-) > > diff --git a/Documentation/devicetree/bindings/iio/adc/ti,ads7950.yaml b/Documentation/devicetree/bindings/iio/adc/ti,ads7950.yaml > new file mode 100644 > index 000000000000..a759d9064718 > --- /dev/null > +++ b/Documentation/devicetree/bindings/iio/adc/ti,ads7950.yaml > @@ -0,0 +1,64 @@ > +# SPDX-License-Identifier: (GPL-2.0 OR BSD-2-Clause) > +%YAML 1.2 > +--- > +$id: http://devicetree.org/schemas/iio/adc/ti,ads7950.yaml# > +$schema: http://devicetree.org/meta-schemas/core.yaml# > + > +title: Texas Instruments ADS7950 and similar ADCs > + > +maintainers: > + - David Lechner <david@lechnology.com> > + > +description: | > + Family of 4-16 channel, 8-12 bit ADCs with SPI interface. > + > +properties: > + compatible: > + enum: > + - ti,ads7950 > + - ti,ads7951 > + - ti,ads7952 > + - ti,ads7953 > + - ti,ads7954 > + - ti,ads7955 > + - ti,ads7956 > + - ti,ads7957 > + - ti,ads7958 > + - ti,ads7959 > + - ti,ads7960 > + - ti,ads7961 > + > + reg: > + maxItems: 1 > + > + spi-max-frequency: true According to the datasheet, max frequency is 20MHz, so this can be: spi-max-frequency: maximum: 20000000 > + > + vref-supply: > + description: Supply the 2.5V or 5V reference voltage Should this say "Supplies ..."? > + > + "#io-channel-cells": > + const: 1 > + > +required: > + - compatible > + - reg > + - vref-supply > + - "#io-channel-cells" > + > +additionalProperties: false > + > +examples: > + - | > + spi { > + #address-cells = <1>; > + #size-cells = <0>; > + > + adc@0 { > + compatible = "ti,ads7957"; > + reg = <0>; > + vref-supply = <&refin_supply>; > + spi-max-frequency = <10000000>; > + #io-channel-cells = <1>; > + }; > + };
On Wed, 12 Aug 2020 11:30:28 -0500 David Lechner <david@lechnology.com> wrote: > On 8/9/20 6:17 AM, Jonathan Cameron wrote: > > From: Jonathan Cameron <Jonathan.Cameron@huawei.com> > > > > Simple conversion. This binding already had the > > that is necessary, I'm happy to leave it as previously documented. > > This commit message doesn't make sense to me. It should probably > just say "this converts the device tree bindings to yml" or so. I'm not sure what happened there. I think perhaps a line got accidentally removed. It was meant to talk about the fact #io-channel-cells is marked as required which may not make sense for all boards with this part. Will rewrite for v2. Jonathan > > > > > Signed-off-by: Jonathan Cameron <Jonathan.Cameron@huawei.com> > > Cc: David Lechner <david@lechnology.com> > > --- > > .../bindings/iio/adc/ti,ads7950.yaml | 64 +++++++++++++++++++ > > .../bindings/iio/adc/ti-ads7950.txt | 23 ------- > > 2 files changed, 64 insertions(+), 23 deletions(-) > > > > diff --git a/Documentation/devicetree/bindings/iio/adc/ti,ads7950.yaml b/Documentation/devicetree/bindings/iio/adc/ti,ads7950.yaml > > new file mode 100644 > > index 000000000000..a759d9064718 > > --- /dev/null > > +++ b/Documentation/devicetree/bindings/iio/adc/ti,ads7950.yaml > > @@ -0,0 +1,64 @@ > > +# SPDX-License-Identifier: (GPL-2.0 OR BSD-2-Clause) > > +%YAML 1.2 > > +--- > > +$id: http://devicetree.org/schemas/iio/adc/ti,ads7950.yaml# > > +$schema: http://devicetree.org/meta-schemas/core.yaml# > > + > > +title: Texas Instruments ADS7950 and similar ADCs > > + > > +maintainers: > > + - David Lechner <david@lechnology.com> > > + > > +description: | > > + Family of 4-16 channel, 8-12 bit ADCs with SPI interface. > > + > > +properties: > > + compatible: > > + enum: > > + - ti,ads7950 > > + - ti,ads7951 > > + - ti,ads7952 > > + - ti,ads7953 > > + - ti,ads7954 > > + - ti,ads7955 > > + - ti,ads7956 > > + - ti,ads7957 > > + - ti,ads7958 > > + - ti,ads7959 > > + - ti,ads7960 > > + - ti,ads7961 > > + > > + reg: > > + maxItems: 1 > > + > > + spi-max-frequency: true > > According to the datasheet, max frequency is 20MHz, so this can be: > > spi-max-frequency: > maximum: 20000000 > > > + > > + vref-supply: > > + description: Supply the 2.5V or 5V reference voltage > > Should this say "Supplies ..."? > > > + > > + "#io-channel-cells": > > + const: 1 > > + > > +required: > > + - compatible > > + - reg > > + - vref-supply > > + - "#io-channel-cells" > > + > > +additionalProperties: false > > + > > +examples: > > + - | > > + spi { > > + #address-cells = <1>; > > + #size-cells = <0>; > > + > > + adc@0 { > > + compatible = "ti,ads7957"; > > + reg = <0>; > > + vref-supply = <&refin_supply>; > > + spi-max-frequency = <10000000>; > > + #io-channel-cells = <1>; > > + }; > > + }; > >
diff --git a/Documentation/devicetree/bindings/iio/adc/ti,ads7950.yaml b/Documentation/devicetree/bindings/iio/adc/ti,ads7950.yaml new file mode 100644 index 000000000000..a759d9064718 --- /dev/null +++ b/Documentation/devicetree/bindings/iio/adc/ti,ads7950.yaml @@ -0,0 +1,64 @@ +# SPDX-License-Identifier: (GPL-2.0 OR BSD-2-Clause) +%YAML 1.2 +--- +$id: http://devicetree.org/schemas/iio/adc/ti,ads7950.yaml# +$schema: http://devicetree.org/meta-schemas/core.yaml# + +title: Texas Instruments ADS7950 and similar ADCs + +maintainers: + - David Lechner <david@lechnology.com> + +description: | + Family of 4-16 channel, 8-12 bit ADCs with SPI interface. + +properties: + compatible: + enum: + - ti,ads7950 + - ti,ads7951 + - ti,ads7952 + - ti,ads7953 + - ti,ads7954 + - ti,ads7955 + - ti,ads7956 + - ti,ads7957 + - ti,ads7958 + - ti,ads7959 + - ti,ads7960 + - ti,ads7961 + + reg: + maxItems: 1 + + spi-max-frequency: true + + vref-supply: + description: Supply the 2.5V or 5V reference voltage + + "#io-channel-cells": + const: 1 + +required: + - compatible + - reg + - vref-supply + - "#io-channel-cells" + +additionalProperties: false + +examples: + - | + spi { + #address-cells = <1>; + #size-cells = <0>; + + adc@0 { + compatible = "ti,ads7957"; + reg = <0>; + vref-supply = <&refin_supply>; + spi-max-frequency = <10000000>; + #io-channel-cells = <1>; + }; + }; +... diff --git a/Documentation/devicetree/bindings/iio/adc/ti-ads7950.txt b/Documentation/devicetree/bindings/iio/adc/ti-ads7950.txt deleted file mode 100644 index e77a6f7e1001..000000000000 --- a/Documentation/devicetree/bindings/iio/adc/ti-ads7950.txt +++ /dev/null @@ -1,23 +0,0 @@ -* Texas Instruments ADS7950 family of A/DC chips - -Required properties: - - compatible: Must be one of "ti,ads7950", "ti,ads7951", "ti,ads7952", - "ti,ads7953", "ti,ads7954", "ti,ads7955", "ti,ads7956", "ti,ads7957", - "ti,ads7958", "ti,ads7959", "ti,ads7960", or "ti,ads7961" - - reg: SPI chip select number for the device - - #io-channel-cells: Must be 1 as per ../iio-bindings.txt - - vref-supply: phandle to a regulator node that supplies the 2.5V or 5V - reference voltage - -Recommended properties: - - spi-max-frequency: Definition as per - Documentation/devicetree/bindings/spi/spi-bus.txt - -Example: -adc@0 { - compatible = "ti,ads7957"; - reg = <0>; - #io-channel-cells = <1>; - vref-supply = <&refin_supply>; - spi-max-frequency = <10000000>; -};