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