Re: [PATCH 6/6] Documentation: iio: Add AD7768 Documentation

[Jonathan Cameron <jic23@kernel.org>]

On Thu, 9 Jul 2026 10:50:17 +0200
Janani Sunil <janani.sunil@analog.com> wrote:

> Add driver documentation for AD7768
> 
> Signed-off-by: Janani Sunil <janani.sunil@analog.com>
> ---
>  Documentation/iio/ad7768.rst | 207 +++++++++++++++++++++++++++++++++++++++++++
>  Documentation/iio/index.rst  |   1 +
>  MAINTAINERS                  |   1 +
>  3 files changed, 209 insertions(+)
> 
> diff --git a/Documentation/iio/ad7768.rst b/Documentation/iio/ad7768.rst
> new file mode 100644
> index 000000000000..438e33d4f375
> --- /dev/null
> +++ b/Documentation/iio/ad7768.rst
> @@ -0,0 +1,207 @@
> +.. SPDX-License-Identifier: GPL-2.0-only
> +
> +=============
> +AD7768 driver
> +=============
> +
> +ADC driver for Analog Devices Inc. AD7768 and AD7768-4 devices. The module name
> +is ``ad7768``.
> +
> +Supported devices
> +=================
> +
> +The following chips are supported by this driver:
> +
> +* `AD7768 <https://www.analog.com/en/products/ad7768.html>`_ - 8-channel, 24-bit simultaneous sampling ADC
> +* `AD7768-4 <https://www.analog.com/en/products/ad7768-4.html>`_ - 4-channel, 24-bit simultaneous sampling ADC

Too long. Wrap those.  In general keep to 80 chars for docs
unless you are breaking up some thing greppable like a file name.


> +
> +Supported features
> +==================
> +
> +Power modes
> +-----------
> +
> +The AD7768 family supports three configurable power and performance modes:
> +
> +* **Low power mode** - Optimized for lowest power consumption
> +* **Median mode** - Balanced power and performance
> +* **Fast mode** - Highest performance with maximum sampling rates
> +
> +The power mode affects the available sampling frequencies and power consumption.
> +Set via the ``adi,power-mode`` device tree property.

Control it from the sampling frequency probably as David suggested.

> +
> +Per-channel calibration
> +-----------------------
> +
> ++---------------------------------------+--------------------------------------------------------------+
> +| Attribute                             | Description                                                  |
> ++=======================================+==============================================================+
> +| ``in_voltage<N>_calibbias``           | Channel offset calibration value                             |
> ++---------------------------------------+--------------------------------------------------------------+
> +| ``in_voltage<N>_calibscale``          | Channel gain calibration value                               |
> ++---------------------------------------+--------------------------------------------------------------+
> +| ``in_voltage<N>_phase``               | Channel phase calibration value.                             |
Be consistent on .

Also does this mean the phase offset is a tweak, or do we know the scaling?

> ++---------------------------------------+--------------------------------------------------------------+
> +