Merge "dt-bindings: iio: adc: Add PMIC7 VADC bindings" (0c89554a) · Commits · e / devices / android_kernel_fairphone_FP5

bindings/iio/adc/qcom,spmi-vadc.txt

+29 −10

Original line number	Diff line number	Diff line
		@@ -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