| Kernel driver exynos4_tmu |
| ================= |
| |
| Supported chips: |
| * ARM SAMSUNG EXYNOS4 series of SoC |
| Prefix: 'exynos4-tmu' |
| Datasheet: Not publicly available |
| |
| Authors: Donggeun Kim <dg77.kim@samsung.com> |
| |
| Description |
| ----------- |
| |
| This driver allows to read temperature inside SAMSUNG EXYNOS4 series of SoC. |
| |
| The chip only exposes the measured 8-bit temperature code value |
| through a register. |
| Temperature can be taken from the temperature code. |
| There are three equations converting from temperature to temperature code. |
| |
| The three equations are: |
| 1. Two point trimming |
| Tc = (T - 25) * (TI2 - TI1) / (85 - 25) + TI1 |
| |
| 2. One point trimming |
| Tc = T + TI1 - 25 |
| |
| 3. No trimming |
| Tc = T + 50 |
| |
| Tc: Temperature code, T: Temperature, |
| TI1: Trimming info for 25 degree Celsius (stored at TRIMINFO register) |
| Temperature code measured at 25 degree Celsius which is unchanged |
| TI2: Trimming info for 85 degree Celsius (stored at TRIMINFO register) |
| Temperature code measured at 85 degree Celsius which is unchanged |
| |
| TMU(Thermal Management Unit) in EXYNOS4 generates interrupt |
| when temperature exceeds pre-defined levels. |
| The maximum number of configurable threshold is four. |
| The threshold levels are defined as follows: |
| Level_0: current temperature > trigger_level_0 + threshold |
| Level_1: current temperature > trigger_level_1 + threshold |
| Level_2: current temperature > trigger_level_2 + threshold |
| Level_3: current temperature > trigger_level_3 + threshold |
| |
| The threshold and each trigger_level are set |
| through the corresponding registers. |
| |
| When an interrupt occurs, this driver notify user space of |
| one of four threshold levels for the interrupt |
| through kobject_uevent_env and sysfs_notify functions. |
| Although an interrupt condition for level_0 can be set, |
| it is not notified to user space through sysfs_notify function. |
| |
| Sysfs Interface |
| --------------- |
| name name of the temperature sensor |
| RO |
| |
| temp1_input temperature |
| RO |
| |
| temp1_max temperature for level_1 interrupt |
| RO |
| |
| temp1_crit temperature for level_2 interrupt |
| RO |
| |
| temp1_emergency temperature for level_3 interrupt |
| RO |
| |
| temp1_max_alarm alarm for level_1 interrupt |
| RO |
| |
| temp1_crit_alarm |
| alarm for level_2 interrupt |
| RO |
| |
| temp1_emergency_alarm |
| alarm for level_3 interrupt |
| RO |
