Skip to content

Commit a67d086

Browse files
committed
add AHT1x
1 parent e3dd63d commit a67d086

File tree

7 files changed

+55
-2
lines changed

7 files changed

+55
-2
lines changed

docs/AHT1x.md

Lines changed: 50 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,50 @@
1+
# AHT1x temperature and humidity sensor
2+
!!! info "This feature is included only in tasmota-sensors.bin"
3+
4+
Otherwise you must [compile your build](Compile-your-build). Add the following to `user_config_override.h`:
5+
```
6+
#ifndef USE_AHT1x
7+
#define USE_AHT1x // [I2cDriver43] Enable AHT10/15 humidity and temperature sensor (I2C address 0x38) (+0k8 code)
8+
#endif
9+
```
10+
----
11+
12+
AHT10 or AH15 are an I<sup>2</sup>C temperature and humidity sensor.
13+
14+
## Configuration
15+
16+
!!! failure "This sensor is incompatible with other I^2^C devices on I^2^C bus"
17+
Sensor datasheet implicitly says:
18+
**Only a single** AHT10 can be connected to the I^2^C bus and no other I^2^C devices can be connected.
19+
20+
### Wiring
21+
| AHT1x | ESP8266 |
22+
|---|---|
23+
|VCC |3.3V
24+
|GND |GND
25+
|SDA | GPIOx
26+
|SCL | GPIOy
27+
28+
The driver currently only allows the use of a single LM75AD sensor on any of the addresses configurable through pins A0, A1 and A2. These are conveniently broken out on the breakout board either as pins or as solderable joints as can be seen on the example breakout board.
29+
30+
### Tasmota Settings
31+
In the _Configuration -> Configure Module_ page assign:
32+
1. GPIOx to `I2C SDA (6)`
33+
2. GPIOy to `I2C SCL (5)`
34+
35+
After a reboot the driver will detect AHT1x automatically and display sensor readings.
36+
37+
![webUI readout](_media/peripherals/aht1x-readout.jpg)
38+
39+
and in MQTT topic (according to TelePeriod):
40+
```
41+
{"Time":"2020-01-01T00:00:00","AHT1X-0x38":{"Temperature":24.7,"Humidity":61.9,"DewPoint":16.8},"TempUnit":"C"}
42+
```
43+
44+
45+
### Breakout Boards
46+
47+
![AHT10](_media/peripherals/AHT10.jpg)![AHT15](_media/peripherals/AHT15.jpg)
48+
49+
[AHT10 Datasheet](https://server4.eca.ir/eshop/AHT10/Aosong_AHT10_en_draft_0c.pdf)
50+
[AHT15 Datasheet](https://wiki.liutyi.info/download/attachments/35291280/Aosong_AHT15_en_draft_0.pdf?version=1&modificationDate=1563622682730&api=v2)

docs/IAQ.md

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -46,7 +46,9 @@ When warm-up is finished, sensor will show readings in web UI:
4646
![webUI readout](_media/peripherals/iaq-readout.jpg)
4747

4848
and in MQTT topic (according to TelePeriod):
49-
`MQT: tele/tasmota_29803A/SENSOR = {"Time":"2020-04-11T11:57:14","IAQ":{"eCO2":450,"TVOC":125,"Resistance":76827}}`
49+
```
50+
{"Time":"2020-01-01T00:00:00","IAQ":{"eCO2":450,"TVOC":125,"Resistance":76827}}
51+
```
5052

5153
## Usage
5254
Typical sensor reading should be around 450 ppm eCO2 and 125 ppb TVOC. Resistance is sensor's gas resistance in Ohm and is the baseline reading from which eCO2 and TVOC are calculated from

docs/Supported-Peripherals.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ Name|Description
44
[**A4988**](A4988-Stepper-Motor-Controller)|Stepper Motor Controller
55
[**ADC**](ADC) | Analog input over A0 pin
66
**ADS1x15** | A/D Converter
7-
**AHT10<BR>AHT15** | Asair AHT10 / AHT15 Temperature and Humidity Sensor (I^2^C)
7+
[**AHT10<BR>AHT15**](AHT1x.md) | Asair AHT10 / AHT15 Temperature and Humidity Sensor (I^2^C)
88
[**AM2301 (DHT21)<BR>AM2302 (DHT22)<BR>AM2321**](AM2301) | Temperature and Humidity Sensor (gpio)
99
[**AS3935**](https://github.com/arendst/Tasmota/pull/8130) | Franklin Lightning sensor (I^2^C)
1010
[**APDS-9960**](APDS-9960) | Ambient Light, RGB Color and Proximity Sensor with Gesture Detection

docs/_media/peripherals/AHT10.jpg

16.4 KB
Loading

docs/_media/peripherals/AHT15.jpg

10.1 KB
Loading
3.08 KB
Loading

mkdocs.yml

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -118,6 +118,7 @@ nav:
118118
- Buzzer.md
119119
- Displays.md
120120
- A4988 stepper motor controller: A4988-Stepper-Motor-Controller.md
121+
- AHT1x.md
121122
- AM2301 temperature and humidity sensor: AM2301.md
122123
- APDS-9960.md
123124
- AZ-7798.md

0 commit comments

Comments
 (0)