GY-63_MS5611/libraries/AD568X/README.md

AD568X

Arduino library for the AD568X series digital analog convertor.

Description

Experimental

The AD568X library implements a base class and four derived classes. The derived classed only differ on the resolution set.

Type	bits	supported	Notes
AD5681R	12	Y
AD5682R	14	Y
AD5683	16	Y
AD5683R	16	Y

The AD568X uses SPI to communicate to the device and supports both hardware SPI as software SPI (bit bang).

The library is not tested with hardware yet so it is labelled as experimental and should be used with care.

Although the library has a function to set the Daisy Chain ENable bit, the library does not support this mode. It is added for completeness and possibly to be used in the future. So for now the library only supports stand alone mode.

Note: the AD5691, AD5692, AD5693 are equivalent devices with I2C (no library yet).

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

Related

• https://github.com/RobTillaart/AD56x8 (multi channel DAC's)
• https://github.com/RobTillaart/AD5680 (18 bit version)
• https://github.com/RobTillaart/MCP_DAC (SPI interface)

Interface

#include "AD568X.h"

Base class

Should not be used to instantiate a device as the derived types have set the correct number of bits.

• AD568X(uint8_t slaveSelect) constructor base class, sets HW SPI. Sets internal values to zero.
• AD568X(uint8_t spiData, uint8_t spiClock, uint8_t slaveSelect) constructor, sets SW SPI. Sets internal values to zero.
• begin() initializes the SPI and sets internal state.

Derived classes (preferred use)

The parameters for the specific constructors are identical to the base class. One should use these, as these set the bit resolution!

• AD5681R(..) constructor, 12 bit.
• AD5682R(..) constructor, 14 bit.
• AD5683R(..) constructor, 16 bit.
• AD5683(..) constructor, 16 bit.

LDAC

The use of the LDAC interface is optional. It allows a prepared value to be set in in the DAC register. See prepareValue(). If you control multiple devices the hardware LDAC allows you to set a new value on all devices simultaneously.

• void setLDACPin(uint8_t ldac) set the LDAC pin.
• void triggerLDAC() give a pulse over the LDAC line.

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 set OR prepared value. At power up the DAC's will be reset to 0 Volt.
• bool setPercentage(float percentage) idem.
• float getPercentage() idem.
• bool prepareValue(uint16_t value) prepares the value. Returns false if value out of range.
• bool updateValue() writes the prepared value to ADC. Returns false if value out of range. This function is also known as the software LDAC.

Control Register

Check datasheet for details.

• bool setControlRegister(uint16_t value) set register in one call.
• uint16_t getControlRegister() return the set / current value.
• bool reset() reset the AD568X device. Also resets all flags in control register.
• bool setPowerDownMode(uint8_t mode = AD568X_PWR_NORMAL) set one of three power down modes, see table below, or to normal mode. Default is AD568X_PWR_NORMAL.
• bool disableReference(bool b) false = reference enabled. true = reference disabled (uses less power). Default is enabled.
• bool enableGain(bool enable = false) false = 0..Vref true = 0..2x Vref. Default is false.
• bool enableDaisyChain(bool enable = false) enables daisy chain mode. WARNING Daisy Chain is not supported in current library. Default is false.

Control register bits: (see datasheet)

bits	meaning	Notes
15	RESET
14	PowerDown 1
13	PowerDown 2
12	REFerence selection
11	GAIN
10	DCEN, Daisy Chain	not supported in the library.

Power down modi: (see datasheet)

mode	define
0x00	AD568X_PWR_NORMAL
0x01	AD568X_PWR_1K
0x02	AD568X_PWR_100K
0x03	AD568X_PWR_TRI

SPI

• 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.

SPI ESP32 specific

("inherited" from MPC_DAC library)

• void selectHSPI() in case hardware SPI, the ESP32 has two options HSPI and VSPI.
• void selectVSPI() see above.
• bool usesHSPI() returns true if HSPI is used.
• bool usesVSPI() returns true if VSPI is used.

The selectVSPI() or the selectHSPI() needs to be called BEFORE the begin() function.

(experimental)

• void setGPIOpins(uint8_t clk, uint8_t miso, uint8_t mosi, uint8_t select) overrule GPIO pins of ESP32 for hardware SPI. Needs to be called AFTER the begin() function.

Note: earlier experiments shows that on a ESP32 SW-SPI is equally fast as HW-SPI and in fact a bit more stable. The SW pulses are a bit slower than the HW pulses and therefore more square. The HW-SPI has some overhead SW-SPI hasn't.

Future

Must

• improve documentation
• get hardware for testing
• test the library

Should

• write examples
  • performance
  • LDAC pin
  • multi device ( array)
  • multi device (LDAC sync)
• Clean up / improve code.
  • move conditional code to variable. (setValue etc).

Could

• write unit test

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,