mirror of
https://github.com/adafruit/DHT-sensor-library.git
synced 2023-10-23 22:20:38 +03:00
Limor "Ladyada" Fried
GitHub
commit
db1a7943d4
13
CONTRIBUTING.md
Normal file
13
CONTRIBUTING.md
Normal file
@ -0,0 +1,13 @@
|
||||
# Contribution Guidlines
|
||||
|
||||
This library is the culmination of the expertise of many members of the open source community who have dedicated their time and hard work. The best way to ask for help or propose a new idea is to [create a new issue](https://github.com/adafruit/DHT-sensor-library/issues/new) while creating a Pull Request with your code changes allows you to share your own innovations with the rest of the community.
|
||||
|
||||
The following are some guidelines to observe when creating issues or PRs:
|
||||
|
||||
- Be friendly; it is important that we can all enjoy a safe space as we are all working on the same project and it is okay for people to have different ideas
|
||||
|
||||
- [Use code blocks](https://github.com/adam-p/markdown-here/wiki/Markdown-Cheatsheet#code); it helps us help you when we can read your code! On that note also refrain from pasting more than 30 lines of code in a post, instead [create a gist](https://gist.github.com/) if you need to share large snippets
|
||||
|
||||
- Use reasonable titles; refrain from using overly long or capitalized titles as they are usually annoying and do little to encourage others to help :smile:
|
||||
|
||||
- Be detailed; refrain from mentioning code problems without sharing your source code and always give information regarding your board and version of the library
|
||||
160
README.md
160
README.md
@ -1,14 +1,162 @@
|
||||
# Adafruit DHT Humidity & Temperature Sensor Library [](https://travis-ci.com/adafruit/DHT-sensor-library)
|
||||
|
||||
An Arduino library for the DHT series of low cost temperature/humidity sensors.
|
||||
## Description
|
||||
|
||||
Tutorial: https://learn.adafruit.com/dht
|
||||
An Arduino library for the DHT series of low-cost temperature/humidity sensors.
|
||||
|
||||
**You must have the following Arduino libraries installed to use this class:**
|
||||
You can find DHT tutorials [here](https://learn.adafruit.com/dht).
|
||||
|
||||
- [Adafruit Unified Sensor Library](https://github.com/adafruit/Adafruit_Sensor)
|
||||
## Installation
|
||||
|
||||
Examples include both a "standalone" DHT example, and one that works along with the Adafruit Unified Sensor Library. Unified sensor library is required even if using the standalone version.
|
||||
### First Method
|
||||
|
||||
Recent Arduino IDE releases include the Library Manager for easy installation. Otherwise, to download, click the DOWNLOADS button in the top right corner, rename the uncompressed folder DHT. Check that the DHT folder contains DHT.cpp and DHT.h. Place the DHT library folder your <arduinosketchfolder>/libraries/ folder. You may need to create the libraries subfolder if its your first library. Restart the IDE.
|
||||
|
||||
|
||||
1. In the Arduino IDE, navigate to Sketch > Include Library > Manage Libraries
|
||||
1. Then the Library Manager will open and you will find a list of libraries that are already installed or ready for installation.
|
||||
1. Then search for DHT-sensor using the search bar.
|
||||
1. Click on the text area and then select the specific version and install it.
|
||||
|
||||
### Second Method
|
||||
|
||||
1. Navigate to the Releases page.
|
||||
1. Download the latest release.
|
||||
1. Extract the zip file
|
||||
1. In the Arduino IDE, navigate to Sketch > Include Library > Add .ZIP Library
|
||||
|
||||
## Requirements
|
||||
|
||||
This library depends on [Adafruit Unified Sensor Library](https://github.com/adafruit/Adafruit_Sensor). To use this library the user must download the required library.
|
||||
|
||||
## Features
|
||||
|
||||
- ### Inexpensive
|
||||
|
||||
This library is used with low-cost temperature and humidity sensors, for example, DHT11 and DHT22. This library is free of cost and the only cost is of the sensors.
|
||||
|
||||
- ### Compatible
|
||||
|
||||
DHT sensor library is compatible with multiple low-cost temperature and humidity sensors like DHT11 and DHT22. A few examples are implemented just to demonstrate how to modify the code for different sensors.
|
||||
|
||||
- ### Function calls
|
||||
|
||||
Basic functions of the low-cost temperature/humidity sensors have been implemented in this library. There's no need to re-implement these functions from scratch. The user simply has to import the library in the project and can use any of its functions by just calling it.
|
||||
|
||||
- ### Give back
|
||||
|
||||
The library is free, you don’t have to pay for anything. However, if you want to support the development, or just thank the author of the library by purchasing products from Adafruit!
|
||||
|
||||
Not only you’ll encourage the development of the library, but you’ll also learn how to best use the library and probably some C++ too
|
||||
|
||||
- ### MIT License
|
||||
|
||||
DHT sensor library is open-source and uses one of the most permissive licenses so you can use it on any project.
|
||||
|
||||
- Commercial use
|
||||
- Modification
|
||||
- Distribution
|
||||
- Private use
|
||||
|
||||
## Functions
|
||||
|
||||
- begin()
|
||||
- readTemperature()
|
||||
- convertCtoF()
|
||||
- convertFtoC()
|
||||
- readHumidity()
|
||||
- computeHeatIndex()
|
||||
- read()
|
||||
- expectPulse()
|
||||
|
||||
## Example
|
||||
|
||||
Examples include both a "standalone" DHT example and one that works along with the Adafruit Unified Sensor Library. A Unified sensor library is required even if using the standalone version. You can find other examples from [Github-DHT-sensor-library](https://github.com/adafruit/DHT-sensor-library/tree/master/examples).
|
||||
|
||||
```Cpp
|
||||
#include "DHT.h"
|
||||
|
||||
#define DHTPIN 2
|
||||
#define DHTTYPE DHT22
|
||||
DHT dht(DHTPIN, DHTTYPE);
|
||||
|
||||
void setup() {
|
||||
Serial.begin(9600);
|
||||
Serial.println(F("DHTxx test!"));
|
||||
|
||||
dht.begin();
|
||||
}
|
||||
|
||||
void loop() {
|
||||
delay(2000);
|
||||
|
||||
float h = dht.readHumidity();
|
||||
float t = dht.readTemperature();
|
||||
float f = dht.readTemperature(true);
|
||||
|
||||
if (isnan(h) || isnan(t) || isnan(f)) {
|
||||
Serial.println(F("Failed to read from DHT sensor!"));
|
||||
return;
|
||||
}
|
||||
|
||||
float hif = dht.computeHeatIndex(f, h);
|
||||
float hic = dht.computeHeatIndex(t, h, false);
|
||||
|
||||
Serial.print(F("Humidity: "));
|
||||
Serial.print(h);
|
||||
Serial.print(F("% Temperature: "));
|
||||
Serial.print(t);
|
||||
Serial.print(F("°C "));
|
||||
Serial.print(f);
|
||||
Serial.print(F("°F Heat index: "));
|
||||
Serial.print(hic);
|
||||
Serial.print(F("°C "));
|
||||
Serial.print(hif);
|
||||
Serial.println(F("°F"));
|
||||
}
|
||||
```
|
||||
|
||||
## Contributing
|
||||
|
||||
If you want to contribute to this project:
|
||||
|
||||
- Report bugs and errors
|
||||
- Ask for enhancements
|
||||
- Create issues and pull requests
|
||||
- Tell others about this library
|
||||
- Contribute new protocols
|
||||
|
||||
Please read [CONTRIBUTING.md](https://github.com/adafruit/DHT-sensor-library/blob/master/CONTRIBUTING.md) for details on our code of conduct, and the process for submitting pull requests to us.
|
||||
|
||||
## Credits
|
||||
|
||||
The author and maintainer of this library is Adafruit <info@adafruit.com>
|
||||
|
||||
Based on previous work by:
|
||||
|
||||
- T. DiCola
|
||||
- P. Y. Dragon
|
||||
- L. Fried
|
||||
- J. Hoffmann
|
||||
- M. Kooijman
|
||||
- J. M. Dana
|
||||
- S. Conaway
|
||||
- S. IJskes
|
||||
- T. Forbes
|
||||
- B. C
|
||||
- T. J Myers
|
||||
- L. Sørup
|
||||
- per1234
|
||||
- O. Duffy
|
||||
- matthiasdanner
|
||||
- J. Lim
|
||||
- G. Ambrozio
|
||||
- chelmi
|
||||
- adams13x13
|
||||
- Spacefish
|
||||
- I. Scheller
|
||||
- C. Miller
|
||||
- 7eggert
|
||||
|
||||
## License
|
||||
|
||||
This library is licensed under [MIT license](https://opensource.org/licenses/MIT).
|
||||
|
||||
Loading…
Reference in New Issue
Block a user