2 * exynos_tmu.h - Samsung EXYNOS TMU (Thermal Management Unit)
4 * Copyright (C) 2011 Samsung Electronics
5 * Donggeun Kim <dg77.kim@samsung.com>
6 * Amit Daniel Kachhap <amit.daniel@samsung.com>
8 * This program is free software; you can redistribute it and/or modify
9 * it under the terms of the GNU General Public License as published by
10 * the Free Software Foundation; either version 2 of the License, or
11 * (at your option) any later version.
13 * This program is distributed in the hope that it will be useful,
14 * but WITHOUT ANY WARRANTY; without even the implied warranty of
15 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
16 * GNU General Public License for more details.
18 * You should have received a copy of the GNU General Public License
19 * along with this program; if not, write to the Free Software
20 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
25 #include <linux/cpu_cooling.h>
27 #include "exynos_thermal_common.h"
29 enum calibration_type {
30 TYPE_ONE_POINT_TRIMMING,
31 TYPE_ONE_POINT_TRIMMING_25,
32 TYPE_ONE_POINT_TRIMMING_85,
33 TYPE_TWO_POINT_TRIMMING,
38 SOC_ARCH_EXYNOS3250 = 1,
44 SOC_ARCH_EXYNOS5420_TRIMINFO,
49 * EXYNOS TMU supported features.
50 * TMU_SUPPORT_EMULATION - This features is used to set user defined
51 * temperature to the TMU controller.
52 * TMU_SUPPORT_MULTI_INST - This features denotes that the soc
53 * has many instances of TMU.
54 * TMU_SUPPORT_FALLING_TRIP - This features shows that interrupt can
55 * be registered for falling trips also.
56 * TMU_SUPPORT_EMUL_TIME - This features allows to set next temp emulation
58 * TMU_SUPPORT_ADDRESS_MULTIPLE - This feature tells that the different TMU
59 * sensors shares some common registers.
60 * TMU_SUPPORT - macro to compare the above features with the supplied.
62 #define TMU_SUPPORT_EMULATION BIT(0)
63 #define TMU_SUPPORT_MULTI_INST BIT(1)
64 #define TMU_SUPPORT_FALLING_TRIP BIT(2)
65 #define TMU_SUPPORT_EMUL_TIME BIT(3)
66 #define TMU_SUPPORT_ADDRESS_MULTIPLE BIT(4)
68 #define TMU_SUPPORTS(a, b) (a->features & TMU_SUPPORT_ ## b)
71 * struct exynos_tmu_register - register descriptors to access registers.
72 * The register validity may vary slightly across different exynos SOC's.
73 * @tmu_cur_temp: register containing the current temperature of the TMU.
74 * @tmu_intstat: Register containing the interrupt status values.
75 * @tmu_intclear: Register for clearing the raised interrupt status.
76 * @emul_con: TMU emulation controller register.
78 struct exynos_tmu_registers {
86 * struct exynos_tmu_platform_data
87 * @threshold: basic temperature for generating interrupt
88 * 25 <= threshold <= 125 [unit: degree Celsius]
89 * @threshold_falling: differntial value for setting threshold
90 * of temperature falling interrupt.
91 * @trigger_levels: array for each interrupt levels
92 * [unit: degree Celsius]
93 * 0: temperature for trigger_level0 interrupt
94 * condition for trigger_level0 interrupt:
95 * current temperature > threshold + trigger_levels[0]
96 * 1: temperature for trigger_level1 interrupt
97 * condition for trigger_level1 interrupt:
98 * current temperature > threshold + trigger_levels[1]
99 * 2: temperature for trigger_level2 interrupt
100 * condition for trigger_level2 interrupt:
101 * current temperature > threshold + trigger_levels[2]
102 * 3: temperature for trigger_level3 interrupt
103 * condition for trigger_level3 interrupt:
104 * current temperature > threshold + trigger_levels[3]
105 * @trigger_type: defines the type of trigger. Possible values are,
106 * THROTTLE_ACTIVE trigger type
107 * THROTTLE_PASSIVE trigger type
108 * SW_TRIP trigger type
110 * @trigger_enable[]: array to denote which trigger levels are enabled.
111 * 1 = enable trigger_level[] interrupt,
112 * 0 = disable trigger_level[] interrupt
113 * @max_trigger_level: max trigger level supported by the TMU
114 * @non_hw_trigger_levels: number of defined non-hardware trigger levels
115 * @gain: gain of amplifier in the positive-TC generator block
117 * @reference_voltage: reference voltage of amplifier
118 * in the positive-TC generator block
119 * 0 < reference_voltage <= 31
120 * @noise_cancel_mode: noise cancellation mode
121 * 000, 100, 101, 110 and 111 can be different modes
122 * @type: determines the type of SOC
123 * @efuse_value: platform defined fuse value
124 * @min_efuse_value: minimum valid trimming data
125 * @max_efuse_value: maximum valid trimming data
126 * @first_point_trim: temp value of the first point trimming
127 * @second_point_trim: temp value of the second point trimming
128 * @default_temp_offset: default temperature offset in case of no trimming
129 * @test_mux; information if SoC supports test MUX
130 * @cal_type: calibration type for temperature
131 * @freq_clip_table: Table representing frequency reduction percentage.
132 * @freq_tab_count: Count of the above table as frequency reduction may
133 * applicable to only some of the trigger levels.
134 * @registers: Pointer to structure containing all the TMU controller registers
135 * and bitfields shifts and masks.
136 * @features: a bitfield value indicating the features supported in SOC like
137 * emulation, multi instance etc
139 * This structure is required for configuration of exynos_tmu driver.
141 struct exynos_tmu_platform_data {
143 u8 threshold_falling;
144 u8 trigger_levels[MAX_TRIP_COUNT];
145 enum trigger_type trigger_type[MAX_TRIP_COUNT];
146 bool trigger_enable[MAX_TRIP_COUNT];
147 u8 max_trigger_level;
148 u8 non_hw_trigger_levels;
150 u8 reference_voltage;
151 u8 noise_cancel_mode;
157 u8 second_point_trim;
158 u8 default_temp_offset;
161 enum calibration_type cal_type;
163 struct freq_clip_table freq_tab[4];
164 unsigned int freq_tab_count;
165 const struct exynos_tmu_registers *registers;
166 unsigned int features;
170 * struct exynos_tmu_init_data
171 * @tmu_count: number of TMU instances.
172 * @tmu_data: platform data of all TMU instances.
173 * This structure is required to store data for multi-instance exynos tmu
176 struct exynos_tmu_init_data {
178 struct exynos_tmu_platform_data tmu_data[];
181 #endif /* _EXYNOS_TMU_H */