#embedded-hal-driver #i2c-driver #expander #i2c #hal-driver

no-std pcf857x

Platform-agnostic Rust driver for the PCF8574, PCF8574A and PCF8575 I/O expanders

5 releases (breaking)

0.5.0 Apr 4, 2025
0.4.0 May 22, 2021
0.3.0 Jun 8, 2019
0.2.0 Oct 20, 2018
0.1.0 Aug 22, 2018

#2459 in Embedded development

Download history 8/week @ 2025-02-05 3/week @ 2025-02-12 25/week @ 2025-02-19 13/week @ 2025-02-26 25/week @ 2025-03-12 164/week @ 2025-04-02 17/week @ 2025-04-09

184 downloads per month

MIT/Apache

35KB
552 lines

Rust PCF857x I/O Expanders Driver

crates.io Docs MSRV Build Status Coverage Status

This is a platform agnostic Rust driver for the PCF8574, PCF8574A and PCF8575 I2C I/O expanders, based on the embedded-hal traits.

This driver allows you to:

  • Set all the outputs to 0 or 1 at once. See set().
  • Read selected inputs. See get().
  • Set all the outputs repeatedly looping through an array. See write_array().
  • Read selected inputs repeatedly filling up an array. See read_array().
  • Split the device into individual input/output pins. See split().

The devices

The devices consist of 8 or 16 quasi-bidirectional ports, I²C-bus interface, three hardware address inputs and interrupt output. The quasi-bidirectional port can be independently assigned as an input to monitor interrupt status or keypads, or as an output to activate indicator devices such as LEDs.

The active LOW open-drain interrupt output (INT) can be connected to the interrupt logic of the microcontroller and is activated when any input state differs from its corresponding input port register state.

Datasheets:

Usage

Please find additional examples using hardware in this repository: driver-examples

use linux_embedded_hal::I2cdev;
use pcf857x::{Pcf8574, PinFlag, SlaveAddr};

fn main() {
    let dev = I2cdev::new("/dev/i2c-1").unwrap();
    let address = SlaveAddr::default();
    let mut expander = Pcf8574::new(dev, address);
    let output_pin_status = 0b1010_1010;
    expander.set(output_pin_status).unwrap();

    let pins_to_be_read = PinFlag::P0 | PinFlag::P7;
    let status = expander.get(pins_to_be_read).unwrap();

    println!("Input pin status: {}", status);
}

Support

For questions, issues, feature requests, and other changes, please file an issue in the github project.

Minimum Supported Rust Version (MSRV)

This crate is guaranteed to compile on stable Rust 1.62 and up. It might compile with older versions but that may change in any new patch release.

License

Licensed under either of

at your option.

Contributing

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.

Dependencies

~56KB