1 # SPDX-License-Identifier: (GPL-2.0) 1 # SPDX-License-Identifier: (GPL-2.0)
2 # Copyright 2020 Linaro Ltd. 2 # Copyright 2020 Linaro Ltd.
3 %YAML 1.2 3 %YAML 1.2
4 --- 4 ---
5 $id: http://devicetree.org/schemas/thermal/the 5 $id: http://devicetree.org/schemas/thermal/thermal-sensor.yaml#
6 $schema: http://devicetree.org/meta-schemas/co 6 $schema: http://devicetree.org/meta-schemas/core.yaml#
7 7
8 title: Thermal sensor 8 title: Thermal sensor
9 9
10 maintainers: 10 maintainers:
11 - Amit Kucheria <amitk@kernel.org> 11 - Amit Kucheria <amitk@kernel.org>
12 12
13 description: | 13 description: |
14 Thermal management is achieved in devicetree 14 Thermal management is achieved in devicetree by describing the sensor hardware
15 and the software abstraction of thermal zone 15 and the software abstraction of thermal zones required to take appropriate
16 action to mitigate thermal overloads. 16 action to mitigate thermal overloads.
17 17
18 The following node types are used to complet 18 The following node types are used to completely describe a thermal management
19 system in devicetree: 19 system in devicetree:
20 - thermal-sensor: device that measures temp 20 - thermal-sensor: device that measures temperature, has SoC-specific bindings
21 - cooling-device: device used to dissipate 21 - cooling-device: device used to dissipate heat either passively or actively
22 - thermal-zones: a container of the followi 22 - thermal-zones: a container of the following node types used to describe all
23 thermal data for the platform 23 thermal data for the platform
24 24
25 This binding describes the thermal-sensor. 25 This binding describes the thermal-sensor.
26 26
27 Thermal sensor devices provide temperature s 27 Thermal sensor devices provide temperature sensing capabilities on thermal
28 zones. Typical devices are I2C ADC converter 28 zones. Typical devices are I2C ADC converters and bandgaps. Thermal sensor
29 devices may control one or more internal sen 29 devices may control one or more internal sensors.
30 30
31 properties: 31 properties:
32 "#thermal-sensor-cells": 32 "#thermal-sensor-cells":
33 description: 33 description:
34 Used to uniquely identify a thermal sens 34 Used to uniquely identify a thermal sensor instance within an IC. Will be
35 0 on sensor nodes with only a single sen 35 0 on sensor nodes with only a single sensor and at least 1 on nodes
36 containing several internal sensors. 36 containing several internal sensors.
37 enum: [0, 1] 37 enum: [0, 1]
38 38
39 required: 39 required:
40 - "#thermal-sensor-cells" 40 - "#thermal-sensor-cells"
41 41
42 additionalProperties: true 42 additionalProperties: true
43 43
44 examples: 44 examples:
45 - | 45 - |
46 #include <dt-bindings/interrupt-controller 46 #include <dt-bindings/interrupt-controller/arm-gic.h>
47 47
48 // Example 1: SDM845 TSENS 48 // Example 1: SDM845 TSENS
49 soc: soc { 49 soc: soc {
50 #address-cells = <2>; 50 #address-cells = <2>;
51 #size-cells = <2>; 51 #size-cells = <2>;
52 52
53 /* ... */ 53 /* ... */
54 54
55 tsens0: thermal-sensor@c263000 { 55 tsens0: thermal-sensor@c263000 {
56 compatible = "qcom,sdm845- 56 compatible = "qcom,sdm845-tsens", "qcom,tsens-v2";
57 reg = <0 0x0c263000 0 0x1f 57 reg = <0 0x0c263000 0 0x1ff>, /* TM */
58 <0 0x0c222000 0 0x1f 58 <0 0x0c222000 0 0x1ff>; /* SROT */
59 #qcom,sensors = <13>; 59 #qcom,sensors = <13>;
60 interrupts = <GIC_SPI 506 60 interrupts = <GIC_SPI 506 IRQ_TYPE_LEVEL_HIGH>,
61 <GIC_SPI 508 61 <GIC_SPI 508 IRQ_TYPE_LEVEL_HIGH>;
62 interrupt-names = "uplow", 62 interrupt-names = "uplow", "critical";
63 #thermal-sensor-cells = <1 63 #thermal-sensor-cells = <1>;
64 }; 64 };
65 65
66 tsens1: thermal-sensor@c265000 { 66 tsens1: thermal-sensor@c265000 {
67 compatible = "qcom,sdm845- 67 compatible = "qcom,sdm845-tsens", "qcom,tsens-v2";
68 reg = <0 0x0c265000 0 0x1f 68 reg = <0 0x0c265000 0 0x1ff>, /* TM */
69 <0 0x0c223000 0 0x1f 69 <0 0x0c223000 0 0x1ff>; /* SROT */
70 #qcom,sensors = <8>; 70 #qcom,sensors = <8>;
71 interrupts = <GIC_SPI 507 71 interrupts = <GIC_SPI 507 IRQ_TYPE_LEVEL_HIGH>,
72 <GIC_SPI 509 72 <GIC_SPI 509 IRQ_TYPE_LEVEL_HIGH>;
73 interrupt-names = "uplow", 73 interrupt-names = "uplow", "critical";
74 #thermal-sensor-cells = <1 74 #thermal-sensor-cells = <1>;
75 }; 75 };
76 }; 76 };
77 ... 77 ...
Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.