https://github.com/rahix/port-expander
Abstraction for I²C port-expanders
https://github.com/rahix/port-expander
embedded-hal i2c rust-embedded
Last synced: 2 months ago
JSON representation
Abstraction for I²C port-expanders
- Host: GitHub
- URL: https://github.com/rahix/port-expander
- Owner: Rahix
- License: apache-2.0
- Created: 2021-04-24T13:05:02.000Z (about 4 years ago)
- Default Branch: main
- Last Pushed: 2025-02-01T14:09:36.000Z (4 months ago)
- Last Synced: 2025-04-04T12:53:23.678Z (2 months ago)
- Topics: embedded-hal, i2c, rust-embedded
- Language: Rust
- Homepage:
- Size: 104 KB
- Stars: 20
- Watchers: 3
- Forks: 15
- Open Issues: 6
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE-APACHE
Awesome Lists containing this project
README
`port-expander` [](https://crates.io/crates/port-expander) [](https://docs.rs/port-expander)
===============
This is a crate providing a common abstraction for I²C port-expanders. This
abstraction is not necessarily the most performant, but it allows using the pins
just like direct GPIOs. Because the pin types also implement the `embedded-hal`
digital IO traits, they can also be passed to further drivers downstream (e.g.
as a reset or chip-select pin).
## Example
```rust
// Initialize I2C peripheral from HAL
let i2c = todo!();
// A0: HIGH, A1: LOW, A2: LOW
let mut pca9555 = port_expander::Pca9555::new(i2c, true, false, false);
let pca_pins = pca9555.split();
let io0_0 = pca_pins.io0_0.into_output().unwrap();
let io1_5 = pca_pins.io0_1; // default is input
io0_0.set_high().unwrap();
assert!(io1_5.is_high().unwrap());
```
## Accessing multiple pins at the same time
Sometimes timing constraints mandate that multiple pin accesses (reading or
writing) happen at the same time. The [`write_multiple()`][write-multiple] and
[`read_multiple()`][read-multiple] methods are designed for doing this.
[write-multiple]: https://docs.rs/port-expander/latest/port_expander/fn.write_multiple.html
[read-multiple]: https://docs.rs/port-expander/latest/port_expander/fn.read_multiple.html
## Supported Devices
The following list is what `port-expander` currently supports. If you needs
support for an additional device, it should be easy to add. It's best to take
a similar existing implementation as inspiration. Contributions welcome!
- [`MAX7321`](https://docs.rs/port-expander/latest/port_expander/dev/max7321/struct.Max7321.html)
- [`PCA9536`](https://docs.rs/port-expander/latest/port_expander/dev/pca9536/struct.Pca9536.html)
- [`PCA9538`](https://docs.rs/port-expander/latest/port_expander/dev/pca9538/struct.Pca9538.html)
- [`PCA9554`](https://docs.rs/port-expander/latest/port_expander/dev/pca9554/struct.Pca9554.html)
- [`PCA9554A`](https://docs.rs/port-expander/latest/port_expander/dev/pca9554/struct.Pca9554A.html)
- [`PCA9555`](https://docs.rs/port-expander/latest/port_expander/dev/pca9555/struct.Pca9555.html)
- [`PCF8574A`](https://docs.rs/port-expander/latest/port_expander/dev/pcf8574/struct.Pcf8574a.html)
- [`PCF8574`](https://docs.rs/port-expander/latest/port_expander/dev/pcf8574/struct.Pcf8574.html)
- [`PCF8575`](https://docs.rs/port-expander/latest/port_expander/dev/pcf8575/struct.Pcf8575.html)
- [`TCA6408A`](https://docs.rs/port-expander/latest/port_expander/dev/tca6408a/struct.Tca6408a.html)
- [`PI4IOE5V6408`](https://docs.rs/port-expander/latest/port_expander/dev/pi4ioe5v6408/struct.Pi4ioe5v6408.html)
## Non-local sharing
`port-expander` uses a custom trait for abstracting different kinds of mutexes:
[`PortMutex`](https://docs.rs/port-expander/latest/port_expander/trait.PortMutex.html).
This means you can also make the pins shareable across task/thread boundaries,
given that you provide an appropriate mutex type:
```rust
// Initialize I2C peripheral from HAL
let i2c = todo!();
// A0: HIGH, A1: LOW, A2: LOW
let mut pca9555: port_expander::Pca9555> =
port_expander::Pca9555::with_mutex(i2c, true, false, false);
let pca_pins = pca9555.split();
```
## License
Licensed under either of
* Apache License, Version 2.0
([LICENSE-APACHE](LICENSE-APACHE) or )
* MIT license
([LICENSE-MIT](LICENSE-MIT) or )
at your option.
## Contribution
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.