Merge tag 'armsoc-dt' of git://git.kernel.org/pub/scm/linux/kernel/git/soc/soc
[sfrench/cifs-2.6.git] / Documentation / devicetree / bindings / input / touchscreen / iqs5xx.txt
1 Azoteq IQS550/572/525 Trackpad/Touchscreen Controller
2
3 Required properties:
4
5 - compatible                    : Must be equal to one of the following:
6                                   "azoteq,iqs550"
7                                   "azoteq,iqs572"
8                                   "azoteq,iqs525"
9
10 - reg                           : I2C slave address for the device.
11
12 - interrupts                    : GPIO to which the device's active-high RDY
13                                   output is connected (see [0]).
14
15 - reset-gpios                   : GPIO to which the device's active-low NRST
16                                   input is connected (see [1]).
17
18 Optional properties:
19
20 - touchscreen-min-x             : See [2].
21
22 - touchscreen-min-y             : See [2].
23
24 - touchscreen-size-x            : See [2]. If this property is omitted, the
25                                   maximum x-coordinate is specified by the
26                                   device's "X Resolution" register.
27
28 - touchscreen-size-y            : See [2]. If this property is omitted, the
29                                   maximum y-coordinate is specified by the
30                                   device's "Y Resolution" register.
31
32 - touchscreen-max-pressure      : See [2]. Pressure is expressed as the sum of
33                                   the deltas across all channels impacted by a
34                                   touch event. A channel's delta is calculated
35                                   as its count value minus a reference, where
36                                   the count value is inversely proportional to
37                                   the channel's capacitance.
38
39 - touchscreen-fuzz-x            : See [2].
40
41 - touchscreen-fuzz-y            : See [2].
42
43 - touchscreen-fuzz-pressure     : See [2].
44
45 - touchscreen-inverted-x        : See [2]. Inversion is applied relative to that
46                                   which may already be specified by the device's
47                                   FLIP_X and FLIP_Y register fields.
48
49 - touchscreen-inverted-y        : See [2]. Inversion is applied relative to that
50                                   which may already be specified by the device's
51                                   FLIP_X and FLIP_Y register fields.
52
53 - touchscreen-swapped-x-y       : See [2]. Swapping is applied relative to that
54                                   which may already be specified by the device's
55                                   SWITCH_XY_AXIS register field.
56
57 [0]: Documentation/devicetree/bindings/interrupt-controller/interrupts.txt
58 [1]: Documentation/devicetree/bindings/gpio/gpio.txt
59 [2]: Documentation/devicetree/bindings/input/touchscreen/touchscreen.txt
60
61 Example:
62
63         &i2c1 {
64                 /* ... */
65
66                 touchscreen@74 {
67                         compatible = "azoteq,iqs550";
68                         reg = <0x74>;
69                         interrupt-parent = <&gpio>;
70                         interrupts = <17 4>;
71                         reset-gpios = <&gpio 27 1>;
72
73                         touchscreen-size-x = <640>;
74                         touchscreen-size-y = <480>;
75
76                         touchscreen-max-pressure = <16000>;
77                 };
78
79                 /* ... */
80         };