GY-63_MS5611/libraries/AD524X
2021-05-28 13:17:38 +02:00
..
.github/workflows add arduino-lint 2021-05-28 13:17:38 +02:00
examples 2021-01-29 2021-01-29 12:31:58 +01:00
test 2021-01-29 2021-01-29 12:31:58 +01:00
.arduino-ci.yml 2021-01-29 2021-01-29 12:31:58 +01:00
AD524X.cpp 2021-01-29 2021-01-29 12:31:58 +01:00
AD524X.h 2021-01-29 2021-01-29 12:31:58 +01:00
keywords.txt 2021-01-29 2021-01-29 12:31:58 +01:00
library.json 2021-01-29 2021-01-29 12:31:58 +01:00
library.properties 2021-01-29 2021-01-29 12:31:58 +01:00
LICENSE 2021-01-29 2021-01-29 12:31:58 +01:00
README.md 2021-01-29 2021-01-29 12:31:58 +01:00

Arduino CI License: MIT GitHub release

AD524X

Arduino class for I2C digital potentiometer AD5241 AD5242

Description

The AD5241 and AD5242 are two digital potentiometers. The AD5241 has one, the AD5242 has two potentiometers. Both types have two outputlines O1 and O2.

These digital potentiometers come in 10K, 100K and 1M and can be set in 256 steps.

An important property of the devices is that they defaults to their mid position at startup.

I2C address

The AD524X has two address lines to configure the I2C address.0x2C - 0x2F

Addr(dec) Addr(Hex) AD0 AD1
44 0x2C GND GND
45 0x2D GND +5V
46 0x2E +5V GND
47 0x2F +5V +5V

Interface

The library has a number of functions which are all quite straightforward. One can get / set the value of (both) the potentiometer(s), and the O1 and O2 lines.

Constructors

  • AD524X(uint8_t address, TwoWire *wire = &Wire) base class, creates an instance with 2 potentiometer. This class does not distinguish between AD5241 and AD5242. The developer is responsible for handling this correctly.
  • AD5241(uint8_t address, TwoWire *wire = &Wire) create an instance with 1 potentiometer
  • AD5242(uint8_t address, TwoWire *wire = &Wire) create an instance with 2 potentiometer

Wire initialization

  • bool begin(uint8_t sda, uint8_t scl) ESP32 a.o initializing of Wire
  • bool begin() for UNO
  • bool isConnected() See if address set in constructor is on the bus.

Basic IO

  • uint8_t write(rdac, value) set channel rdac 0/1 to value 0..255
  • uint8_t write(rdac, value, O1, O2) idem + set output lines O1 and O2 too
  • uint8_t read(rdac) read back set value
  • uint8_t setO1(value = HIGH) value = HIGH (default) or LOW
  • uint8_t setO2(value = HIGH) value = HIGH (default) or LOW
  • uint8_t getO1() read back O1 line
  • uint8_t getO2() read back O2 line

Misc

  • uint8_t zeroAll() sets pm's and I/O to 0 or LOW.
  • uint8_t reset() sets pm's to midpoint = 127 and I/O to LOW. (startup)
  • uint8_t midScaleReset(rdac) resets one to midpoint = 127.
  • uint8_t readBackRegister() read register back, for debugging.

Experimental

  • uint8_t shutDown() check datasheet, not tested yet, use at own risk.

Operation

The examples show the basic working of the functions.