🌡️ Kitchen Plinth Heater — ESPHome Controller

An ESPHome-based smart controller for a kitchen plinth heater fan, built on a Wemos D1 Mini (ESP8266). Designed to work with a heat pump or underfloor heating system, automatically pushing warm air through a plinth heat exchanger when the flow temperature reaches a set threshold.

Works fully standalone — no Home Assistant required for basic operation. HA adds remote control and monitoring.

---

✨ Features

• 🌡️ Auto mode — fan turns on at a set speed when temperature hits your threshold
• 💨 Boost mode — full speed via physical switch
• ⭕ Off mode — physical switch cuts fan completely
• 👶 Child mode — disables boost from the physical switch (toddler-safe!)
• 🎛️ Manual mode — override fan speed from Home Assistant
• 📊 RPM feedback — reads tach signal from one fan
• 🔄 Survives HA outages — all logic runs on the ESP itself
• 💾 Restores settings on reboot — set temp, set speed persisted to flash

---

📁 Repository Structure

/
├── README.md                   # This file
├── kitchen-plinth-heater.yaml  # ESPHome configuration
└── docs/
    ├── hardware.md             # Wiring, components, schematic
    ├── pins.md                 # Pin reference table
    ├── esphome-config.md       # YAML walkthrough and explanation
    └── home-assistant.md       # HA entities reference

---

🚀 Quick Start

1. Copy kitchen-plinth-heater.yaml into your ESPHome config folder
2. Update the dallas_addr substitution with your sensor's address (see ESPHome docs)
3. Add your WiFi credentials to secrets.yaml
4. Flash to a Wemos D1 Mini
5. Wire up per the hardware guide

---

🔗 Credits

Hardware design based on 3ative's PWM Fan Controller with modifications:

• Added 3-position I/O/II switch (Off / Auto / Boost)
• Added 3x fan headers
• Modified ESPHome config for heat pump / weather compensation use case