https://github.com/cedargrovestudios/circuitpython_ad5293
A CircuitPython driver for the AD5293 digital potentiometer.
https://github.com/cedargrovestudios/circuitpython_ad5293
ad5293 circuitpython circuitpython-community-bundle digital-potentiometer spi
Last synced: 5 months ago
JSON representation
A CircuitPython driver for the AD5293 digital potentiometer.
- Host: GitHub
- URL: https://github.com/cedargrovestudios/circuitpython_ad5293
- Owner: CedarGroveStudios
- License: mit
- Created: 2023-03-15T18:02:43.000Z (almost 3 years ago)
- Default Branch: main
- Last Pushed: 2023-07-26T01:29:47.000Z (over 2 years ago)
- Last Synced: 2025-03-14T14:25:05.352Z (10 months ago)
- Topics: ad5293, circuitpython, circuitpython-community-bundle, digital-potentiometer, spi
- Language: Python
- Homepage:
- Size: 6.26 MB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.rst
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
README
Introduction
============
.. image:: https://img.shields.io/discord/327254708534116352.svg
:target: https://adafru.it/discord
:alt: Discord
.. image:: https://github.com/CedarGroveStudios/CircuitPython_AD5293/workflows/Build%20CI/badge.svg
:target: https://github.com/CedarGroveStudios/CircuitPython_AD5293/actions
:alt: Build Status
.. image:: https://img.shields.io/badge/code%20style-black-000000.svg
:target: https://github.com/psf/black
:alt: Code Style: Black
A CircuitPython driver for the AD5293 digital potentiometer.
The AD5293 Digital Potentiometer is an SPI, 10-bit, 100K-ohm device. The device
operates with a digital logic power source of 2.7v to 5.5v and a dual analog
power source of +/-9v to +/-16.5v. The potentiometer pins act similarly to a passive
resistive potentiometer, but requires that voltages placed on any of the
three pins not exceed the analog power supply voltage.
The CircuitPython driver supports a single SPI potentiometer device per instance.
Connecting the SDO pin to the SPI host input pin is not required nor recommended
since the SDO pin could interfere with other SPI-connected devices.
This driver does not work with daisy-chained devices.
The Cedar Grove AD5293 custom breakout board provides power and signal
connections for SPI and the potentiometer chip. The AD5293 is also
used in the AD9833-based Cedar Grove Precision VCO Eurorack module.
Dependencies
=============
This driver depends on:
* `Adafruit CircuitPython `_
Please ensure all dependencies are available on the CircuitPython filesystem.
This is easily achieved by downloading
`the Adafruit library and driver bundle `_
or individual libraries can be installed using
`circup `_.
Installing to a Connected CircuitPython Device with Circup
==========================================================
Make sure that you have ``circup`` installed in your Python environment.
Install it with the following command if necessary:
.. code-block:: shell
pip3 install circup
With ``circup`` installed and your CircuitPython device connected use the
following command to install:
.. code-block:: shell
circup install cedargrove_ad5293
Or the following command to update an existing version:
.. code-block:: shell
circup update
Usage Example
=============
.. code-block:: python
import board
import cedargrove_ad5293
ad5293 = cedargrove_ad5245.AD5293(spi=board.SPI(), select=board.D9)
ad5293.wiper = 1023
print("Wiper set to %d"%ad5293.wiper)
``ad5293_simpletest.py`` and other examples can be found in the ``examples`` folder.
Documentation
=============
`AD5293 CircuitPython Driver API Class Description `_
`CedarGrove AD5293 Breakout OSH Park Project `_
`CedarGrove AD5293 Breakout PCB Repository `_
.. image:: https://github.com/CedarGroveStudios/CircuitPython_AD5293/blob/main/media/ad5293_glamour.png
For information on building library documentation, please check out
`this guide `_.
Contributing
============
Contributions are welcome! Please read our `Code of Conduct
`_
before contributing to help this project stay welcoming.