* [PATCH V2] dt-bindings: input: tsc2005: Convert to YAML schema
@ 2021-06-10 15:01 Marek Vasut
2021-06-18 21:29 ` Rob Herring
0 siblings, 1 reply; 2+ messages in thread
From: Marek Vasut @ 2021-06-10 15:01 UTC (permalink / raw)
To: devicetree
Cc: Marek Vasut, Dmitry Torokhov, Michael Welling, Rob Herring,
kernel, linux-input
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"
+
+ 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>;
- };
-}
--
2.30.2
^ permalink raw reply related [flat|nested] 2+ messages in thread
* Re: [PATCH V2] dt-bindings: input: tsc2005: Convert to YAML schema
2021-06-10 15:01 [PATCH V2] dt-bindings: input: tsc2005: Convert to YAML schema Marek Vasut
@ 2021-06-18 21:29 ` Rob Herring
0 siblings, 0 replies; 2+ messages in thread
From: Rob Herring @ 2021-06-18 21:29 UTC (permalink / raw)
To: Marek Vasut
Cc: devicetree, Dmitry Torokhov, Michael Welling, kernel, linux-input
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
>
>
^ permalink raw reply [flat|nested] 2+ messages in thread
end of thread, other threads:[~2021-06-18 21:29 UTC | newest]
Thread overview: 2+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2021-06-10 15:01 [PATCH V2] dt-bindings: input: tsc2005: Convert to YAML schema Marek Vasut
2021-06-18 21:29 ` Rob Herring
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).