AHT20-driver

Rust embedded-HAL driver for the AHT20 temperature and humidity sensor.

You can read my blog post AHT20 thermometer driver which details the creation of this driver.

Example

There is an example app for the Blue Pill board in the examples/blue_pill/ directory. You can run that with cargo run --release. It will read the temperature and humidity and print it the console.

How to use

Using the AHT20 driver in your own project should be possible with any platform that supports the embedded-HAL. See awesome-embedded-rust for a list of supported platforms. I've used this driver with the stm32f103, aka. the Blue Pill board.

In order to use the aht20-driver you'll need to configure an I2C device that implements the embedded HAL blocking I2C traits. You'll also need a delay device that implements the embedded HAL blocking delay traits.

The example in this repository shows an example for the Blue Pill board. Once you have those configured - pass those to the AHT20::new method to create the device driver. You will need to call the init method on it, which will calibrate the sensor and return a new struct with methods for measuring and resetting the sensor.

Once calibrated you can call the measure method which will return a measurement containing temperature and humidity values in relative humidity %, and degrees Celsius.

// Configure the AHT20 temperature and humidity sensor.
let mut aht20_uninit = aht20_driver::AHT20::new(i2c, aht20_driver::SENSOR_ADDRESS);
let mut aht20 = aht20_uninit.init(&mut delay).unwrap();

// Take the temperature and humidity measurement.
let aht20_measurement = aht20.measure(&mut delay).unwrap();

rprintln!("temperature (aht20): {:.2}C", aht20_measurement.temperature);
rprintln!("humidity (aht20): {:.2}%", aht20_measurement.humidity);

Contributing

Please open an issue, start a conversation under discussions, or submit a pull request - all are welcome.

I'd love to know if you're using the driver, and I'd like to link to your projects so that others can learn from them.

License

aht20-driver is distributed under the terms of both the MIT License and the Apache License 2.0.

See the LICENSE-APACHE and LICENSE-MIT files for license details.