TemperatureHumidity < Embedded

---+ Measuring temperature and humidity
---++ Goal:

The DHT11 is a low lost humidity and temperature sensor using its own serial protocol for data transfer. While for 1-wire devices like the ds18B20 temperature sensor a device driver for Linux is available as a kernel module and all the intricacies of the protocol are handled within this module, such a device driver is not available for the DHT11.

The goal of this exercise is therefore to read and understand the [[http://www.micropik.com/PDF/dht11.pdf][DHT11 data sheet]] and to interpret the DHT-11 protocol in order to extract the measured data.

This is a photo of the DHT11 I have got in my sensor kit. Be careful: the PCB onto which the DHT11 is mounted in the sensor kit we have here at UCC is different!

<img alt="dht11.png" height="392" src="%ATTACHURL%/dht11.png" title="dht11.png" width="238" />

*%RED%Be careful: The PCB on which the DHT11 is mounted in our sensor kit is cabled differently:%ENDCOLOR%*

*%RED%Looking onto the device like in the photo, the signal pin is left, labeled "S" (where the GND pin is on my DHT11), the Vcc pin is in the middle and the GND pin is right!%ENDCOLOR%*
---++ Exercise 1: Using a shared library

In order to simplify matters for you I wrote a few functions collected in a shared library.

These are the calls available to you:
   * <p>int dht11Init(void);</p>
   * <p>void dht11SetDebug(bool);</p>
   * <p>int dht11Measurement(void);</p>
   * <p>int dth11GetValidTemperature(void);</p>
   * <p>int dth11GetValidHumidity(void);</p>
   * <p>int dht11GetValidRawData(int *);</p>
   * <p>int dht11GetChecksum(void);</p>
   * <p>int dht11GetDeviceChecksum();</p>
   * <p>time_t dht11GetValidMeasTimeStamp(void);</p>
The sequence will be to first call dht11Init(), then make a measurement with dht11Measurement() and then read out whatever you are interested in.

You will find the include file _dht11.h_ in _/opt/ucc/include_ and the library<i> libdht11.so</i> in _/opt/ucc/lib_

Documentation has been included in _doxygen_ format in the source files. Using the _doxygen_ tool (installed on your Raspberry PI) you can generate documentation for this library automatically. You will find it as html file, which you can look at with your browser.

The URL is: https://dcsit.twiki.ucc.edu.gh/html/libDoc/dht11

The URL only works when looking at the TWiki site from the Raspberry Pi. Otherwise you will have to look up the index.html file in the html sub directory created by doxygen.

---++ Exercise 1: Data taking

Carefully read the DHT-11 data sheet and fully understand the way the DHT-11 communicates with its host micro-controller. Connect the DHT-11 to Vcc and ground and connect the data pin to gpio pin 0 (see warning above!)

Write a C program to drive the data pin in such a way that the data transfer is initiated. Then program the gpio pin as input and read the data repetitively every 5 micro seconds. Save the data into an integer array (even though the data will only vary between 0 and 1). Use a pointer to take as little time as possible to transfer the data into the array. Finally print the data read onto stdout and redirect the output onto a file. How big must the data array be to hold all data in the worst case where only 1s are transmitted?
---++ Exercise 2: Manual Data Analysis

Use gnuplot to plot the acquired data. Analyze the data and extract the values for temperature, humidity and checksum by hand. Calculate the checksum over the temperature and humidity data and compare the result to the expected value sent by the DHT11. Use hexadecimal calculus to do this.

A typical bit stream transmitted by the DHT11.

<img alt="dht11Data.png" height="275" src="%ATTACHURL%/dht11Data.png" title="dht11Data.png" width="642" />
---++ Exercise 3: Analysis done by program

Read in the acquired data through stdin and print them (I/O redirection from the file). Then analyze the pulse train and extract the temperature and humidity data. Use _shift_ and _or_ instructions to build up the 8 bit values for temperature and humidity. Calculate and compare the checksums. Print the results.

Finally connect the data acquisition and the data treatment programs through a pipe.
---++ Comments:

Of course it is also possible to treat the data on the fly during data taking (you may want to give it a try!) However in this case debugging is more difficult due to real time constraints. You cannot put print statements into the code for debugging because the DHT-11 will not wait until your debugging print has finished. If you separate data taking and data analysis, the debugging becomes much easier because you have plenty of time to look at the data.

---++ 

-- %USERSIG{UliRaich - 2017-08-13}%

---++ Comments

%COMMENT%
Attachments
Topic attachments
I	Attachment	History	Action	Size	Date	Who
odt	dht11.odt	r1	manage	58.9 K	2017-10-25 - 18:54	UnknownUser
png	dht11.png	r1	manage	597.9 K	2017-10-25 - 16:12	UnknownUser
png	dht11Data.png	r1	manage	38.7 K	2017-10-25 - 16:12	UnknownUser
This topic: Embedded_Systems > WebHome > CourseExercises > TemperatureHumidity
Topic revision: r4 - 2017-10-31 - uli