1*04f1842aSLinus Walleij# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
2*04f1842aSLinus Walleij%YAML 1.2
3*04f1842aSLinus Walleij---
4*04f1842aSLinus Walleij$id: http://devicetree.org/schemas/input/atmel,maxtouch.yaml#
5*04f1842aSLinus Walleij$schema: http://devicetree.org/meta-schemas/core.yaml#
6*04f1842aSLinus Walleij
7*04f1842aSLinus Walleijtitle: Atmel maXTouch touchscreen/touchpad
8*04f1842aSLinus Walleij
9*04f1842aSLinus Walleijmaintainers:
10*04f1842aSLinus Walleij  - Nick Dyer <nick@shmanahar.org>
11*04f1842aSLinus Walleij  - Linus Walleij <linus.walleij@linaro.org>
12*04f1842aSLinus Walleij
13*04f1842aSLinus Walleijdescription: |
14*04f1842aSLinus Walleij  Atmel maXTouch touchscreen or touchpads such as the mXT244
15*04f1842aSLinus Walleij  and similar devices.
16*04f1842aSLinus Walleij
17*04f1842aSLinus Walleijproperties:
18*04f1842aSLinus Walleij  compatible:
19*04f1842aSLinus Walleij    const: atmel,maxtouch
20*04f1842aSLinus Walleij
21*04f1842aSLinus Walleij  reg:
22*04f1842aSLinus Walleij    maxItems: 1
23*04f1842aSLinus Walleij
24*04f1842aSLinus Walleij  interrupts:
25*04f1842aSLinus Walleij    maxItems: 1
26*04f1842aSLinus Walleij
27*04f1842aSLinus Walleij  vdda-supply:
28*04f1842aSLinus Walleij    description:
29*04f1842aSLinus Walleij      Optional regulator for the AVDD analog voltage.
30*04f1842aSLinus Walleij
31*04f1842aSLinus Walleij  vdd-supply:
32*04f1842aSLinus Walleij    description:
33*04f1842aSLinus Walleij      Optional regulator for the VDD digital voltage.
34*04f1842aSLinus Walleij
35*04f1842aSLinus Walleij  reset-gpios:
36*04f1842aSLinus Walleij    maxItems: 1
37*04f1842aSLinus Walleij    description:
38*04f1842aSLinus Walleij      Optional GPIO specifier for the touchscreen's reset pin
39*04f1842aSLinus Walleij      (active low). The line must be flagged with
40*04f1842aSLinus Walleij      GPIO_ACTIVE_LOW.
41*04f1842aSLinus Walleij
42*04f1842aSLinus Walleij  linux,gpio-keymap:
43*04f1842aSLinus Walleij    $ref: /schemas/types.yaml#/definitions/uint32-array
44*04f1842aSLinus Walleij    description: |
45*04f1842aSLinus Walleij      When enabled, the SPT_GPIOPWN_T19 object sends messages
46*04f1842aSLinus Walleij      on GPIO bit changes. An array of up to 8 entries can be provided
47*04f1842aSLinus Walleij      indicating the Linux keycode mapped to each bit of the status byte,
48*04f1842aSLinus Walleij      starting at the LSB. Linux keycodes are defined in
49*04f1842aSLinus Walleij      <dt-bindings/input/input.h>.
50*04f1842aSLinus Walleij
51*04f1842aSLinus Walleij      Note: the numbering of the GPIOs and the bit they start at varies
52*04f1842aSLinus Walleij      between maXTouch devices. You must either refer to the documentation,
53*04f1842aSLinus Walleij      or experiment to determine which bit corresponds to which input. Use
54*04f1842aSLinus Walleij      KEY_RESERVED for unused padding values.
55*04f1842aSLinus Walleij
56*04f1842aSLinus Walleijrequired:
57*04f1842aSLinus Walleij  - compatible
58*04f1842aSLinus Walleij  - reg
59*04f1842aSLinus Walleij  - interrupts
60*04f1842aSLinus Walleij
61*04f1842aSLinus WalleijadditionalProperties: false
62*04f1842aSLinus Walleij
63*04f1842aSLinus Walleijexamples:
64*04f1842aSLinus Walleij  - |
65*04f1842aSLinus Walleij    #include <dt-bindings/interrupt-controller/irq.h>
66*04f1842aSLinus Walleij    #include <dt-bindings/gpio/gpio.h>
67*04f1842aSLinus Walleij    i2c {
68*04f1842aSLinus Walleij      #address-cells = <1>;
69*04f1842aSLinus Walleij      #size-cells = <0>;
70*04f1842aSLinus Walleij      touchscreen@4a {
71*04f1842aSLinus Walleij        compatible = "atmel,maxtouch";
72*04f1842aSLinus Walleij        reg = <0x4a>;
73*04f1842aSLinus Walleij        interrupt-parent = <&gpio>;
74*04f1842aSLinus Walleij        interrupts = <26 IRQ_TYPE_EDGE_FALLING>;
75*04f1842aSLinus Walleij        reset-gpios = <&gpio 27 GPIO_ACTIVE_LOW>;
76*04f1842aSLinus Walleij        vdda-supply = <&ab8500_ldo_aux2_reg>;
77*04f1842aSLinus Walleij        vdd-supply = <&ab8500_ldo_aux5_reg>;
78*04f1842aSLinus Walleij      };
79*04f1842aSLinus Walleij    };
80*04f1842aSLinus Walleij
81*04f1842aSLinus Walleij...
82