45 lines
982 B
Markdown
45 lines
982 B
Markdown
|
# DHT11 Python library
|
||
|
|
||
|
This simple class can be used for reading temperature and humidity values from DHT11 sensor on Raspberry Pi.
|
||
|
|
||
|
# Installation
|
||
|
|
||
|
To install, just run following:
|
||
|
|
||
|
```
|
||
|
pip install dht11
|
||
|
```
|
||
|
|
||
|
# Usage
|
||
|
|
||
|
1. Instantiate the `DHT11` class with the pin number as constructor parameter.
|
||
|
2. Call `read()` method, which will return `DHT11Result` object with actual values and error code.
|
||
|
|
||
|
For example:
|
||
|
|
||
|
```python
|
||
|
import RPi.GPIO as GPIO
|
||
|
import dht11
|
||
|
|
||
|
# initialize GPIO
|
||
|
GPIO.setwarnings(False)
|
||
|
GPIO.setmode(GPIO.BCM)
|
||
|
GPIO.cleanup()
|
||
|
|
||
|
# read data using pin 14
|
||
|
instance = dht11.DHT11(pin = 14)
|
||
|
result = instance.read()
|
||
|
|
||
|
if result.is_valid():
|
||
|
print("Temperature: %-3.1f C" % result.temperature)
|
||
|
print("Humidity: %-3.1f %%" % result.humidity)
|
||
|
else:
|
||
|
print("Error: %d" % result.error_code)
|
||
|
```
|
||
|
|
||
|
For working example, see `dht11_example.py` (you probably need to adjust pin for your configuration)
|
||
|
|
||
|
# License
|
||
|
|
||
|
This project is licensed under the terms of the MIT license.
|