5 unstable releases

0.3.1 Oct 21, 2024
0.3.0 Mar 8, 2024
0.2.1 Oct 27, 2023
0.1.1 Feb 5, 2023

#348 in Embedded development

Download history 14/week @ 2024-07-29 171/week @ 2024-08-05 113/week @ 2024-08-12 62/week @ 2024-08-19 87/week @ 2024-08-26 55/week @ 2024-09-02 48/week @ 2024-09-09 79/week @ 2024-09-16 225/week @ 2024-09-23 78/week @ 2024-09-30 179/week @ 2024-10-07 385/week @ 2024-10-14 234/week @ 2024-10-21 36/week @ 2024-10-28

837 downloads per month

MIT license

25KB
548 lines

SHT31-rs   Build Status Latest Version

A cargo library for the SHT31 temperature / humidity sensors


Usage

The default sensor usage includes a blocking sensor read that blocks the current thread until the sensor does a reading.

use sht31::prelude::*;

fn main() -> Result<()> {
    // Requires an i2c connection + delay (both from embedded_hal 1.x.x)
    let sht = SHT31::new(i2c, delay);
    
    loop {
        let reading = sht.read()?;
    }
}

Advanced Single Shot Usage

Breaks down the simple usage into two commands, one where the sensor is notified to start reading and another where the reading is requested

use sht31::prelude::*;

fn main() -> Result<()> {
    // i2c setup
    
    // Use single shot, with high accuracy, an alternate I2C address 
    // and return temp data in Fahrenheit
    let sht = SHT31::new(i2c)
        .with_mode(SingleShot::new())
        .with_accuracy(Accuracy::High)
        .with_unit(TemperatureUnit::Fahrenheit)
        .with_address(DeviceAddr::AD1);

    loop {
        // Start measuring before you need the reading, 
        // this is more efficient than waiting for readings
        sht.measure()?;

        // Some other code here...

        let reading = sht.read()?;
    }
}

Periodic Usage

Periodic mode continually reads data at a rate of the given measurements per second (MPS) and at a quality of the given Accuracy. This means that you dont have to worry about running SHT31::measure() every time you want to read data

use sht31::prelude::*;

fn main() -> Result<()> {
    // i2c setup
    
    // In periodic mode, the sensor keeps updating the reading
    // without needing to measure
    let mut sht = SHT31::new(sht_i2c)
        .with_mode(Periodic::new().with_mps(MPS::Normal))
        .with_accuracy(Accuracy::High);
    
    // Trigger the measure before running your loop to initialize the periodic mode
    sht.measure()?;
    
    loop {
        let reading = sht.read()?;
    }
}

Periodic with Accelerated Response Time

Periodic mode has a unique mode that allows the sensor to read data at 4Hz

use sht31::prelude::*;

fn main() -> Result<()> {
    
    // Makes the sensor acquire the data at 4 Hz
    let mut sht = SHT31::new(sht_i2c)
        .with_mode(Periodic::new().with_art());
    sht.measure()?;
    
    loop {
        let reading = sht.read()?;
    }
}

Mode switching

This crate also supports more complex case scenarios where you might want to switch between period to single shot for example

use sht31::prelude::*;

fn main() -> Result<()> {
    // i2c setup
    
    let mut sht = SHT31::new(sht_i2c)
        .with_mode(Periodic::new());
    
    // Trigger the measure before running your loop to initialize the periodic mode
    sht.measure()?;
    
    // Do a periodic read
    let reading = sht.read()?;
    
    // Cancel the currently running command (periodic)
    sht.break_command()?;
    
    sht = sht.with_mode(SingleShot::new());
    
    sht.measure()?;
    
    let new_reading = sht.read()?;
}

Dependencies

~155–270KB