| Message ID | 20200612141903.2391044-22-thierry.reding@gmail.com |
|---|---|
| State | Deferred |
| Headers | show |
| Series | dt-bindings: json-schema conversions and cleanups | expand |
On Fri, Jun 12, 2020 at 04:18:46PM +0200, Thierry Reding wrote: > From: Thierry Reding <treding@nvidia.com> > > Convert the Freescale SGTL5000 device tree bindings from free-form text > format to json-schema. > > Signed-off-by: Thierry Reding <treding@nvidia.com> > --- > .../devicetree/bindings/sound/sgtl5000.txt | 60 ---------- > .../devicetree/bindings/sound/sgtl5000.yaml | 103 ++++++++++++++++++ > .../devicetree/bindings/trivial-devices.yaml | 2 - > 3 files changed, 103 insertions(+), 62 deletions(-) > delete mode 100644 Documentation/devicetree/bindings/sound/sgtl5000.txt > create mode 100644 Documentation/devicetree/bindings/sound/sgtl5000.yaml > diff --git a/Documentation/devicetree/bindings/sound/sgtl5000.yaml b/Documentation/devicetree/bindings/sound/sgtl5000.yaml > new file mode 100644 > index 000000000000..4f29b63c54d3 > --- /dev/null > +++ b/Documentation/devicetree/bindings/sound/sgtl5000.yaml > @@ -0,0 +1,103 @@ > +# SPDX-License-Identifier: GPL-2.0-only > +%YAML 1.2 > +--- > +$id: http://devicetree.org/schemas/sound/sgtl5000.yaml# > +$schema: http://devicetree.org/meta-schemas/core.yaml# > + > +title: Freescale SGTL5000 Stereo Codec > + > +maintainers: > + - Fabio Estevam <festevam@gmail.com> > + > +properties: > + compatible: > + const: fsl,sgtl5000 > + > + reg: > + maxItems: 1 > + > + "#sound-dai-cells": > + const: 0 > + > + clocks: > + items: > + - description: the clock provider of SYS_MCLK > + > + VDDA-supply: > + description: the regulator provider of VDDA > + > + VDDIO-supply: > + description: the regulator provider of VDDIO > + > + VDDD-supply: > + description: the regulator provider of VDDD > + > + micbias-resistor-k-ohms: > + description: The bias resistor to be used in kOhms. The resistor can take > + values of 2k, 4k or 8k. If set to 0 it will be off. If this node is not > + mentioned or if the value is unknown, then micbias resistor is set to > + 4k. > + $ref: "/schemas/types.yaml#/definitions/uint32" Anything with standard unit suffix already has a type. > + enum: [ 0, 2, 4, 8 ] > + > + micbias-voltage-m-volts: > + description: The bias voltage to be used in mVolts. The voltage can take > + values from 1.25V to 3V by 250mV steps. If this node is not mentioned > + or the value is unknown, then the value is set to 1.25V. > + $ref: "/schemas/types.yaml#/definitions/uint32" > + enum: [ 1250, 1500, 1750, 2000, 2250, 2500, 2750, 3000 ] > + > + lrclk-strength: > + description: | > + The LRCLK pad strength. Possible values are: 0, 1, 2 and 3 as per the > + table below: > + > + VDDIO 1.8V 2.5V 3.3V > + 0 = Disable > + 1 = 1.66 mA 2.87 mA 4.02 mA > + 2 = 3.33 mA 5.74 mA 8.03 mA > + 3 = 4.99 mA 8.61 mA 12.05 mA > + $ref: "/schemas/types.yaml#/definitions/uint32" > + enum: [ 0, 1, 2, 3 ] > + > + sclk-strength: > + description: | > + The SCLK pad strength. Possible values are: 0, 1, 2 and 3 as per the > + table below: > + > + VDDIO 1.8V 2.5V 3.3V > + 0 = Disable > + 1 = 1.66 mA 2.87 mA 4.02 mA > + 2 = 3.33 mA 5.74 mA 8.03 mA > + 3 = 4.99 mA 8.61 mA 12.05 mA > + $ref: "/schemas/types.yaml#/definitions/uint32" > + enum: [ 0, 1, 2, 3 ] > + > +required: > + - compatible > + - reg > + - "#sound-dai-cells" > + - clocks > + - VDDA-supply > + - VDDIO-supply > + > +additionalProperties: false > + > +examples: > + - | > + i2c { > + #address-cells = <1>; > + #size-cells = <0>; > + > + codec@a { > + compatible = "fsl,sgtl5000"; > + reg = <0x0a>; > + #sound-dai-cells = <0>; > + clocks = <&clks 150>; > + micbias-resistor-k-ohms = <2>; > + micbias-voltage-m-volts = <2250>; > + VDDA-supply = <®_3p3v>; > + VDDIO-supply = <®_3p3v>; > + }; > + }; > +... > diff --git a/Documentation/devicetree/bindings/trivial-devices.yaml b/Documentation/devicetree/bindings/trivial-devices.yaml > index 4165352a590a..b7e94fe8643f 100644 > --- a/Documentation/devicetree/bindings/trivial-devices.yaml > +++ b/Documentation/devicetree/bindings/trivial-devices.yaml > @@ -80,8 +80,6 @@ properties: > - fsl,mpl3115 > # MPR121: Proximity Capacitive Touch Sensor Controller > - fsl,mpr121 > - # SGTL5000: Ultra Low-Power Audio Codec > - - fsl,sgtl5000 > # G751: Digital Temperature Sensor and Thermal Watchdog with Two-Wire Interface > - gmt,g751 > # Infineon IR38064 Voltage Regulator > -- > 2.24.1 >
diff --git a/Documentation/devicetree/bindings/sound/sgtl5000.txt b/Documentation/devicetree/bindings/sound/sgtl5000.txt deleted file mode 100644 index 9d9ff5184939..000000000000 --- a/Documentation/devicetree/bindings/sound/sgtl5000.txt +++ /dev/null @@ -1,60 +0,0 @@ -* Freescale SGTL5000 Stereo Codec - -Required properties: -- compatible : "fsl,sgtl5000". - -- reg : the I2C address of the device - -- #sound-dai-cells: must be equal to 0 - -- clocks : the clock provider of SYS_MCLK - -- VDDA-supply : the regulator provider of VDDA - -- VDDIO-supply: the regulator provider of VDDIO - -Optional properties: - -- VDDD-supply : the regulator provider of VDDD - -- micbias-resistor-k-ohms : the bias resistor to be used in kOhms - The resistor can take values of 2k, 4k or 8k. - If set to 0 it will be off. - If this node is not mentioned or if the value is unknown, then - micbias resistor is set to 4K. - -- micbias-voltage-m-volts : the bias voltage to be used in mVolts - The voltage can take values from 1.25V to 3V by 250mV steps - If this node is not mentioned or the value is unknown, then - the value is set to 1.25V. - -- lrclk-strength: the LRCLK pad strength. Possible values are: -0, 1, 2 and 3 as per the table below: - -VDDIO 1.8V 2.5V 3.3V -0 = Disable -1 = 1.66 mA 2.87 mA 4.02 mA -2 = 3.33 mA 5.74 mA 8.03 mA -3 = 4.99 mA 8.61 mA 12.05 mA - -- sclk-strength: the SCLK pad strength. Possible values are: -0, 1, 2 and 3 as per the table below: - -VDDIO 1.8V 2.5V 3.3V -0 = Disable -1 = 1.66 mA 2.87 mA 4.02 mA -2 = 3.33 mA 5.74 mA 8.03 mA -3 = 4.99 mA 8.61 mA 12.05 mA - -Example: - -sgtl5000: codec@a { - compatible = "fsl,sgtl5000"; - reg = <0x0a>; - #sound-dai-cells = <0>; - clocks = <&clks 150>; - micbias-resistor-k-ohms = <2>; - micbias-voltage-m-volts = <2250>; - VDDA-supply = <®_3p3v>; - VDDIO-supply = <®_3p3v>; -}; diff --git a/Documentation/devicetree/bindings/sound/sgtl5000.yaml b/Documentation/devicetree/bindings/sound/sgtl5000.yaml new file mode 100644 index 000000000000..4f29b63c54d3 --- /dev/null +++ b/Documentation/devicetree/bindings/sound/sgtl5000.yaml @@ -0,0 +1,103 @@ +# SPDX-License-Identifier: GPL-2.0-only +%YAML 1.2 +--- +$id: http://devicetree.org/schemas/sound/sgtl5000.yaml# +$schema: http://devicetree.org/meta-schemas/core.yaml# + +title: Freescale SGTL5000 Stereo Codec + +maintainers: + - Fabio Estevam <festevam@gmail.com> + +properties: + compatible: + const: fsl,sgtl5000 + + reg: + maxItems: 1 + + "#sound-dai-cells": + const: 0 + + clocks: + items: + - description: the clock provider of SYS_MCLK + + VDDA-supply: + description: the regulator provider of VDDA + + VDDIO-supply: + description: the regulator provider of VDDIO + + VDDD-supply: + description: the regulator provider of VDDD + + micbias-resistor-k-ohms: + description: The bias resistor to be used in kOhms. The resistor can take + values of 2k, 4k or 8k. If set to 0 it will be off. If this node is not + mentioned or if the value is unknown, then micbias resistor is set to + 4k. + $ref: "/schemas/types.yaml#/definitions/uint32" + enum: [ 0, 2, 4, 8 ] + + micbias-voltage-m-volts: + description: The bias voltage to be used in mVolts. The voltage can take + values from 1.25V to 3V by 250mV steps. If this node is not mentioned + or the value is unknown, then the value is set to 1.25V. + $ref: "/schemas/types.yaml#/definitions/uint32" + enum: [ 1250, 1500, 1750, 2000, 2250, 2500, 2750, 3000 ] + + lrclk-strength: + description: | + The LRCLK pad strength. Possible values are: 0, 1, 2 and 3 as per the + table below: + + VDDIO 1.8V 2.5V 3.3V + 0 = Disable + 1 = 1.66 mA 2.87 mA 4.02 mA + 2 = 3.33 mA 5.74 mA 8.03 mA + 3 = 4.99 mA 8.61 mA 12.05 mA + $ref: "/schemas/types.yaml#/definitions/uint32" + enum: [ 0, 1, 2, 3 ] + + sclk-strength: + description: | + The SCLK pad strength. Possible values are: 0, 1, 2 and 3 as per the + table below: + + VDDIO 1.8V 2.5V 3.3V + 0 = Disable + 1 = 1.66 mA 2.87 mA 4.02 mA + 2 = 3.33 mA 5.74 mA 8.03 mA + 3 = 4.99 mA 8.61 mA 12.05 mA + $ref: "/schemas/types.yaml#/definitions/uint32" + enum: [ 0, 1, 2, 3 ] + +required: + - compatible + - reg + - "#sound-dai-cells" + - clocks + - VDDA-supply + - VDDIO-supply + +additionalProperties: false + +examples: + - | + i2c { + #address-cells = <1>; + #size-cells = <0>; + + codec@a { + compatible = "fsl,sgtl5000"; + reg = <0x0a>; + #sound-dai-cells = <0>; + clocks = <&clks 150>; + micbias-resistor-k-ohms = <2>; + micbias-voltage-m-volts = <2250>; + VDDA-supply = <®_3p3v>; + VDDIO-supply = <®_3p3v>; + }; + }; +... diff --git a/Documentation/devicetree/bindings/trivial-devices.yaml b/Documentation/devicetree/bindings/trivial-devices.yaml index 4165352a590a..b7e94fe8643f 100644 --- a/Documentation/devicetree/bindings/trivial-devices.yaml +++ b/Documentation/devicetree/bindings/trivial-devices.yaml @@ -80,8 +80,6 @@ properties: - fsl,mpl3115 # MPR121: Proximity Capacitive Touch Sensor Controller - fsl,mpr121 - # SGTL5000: Ultra Low-Power Audio Codec - - fsl,sgtl5000 # G751: Digital Temperature Sensor and Thermal Watchdog with Two-Wire Interface - gmt,g751 # Infineon IR38064 Voltage Regulator