Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/eldruin/tmp006-rs

Platform agnostic Rust driver for the TMP006/TMP006B non-contact infrared (IR) thermopile temperature sensor, based on the embedded-hal traits.
https://github.com/eldruin/tmp006-rs

embedded embedded-hal embedded-hal-driver i2c ir no-std rust sensor temperature thermopile

Last synced: 18 days ago
JSON representation

Platform agnostic Rust driver for the TMP006/TMP006B non-contact infrared (IR) thermopile temperature sensor, based on the embedded-hal traits.

Host: GitHub
URL: https://github.com/eldruin/tmp006-rs
Owner: eldruin
License: apache-2.0
Created: 2018-12-02T11:40:30.000Z (about 6 years ago)
Default Branch: master
Last Pushed: 2024-02-12T08:34:22.000Z (11 months ago)
Last Synced: 2024-10-16T05:28:03.957Z (3 months ago)
Topics: embedded, embedded-hal, embedded-hal-driver, i2c, ir, no-std, rust, sensor, temperature, thermopile
Language: Rust
Size: 74.2 KB
Stars: 0
Watchers: 3
Forks: 1
Open Issues: 0
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE-APACHE

Awesome Lists containing this project

README

        # Rust TMP006/B Non-Contact Infrared (IR) Thermopile Temperature Sensor Driver

[![crates.io](https://img.shields.io/crates/v/tmp006.svg)](https://crates.io/crates/tmp006)

[![Docs](https://docs.rs/tmp006/badge.svg)](https://docs.rs/tmp006)

![Minimum Supported Rust Version](https://img.shields.io/badge/rustc-1.62+-blue.svg)

[![Build Status](https://github.com/eldruin/tmp006-rs/workflows/Build/badge.svg)](https://github.com/eldruin/tmp006-rs/actions?query=workflow%3ABuild)

[![Coverage Status](https://coveralls.io/repos/github/eldruin/tmp006-rs/badge.svg?branch=master)](https://coveralls.io/github/eldruin/tmp006-rs?branch=master)

This is a platform agnostic Rust driver for the TMP006/TMP006B non-contact

infrared (IR) thermopile temperature sensor, based on the

[`embedded-hal`] traits.

[`embedded-hal`]: https://github.com/rust-embedded/embedded-hal

This driver allows you to:

- Enable/disable the device. See: `enable()`.

- Read the object temperature. See: `read_object_temperature()`.

- Read the object voltage and ambient temperature raw data. See: `read_sensor_data()`.

- Calculate the object temperature from the sensor raw data. See: `calculate_object_temperature()`.

- Set the ADC conversion rate. See: `set_conversion_rate()`.

- Enable/disable the DRDY pin. See: `enable_drdy_pin()`.

- Read whether data is ready to be read. See: `is_data_ready()`.

- Perform a software reset. See: `reset()`.

- Read the manufacturer ID. See: `read_manufacturer_id()`.

- Read the device ID. See: `read_device_id()`.

[Introductory blog post](https://blog.eldruin.com/tmp006-contact-less-infrared-ir-thermopile-driver-in-rust/)

## The device

The TMP006 and TMP006B are the first in a series of temperature sensors

that measure the temperature of an object without the need to make contact

with the object. This sensor uses a thermopile to absorb the infrared

energy emitted from the object being measured and uses the corresponding

change in thermopile voltage to determine the object temperature.

Infrared sensor voltage range is specified from -40°C to +125°C to enable

use in a wide range of applications. Low power consumption along with low

operating voltage makes the device suitable for battery-powered

applications. The low package height of the chip-scale format enables

standard high- volume assembly methods, and can be useful where limited

spacing to the object being measured is available.

Datasheet:

- [TMP006/B](https://media.digikey.com/pdf/Data%20Sheets/Texas%20Instruments%20PDFs/TMP006(B).pdf)

User guide:

- [TMP006 user guide](https://cdn-shop.adafruit.com/datasheets/tmp006ug.pdf)

## Usage example

To use this driver, import this crate and an `embedded_hal` implementation,

then instantiate the device.

Please find additional examples in this repository: [driver-examples]

[driver-examples]: https://github.com/eldruin/driver-examples

```rust

use linux_embedded_hal::I2cdev;

use nb::block;

use tmp006::{SlaveAddr, Tmp006};

fn main() {

    let dev = I2cdev::new("/dev/i2c-1").unwrap();

    let address = SlaveAddr::default();

    let mut sensor = Tmp006::new(dev, address);

    let calibration_factor = 6e-14;

    let temperature = block!(sensor

        .read_object_temperature(calibration_factor))

        .unwrap();

    println!("Temperature: {}K", temperature);

}

```

## Support

For questions, issues, feature requests, and other changes, please file an

[issue in the github project](https://github.com/eldruin/tmp006-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.