hc
2023-10-25 6c2073b7aa40e29d0eca7d571dd7bc590c7ecaa7
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
Samsung Exynos Analog to Digital Converter bindings
 
The devicetree bindings are for the new ADC driver written for
Exynos4 and upward SoCs from Samsung.
 
New driver handles the following
1. Supports ADC IF found on EXYNOS4412/EXYNOS5250
   and future SoCs from Samsung
2. Add ADC driver under iio/adc framework
3. Also adds the Documentation for device tree bindings
 
Required properties:
- compatible:        Must be "samsung,exynos-adc-v1"
               for Exynos5250 controllers.
           Must be "samsung,exynos-adc-v2" for
               future controllers.
           Must be "samsung,exynos3250-adc" for
               controllers compatible with ADC of Exynos3250.
           Must be "samsung,exynos4212-adc" for
               controllers compatible with ADC of Exynos4212 and Exynos4412.
           Must be "samsung,exynos7-adc" for
               the ADC in Exynos7 and compatibles
           Must be "samsung,s3c2410-adc" for
               the ADC in s3c2410 and compatibles
           Must be "samsung,s3c2416-adc" for
               the ADC in s3c2416 and compatibles
           Must be "samsung,s3c2440-adc" for
               the ADC in s3c2440 and compatibles
           Must be "samsung,s3c2443-adc" for
               the ADC in s3c2443 and compatibles
           Must be "samsung,s3c6410-adc" for
               the ADC in s3c6410 and compatibles
           Must be "samsung,s5pv210-adc" for
               the ADC in s5pv210 and compatibles
- reg:            List of ADC register address range
           - The base address and range of ADC register
           - The base address and range of ADC_PHY register (every
             SoC except for s3c24xx/s3c64xx ADC)
- interrupts:         Contains the interrupt information for the timer. The
           format is being dependent on which interrupt controller
           the Samsung device uses.
- #io-channel-cells = <1>; As ADC has multiple outputs
- clocks        From common clock bindings: handles to clocks specified
           in "clock-names" property, in the same order.
- clock-names        From common clock bindings: list of clock input names
           used by ADC block:
           - "adc" : ADC bus clock
           - "sclk" : ADC special clock (only for Exynos3250 and
                  compatible ADC block)
- vdd-supply        VDD input supply.
 
- samsung,syscon-phandle Contains the PMU system controller node
           (To access the ADC_PHY register on Exynos5250/5420/5800/3250)
Optional properties:
- has-touchscreen:    If present, indicates that a touchscreen is
           connected an usable.
 
Note: child nodes can be added for auto probing from device tree.
 
Example: adding device info in dtsi file
 
adc: adc@12d10000 {
   compatible = "samsung,exynos-adc-v1";
   reg = <0x12D10000 0x100>;
   interrupts = <0 106 0>;
   #io-channel-cells = <1>;
   io-channel-ranges;
 
   clocks = <&clock 303>;
   clock-names = "adc";
 
   vdd-supply = <&buck5_reg>;
   samsung,syscon-phandle = <&pmu_system_controller>;
};
 
Example: adding device info in dtsi file for Exynos3250 with additional sclk
 
adc: adc@126c0000 {
   compatible = "samsung,exynos3250-adc", "samsung,exynos-adc-v2;
   reg = <0x126C0000 0x100>;
   interrupts = <0 137 0>;
   #io-channel-cells = <1>;
   io-channel-ranges;
 
   clocks = <&cmu CLK_TSADC>, <&cmu CLK_SCLK_TSADC>;
   clock-names = "adc", "sclk";
 
   vdd-supply = <&buck5_reg>;
   samsung,syscon-phandle = <&pmu_system_controller>;
};
 
Example: Adding child nodes in dts file
 
adc@12d10000 {
 
   /* NTC thermistor is a hwmon device */
   ncp15wb473@0 {
       compatible = "murata,ncp15wb473";
       pullup-uv = <1800000>;
       pullup-ohm = <47000>;
       pulldown-ohm = <0>;
       io-channels = <&adc 4>;
   };
};
 
Note: Does not apply to ADC driver under arch/arm/plat-samsung/
Note: The child node can be added under the adc node or separately.