mirror of
https://github.com/RobTillaart/Arduino.git
synced 2024-10-03 18:09:02 -04:00
.. | ||
.github/workflows | ||
examples | ||
test | ||
.arduino-ci.yml | ||
library.json | ||
library.properties | ||
LICENSE | ||
MCP23017.cpp | ||
MCP23017.h | ||
README.md |
MCP23017_RT
Arduino library for MCP23017 16 channel I2C port expander
Description
This library gives easy control over the 16 pins of a MCP23017 chip.
Interface
Constructor
- MCP23017(address, TwoWire *wire = &Wire) constructor, with default Wire interface. Can be overruled with Wire0..WireN
- bool begin() for UNO, returns true if successful
- bool begin(sda, scl) for ESP32, returns true if successful
- bool isConnected() returns true if connected, false otherwise
single pin interface
- bool pinMode(pin, value) pin = 0..15, value = INPUT, OUTPUT, returns true if successful.
- bool digitalWrite(pin, value) pin = 0..15, value = LOW(0) HIGH (!0), returns true if successful.
- uint8_t digitalRead(pin) pin = 0..15
8 pins interface
- bool pinMode8(port, value) port = 0, 1 value = 0..255, returns true if successful.
- bool write8(port, value) port = 0, 1 value = 0..255, returns true if successful.
- uint8_t read8(port) port = 0, 1
Error codes
- int lastError() Above functions set an error flag that can be read withthis function. Reading it will reset the flag to MCP23017_OK.
DESCRIPTION | VALUE |
---|---|
MCP23017_OK | 0x00 |
MCP23017_PIN_ERROR | 0x81 |
MCP23017_I2C_ERROR | 0x82 |
MCP23017_VALUE_ERROR | 0x83 |
MCP23017_PORT_ERROR | 0x84 |
Future
Must
- add pinMode16(), write16() and read16()
- investigate PULL_UP register see begin() => pinMode() (breaking change)
Should
- investigate caching for performance (readback)
Could
- initial value (16 bit?) as begin parameter (breaking change)
- depends on input output pullup etc?
- investigate auto address increment?
Operation
See examples