DHT Sensor

The dht sensor platform allows you to get the current temperature and humidity from a DHT11, DHT22 or AM2302 device.


To use your DHTxx sensor in your installation, you must first install the libgpiod2 library.

sudo apt install libgpiod2


Add the following to your configuration.yaml file:

# Example configuration.yaml entry
  platform: dht
  sensor: DHT22
  pin: 23
    - temperature
    - humidity

Configuration Variables

sensor string Required

The sensor type, supported devices are DHT11, DHT22 and AM2302.

pin integer Required

The pin the sensor is connected to.

name string (Optional, default: DHT Sensor)

The name of the sensor.

monitored_conditions list Required

Conditions to monitor. Available conditions are only temperature and humidity.


Temperature at the sensor’s location.


Humidity level at the sensor’s location.

temperature_offset integer | float (Optional, default: 0)

Add or subtract a value from the temperature.

humidity_offset integer | float (Optional, default: 0)

Add or subtract a value from the humidity.

The name of the pin to which the sensor is connected has different names on different platforms. ‘P8_11’ for Beaglebone, ‘23’ for Raspberry Pi.


An example for a Raspberry Pi 3 with a DHT22 sensor connected to GPIO4 (pin 7):

  - platform: dht
    sensor: DHT22
    pin: 4
    temperature_offset: 2.1
    humidity_offset: -3.2
      - temperature
      - humidity