Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/cedargrovestudios/circuitpython_ad5245

A CircuitPython driver for the AD5245 digital potentiometer.
https://github.com/cedargrovestudios/circuitpython_ad5245

ad5245 circuitpython circuitpython-community-bundle digital-potentiometer i2c

Last synced: 20 days ago
JSON representation

A CircuitPython driver for the AD5245 digital potentiometer.

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_AD5245/workflows/Build%20CI/badge.svg
:target: https://github.com/CedarGroveStudios/CircuitPython_AD5245/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 AD5245 digital potentiometer.

The AD5245 Digital Potentiometer is an I2C, 10K-ohm chip. The potentiometer sports
256 resistance steps and can work with a power source from 2.7v to 5.5v. The pins
act similarly to a passive resistive potentiometer, but require that voltages placed
on any of the three pins not exceed the power supply voltage or drop below ground potential.

The Cedar Grove AD5245 custom breakout board provides power and signal connections
for I2C and the potentiometer chip. The AD5245 is also integrated with the
AD9833 ADSR Precision Waveform Generator FeatherWing.

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_ad5245

Or the following command to update an existing version:

.. code-block:: shell

circup update

Usage Example
=============

.. code-block:: python

import cedargrove_ad5245

ad5245 = cedargrove_ad5245.AD5245(address=0x2C)

ad5245.wiper = 255
print("Wiper set to %d"%ad5245.wiper)

``ad5245_simpletest.py`` and other examples can be found in the ``examples`` folder.

Documentation
=============
`AD5245 CircuitPython Driver API Class Description `_

`CedarGrove AD5245 Breakout OSH Park Project `_

.. image:: https://github.com/CedarGroveStudios/CircuitPython_AD5245/blob/master/media/AD5245_breakout_for_fritzing.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.