esp32-fan-controller

KO | EN

gitlite — search

#python #hacktoberfest #machine-learning #rust #deep-learning #macos #nodejs #windows #awesome #cli #kubernetes #awesome-list #openai #ios

esp32-fan-controller

(★ 442)

ESP32 fan controller with temperature sensor and MQTT

파일 탐색기

최종 버전 다운로드 (.zip)

- - build-platformio.yml
- README
- config.h
- config_override_example.h
- fanPWM.cpp
- fanPWM.h
- fanTacho.cpp
- fanTacho.h
- log.cpp
- log.h
- main.cpp
- mqtt.cpp
- mqtt.h
- OTA.cpp
- OTA.h
- sensorBME280.cpp
- sensorBME280.h
- temperatureController.cpp
- temperatureController.h
- tft.cpp
- tft.h
- tftTouch.cpp
- tftTouch.h
- wifiCommunication.cpp
- wifiCommunication.h
.gitignore
.travis.yml
platformio.ini
README.md

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

![Build](https://github.com/KlausMu/esp32-fan-controller/actions/workflows/build-platformio.yml/badge.svg)

# ESP32 fan controller with MQTT support
This project describes how to use an ESP32 microcontroller for controlling a 4 pin fan (pwm controlled fan). Main features are:
* mode 1 (fan mode or pwm mode): directly setting fan speed via pwm signal
* mode 2 (climate mode or temperature controller mode): fan speed automatically increases if temperature is getting close to or higher than target temperature. Of course temperature can never get lower than air temperature of room.
* measurement of fan speed via tacho signal
* measurement of ambient values via BME280: temperature, humidity, pressure
* support of MQTT
* support of OTA (over the air updates of firmware). Please see <a href="https://github.com/KlausMu/esp32-fan-controller/wiki/07-OTA---Over-the-air-updates">Wiki: 07 OTA Over the air updates</a>

* TFT display for showing status information, different resolutions supported (tested with 320x240 and 160x128)
* TFT touch display for setting pwm or target temperature
* optional: integration into home automation software <a href="https://www.home-assistant.io/">Home Assistant</a> (with MQTT discovery) or <a href="https://www.openhab.org/">openHAB</a>.

Even if you don't want to use all of these features, the project can hopefully easily be simplified or extended. With some minor modifications an ESP8266 / D1 mini should be usable.

I did this project for having an automatic temperature controller for my 3D printer housing. But of course at least the ideas used here could be used for many other purposes.

For more information please see the <a href="https://github.com/KlausMu/esp32-fan-controller/wiki">Wiki</a>

## Integration in Home Assistant
With mqtt discovery, you can integrate the fan controller with almost no effort in Home Assistant.
<a href="https://github.com/KlausMu/esp32-fan-controller/wiki/images/HA_climate_card_small.png"><img src="https://github.com/KlausMu/esp32-fan-controller/wiki/images/HA_climate_card_small.png"></a> <a href="https://github.com/KlausMu/esp32-fan-controller/wiki/images/HA_climate_card_detail_small.png"><img src="https://github.com/KlausMu/esp32-fan-controller/wiki/images/HA_climate_card_detail_small.png"></a>

Please see <a href="https://github.com/KlausMu/esp32-fan-controller/wiki/05-Home-Assistant">Wiki: 05 Home Assistant</a>

## Operation modes
You can operate the ESP32 fan controller mainly in two different modes, depending on your needs:
mode | description | how to set PWM | how to set actual temperature | how to set target temperature
------------ | ------------- | ------------- | ------------- | -------------
fan mode | fan speed directly set via PWM signal | MQTT, touch or both | BME280 (optional, only used for information) |
climate mode | automatic temperature control fan speed is automatically set depending on difference between target temperature and actual temperature | | MQTT or BME280 | MQTT, touch or both

In both modes, a TFT panel can optionally be used for showing status information from the fan, ambient (BME280: temperature, humidity, pressure) and the chosen target temperature. Different resolutions of the TFT panel are supported, layout will automatically be adapted (tested with 320x240 and 160x128).

If you use a TFT touch panel, you can set the PWM value or target temperature via the touch panel (otherwise you have to use MQTT).

For more information please see the <a href="https://github.com/KlausMu/esp32-fan-controller/wiki/03-Examples-%E2%80%90-operation-modes-and-breadboards">Wiki: 03 Examples - operation modes and breadboards</a>

## Wiring diagram for fan and BME280
![Wiring diagram fan and BME280](https://github.com/KlausMu/esp32-fan-controller/wiki/images/fritzingESP32_BME280_fan.png)

For more information please see the <a href="https://github.com/KlausMu/esp32-fan-controller/wiki/01-Wiring-diagram">Wiki: 01 Wiring diagram</a>

## Part list
Function | Parts | Remarks | approx. price
------------ | ------------- | ------------- | -------------
mandatory
microcontroller | ESP32 | e.g. from <a href="https://www.az-delivery.de/en/products/esp32-developmentboard">AZ-Delivery</a> | 8 EUR
fan | 4 pin fan (4 pin means pwm controlled), 5V or 12V | tested with a standard CPU fan and a Noctua NF-F12 PWM for a list of premium fans see https://noctua.at/en/products/fan | 20 EUR for Noctua
measuring tacho signal of fan | - pullup resistor 10 k&#8486; - RC circuit: resistor 3.3 k&#8486;; ceramic capacitor 100 pF
power supply | - 5V for ESP32, 5V or 12V for fan (depending on fan) or -12V when using AZ-touch (see below) | e.g. with 5.5×2.5 mm coaxial power connector | 12 EUR
optional
temperature sensor | - BME280 - 2 pullup resistors 3.3 k&#8486; (for I2C) | e.g. from <a href="https://az-delivery.de/en/products/gy-bme280">AZ-Delivery</a> | 6.50 EUR
optional
TFT display (non touch) | 1.8 inch 160x128, ST7735 | e.g. from <a href="https://www.az-delivery.de/en/products/1-8-zoll-spi-tft-display">AZ-Delivery</a> | 6.80 EUR
TFT touch display with ESP32 housing | AZ-touch from AZ delivery including voltage regulator and TFT touch display (2.8 inch 320x240, ILI9341, XPT2046) | e.g. from <a href="https://www.az-delivery.de/en/products/az-touch-wandgehauseset-mit-2-8-zoll-touchscreen-fur-esp8266-und-esp32">AZ-Delivery</a> (you can also use the older <a href="https://www.az-delivery.de/en/products/az-touch-wandgehauseset-mit-touchscreen-fur-esp8266-und-esp32">2.4 inch ArduiTouch</a>)| 30 EUR
connectors for detaching parts from AZ-touch | - e.g. 5.5×2.5 mm coaxial power connector male - JST-XH 2.54 mm for BME280 - included extra cables and connectors in case of Noctua fan

Other TFTs can most likely easily be used, as long as there is a library from Adafruit for it. If resolution is smaller than 160x128 it might be necessary to change the code in file tft.cpp. Anything bigger should automatically be rearranged. If you want to use touch, your TFT should have the XPT2046 chip to use it without any code change.

## Software installation
If you're only used to the Arduino IDE, I highly recommend having a look at <a href="https://platformio.org/">PlatformIO IDE</a>.

While the Arduino IDE is sufficient for flashing, it is not very comfortable for software development. There is no syntax highlighting and no autocompletion. All the needed libraries have to be installed manually, and you will sooner or later run into trouble with different versions of the same library.

This cannot happen with <a href="https://platformio.org/">PlatformIO</a>. All libraries will automatically be installed into the project folder and cannot influence other projects.

If you absolutely want to use the Arduino IDE, please have look at the file "platformio.ini" for the libraries needed.

For installing PlatformIO IDE, follow this <a href="https://docs.platformio.org/en/latest/integration/ide/vscode.html#installation">guide</a>. It is as simple as:
* install VSCode (Visual Studio Code)
* install PlatformIO as an VSCode extension
* clone this repository or download it
* use "open folder" in VSCode to open this repository
* check settings in "config.h"
* upload to ESP32

## Images
### ArduiTouch running in "climate mode"
![TempControllerModeArduiTouch](https://github.com/KlausMu/esp32-fan-controller/wiki/images/tempControllerModeArduiTouch.jpg)
### Images of ESP32 fan controller used in a 3D printer housing


![3DPrinter](https://github.com/KlausMu/esp32-fan-controller/wiki/images/3Dprinter.jpg)

For more information please see the <a href="https://github.com/KlausMu/esp32-fan-controller/wiki/04-AZ%E2%80%90touch-or-ArduiTouch">Wiki: 04 AZ‐touch / ArduiTouch</a>

esp32-fan-controller

파일 탐색기

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

esp32-fan-controller

파일 탐색기

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

Download README