Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/eldruin/lm75-rs
Platform-agnostic Rust driver for the LM75 temperature sensor and thermal watchdog.
https://github.com/eldruin/lm75-rs
driver embedded embedded-hal embedded-hal-driver i2c no-std rust sensor temperature temperature-sensor watchdog
Last synced: 2 months ago
JSON representation
Platform-agnostic Rust driver for the LM75 temperature sensor and thermal watchdog.
- Host: GitHub
- URL: https://github.com/eldruin/lm75-rs
- Owner: eldruin
- License: apache-2.0
- Created: 2018-10-14T18:06:27.000Z (about 6 years ago)
- Default Branch: master
- Last Pushed: 2024-01-18T08:17:06.000Z (12 months ago)
- Last Synced: 2024-10-16T05:28:12.873Z (3 months ago)
- Topics: driver, embedded, embedded-hal, embedded-hal-driver, i2c, no-std, rust, sensor, temperature, temperature-sensor, watchdog
- Language: Rust
- Size: 54.7 KB
- Stars: 5
- Watchers: 3
- Forks: 3
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE-APACHE
Awesome Lists containing this project
README
# Rust LM75 Temperature Sensor and Thermal Watchdog Driver
[](https://crates.io/crates/lm75)
[](https://docs.rs/lm75)
[](https://github.com/eldruin/lm75-rs/actions?query=workflow%3ABuild)
[](https://coveralls.io/github/eldruin/lm75-rs?branch=master)
This is a platform agnostic Rust driver for the LM75 temperature sensor and thermal watchdog, based on the
[`embedded-hal`](https://github.com/rust-embedded/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.
- Set the sample rate of temperature measurements (PCT2075 only)
## 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:
- [LM75](https://datasheets.maximintegrated.com/en/ds/LM75.pdf)
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], [PCT2075].
[AT30TS75A]: http://ww1.microchip.com/downloads/en/DeviceDoc/Atmel-8839-DTS-AT30TS75A-Datasheet.pdf
[DS1775]: https://datasheets.maximintegrated.com/en/ds/DS1775-DS1775R.pdf
[DS75]: https://datasheets.maximintegrated.com/en/ds/DS75.pdf
[DS7505]: https://datasheets.maximintegrated.com/en/ds/DS7505.pdf
[G751]: http://www.gmt.com.tw/product/datasheet/EDS-751.pdf
[LM75A]: https://www.nxp.com/docs/en/data-sheet/LM75A.pdf
[LM75B, LM75C]: http://www.ti.com/lit/ds/symlink/lm75b.pdf
[MAX6625]: https://datasheets.maximintegrated.com/en/ds/MAX6625-MAX6626.pdf
[MAX7500/1/2/3/4]: https://datasheets.maximintegrated.com/en/ds/MAX7500-MAX7504.pdf
[MCP9800/1/2/3]: http://ww1.microchip.com/downloads/en/DeviceDoc/21909d.pdf
[STDS75]: https://www.st.com/resource/en/datasheet/stds75.pdf
[TCN75]: http://ww1.microchip.com/downloads/en/DeviceDoc/21490D.pdf
[PCT2075]: https://www.nxp.com/docs/en/data-sheet/PCT2075.pdf
### Usage
Please find additional examples using hardware in this repository: [driver-examples]
[driver-examples]: https://github.com/eldruin/driver-examples
```rust
use linux_embedded_hal::I2cdev;
use lm75::{Lm75, Address};
fn main() {
let dev = I2cdev::new("/dev/i2c-1").unwrap();
let address = Address::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, as well as if you
are interested in supporting a similar sensor, please file an
[issue in the github project](https://github.com/eldruin/lm75-rs/issues).
## Minimum Supported Rust Version (MSRV)
This crate is guaranteed to compile on stable Rust 1.62 and up. It *might*
compile with older versions but that may change in any new patch release.
The MSRV will not be updated in any patch release.
## License
Licensed under either of
* Apache License, Version 2.0 ([LICENSE-APACHE](LICENSE-APACHE) or
)
* MIT license ([LICENSE-MIT](LICENSE-MIT) or
)
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.