5 releases (3 breaking)
0.4.0 | Sep 7, 2021 |
---|---|
0.3.1 | Sep 13, 2020 |
0.3.0 | Dec 25, 2019 |
0.2.0 | Aug 31, 2019 |
0.1.0 | Aug 9, 2019 |
#2207 in Embedded development
Used in ruspiro-sdk
28KB
387 lines
RusPiRo I²C Bus interface crate
Simple and safe access to the I²C bus available on the Raspberry Pi. This implementation will need the GPIO pins 2 and 3 for exclusive use for the I²C bus.
Dependency
The I²C implementation requires an allocator to be build into the final binary. It's recommended to
use the ruspiro-allocator
with this crate.
Usage
To use the crate just add the following dependency to your Cargo.toml
file:
[dependencies]
ruspiro-i2c = "0.3"
Once done the access to the I²C bus interface is available in your rust files like so:
use ruspiro_i2c::I2C;
fn demo() {
I2C.take_for(|i2c| {
if i2c.initialize(250_000_000, true).is_ok() {
// now scan I2C devices connected to RPi, this will print their
// addresses to the console
let devices = i2c.scan().unwrap();
for d in devices {
info!("device detected at 0x{:2X}", d);
}
}
});
}
To configure and use a device connected to the I²C bus you can simply use the provided functions provided when taking the I2C. First off you may check whether the device is connected to the bus before continuing with the config:
use ruspiro_i2c::I2C;
fn demo() {
let device_addr = 0x68;
I2C.take_for(|i2c| {
if i2c.check_device(device_addr).is_ok() {
// configure the device...
// as arbitary example pass value 0x1 to the 8bit register 0x10
i2c.write_register_u8(device_addr, 0x10, 0x1);
}
});
}
License
Licensed under Apache License, Version 2.0, (LICENSE or http://www.apache.org/licenses/LICENSE-2.0)
Dependencies
~2MB
~41K SLoC