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