richardzone / homeassistant-dht

Support for Adafruit DHT temperature and humidity sensor
Apache License 2.0
10 stars 7 forks source link
dht dht11 dht22 home-assistant iot raspberry-pi

Home Assistant DHT temperature and humidity sensor

This is a spin-off from the official home assitant DHT integration, which was removed since Home Assistant Core version 2022.4.0.

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

Installation

HACS

The recommend way to install dht is through HACS.

Manual installation

Copy the dht folder and all of its contents into your Home Assistant's custom_components folder. This folder is usually inside your /config folder. If you are running Hass.io, use SAMBA to copy the folder over. You may need to create the custom_components folder and then copy the dht folder and all of its contents into it.

Setup

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

sudo apt install libgpiod2

Configuration

Add the following to your configuration.yaml file:

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

Full confirguration reference below:

sensor:
  description: The sensor type, supported devices are DHT11, DHT22 and AM2302.
  required: true
  type: string
pin:
  description: The pin the sensor is connected to.
  required: true
  type: integer
name:
  description: The name of the sensor.
  required: false
  default: DHT Sensor
  type: string
monitored_conditions:
  description: Conditions to monitor. Available conditions are only *temperature* and *humidity*.
  required: true
  type: list
  keys:
    temperature:
      description: Temperature at the sensor's location.
    humidity:
      description: Humidity level at the sensor's location.
temperature_offset:
  description: Add or subtract a value from the temperature.
  required: false
  default: 0
  type: [integer, float]
humidity_offset:
  description: Add or subtract a value from the humidity.
  required: false
  default: 0
  type: [integer, float]

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.

Example

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

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

Credits

Original contributors