bindings/thermal/thermal-idle.yaml

1 # SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
4 ---
5 $id: http://devicetree.org/schemas/thermal/thermal-idle.yaml#
6 $schema: http://devicetree.org/meta-schemas/core.yaml#
8 title: Thermal idle cooling device binding
11   - Daniel Lezcano <daniel.lezcano@linaro.org>
14   The thermal idle cooling device allows the system to passively
15   mitigate the temperature on the device by injecting idle cycles,
18   This binding describes the thermal idle node.
22     const: thermal-idle
24       A thermal-idle node describes the idle cooling device properties to
25       cool down efficiently the attached thermal zone.
27   '#cooling-cells':
31       the cooling-maps reference. The first cell is the minimum cooling state
34   duration-us:
36       The idle duration in microsecond the device should cool down.
38   exit-latency-us:
40       The exit latency constraint in microsecond for the injected idle state
42       idle state from among all the present ones.
45   - '#cooling-cells'
50   - |
51     #include <dt-bindings/thermal/thermal.h>
53     // Example: Combining idle cooling device on big CPUs with cpufreq cooling device
55             #address-cells = <2>;
56             #size-cells = <0>;
62                          compatible = "arm,cortex-a72";
64                          enable-method = "psci";
65                          capacity-dmips-mhz = <1024>;
66                          dynamic-power-coefficient = <436>;
67                          #cooling-cells = <2>; /* min followed by max */
68                          cpu-idle-states = <&CPU_SLEEP &CLUSTER_SLEEP>;
69                          thermal-idle {
70                                  #cooling-cells = <2>;
71                                  duration-us = <10000>;
72                                  exit-latency-us = <500>;
78                         compatible = "arm,cortex-a72";
80                         enable-method = "psci";
81                         capacity-dmips-mhz = <1024>;
82                         dynamic-power-coefficient = <436>;
83                         #cooling-cells = <2>; /* min followed by max */
84                         cpu-idle-states = <&CPU_SLEEP &CLUSTER_SLEEP>;
85                         thermal-idle {
86                                 #cooling-cells = <2>;
87                                 duration-us = <10000>;
88                                 exit-latency-us = <500>;
100                 polling-delay-passive = <100>;
101                 polling-delay = <1000>;
131                 cooling-maps {
134                              cooling-device = <&{/cpus/cpu@100/thermal-idle} 0 15 >,
135                                               <&{/cpus/cpu@101/thermal-idle} 0 15>;
140                              cooling-device =