DHT
DHT
humidity sensors and thermistors to measure the surrounding air. They feature a chip that
handles analog to digital conversion and provide a 1-wire interface. Newer sensors additionally
provide an I2C interface.
The DHT11 (blue) and DHT22 (white) sensors provide the same 1-wire interface, however, the
DHT22 requires a separate object as it has more complex calculation. DHT22 have 1 decimal
place resolution for both humidity and temperature readings. DHT11 have whole number for
both.
A custom 1-wire protocol, which is different to Dallas 1-wire, is used to get the measurements
from the sensor. The payload consists of a humidity value, a temperature value and a checksum.
To use the 1-wire interface, construct the objects referring to their data pin:
>>> d = dht.DHT11(machine.Pin(4))
>>> d.measure()
>>> d.temperature()
>>> d.humidity()
>>> d = dht.DHT22(machine.Pin(4))
Values returned from temperature() are in degrees Celsius and values returned from humidity()
are a percentage of relative humidity.
The DHT11 can be called no more than once per second and the DHT22 once every two seconds
for most accurate results. Sensor accuracy will degrade over time. Each sensor supports a
different operating range. Refer to the product datasheets for specifics.
In 1-wire mode, only three of the four pins are used and in I2C mode, all four pins are used.
Older sensors may still have 4 pins even though they do not support I2C. The 3rd pin is simply
not connected.
Pin configurations:
Sensor without I2C in 1-wire mode (eg. DHT11, DHT22, AM2301, AM2302):
Sensor with I2C in I2C mode (eg. DHT12, AM2320, AM2321, AM2322):
You should use pull-up resistors for the Data, SDA and SCL pins.
To make newer I2C sensors work in backwards compatible 1-wire mode, you must connect both
pins 3 and 4 to GND. This disables the I2C interface.
DHT22 sensors are now sold under the name AM2302 and are otherwise identical.