From 2875b73d9d36dcbbeae7af18b7396c42a43b88e2 Mon Sep 17 00:00:00 2001 From: Jishnu Prakash Date: Tue, 29 Oct 2019 15:39:07 +0530 Subject: [PATCH] dt-bindings: iio: adc: Add PMIC7 VADC bindings Add documentation for PMIC7 VADC peripheral. PMIC7 ADC has support for clients to read voltage and current on supported channels connected to the PMIC. Clients include reading voltage phone power and on board system thermistors for thermal management. ADCs on certain PMICs have support to read battery current. Change-Id: Ieb8ad5779b078dd77838c498b3a4e0bbcf907df8 --- bindings/iio/adc/qcom,spmi-vadc.txt | 39 +++++++++++++++++++++-------- 1 file changed, 29 insertions(+), 10 deletions(-) diff --git a/bindings/iio/adc/qcom,spmi-vadc.txt b/bindings/iio/adc/qcom,spmi-vadc.txt index c8787688..baa11b61 100644 --- a/bindings/iio/adc/qcom,spmi-vadc.txt +++ b/bindings/iio/adc/qcom,spmi-vadc.txt @@ -11,6 +11,7 @@ VADC node: Usage: required Value type: Definition: Should contain "qcom,spmi-vadc". + Should contain "qcom,spmi-adc7" for PMIC7 ADC driver. Should contain "qcom,spmi-adc5" for PMIC5 ADC driver. Should contain "qcom,spmi-adc-rev2" for PMIC rev2 ADC driver. Should contain "qcom,pms405-adc" for PMS405 PMIC @@ -51,7 +52,7 @@ Channel node properties: See include/dt-bindings/iio/qcom,spmi-vadc.h - label: - Usage: required for "qcom,spmi-adc5" and "qcom,spmi-adc-rev2" + Usage: required for "qcom,spmi-adc5", "qcom,spmi-adc7" and "qcom,spmi-adc-rev2" Value type: Definition: ADC input of the platform as seen in the schematics. For thermistor inputs connected to generic AMUX or GPIO inputs @@ -66,8 +67,12 @@ Channel node properties: - For compatible property "qcom,spmi-vadc", valid values are 512, 1024, 2048, 4096. If property is not found, default value of 512 will be used. - - For compatible property "qcom,spmi-adc5", valid values are 250, 420 - and 840. If property is not found, default value of 840 is used. + - For compatible property "qcom,spmi-adc5", valid values are + 250, 420 and 840. If property is not found, default value of + 840 is used. + - For compatible property "qcom,spmi-adc7", valid values are + 85, 340 and 1360. If property is not found, default value of + 1360 is used. - For compatible property "qcom,spmi-adc-rev2", valid values are 256, 512 and 1024. If property is not present, default value is 1024. @@ -90,11 +95,11 @@ Channel node properties: channel calibration. If property is not found, channel will be calibrated with 0.625V and 1.25V reference channels, also known as absolute calibration. - - For compatible property "qcom,spmi-adc5" and "qcom,spmi-adc-rev2", - if this property is specified VADC will use the VDD reference - (1.875V) and GND for channel calibration. If property is not found, - channel will be calibrated with 0V and 1.25V reference channels, - also known as absolute calibration. + - For compatible property "qcom,spmi-adc5", "qcom,spmi-adc7" and + "qcom,spmi-adc-rev2", if this property is specified VADC will + use the VDD reference (1.875V) and GND for channel calibration. + If property is not found, channel will be calibrated with 0V + and 1.25V reference channels, also known as absolute calibration. - qcom,hw-settle-time: Usage: optional @@ -116,6 +121,12 @@ Channel node properties: Certain controller digital versions have valid values of 15, 100, 200, 300, 400, 500, 600, 700, 1, 2, 4, 8, 16, 32, 64, 128 ms If property is not found, channel will use 15us. + - For compatible property "qcom,spmi-adc7", delay = 15us for + value 0, 100us * (value) for values < 8, 1ms for value 8 + and 2ms * (value - 8) otherwise. + Valid values are: 15, 100, 200, 300, 400, 500, 600, 700, 1000, 2000, + 4000, 8000, 16000, 32000, 64000, 128000 us. + If property is not found, channel will use 15us. - qcom,avg-samples: Usage: optional @@ -127,10 +138,18 @@ Channel node properties: - For compatible property "qcom,spmi-vadc", valid values are: 1, 2, 4, 8, 16, 32, 64, 128, 256, 512 If property is not found, 1 sample will be used. - - For compatible property "qcom,spmi-adc5" and "qcom,spmi-adc-rev2", - valid values are: 1, 2, 4, 8, 16 + - For compatible property "qcom,spmi-adc5", "qcom,spmi-adc7" + and "qcom,spmi-adc-rev2", valid values are: 1, 2, 4, 8, 16. If property is not found, 1 sample will be used. +- qcom,scale-fn-type: + Usage: optional + Value type: + Definition: The index of the VADC scale function used to convert raw ADC + code to physical scaled units for the channel. Defined for compatible + properties "qcom,spmi-adc5" and "qcom,spmi-adc7". + See include/dt-bindings/iio/qcom,spmi-vadc.h. + NOTE: For compatible property "qcom,spmi-vadc" following channels, also known as