Merge tag 'kbuild-misc-v4.15' of git://git.kernel.org/pub/scm/linux/kernel/git/masahi...
[sfrench/cifs-2.6.git] / Documentation / devicetree / bindings / mfd / sun4i-gpadc.txt
1 Allwinner SoCs' GPADC Device Tree bindings
2 ------------------------------------------
3 The Allwinner SoCs all have an ADC that can also act as a thermal sensor
4 and sometimes as a touchscreen controller.
5
6 Required properties:
7   - compatible: "allwinner,sun8i-a33-ths",
8   - reg: mmio address range of the chip,
9   - #thermal-sensor-cells: shall be 0,
10   - #io-channel-cells: shall be 0,
11
12 Example:
13         ths: ths@1c25000 {
14                 compatible = "allwinner,sun8i-a33-ths";
15                 reg = <0x01c25000 0x100>;
16                 #thermal-sensor-cells = <0>;
17                 #io-channel-cells = <0>;
18         };
19
20 sun4i, sun5i and sun6i SoCs are also supported via the older binding:
21
22 sun4i resistive touchscreen controller
23 --------------------------------------
24
25 Required properties:
26  - compatible: "allwinner,sun4i-a10-ts", "allwinner,sun5i-a13-ts" or
27    "allwinner,sun6i-a31-ts"
28  - reg: mmio address range of the chip
29  - interrupts: interrupt to which the chip is connected
30  - #thermal-sensor-cells: shall be 0
31
32 Optional properties:
33  - allwinner,ts-attached         : boolean indicating that an actual touchscreen
34                                    is attached to the controller
35  - allwinner,tp-sensitive-adjust : integer (4 bits)
36                                    adjust sensitivity of pen down detection
37                                    between 0 (least sensitive) and 15
38                                    (defaults to 15)
39  - allwinner,filter-type         : integer (2 bits)
40                                    select median and averaging filter
41                                    samples used for median / averaging filter
42                                    0: 4/2
43                                    1: 5/3
44                                    2: 8/4
45                                    3: 16/8
46                                    (defaults to 1)
47
48 Example:
49
50         rtp: rtp@1c25000 {
51                 compatible = "allwinner,sun4i-a10-ts";
52                 reg = <0x01c25000 0x100>;
53                 interrupts = <29>;
54                 allwinner,ts-attached;
55                 #thermal-sensor-cells = <0>;
56                 /* sensitive/noisy touch panel */
57                 allwinner,tp-sensitive-adjust = <0>;
58                 allwinner,filter-type = <3>;
59         };