Forth-eV Wiki

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
{{pfw:full-banner.png?500 }}
====== DHT22 ======
The DHT22 module is a low-cost digital temperature and humidity sensor. It utilizes a capacitive humidity sensor and a thermistor to measure the surrounding air and outputs a digital signal via a single data pin. It's known for its wider measurement range and higher accuracy compared to its predecessor, the DHT11.

**Key features include:**

* Measures both temperature (from -40°C to 80°C with an accuracy of ±0.5°C) and humidity (from 0% to 99.9%RH with an accuracy of ±2-5%).
* Digital output via a single-wire interface, simplifying communication with microcontrollers like Arduino and Raspberry Pi.
* Operates on a voltage range of 3.3V to 6V.
* Has a relatively low power consumption.
* Offers good long-term stability.
* Typically comes on a small PCB with necessary pull-up resistors, making it easy to integrate into projects.
* Has a sampling rate of no more than 0.5 Hz (once every 2 seconds).
* Suitable for indoor environmental monitoring, weather stations, and HVAC systems.

===== SDA Protocol =====

The DHT22 communicates using a **proprietary single-wire serial protocol**. Here's a breakdown of the process:

1.  **Start Signal from Microcontroller:** The microcontroller initiates communication by pulling the data line low for a specific duration (typically > 800µs to 1ms). This signals the DHT22 to wake up and prepare to send data.
2.  **Response from DHT22:** After the start signal, the DHT22 pulls the data line low for about 80µs and then high for another 80µs. This serves as a response signal indicating that the sensor is ready to transmit data.
3.  **Data Transmission (40 bits):** The DHT22 transmits 40 bits of data representing humidity and temperature readings, followed by a checksum bit. Each bit is transmitted as follows:
    * The data line is first pulled low for approximately 50µs.
    * Then, it's pulled high for a varying duration:
        * **26-28µs high indicates a "0" bit.**
        * **70µs high indicates a "1" bit.**
4.  **Data Format (5 bytes):** The 40 bits of data are structured into five 8-bit bytes:
    * **Byte 1:** Humidity integer part (0-99)
    * **Byte 2:** Humidity decimal part (always 0 for DHT22)
    * **Byte 3:** Temperature integer part (-40 to +80)
    * **Byte 4:** Temperature decimal part (always 0 for DHT22)
    * **Byte 5:** Checksum (sum of the first four bytes, modulo 256)
5.  **End of Transmission:** After transmitting all 40 bits, the DHT22 releases the data line, and it's pulled high by an external pull-up resistor, returning to the idle state.

The microcontroller needs to carefully time these pulses to correctly interpret the data sent by the DHT22. Libraries for popular platforms like Arduino and Raspberry Pi handle these timing-critical operations.

[[https://wiki.forth-ev.de/lib/exe/fetch.php/pfw:am2302-en-aosong.pdf|am2302-en-aosong.pdf]] This Aosong document has the correct data, although it is a creepy English translation. 

On page 2, under 4, "The definition of single-bus interface," pin 2 of the sensor is called **SDA, Serial Data**. A table and a figure show the pin assignment of the AM2302.

{{ :en:pfw:dht22-response.png?nolink |Screenshot of the 40-bit response on the SDA line. (PulsView Logic Analyser)}}


===== Testing with a Logic Analyser (PulsView) =====

Pin P1.0 is bidirectional. It sends the start pulse and then receives the 40 data bits from the sensor module.

The code includes test pulses on pin P1.6 to check the timing. You can remove those.

{{ :en:pfw:ok-40bits_checksumme_richtig.png?nolink |The top line is the DHT22's response, and the following line shows the timing checks. The checksum is correct.}}

The time-critical part is assembler code. The surrounding code was written in noForth. It uses ''tools.f'' and ''noforth_m_asm'' from the noForth library. These must be compiled into noForth on the MSP430G2553 beforehand.

Sensor modules vary in their output speed due to manufacturing and temperature conditions. 1/4 of the response pulse is approximately the waiting time to read the bit. Therefore, the code //adapts// to the observed speed. A 'while' loop is used for this, but its execution takes about twice as long as the wait loop for reading the bit. The waiting time from 'moon' is therefore simply doubled to make it fit.

{{ :en:pfw:dht22-bit_lesen_mit_2xmoon.png?nolink |The timing is critical. So, it's correct now. Here we read a "0"}}

====== Implementation for TI's Launchpad ======

This program was used to test DHT22 modules before installation. The DHT22 modules were tested for functionality at room temperature, pre-sorted in this way, and then frozen in a bag of moist sand in the freezer and tested again. One module displayed incorrect temperature values in frost conditions, the display of negative values did not comply with the specifications.

[[en:pfw:dht22-msp430g2553-noforth|DHT22 for Launchpad MSP430G2553 and noForth]]


====== Implementation for RP2040 ======

[[en:pfw:dht22-rp2040-nofortht|DHT22 for the Raspberry Pi Pico Board RP2040 and noForth t]] using a PIO block

PIO stands for //Programmable Input Output//. You can program the PIO blocks with the [[en:pfw:assemblers_pio-assembler|noforth t PIO Assembler]].
====== Background Information ======

  * How this was discovered: [[en:pfw:dht22tmpformat|The temperature format of the DHT22]]
  * [[https://www.ti.com/lit/ug/slau144j/slau144j.pdf|MSP430x2xx Family guide SLAU144J.PDF]]
  * [[https://www.ti.com/lit/ds/symlink/msp430g2553.pdf|MSP430G2553 datasheet SLAS735J.PDF]], port data on page 49ff
  * [[https://home.hccnet.nl/anij/nof/noforth.html| noforth.html - find your version, docmentation,  tool.f and asm.f here.]] All about noForth.
  * [[en:pfw:whatisapioblock|What is a PIO block?]]

====== Aids ======

MK:\\
I like //Notepad Next// for Linux, a cross-platform, reimplementation of //Notepad++//.
https://github.com/dail8859/NotepadNext\\
To work with the embedded noForth system I use //e4thcom// by Manfred Mahlow.
https://wiki.forth-ev.de/doku.php/projects:e4thcom\\
Sometimes I also use Windows and Teraterm, for example, to log longer MCU outputs to a file. I also prefer it for testing parts of the source code using copy and paste.\\
In this project I used a Logic Analyzer by AZDelivery, 8 CH, 24MHz. (Amazon)\\
//PulseView// is a Qt-based logic analyzer and oscilloscope GUI for sigrok.