Merge remote-tracking branches 'asoc/fix/atmel', 'asoc/fix/fsl', 'asoc/fix/tegra...
[linux-drm-fsl-dcu.git] / Documentation / devicetree / bindings / input / touchscreen / ti-tsc-adc.txt
1 * TI - TSC ADC (Touschscreen and analog digital converter)
2 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
3
4 Required properties:
5 - child "tsc"
6         ti,wires: Wires refer to application modes i.e. 4/5/8 wire touchscreen
7                   support on the platform.
8         ti,x-plate-resistance: X plate resistance
9         ti,coordinate-readouts: The sequencer supports a total of 16
10                                 programmable steps each step is used to
11                                 read a single coordinate. A single
12                                 readout is enough but multiple reads can
13                                 increase the quality.
14                                 A value of 5 means, 5 reads for X, 5 for
15                                 Y and 2 for Z (always). This utilises 12
16                                 of the 16 software steps available. The
17                                 remaining 4 can be used by the ADC.
18         ti,wire-config: Different boards could have a different order for
19                         connecting wires on touchscreen. We need to provide an
20                         8 bit number where in the 1st four bits represent the
21                         analog lines and the next 4 bits represent positive/
22                         negative terminal on that input line. Notations to
23                         represent the input lines and terminals resoectively
24                         is as follows:
25                         AIN0 = 0, AIN1 = 1 and so on till AIN7 = 7.
26                         XP  = 0, XN = 1, YP = 2, YN = 3.
27 - child "adc"
28         ti,adc-channels: List of analog inputs available for ADC.
29                          AIN0 = 0, AIN1 = 1 and so on till AIN7 = 7.
30
31 Example:
32         tscadc: tscadc@44e0d000 {
33                 compatible = "ti,am3359-tscadc";
34                 tsc {
35                         ti,wires = <4>;
36                         ti,x-plate-resistance = <200>;
37                         ti,coordiante-readouts = <5>;
38                         ti,wire-config = <0x00 0x11 0x22 0x33>;
39                 };
40
41                 adc {
42                         ti,adc-channels = <4 5 6 7>;
43                 };
44         }