DS AN Humidity Sensor Excellent Library Notes Code Etc Al - Q97 - DHT11.pdfArduino Playground - DHTLib
DS AN Humidity Sensor Excellent Library Notes Code Etc Al - Q97 - DHT11.pdfArduino Playground - DHTLib
PARTICIPATE
(http://playground.arduino.cc/Main/Participate)
- Suggestions
(http://code.google.com/p/arduino/issues/list)
- Formatting guidelines
(http://playground.arduino.cc/Main/Participate#contribrules)
- All recent changes
(http://playground.arduino.cc/Site/AllRecentChanges)
- PmWiki
(http://playground.arduino.cc/PmWiki/PmWiki)
- WikiSandBox training
(http://playground.arduino.cc/Main/WikiSandbox)
- Basic Editing
(http://playground.arduino.cc/PmWiki/BasicEditing)
- Cookbook (addons)
(http://www.pmwiki.org/wiki/Cookbook/CookbookBasics)
- Documentation index
(http://www.pmwiki.org/wiki/PmWiki/DocumentationIndex)
- Drone with Arduino
(http://www.bartoloilliano.com/arduino-
tutorial-costruire-un-drone-
con-webcam-telecomandato-
da-pc-tramite-csharp.html)
- Thermostat with Arduino
(http://arduinothermostat.blogspot.co.uk)
Intro
The DHT11, DHT21 and DHT22 are relative cheap sensors for measuring temperature and humidity. This article describes a
library for reading both values from these sensors. Recently I wrote a library for the DHT11 only, see -
http://playground.arduino.cc/Main/DHT11Lib (http://playground.arduino.cc/Main/DHT11Lib) - It has a smaller footprint so if
you only use DHT11 it might be preferred.
I contacted the manufacturer to get the details of the differences between the two DHT sensors to build a lib that supports
both. The DHT21/22 is quite similar to the DHT11 and has a greater accuracy (one decimal) and range (negative temperatures).
The hardware pins and handshake are identical but it uses a different data format.
The DHT33/44 are tested - got free sample from http://shop.boxtec.ch (http://shop.boxtec.ch) for testing (thanks!) - and
they are working great. According to specification these two have a DS18B20 temperature sensor inside which is more
accurate than the DHT21/22 and 11. See elaborate comparison (http://playground.boxtec.ch/doku.php/sensors/temp-
hum_sensors_compared)
Note: The Digistump Digix is a 3.3V device and it works with the DHT22, however when a level shifter was used the
communication failed. So the DHT22 works well on 3.3V.
Major fixes
- update: 0.1.05 fixes negative temperatures for DHT22 (Gave CRC error)
- update: 0.1.07 added support for DHT21 (math equals DHT22)
- update: 0.1.10 update timing substantial faster for DHT21 and DHT22
- update: 0.1.11 and 0.1.12 are not published version (developer only)
- update: 0.1.13 added support for DHT33 and DHT44 - LAST DUE VERSION
- update: 0.1.14 replaced digitalRead with faster code (AVR ONLY!!! better support for lower Mhz devices)
- update: 0.1.19 fixes broken DHT11 (AVR ONLY)
Alternative names
Other libraries:
- There is another library for the DHT22 that is known to work with Arduino 1.0 on ATmega328 Uno boards:
https://github.com/ringerc/Arduino-DHT22 (https://github.com/ringerc/Arduino-DHT22); it is based on earlier work by nethoncho
(https://github.com/nethoncho/Arduino-DHT22).
- And yet another library with real low memory and code size footprint, auto detect DHT11/DHT22 sensor:
https://github.com/markruys/arduino-DHT (https://github.com/markruys/arduino-DHT).
- A calibration method by revmike is discussed here (http://forum.arduino.cc/index.php?topic=184356.msg1753894#msg1753894).
- A nice comfort map is written by JImboZA comfort map (http://forum.arduino.cc/index.php?topic=284571)
- An experiment with reading less bytes here (http://forum.arduino.cc/index.php?topic=244989.0)
Connection (hardware)
The DHT11/21/22 has three lines, GND, +5V and a single data line. By means of a handshake the values are clocked out over the
single digital line. Details about the protocol see datasheet: http://www.micro4you.com/files/sensor/DHT11.pdf
(http://www.micro4you.com/files/sensor/DHT11.pdf) (handshake for DHT21/22 is identical, data format differs)
Simkard added a picture for the pin layout which is not in the datasheet, see =>
http://arduino.cc/forum/index.php/topic,58531.msg421787.html#msg421787
(http://arduino.cc/forum/index.php/topic,58531.msg421787.html#msg421787)
- 1 : VCC (5V)
- 2 : SIGnal
- 3 : NC Not connected
- 4 : GND
There have been reports that some sensors have pin 3 and 4 reversed, probably as a quality control/manufacturing issue. If you
have issues, consider grounding both pins 3 and 4.
DHT library
The library at the end of this article is rewritten from scratch although inspired by earlier work of George Hadjikyriacou. While I
wrote, Simkard did the testing so we can say it is an international library ;).
The library is not compatible with earlier DHT libraries to be able to support both DHT's and stay as simple as possible and to
minimize footprint.
The interface of the class supports only one function for reading the humidity and temperature from the sensors and store it
in two members of the class. The read() function verifies the checksum of the data transmission and it has a time out function.
If there is a checksum error the values of temperature and/or humidity might still be valid.
The class has 6 read functions read11(PIN), read(PIN) and readxx(PIN) which have essentially the same interface. They read the
DHT connected to PIN, and fill the two class members temperature and humidity. Multiple reads from these class members (H
& T) will return the same (previous) values until a new read is done.
The class is kept simple and with one instance it is possible to read multiple, even different sensors, provided each sensor has a
separate pin. Please note that the values of temperature and humidity will be overwritten with every call. So either copy those
values asap of use an instance of the class per sensor. Since version 0.1.04 the temperature and humidity are set to
DHTLIB_INVALID_VALUE if there is a DHTLIB_ERROR_TIMEOUT to make explicit there is something wrong.
If one only needs e.g. the DHT22 part one could comment/remove the read11() function in the .cpp and .h files so the footprint
is a few bytes smaller. (update: compiler optimizes this so not needed)
The TIMEOUT now depends on the F_CPU : #define TIMEOUT (F_CPU/40000). Works for all CPU speed under 100MHz.
2014-feb-08: Tried using micros() to determine TIMEOUT more accurately, resulted in a larger footprint. Added time
measurement for demo sketch DHT22. A call to read Temperature and humidity takes between 24 and 25 milliseconds from
which 20 milliseconds is a "chip wake up" call. Worth investigating if this can be reduced. (both fixed in the 01.10 version)
Usage
A sketch shows how the library can be used to read the sensor. --- Note: the max frequency the sensor can be sampled is
about once per 2 seconds
//
// FILE: dht_test.ino
// AUTHOR: Rob Tillaart
// VERSION: 0.1.07
// PURPOSE: DHT Temperature & Humidity Sensor library for Arduino
// URL: http://arduino.cc/playground/Main/DHTLib
//
// Released to the public domain
//
#include <dht.h>
dht DHT;
#define DHT11_PIN 4
#define DHT21_PIN 5
#define DHT22_PIN 6
void setup()
{
Serial.begin(115200);
Serial.println("DHT TEST PROGRAM ");
Serial.print("LIBRARY VERSION: ");
Serial.println(DHT_LIB_VERSION);
Serial.println();
Serial.println("Type,\tstatus,\tHumidity (%),\tTemperature (C)");
}
void loop()
{
// READ DATA
Serial.print("DHT22, \t");
int chk = DHT.read22(DHT22_PIN);
switch (chk)
{
case DHTLIB_OK:
Serial.print("OK,\t");
break;
case DHTLIB_ERROR_CHECKSUM:
Serial.print("Checksum error,\t");
break;
case DHTLIB_ERROR_TIMEOUT:
Serial.print("Time out error,\t");
break;
default:
Serial.print("Unknown error,\t");
break;
}
// DISPLAY DATA
Serial.print(DHT.humidity, 1);
Serial.print(",\t");
Serial.println(DHT.temperature, 1);
delay(1000);
// READ DATA
Serial.print("DHT21, \t");
chk = DHT.read21(DHT21_PIN);
switch (chk)
{
case DHTLIB_OK:
Serial.print("OK,\t");
break;
case DHTLIB_ERROR_CHECKSUM:
Serial.print("Checksum error,\t");
break;
case DHTLIB_ERROR_TIMEOUT:
Serial.print("Time out error,\t");
break;
default:
Serial.print("Unknown error,\t");
break;
}
// DISPLAY DATA
Serial.print(DHT.humidity, 1);
Serial.print(",\t");
Serial.println(DHT.temperature, 1);
delay(1000);
// READ DATA
Serial.print("DHT11, \t");
chk = DHT.read11(DHT11_PIN);
switch (chk)
{
case DHTLIB_OK:
Serial.print("OK,\t");
break;
case DHTLIB_ERROR_CHECKSUM:
Serial.print("Checksum error,\t");
break;
case DHTLIB_ERROR_TIMEOUT:
Serial.print("Time out error,\t");
break;
default:
Serial.print("Unknown error,\t");
break;
}
// DISPLAY DATA
Serial.print(DHT.humidity,1);
Serial.print(",\t");
Serial.println(DHT.temperature,1);
delay(1000);
}
//
// END OF FILE
//
In setup() The version of the library (a define) is displayed. This is for debugging purpose only.
In loop() a DHT22, a DHT21 and a DHT11 sensor are read and the fields temperature and humidity are filled. The return value of
the readXX function is checked and displayed. Then the temperature and humidity are shown.
Notes
To use the library, make a folder in your SKETCHBOOKPATH\libaries with the name DHT and put the .h and .cpp there.
Optionally make a examples subdirectory to place the sample app.
Todo
dht.h
//
// FILE: dht.h
// AUTHOR: Rob Tillaart
// VERSION: 0.1.14
// PURPOSE: DHT Temperature & Humidity Sensor library for Arduino
// URL: http://arduino.cc/playground/Main/DHTLib
//
// HISTORY:
// see dht.cpp file
//
#ifndef dht_h
#define dht_h
#define DHTLIB_OK 0
#define DHTLIB_ERROR_CHECKSUM -1
#define DHTLIB_ERROR_TIMEOUT -2
#define DHTLIB_INVALID_VALUE -999
#define DHTLIB_DHT11_WAKEUP 18
#define DHTLIB_DHT_WAKEUP 1
class dht
{
public:
// return values:
// DHTLIB_OK
// DHTLIB_ERROR_CHECKSUM
// DHTLIB_ERROR_TIMEOUT
int read11(uint8_t pin);
int read(uint8_t pin);
double humidity;
double temperature;
private:
uint8_t bits[5]; // buffer to receive data
int _readSensor(uint8_t pin, uint8_t wakeupDelay);
};
#endif
//
// END OF FILE
//
dht.cpp
//
// FILE: dht.cpp
// AUTHOR: Rob Tillaart
// VERSION: 0.1.14
// PURPOSE: DHT Temperature & Humidity Sensor library for Arduino
// URL: http://arduino.cc/playground/Main/DHTLib
//
// HISTORY:
// 0.1.14 replace digital read with faster (~3x) code => more robust low MHz machines.
// 0.1.13 fix negative temperature
// 0.1.12 support DHT33 and DHT44 initial version
// 0.1.11 renamed DHTLIB_TIMEOUT
// 0.1.10 optimized faster WAKEUP + TIMEOUT
// 0.1.09 optimize size: timeout check + use of mask
// 0.1.08 added formula for timeout based upon clockspeed
// 0.1.07 added support for DHT21
// 0.1.06 minimize footprint (2012-12-27)
// 0.1.05 fixed negative temperature bug (thanks to Roseman)
// 0.1.04 improved readability of code using DHTLIB_OK in code
// 0.1.03 added error values for temp and humidity when read failed
// 0.1.02 added error codes
// 0.1.01 added support for Arduino 1.0, fixed typos (31/12/2011)
// 0.1.00 by Rob Tillaart (01/04/2011)
//
// inspired by DHT11 library
//
// Released to the public domain
//
#include "dht.h"
/////////////////////////////////////////////////////
//
// PUBLIC
//
// return values:
// DHTLIB_OK
// DHTLIB_ERROR_CHECKSUM
// DHTLIB_ERROR_TIMEOUT
int dht::read11(uint8_t pin)
{
// READ VALUES
int rv = _readSensor(pin, DHTLIB_DHT11_WAKEUP);
if (rv != DHTLIB_OK)
{
humidity = DHTLIB_INVALID_VALUE; // invalid value, or is NaN prefered?
temperature = DHTLIB_INVALID_VALUE; // invalid value
return rv;
}
// TEST CHECKSUM
// bits[1] && bits[3] both 0
uint8_t sum = bits[0] + bits[2];
if (bits[4] != sum) return DHTLIB_ERROR_CHECKSUM;
return DHTLIB_OK;
}
// return values:
// DHTLIB_OK
// DHTLIB_ERROR_CHECKSUM
// DHTLIB_ERROR_TIMEOUT
int dht::read(uint8_t pin)
{
// READ VALUES
int rv = _readSensor(pin, DHTLIB_DHT_WAKEUP);
if (rv != DHTLIB_OK)
{
humidity = DHTLIB_INVALID_VALUE; // invalid value, or is NaN prefered?
temperature = DHTLIB_INVALID_VALUE; // invalid value
return rv; // propagate error value
}
// TEST CHECKSUM
uint8_t sum = bits[0] + bits[1] + bits[2] + bits[3];
if (bits[4] != sum)
{
return DHTLIB_ERROR_CHECKSUM;
}
return DHTLIB_OK;
}
/////////////////////////////////////////////////////
//
// PRIVATE
//
// return values:
// DHTLIB_OK
// DHTLIB_ERROR_TIMEOUT
int dht::_readSensor(uint8_t pin, uint8_t wakeupDelay)
{
// INIT BUFFERVAR TO RECEIVE DATA
uint8_t mask = 128;
uint8_t idx = 0;
// REQUEST SAMPLE
pinMode(pin, OUTPUT);
digitalWrite(pin, LOW); // T-be
delay(wakeupDelay);
digitalWrite(pin, HIGH); // T-go
delayMicroseconds(40);
pinMode(pin, INPUT);
uint32_t t = micros();
loopCntHIGH = DHTLIB_TIMEOUT;
while ((*PIR & bit) != LOW )
{
if (--loopCntHIGH == 0) return DHTLIB_ERROR_TIMEOUT;
}
return DHTLIB_OK;
}
//
// END OF FILE
//
Share
NEWSLETTER
Enter your email to sign up
©2015 Arduino Copyright Notice (http://arduino.cc/en/Main/CopyrightNotice) Contact us (http://arduino.cc/en/Main/ContactUs)
(http://www.flickr.com/photos/arduino_cc) (http://youtube.com/arduinoteam)