Skip to content

MicroPython driver for PCF8574 8-Bit I2C I/O Expander with Interrupt

License

Notifications You must be signed in to change notification settings

mcauser/micropython-pcf8574

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

2 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

MicroPython PCF8574

A MicroPython library for PCF8574 8-Bit I2C I/O Expander with Interrupt.

demo

The PCF8574 consists of a 8-bit quasi-bidirectional port and an I2C-bus interface.

The device includes latched outputs with high current drive capability for directly driving LEDs.

The interrupt has an open-drain output, which means you need a pull-up on your microcontroller to detect when the PCF8574 drives it LOW.

When setting a pin HIGH, it acts as both output AND input. The pin internally uses a weak current-source pull-up to latch output HIGH. When driven LOW, for example, with a push button, the pin will read as LOW.

An interrupt fires on any rising or falling edge of the pins in input mode (HIGH). Interrupt is cleared when the pins are changed or the port is read.

At power on, all pins are driven HIGH and can be immediately used as inputs.

Operating voltage: 2.5V - 5.5V

Installation

Using mip via mpremote:

$ mpremote mip install github:mcauser/micropython-pcf8574
$ mpremote mip install github:mcauser/micropython-pcf8574/examples

Using mip directly on a WiFi capable board:

>>> import mip
>>> mip.install("github:mcauser/micropython-pcf8574")
>>> mip.install("github:mcauser/micropython-pcf8574/examples")

Manual installation:

Copy src/pcf8574.py to the root directory of your device.

Examples

Basic Usage

import pcf8574
from machine import I2C, Pin

# TinyPICO (ESP32)
i2c = I2C(0)
pcf = pcf8574.PCF8574(i2c, 0x20)

# read pin 2
pcf.pin(2)

# set pin 3 HIGH
pcf.pin(3, 1)

# set pin 4 LOW
pcf.pin(4, 0)

# toggle pin 5
pcf.toggle(5)

# set all pins at once with 8-bit int
pcf.port = 0xFF

# read all pins at once as 8-bit int
pcf.port
# returns 255 (0xFF)

For more detailed examples, see examples.

If you mip installed them above, you can run them like so:

import pcf8574.examples.basic

Pins

Pin Type Description
A0 I Address select 1, connect to VCC or GND
A1 I Address select 2, connect to VCC or GND
A2 I Address select 3, connect to VCC or GND
INT O Interrupt output, open drain, active LOW
P00 I/O Port A, Pin 0
P01 I/O Port A, Pin 1
P02 I/O Port A, Pin 2
P03 I/O Port A, Pin 3
P04 I/O Port A, Pin 4
P05 I/O Port A, Pin 5
P06 I/O Port A, Pin 6
P07 I/O Port A, Pin 7
SDA I/O I2C Serial Data, needs pull-up
SCL I I2C Serial Clock, needs pull-up
GND PWR Ground
VCC PWR Supply voltage 3.3-5V

Methods

Construct with a reference to I2C and set the device address. Valid address range 0x20-0x27. If are you not sure what it is, run an i2c.scan(). See below for address selection.

__init__(i2c, address=0x20)

Scans the I2C bus for the provided address and returns True if a device is present otherwise raises an OSError.

check()

Method for getting or setting a single pin. If no value is provided, the port will be read and value of specified pin returned. If a value is provided, the port will be updated and device written to. The port is written to after each call. If you intend to toggle many pins at once, use the port property instead. See below. Valid pin range 0-7.

pin(pin, value=None)

Method for flipping the value of a single pin. Valid pin range 0-7.

toggle(pin)

Private method for checking the supplied pin number is within the valid range.

_validate_pin()

Private method for loading _port from the device.

_read()

Private method for sending _port to the device.

_write()

Properties

Getter reads the port from the device and returns a 8-bit integer.

port

Setter writes an 8-bit integer representing the port to the device. If you are setting multiple pins at once, use this instead of the pin() method as this writes the entire 8-bit port to the device once, rather than 8 separate writes.

port = 0xFF

Ports

  • P00-P07 - Port A

This chip only has one port (8 pins). If you need more pins, the PCF8575 has two ports (16 pins).

Interrupts

  • INT - Active LOW

I2C Interface

If you are using a module, most contain 10k pull-ups on the SCL and SDA lines.

If you are using the PCF8574 chip directly, you'll need to add your own.

I2C Address

The chip supports I2C addresses 0x20-0x27 and is customisable using address pins A0, A1, A2

A0 A1 A2 I2C Address
GND GND GND 0x20 (default)
3V3 GND GND 0x21
GND 3V3 GND 0x22
3V3 3V3 GND 0x23
GND GND 3V3 0x24
3V3 GND 3V3 0x25
GND 3V3 3V3 0x26
3V3 3V3 3V3 0x27

Parts

Connections

TinyPICO ESP32

from machine import SoftI2C, Pin
i2c = SoftI2C(scl=Pin(22), sda=Pin(21))

from machine import I2C, Pin
i2c = I2C(0)
PCF8574 Module TinyPICO (ESP32)
SDA 21 (SDA)
SCL 22 (SCL)
VCC 3V3
GND GND
INT (optional) 4

Links

License

Licensed under the MIT License.

Copyright (c) 2019 Mike Causer