Ecosyste.ms: Awesome

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

Awesome Lists | Featured Topics | Projects

https://github.com/blemasle/arduino-mcp23017

Complete support of MCP23017
https://github.com/blemasle/arduino-mcp23017

arduino-library i2c mcp23017 port-expander

Last synced: 3 days ago
JSON representation

Complete support of MCP23017

Host: GitHub
URL: https://github.com/blemasle/arduino-mcp23017
Owner: blemasle
License: mit
Created: 2018-11-20T01:53:57.000Z (almost 6 years ago)
Default Branch: master
Last Pushed: 2023-11-18T12:43:53.000Z (12 months ago)
Last Synced: 2024-08-02T05:06:51.762Z (3 months ago)
Topics: arduino-library, i2c, mcp23017, port-expander
Language: C++
Homepage:
Size: 52.7 KB
Stars: 68
Watchers: 7
Forks: 40
Open Issues: 2
Metadata Files:
- Readme: README.md
- License: LICENSE.md

Awesome Lists containing this project

README

# MCP23017
[![Build Status](https://travis-ci.org/blemasle/arduino-mcp23017.svg?branch=master)](https://travis-ci.org/blemasle/arduino-mcp23017)
[![License](https://img.shields.io/badge/license-MIT%20License-blue.svg)](http://doge.mit-license.org)

This library provides full control over the Microchip's [MCP23017](https://www.microchip.com/wwwproducts/en/MCP23017), including interrupt support.

## Features
* Individual pins read & write
* Ports read & write
* Registers read & write
* Full interrupt support

## Usage
Unlike most Arduino library, no default instance is created when the library is included. It's up to you to create one using the appropriate I2C address based on MCP23017 `A0`, `A1` and `A2` pins wirings.
Available addresses go from `0x20` to `0x27`, allowing up to 8 MCP23017 on the same I2C bus.

```cpp
#include
#include

MCP23017 mcp = MCP23017(0x24);
```

Additionaly, you can specify the `Wire` instance to use as a second argument. For instance `MCP23017(0x24, Wire1)`.
See included examples for further usage.

## Warning about GPA7 & GPB7

GPA7 or GPB7 should not be used as inputs despite what the configuration registers allow. As [stated by Microchip](https://microchip.my.site.com/s/article/GPA7---GPB7-Cannot-Be-Used-as-Inputs-In-MCP23017), it can lead to SDA signal corruption or even malfunction in the host bus under some conditions.

## Breaking changes in v2.0.0
Major renames have been performed in v2.0.0 to improve compatibility with a variety of platforms. Existing code *will* break when you update from version v1.x.

| Name in v1.x | Name in v2.x |
|-----------------------|---------------------------|
| `MCP23017_PORT` | `MCP23017Port` |
| `MCP23017_REGISTER` | `MCP23017Register` |
| `MCP23017_INTMODE` | `MCP23017InterruptMode` |

In addition to this, every member of the `MCP23017Register` enum were renamed to avoid possible conflicts with macro definitions. `GPIOA` was renamed to `GPIO_A`, `INTCAPA` to `INTCAP_A` and so on...