Compare commits

..

2 Commits

Author SHA1 Message Date
tolerryan
4940c936a6 Update README.md 2026-11-21 00:02:17 -06:00
tolerryan
1779d50df9 Fan Controller project created 2026-11-21 00:02:11 -06:00
3 changed files with 240 additions and 0 deletions

46
Fan Controller/README.md Normal file
View File

@@ -0,0 +1,46 @@
# 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

183
Fan Controller/firmware Normal file
View File

@@ -0,0 +1,183 @@
/*
Wemos D1 Mini - Web-based PWM Controller for 4-Wire PC Fan
------------------------------------------------------------
- Hosts a webpage with a slider (0-100%) to control fan speed
- Outputs 1kHz PWM on D5 (GPIO14) -> fan Blue (PWM) wire
- Reads RPM from fan Green (Tach) wire on D6 (GPIO12) via gated 500ms polling
Wiring:
Fan Black (GND) -> Wemos GND (and 12V supply GND - common ground!)
Fan Yellow (12V) -> 12V supply (NOT the Wemos 3V3/5V pin)
Fan Blue (PWM) -> Wemos D5 (GPIO14)
Fan Green (Tach) -> Wemos D6 (GPIO12) [optional]
*/
#include <ESP8266WiFi.h>
#include <ESP8266WebServer.h>
// ---------- USER CONFIG ----------
const char* ssid = "SSID";
const char* password = "PASSWORD";
const int PWM_PIN = D5; // GPIO14 -> fan PWM (blue) wire
const int TACH_PIN = D6; // GPIO12 -> fan tach (green) wire
const bool USE_TACH = true; // set false if you didn't wire the tach pin
const unsigned long RPM_INTERVAL_MS = 3000; // check RPM every 3 seconds
const unsigned long RPM_WINDOW_MS = 500; // sample tach pulses for 500ms
// ----------------------------------
ESP8266WebServer server(80);
volatile unsigned long tachPulses = 0;
unsigned long lastRpmCycle = 0;
bool samplingTach = false;
int currentRPM = 0;
int currentPercent = 50; // startup duty cycle
void ICACHE_RAM_ATTR tachISR() {
tachPulses++;
}
const char htmlPage[] PROGMEM = R"rawliteral(
<!DOCTYPE html>
<html>
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>Fan Control</title>
<style>
body { font-family: Arial, sans-serif; background:#1e1e1e; color:#eee;
text-align:center; padding-top:40px; }
h1 { font-size: 1.6em; }
.slider { width: 80%; max-width: 400px; height: 30px; }
.value { font-size: 2.5em; margin: 20px 0; }
.rpm { font-size: 1.2em; color: #9fd; margin-top: 10px; }
button { background:#333; color:#eee; border:1px solid #555; padding:10px 18px;
margin:6px; border-radius:6px; font-size:1em; }
button:active { background:#555; }
</style>
</head>
<body>
<h1>PC Fan Speed Control</h1>
<div class="value" id="pct">--%</div>
<input type="range" min="0" max="100" value="50" class="slider" id="slider">
<div>
<button onclick="setVal(0)">Off</button>
<button onclick="setVal(50)">50%</button>
<button onclick="setVal(100)">Full</button>
</div>
<div class="rpm" id="rpm">RPM: --</div>
<script>
const slider = document.getElementById('slider');
const pct = document.getElementById('pct');
const rpmEl = document.getElementById('rpm');
function sendValue(v) {
fetch('/set?value=' + v);
}
function setVal(v) {
slider.value = v;
pct.innerText = v + '%';
sendValue(v);
}
slider.oninput = function() {
pct.innerText = this.value + '%';
};
slider.onchange = function() {
sendValue(this.value);
};
function poll() {
fetch('/status').then(r => r.json()).then(d => {
pct.innerText = d.percent + '%';
slider.value = d.percent;
rpmEl.innerText = 'RPM: ' + d.rpm;
});
}
setInterval(poll, 2000);
poll();
</script>
</body>
</html>
)rawliteral";
void handleRoot() {
server.send_P(200, "text/html", htmlPage);
}
void handleSet() {
if (server.hasArg("value")) {
int percent = server.arg("value").toInt();
percent = constrain(percent, 0, 100);
currentPercent = percent;
int duty = map(percent, 0, 100, 0, 1023);
analogWrite(PWM_PIN, duty);
}
server.send(200, "text/plain", "OK");
}
void handleStatus() {
String json = "{\"percent\":" + String(currentPercent) +
",\"rpm\":" + String(currentRPM) + "}";
server.send(200, "application/json", json);
}
void setup() {
Serial.begin(115200);
pinMode(PWM_PIN, OUTPUT);
analogWriteRange(1023); // keep 10-bit (0-1023) duty cycle scale
analogWrite(PWM_PIN, map(currentPercent, 0, 100, 0, 1023));
if (USE_TACH) {
pinMode(TACH_PIN, INPUT_PULLUP);
}
WiFi.mode(WIFI_STA);
WiFi.setSleepMode(WIFI_NONE_SLEEP); // keep Wi-Fi responsive for incoming HTTP requests
WiFi.begin(ssid, password);
Serial.print("Connecting to WiFi");
while (WiFi.status() != WL_CONNECTED) {
delay(500);
Serial.print(".");
}
Serial.println();
Serial.print("Connected! IP address: ");
Serial.println(WiFi.localIP());
server.on("/", handleRoot);
server.on("/set", handleSet);
server.on("/status", handleStatus);
server.begin();
Serial.println("HTTP server started");
lastRpmCycle = millis();
}
void loop() {
server.handleClient();
if (USE_TACH) {
unsigned long now = millis();
// Start a 500ms sampling window every 3 seconds
if (!samplingTach && (now - lastRpmCycle >= RPM_INTERVAL_MS)) {
tachPulses = 0;
samplingTach = true;
lastRpmCycle = now;
attachInterrupt(digitalPinToInterrupt(TACH_PIN), tachISR, FALLING);
}
// End sampling window and calculate RPM
else if (samplingTach && (now - lastRpmCycle >= RPM_WINDOW_MS)) {
detachInterrupt(digitalPinToInterrupt(TACH_PIN));
samplingTach = false;
// Scale pulses from 500ms window to 60 seconds, divided by 2 pulses/rev
currentRPM = (tachPulses * 60000UL) / (RPM_WINDOW_MS * 2);
}
}
}

View File

@@ -0,0 +1,11 @@
# ESP8266 Electronic Hardware Projects
This repository contains different electronic hardware projects developed using ESP8266 Arduino Platform. These projects are a hobby of mine and are designed to explore different aspects of electronic hardware.
- Fan Controller: A micro ESP8266 board with WiFi and Web server capabilities. It outputs PWM to controll a pc fan and reads the tach. also exposes API under /status and /set endpoints to control progmatically
The code provided here is written in Arduino language and should be compatible with ESP8266 boards. It's a hobby project that can be used to explore different aspects of electronic hardware.
You can find the code for each project in their respective directories.
I hope you find this repository useful and happy coding!