From patchwork Sun Jun 27 16:32:30 2021 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Jonathan Cameron X-Patchwork-Id: 467807 Delivered-To: patch@linaro.org Received: by 2002:a02:c94a:0:0:0:0:0 with SMTP id u10csp3282860jao; Sun, 27 Jun 2021 09:30:39 -0700 (PDT) X-Google-Smtp-Source: ABdhPJxLenFNdK8zkK7V8J4kWIhT+FIBlNuDyPIamqwqdpbGEQbXowP8NhUxauu+PX8O6xfzJyWN X-Received: by 2002:aa7:dbc3:: with SMTP id v3mr28070359edt.63.1624811439471; Sun, 27 Jun 2021 09:30:39 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1624811439; cv=none; d=google.com; s=arc-20160816; b=FzxVrhKNfqOGWp40xJuu0NBUIRmiX7oNNHipYQyL7ZMdy16qSRwzErwjRHdog22Bp2 UGBXRERjRry7qB+cjJ4jzC3judOZ+Njb2P3zr05ZI3khkqV7KdYL0TtQ0sg4Azk0kjgl /vWCfeQnfJyVqjGE6EDtFPWhl8iUTDbaS6PnI8yB99kZHWWOFPni87TzGyNg7Z2jbXHz FrHTm822Rv39JSnC2rV/hWHmtTEReV6677ayhukdvdmtFlJ1cOK6K3p9/I28GH1HR4/7 +rcxO/tW0qR+6SfdBhfdPqrzJSF+yutIbd/Lu1i4q8A7tmMj/nPQj/YqCsSvAe2ppvci oOTg== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:content-transfer-encoding:mime-version :references:in-reply-to:message-id:date:subject:cc:to:from :dkim-signature; bh=eUhb/65/501wP48o/4GiNKU6I7nWUGF3VD7QAsBeyJQ=; b=k5L0jU0yFRkAFtaccC67Nt0BATRU7/hP/HnHJdYLx3T5dLFJWT8kyijyGVyY1JohDg RQfB7alUJpg+Rb03WpFo6ypiiwF0e701OiA9ZIBNLM59Ew1S9+98WZLrUfHFxZRfJMlq eqvux6pGhg0yU33MSucDenCEjUuMaH0RRvFcWgKhJLzEaf7Vv5nEGQlTBUEtY4BYvevu +cGMkUrYgc7EqXbPocdkNZvgbCAWJOVrhRAOk6ebz3GRTv4mlCfU2lv18Go5dy/tlVIg KEYM1dplGSvpse4F7m2PKogLSvlmbQDh69xX/2U9lgmTSpeOrpixm/fcwGDEQDdZ2piN I2RA== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@kernel.org header.s=k20201202 header.b=OFITp9rc; spf=pass (google.com: domain of devicetree-owner@vger.kernel.org designates 23.128.96.18 as permitted sender) smtp.mailfrom=devicetree-owner@vger.kernel.org; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=kernel.org Return-Path: Received: from vger.kernel.org (vger.kernel.org. [23.128.96.18]) by mx.google.com with ESMTP id s27si11202998edy.94.2021.06.27.09.30.39; Sun, 27 Jun 2021 09:30:39 -0700 (PDT) Received-SPF: pass (google.com: domain of devicetree-owner@vger.kernel.org designates 23.128.96.18 as permitted sender) client-ip=23.128.96.18; Authentication-Results: mx.google.com; dkim=pass header.i=@kernel.org header.s=k20201202 header.b=OFITp9rc; spf=pass (google.com: domain of devicetree-owner@vger.kernel.org designates 23.128.96.18 as permitted sender) smtp.mailfrom=devicetree-owner@vger.kernel.org; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=kernel.org Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S230334AbhF0Qc7 (ORCPT + 7 others); Sun, 27 Jun 2021 12:32:59 -0400 Received: from mail.kernel.org ([198.145.29.99]:44964 "EHLO mail.kernel.org" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S230315AbhF0Qc6 (ORCPT ); Sun, 27 Jun 2021 12:32:58 -0400 Received: by mail.kernel.org (Postfix) with ESMTPSA id 9C663619EE; Sun, 27 Jun 2021 16:30:32 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1624811434; bh=hBOyjKv+0wVWVYHNsRiFNDZRxA1uNPRZ6ksWzHUapDI=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=OFITp9rcZywJFDDSlHRCUT09TQelQxNKYPqnLVsCBzHYlgFJRwdpybTH0/t3a9muB 99Ue1Tzw/V8tStO23WL6JS/12p1PTPf4gbQUpFseMNGRIfe0zYPOapWQo8aIvsYLEB l+4RoG1hqOwQLKLl0okfQCYJFiEAre8Bv6KU5ShtUMLzC9HT8f/J77rKZwcGNM5+mM zklwzyiUJH0vWdhXVVPFBPFbFMghIeVgCrn+pD+HLY8F6bNu69JNHMdGW7M4li5o7H KZLtXDpieMdP4qmpMDQb0pBE4fYLyFmt9B1fnuFMnHw1bDfp0RutdbaJotSTsD/u4G MzRBIuPOI2buA== From: Jonathan Cameron To: linux-iio@vger.kernel.org, Rob Herring , devicetree@vger.kernel.org Cc: Jonathan Cameron , Lars-Peter Clausen Subject: [PATCH 01/15] dt-bindings: iio: dac: adi, ad5421: Add missing binding document. Date: Sun, 27 Jun 2021 17:32:30 +0100 Message-Id: <20210627163244.1090296-2-jic23@kernel.org> X-Mailer: git-send-email 2.32.0 In-Reply-To: <20210627163244.1090296-1-jic23@kernel.org> References: <20210627163244.1090296-1-jic23@kernel.org> MIME-Version: 1.0 Precedence: bulk List-ID: X-Mailing-List: devicetree@vger.kernel.org From: Jonathan Cameron This is documented what is currently the case. There are a number of things that could be added, but I don't feel the binding elements are obvious enough to document without a driver implementation to verify they are good choices. These include * Range * Regulators, both input and potentially output (if the loop being driven is ever described). I've listed Lars and myself as maintainers of the binding, but if anyone else wants to be added they would be most welcome! Signed-off-by: Jonathan Cameron Cc: Lars-Peter Clausen --- .../bindings/iio/dac/adi,ad5421.yaml | 51 +++++++++++++++++++ 1 file changed, 51 insertions(+) -- 2.32.0 Reviewed-by: Rob Herring diff --git a/Documentation/devicetree/bindings/iio/dac/adi,ad5421.yaml b/Documentation/devicetree/bindings/iio/dac/adi,ad5421.yaml new file mode 100644 index 000000000000..188f656617e3 --- /dev/null +++ b/Documentation/devicetree/bindings/iio/dac/adi,ad5421.yaml @@ -0,0 +1,51 @@ +# SPDX-License-Identifier: (GPL-2.0 OR BSD-2-Clause) +%YAML 1.2 +--- +$id: http://devicetree.org/schemas/iio/dac/adi,ad5421.yaml# +$schema: http://devicetree.org/meta-schemas/core.yaml# + +title: Analog Devices AD5421 DAC + +maintainers: + - Lars-Peter Clausen + - Jonathan Cameron + +description: | + AD5421 is designed for us in loop-powered, 4 mA to 20 mA smart transmitter + applications. It provides a 16-bit DAC, current amplifier, voltage regulator + to drive the loop and a voltage reference. + +properties: + compatible: + const: adi,ad5421 + + reg: + maxItems: 1 + + interrupts: + maxItems: 1 + description: Fault signal. + + spi-max-frequency: true + +required: + - compatible + - reg + +additionalProperties: false + +examples: + - | + #include + spi { + #address-cells = <1>; + #size-cells = <0>; + + dac@0 { + compatible = "adi,ad5421"; + reg = <0>; + spi-max-frequency = <30000000>; + interrupts = <55 IRQ_TYPE_LEVEL_HIGH>; + }; + }; +...