From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from mail-oo1-f50.google.com (mail-oo1-f50.google.com [209.85.161.50]) (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 88259176FCE for ; Sun, 27 Oct 2024 19:41:26 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.161.50 ARC-Seal:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1730058090; cv=none; b=OnbAinm6cmn4bK3AMmRJVnDVDaB4xdPv9vo0vCzeKQ8peiHqITZDWOZq7dW1Tpdj2+QaoNWcngAafmi9wgyip0/dVpqTTE+1DB3J0z8iIsXOr2iBhVVK+NyM1883Qr5L8uPdtZvz3wXLslRcwDTus0aTcPC2LI3x7tB6Lo7ULzE= ARC-Message-Signature:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1730058090; c=relaxed/simple; bh=v+vz7OIIFECPzMyfYUR86ehGfecvzTQY7cT6KQHCzi4=; h=Message-ID:Date:MIME-Version:Subject:To:Cc:References:From: In-Reply-To:Content-Type; b=pXxCu+Lw4TyPBgUiVotv9qGiVzazHbkPviiBMpN5rKTa+tg0a5ixRpz1Q22NAiAKGm1oD8iTTFfwtB42MoogdYkC4goMN/0p+Oq9sljLfNWpVioEBUQLS4q0nyPZG1t2aiFV/Civ2AWk81LUptQ5iR7rWT5JXFxpt1K/5hBgGCk= ARC-Authentication-Results:i=1; smtp.subspace.kernel.org; dmarc=none (p=none dis=none) header.from=baylibre.com; spf=pass smtp.mailfrom=baylibre.com; dkim=pass (2048-bit key) header.d=baylibre-com.20230601.gappssmtp.com header.i=@baylibre-com.20230601.gappssmtp.com header.b=eoW56xCr; arc=none smtp.client-ip=209.85.161.50 Authentication-Results: smtp.subspace.kernel.org; dmarc=none (p=none dis=none) header.from=baylibre.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=baylibre.com Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=baylibre-com.20230601.gappssmtp.com header.i=@baylibre-com.20230601.gappssmtp.com header.b="eoW56xCr" Received: by mail-oo1-f50.google.com with SMTP id 006d021491bc7-5ebc04d495aso2084716eaf.2 for ; Sun, 27 Oct 2024 12:41:26 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=baylibre-com.20230601.gappssmtp.com; s=20230601; t=1730058085; x=1730662885; darn=vger.kernel.org; h=content-transfer-encoding:in-reply-to:from:content-language :references:cc:to:subject:user-agent:mime-version:date:message-id :from:to:cc:subject:date:message-id:reply-to; bh=DS49mL6mh3qfyGHT1zyM0qeylEka6PaSbeWVh4VtAn4=; b=eoW56xCrKC0eCdUB+TOfPm+jOxMWzEvMD7IvLIrwfd6VgdYerfpY4lrubbzfk+XVH1 NSjTetAcsP3kiHGH90h3tAvtyDzdVgRHiriQJzKiCBwFQJRvywvvSJvA5qDcCXj965Zd eEs9VVLLAKvb9GqAkL8wxvIhcTJAlIUvEwWWp70RZJudPDZJ41rFtj5hHdLXi+cbLSKX k+8tVWDCVtntFv/bGzSvL/4r9WFWsgDaFj1c0aBPMrmzz2nxKNdBHIvYAMeg8ZJ95vAV 5J0OGAQZTjsyFg15m/dKpCp0yTkuFskuEyCrkpwpW3sSObXhm+AHEnAsndo9gbrkwbLz gM6w== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1730058085; x=1730662885; h=content-transfer-encoding:in-reply-to:from:content-language :references:cc:to:subject:user-agent:mime-version:date:message-id :x-gm-message-state:from:to:cc:subject:date:message-id:reply-to; bh=DS49mL6mh3qfyGHT1zyM0qeylEka6PaSbeWVh4VtAn4=; b=dh2wfs6VmpKa+HZUAyVek/vXrd/4upLBIjgim0rVhhs2FfNW8KJy125uUogUnIvep6 b6ToAymRetP33BW610VtWjenvYv95B2tigBJyhV5kEmba1e3Wd55kb7IT2Y6Ajqp28dZ qWo4Ol01HmGTDLMiie2NtYd26obkmjV9ty1JB+Wag8+8Iq51zZGn1AJbttcaoS8BC0qa S/C0ec55fTM6s2gkBMvJWDZOH5wh2EWE8B1MS+guSIHTCmlqOtNf0vT2UFp5vxobkFfh GTXb+nKlObuVyY+ZdCBS0U803UtVEB8nl+mnHsv5Aj6XCQsVK8O4wGvwgFzBbH6aElKo kkiQ== X-Forwarded-Encrypted: i=1; AJvYcCXq+82EtAfiuqsxivD9KPitbkpVFuiQQdMeOUoT2B6uKKoErNMpTfb4YgnigQGQpCCS0wLXd71aCmU=@vger.kernel.org X-Gm-Message-State: AOJu0YzvXYX26KlwBFWMLvKfbNMzfsewtHZcNWRYoTgm/Ytrtx3mGpQ3 HO03DVd1+MoNM5DHIrVc3IaMfRaB6S9SZNh/J+sBKn0xCTkBddA/E6PvCidXUq0= X-Google-Smtp-Source: AGHT+IEN4f17W5Pxyu0a3Sg3sLpksasKzlX7/jnfpEUhNEtj1KFkavvwEUUQrUhY89AcYkgtdZMp9A== X-Received: by 2002:a05:6870:170f:b0:288:18a0:e169 with SMTP id 586e51a60fabf-29051b4d49dmr4184676fac.19.1730058085605; Sun, 27 Oct 2024 12:41:25 -0700 (PDT) Received: from [192.168.0.142] (ip98-183-112-25.ok.ok.cox.net. [98.183.112.25]) by smtp.gmail.com with ESMTPSA id 586e51a60fabf-29035da4b9bsm1589189fac.15.2024.10.27.12.41.22 (version=TLS1_3 cipher=TLS_AES_128_GCM_SHA256 bits=128/128); Sun, 27 Oct 2024 12:41:24 -0700 (PDT) Message-ID: <776b38c3-1bca-4416-a855-d45b759ec2c2@baylibre.com> Date: Sun, 27 Oct 2024 14:41:22 -0500 Precedence: bulk X-Mailing-List: linux-doc@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 User-Agent: Mozilla Thunderbird Subject: Re: [PATCH v3 4/4] docs: iio: ad7380: add adaq4370-4 and adaq4380-4 To: Julien Stephan , Lars-Peter Clausen , Michael Hennerich , =?UTF-8?Q?Nuno_S=C3=A1?= , Jonathan Cameron , Rob Herring , Krzysztof Kozlowski , Conor Dooley , Jonathan Corbet Cc: linux-iio@vger.kernel.org, devicetree@vger.kernel.org, linux-kernel@vger.kernel.org, linux-doc@vger.kernel.org References: <20241024-ad7380-add-adaq4380-4-support-v3-0-6a29bd0f79da@baylibre.com> <20241024-ad7380-add-adaq4380-4-support-v3-4-6a29bd0f79da@baylibre.com> Content-Language: en-US From: David Lechner In-Reply-To: <20241024-ad7380-add-adaq4380-4-support-v3-4-6a29bd0f79da@baylibre.com> Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 7bit On 10/24/24 3:16 AM, Julien Stephan wrote: > Adding documentation for adaq4370-4 and adaq4380-4 supported devices. In > particular, document the reference voltage mechanism and the gain > parameter that are specific to adaq devices. > > Signed-off-by: Julien Stephan > --- > Documentation/iio/ad7380.rst | 18 ++++++++++++++++++ > 1 file changed, 18 insertions(+) > > diff --git a/Documentation/iio/ad7380.rst b/Documentation/iio/ad7380.rst > index 6f70b49b9ef27c1ac32acaefecd1146e5c8bd6cc..ae408ff2fa9c97427a9fef57020fb54203d2d33e 100644 > --- a/Documentation/iio/ad7380.rst > +++ b/Documentation/iio/ad7380.rst > @@ -27,6 +27,8 @@ The following chips are supported by this driver: > * `AD7386-4 `_ > * `AD7387-4 `_ > * `AD7388-4 `_ > +* `ADAQ4370-4 `_ > +* `ADAQ4380-4 `_ > > > Supported features > @@ -47,6 +49,12 @@ ad7380-4 > ad7380-4 supports only an external reference voltage (2.5V to 3.3V). It must be > declared in the device tree as ``refin-supply``. > > +adaq devices > +~~~~~~~~~~~~ > + > +adaq4370-4 and adaq4380-4 don't have an external reference, but use a 3V > +internal reference derived from one of its supplies (``refin-supply``) > + > All other devices from ad738x family > ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ > > @@ -121,6 +129,16 @@ Example for AD7386/7/8 (2 channels parts): > > When enabling sequencer mode, the effective sampling rate is divided by two. > > + > +Gain (adaq devices only) > +~~~~~~~~~~~~~~~~~~~~~~~~ > + > +adaq devices have a pin selectable gain in front of each adc. The appropriate If we are doing a v4 anyway, it would be nice to use caps for acronyms like ADAQ and ADC here and elsewhere. > +gain is selectable from device tree using the ``adi,gain-milli`` property. > +Refer to the typical connection diagrams section of the datasheet for pin > +wiring. > + > + > Unimplemented features > ---------------------- > >