Rust embedded-HAL driver for the AHT20 temperature and humidity sensor.
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.
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.
```rust // Configure the AHT20 temperature and humidity sensor. let mut aht20uninit = aht20driver::AHT20::new(i2c, aht20driver::SENSORADDRESS); 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", aht20measurement.temperature); rprintln!("humidity (aht20): {:.2}%", aht20measurement.humidity); ```
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.
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.