1.. SPDX-License-Identifier: GPL-2.0-only
2
3==============
4AD3552R driver
5==============
6
7Device driver for Analog Devices Inc. AD35XXR series of DACs. The module name
8is ``ad3552r``.
9With the same module name, two different driver variants are available, the
10``generic spi`` variant, to be used with any classic SPI controllers, and the
11``hs`` (high speed) variant, for an ADI ``axi-dac`` (IP core) based controller
12that allows to reach the maximum sample rate supported from the DACs, using the
13DMA transfer and all the SPI lines available (D/QDSPI)..
14The high speed driver variant is intended to be used with the ``adi-axi-dac``
15backend support enabled, that is enabled by default when the driver is selected.
16
17Supported devices
18=================
19
20* `AD3541R <https://www.analog.com/en/products/ad3541r.html>`_
21* `AD3542R <https://www.analog.com/en/products/ad3542r.html>`_
22* `AD3551R <https://www.analog.com/en/products/ad3551r.html>`_
23* `AD3552R <https://www.analog.com/en/products/ad3552r.html>`_
24
25Wiring connections
26==================
27
28Generic SPI
29-----------
30Use the classic SPI S_CLK/CS/SDO/SDI connection.
31
32High speed (using axi-dac backend)
33----------------------------------
34
35::
36
37    .-----------------.                .-------.
38    |                 |--- D/QSPI -----|       |
39    |   DAC IP CORE   |--- SPI S_CLK --|  DAC  |
40    |                 |--- SPI CS -----|       |
41    |                 |--- LDAC -------|       |
42    |                 |--- RESET ------|       |
43    |_________________|                |_______|
44
45
46High speed features
47===================
48
49Device attributes
50-----------------
51
52The following table shows the ad35xxr related device debug files, found in the
53specific debugfs path ``/sys/kernel/debug/iio/iio:deviceX``.
54
55+-----------------------+------------------------------------------------------+
56| Debugfs device files  | Description                                          |
57+-----------------------+------------------------------------------------------+
58| data_source           | The used data source, as                             |
59|                       | ``normal``, ``ramp-16bit``, etc.                     |
60+-----------------------+------------------------------------------------------+
61| data_source_available | The available data sources.                          |
62+-----------------------+------------------------------------------------------+
63
64Usage examples
65--------------
66
67. code-block:: bash
68	root:/sys/bus/iio/devices/iio:device0# cat data_source
69	normal
70	root:/sys/bus/iio/devices/iio:device0# echo -n ramp-16bit > data_source
71	root:/sys/bus/iio/devices/iio:device0# cat data_source
72	ramp-16bit
73