ad3552r.rst 2.6 KB

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