GY-63_MS5611/libraries/AD56X8/AD56X8.h
2024-01-19 14:23:07 +01:00

163 lines
3.7 KiB
C++

#pragma once
//
// FILE: AD56X8.h
// AUTHOR: Rob Tillaart
// VERSION: 0.3.0
// DATE: 2022-07-28
// PURPOSE: Arduino library for AD56X8, SPI 8 channel Digital Analog Convertor.
#include "Arduino.h"
#include "SPI.h"
#define AD56X8_LIB_VERSION (F("0.3.0"))
#ifndef __SPI_CLASS__
#if defined(ARDUINO_ARCH_RP2040)
#define __SPI_CLASS__ SPIClassRP2040
#else
#define __SPI_CLASS__ SPIClass
#endif
#endif
#define AD56X8_PWR_NORMAL 0x00
#define AD56X8_PWR_1K 0x01
#define AD56X8_PWR_100K 0x02
#define AD56X8_PWR_TRI_STATE 0x03
// ZERO, HALF, FULL ?
#define AD56X8_CC_0000 0x00
#define AD56X8_CC_8000 0x01
#define AD56X8_CC_FFFF 0x02
#define AD56X8_CC_NOP 0x03 // do not use (read datasheet)
class AD56X8
{
public:
// HARDWARE SPI
AD56X8(uint8_t slaveSelect, __SPI_CLASS__ * mySPI = &SPI);
// SOFTWARE SPI
AD56X8(uint8_t slaveSelect, uint8_t spiData, uint8_t spiClock);
void begin();
uint8_t getType();
// optional hardware LDAC interface
void setLDACPin(uint8_t ldac);
bool triggerLDAC(); // return false if pin not set.
// SET DAC
// returns false if channel out of range
// sets output immediately = prepare + update.
bool setValue(uint8_t channel, uint16_t value);
uint16_t getValue(uint8_t channel);
bool setPercentage(uint8_t channel, float percentage);
float getPercentage(uint8_t channel);
// prep & update separately
bool prepareChannel(uint8_t channel, uint16_t value);
bool updateChannel(uint8_t channel);
void updateAllChannels();
// LDAC
void setLDACmask(uint8_t mask = 0x00);
uint8_t getLDACmask();
bool inLDACmask(uint8_t channel);
// POWER
// mode = 0..3
// returns false if mode out of range
bool setPowerMode(uint8_t powerDownMode, uint8_t mask = 0x00);
// MISC
// software reset
void reset();
// returns false if mode out of range
// CCmode = 0..2
bool setClearCode(uint8_t CCmode); // check datasheet.
// SPI
// speed in Hz
void setSPIspeed(uint32_t speed);
uint32_t getSPIspeed();
bool usesHWSPI();
protected:
uint8_t _type = 0; // # bits
uint8_t _dataOut = 255;
uint8_t _clock = 255;
uint8_t _select = 255;
uint8_t _ldac = 255;
uint16_t _value[8];
uint8_t _ldacMask = 0;
bool _hwSPI = false;
uint32_t _SPIspeed = 16000000;
void updateDevice(uint8_t cmd, uint8_t channel, uint16_t value);
void updateDevice(uint8_t a, uint8_t b, uint8_t c, uint8_t d);
void swSPI_transfer(uint8_t value);
__SPI_CLASS__ * _mySPI;
SPISettings _spi_settings;
};
/////////////////////////////////////////////////////////////////////////////
//
// DERIVED CLASSES
//
class AD5668_3 : public AD56X8
{
public:
// HARDWARE SPI
AD5668_3(uint8_t slaveSelect, __SPI_CLASS__ * mySPI = &SPI);
// SOFTWARE SPI
AD5668_3(uint8_t slaveSelect, uint8_t spiData, uint8_t spiClock);
void reset();
};
class AD5668 : public AD56X8
{
public:
// HARDWARE SPI
AD5668(uint8_t slaveSelect, __SPI_CLASS__ * mySPI = &SPI);
// SOFTWARE SPI
AD5668(uint8_t slaveSelect, uint8_t spiData, uint8_t spiClock);
};
class AD5648 : public AD56X8
{
public:
// HARDWARE SPI
AD5648(uint8_t slaveSelect, __SPI_CLASS__ * mySPI = &SPI);
// SOFTWARE SPI
AD5648(uint8_t slaveSelect, uint8_t spiData, uint8_t spiClock);
};
class AD5628 : public AD56X8
{
public:
// HARDWARE SPI
AD5628(uint8_t slaveSelect, __SPI_CLASS__ * mySPI = &SPI);
// SOFTWARE SPI
AD5628(uint8_t slaveSelect, uint8_t spiData, uint8_t spiClock);
};
// -- END OF FILE --