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
This commit is contained in:
Jishnu Prakash
2019-10-29 15:39:07 +05:30
committed by Gerrit - the friendly Code Review server
parent afe0c35919
commit 2875b73d9d

View File

@@ -11,6 +11,7 @@ VADC node:
Usage: required
Value type: <string>
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: <empty>
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: <u32>
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