xref: /freebsd/sys/contrib/device-tree/Bindings/input/touchscreen/iqs5xx.txt (revision f81cdf24ba5436367377f7c8e8f51f6df2a75ca7)
1Azoteq IQS550/572/525 Trackpad/Touchscreen Controller
2
3Required 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
18Optional 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
61Example:
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	};
81