AD5620

Arduino library for the AD5620 / AD5640 Digital Analog Convertor (12/14 bit).

Description

Experimental

The AD5620 is a 12 bit DAC, which is to be controlled by SPI. This library supports both hardware as software SPI.

The value of the DAC can be changed by setValue() or by setPercentage(). If the values are out of range these function will return false. The value set is kept by the library and can be fetched by getValue() and getPercentage().

The library also implements support for the AD5640, a 14 bit DAC.

Warning The library is not tested with hardware so use with care.

Feedback, issues, improvements are welcome. Please file an issue on GitHub.

Compatibles

Overview devices, nr of bits, setValue range and indicative LSB

Related

• https://github.com/RobTillaart/AD5620 (single channel, 12 bit)
• https://github.com/RobTillaart/AD5680 (single channel, 18 bit)
• https://github.com/RobTillaart/AD56x8 (multi channel)
• https://github.com/RobTillaart/AD568X (single channel lower resolution)
• https://github.com/RobTillaart/MCP_DAC (SPI interface)

Interface

#include "AD5620.h"

Base class

The AD5640 has identical constructors.

• AD5620(uint8_t slaveSelect, SPIClassRP2040 * mySPI = &SPI) constructor hardware SPI (RP2040 specific). Sets internal value to zero.
• AD5620(uint8_t slaveSelect, SPIClass * mySPI = &SPI) constructor hardware SPI. Sets internal value to zero.
• AD5620(uint8_t slaveSelect, uint8_t spiData, uint8_t spiClock) constructor software SPI. Sets the software SPI pins. Sets internal value to zero.
• void begin() initializes the SPI and sets internal state.
• uint8_t getType() returns nr of bits, 12 for AD5620, 14 for AD5640.

Set DAC

• bool setValue(uint16_t value) set value to the output immediately, effectively a prepare + update in one call. Returns false if value out of range.
• uint16_t getValue() returns the set value from cache. At power up the device will be reset to 0 (== 0 volt).
• uint16_t getMaxValue() returns 4095 for AD5620, returns 16383 for AD5640.
• bool setPercentage(float percentage) sets the output as a percentage 0..100%. If percentage is out of range, it is not set and the function returns false.
• float getPercentage() returns percentage, wrapper around getValue(). Might return a slightly different value than setPercentage() due to rounding math. At power up the function will return 0 as default value.

Power down

See datasheet P19 for details.

• bool setPowerDownMode(uint8_t mode) returns false if mode is out of range.
• uint8_t getPowerDownMode() returns set power down mode, default 0.

SPI

Adjust the performance of the SPI port.

• void setSPIspeed(uint32_t speed) sets SPI clock in Hz, please read datasheet of the ADC first to get optimal speed.
• uint32_t getSPIspeed() gets current speed in Hz.
• bool usesHWSPI() returns true if HW SPI is used.

Datasheet maximum frequency. Overclocking is not tested.

Performance

Measurements with AD5620_demo.ino - performance of setValue() is the most important. The numbers are rounded and indicative, other boards might produce different numbers.

1. ESP32 HW is equal performant for HSPI and VSPI. Unknown why HW SPI is 20% slower than SW SPI (transaction overhead?)

70000 calls per second means that a 1 KHz wave can be constructed with 70 values per period (max).

Please share your performance data, open an issue to report.

Future

Must

• improve documentation
• get hardware
• test the library

Should

• add examples
• create a similar library for AD5660

Could

Wont

Support

If you appreciate my libraries, you can support the development and maintenance. Improve the quality of the libraries by providing issues and Pull Requests, or donate through PayPal or GitHub sponsors.

Thank you,