aht30 1.0.1

Better AHT10 / AHT20 / AHT30 / AHT40 humidity temperature sensor driver, for rust embedded-hal, optional async.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63

# 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](https://github.com/embassy-rs/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

```rust
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

```rust
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.

```rust
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

```rust
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
```