| Message ID | 20210610150110.29847-1-marex@denx.de (mailing list archive) |
|---|---|
| State | Superseded |
| Headers | show |
| Series | [V2] dt-bindings: input: tsc2005: Convert to YAML schema | expand |
On Thu, Jun 10, 2021 at 05:01:10PM +0200, Marek Vasut wrote: > Convert the TI TSC2004/TSC2005 DT bindings to YAML schema. > > Signed-off-by: Marek Vasut <marex@denx.de> > Cc: Dmitry Torokhov <dmitry.torokhov@gmail.com> > Cc: Michael Welling <mwelling@ieee.org> > Cc: Rob Herring <robh+dt@kernel.org> > Cc: kernel@dh-electronics.com > Cc: linux-input@vger.kernel.org > To: devicetree@vger.kernel.org > --- > V2: - Switch the license to (GPL-2.0-only OR BSD-2-Clause) > --- > .../input/touchscreen/ti,tsc2005.yaml | 128 ++++++++++++++++++ > .../bindings/input/touchscreen/tsc2005.txt | 64 --------- > 2 files changed, 128 insertions(+), 64 deletions(-) > create mode 100644 Documentation/devicetree/bindings/input/touchscreen/ti,tsc2005.yaml > delete mode 100644 Documentation/devicetree/bindings/input/touchscreen/tsc2005.txt > > diff --git a/Documentation/devicetree/bindings/input/touchscreen/ti,tsc2005.yaml b/Documentation/devicetree/bindings/input/touchscreen/ti,tsc2005.yaml > new file mode 100644 > index 000000000000..082c8ab00fcb > --- /dev/null > +++ b/Documentation/devicetree/bindings/input/touchscreen/ti,tsc2005.yaml > @@ -0,0 +1,128 @@ > +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause) > +%YAML 1.2 > +--- > +$id: http://devicetree.org/schemas/input/touchscreen/ti,tsc2005.yaml# > +$schema: http://devicetree.org/meta-schemas/core.yaml# > + > +title: Texas Instruments TSC2004 and TSC2005 touchscreen controller bindings > + > +maintainers: > + - Marek Vasut <marex@denx.de> > + - Michael Welling <mwelling@ieee.org> > + > +properties: > + $nodename: > + pattern: "^touchscreen(@.*)?$" > + > + compatible: > + oneOf: > + - const: "ti,tsc2004" > + - const: "ti,tsc2005" enum instead and drop the quotes. > + > + reg: > + description: | > + I2C address when used on the I2C bus, or the SPI chip select index > + when used on the SPI bus maxItems: 1 > + > + interrupts: > + maxItems: 1 > + > + reset-gpios: > + description: GPIO specifier for the controller reset line maxItems: 1 > + > + spi-max-frequency: > + description: TSC2005 SPI bus clock frequency. > + maximum: 25000000 > + > + ti,x-plate-ohms: > + description: resistance of the touchscreen's X plates in ohm (defaults to 280) > + $ref: /schemas/types.yaml#/definitions/uint32 Standard type, don't need $ref. > + > + ti,esd-recovery-timeout-ms: > + description: | > + if the touchscreen does not respond after the configured time > + (in milli seconds), the driver will reset it. This is disabled > + by default. > + $ref: /schemas/types.yaml#/definitions/uint32 Standard type. > + > + vio-supply: > + description: Regulator specifier > + > + touchscreen-fuzz-pressure: true > + touchscreen-fuzz-x: true > + touchscreen-fuzz-y: true > + touchscreen-max-pressure: true > + touchscreen-size-x: true > + touchscreen-size-y: true > + > +allOf: > + - $ref: touchscreen.yaml# > + - if: > + properties: > + compatible: > + contains: > + const: "ti,tsc2004" Drop quotes > + then: > + properties: > + spi-max-frequency: false > + > +additionalProperties: false > + > +required: > + - compatible > + - reg > + - interrupts > + > +examples: > + - | > + #include <dt-bindings/interrupt-controller/irq.h> > + #include <dt-bindings/gpio/gpio.h> > + i2c { > + #address-cells = <1>; > + #size-cells = <0>; > + touchscreen@48 { > + compatible = "ti,tsc2004"; > + reg = <0x48>; > + vio-supply = <&vio>; > + > + reset-gpios = <&gpio4 8 GPIO_ACTIVE_HIGH>; > + interrupts-extended = <&gpio1 27 IRQ_TYPE_EDGE_RISING>; > + > + touchscreen-fuzz-x = <4>; > + touchscreen-fuzz-y = <7>; > + touchscreen-fuzz-pressure = <2>; > + touchscreen-size-x = <4096>; > + touchscreen-size-y = <4096>; > + touchscreen-max-pressure = <2048>; > + > + ti,x-plate-ohms = <280>; > + ti,esd-recovery-timeout-ms = <8000>; > + }; > + }; > + - | > + #include <dt-bindings/interrupt-controller/irq.h> > + #include <dt-bindings/gpio/gpio.h> > + spi { > + #address-cells = <1>; > + #size-cells = <0>; > + touchscreen@0 { > + compatible = "ti,tsc2005"; > + spi-max-frequency = <6000000>; > + reg = <0>; > + > + vio-supply = <&vio>; > + > + reset-gpios = <&gpio4 8 GPIO_ACTIVE_HIGH>; /* 104 */ > + interrupts-extended = <&gpio4 4 IRQ_TYPE_EDGE_RISING>; /* 100 */ > + > + touchscreen-fuzz-x = <4>; > + touchscreen-fuzz-y = <7>; > + touchscreen-fuzz-pressure = <2>; > + touchscreen-size-x = <4096>; > + touchscreen-size-y = <4096>; > + touchscreen-max-pressure = <2048>; > + > + ti,x-plate-ohms = <280>; > + ti,esd-recovery-timeout-ms = <8000>; > + }; > + }; > diff --git a/Documentation/devicetree/bindings/input/touchscreen/tsc2005.txt b/Documentation/devicetree/bindings/input/touchscreen/tsc2005.txt > deleted file mode 100644 > index b80c04b0e5c0..000000000000 > --- a/Documentation/devicetree/bindings/input/touchscreen/tsc2005.txt > +++ /dev/null > @@ -1,64 +0,0 @@ > -* Texas Instruments tsc2004 and tsc2005 touchscreen controllers > - > -Required properties: > - - compatible : "ti,tsc2004" or "ti,tsc2005" > - - reg : Device address > - - interrupts : IRQ specifier > - - spi-max-frequency : Maximum SPI clocking speed of the device > - (for tsc2005) > - > -Optional properties: > - - vio-supply : Regulator specifier > - - reset-gpios : GPIO specifier for the controller reset line > - - ti,x-plate-ohms : integer, resistance of the touchscreen's X plates > - in ohm (defaults to 280) > - - ti,esd-recovery-timeout-ms : integer, if the touchscreen does not respond after > - the configured time (in milli seconds), the driver > - will reset it. This is disabled by default. > - - properties defined in touchscreen.txt > - > -Example: > - > -&i2c3 { > - tsc2004@48 { > - compatible = "ti,tsc2004"; > - reg = <0x48>; > - vio-supply = <&vio>; > - > - reset-gpios = <&gpio4 8 GPIO_ACTIVE_HIGH>; > - interrupts-extended = <&gpio1 27 IRQ_TYPE_EDGE_RISING>; > - > - touchscreen-fuzz-x = <4>; > - touchscreen-fuzz-y = <7>; > - touchscreen-fuzz-pressure = <2>; > - touchscreen-size-x = <4096>; > - touchscreen-size-y = <4096>; > - touchscreen-max-pressure = <2048>; > - > - ti,x-plate-ohms = <280>; > - ti,esd-recovery-timeout-ms = <8000>; > - }; > -} > - > -&mcspi1 { > - tsc2005@0 { > - compatible = "ti,tsc2005"; > - spi-max-frequency = <6000000>; > - reg = <0>; > - > - vio-supply = <&vio>; > - > - reset-gpios = <&gpio4 8 GPIO_ACTIVE_HIGH>; /* 104 */ > - interrupts-extended = <&gpio4 4 IRQ_TYPE_EDGE_RISING>; /* 100 */ > - > - touchscreen-fuzz-x = <4>; > - touchscreen-fuzz-y = <7>; > - touchscreen-fuzz-pressure = <2>; > - touchscreen-size-x = <4096>; > - touchscreen-size-y = <4096>; > - touchscreen-max-pressure = <2048>; > - > - ti,x-plate-ohms = <280>; > - ti,esd-recovery-timeout-ms = <8000>; > - }; > -} > -- > 2.30.2 > >
diff --git a/Documentation/devicetree/bindings/input/touchscreen/ti,tsc2005.yaml b/Documentation/devicetree/bindings/input/touchscreen/ti,tsc2005.yaml new file mode 100644 index 000000000000..082c8ab00fcb --- /dev/null +++ b/Documentation/devicetree/bindings/input/touchscreen/ti,tsc2005.yaml @@ -0,0 +1,128 @@ +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause) +%YAML 1.2 +--- +$id: http://devicetree.org/schemas/input/touchscreen/ti,tsc2005.yaml# +$schema: http://devicetree.org/meta-schemas/core.yaml# + +title: Texas Instruments TSC2004 and TSC2005 touchscreen controller bindings + +maintainers: + - Marek Vasut <marex@denx.de> + - Michael Welling <mwelling@ieee.org> + +properties: + $nodename: + pattern: "^touchscreen(@.*)?$" + + compatible: + oneOf: + - const: "ti,tsc2004" + - const: "ti,tsc2005" + + reg: + description: | + I2C address when used on the I2C bus, or the SPI chip select index + when used on the SPI bus + + interrupts: + maxItems: 1 + + reset-gpios: + description: GPIO specifier for the controller reset line + + spi-max-frequency: + description: TSC2005 SPI bus clock frequency. + maximum: 25000000 + + ti,x-plate-ohms: + description: resistance of the touchscreen's X plates in ohm (defaults to 280) + $ref: /schemas/types.yaml#/definitions/uint32 + + ti,esd-recovery-timeout-ms: + description: | + if the touchscreen does not respond after the configured time + (in milli seconds), the driver will reset it. This is disabled + by default. + $ref: /schemas/types.yaml#/definitions/uint32 + + vio-supply: + description: Regulator specifier + + touchscreen-fuzz-pressure: true + touchscreen-fuzz-x: true + touchscreen-fuzz-y: true + touchscreen-max-pressure: true + touchscreen-size-x: true + touchscreen-size-y: true + +allOf: + - $ref: touchscreen.yaml# + - if: + properties: + compatible: + contains: + const: "ti,tsc2004" + then: + properties: + spi-max-frequency: false + +additionalProperties: false + +required: + - compatible + - reg + - interrupts + +examples: + - | + #include <dt-bindings/interrupt-controller/irq.h> + #include <dt-bindings/gpio/gpio.h> + i2c { + #address-cells = <1>; + #size-cells = <0>; + touchscreen@48 { + compatible = "ti,tsc2004"; + reg = <0x48>; + vio-supply = <&vio>; + + reset-gpios = <&gpio4 8 GPIO_ACTIVE_HIGH>; + interrupts-extended = <&gpio1 27 IRQ_TYPE_EDGE_RISING>; + + touchscreen-fuzz-x = <4>; + touchscreen-fuzz-y = <7>; + touchscreen-fuzz-pressure = <2>; + touchscreen-size-x = <4096>; + touchscreen-size-y = <4096>; + touchscreen-max-pressure = <2048>; + + ti,x-plate-ohms = <280>; + ti,esd-recovery-timeout-ms = <8000>; + }; + }; + - | + #include <dt-bindings/interrupt-controller/irq.h> + #include <dt-bindings/gpio/gpio.h> + spi { + #address-cells = <1>; + #size-cells = <0>; + touchscreen@0 { + compatible = "ti,tsc2005"; + spi-max-frequency = <6000000>; + reg = <0>; + + vio-supply = <&vio>; + + reset-gpios = <&gpio4 8 GPIO_ACTIVE_HIGH>; /* 104 */ + interrupts-extended = <&gpio4 4 IRQ_TYPE_EDGE_RISING>; /* 100 */ + + touchscreen-fuzz-x = <4>; + touchscreen-fuzz-y = <7>; + touchscreen-fuzz-pressure = <2>; + touchscreen-size-x = <4096>; + touchscreen-size-y = <4096>; + touchscreen-max-pressure = <2048>; + + ti,x-plate-ohms = <280>; + ti,esd-recovery-timeout-ms = <8000>; + }; + }; diff --git a/Documentation/devicetree/bindings/input/touchscreen/tsc2005.txt b/Documentation/devicetree/bindings/input/touchscreen/tsc2005.txt deleted file mode 100644 index b80c04b0e5c0..000000000000 --- a/Documentation/devicetree/bindings/input/touchscreen/tsc2005.txt +++ /dev/null @@ -1,64 +0,0 @@ -* Texas Instruments tsc2004 and tsc2005 touchscreen controllers - -Required properties: - - compatible : "ti,tsc2004" or "ti,tsc2005" - - reg : Device address - - interrupts : IRQ specifier - - spi-max-frequency : Maximum SPI clocking speed of the device - (for tsc2005) - -Optional properties: - - vio-supply : Regulator specifier - - reset-gpios : GPIO specifier for the controller reset line - - ti,x-plate-ohms : integer, resistance of the touchscreen's X plates - in ohm (defaults to 280) - - ti,esd-recovery-timeout-ms : integer, if the touchscreen does not respond after - the configured time (in milli seconds), the driver - will reset it. This is disabled by default. - - properties defined in touchscreen.txt - -Example: - -&i2c3 { - tsc2004@48 { - compatible = "ti,tsc2004"; - reg = <0x48>; - vio-supply = <&vio>; - - reset-gpios = <&gpio4 8 GPIO_ACTIVE_HIGH>; - interrupts-extended = <&gpio1 27 IRQ_TYPE_EDGE_RISING>; - - touchscreen-fuzz-x = <4>; - touchscreen-fuzz-y = <7>; - touchscreen-fuzz-pressure = <2>; - touchscreen-size-x = <4096>; - touchscreen-size-y = <4096>; - touchscreen-max-pressure = <2048>; - - ti,x-plate-ohms = <280>; - ti,esd-recovery-timeout-ms = <8000>; - }; -} - -&mcspi1 { - tsc2005@0 { - compatible = "ti,tsc2005"; - spi-max-frequency = <6000000>; - reg = <0>; - - vio-supply = <&vio>; - - reset-gpios = <&gpio4 8 GPIO_ACTIVE_HIGH>; /* 104 */ - interrupts-extended = <&gpio4 4 IRQ_TYPE_EDGE_RISING>; /* 100 */ - - touchscreen-fuzz-x = <4>; - touchscreen-fuzz-y = <7>; - touchscreen-fuzz-pressure = <2>; - touchscreen-size-x = <4096>; - touchscreen-size-y = <4096>; - touchscreen-max-pressure = <2048>; - - ti,x-plate-ohms = <280>; - ti,esd-recovery-timeout-ms = <8000>; - }; -}
Convert the TI TSC2004/TSC2005 DT bindings to YAML schema. Signed-off-by: Marek Vasut <marex@denx.de> Cc: Dmitry Torokhov <dmitry.torokhov@gmail.com> Cc: Michael Welling <mwelling@ieee.org> Cc: Rob Herring <robh+dt@kernel.org> Cc: kernel@dh-electronics.com Cc: linux-input@vger.kernel.org To: devicetree@vger.kernel.org --- V2: - Switch the license to (GPL-2.0-only OR BSD-2-Clause) --- .../input/touchscreen/ti,tsc2005.yaml | 128 ++++++++++++++++++ .../bindings/input/touchscreen/tsc2005.txt | 64 --------- 2 files changed, 128 insertions(+), 64 deletions(-) create mode 100644 Documentation/devicetree/bindings/input/touchscreen/ti,tsc2005.yaml delete mode 100644 Documentation/devicetree/bindings/input/touchscreen/tsc2005.txt