Files
ESP-fun/Fan Controller/README.md
2026-11-21 00:02:11 -06:00

47 lines
1.4 KiB
Markdown

# ESP8266 Fan Controller
This project provides an interface for controlling a 4-Wire PC Fan with a web-based UI. It uses ESP8266WiFi and ESP8266WebServer libraries from Espressif's ESP8266 Arduino Platform.
## Getting Started
### Hardware
The project is designed to work with the following hardware:
- Wemos D1 Mini
- 4-Wire PC Fan
- 12V Supply
- 5V Supply
- PWM Wires (blue: D5, green: D6)
- Tachometer (if using)
### Software
The code is written in Arduino language and should be compatible with ESP8266 boards.
## Setup
1. Connect the fan to the Wemos D1 Mini and power pins.
2. Connect the PWM wires to the D5 and D6 pins on the Wemos D1 Mini.
3. Connect the tachometer (if using) to the D6 pin on the Wemos D1 Mini.
4. Power the Wemos D1 Mini and power pins with a 12V supply and a 5V supply.
5. Connect the Wemos D1 Mini to your computer using a USB cable.
6. Open the Arduino IDE and upload the firmware code to the Wemos D1 Mini.
## Usage
The project provides a web server that serves a HTML page with sliders for controlling the fan speed and a button for turning the fan off. It also provides a JSON endpoint for getting the current fan status.
### Monitoring
The project includes a periodic task to monitor the fan's RPM and display it in the UI.
## License
This project is licensed under the MIT License - see the LICENSE.md file for details
## Acknowledgments
- Espressif
- TheWemos team