Merge tag 'arc-5.1-rc2' of git://git.kernel.org/pub/scm/linux/kernel/git/vgupta/arc
[sfrench/cifs-2.6.git] / Documentation / devicetree / bindings / input / touchscreen / edt-ft5x06.txt
1 FocalTech EDT-FT5x06 Polytouch driver
2 =====================================
3
4 There are 5 variants of the chip for various touch panel sizes
5 FT5206GE1  2.8" .. 3.8"
6 FT5306DE4  4.3" .. 7"
7 FT5406EE8  7"   .. 8.9"
8 FT5506EEG  7"   .. 8.9"
9 FT5726NEI  5.7” .. 11.6"
10
11 The software interface is identical for all those chips, so that
12 currently there is no need for the driver to distinguish between the
13 different chips. Nevertheless distinct compatible strings are used so
14 that a distinction can be added if necessary without changing the DT
15 bindings.
16
17
18 Required properties:
19  - compatible:  "edt,edt-ft5206"
20            or:  "edt,edt-ft5306"
21            or:  "edt,edt-ft5406"
22            or:  "edt,edt-ft5506"
23            or:  "evervision,ev-ft5726"
24            or:  "focaltech,ft6236"
25
26  - reg:         I2C slave address of the chip (0x38)
27  - interrupts:       interrupt specification for the touchdetect
28                      interrupt
29
30 Optional properties:
31  - reset-gpios: GPIO specification for the RESET input
32  - wake-gpios:  GPIO specification for the WAKE input
33
34  - pinctrl-names: should be "default"
35  - pinctrl-0:   a phandle pointing to the pin settings for the
36                 control gpios
37
38  - threshold:   allows setting the "click"-threshold in the range
39                 from 0 to 80.
40
41  - gain:        allows setting the sensitivity in the range from 0 to
42                 31. Note that lower values indicate higher
43                 sensitivity.
44
45  - offset:      allows setting the edge compensation in the range from
46                 0 to 31.
47
48  - offset-x:    Same as offset, but applies only to the horizontal position.
49                 Range from 0 to 80, only supported by evervision,ev-ft5726
50                 devices.
51
52  - offset-y:    Same as offset, but applies only to the vertical position.
53                 Range from 0 to 80, only supported by evervision,ev-ft5726
54                 devices.
55
56  - touchscreen-size-x      : See touchscreen.txt
57  - touchscreen-size-y      : See touchscreen.txt
58  - touchscreen-fuzz-x      : See touchscreen.txt
59  - touchscreen-fuzz-y      : See touchscreen.txt
60  - touchscreen-inverted-x  : See touchscreen.txt
61  - touchscreen-inverted-y  : See touchscreen.txt
62  - touchscreen-swapped-x-y : See touchscreen.txt
63
64 Example:
65         polytouch: edt-ft5x06@38 {
66                 compatible = "edt,edt-ft5406", "edt,edt-ft5x06";
67                 reg = <0x38>;
68                 pinctrl-names = "default";
69                 pinctrl-0 = <&edt_ft5x06_pins>;
70                 interrupt-parent = <&gpio2>;
71                 interrupts = <5 IRQ_TYPE_EDGE_FALLING>;
72                 reset-gpios = <&gpio2 6 GPIO_ACTIVE_LOW>;
73                 wake-gpios = <&gpio4 9 GPIO_ACTIVE_HIGH>;
74         };