mirror of
https://github.com/home-assistant/home-assistant.io.git
synced 2025-05-30 23:06:49 +00:00
1833c32a2c
* Sets front matter defaults * Removes default front matter from section templates/pages * Removes default front matter from addon pages * Removes default front matter from integration pages * Removes default front matter from posts * Removes default front matter from docs pages * Removes default front matter from other pages * Fixes blog category pages
83 lines
1.9 KiB
Markdown
83 lines
1.9 KiB
Markdown
---
|
|
title: "DHT Sensor"
|
|
description: "Instructions on how to integrate DHTxx sensors within Home Assistant."
|
|
ha_category:
|
|
- DIY
|
|
ha_release: 0.7
|
|
logo: dht.png
|
|
ha_iot_class: Local Polling
|
|
redirect_from:
|
|
- /components/sensor.dht/
|
|
---
|
|
|
|
|
|
The `dht` sensor platform allows you to get the current temperature and humidity from a DHT11, DHT22 or AM2302 device.
|
|
|
|
## Configuration
|
|
|
|
To use your DHTxx sensor in your installation, add the following to your `configuration.yaml` file:
|
|
|
|
```yaml
|
|
# Example configuration.yaml entry
|
|
sensor:
|
|
platform: dht
|
|
sensor: DHT22
|
|
pin: 23
|
|
monitored_conditions:
|
|
- temperature
|
|
- humidity
|
|
```
|
|
|
|
{% configuration %}
|
|
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]
|
|
{% endconfiguration %}
|
|
|
|
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):
|
|
|
|
```yaml
|
|
sensor:
|
|
- platform: dht
|
|
sensor: DHT22
|
|
pin: 4
|
|
temperature_offset: 2.1
|
|
humidity_offset: -3.2
|
|
monitored_conditions:
|
|
- temperature
|
|
- humidity
|
|
```
|