From d02c277821590f984d25b5b0b7f6c2daa9401551 Mon Sep 17 00:00:00 2001
From: Jishnu Prakash <jprakash@qti.qualcomm.com>
Date: Tue, 29 Jun 2021 16:41:46 +0530
Subject: [PATCH] dt-bindings: iio: qcom,spmi-vadc: Add SW-calibrated ADC
 bindings

Add bindings for SW-calibrated ADC used on PMR735A/PMR735B on
targets which don't have PMK8350 running in master mode.

Change-Id: I753b3caf1e52ac9920a9df32cbef465277409700
---
 bindings/iio/adc/qcom,spmi-vadc.txt | 60 ++++++++++++++++++++++++++---
 1 file changed, 55 insertions(+), 5 deletions(-)

diff --git a/bindings/iio/adc/qcom,spmi-vadc.txt b/bindings/iio/adc/qcom,spmi-vadc.txt
index 975907257ad6..b242cb777b44 100644
--- a/bindings/iio/adc/qcom,spmi-vadc.txt
+++ b/bindings/iio/adc/qcom,spmi-vadc.txt
@@ -11,12 +11,13 @@ VADC node:
     Usage: required
     Value type: <string>
     Definition: Should contain "qcom,spmi-vadc".
-                Should contain "qcom,spmi-adc5-gen3" for PMIC5 Gen3 ADC driver.
-                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,spmi-adc5-gen3" for PMIC5 Gen3 ADC.
+                Should contain "qcom,spmi-adc7" for PMIC7 ADC.
+                Should contain "qcom,spmi-adc5" for PMIC5 ADC.
+                Should contain "qcom,spmi-adc-rev2" for PMIC rev2 ADC.
                 Should contain "qcom,pms405-adc" for PMS405 PMIC
-		Should contain "qcom,spmi-adc5-lite" for PMIC5 ADC-lite driver.
+                Should contain "qcom,spmi-adc5-lite" for PMIC5 ADC-lite.
+                Should contain "qcom,spmi-adc7-sw-calib" for PMIC7 SW-calibrated ADC.
 - reg:
     Usage: required
     Value type: <prop-encoded-array>
@@ -108,6 +109,19 @@ Channel node properties:
               If property is not found, channel will be calibrated with 0V
               and 1.25V reference channels, also known as absolute calibration.
 
+- qcom,no-cal:
+    Usage: optional
+    Value type: <empty>
+    Definition: Channel calibration type.
+            - For compatible property "qcom,spmi-adc7-sw-calib", if this property
+              is specified for a channel, VADC will not use any reference channels
+              for that channel's calibration. It is needed for the three calibration
+              channels alone (ADC7_REF_GND, ADC7_1P25VREF and ADC7_VREF_VADC),
+              mutually exclusive with ratiometric calibration and not meant for any
+              other compatible property. If property is not found, channel will be
+              calibrated with 0.625V and 1.25V reference channels, also known as
+              absolute calibration.
+
 - qcom,hw-settle-time:
     Usage: optional
     Value type: <u32>
@@ -187,6 +201,11 @@ configuration nodes should be defined:
 VADC_REF_625MV and/or VADC_SPARE1(based on PMIC version) VADC_REF_1250MV,
 VADC_GND_REF and VADC_VDD_VADC.
 
+For compatible property "qcom,spmi-adc7-sw-calib" following channels, also
+known as reference point channels, are used for result calibration and their
+channel configuration nodes should be defined:
+ADC7_REF_GND, ADC7_1P25VREF and ADC7_VREF_VADC.
+
 Example1:
 
 #include <dt-bindings/iio/qcom,spmi-vadc.h>
@@ -265,3 +284,34 @@ Example2:
 		io-channels = <&pm5100_adc PM5100_ADC5_GEN3_VPH_PWR>;
 		io-channel-names = "vph_pwr";
 	};
+
+Example3:
+
+#include <dt-bindings/iio/qcom,spmi-vadc.h>
+#include <linux/irq.h>
+/* ... */
+
+	/* VADC node */
+	pmr735a_vadc: vadc@3600 {
+		compatible = "qcom,spmi-adc7-sw-calib";
+		reg = <0x3600>, <0x3900>;
+		reg-names = "adc5-sw-calib-pbs-base", "adc5-sw-calib-cmn-base";
+		interrupts = <0x4 0x36 0x0 IRQ_TYPE_EDGE_RISING>;
+		#address-cells = <1>;
+		#size-cells = <0>;
+		#io-channel-cells = <1>;
+		io-channel-ranges;
+
+		/* Channel node */
+		pmr735a_die_temp {
+			reg = <ADC7_DIE_TEMP>;
+			label = "pmr735a_die_temp";
+			qcom,pre-scaling = <1 1>;
+		};
+	};
+
+	/* IIO client node */
+	pmr735a_tz {
+		io-channels = <&pmr735a_vadc ADC7_DIE_TEMP>;
+		io-channel-names = "thermal";
+	};