tjh.dev
Linux kernel mirror (for testing)
git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
kernel
os
linux
1* Exynos Thermal Management Unit (TMU)
2
3** Required properties:
4
5- compatible : One of the following:
6 "samsung,exynos3250-tmu"
7 "samsung,exynos4412-tmu"
8 "samsung,exynos4210-tmu"
9 "samsung,exynos5250-tmu"
10 "samsung,exynos5260-tmu"
11 "samsung,exynos5420-tmu" for TMU channel 0, 1 on Exynos5420
12 "samsung,exynos5420-tmu-ext-triminfo" for TMU channels 2, 3 and 4
13 Exynos5420 (Must pass triminfo base and triminfo clock)
14 "samsung,exynos5433-tmu"
15 "samsung,exynos5440-tmu"
16 "samsung,exynos7-tmu"
17- interrupt-parent : The phandle for the interrupt controller
18- reg : Address range of the thermal registers. For soc's which has multiple
19 instances of TMU and some registers are shared across all TMU's like
20 interrupt related then 2 set of register has to supplied. First set
21 belongs to register set of TMU instance and second set belongs to
22 registers shared with the TMU instance.
23
24 NOTE: On Exynos5420, the TRIMINFO register is misplaced for TMU
25 channels 2, 3 and 4
26 Use "samsung,exynos5420-tmu-ext-triminfo" in cases, there is a misplaced
27 register, also provide clock to access that base.
28
29 TRIMINFO at 0x1006c000 contains data for TMU channel 3
30 TRIMINFO at 0x100a0000 contains data for TMU channel 4
31 TRIMINFO at 0x10068000 contains data for TMU channel 2
32
33- interrupts : Should contain interrupt for thermal system
34- clocks : The main clocks for TMU device
35 -- 1. operational clock for TMU channel
36 -- 2. optional clock to access the shared registers of TMU channel
37 -- 3. optional special clock for functional operation
38- clock-names : Thermal system clock name
39 -- "tmu_apbif" operational clock for current TMU channel
40 -- "tmu_triminfo_apbif" clock to access the shared triminfo register
41 for current TMU channel
42 -- "tmu_sclk" clock for functional operation of the current TMU
43 channel
44
45The Exynos TMU supports generating interrupts when reaching given
46temperature thresholds. Number of supported thermal trip points depends
47on the SoC (only first trip points defined in DT will be configured):
48 - most of SoC: 4
49 - samsung,exynos5433-tmu: 8
50 - samsung,exynos7-tmu: 8
51
52Following properties are mandatory (depending on SoC):
53- samsung,tmu_gain: Gain value for internal TMU operation.
54- samsung,tmu_reference_voltage: Value of TMU IP block's reference voltage
55- samsung,tmu_noise_cancel_mode: Mode for noise cancellation
56- samsung,tmu_efuse_value: Default level of temperature - it is needed when
57 in factory fusing produced wrong value
58- samsung,tmu_min_efuse_value: Minimum temperature fused value
59- samsung,tmu_max_efuse_value: Maximum temperature fused value
60- samsung,tmu_first_point_trim: First point trimming value
61- samsung,tmu_second_point_trim: Second point trimming value
62- samsung,tmu_default_temp_offset: Default temperature offset
63- samsung,tmu_cal_type: Callibration type
64
65** Optional properties:
66
67- vtmu-supply: This entry is optional and provides the regulator node supplying
68 voltage to TMU. If needed this entry can be placed inside
69 board/platform specific dts file.
70
71Example 1):
72
73 tmu@100C0000 {
74 compatible = "samsung,exynos4412-tmu";
75 interrupt-parent = <&combiner>;
76 reg = <0x100C0000 0x100>;
77 interrupts = <2 4>;
78 clocks = <&clock 383>;
79 clock-names = "tmu_apbif";
80 status = "disabled";
81 vtmu-supply = <&tmu_regulator_node>;
82 #include "exynos4412-tmu-sensor-conf.dtsi"
83 };
84
85Example 2):
86
87 tmuctrl_0: tmuctrl@160118 {
88 compatible = "samsung,exynos5440-tmu";
89 reg = <0x160118 0x230>, <0x160368 0x10>;
90 interrupts = <0 58 0>;
91 clocks = <&clock 21>;
92 clock-names = "tmu_apbif";
93 #include "exynos5440-tmu-sensor-conf.dtsi"
94 };
95
96Example 3): (In case of Exynos5420 "with misplaced TRIMINFO register")
97 tmu_cpu2: tmu@10068000 {
98 compatible = "samsung,exynos5420-tmu-ext-triminfo";
99 reg = <0x10068000 0x100>, <0x1006c000 0x4>;
100 interrupts = <0 184 0>;
101 clocks = <&clock 318>, <&clock 318>;
102 clock-names = "tmu_apbif", "tmu_triminfo_apbif";
103 #include "exynos4412-tmu-sensor-conf.dtsi"
104 };
105
106 tmu_cpu3: tmu@1006c000 {
107 compatible = "samsung,exynos5420-tmu-ext-triminfo";
108 reg = <0x1006c000 0x100>, <0x100a0000 0x4>;
109 interrupts = <0 185 0>;
110 clocks = <&clock 318>, <&clock 319>;
111 clock-names = "tmu_apbif", "tmu_triminfo_apbif";
112 #include "exynos4412-tmu-sensor-conf.dtsi"
113 };
114
115 tmu_gpu: tmu@100a0000 {
116 compatible = "samsung,exynos5420-tmu-ext-triminfo";
117 reg = <0x100a0000 0x100>, <0x10068000 0x4>;
118 interrupts = <0 215 0>;
119 clocks = <&clock 319>, <&clock 318>;
120 clock-names = "tmu_apbif", "tmu_triminfo_apbif";
121 #include "exynos4412-tmu-sensor-conf.dtsi"
122 };
123
124Note: For multi-instance tmu each instance should have an alias correctly
125numbered in "aliases" node.
126
127Example:
128
129aliases {
130 tmuctrl0 = &tmuctrl_0;
131 tmuctrl1 = &tmuctrl_1;
132 tmuctrl2 = &tmuctrl_2;
133};