#temperature #sensor #i2c #driver #embedded-hal-driver

no-std lm75

Platform-agnostic Rust driver for the LM75 temperature sensor and thermal watchdog

3 releases

0.1.2 Jan 30, 2021
0.1.1 Oct 20, 2018
0.1.0 Oct 19, 2018

#449 in Embedded development

Download history 15/week @ 2021-02-25 10/week @ 2021-03-04 13/week @ 2021-03-11 7/week @ 2021-03-18 22/week @ 2021-03-25 18/week @ 2021-04-01 16/week @ 2021-04-08 26/week @ 2021-04-15 13/week @ 2021-04-22 13/week @ 2021-04-29 27/week @ 2021-05-06 32/week @ 2021-05-13 22/week @ 2021-05-20 15/week @ 2021-05-27 10/week @ 2021-06-03 13/week @ 2021-06-10

75 downloads per month
Used in bitbang-hal

MIT/Apache

25KB
326 lines

Rust LM75 Temperature Sensor and Thermal Watchdog Driver

crates.io Docs Build Status Coverage Status

This is a platform agnostic Rust driver for the LM75 temperature sensor and thermal watchdog, based on the embedded-hal traits.

This driver allows you to:

  • Enable/disable the device.
  • Read the temperature.
  • Set the fault queue.
  • Set the OS temperature.
  • Set the hysteresis temperature.
  • Set the OS operation mode.
  • Set the OS polarity.

The device

The LM75 temperature sensor includes a delta-sigma analog-to-digital converter, and a digital overtemperature detector. The host can query the LM75 through its I2C interface to read temperature at any time. The open-drain overtemperature output (OS) sinks current when the programmable temperature limit is exceeded. The OS output operates in either of two modes, comparator or interrupt. The host controls the temperature at which the alarm is asserted (TOS) and the hysteresis temperature below which the alarm condition is not valid (THYST). Also, the LM75's TOS and THYST registers can be read by the host. The address of the LM75 is set with three pins to allow multiple devices to work on the same bus. Power-up is in comparator mode, with defaults of TOS= +80ºC and THYST= +75ºC. The 3.0V to 5.5V supply voltage range, low supply current, and I2C interface make the LM75 ideal for many applications in thermal management and protection.

Datasheet:

This driver is also compatible with at least LM75A, LM75B, LM75C, AT30TS75A, DS1775, DS75, DS7505, G751, MAX7500/1/2/3/4, MAX6625, MCP9800/1/2/3, STDS75, TCN75.

Usage

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

use linux_embedded_hal::I2cdev;
use lm75::{Lm75, SlaveAddr};

fn main() {
    let dev = I2cdev::new("/dev/i2c-1").unwrap();
    let address = SlaveAddr::default();
    let mut sensor = Lm75::new(dev, address);
    let temp_celsius = sensor.read_temperature().unwrap();
    println!("Temperature: {}ºC", temp_celsius);
}

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