Lines Matching refs:thermal
4 defining hardware thermal structure using device tree.
5 A thermal structure includes thermal zones and their components,
9 The target of device tree thermal descriptors is to describe only
10 the hardware thermal aspects. The thermal device tree bindings are
14 There are five types of nodes involved to describe thermal bindings:
15 - thermal sensors: devices which may be used to take temperature
21 - thermal zones: used to describe thermal data within the hardware;
28 thermal zones. Typical devices are I2C ADC converters and bandgaps. These are
29 nodes providing temperature data to thermal zones. Thermal sensor devices may
33 - #thermal-sensor-cells: Used to provide sensor device specific information
34 Type: unsigned while referring to it. Typically 0 on thermal sensor
38 the IC. See thermal zone binding for more details
115 - trip: A phandle of a trip point node within the same thermal
120 - contribution: The cooling contribution to the thermal zone of the
123 of all cooling contributions within a thermal zone.
129 Refer to include/dt-bindings/thermal/thermal.h for definition of this constant.
133 The thermal zone node is the node containing all the required info
134 for describing a thermal zone, including its cooling device bindings. The
135 thermal zone node must contain, apart from its own properties, one sub-node
140 Type: unsigned when checking this thermal zone.
147 - thermal-sensors: A list of thermal sensor phandles and sensor specifier
148 Type: list of used while monitoring the thermal zone.
153 Type: sub-node required to describe the thermal zone.
162 Elem size: one cell the sensors listed in the thermal-sensors property.
172 Type: unsigned thermal zone can dissipate at the desired
179 derivative over time) in two situations for a thermal zone:
191 * The thermal-zones node
193 The "thermal-zones" node is a container for all thermal zone nodes. It shall
194 contain only sub-nodes describing thermal zones as in the section
195 "Thermal zone nodes". The "thermal-zones" node appears under "/".
199 Below are several examples on how to use thermal data descriptors
202 (a) - CPU thermal zone
204 The CPU thermal zone example below describes how to setup one thermal zone
208 #include <dt-bindings/thermal/thermal.h>
257 #thermal-sensor-cells = <0>;
261 thermal-zones {
262 cpu_thermal: cpu-thermal {
266 thermal-sensors = <&bandgap0>;
305 used to monitor the zone 'cpu-thermal' using its sole sensor. A fan
308 the thermal zone 'cpu-thermal' using its cooling states
312 linked to the same thermal zone, 'cpu-thermal', as a passive cooling device,
314 which is a trip point at 100C. On the thermal zone 'cpu-thermal', at the
320 The example below describes how to deploy several thermal zones based off a
322 case on SoC designs with several internal IPs that may need different thermal
326 #include <dt-bindings/thermal/thermal.h>
335 #thermal-sensor-cells = <1>;
339 thermal-zones {
340 cpu_thermal: cpu-thermal {
345 thermal-sensors = <&bandgap0 0>;
367 gpu_thermal: gpu-thermal {
372 thermal-sensors = <&bandgap0 1>;
394 dsp_thermal: dsp-thermal {
399 thermal-sensors = <&bandgap0 2>;
425 hotspots: one for CPU thermal zone, one for GPU thermal zone and the
426 other to monitor a DSP thermal zone.
429 to different thermal zones. This is achieved by means of using the
430 #thermal-sensor-cells property and using the first cell of the sensor
432 monitor CPU thermal zone, <bandgap 1> is used to monitor GPU thermal
433 zone and <bandgap 2> is used to monitor DSP thermal zone. Each zone
438 (c) - Several sensors within one single thermal zone
441 one thermal zone.
443 #include <dt-bindings/thermal/thermal.h>
452 #thermal-sensor-cells = <0>;
463 #thermal-sensor-cells = <0>;
467 thermal-zones {
468 cpu_thermal: cpu-thermal {
472 thermal-sensors = <&bandgap0>, /* cpu */
489 a thermal hotspot in the silicon. The above example illustrates this situation.
502 thermal-sensors = <&adc>;
507 (d) - Board thermal
509 The board thermal example below illustrates how to setup one thermal zone
512 #include <dt-bindings/thermal/thermal.h>
521 #thermal-sensor-cells = <1>; /* sensor internal ID */
525 thermal-zones {
526 batt-thermal {
531 thermal-sensors = <&adc_dummy 4>;
542 board_thermal: board-thermal {
547 thermal-sensors = <&adc_dummy 0>, /* pcb top edge */