Received-SPF: pass (google.com: best guess record for domain of linux-kernel-owner@vger.kernel.org designates 209.132.180.67 as permitted sender) client-ip=209.132.180.67;
Received-SPF: Pass (protection.outlook.com: domain of analog.com designates
 137.71.25.57 as permitted sender) receiver=protection.outlook.com;
 client-ip=137.71.25.57; helo=nwd2mta4.analog.com;
From:   Mircea Caprioru <mircea.caprioru@analog.com>
CC:     Mircea Caprioru <mircea.caprioru@analog.com>,
        Jonathan Cameron <jic23@kernel.org>,
        Hartmut Knaack <knaack.h@gmx.de>,
        Lars-Peter Clausen <lars@metafoo.de>,
        Peter Meerwald-Stadler <pmeerw@pmeerw.net>,
        Rob Herring <robh+dt@kernel.org>,
        Mark Rutland <mark.rutland@arm.com>,
        Linus Walleij <linus.walleij@linaro.org>,
        Sedat Dilek <sedat.dilek@gmail.com>,
        "Rafael Aquini" <aquini@redhat.com>,
        "David S. Miller" <davem@davemloft.net>,
        "Ludovic Desroches" <ludovic.desroches@o2linux.fr>,
        Florian Fainelli <f.fainelli@gmail.com>,
        Randy Dunlap <rdunlap@infradead.org>,
        "Kuppuswamy Sathyanarayanan" 
        <sathyanarayanan.kuppuswamy@linux.intel.com>,
        <linux-iio@vger.kernel.org>, <devicetree@vger.kernel.org>,
        <linux-kernel@vger.kernel.org>
Subject: [PATCH 1/2] dt-bindings: iio: dac: Add docs for AD5770R DAC
Date:   Mon, 30 Jul 2018 16:59:55 +0300
Message-ID: <20180730135956.4611-1-mircea.caprioru@analog.com>
MIME-Version: 1.0
Content-Type: text/plain
SpamDiagnosticOutput: 1:99
SpamDiagnosticMetadata: NSPM
X-MS-Exchange-CrossTenant-OriginalArrivalTime: 30 Jul 2018 14:00:39.2715
 (UTC)
X-MS-Exchange-CrossTenant-Network-Message-Id: ae92d669-e861-46cb-bd1b-08d5f624d4e4
X-MS-Exchange-CrossTenant-Id: eaa689b4-8f87-40e0-9c6f-7228de4d754a
X-MS-Exchange-CrossTenant-OriginalAttributedTenantConnectingIp: TenantId=eaa689b4-8f87-40e0-9c6f-7228de4d754a;Ip=[137.71.25.57];Helo=[nwd2mta4.analog.com]
X-MS-Exchange-CrossTenant-FromEntityHeader: HybridOnPrem
X-MS-Exchange-Transport-CrossTenantHeadersStamped: DM5PR03MB3131
To:     unlisted-recipients:; (no To-header on input)
Sender: linux-kernel-owner@vger.kernel.org
Precedence: bulk
List-ID: <linux-kernel.vger.kernel.org>
X-Mailing-List: linux-kernel@vger.kernel.org

Adding dt-bindings documentation for AD5770R DAC. The bindings follow the
standard SPI and fixed regulator bindings.

Signed-off-by: Mircea Caprioru <mircea.caprioru@analog.com>
---
 .../devicetree/bindings/iio/dac/ad5770r.txt   | 86 +++++++++++++++++++
 MAINTAINERS                                   |  7 ++
 2 files changed, 93 insertions(+)
 create mode 100644 Documentation/devicetree/bindings/iio/dac/ad5770r.txt

diff --git a/Documentation/devicetree/bindings/iio/dac/ad5770r.txt b/Documentation/devicetree/bindings/iio/dac/ad5770r.txt
new file mode 100644
index 000000000000..bdd6ee4d5f2f
--- /dev/null
+++ b/Documentation/devicetree/bindings/iio/dac/ad5770r.txt
@@ -0,0 +1,86 @@
+Analog Devices AD5770R DAC device driver
+
+Required properties for the AD5770R:
+	- compatible: Must be "adi,ad5770r"
+	- reg: SPI chip select number for the device
+	- spi-max-frequency: Max SPI frequency to use (< 10000000, as per
+			Documentation/devicetree/bindings/spi/spi-bus.txt)
+	- child nodes: Each child node represents one channel and has
+		the following required properties:
+		* num: This represents the channel num
+		* adi,range-microamp: Output range of the channel
+		The following ranges are supported:
+		* Channel 0:
+			* <0 300000> 0 mA to 300 mA
+			* <(-60000) 0> -60 to 0 mA
+			* <(-60000) 300000> -60 to 300 mA
+		* Channel 1:
+			* <0 140000> 0 to 140 mA
+			* <0 250000> 0 to 250 mA
+		* Channel 2:
+			* <0 55000> 0 to 55 mA
+			* <0 150000> 0 to 150 mA
+		* Channel 3 to Channel 5:
+			* <0 45000> 0 to 45 mA
+			* <0 100000> 0 to 100 mA
+
+Optional properties:
+
+- vref: Specify the voltage of the external reference used.
+		Available reference options are: 1.25 V or 2.5 V. If no
+		external reference declared then the device will use the
+		internal reference of 1.25 V.
+
+- reset-gpios: GPIO spec for the RESET pin. If specified, it will be
+		asserted during driver probe.
+
+AD5770R Example:
+
+	ad5770r@0 {
+		compatible = "ad5770r";
+		reg = <0>;
+                spi-max-frequency = <1000000>;
+		vref-supply = <&vref>;
+
+		reset-gpios = <&gpio 22 0>;
+
+		channel@0 {
+			num = <0>;
+			adi,range-microamp = <0 300000>;
+		};
+
+		channel@1 {
+			num = <1>;
+			adi,range-microamp = <0 140000>;
+		};
+
+		channel@2 {
+			num = <2>;
+			adi,range-microamp = <0 55000>;
+		};
+
+		channel@3 {
+			num = <3>;
+			adi,range-microamp = <0 45000>;
+		};
+
+		channel@4 {
+			num = <4>;
+			adi,range-microamp = <0 45000>;
+		};
+
+		channel@5 {
+			num = <5>;
+			adi,range-microamp = <0 45000>;
+		};
+       };
+
+External reference example:
+
+	vref: fixedregulator@0 {
+		compatible = "regulator-fixed";
+		regulator-name = "fixed-supply";
+		regulator-min-microvolt = <1250000>;
+		regulator-max-microvolt = <1250000>;
+	};
+
diff --git a/MAINTAINERS b/MAINTAINERS
index 6f7721d1634c..9c2626079592 100644
--- a/MAINTAINERS
+++ b/MAINTAINERS
@@ -756,6 +756,13 @@ M:	Michael Hanselmann <linux-kernel@hansmi.ch>
 S:	Supported
 F:	drivers/macintosh/ams/
 
+ANALOG DEVICES INC AD5770R DRIVER
+M:	Mircea Caprioru <mircea.caprioru@analog.com>
+L:	linux-iio@vger.kernel.org
+W:	http://ez.analog.com/community/linux-device-drivers
+S:	Supported
+F:	Documentation/devicetree/bindings/iio/dac/ad5770r.txt
+
 ANALOG DEVICES INC AD9389B DRIVER
 M:	Hans Verkuil <hans.verkuil@cisco.com>
 L:	linux-media@vger.kernel.org
-- 
2.17.1