Documentation/devicetree/bindings/thermal/nvidia,tegra124-soctherm.txt

   1 Tegra124 SOCTHERM thermal management system
   2
   3 The SOCTHERM IP block contains thermal sensors, support for polled
   4 or interrupt-based thermal monitoring, CPU and GPU throttling based
   5 on temperature trip points, and handling external overcurrent
   6 notifications. It is also used to manage emergency shutdown in an
   7 overheating situation.
   8
   9 Required properties :
  10 - compatible : For Tegra124, must contain "nvidia,tegra124-soctherm".
  11   For Tegra132, must contain "nvidia,tegra132-soctherm".
  12   For Tegra210, must contain "nvidia,tegra210-soctherm".
  13 - reg : Should contain 1 entry:
  14   - SOCTHERM register set
  15 - interrupts : Defines the interrupt used by SOCTHERM
  16 - clocks : Must contain an entry for each entry in clock-names.
  17   See ../clocks/clock-bindings.txt for details.
  18 - clock-names : Must include the following entries:
  19   - tsensor
  20   - soctherm
  21 - resets : Must contain an entry for each entry in reset-names.
  22   See ../reset/reset.txt for details.
  23 - reset-names : Must include the following entries:
  24   - soctherm
  25 - #thermal-sensor-cells : Should be 1. See ./thermal.txt for a description
  26     of this property. See <dt-bindings/thermal/tegra124-soctherm.h> for a
  27     list of valid values when referring to thermal sensors.
  28
  29 Note:
  30 - the "critical" type trip points will be set to SOC_THERM hardware as the
  31 shut down temperature. Once the temperature of this thermal zone is higher
  32 than it, the system will be shutdown or reset by hardware.
  33
  34 Example :
  35
  36         soctherm@700e2000 {
  37                 compatible = "nvidia,tegra124-soctherm";
  38                 reg = <0x0 0x700e2000 0x0 0x1000>;
  39                 interrupts = <GIC_SPI 48 IRQ_TYPE_LEVEL_HIGH>;
  40                 clocks = <&tegra_car TEGRA124_CLK_TSENSOR>,
  41                         <&tegra_car TEGRA124_CLK_SOC_THERM>;
  42                 clock-names = "tsensor", "soctherm";
  43                 resets = <&tegra_car 78>;
  44                 reset-names = "soctherm";
  45
  46                 #thermal-sensor-cells = <1>;
  47         };
  48
  49 Example: referring to thermal sensors :
  50
  51        thermal-zones {
  52                 cpu {
  53                         polling-delay-passive = <1000>;
  54                         polling-delay = <1000>;
  55
  56                         thermal-sensors =
  57                                 <&soctherm TEGRA124_SOCTHERM_SENSOR_CPU>;
  58
  59                         trips {
  60                                 cpu_shutdown_trip: shutdown-trip {
  61                                         temperature = <102500>;
  62                                         hysteresis = <1000>;
  63                                         type = "critical";
  64                                 };
  65                         };
  66                 };
  67         };