MCP4xxx I2C and SPI digital potentiometers


A digital potentiometer is a potentiometer that can be controlled via digital means (typically I2C or SPI). They consist of a "resistor ladder" of many identical value resistors between two pins (the ends of the potentiometer), while a third pin (the wiper) can be connected between any of those resistors. The number of taps (points between resistors that the wiper can be connected to) varies, but is typically a power of two, or 1 more than a power of two. Some digital potentiometers have non-volatile memory and use that to initialize the wiper position on startup. Digital pots are available in the same resistance ranges as analog pots. Digital rheostats are also available. Note that in most digital potentiometers, the voltage on any of the potentiometer terminals must always be between ground and supply voltage (sometimes with allowance for voltages slightly beyond that), though there do exist digital potentiometers capable of handling much higher voltages on the analog pins. Digital potentiometers generally cannot handle very much current - see the datasheet for specifics.

Supported Parts

This module MCP4xxx (About Modules) interfaces with a wide variety of I2C and SPI digital potentiometers and rheostats made by Microchip. Supported devices have either 129 or 257 taps (128 and 256 tap SPI parts are also supported), 1, 2, or 4 potentiometers (or rheostats), and may or may not have non-volitile memory. Many of these devices have multiple pins available to set the I2C address. This module does not work with MCP401x or MCP4xxxx devices.

Supported parts will have part numbers of the form MCP4abc a - Indicates number of pots and interface. I2C: 4 -> 4 pots, 5 -> 1 pot, 6 -> 2 pots SPI: 1-> 1 pot, 2-> 2 pots, 3-> 4 pots.
b - Indicates number of taps and whether it has non-volitile memory. 3 -> 129 taps volatile, 4-> 129 taps non-volatile. 5 -> 257 taps volatile, 6-> 257 taps non-volatile. c - 1 indicates a potentiometer, 2 indicates a rheostat.

Additionally, the MCP41HVx1 series of high voltage potentiometers is supported.

Wiring (I2C)

Unfortunately, the parts supported by this module are available only in inconvenient packages: QFN (which is impractical to use at home) and TSSOP, which is a finer pitch than the Espruino SMD prototyping area. Generic breakout boards for TSSOP packages are available from Adafruit and many other hobby electronics suppliers. Soldering using the "drag soldering" technique is recommended.

Wiring is straightforward:
GND goes to GND on the Espruino VCC goes to 3.3v on the Espruino (VCC can be 5v on these parts, which means you could use VBat instead if VBat isn't above 5v). Connect SDA and SCL to the corresponding pins on the Espruino. Connect a 10k pullup resistor between SDA and VCC, and between SCL and VCC. Connect a 0.1uf ceramic capacitor between VCC and GND. Connect the address pins to GND (for 0) or VCC (for 1). If not using the alternate address pins, connect them all to GND.

Wiring (SPI)

Unlike their I2C potentiometers, Microchip makes several SPI potentiometers in convenient PDIP and SOIC package, in addition to TSSOP. Presently, the HV series is only available in TSSOP-14.

Wiring is straightforward:
GND goes to GND on the Espruino VCC goes to 3.3v on the Espruino (VCC can be 5v on these parts, which means you could use VBat instead if VBat isn't above 5v). Connect a 0.1uf ceramic capacitor between VCC and GND. Connect SCK, SDO, and SDI to SCK, MISO, and MOSI pins of SPI respectively. Connect any additional pins (SDWN, RST, WLAT, etc), either to VCC, Ground, or a GPIO line, as appropriate for your project. See the datasheets for more details on the function of these pins. For high voltage parts, be sure to connect V+ and V- to the highest and lowest voltages the A/B/W terminals might be exposed to.


Setup I2C or SPI, and then call either:

var digipot=require("MCP4xxx").connectI2C(i2c,pots,taps,addr);


var digipot=require("MCP4xxx").connectSPI(spi,cs,pots,taps);

`i2c` is the I2C interface it is connected to (I2C only)
`spi` is the SPI interface it is connected to (SPI only)
`cs` is the Espruino pin connected to the CS (chip select) line on the part. (SPI only)
`pots` is the number of pots (1, 2, or 4)
`taps` is the number of taps on each pot (129 or 257)
`addr` is the value of the address pins (if omitted, 0 is assumed, I2C only)

Control it using:

digipot.incr(pot) //increment value by 1
digipot.decr(pot) //decrement value by 1

pot is the number of the pot being acted on (0~3) value is the value to be set nv sets whether to refer to the non-volatile registers (if available) (If omitted, volatile memory is assumed)

digipot.setTCON(pot,sdwn,a,w,b) The TCON (Terminal CONnect) register controls whether pins on the specified pot are connected to the resistor ladder or not. sdwn controls shutdown - if set to 0, the all terminals will be disconnected, 1 for normal operation. a, w, and b control whether the corresponding pins are connected to the resistor ladder.

digipot.getStatus() returns an object with up to 5 properties. The pot0-pot3 properties contain the tcon settings for each pot. This is returned as a number from 0-15 - the MSB is shutdown status, then a, w, and b in that order. The status property contains the value of the status register, used to indicate successful write to non-volatile memory on devices with such functionality (otherwise, it may be disregarded).



This page is auto-generated from GitHub. If you see any mistakes or have suggestions, please let us know.