aht30

Better AHT10 / AHT20 / AHT30 / AHT40 humidity temperature sensor driver, for rust embedded-hal, optional async.

• Flexable design: configurable I2C address, enable / disable checksum.
• Optional async: enable the async feature, can be used with embassy.
• Friendly for no-FPU platform: allow read raw u32 or u16 value.
• Correct and sound: follow official datasheet and routine. Already tested on real hardware.

Example

AHT10 async

use aht30::{AHT10_DEFAULT_ADDR, Aht10Async};
use embassy_time::{Delay, Timer};
use esp_hal::i2c::master::I2c; // or whatever any embedded-hal i2c, like ch32-hal, stm32f4xx-hal, and linux-embedded-hal
let i2c = I2c::new(peripherals.I2C0, Default::default())?
    .with_sda(peripherals.GPIO4)
    .with_scl(peripherals.GPIO5)
    .into_async();
let mut aht10 = Aht10Async::new(AHT10_DEFAULT_ADDR, i2c, Delay); 
aht10.calibrate().await?; // do calibrate is recommended
let (humidity, temperature) = aht10.read().await?.decode(); // aht10 has no checksum support
// example output: humidity = 67.25 %, temperature = 23.75 °C
info!("humidity = {} %, temperature = {} °C", humidity, temperature);
// read raw value without calc decode formula
let humidity_raw = aht10.read().await?.humidity_raw; 

AHT10 sync

use aht30::{AHT10_DEFAULT_ADDR, Aht10};
use esp_hal::delay::Delay;
use esp_hal::i2c::master::I2c;
let i2c = I2c::new(peripherals.I2C0, Default::default())?
    .with_sda(peripherals.GPIO4)
    .with_scl(peripherals.GPIO5);
let mut aht10 = Aht10::new(AHT10_DEFAULT_ADDR, i2c, Delay);
aht10.calibrate()?;
let (humidity, temperature) = aht10.read()?.decode();

AHT20 / AHT25 / AHT30, async

For sync usage, see aht10 example. Just remove Async suffix in name.

use aht30::{AHT20_DEFAULT_ADDR, Aht20Async};
let mut aht20 = Aht20Async::new(AHT20_DEFAULT_ADDR, i2c, Delay);
aht20.calibrate().await?; // do calibrate may not be required for models manufactured after 2022, but still recommended
let (humidity, temperature) = aht20.read(true).await?.decode(); // enable checksum is recommended

AHT40, async

use aht30::{AHT40_DEFAULT_ADDR, Aht40Async}; // it has different i2c address
let mut aht40 = Aht40Async::new(AHT40_DEFAULT_ADDR, i2c, Delay);
// aht40 has no calibrate function
let (humidity, temperature) = aht40.read(true).await?.decode(); // enable checksum is recommended