Commit 04f1842a authored by Linus Walleij's avatar Linus Walleij Committed by Dmitry Torokhov
Browse files

Input: atmel_mxt_ts - convert bindings to YAML and extend



This converts the Armel MXT touchscreen bindings to YAML format and
extends them with the following two properties:

- vdda-supply: the optional analog supply voltage
- vdd-supply: the optional digital supply voltage

Tested the schema with all in-tree users and they verify fine.

Signed-off-by: default avatarLinus Walleij <linus.walleij@linaro.org>
Reviewed-by: default avatarRob Herring <robh@kernel.org>
Link: https://lore.kernel.org/r/20201104153032.1387747-2-linus.walleij@linaro.org


Signed-off-by: default avatarDmitry Torokhov <dmitry.torokhov@gmail.com>
parent feedaacd
Loading
Loading
Loading
Loading
+0 −41
Original line number Diff line number Diff line
Atmel maXTouch touchscreen/touchpad

Required properties:
- compatible:
    atmel,maxtouch

    The following compatibles have been used in various products but are
    deprecated:
	atmel,qt602240_ts
	atmel,atmel_mxt_ts
	atmel,atmel_mxt_tp
	atmel,mXT224

- reg: The I2C address of the device

- interrupts: The sink for the touchpad's IRQ output
    See ../interrupt-controller/interrupts.txt

Optional properties for main touchpad device:

- linux,gpio-keymap: When enabled, the SPT_GPIOPWN_T19 object sends messages
    on GPIO bit changes. An array of up to 8 entries can be provided
    indicating the Linux keycode mapped to each bit of the status byte,
    starting at the LSB. Linux keycodes are defined in
    <dt-bindings/input/input.h>.

    Note: the numbering of the GPIOs and the bit they start at varies between
    maXTouch devices. You must either refer to the documentation, or
    experiment to determine which bit corresponds to which input. Use
    KEY_RESERVED for unused padding values.

- reset-gpios: GPIO specifier for the touchscreen's reset pin (active low)

Example:

	touch@4b {
		compatible = "atmel,maxtouch";
		reg = <0x4b>;
		interrupt-parent = <&gpio>;
		interrupts = <TEGRA_GPIO(W, 3) IRQ_TYPE_LEVEL_LOW>;
	};
+81 −0
Original line number Diff line number Diff line
# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
%YAML 1.2
---
$id: http://devicetree.org/schemas/input/atmel,maxtouch.yaml#
$schema: http://devicetree.org/meta-schemas/core.yaml#

title: Atmel maXTouch touchscreen/touchpad

maintainers:
  - Nick Dyer <nick@shmanahar.org>
  - Linus Walleij <linus.walleij@linaro.org>

description: |
  Atmel maXTouch touchscreen or touchpads such as the mXT244
  and similar devices.

properties:
  compatible:
    const: atmel,maxtouch

  reg:
    maxItems: 1

  interrupts:
    maxItems: 1

  vdda-supply:
    description:
      Optional regulator for the AVDD analog voltage.

  vdd-supply:
    description:
      Optional regulator for the VDD digital voltage.

  reset-gpios:
    maxItems: 1
    description:
      Optional GPIO specifier for the touchscreen's reset pin
      (active low). The line must be flagged with
      GPIO_ACTIVE_LOW.

  linux,gpio-keymap:
    $ref: /schemas/types.yaml#/definitions/uint32-array
    description: |
      When enabled, the SPT_GPIOPWN_T19 object sends messages
      on GPIO bit changes. An array of up to 8 entries can be provided
      indicating the Linux keycode mapped to each bit of the status byte,
      starting at the LSB. Linux keycodes are defined in
      <dt-bindings/input/input.h>.

      Note: the numbering of the GPIOs and the bit they start at varies
      between maXTouch devices. You must either refer to the documentation,
      or experiment to determine which bit corresponds to which input. Use
      KEY_RESERVED for unused padding values.

required:
  - compatible
  - reg
  - interrupts

additionalProperties: false

examples:
  - |
    #include <dt-bindings/interrupt-controller/irq.h>
    #include <dt-bindings/gpio/gpio.h>
    i2c {
      #address-cells = <1>;
      #size-cells = <0>;
      touchscreen@4a {
        compatible = "atmel,maxtouch";
        reg = <0x4a>;
        interrupt-parent = <&gpio>;
        interrupts = <26 IRQ_TYPE_EDGE_FALLING>;
        reset-gpios = <&gpio 27 GPIO_ACTIVE_LOW>;
        vdda-supply = <&ab8500_ldo_aux2_reg>;
        vdd-supply = <&ab8500_ldo_aux5_reg>;
      };
    };

...
+1 −1
Original line number Diff line number Diff line
@@ -2980,7 +2980,7 @@ ATMEL MAXTOUCH DRIVER
M:	Nick Dyer <nick@shmanahar.org>
S:	Maintained
T:	git git://github.com/ndyer/linux.git
F:	Documentation/devicetree/bindings/input/atmel,maxtouch.txt
F:	Documentation/devicetree/bindings/input/atmel,maxtouch.yaml
F:	drivers/input/touchscreen/atmel_mxt_ts.c
ATMEL WIRELESS DRIVER