MCP23017-RK (community library)

Summary

Particle driver for 16-port I2C GPIO Expander MCP23017

Example Build Testing

Library Read Me

This content is provided by the library maintainer and has not been validated or approved.

MCP23017-RK

Particle driver for MCP23017 16-port I2C GPIO expander

Pinouts

One Side:

• 1 GPB0
• 2 GPB1
• 3 GPB2
• 4 GPB3
• 5 GPB4
• 6 GPB5
• 7 GPB6
• 8 GPB7
• 9 VDD (3.3 or 5V, red)
• 10 VSS (GND, black)
• 11 NC
• 12 SCL (to Photon D1, blue)
• 13 SDA (to Photon D0, green)
• 14 NC

Other Side:

• 15 A0
• 16 A1
• 17 A2
• 18 /RESET
• 19 INTB
• 20 INTA
• 21 GPA0
• 22 GPA1
• 23 GPA2
• 24 GPA3
• 25 GPA4
• 26 GPA5
• 27 GPA6
• 28 GPA7

Note that the address lines are not biased so you must connect them to GND or VDD to set the address! Normally you'd connect all to GND to set address 0.

Same for /RESET, though you probably want to connect that to VDD to keep the device out of reset.

pinout (image removed)

Here's my test circuit:

circuit (image removed)

Important: Remember the pull-ups on the SDA and SCL lines (4.7K or 10K typically)! While many breakout boards like you'd get from Adafruit or Sparkfun includes the pull-ups on the board, you must add external resistors when using a bare MCP23008.

Using the Library

This library has an API that looks remarkably like the regular GPIO calls.

Initialization

Typically you create an global object like this in your source:

MCP23017 gpio(Wire, 0);

The first parameter is the interface. It's typically Wire (D0 and D1).

The second parameter is the address of the device (0-7). This corresponds to the value set on the A0, A1, and A2 pins and allows up to 8 separate MCP23008 devices on a single I2C bus.

On the Electron, you can also use Wire1 on C4 and C5:

MCP23017 gpio(Wire1, 0);

begin

void begin();

You must call begin(), typically during setup(), to initialize the Wire interface.

pinMode

void pinMode(uint16_t pin, PinMode mode);

Sets the pin mode of a pin (0-15). Values for mode include:

• INPUT (default)
• INPUT_PULLUP
• OUTPUT

Note that it does not support INPUT_PULLDOWN, as the MCP23008 only supports internal pull-ups. Also, they're 100K vs. the 40K (-ish) pull-ups in the STM32F205.

Pins GPA0 - GPA7 are 0 - 7, and pins GPB0 - GPB7 are 8 - 15.

digitalWrite

void digitalWrite(uint16_t pin, uint8_t value);

Sets the value of a pin (0-15) to the specified value. Values are typically:

• 0 (or false or LOW)
• 1 (or true or HIGH)

digitalRead

int32_t digitalRead(uint16_t pin);

Reads the value of the pin (0-15). This will be HIGH (true, 1) or LOW (false, 0).

If used on an output pin, returns the current output state.

getPinMode

PinMode getPinMode(uint16_t pin);

Returns the pin mode of pin (0-15), which will be one of:

• INPUT (default)
• INPUT_PULLUP
• OUTPUT

pinAvailable

bool pinAvailable(uint16_t pin);

Returns true if 0 <= pin <= 15.

Example Programs

Simple Example

#include "Particle.h"
#include "MCP23017-RK.h"

MCP23008 gpio(Wire, 0);

void setup() {
Serial.begin(9600);

gpio.begin();
gpio.pinMode(0, OUTPUT);
gpio.digitalWrite(0, HIGH);
}

void loop() {
}

Other Example

The other example outputs a square wave on pins 6, 7, 8, 9:

• GPA6: 1000 ms. period (1 Hz)
• GPA7: 666 ms. period
• GPB0: 200 ms. period (5 Hz)
• GPB1: 20 ms. period (50 Hz)

This should result in the following:

Output (image removed)

You can also connect a jumper from GPB7 to one of those pins. It echoes the value on the GPB7 input to the blue D7 LED on the Photon, so you can see the different frequencies.

Browse Library Files