Crate lm75[][src]

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 LM75A, LM75B and LM75C: LM75B/C Datasheet

And also at least with the devices MAX7500, MAX6625, MAX6626, DS75LV, and DS7505.

Usage examples (see also examples folder)

Read temperature

Import this crate and an embedded_hal implementation, then instantiate the device:

extern crate linux_embedded_hal as hal;
extern crate lm75;

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

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

Provide an alternative address

extern crate linux_embedded_hal as hal;
extern crate lm75;

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

let dev = I2cdev::new("/dev/i2c-1").unwrap();
let (a2, a1, a0) = (false, false, true);
let address = SlaveAddr::Alternative(a2, a1, a0);
let mut sensor = Lm75::new(dev, address);

Set the fault queue

This is the number of consecutive faults necessary to trigger an OS condition.

extern crate linux_embedded_hal as hal;
extern crate lm75;

use hal::I2cdev;
use lm75::{ Lm75, SlaveAddr, FaultQueue };

let dev = I2cdev::new("/dev/i2c-1").unwrap();
let mut sensor = Lm75::new(dev, SlaveAddr::default());
sensor.set_fault_queue(FaultQueue::_4).unwrap();

Set the OS polarity

extern crate linux_embedded_hal as hal;
extern crate lm75;

use hal::I2cdev;
use lm75::{ Lm75, SlaveAddr, OsPolarity };

let dev = I2cdev::new("/dev/i2c-1").unwrap();
let mut sensor = Lm75::new(dev, SlaveAddr::default());
sensor.set_os_polarity(OsPolarity::ActiveHigh).unwrap();

Set the OS operation mode

extern crate linux_embedded_hal as hal;
extern crate lm75;

use hal::I2cdev;
use lm75::{ Lm75, SlaveAddr, OsMode };

let dev = I2cdev::new("/dev/i2c-1").unwrap();
let mut sensor = Lm75::new(dev, SlaveAddr::default());
sensor.set_os_mode(OsMode::Interrupt).unwrap();

Set the OS temperature

extern crate linux_embedded_hal as hal;
extern crate lm75;

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

let dev = I2cdev::new("/dev/i2c-1").unwrap();
let mut sensor = Lm75::new(dev, SlaveAddr::default());
sensor.set_os_temperature(50.0).unwrap();

Set the hysteresis temperature

extern crate linux_embedded_hal as hal;
extern crate lm75;

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

let dev = I2cdev::new("/dev/i2c-1").unwrap();
let mut sensor = Lm75::new(dev, SlaveAddr::default());
sensor.set_hysteresis_temperature(40.0).unwrap();

Enable / disable the sensor

extern crate linux_embedded_hal as hal;
extern crate lm75;

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

let dev = I2cdev::new("/dev/i2c-1").unwrap();
let mut sensor = Lm75::new(dev, SlaveAddr::default());
sensor.disable().unwrap(); // shutdown
sensor.enable().unwrap();

Structs

Lm75

LM75 device driver.

Enums

Error

All possible errors in this crate

FaultQueue

Fault queue

OsMode

OS operation mode

OsPolarity

OS polarity

SlaveAddr

Possible slave addresses