Introduction

Documentation Status Gitter

CircuitPython support for the DHT11 and DHT22 temperature and humidity devices.

Dependencies

This driver depends on:

Please ensure all dependencies are available on the CircuitPython filesystem. This is easily achieved by downloading the Adafruit library and driver bundle.

Usage Example

Hardware Set-up

The DHT11 and DHT22 devices both need a pull-resistor on the data signal wire. This resistor is in the range of 1k to 5k. Please check your device datasheet for the appropriate value.

Basics

Of course, you must import the library to use it:

import adafruit_dht

The DHT type devices use single data wire, so import the board pin

from board import <pin>

Now, to initialize the DHT11 device:

dht_device = adafruit_dht.DHT11(<pin>)

OR initialize the DHT22 device:

dht_device = adafruit_dht.DHT22(<pin>)

Read temperature and humidity

Now get the temperature and humidity values

temperature = dht_device.temperature
humidity = dht_device.humidity

These properties may raise an exception if a problem occurs. You should use try/raise logic and catch RuntimeError and then retry getting the values after 1/2 second.

Contributing

Contributions are welcome! Please read our Code of Conduct before contributing to help this project stay welcoming.