GY-63_MS5611/libraries/AD5263/AD5263.cpp

//
//    FILE: AD5263.cpp
//  AUTHOR: Rob Tillaart
// VERSION: 0.1.0
// PURPOSE: Arduino library for I2C digital potentiometer AD5263 and compatibles.
//    DATE: 2023-10-09
//     URL: https://github.com/RobTillaart/AD5263


#include "AD5263.h"


#define AD5263_RDAC0        0x00
#define AD5263_RDAC1        0x20
#define AD5263_RDAC2        0x40
#define AD5263_RDAC3        0x60
#define AD5263_RESET        0x10
#define AD5263_SHUTDOWN     0x08
#define AD5263_O1_HIGH      0x04
#define AD5263_O2_HIGH      0x02


AD5263::AD5263(const uint8_t address, TwoWire *wire)
{
  _address = address;
  _wire = wire;

  //  power on reset => mid position
  _pmCount = 4;
  for (int i = 0; i < _pmCount; i++)
  {
  _lastValue[i] = AD5263_MIDPOINT;
  }
  _O1 = _O2 = 0;
}


bool AD5263::begin()
{
  if (! isConnected()) return false;
  reset();
  return true;
}


bool AD5263::isConnected()
{
  _wire->beginTransmission(_address);
  return ( _wire->endTransmission() == 0);
}


uint8_t AD5263::reset()
{
  for (int i = 1; i < _pmCount; i++)
  {
    write(i, AD5263_MIDPOINT);
  }
  return write(0, AD5263_MIDPOINT, LOW, LOW);
}


uint8_t AD5263::zeroAll()
{
  for (int i = 1; i < _pmCount; i++)
  {
    write(i, 0);
  }
  return write(0, 0, LOW, LOW);
}


uint8_t AD5263::write(const uint8_t rdac, const uint8_t value)
{
  if (rdac >= _pmCount) return AD5263_ERROR;

  uint8_t cmd = AD5263_RDAC0;
  if (rdac == 1) cmd = AD5263_RDAC1;
  if (rdac == 2) cmd = AD5263_RDAC2;
  if (rdac == 3) cmd = AD5263_RDAC3;

  //  apply the output lines
  cmd = cmd | _O1 | _O2;
  _lastValue[rdac] = value;
  return send(cmd, value);
}


uint8_t AD5263::write(const uint8_t rdac, const uint8_t value, const uint8_t O1, const uint8_t O2)
{
  if (rdac >= _pmCount) return AD5263_ERROR;

  _O1 = (O1 == LOW) ? 0 : AD5263_O1_HIGH;
  _O2 = (O2 == LOW) ? 0 : AD5263_O2_HIGH;

  uint8_t cmd = AD5263_RDAC0;
  if (rdac == 1) cmd = AD5263_RDAC1;
  if (rdac == 2) cmd = AD5263_RDAC2;
  if (rdac == 3) cmd = AD5263_RDAC3;

  //  apply the output lines
  cmd = cmd | _O1 | _O2;
  _lastValue[rdac] = value;
  return send(cmd, value);
}


uint8_t AD5263::setO1(const uint8_t value)
{
  _O1 = (value == LOW) ? 0 : AD5263_O1_HIGH;
  uint8_t cmd = AD5263_RDAC0 | _O1 | _O2;
  return send(cmd, _lastValue[0]);
}


uint8_t AD5263::setO2(const uint8_t value)
{
  _O2 = (value == LOW) ? 0: AD5263_O2_HIGH;
  uint8_t cmd = AD5263_RDAC0 | _O1 | _O2;
  return send(cmd, _lastValue[0]);
}


uint8_t AD5263::getO1()
{
  return (_O1 > 0);
}


uint8_t AD5263::getO2()
{
  return (_O2 > 0);
}


uint8_t AD5263::read(const uint8_t rdac)
{
  if (rdac >= _pmCount) return 0x00;
  return _lastValue[rdac];
}


uint8_t AD5263::readBackRegister()
{
  _wire->beginTransmission(_address);
  _wire->endTransmission();
  _wire->requestFrom(_address, (uint8_t)1);
  return _wire->read();
}


uint8_t AD5263::midScaleReset(const uint8_t rdac)
{
    if (rdac >= _pmCount) return AD5263_ERROR;

  uint8_t cmd = AD5263_RESET;
  if (rdac == 0) cmd |= AD5263_RDAC0;
  if (rdac == 1) cmd |= AD5263_RDAC1;
  if (rdac == 2) cmd |= AD5263_RDAC2;
  if (rdac == 3) cmd |= AD5263_RDAC3;

  //  apply the output lines
  cmd = cmd | _O1 | _O2;
  _lastValue[rdac] = AD5263_MIDPOINT;
  return send(cmd, AD5263_MIDPOINT);
}


//  read datasheet P.20
uint8_t AD5263::shutDown()
{
  uint8_t cmd = AD5263_SHUTDOWN;  //  TODO TEST & VERIFY
  return send(cmd, 0);
}


uint8_t AD5263::pmCount()
{
  return _pmCount;
}


//////////////////////////////////////////////////////////
//
//  PROTECTED
//
uint8_t AD5263::send(const uint8_t cmd, const uint8_t value)
{
  _wire->beginTransmission(_address);
  _wire->write(cmd);
  _wire->write(value);
  return _wire->endTransmission();
}


//////////////////////////////////////////////////////////////
//
//  DERIVED CLASSES
//
/*
AD5280::AD5280(const uint8_t address, TwoWire *wire) : AD5263(address, wire)
{
  _pmCount = 1;
}


uint8_t AD5280::write(const uint8_t value)
{
  //  apply the output lines
  uint8_t cmd = AD5263_RDAC0 | _O1 | _O2;
  _lastValue[0] = value;
  return send(cmd, value);
}


uint8_t AD5280::write(const uint8_t value, const uint8_t O1, const uint8_t O2)
{
  _O1 = (O1 == LOW) ? 0 : AD5263_O1_HIGH;
  _O2 = (O2 == LOW) ? 0 : AD5263_O2_HIGH;

  //  apply the output lines
  uint8_t cmd = AD5263_RDAC0 | _O1 | _O2;
  _lastValue[0] = value;
  return send(cmd, value);
}


uint8_t AD5280::write(const uint8_t rdac, const uint8_t value)
{
  return AD5263::write(rdac, value);
}


uint8_t AD5280::write(const uint8_t rdac, const uint8_t value, const uint8_t O1, const uint8_t O2)
{
  return AD5263::write(rdac, value, O1, O2);
}


AD5242::AD5282(const uint8_t address, TwoWire *wire) : AD5263(address, wire)
{
  _pmCount = 2;
}
*/

//  -- END OF FILE --