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 Wiki: 07 OTA Over the air updates

• 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 Home Assistant (with MQTT discovery) or openHAB.

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 Wiki

Integration in Home Assistant

With mqtt discovery, you can integrate the fan controller with almost no effort in Home Assistant.

Please see Wiki: 05 Home Assistant

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 Wiki: 03 Examples - operation modes and breadboards

Wiring diagram for fan and BME280

For more information please see the Wiki: 01 Wiring diagram

Part list

Function	Parts	Remarks	approx. price
mandatory
microcontroller	ESP32	e.g. from AZ-Delivery	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Ω - RC circuit: resistor 3.3 kΩ; 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Ω (for I2C)	e.g. from AZ-Delivery	6.50 EUR
optional
TFT display (non touch)	1.8 inch 160x128, ST7735	e.g. from AZ-Delivery	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 AZ-Delivery (you can also use the older 2.4 inch ArduiTouch)	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 PlatformIO IDE.

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 PlatformIO. 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 guide. 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"

Images of ESP32 fan controller used in a 3D printer housing

For more information please see the Wiki: 04 AZ‐touch / ArduiTouch