GY-63_MS5611/libraries/AD5245/README.md
2024-01-12 17:06:06 +01:00

4.0 KiB

Arduino CI Arduino-lint JSON check GitHub issues

License: MIT GitHub release PlatformIO Registry

AD5245

Arduino library for I2C single channel digital potentiometer AD5245.

The library is experimental and not tested with hardware yet.

Description

The AD5245 is a single channel digital potentiometer which comes in 5 kΩ, 10 kΩ, 50 kΩ, 100 kΩ and can be set in 256 steps.

Indicative step size.

value step size
5 kΩ 19.53 Ω
10 kΩ 39.06 Ω
50 kΩ 195.3 Ω
100 kΩ 390.6 Ω

An important property of the device is that it defaults to the mid-scale position at startup. One can use AD5245_MIDPOINT == 128 to reset to the mid-scale position.

0.3.0 Breaking change

Version 0.3.0 introduced a breaking change. You cannot set the pins in begin() any more. This reduces the dependency of processor dependent Wire implementations. The user has to call Wire.begin() and can optionally set the Wire pins before calling begin().

This library is based upon the AD524X library, and triggered by this issue:

I2C address

The AD5245 has one address line to configure the I2C address.

Address(dec) Address(Hex) AD0
44 0x2C GND
45 0x2D +5V

The maximum I2C speed is 400 KHz.

Interface

#include AD5245.h"

The library has a number of functions which are all quite straightforward. One can get / set the value of the potentiometer.

  • AD5245(uint8_t address, TwoWire *wire = &Wire) constructor
  • bool begin() initializes internals. Returns true on success.
  • bool isConnected() See if address set in constructor is on the bus.
  • uint8_t reset() sets potentiometer to midpoint = 128. (startup default)
  • uint8_t write(uint8_t value) set to value 0 .. 255.
  • uint8_t read() read value from cache.
  • uint8_t readDevice() read value from device.
  • uint8_t shutDown() check datasheet, not tested yet, use at own risk.

Error codes

define value
AD5245_OK 0
AD5245_ERROR 100

Operation

The examples show the basic working of the functions.

Future

Must

Should

  • sync with AD520X library
  • sync with AD524X library

Could

Wont

  • midScaleReset() ? AD524X alike ==> user can do write(AD5245_MIDPOINT).

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,