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