10 unstable releases (3 breaking)

0.4.5 Feb 20, 2023
0.4.4 Feb 3, 2023
0.3.0 Feb 1, 2023
0.2.1 Feb 1, 2023
0.1.0 Feb 1, 2023

#1525 in Embedded development

34 downloads per month

MIT license

29KB
314 lines

ina3221

crates.io

Embedded driver for the INA3221 triple-channel power monitor in Rust.

The INA3221 is very similar to the classic INA219 power monitor IC.

Compatibility

Any board that supports embedded-hal blocking 1.0 I2c should be compatible with this library.

NOTE: Some HALs require feature flagging to enable 1.0 functionality, for example esp-hal requires the eh1 feature.

Installation

You can add via crates.io:

$ cargo add ina3221

NOTE: Some HALs require feature flagging to enable 1.0 functionality, for example esp-hal requires the eh1 feature.

Documentation

You can find the documentation here.

Example

This example assumes a 0.1 Ohm shunt resistor for current and power calculations.

const INA3221_I2C_ADDR: u8 = 0x40;
const SHUNT_RESISTANCE: f32 = 0.1f32;   // 0.1 Ohm

use ina3221::INA3221;

fn main() {
    let i2c = I2C::new(/* initialize your I2C here */);
    let ina = INA3221::new(i2c, INA3221_I2C_ADDR);

    let mut delay = Delay::new(/* initialize your delay/clocks */);

    loop {
        for channel in 0..3 {
            let shunt_voltage = ina.get_shunt_voltage(channel).unwrap();
            let bus_voltage = ina.get_bus_voltage(channel).unwrap();
            
            // Voltage can be added using the '+' operator on the unit type
            let load_voltage = bus_voltage + shunt_voltage;

            // Skip channel if no voltage present
            if shunt_voltage.is_zero() {
                continue;
            }
            
            // Use Ohm's Law to calculate current and power with known resistance
            let current_milliamps = shunt_voltage.milli_volts() / SHUNT_RESISTANCE;
            let power_milliwatts = current_milliamps * load_voltage.volts();
            
            println!(
                "Channel {}: load = {:.3} V, current = {:.3} mA, power = {:.3} mW",
                channel_index + 1,
                load_voltage.volts(),
                current_milliamps,
                power_milliwatts,
            );
        }
        
        delay.delay_ms(1000u32);
    }
}

Output

This is sample output powering an Arduino Uno R3 over USB, running the blinky script.

Channel 1: load = 5.212 V, current = 36.800 mA, power = 191.790 mW
Channel 1: load = 5.211 V, current = 33.600 mA, power = 175.102 mW
Channel 1: load = 5.212 V, current = 36.800 mA, power = 191.790 mW
Channel 1: load = 5.219 V, current = 34.000 mA, power = 177.460 mW
Channel 1: load = 5.212 V, current = 36.800 mA, power = 191.790 mW
Channel 1: load = 5.211 V, current = 34.000 mA, power = 177.188 mW
Channel 1: load = 5.211 V, current = 34.000 mA, power = 177.188 mW
Channel 1: load = 5.212 V, current = 36.400 mA, power = 189.704 mW
Channel 1: load = 5.211 V, current = 34.000 mA, power = 177.188 mW
Channel 1: load = 5.212 V, current = 36.800 mA, power = 191.790 mW
Channel 1: load = 5.211 V, current = 34.000 mA, power = 177.188 mW

Dependencies

~220KB