Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/eldruin/tmp1x2-rs
Platform-agnostic Rust driver for the TMP102 and TMP112 digital temperature sensors
https://github.com/eldruin/tmp1x2-rs
driver embedded embedded-hal embedded-hal-driver i2c no-std rust sensor temperature temperature-sensor
Last synced: 3 months ago
JSON representation
Platform-agnostic Rust driver for the TMP102 and TMP112 digital temperature sensors
- Host: GitHub
- URL: https://github.com/eldruin/tmp1x2-rs
- Owner: eldruin
- License: apache-2.0
- Created: 2018-10-24T20:44:55.000Z (about 6 years ago)
- Default Branch: master
- Last Pushed: 2024-02-08T08:52:44.000Z (12 months ago)
- Last Synced: 2024-10-16T05:29:15.820Z (3 months ago)
- Topics: driver, embedded, embedded-hal, embedded-hal-driver, i2c, no-std, rust, sensor, temperature, temperature-sensor
- Language: Rust
- Homepage: https://blog.eldruin.com/tmp1x2-temperature-sensor-driver-in-rust/
- Size: 69.3 KB
- Stars: 10
- 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 TMP102 and TMP112 Temperature Sensor Driver
[](https://crates.io/crates/tmp1x2)
[](https://docs.rs/tmp1x2)
[](https://github.com/eldruin/tmp1x2-rs/actions?query=workflow%3ABuild)
[](https://coveralls.io/github/eldruin/tmp1x2-rs?branch=master)
This is a platform agnostic Rust driver for the TMP102 and TMP112
high-accuracy, low-power, digital temperature sensors, using the
[`embedded-hal`] traits.
This driver allows you to:
- Change into one-shot or continuous conversion mode.
- Read the temperature.
- Enable/disable the extended measurement mode.
- Trigger a one-shot measurement.
- Read whether the one-shot measurement result is ready.
- Set the conversion rate.
- Set the high/low temperature threshold.
- Set the fault queue.
- Set the alert polarity.
- Set the thermostat mode.
- Read whether a comparator mode alert is active.
[Introductory blog post](https://blog.eldruin.com/tmp1x2-temperature-sensor-driver-in-rust/)
## The devices
This driver is compatible with both the TMP102 device as well as the TMP112
family of devices, including TMP112A, TMP112B and TMP112N.
These temperature sensors are highly linear and do not require complex
calculations or lookup tables to derive the temperature. The on-chip
12-bit ADC offers resolutions down to 0.0625°C.
The TMP102 device is a digital temperature sensor ideal for NTC/PTC
thermistor replacement where high accuracy is required. The device offers an
accuracy of +/-0.5°C without requiring calibration or external component
signal conditioning.
The TMP112 family of devices are digital temperature sensors designed for
high-accuracy, low-power, NTC/PTC thermistor replacements where high accuracy
is required. The TMP112A and TMP112B offers 0.5°C accuracy and are optimized
to provide the best PSR performance for 3.3V and 1.8V operation respectively,
while TMP112N offers 1°C accuracy.
The devices feature SMBus(TM), two-wire and I2C interface compatibility,
and allows up to four devices on one bus.
Datasheets:
- [TMP102](http://www.ti.com/lit/ds/symlink/tmp102.pdf)
- [TMP112x](http://www.ti.com/lit/ds/symlink/tmp112.pdf)
### Usage
Please find additional examples using hardware in this repository: [driver-examples]
```rust
use linux_embedded_hal::I2cdev;
use tmp1x2::{Tmp1x2, SlaveAddr};
fn main() {
let dev = I2cdev::new("/dev/i2c-1").unwrap();
let address = SlaveAddr::default();
let mut sensor = Tmp1x2::new(dev, address);
let temperature = sensor.read_temperature().unwrap();
println!("Temperature: {:.1}ºC", temperature);
}
```
## Support
For questions, issues, feature requests, and other changes, please file an
[issue in the github project](https://github.com/eldruin/tmp1x2-rs/issues).
## License
Licensed under either of
* Apache License, Version 2.0 ([LICENSE-APACHE](LICENSE-APACHE) or
http://www.apache.org/licenses/LICENSE-2.0)
* MIT license ([LICENSE-MIT](LICENSE-MIT) or
http://opensource.org/licenses/MIT)
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.
[driver-examples]: https://github.com/eldruin/driver-examples
[`embedded-hal`]: https://github.com/rust-embedded/embedded-hal