Dew-Point-Ventilation-Zigbee

KO | EN

gitlite — search

#react #llm #golang #android #rust #deep-learning #docker #nodejs #awesome #cli #pytorch #security #openai #open-source

Dew-Point-Ventilation-Zigbee

(★ 11)

Dew Point Ventilation based on Zigbee with ESP32C6

Dew-Point-Ventilation-Zigbee Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Dew-Point-Ventilation-Zigbee
Dew Point Ventilation based on Zigbee with ESP32C6

This repository contains the source code for a dew point ventilator as initially described here by german MAKE magazin: [Taupunktluefter](https://github.com/MakeMagazinDE/Taupunktluefter). The whole build is explained in german language (behind a paywall) at [heise.de](https://www.heise.de/ratgeber/Bastelprojekt-Taupunkt-Lueftung-mit-ZigBee-Funksteckdose-installieren-10300381.html)

# Newest Updates:
June 2026 - Version 3.3.1
* Added hard-coded sensor offset in [processSensorData.h](DewPointFan/lib/processSensorData/processSensorData.h)
* Minor fixes

February 2026 - Version 3.2.1:
* Fix of sensor reset, see [sensor power reset](#sensor-power-reset), by including it into the processSensorData loop.

November 2025 - Version 3.2.0:
* Display sleeps after some minutes of inactivity. The rest of the systems stays active
* Automatic day light saving time compensation (+1 hour). Enabled by `#define DAYLIGHTSAVING` command
* [Date can be set via terminal](#set-date-via-serial) command `Z` (instructions are in german language) if necessary.

September 2025: 
* Formatting of code enforced with CLANG. 
* Explained manual versioning scheme in this [pre-release checklist](preRelease.md).
* Ver 3.1.0: Added [sensor power reset](#sensor-power-reset) to enable cycling the power of the sensors if the communication fails.

July 2025: Update of the [visualization](#recording-the-data-on-the-sd-card-and-visualization). Now directly in HTML and javascript. Try it out here: [VisualizeData.html](https://andunhh.github.io/Dew-Point-Ventilation-Zigbee/Visualization/VisualizeData.html).

# Instructions for the dew point ventilator
These instructions describe a dew point ventilation system. This system is used to measure the humidity of the air at two locations. If the air outside is drier in absolute terms than inside, a fan is switched on.

The following picture shows the components schematically:

![Schematic overview of the dew point ventilation system](https://raw.githubusercontent.com/AndunHH/Dew-Point-Ventilation-Zigbee/main/images/ventilation-scheme.svg)

The temperature is measured by an internal and external DHT22 sensor. The controll unit checks whether ventilation is useful and commands the socket via zigbee to turn on the fan for ventilation.

The individual components inside the control unit are described in more detail in the following image:

![Components overview](https://raw.githubusercontent.com/AndunHH/Dew-Point-Ventilation-Zigbee/main/images/controller-overview.svg)

Check out the following 3d modelled parts:
- [Case for dew point ventilation with seeed xiao esp32c6 and DHT22](https://www.printables.com/model/1143678-case-for-dew-point-ventilation-with-seeed-xiao-esp)
- [Grove Temperature Humidity Sensor DHT22 case](https://www.printables.com/model/1145516-grove-temperature-humidity-sensor-dht22-case)

# Overview of the code provided

The code is intended to be compiled in vscode with platformio. The main programm logic can be found in the [main.cpp](DewPointFan/src/main.cpp) and is calling six helping classes, which can be found in the lib folder:
1. ProcessSensorData: Read the sensors, calculate the dewpoint and decide if ventilation is useful.
2. ControlFan: Handle the mode selection by the user and the duration of the fan being on or off.
3. ZigbeeSwitchHelper: Handles the zigbee communication with the mains socket, based on the Zigbee Arduino library.
4. RTCHelper: Sets the RTC if necessary and supplies the date information for display and logging.
5. SDhelper: Write data to the sd card in regular intervals
6. DispHelper: Show status information on the display.

Here is also a short sketch of the main idea:

![Program flow](https://raw.githubusercontent.com/AndunHH/Dew-Point-Ventilation-Zigbee/main/images/programFlow.drawio.svg)

# How to install with platformIO

You can use PlatformIO to flash the board with this fast steps. 
1. Install PlatformIO or [pioarduino](https://github.com/pioarduino/platform-espressif32/).
2. Clone this repo and open it in vscode.
3. The project should be configured automatically.
4. Click compile and upload -> Done

# Setup and commissioning
The outdoor sensor should be placed outside so that it can measure the air temperature and humidity of the outside air. A hanger is provided for this purpose.

The control unit should be mounted indoors and reach the outdoor sensor with the 3m long cable. The indoor sensor on the housing of the control unit should not be directly in the airflow of the future fan. It is better if it can measure the indoor temperature and humidity undisturbed.

The control unit is supplied with power using a cell phone power supply unit and a USB-C cable. When the power is connected, the device starts after 4 s and shows information on the display.

The device always starts in automatic mode.

The device includes a switchable socket that works according to the Zigbee standard, as sold by Philips Hue or IKEA, for example.

# Operation in automatic mode

1. The inner and outer sensors are scanned alternately every two seconds. The air temperature and relative humidity are determined. 
2. Eight pairs of values are averaged so that decisions are based on approximately half a minute and not on individual values.
3. The dew point temperature is calculated from the relative humidity and the temperature. The dew point temperature is a measure of the absolute amount of moisture in the air. 
4. If the answers to the following four questions are yes, ventilation makes sense - otherwise not! (adjust values in [processSensorData.h](DewPointFan/lib/processSensorData/processSensorData.h))
   - Is the temperature inside above 10°C?
   - Is the temperature outside above -2°C?
   - Is the dew point inside above 5°C?
   - Is the dew point outside 3°C lower than inside? It only makes sense to ventilate If it is noticeably drier outside than inside!
5. If the appliance is in automatic mode (“AUTO”) and ventilation makes sense (see 4.) then the fan is switched on for 15 minutes.
6. As typical bathroom fans are not designed for continuous operation, the fan then switches off again for 10 minutes. 
7. After the 10 min break, the fan may be switched on again if ventilation makes sense.

# Temperature display
The measured values of the sensors can be read on the display of the control unit. On the left for the indoor sensor and on the right for the outdoor sensor.

1. Air temperature in °C
2. Relative humidity in percent
3. The dew point temperature in °C, which serves as a measure of the absolute humidity.
4. Evaluation of the conditions. This indicates whether ventilation makes sense or why it does not.

Internally, each measured value is averaged over 8 single measurements. The number of valid measurements in the FIFO is shown in the display in the second line, if the value is NOT equal to 8. Therefore, during initialization, a zero is shown here. Also a smaller value is shown here, if you have connection problems with the sensor.

Additionally, the fan state and mode is shown in the upper left corners in all screens.

![Overview of the measurement data](https://raw.githubusercontent.com/AndunHH/Dew-Point-Ventilation-Zigbee/main/images/screen-measurements.jpg)

# Off, on and automatic mode

The mode of the device can be switched using the small recessed button.

![Mode switch](https://raw.githubusercontent.com/AndunHH/Dew-Point-Ventilation-Zigbee/main/images/Modus-Schalter.png)

The device always starts in automatic mode and shows this as “AUTO” on the display.

When the button is pressed, the appliance switches to ON mode. Here the fan is always switched on for 15 minutes - is then switched off for 10 minutes and then starts again in any case.

If you press the button again and select the off mode (“OFF”), the fan will never start.

If you press the button a third time, you will return to automatic mode.

Regardless of the mode, the display always shows whether ventilation is theoretically useful.

# Recording the data on the SD card and visualization

The micro SD card can be clicked into place by pressing lightly on the right-hand side of the housing. This causes it to come out a few millimeters and can be removed.

The data on the SD card can be converted into a nice graphic using the Jupyter notebook [Dewpoint-Visualization.ipynb](Visualization/Dewpoint-Visualization.ipynb). The second approach works directly from the browser. See the code here [Visualization/VisualizeData.html](Visualization/VisualizeData.html) or view the page directly on github pages: [VisualizeData.html](https://andunhh.github.io/Dew-Point-Ventilation-Zigbee/Visualization/VisualizeData.html). 
There is also a german version: [VisualizeData_DE.html](https://andunhh.github.io/Dew-Point-Ventilation-Zigbee/Visualization/VisualizeData_DE.html).

The visualization shows:
1. The temperature inside and outside. The limits are shown as a dotted line. (At the moment the limits are not read from the sd card, but are hard coded into the visualization.)
2. The measured relative humidity.
3. The calculated dew point. If the outer dew point is below the inner dewpoint, the air contains less humidity, the are between the curves is colored in light green. If the differences is above the necessary 3 K difference, the area is colored in dark green.
4. The summed time how long the fan was turned on is shown in between the plot.

![example of the evaluated picture](https://raw.githubusercontent.com/AndunHH/Dew-Point-Ventilation-Zigbee/main/images/2024-05.png)

## How to get the Jupyter visualization running
1. Install VScode extensions: Jupyter and Python and restart vscode.
2. Open the Jupyter Notebook "Dewpoint-Visualization.ipynb" in vscode.
3. Handle Python kernel and environment as follows:
   1. Click in the upper right corner to open the "Select Kernel" dialog. This can also be done by opening all comands with ctrl + shift + p and type > select kernel.
   2. Look at the top center of the VSC-window.
   3. If you have an already working ".venv"-kernel, choose it an go to step 3.4.. Otherwhise click on "select another kernel"
      1. Choose "Python Environments"
      2. Choose "+ Create Python Environment"
      3. Choose "venv"
      4. If already one exists: "Delete and Recreate"
      5. Chosse the global python interpreter. This one is marked at the end of line with the blue colored word "Global".
      6. Select dependencies "Visualization/requirements.txt" and click ok.
   4. Wait until the packages are installed.
   5. Save file <Dewpoint-Visualisation.ipynb> manually.
4. Use the "Run all" Button in the Jupyter Notebook.
5. After a short time you will be prompted for the csv-file with logged data. If no prompt seems to appear look at the task bar. Here could blink the Python-icon. Click on it and choose path and csv-file with logged data.
6. After a moment scroll down. At the end of the page you will find the plotted charts.

# Coupling a new socket outlet

A new zigbee device can be coupled for 180s after a reset of the controller. To delete old couplings a zigbee factory reset can be done with a long press on the boot button on the esp32c6.

# Electronic details
The DHT sensors are connected as follows:

### inner sensor

| pins of "Analog" connector 	|	pins of DHT22.1 | comment | 
| --- | --- | --- | 
| GND | 	GND | |
|3V3 				|	VDD | connect to a pin to enable the sensor power reset feature! | 
|N/A = A0 			|	NC (not in function) | | 
|0 = D0 				|	SDA | |

### outer sensor
| pins of "UART" connector	 |	pins of DHT22.2 | comment  |
| --- | --- | --- |
|GND 				|	GND | |
|3V3 				|	VDD |connect to a pin to enable the sensor power reset feature! | 
|TX.6 				|	NC (not in function) | |
|RX.7 = D7 			|	SDA  |  |

![Pin out of the expantionsboard](https://raw.githubusercontent.com/AndunHH/Dew-Point-Ventilation-Zigbee/main/images/pinout-expansionboard.png)

Modified picture, original taken from here: https://wiki.seeedstudio.com/Seeeduino-XIAO-Expansion-Board/#pinout-diagram

# Sensor power reset
In [Issue #9](https://github.com/AndunHH/Dew-Point-Ventilation-Zigbee/issues/9) we found, that some sensors and communication cables may be unreliable.
There are two possible workarounds:
1. Uncomment the block in main.cpp to reset the ESP32 after 30s of invalid sensor data. Look for `ESP.restart();`. As this is only restarting the ESP32, the sensors may still be in a blocked state.
2. Connect the sensors to a logic pin (e.g. D3) instead of 3.3V and use this pin to reset the sensors, if the communication is invalid. 
Define the `#SENSORPWRRESET` at top of in [processSensorData.h](DewPointFan/lib/processSensorData/processSensorData.h) to enable this feature.

# Set date via serial
Connect to the esp via serial terminal. Type `Z` to start date mode. Enter date and time in format `dd.mm.yyyy hh:mm` and press enter.

# Components
The following table lists the used components. 
Regarding the temperature sensor: We got reports that not every sensor is capable of measuring negative temperatures even though their sold so... test the outside sensor in the fridge before winter!

| component | Approx. price |
| --- | --- |
| [ESP32-C6 by Seeed Studio](https://www.seeedstudio.com/Seeed-Studio-XIAO-ESP32C6-p-5884.html) | 6 € |
| [XIAO Expansion Board](https://wiki.seeedstudio.com/Seeeduino-XIAO-Expansion-Board) | [15 €](https://www.reichelt.de/de/de/shop/produkt/xiao_-_erweiterungboard_mit_oled-display-379735) |
| 2x [DHT22 Sensors](https://www.reichelt.de/de/de/shop/produkt/arduino_-_temp_feuchte_pro_praezise_dht22_am2302-191250) | 20 €| 
| [XLR socket](https://www.reichelt.de/de/de/shop/produkt/xlr-einbaustecker_3-polig_vernickelte_kontakte-40795) and cable | 5 € |
| SD card | 6 € | 
| 3D print | 15 € |
| Zigbee socket | 8 € | 
| Cell phone power supply + USB-C cable | 5 € | 
| CR1220 battery for RTC | <1€ |
| M2 and M3 screws ... | <1€ |
| __total__ | __80 €__ |

Obviously, additionally required:

- Bathroom fan

# FAQ
## The RTC seems not to work
Try scrubbing the connection of the battery pad with a screw driver, as there may be some residue from the soldering process which prohibits good contact to the battery.

## Can I ignore the messages "... not set as GPIO"?
Yes, the gpio warning may be ignored.

## What is "wifi.txt" needed for?
This is not used now, but the idea is, that the system uses wifi to get a proper time stamp. Unfortunately, WiFi and zigbee is not working at the same time now.

## How to fix an offset between the sensors?
You can apply a hard-coded offset between the two sensors. Check the definitions in [processSensorData.h](DewPointFan/lib/processSensorData/processSensorData.h)

## Warning about ADC_ATTEN_DB deprecation
The followings warning during compilation are normal and can be ignored: 
``` .pio/libdeps/build/ESP32_Button/src/original/button_adc.c: In function 'button_adc_init':
.pio/libdeps/build/ESP32_Button/src/original/button_adc.c:199:13: warning: 'ADC_ATTEN_DB_11' is deprecated [-Wdeprecated-declarations]
  199 |             .atten = ADC_BUTTON_ATTEN,
```

## Reported _errors_ during init
There are some some errors reported during the programs startup phase via serial interface. Those are known bugs which may be ignored.
```
Initializing disp...[  4028][E][esp32-hal-gpio.c:176] __digitalWrite(): IO 23 is not set as GPIO.
[  4134][E][esp32-hal-gpio.c:176] __digitalWrite(): IO 23 is not set as GPIO.
[  4240][E][esp32-hal-gpio.c:176] __digitalWrite(): IO 23 is not set as GPIO.
Initializing zigbee ...Adding ZigbeeSwitch endpoint to Zigbee Core
newFileName detected
[  4522][E][vfs_api.cpp:99] open(): /sd/wifi.txt does not exist, no permits
```

# Further Project ideas / Wanted features
## Controller

- Change general behavior of the button, to wake up the display at all or prolong the actual shown screen. See [issue #5](https://github.com/AndunHH/Dew-Point-Ventilation-Zigbee/issues/5#issuecomment-2741584899)
- Use one of the LEDs (e.g. the yellow one) to indicate that zigbee pairing is enabled. See [issue #5](https://github.com/AndunHH/Dew-Point-Ventilation-Zigbee/issues/5#issuecomment-2741584899)
- Use wifi credentials and check once per day if the wifi can be accessed to update the rtc.
- Reset the whole controller once per day or if data are missing? Check `processSensorData.timeSinceAllDataWhereValid()`
- Show in the display, if no plug is bound at all.
- Read the offset for the sensor from the SD card.

## Visualization
- Add the actual limits that are used to calculate if ventilation is usefull to the SD card. Then read them during visualization, as they are hardcoded now and always show the default limits and not the actual used ones, if they differ.

Dew-Point-Ventilation-Zigbee

Dew-Point-Ventilation-Zigbee Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Dew-Point-Ventilation-Zigbee

Dew-Point-Ventilation-Zigbee Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README