Received: by 2002:ab2:7855:0:b0:1f9:5764:f03e with SMTP id m21csp962996lqp; Thu, 23 May 2024 05:34:02 -0700 (PDT) X-Forwarded-Encrypted: i=3; AJvYcCVdMQaP3b3+fGPp0f872P1jkrM3wZl7rVuQBVAnPtIQ7Q0xE6EjzvbhFkv3ZE/x88gx3TpWYeO3ybs+eIjB4J5KwLy22UlqPLrCsUNAIg== X-Google-Smtp-Source: AGHT+IHYvdT9NS9Q5LR1uJ2eF1aJQfinNXuDWml6mYu0ySgCovUAY9jDvDvpfqQOyx/1HTOgPje1 X-Received: by 2002:a05:6a21:99a6:b0:1b1:c77f:56c3 with SMTP id adf61e73a8af0-1b1f87ec83amr6186523637.7.1716467642655; Thu, 23 May 2024 05:34:02 -0700 (PDT) ARC-Seal: i=2; a=rsa-sha256; t=1716467642; cv=pass; d=google.com; s=arc-20160816; b=ENG27/dCcQZglrJ0IYmSVNxGXFJDxddsq2hlK+uuTJl5uFWAxWRpDeg9JoFMWlleGo zGBq1/aXgyZKmFOpPsD8nz40ksAEQl4RcyovyZ1t5pFpltRtR4PUocX3vzOV7wSLVlvP Lf34wOHb2XK7rW976Uw5+q1n3otz1cAuAE72poh3D3R3qXVFdzDuf9UXCAJ5Z+10UVOr USmmqcJG3vsZVYnXI7E+dYxMLzM01CzBmaoqTVKuKpSuJP3Gzr2zl3nvFH0MSRF88uQo 7sTdONJJUKsMECnABb0v8PwztaVET39Bk74aHJ/REYnbKphVSZeE4tVBK5RRIqvnsZc6 ZJKA== ARC-Message-Signature: i=2; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=in-reply-to:content-transfer-encoding:content-disposition :mime-version:list-unsubscribe:list-subscribe:list-id:precedence :references:message-id:subject:cc:to:from:date:dkim-signature; bh=Gk8DP5vXtAkJ/zfDkvvZOMUmJlUjTrbxzgGQEpx9NFw=; fh=XrwOEBDui8SXyTR1xcFoxs8GTtVVDRktEGn8+IqKsqw=; b=J61aydEvKGgd+gkuSzHV0XTSmY/6VRoz41NILU778IGejvA6g26N/sBUEm0uZiP5ut 5teSCiJS7qAOyu2+Ij4mE6OyJss7n1r1mDT+OkHoEBQW6u0gXiFs1qo/XjC/19nrkayS EYV++P1Ibojo+wOhG243Rw/HDpQGOsV6fuhC5doKmdcLzexluS91uJ+vL+e3CPclgfow u6JqBY20NV92b+/z4D56BXUp12nvD8a1EC5EoS7HPAlZSxpshve6IdyyAKJAEyM1WEvi IgzrwJVDY6RYGgIm6++qWnudBQ8t2J8FPXGr0zYD69RrR8LiuCQgjlbvtcKNeRxZ5MpN tdPw==; dara=google.com ARC-Authentication-Results: i=2; mx.google.com; dkim=pass header.i=@kernel.org header.s=k20201202 header.b=XzCdnMwf; arc=pass (i=1 dkim=pass dkdomain=kernel.org); spf=pass (google.com: domain of linux-kernel+bounces-187475-linux.lists.archive=gmail.com@vger.kernel.org designates 139.178.88.99 as permitted sender) smtp.mailfrom="linux-kernel+bounces-187475-linux.lists.archive=gmail.com@vger.kernel.org"; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=kernel.org Return-Path: Received: from sv.mirrors.kernel.org (sv.mirrors.kernel.org. [139.178.88.99]) by mx.google.com with ESMTPS id d2e1a72fcca58-6f4d2aee66asi4776741b3a.197.2024.05.23.05.34.02 for (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Thu, 23 May 2024 05:34:02 -0700 (PDT) Received-SPF: pass (google.com: domain of linux-kernel+bounces-187475-linux.lists.archive=gmail.com@vger.kernel.org designates 139.178.88.99 as permitted sender) client-ip=139.178.88.99; Authentication-Results: mx.google.com; dkim=pass header.i=@kernel.org header.s=k20201202 header.b=XzCdnMwf; arc=pass (i=1 dkim=pass dkdomain=kernel.org); spf=pass (google.com: domain of linux-kernel+bounces-187475-linux.lists.archive=gmail.com@vger.kernel.org designates 139.178.88.99 as permitted sender) smtp.mailfrom="linux-kernel+bounces-187475-linux.lists.archive=gmail.com@vger.kernel.org"; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=kernel.org Received: from smtp.subspace.kernel.org (wormhole.subspace.kernel.org [52.25.139.140]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by sv.mirrors.kernel.org (Postfix) with ESMTPS id 3D81F281033 for ; Thu, 23 May 2024 12:34:02 +0000 (UTC) Received: from localhost.localdomain (localhost.localdomain [127.0.0.1]) by smtp.subspace.kernel.org (Postfix) with ESMTP id C930A1487F5; Thu, 23 May 2024 12:33:53 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=kernel.org header.i=@kernel.org header.b="XzCdnMwf" Received: from smtp.kernel.org (aws-us-west-2-korg-mail-1.web.codeaurora.org [10.30.226.201]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id C1E8A1E4A0; Thu, 23 May 2024 12:33:52 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=10.30.226.201 ARC-Seal:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1716467632; cv=none; b=VCAjgvMEXPp+pFImEa1HKK/rVnZ18MOICg0eme5r4jiP8uMIsflktqgGzkTeczPs5m4ski8x+H+93KUJfBTu9pUHgn3aWrhjRfnLtbBNbac5fzJQrTTcpx79OWgET8dI6eGfDDKJ9RwAxCUor/+c36WLcZiw2GStVqqr7Ek59lE= ARC-Message-Signature:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1716467632; c=relaxed/simple; bh=a8MmbzJBeepTahbb6Q+q7oc8lvq89ytBLirdGd192iY=; h=Date:From:To:Cc:Subject:Message-ID:References:MIME-Version: Content-Type:Content-Disposition:In-Reply-To; b=qg2JTcpkJXqbScaX1lCdBr/BCc37V5gweqpTqU7ezMpTdCiT14nOxtZKIXQFuT9N37l59QXzkDBLJP2fNHVnn6Vck14CPgo9cIB6pirrr7Hg1a/+QKXt/lZyMufAfqE6WseFLpOL5KnabYsyl+AFW6oVCQFPoXeRYNtIFTuQ8so= ARC-Authentication-Results:i=1; smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=kernel.org header.i=@kernel.org header.b=XzCdnMwf; arc=none smtp.client-ip=10.30.226.201 Received: by smtp.kernel.org (Postfix) with ESMTPSA id 216F7C2BD10; Thu, 23 May 2024 12:33:52 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1716467632; bh=a8MmbzJBeepTahbb6Q+q7oc8lvq89ytBLirdGd192iY=; h=Date:From:To:Cc:Subject:References:In-Reply-To:From; b=XzCdnMwf9+VrGY2+RNwqK6SHIEV1J7zTUdWsHAHpcOrzQgLud8Zf8Ckxhll/Sz69g kT74aFgaG66KcSgbsmgwfjT7aMt3+I9NWfDZyGDJpt0iRKO0bSxSBOBzIGsmd7jJVL YGMNvC/2j73m6P1PPGJrhk8OIC29gfqsJpAMlyNkrYFsrIlE2Y2oqv8hG0fID752D9 0KRwR+zZygOZBFIhGrcWzsoo5EBHzzZHkZep3JL7Zu84ypYZXXQvE00XuINBo1Us44 VZ5rIr+T9a2CP4uDNK/zLhVlRd3NGDOxNtj9JGDcKRFSQXxudXyKOq9/iSKDQ4mNNf bufHMtKR6bF5w== Date: Thu, 23 May 2024 07:33:51 -0500 From: Rob Herring To: Kim Seer Paller Cc: linux-kernel@vger.kernel.org, linux-iio@vger.kernel.org, devicetree@vger.kernel.org, Jonathan Cameron , David Lechner , Lars-Peter Clausen , Liam Girdwood , Mark Brown , Dimitri Fedrau , Krzysztof Kozlowski , Conor Dooley , Michael Hennerich , Nuno =?iso-8859-1?Q?S=E1?= Subject: Re: [PATCH v2 4/5] dt-bindings: iio: dac: Add adi,ltc2672.yaml Message-ID: <20240523123351.GA2067525-robh@kernel.org> References: <20240523031909.19427-1-kimseer.paller@analog.com> <20240523031909.19427-5-kimseer.paller@analog.com> Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Disposition: inline Content-Transfer-Encoding: 8bit In-Reply-To: <20240523031909.19427-5-kimseer.paller@analog.com> On Thu, May 23, 2024 at 11:19:08AM +0800, Kim Seer Paller wrote: > Add documentation for ltc2672. > > Co-developed-by: Michael Hennerich > Signed-off-by: Michael Hennerich > Signed-off-by: Kim Seer Paller > --- > .../bindings/iio/dac/adi,ltc2672.yaml | 159 ++++++++++++++++++ > MAINTAINERS | 1 + > 2 files changed, 160 insertions(+) > create mode 100644 Documentation/devicetree/bindings/iio/dac/adi,ltc2672.yaml > > diff --git a/Documentation/devicetree/bindings/iio/dac/adi,ltc2672.yaml b/Documentation/devicetree/bindings/iio/dac/adi,ltc2672.yaml > new file mode 100644 > index 000000000000..996aae315640 > --- /dev/null > +++ b/Documentation/devicetree/bindings/iio/dac/adi,ltc2672.yaml > @@ -0,0 +1,159 @@ > +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause) > +%YAML 1.2 > +--- > +$id: http://devicetree.org/schemas/iio/dac/adi,ltc2672.yaml# > +$schema: http://devicetree.org/meta-schemas/core.yaml# > + > +title: Analog Devices LTC2672 DAC > + > +maintainers: > + - Michael Hennerich > + - Kim Seer Paller > + > +description: | > + Analog Devices LTC2672 5 channel, 16 bit, 300mA DAC > + https://www.analog.com/media/en/technical-documentation/data-sheets/ltc2672.pdf > + > +properties: > + compatible: > + enum: > + - adi,ltc2672 > + > + reg: > + maxItems: 1 > + > + spi-max-frequency: > + maximum: 50000000 > + > + vcc-supply: > + description: Analog Supply Voltage Input. > + > + v-neg-supply: > + description: Negative Supply Voltage Input. > + > + vdd0-supply: > + description: Positive Supply Voltage Input for DAC OUT0. > + > + vdd1-supply: > + description: Positive Supply Voltage Input for DAC OUT1. > + > + vdd2-supply: > + description: Positive Supply Voltage Input for DAC OUT2. > + > + vdd3-supply: > + description: Positive Supply Voltage Input for DAC OUT3. > + > + vdd4-supply: > + description: Positive Supply Voltage Input for DAC OUT4. > + > + iovcc-supply: > + description: Digital Input/Output Supply Voltage. > + > + ref-supply: > + description: > + Reference Input/Output. The voltage at the REF pin sets the full-scale > + range of all channels. If not provided the internal reference is used and > + also provided on the VREF pin. > + > + clr-gpios: > + description: > + Active Low Asynchronous Clear Input. A logic low at this level triggered > + input clears the device to the default reset code and output range, which > + is zero-scale with the outputs off. The control registers are cleared to > + zero. > + maxItems: 1 > + > + adi,rfsadj-ohms: > + description: > + If FSADJ is tied to VCC, an internal RFSADJ (20 kΩ) is selected, which > + results in nominal output ranges. When an external resistor of 19 kΩ to > + 41 kΩ can be used instead by connecting the resistor between FSADJ and GND > + it controls the scaling of the ranges, and the internal resistor is > + automatically disconnected. > + minimum: 19000 > + maximum: 41000 > + default: 20000 > + > + io-channels: > + description: > + Analog multiplexer output. Pin voltages and currents can be monitored by > + measuring the voltage at MUX. You need constraints for how many entries and what is each one. > + > + '#address-cells': > + const: 1 > + > + '#size-cells': > + const: 0 > + > +patternProperties: > + "^channel@[0-4]$": > + type: object > + additionalProperties: false > + > + properties: > + reg: > + description: The channel number representing the DAC output channel. > + maximum: 4 > + > + adi,toggle-mode: > + description: > + Set the channel as a toggle enabled channel. Toggle operation enables > + fast switching of a DAC output between two different DAC codes without > + any SPI transaction. > + type: boolean > + > + adi,output-range-microamp: > + description: Specify the channel output full scale range. > + $ref: /schemas/types.yaml#/definitions/uint32 > + enum: [3125000, 6250000, 12500000, 25000000, 50000000, 100000000, > + 200000000, 300000000] > + > + required: > + - reg > + - adi,output-range-microamp > + > +required: > + - compatible > + - reg > + - spi-max-frequency > + - vcc-supply > + - iovcc-supply > + - v-neg-supply > + > +allOf: > + - $ref: /schemas/spi/spi-peripheral-props.yaml# > + > +additionalProperties: false > + > +examples: > + - | > + spi { > + #address-cells = <1>; > + #size-cells = <0>; > + dac@0 { > + compatible = "adi,ltc2672"; > + reg = <0>; > + spi-max-frequency = <10000000>; > + > + vcc-supply = <&vcc>; > + iovcc-supply = <&vcc>; > + ref-supply = <&vref>; > + v-neg-supply = <&vneg>; > + > + io-channels = <&adc 0>; > + > + #address-cells = <1>; > + #size-cells = <0>; > + channel@0 { > + reg = <0>; > + adi,toggle-mode; > + adi,output-range-microamp = <3125000>; > + }; > + > + channel@1 { > + reg = <1>; > + adi,output-range-microamp = <6250000>; > + }; > + }; > + }; > +... > diff --git a/MAINTAINERS b/MAINTAINERS > index 7becbdf7d1df..3320b7af4c0b 100644 > --- a/MAINTAINERS > +++ b/MAINTAINERS > @@ -12858,6 +12858,7 @@ S: Supported > W: https://ez.analog.com/linux-software-drivers > F: Documentation/ABI/testing/sysfs-bus-iio-dac > F: Documentation/devicetree/bindings/iio/dac/adi,ltc2664.yaml > +F: Documentation/devicetree/bindings/iio/dac/adi,ltc2672.yaml > > LTC2688 IIO DAC DRIVER > M: Nuno Sá > -- > 2.34.1 >