mirror of
https://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
synced 2025-01-01 10:43:43 +00:00
78134832a1
Add documentation for the AD7625/AD7626/AD7960/AD7961 ADCs. Signed-off-by: Trevor Gamblin <tgamblin@baylibre.com> Link: https://patch.msgid.link/20240909-ad7625_r1-v5-3-60a397768b25@baylibre.com Signed-off-by: Jonathan Cameron <Jonathan.Cameron@huawei.com>
92 lines
3.1 KiB
ReStructuredText
92 lines
3.1 KiB
ReStructuredText
.. SPDX-License-Identifier: GPL-2.0-only
|
|
|
|
====================
|
|
AD7625 driver
|
|
====================
|
|
|
|
ADC driver for Analog Devices Inc. AD7625, AD7626, AD7960, and AD7961
|
|
devices. The module name is ``ad7625``.
|
|
|
|
Supported devices
|
|
=================
|
|
|
|
The following chips are supported by this driver:
|
|
|
|
* `AD7625 <https://www.analog.com/AD7625>`_
|
|
* `AD7626 <https://www.analog.com/AD7626>`_
|
|
* `AD7960 <https://www.analog.com/AD7960>`_
|
|
* `AD7961 <https://www.analog.com/AD7961>`_
|
|
|
|
The driver requires use of the Pulsar LVDS HDL project:
|
|
|
|
* `Pulsar LVDS HDL <http://analogdevicesinc.github.io/hdl/projects/pulsar_lvds/index.html>`_
|
|
|
|
To trigger conversions and enable subsequent data transfer, the devices
|
|
require coupled PWM signals with a phase offset.
|
|
|
|
Supported features
|
|
==================
|
|
|
|
Conversion control modes
|
|
------------------------
|
|
|
|
The driver currently supports one of two possible LVDS conversion control methods.
|
|
|
|
Echoed-Clock interface mode
|
|
^^^^^^^^^^^^^^^^^^^^^^^^^^^
|
|
|
|
.. code-block::
|
|
|
|
+----------------+
|
|
+xxxxxxxxxxxxxxxxxxxxxxxxxx| CNV |
|
|
X | |
|
|
v | HOST |
|
|
+----------------------------+ | |
|
|
| CNV+/CNV- DCO+/DCO- |xxxxxxx>| CLK_IN |
|
|
| | | |
|
|
| | | |
|
|
| AD7625 D+/D- |xxxxxxx>| DATA_IN |
|
|
| | | |
|
|
| | | |
|
|
| CLK+/CLK- |<xxxxxxx| CLK & CLK_GATE |
|
|
+----------------------------+ | |
|
|
+----------------+
|
|
|
|
Reference voltage
|
|
-----------------
|
|
|
|
Three possible reference voltage sources are supported:
|
|
|
|
- Internal reference (only available on AD7625 and AD7626)
|
|
- External reference and internal buffer
|
|
- External reference
|
|
|
|
The source is determined by the device tree. If ``ref-supply`` is present, then
|
|
the external reference is used. If ``refin-supply`` is present, then the internal
|
|
buffer is used. If neither is present, then the internal reference is used.
|
|
|
|
Unimplemented features
|
|
----------------------
|
|
|
|
- Self-clocked mode
|
|
|
|
|
|
Device attributes
|
|
=================
|
|
|
|
The AD762x is a fully-differential ADC and has the following attributes:
|
|
|
|
+---------------------------------------+--------------------------------------------------------------+
|
|
| Attribute | Description |
|
|
+=======================================+==============================================================+
|
|
| ``scale`` | Scale factor to convert raw value from buffered reads to mV. |
|
|
+---------------------------------------+--------------------------------------------------------------+
|
|
|
|
|
|
Device buffers
|
|
==============
|
|
|
|
This driver supports IIO triggered buffers.
|
|
|
|
See :doc:`iio_devbuf` for more information.
|