mirror of
https://github.com/RobTillaart/Arduino.git
synced 2024-09-20 00:55:58 -04:00
77 lines
2.5 KiB
Markdown
77 lines
2.5 KiB
Markdown
|
|
[](https://github.com/marketplace/actions/arduino_ci)
|
|
[](https://github.com/RobTillaart/AD5245/actions/workflows/arduino-lint.yml)
|
|
[](https://github.com/RobTillaart/AD5245/actions/workflows/jsoncheck.yml)
|
|
[](https://github.com/RobTillaart/AD5245/blob/master/LICENSE)
|
|
[](https://github.com/RobTillaart/AD5245/releases)
|
|
|
|
|
|
# AD5245
|
|
|
|
Arduino library for I2C single channel digital potentiometer AD5245.
|
|
|
|
The library is experimental and not tested yet.
|
|
|
|
|
|
## Description
|
|
|
|
The AD5245 is a single channel digital potentiometer which comes in
|
|
10K, 100K and 1M and can be set in 256 steps.
|
|
|
|
An important property of the device is that it defaults
|
|
to the mid position at startup.
|
|
One can use **AD5245_MIDPOINT** == 128 to reset to the mid position.
|
|
|
|
|
|
#### Related libraries
|
|
|
|
This library is based upon the AD524X library, and triggered by this issue:
|
|
- https://github.com/RobTillaart/AD524X/issues/11
|
|
|
|
|
|
## I2C address
|
|
|
|
The AD5245 has one address line to configure the I2C address.
|
|
|
|
| Addr(dec)| Addr(Hex) | AD0 |
|
|
|:--------:|:---------:|:-----:|
|
|
| 44 | 0x2C | GND |
|
|
| 45 | 0x2D | +5V |
|
|
|
|
|
|
## Interface
|
|
|
|
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(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.
|
|
- **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
|
|
|
|
- sync with AD520X library
|
|
- sync with AD524X library
|
|
- reset ==> midScaleReset() ? AD524X alike
|
|
|