From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from mail-pg1-f182.google.com (mail-pg1-f182.google.com [209.85.215.182]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id CA34E302163 for ; Tue, 30 Sep 2025 14:46:33 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.215.182 ARC-Seal:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1759243595; cv=none; b=SAQ7gJKvOP5HzHAhrPP7fkVzzChln+dYqi1t2I3zARwdmQtYFeZLFk0pCFFxOxgMz72/nblVzgg8L//usF2iS+5LIKRG+BdpC/d0yVmeJ9yXWWHXIbD/L4wPJiWUFrl9XcUUoDsbnVSXG03jmaFQnhgZ7CjCGU5rfvtMw7Q5Pzk= ARC-Message-Signature:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1759243595; c=relaxed/simple; bh=O3iw2GxXiVKzNYOYE/ZVyGls0+ofp0SaOBPPWCbl0uk=; h=Date:From:To:Cc:Subject:Message-ID:References:MIME-Version: Content-Type:Content-Disposition:In-Reply-To; b=OqegOeE2L7BEJNxMRhw8yaBc/0r8TQi5Z93RNThJMkt0ydOD0nDU3bugS8kSVYz0TDfqaM+2snl0D9dyz1XW0d98q0BReiUg3LnIyzWmW7y9TSEBLnbQd+svEirYa47T4EXXUISil28ItMQB6e4/qQ6WGdJ4BwJhutrUxos7PqA= ARC-Authentication-Results:i=1; smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com; spf=pass smtp.mailfrom=gmail.com; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b=jGKwN4Wq; arc=none smtp.client-ip=209.85.215.182 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=gmail.com Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b="jGKwN4Wq" Received: by mail-pg1-f182.google.com with SMTP id 41be03b00d2f7-b4fb8d3a2dbso4769831a12.3 for ; Tue, 30 Sep 2025 07:46:33 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1759243593; x=1759848393; darn=vger.kernel.org; h=in-reply-to:content-transfer-encoding:content-disposition :mime-version:references:message-id:subject:cc:to:from:date:from:to :cc:subject:date:message-id:reply-to; bh=gtl9s1x2Ex8u74sVxDhnBYLads9LLhbmtzGZjSOpUpQ=; b=jGKwN4Wqr04Uw3I/UPpwk2A6wvL/X4rgbF4N+0eT9v8tTV2rXSRLKKyvAr2Opx+Tmf Go+jxVBArXWirMiKTsK/THViLlbZrSPd9mgGT+IR2M1pNqz9pdSobv3jVB265vlRnlcD /bYYTtV7rEIDn0Tu8o5m7gAOarMTs94ggrQhiQmDCOScO9U5nuzwCibbwAWhM/9lWyvV vgwzIt2/sP4S8T9JVsrne3J0KC6bGCOW2G7/hQ0ZhIoCFy0q4d1DQdEzrUQxT1a2WJDU 36o39lVvpCvfkPNhEydtYt17ePNplFALyQpOe6lbDtBVIwviikaT2PRlaR769tmaMUap Uq4w== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1759243593; x=1759848393; h=in-reply-to:content-transfer-encoding:content-disposition :mime-version:references:message-id:subject:cc:to:from:date :x-gm-message-state:from:to:cc:subject:date:message-id:reply-to; bh=gtl9s1x2Ex8u74sVxDhnBYLads9LLhbmtzGZjSOpUpQ=; b=EvvovFxhc+XZvbWRvuQu53f0oi3ceMATnwQ17/EqhtmDmN7MzMiMJE67RjCmw1Xbhp NpH1MoXNeXzWaavo4snHGjPoL4Aj8h9fU4xYqtKaeUM+c0AO1MRQfskK0AX69PWckst9 5yf54pdHiyd2YtnMefH49+AunLiasqk2qNsGIx7mJ0UfjNbxMyidUE068Us5Z011ae3W LEM/u9vVMD8Wrn+ppCJDYcil33PNp544wZzBP5txaT7F+2CDbf77o9KD52hpZY97rG8s fm3vt3loN0ktfzgbtk7O/oZVqxY1Y5xosUflcT3rLqZ9A3HcZvQDjjZ4/9lfXD5tZsPp hc9A== X-Forwarded-Encrypted: i=1; AJvYcCWK1FGNo6PJWCr+6+vo5ZQ7c8Uy0JC0pnkO1ATLwOKybcTWoGMnh5WIAvAbDT4gTNlE3RL3vTp9564=@vger.kernel.org X-Gm-Message-State: AOJu0YzXNG6ldTRlWFyHN3drvNOVedGZQxaZiySGM7zyqt+rzIVjKMjf I4USZba8peC0ZL/xTJLmnEJK79UV5dtQadO7nvfG8tR5/NmWVDy7SoZW X-Gm-Gg: ASbGncue9DipijQN2C8Bt1sL8V8RP01hFl5ef/ySN4peWqPdvJKPuiiaFVdMrM24ukU QPJCE4Z2MPJ3iQKWa4ArA8BIBt8A/YutzqDw+FItHUmWOxhw0BULCqd5sl9yY/vOsWIExUzqEut Bu4Ua1BLkBd2FXBNwQqFu74Hdi39TVwQhxzRM+iZP2+A92p6IipdyEgqCqb6OGDXTMOIlnGM8QR T7LedLQ/fG7N54Cpm1FQBJZdkssIY9c4baEdbN8XSio45n/kaKEbEK80ahuNE8CgB0YpIUu3lKW T5zja9Z0IveQUEm1YmEePmcEoMC1/RGzW3Z486hxc1e3ToVHdl7u/nsmHkrgDOIjiHhdoAV4Tw7 gcRM8VM6SXk0RnFR7ZL2A/FQYIGHpctXiC6grnhNDCYHsBnwxFkV6cig= X-Google-Smtp-Source: AGHT+IE4hgKlPjRv6CQsulSHO7uaJxWorIuNklCjzaMiGW9OXkndROA3boKX4qKvwUjuv370Yq7hzQ== X-Received: by 2002:a17:90b:1647:b0:330:7a32:3290 with SMTP id 98e67ed59e1d1-3342a3471ccmr24460323a91.37.1759243592943; Tue, 30 Sep 2025 07:46:32 -0700 (PDT) Received: from localhost ([2804:30c:b65:6a00:ceaa:2ed0:e81e:8f51]) by smtp.gmail.com with UTF8SMTPSA id 98e67ed59e1d1-3341bd90367sm20311444a91.5.2025.09.30.07.46.31 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Tue, 30 Sep 2025 07:46:31 -0700 (PDT) Date: Tue, 30 Sep 2025 11:47:24 -0300 From: Marcelo Schmitt To: David Lechner Cc: Rob Herring , Jonathan Cameron , Marcelo Schmitt , linux-iio@vger.kernel.org, devicetree@vger.kernel.org, linux-doc@vger.kernel.org, linux-spi@vger.kernel.org, linux-kernel@vger.kernel.org, michael.hennerich@analog.com, nuno.sa@analog.com, eblanc@baylibre.com, andy@kernel.org, krzk+dt@kernel.org, conor+dt@kernel.org, corbet@lwn.net, Linus Walleij , Bartosz Golaszewski , linux-gpio@vger.kernel.org Subject: Re: [PATCH v3 7/8] dt-bindings: iio: adc: adi,ad4030: Add ADAQ4216 and ADAQ4224 Message-ID: References: <5dc08b622dac1db561f26034c93910ccff75e965.1758916484.git.marcelo.schmitt@analog.com> <20250928111955.175680cb@jic23-huawei> <20250929143132.GA4099970-robh@kernel.org> Precedence: bulk X-Mailing-List: linux-doc@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: On 09/29, David Lechner wrote: > On Mon, Sep 29, 2025 at 4:31 PM Rob Herring wrote: > > > > On Sun, Sep 28, 2025 at 11:19:55AM +0100, Jonathan Cameron wrote: > > > On Fri, 26 Sep 2025 17:40:47 -0300 > > > Marcelo Schmitt wrote: > > > > > > > ADAQ4216 and ADAQ4224 are similar to AD4030 except that ADAQ devices have a > > > > PGA (programmable gain amplifier) that scales the input signal prior to it > > > > reaching the ADC inputs. The PGA is controlled through a couple of pins (A0 > > > > and A1) that set one of four possible signal gain configurations. > > > > > > > > Signed-off-by: Marcelo Schmitt > > > > --- > > > > Change log v2 -> v3 > > > > - PGA gain now described in decibels. > > > > > > > > The PGA gain is not going to fit well as a channel property because it may > > > > affect more than one channel as in AD7191. > > > > https://www.analog.com/media/en/technical-documentation/data-sheets/AD7191.pdf > > > > > > > > I consulted a very trustworthy source [1, 2] and learned that describing signal > > > > gains in decibels is a common practice. I now think it would be ideal to describe > > > > these PGA and PGA-like gains with properties in decibel units and this patch > > > > is an attempt of doing so. The only problem with this approach is that we end up > > > > with negative values when the gain is lower than 1 (the signal is attenuated) > > > > and device tree specification doesn't support signed integer types. As the > > > > docs being proposed fail dt_binding_check, I guess I have to nack the patch myself. > > > > Any chance of dt specification eventually support signed integers? > > > > Any suggestions appreciated. > > > > > > > > [1] https://en.wikipedia.org/wiki/Decibel > > > > [2] https://en.wikipedia.org/wiki/Gain_(electronics) > > > > > > I still wonder if the better way to describe this is to ignore that it > > > has anything to do with PGA as such and instead describe the pin strapping. > > > > > > DT folk, is there an existing way to do that? My grep skills are failing to > > > spot one. > > > > > > We've papered over this for a long time in various IIO drivers by controlling > > > directly what the pin strap controls with weird and wonderful device specific > > > bindings. I wonder if we can't have a gpio driver + binding that rejects all > > > config and just lets us check the current state of an output pin. Kind of a > > > fixed mode regulator equivalent for gpios. > > > > If these are connected to GPIOs, isn't it possible that someone will > > want to change their value? > > > > Other than some generic 'pinstrap-gpios' property, I don't see what we'd > > do here? I don't feel like pin strapping GPIOs is something that we see > > all that often. > > > > Rob > > I think the idea is that it is not actually a GPIO, just a hard-wired > connection. We would want to have a "fixed-gpios" to describe these > hard-wired connections as GPIOs so that we don't have to write complex > binding for chip config GPIOs. I've seen configuration pins like on at > least half a dozed of the ADCs I've been working on/reviewing over the > last two years (since I got involved in IIO again). Yes, the alternative to having GPIOs would be to have pins hard-wired set to a specific logic level. And the connection don't need to be to GPIOs. The gain pins on the ADC chip can be connected to anything that keeps a constant logic level while we capture data from the ADC. > > For example, there might be 4 mode pins, so we would like to just have > a mode-gpios property. So this could be all 4 connected to GPIOs, all > 4 hard-wired, or a mix. Having some pins hard-wired and some connected to GPIOs is possible, but that would make things even more complex as each pin on the ADC chip sets a different portion of the gain. IMHO, mixed GPIO/hard-wired configuration starts looking like over engineering and I haven't been requested for so much configuration flexibility. Having either all hard-wired or all connected to GPIOs should be ok. I'm not familiar with pinctrl dt-bindings, but I was wondering if we could get to something similar with pinctrl. Based on some pinctrl bindings, I think fixed-level GPIOs could look like the following (for the 4 pin-mode example). pinctrl0: pincontroller@0 { compatible = "vendor,model-pinctrl"; all-low-state: some-gpio-pins { pins = "gpio0", "gpio1", "gpio2", "gpio3"; function = "gpio"; output-low; }; all-high-state: some-gpio-pins { pins = "gpio0", "gpio1", "gpio2", "gpio3"; function = "gpio"; output-high; }; most-high-state: some-gpio-pins { pins1 { pins = "gpio0", "gpio1", "gpio2"; function = "gpio"; output-high; }; pins2 { pins = "gpio3"; function = "gpio"; output-low; }; }; }; spi { adc@0 { compatible = "vendor,adc"; /* All gpios */ pga-gpios = <&gpio0 0 GPIO_ACTIVE_HIGH>, <&gpio0 1 GPIO_ACTIVE_HIGH>, <&gpio0 2 GPIO_ACTIVE_HIGH>, <&gpio0 3 GPIO_ACTIVE_HIGH>; /* or all hard-wired */ pinctrl-names = "minimum-gain", "moderate-gain", "maximum-gain"; pinctrl-0 = <&all-low-state>, <&most-high-state>, <&all-high-state>; }; }; Though, the above is still relying on GPIOs which is not a requirement from ADC peripheral perspective. Also, if GPIOs are available, one can just provide them through pga-gpios and have full control over the signal gain with the IIO driver. It boils down to just telling software what are the logical levels at two pins on the ADC chip when GPIOs are not provided. Thanks, Marcelo > > (The actual bindings would need more thought, but this should give the > general idea) > > fixed_gpio: hard-wires { > compatible = "fixed-gpios"; > gpio-controller; > #gpio-cells = <1>; > }; > > gpio0: gpio-controller@4000000 { > compatible = "vendor,soc-gpios"; > gpio-controller; > #gpio-cells = <2>; > }; > > spi { > adc@0 { > compatible = "vendor,adc"; > /* All gpios */ > mode-gpios = <&gpio0 0 GPIO_ACTIVE_HIGH>, > <&gpio0 1 GPIO_ACTIVE_HIGH>, > <&gpio0 2 GPIO_ACTIVE_HIGH>, > <&gpio0 3 GPIO_ACTIVE_HIGH>; > /* or all hard-wired */ > mode-gpios = <&fixed_gpio 0 GPIO_FIXED_HIGH>, > <&fixed_gpio GPIO_FIXED_HIGH>, > <&fixed_gpio GPIO_FIXED_LOW>, > <&fixed_gpio GPIO_FIXED_LOW>; > /* or mixed */ > mode-gpios = <&gpio0 0 GPIO_ACTIVE_HIGH>, > <&gpio0 1 GPIO_ACTIVE_HIGH>, > <&fixed_gpio GPIO_FIXED_LOW>, > <&fixed_gpio GPIO_FIXED_LOW>; > }; > };