#gauge #battery #embedded-hal-driver #fuel #lithium

no-std max170xx

Platform-agnostic Rust driver for the MAX170xx 1-cell/2-cell fuel-gauge systems with ModelGauge for lithium-ion (Li+) batteries. Compatible with MAX17043, MAX17044, MAX17048 MAX17049, MAX17058 and MAX17059

1 unstable release

0.1.0 Jul 19, 2020

#579 in Embedded development

Download history 5/week @ 2021-02-25 4/week @ 2021-03-04 4/week @ 2021-03-11 3/week @ 2021-03-18 8/week @ 2021-03-25 12/week @ 2021-04-01 7/week @ 2021-04-08 6/week @ 2021-04-15 3/week @ 2021-04-22 4/week @ 2021-04-29 22/week @ 2021-05-06 1177/week @ 2021-05-13 19/week @ 2021-05-20 764/week @ 2021-05-27 824/week @ 2021-06-03 289/week @ 2021-06-10

51 downloads per month

MIT/Apache

18KB
223 lines

Rust MAX170xx 1-Cell/2-Cell Fuel Gauge for Lithium-ion (Li+) Batteries Driver

Build Status Coverage Status

This is a platform agnostic Rust driver for the ultra-compact, low-cost, host-side fuel-gauge systems for lithium-ion (Li+) batteries in handheld and portable equipment using the embedded-hal traits.

It is compatible with MAX17043, MAX17044, MAX17048, MAX17049, MAX17058 and MAX17059.

This driver allows you to:

  • Get state of charge. See: soc().
  • Get battery voltage. See: voltage().
  • Software reset. See: reset().
  • Quickstart. See: quickstart().
  • Get IC version. See: version().
  • Only on MAX17048/MAX17049:
    • Get charge/discharge rate. See: charge_rate().
  • Only on MAX17048/MAX17049/MAX17058/MAX17059:
    • Set table registers. See: set_table().

The devices

The devices are ultra-compact, low-cost, host-side fuel-gauge systems for lithium-ion (Li+) batteries in handheld and portable equipment. There are models configured to operate with a single or dual lithium cell pack.

The devices use a sophisticated Li+ battery-modeling scheme, called ModelGauge(TM) to track the battery's relative state-of-charge (SOC) continuously over a widely varying charge/discharge profile. Unlike traditional fuel gauges, the ModelGauge algorithm eliminates the need for battery relearn cycles and an external current-sense resistor. Temperature compensation is possible in the application with minimal interaction between a μC and the device.

The communication is done through an I2C interface.

Datasheets: MAX17043/MAX17044, MAX17048/MAX17049, MAX17058/MAX17059

Usage

To use this driver, import this crate and an embedded_hal implementation, then instantiate the device.

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

use linux_embedded_hal::I2cdev;
use max170xx::Max17043;

fn main() {
    let dev = I2cdev::new("/dev/i2c-1").unwrap();
    let mut sensor = Max17043::new(dev);
    loop {
        let soc = sensor.soc().unwrap();
        let voltage = sensor.voltage().unwrap();
        println!("Charge: {:.2}%", soc);
        println!("Voltage: {:.2}V", voltage);
    }
}

Support

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

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

~82KB