1 # SPDX-License-Identifier: (GPL-2.0 OR BSD-2-C 1 # SPDX-License-Identifier: (GPL-2.0 OR BSD-2-Clause)
2 %YAML 1.2 2 %YAML 1.2
3 --- 3 ---
4 $id: http://devicetree.org/schemas/thermal/qco 4 $id: http://devicetree.org/schemas/thermal/qcom-spmi-adc-tm5.yaml#
5 $schema: http://devicetree.org/meta-schemas/co 5 $schema: http://devicetree.org/meta-schemas/core.yaml#
6 6
7 title: Qualcomm's SPMI PMIC ADC Thermal Monito 7 title: Qualcomm's SPMI PMIC ADC Thermal Monitoring
8 maintainers: 8 maintainers:
9 - Dmitry Baryshkov <dmitry.baryshkov@linaro.o 9 - Dmitry Baryshkov <dmitry.baryshkov@linaro.org>
10 10
11 $ref: thermal-sensor.yaml# 11 $ref: thermal-sensor.yaml#
12 12
13 properties: 13 properties:
14 compatible: 14 compatible:
15 enum: 15 enum:
16 - qcom,spmi-adc-tm5 16 - qcom,spmi-adc-tm5
17 - qcom,spmi-adc-tm5-gen2 17 - qcom,spmi-adc-tm5-gen2
18 - qcom,adc-tm7 # Incomplete / subject to 18 - qcom,adc-tm7 # Incomplete / subject to change
19 19
20 reg: 20 reg:
21 maxItems: 1 21 maxItems: 1
22 22
23 interrupts: 23 interrupts:
24 maxItems: 1 24 maxItems: 1
25 25
26 "#thermal-sensor-cells": 26 "#thermal-sensor-cells":
27 const: 1 27 const: 1
28 28
29 "#address-cells": 29 "#address-cells":
30 const: 1 30 const: 1
31 31
32 "#size-cells": 32 "#size-cells":
33 const: 0 33 const: 0
34 34
35 qcom,avg-samples: 35 qcom,avg-samples:
36 $ref: /schemas/types.yaml#/definitions/uin 36 $ref: /schemas/types.yaml#/definitions/uint32
37 description: Number of samples to be used 37 description: Number of samples to be used for measurement.
38 Not applicable for Gen2 ADC_TM per 38 Not applicable for Gen2 ADC_TM peripheral.
39 enum: 39 enum:
40 - 1 40 - 1
41 - 2 41 - 2
42 - 4 42 - 4
43 - 8 43 - 8
44 - 16 44 - 16
45 default: 1 45 default: 1
46 46
47 qcom,decimation: 47 qcom,decimation:
48 $ref: /schemas/types.yaml#/definitions/uin 48 $ref: /schemas/types.yaml#/definitions/uint32
49 description: This parameter is used to dec 49 description: This parameter is used to decrease ADC sampling rate.
50 Quicker measurements can be made b 50 Quicker measurements can be made by reducing decimation ratio.
51 Not applicable for Gen2 ADC_TM per 51 Not applicable for Gen2 ADC_TM peripheral.
52 enum: 52 enum:
53 - 250 53 - 250
54 - 420 54 - 420
55 - 840 55 - 840
56 default: 840 56 default: 840
57 57
58 patternProperties: 58 patternProperties:
59 "^([-a-z0-9]*)@[0-7]$": 59 "^([-a-z0-9]*)@[0-7]$":
60 type: object 60 type: object
61 description: 61 description:
62 Represent one thermal sensor. 62 Represent one thermal sensor.
63 63
64 properties: 64 properties:
65 reg: 65 reg:
66 description: Specify the sensor channe 66 description: Specify the sensor channel. There are 8 channels in PMIC5's ADC TM
67 minimum: 0 67 minimum: 0
68 maximum: 7 68 maximum: 7
69 69
70 io-channels: 70 io-channels:
71 description: 71 description:
72 From common IIO binding. Used to pip 72 From common IIO binding. Used to pipe PMIC ADC channel to thermal monitor
73 73
74 qcom,ratiometric: 74 qcom,ratiometric:
75 $ref: /schemas/types.yaml#/definitions 75 $ref: /schemas/types.yaml#/definitions/flag
76 description: 76 description:
77 Channel calibration type. 77 Channel calibration type.
78 If this property is specified VADC w 78 If this property is specified VADC will use the VDD reference
79 (1.875V) and GND for channel calibra 79 (1.875V) and GND for channel calibration. If property is not found,
80 channel will be calibrated with 0V a 80 channel will be calibrated with 0V and 1.25V reference channels,
81 also known as absolute calibration. 81 also known as absolute calibration.
82 82
83 qcom,hw-settle-time-us: 83 qcom,hw-settle-time-us:
84 description: Time between AMUX getting 84 description: Time between AMUX getting configured and the ADC starting conversion.
85 enum: [15, 100, 200, 300, 400, 500, 60 85 enum: [15, 100, 200, 300, 400, 500, 600, 700, 1000, 2000, 4000, 8000, 16000, 32000, 64000, 128000]
86 86
87 qcom,pre-scaling: 87 qcom,pre-scaling:
88 $ref: /schemas/types.yaml#/definitions 88 $ref: /schemas/types.yaml#/definitions/uint32-array
89 description: Used for scaling the chan 89 description: Used for scaling the channel input signal before the
90 signal is fed to VADC. The configura 90 signal is fed to VADC. The configuration for this node is to know the
91 pre-determined ratio and use it for 91 pre-determined ratio and use it for post scaling. It is a pair of
92 integers, denoting the numerator and 92 integers, denoting the numerator and denominator of the fraction by
93 which input signal is multiplied. Fo 93 which input signal is multiplied. For example, <1 3> indicates the
94 signal is scaled down to 1/3 of its 94 signal is scaled down to 1/3 of its value before ADC measurement. If
95 property is not found default value 95 property is not found default value depending on chip will be used.
96 items: 96 items:
97 - const: 1 97 - const: 1
98 - enum: [ 1, 3, 4, 6, 20, 8, 10 ] 98 - enum: [ 1, 3, 4, 6, 20, 8, 10 ]
99 99
100 qcom,avg-samples: 100 qcom,avg-samples:
101 $ref: /schemas/types.yaml#/definitions 101 $ref: /schemas/types.yaml#/definitions/uint32
102 description: Number of samples to be u 102 description: Number of samples to be used for measurement.
103 This property in child node is appli 103 This property in child node is applicable only for Gen2 ADC_TM peripheral.
104 enum: 104 enum:
105 - 1 105 - 1
106 - 2 106 - 2
107 - 4 107 - 4
108 - 8 108 - 8
109 - 16 109 - 16
110 default: 1 110 default: 1
111 111
112 qcom,decimation: 112 qcom,decimation:
113 $ref: /schemas/types.yaml#/definitions 113 $ref: /schemas/types.yaml#/definitions/uint32
114 description: This parameter is used to 114 description: This parameter is used to decrease ADC sampling rate.
115 Quicker measurements can be made by 115 Quicker measurements can be made by reducing decimation ratio.
116 This property in child node is appli 116 This property in child node is applicable only for Gen2 ADC_TM peripheral.
117 enum: 117 enum:
118 - 85 118 - 85
119 - 340 119 - 340
120 - 1360 120 - 1360
121 default: 1360 121 default: 1360
122 122
123 required: 123 required:
124 - reg 124 - reg
125 - io-channels 125 - io-channels
126 126
127 additionalProperties: 127 additionalProperties:
128 false 128 false
129 129
130 allOf: 130 allOf:
131 - if: 131 - if:
132 properties: 132 properties:
133 compatible: 133 compatible:
134 contains: 134 contains:
135 const: qcom,spmi-adc-tm5 135 const: qcom,spmi-adc-tm5
136 136
137 then: 137 then:
138 patternProperties: 138 patternProperties:
139 "^([-a-z0-9]*)@[0-7]$": 139 "^([-a-z0-9]*)@[0-7]$":
140 properties: 140 properties:
141 qcom,decimation: false 141 qcom,decimation: false
142 qcom,avg-samples: false 142 qcom,avg-samples: false
143 143
144 - if: 144 - if:
145 properties: 145 properties:
146 compatible: 146 compatible:
147 contains: 147 contains:
148 const: qcom,spmi-adc-tm5-gen2 148 const: qcom,spmi-adc-tm5-gen2
149 149
150 then: 150 then:
151 properties: 151 properties:
152 qcom,avg-samples: false 152 qcom,avg-samples: false
153 qcom,decimation: false 153 qcom,decimation: false
154 154
155 required: 155 required:
156 - compatible 156 - compatible
157 - reg 157 - reg
158 - interrupts 158 - interrupts
159 - "#address-cells" 159 - "#address-cells"
160 - "#size-cells" 160 - "#size-cells"
161 161
162 unevaluatedProperties: false 162 unevaluatedProperties: false
163 163
164 examples: 164 examples:
165 - | 165 - |
166 #include <dt-bindings/iio/qcom,spmi-vadc.h 166 #include <dt-bindings/iio/qcom,spmi-vadc.h>
167 #include <dt-bindings/interrupt-controller 167 #include <dt-bindings/interrupt-controller/irq.h>
168 168
169 pmic { 169 pmic {
170 #address-cells = <1>; 170 #address-cells = <1>;
171 #size-cells = <0>; 171 #size-cells = <0>;
172 172
173 pm8150b_adc: adc@3100 { 173 pm8150b_adc: adc@3100 {
174 compatible = "qcom,spmi-adc5"; 174 compatible = "qcom,spmi-adc5";
175 reg = <0x3100>; 175 reg = <0x3100>;
176 #address-cells = <1>; 176 #address-cells = <1>;
177 #size-cells = <0>; 177 #size-cells = <0>;
178 #io-channel-cells = <1>; 178 #io-channel-cells = <1>;
179 179
180 /* Other properties are omitted */ 180 /* Other properties are omitted */
181 channel@4f { 181 channel@4f {
182 reg = <ADC5_AMUX_THM3_100K_PU> 182 reg = <ADC5_AMUX_THM3_100K_PU>;
183 qcom,ratiometric; 183 qcom,ratiometric;
184 qcom,hw-settle-time = <200>; 184 qcom,hw-settle-time = <200>;
185 label = "conn_therm"; 185 label = "conn_therm";
186 }; 186 };
187 }; 187 };
188 188
189 adc-tm@3500 { 189 adc-tm@3500 {
190 compatible = "qcom,spmi-adc-tm5"; 190 compatible = "qcom,spmi-adc-tm5";
191 reg = <0x3500>; 191 reg = <0x3500>;
192 interrupts = <0x2 0x35 0x0 IRQ_TYP 192 interrupts = <0x2 0x35 0x0 IRQ_TYPE_EDGE_RISING>;
193 #thermal-sensor-cells = <1>; 193 #thermal-sensor-cells = <1>;
194 #address-cells = <1>; 194 #address-cells = <1>;
195 #size-cells = <0>; 195 #size-cells = <0>;
196 196
197 conn-therm@0 { 197 conn-therm@0 {
198 reg = <0>; 198 reg = <0>;
199 io-channels = <&pm8150b_adc AD 199 io-channels = <&pm8150b_adc ADC5_AMUX_THM3_100K_PU>;
200 qcom,ratiometric; 200 qcom,ratiometric;
201 qcom,hw-settle-time-us = <200> 201 qcom,hw-settle-time-us = <200>;
202 }; 202 };
203 }; 203 };
204 }; 204 };
205 205
206 - | 206 - |
207 #include <dt-bindings/iio/qcom,spmi-adc7-p 207 #include <dt-bindings/iio/qcom,spmi-adc7-pmk8350.h>
208 #include <dt-bindings/iio/qcom,spmi-adc7-p 208 #include <dt-bindings/iio/qcom,spmi-adc7-pm8350.h>
209 #include <dt-bindings/interrupt-controller 209 #include <dt-bindings/interrupt-controller/irq.h>
210 210
211 pmic { 211 pmic {
212 #address-cells = <1>; 212 #address-cells = <1>;
213 #size-cells = <0>; 213 #size-cells = <0>;
214 214
215 pmk8350_vadc: adc@3100 { 215 pmk8350_vadc: adc@3100 {
216 compatible = "qcom,spmi-adc7"; 216 compatible = "qcom,spmi-adc7";
217 reg = <0x3100>; 217 reg = <0x3100>;
218 #address-cells = <1>; 218 #address-cells = <1>;
219 #size-cells = <0>; 219 #size-cells = <0>;
220 #io-channel-cells = <1>; 220 #io-channel-cells = <1>;
221 221
222 /* Other properties are omitted */ 222 /* Other properties are omitted */
223 channel@44 { 223 channel@44 {
224 reg = <PMK8350_ADC7_AMUX_THM1_ 224 reg = <PMK8350_ADC7_AMUX_THM1_100K_PU>;
225 qcom,ratiometric; 225 qcom,ratiometric;
226 qcom,hw-settle-time = <200>; 226 qcom,hw-settle-time = <200>;
227 label = "xo_therm"; 227 label = "xo_therm";
228 }; 228 };
229 229
230 channel@147 { 230 channel@147 {
231 reg = <PM8350_ADC7_AMUX_THM4_1 231 reg = <PM8350_ADC7_AMUX_THM4_100K_PU(1)>;
232 qcom,ratiometric; 232 qcom,ratiometric;
233 qcom,hw-settle-time = <200>; 233 qcom,hw-settle-time = <200>;
234 label = "conn_therm"; 234 label = "conn_therm";
235 }; 235 };
236 }; 236 };
237 237
238 adc-tm@3400 { 238 adc-tm@3400 {
239 compatible = "qcom,spmi-adc-tm5-ge 239 compatible = "qcom,spmi-adc-tm5-gen2";
240 reg = <0x3400>; 240 reg = <0x3400>;
241 interrupts = <0x0 0x34 0x0 IRQ_TYP 241 interrupts = <0x0 0x34 0x0 IRQ_TYPE_EDGE_RISING>;
242 #thermal-sensor-cells = <1>; 242 #thermal-sensor-cells = <1>;
243 #address-cells = <1>; 243 #address-cells = <1>;
244 #size-cells = <0>; 244 #size-cells = <0>;
245 245
246 pmk8350-xo-therm@0 { 246 pmk8350-xo-therm@0 {
247 reg = <0>; 247 reg = <0>;
248 io-channels = <&pmk8350_vadc P 248 io-channels = <&pmk8350_vadc PMK8350_ADC7_AMUX_THM1_100K_PU>;
249 qcom,decimation = <340>; 249 qcom,decimation = <340>;
250 qcom,ratiometric; 250 qcom,ratiometric;
251 qcom,hw-settle-time-us = <200> 251 qcom,hw-settle-time-us = <200>;
252 }; 252 };
253 253
254 conn-therm@1 { 254 conn-therm@1 {
255 reg = <1>; 255 reg = <1>;
256 io-channels = <&pmk8350_vadc P 256 io-channels = <&pmk8350_vadc PM8350_ADC7_AMUX_THM4_100K_PU(1)>;
257 qcom,avg-samples = <2>; 257 qcom,avg-samples = <2>;
258 qcom,ratiometric; 258 qcom,ratiometric;
259 qcom,hw-settle-time-us = <200> 259 qcom,hw-settle-time-us = <200>;
260 }; 260 };
261 }; 261 };
262 }; 262 };
263 ... 263 ...
Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.