From 7664fc5dfc9f7bc566ba7d9ac9da6077bbcaae89 Mon Sep 17 00:00:00 2001
From: Ehsan Shaghaei <53513242+Ehsan2754@users.noreply.github.com>
Date: Fri, 26 Jul 2024 22:56:08 +0000
Subject: [PATCH] ad525x_dpot device tree example

---
 .../devicetree/bindings/misc/ad525x_dpot.txt  | 81 +++++++++++++++++++
 Documentation/misc-devices/ad525x_dpot.rst    |  3 +
 2 files changed, 84 insertions(+)
 create mode 100644 Documentation/devicetree/bindings/misc/ad525x_dpot.txt

diff --git a/Documentation/devicetree/bindings/misc/ad525x_dpot.txt b/Documentation/devicetree/bindings/misc/ad525x_dpot.txt
new file mode 100644
index 000000000000..2143276f5317
--- /dev/null
+++ b/Documentation/devicetree/bindings/misc/ad525x_dpot.txt
@@ -0,0 +1,81 @@
+# Digital Potentiometers  compatible with Analog Devices family
+
+# Required properties:
+- compatible <I2C>: 
+  * "ad5258"
+  * "ad5259"
+  * "ad5251"
+  * "ad5252"
+  * "ad5253"
+  * "ad5254"
+  * "ad5255"
+  * "ad5241"
+  * "ad5242"
+  * "ad5243"
+  * "ad5245"
+  * "ad5246"
+  * "ad5247"
+  * "ad5248"
+  * "ad5280"
+  * "ad5282"
+  * "adn2860"
+  * "ad5273"
+  * "ad5161"
+  * "ad5171"
+  * "ad5170"
+  * "ad5172"
+  * "ad5173"
+  * "ad5272"
+  * "ad5274"
+- compatible <SPI>: 
+  * "ad,ad5160"
+  * "ad,ad5161"
+  * "ad,ad5162"
+  * "ad,ad5165"
+  * "ad,ad5200"
+  * "ad,ad5201"
+  * "ad,ad5203"
+  * "ad,ad5204"
+  * "ad,ad5206"
+  * "ad,ad5207"
+  * "ad,ad5231"
+  * "ad,ad5232"
+  * "ad,ad5233"
+  * "ad,ad5235"
+  * "ad,ad5260"
+  * "ad,ad5262"
+  * "ad,ad5263"
+  * "ad,ad5290"
+  * "ad,ad5291"
+  * "ad,ad5292"
+  * "ad,ad5293"
+  * "ad,ad7376"
+  * "ad,ad8400"
+  * "ad,ad8402"
+  * "ad,ad8403"
+  * "ad,adn2850"
+  * "ad,ad5270"
+  * "ad,ad5271"
+- reg : spi chip select number for the device / I2C address
+- spi-max-frequency : max spi frequency to use
+Example for SPI:
+```
+ad5204@1 {
+address-cells = <1>;
+size-cells = <1>;
+compatible = "ad,ad5204";
+spi-max-frequency = <5000000>;
+reg = <1>;
+};
+```
+Example for I2C:
+```
+ad5242@2c {
+compatible = "ad,ad5242";
+reg = <2c>;
+};
+```
+
+
+
+
diff --git a/Documentation/misc-devices/ad525x_dpot.rst b/Documentation/misc-devices/ad525x_dpot.rst
index 6483ec254520..6151336ceb19 100644
--- a/Documentation/misc-devices/ad525x_dpot.rst
+++ b/Documentation/misc-devices/ad525x_dpot.rst
@@ -55,3 +55,6 @@ You can use simple reads/writes to access these files::
 	# echo 3 > rdac0
 	# cat rdac0
 	3
+
+* Note: See device-tree example in:
+ Documentation/devicetree/bindings/misc/ad525x_dpot.txt