Skip to the content
4 layers101.5 × 83.4 mmThermostat, the printed circuit board in 3D

A comprehensive, feature-rich smart thermostat firmware for ESP32-S3 microcontrollers with touch display, web interface, and Home Assistant integration.

Size
101.5 × 83.4 mm
Copper layers
4
Thickness
4.69 mm
Parts
91
Nets
105
Pads
326
Tracks, vias
813, 100
Pours
5
Routed
Yes
KiCad
KiCad 9.0 (file 20241229)
Created
20 Nov 2025
Updated
24 Jul 2026

Overview

Thermostat is an open-source printed circuit board by jrtaylor71, from the jrtaylor71/Smart-Thermostat-Alt-Firmware repository on GitHub. It is a 4-layer board of 101.5 × 83.4 mm with 91 parts on 105 nets, routed with 813 tracks and 100 vias.

It is built around the ESP32-S3-WROOM-1-N16, AHT20 and LM2596T-5.0, with the AMS1117-3.3, 1N4148W and MB6S among its other parts. Its parts include 20 resistors, 14 capacitors, 12 diodes, 7 connectors and 7 switches. It belongs with the home automation and IoT boards and the ESP32 boards of this library.

Main components

8

README

README.md

Smart Thermostat Alt Firmware

A comprehensive, feature-rich smart thermostat system built on the ESP32 platform with professional PCB design. Perfect for DIY smart home automation with full Home Assistant integration.

🏗️ Hardware Credits

This project is alternative firmware for the excellent smart-thermostat hardware designed by Stefan Meisner.

Original Hardware Project: https://github.com/smeisner/smart-thermostat

We use Stefan's hardware design and provide an enhanced firmware implementation with advanced features including multi-core architecture, centralized display management, and comprehensive Home Assistant integration.

🌟 Key Features

  • 📱 Local Touch Control: ILI9341 TFT LCD with intuitive touch interface
  • 🏠 Smart Home Ready: Full MQTT integration with Home Assistant auto-discovery
  • 🔄 Bidirectional Schedule Sync (v1.4.001): 7-day schedules stay in sync between thermostat and Home Assistant (device ↔ HA) with day/night periods and editable Heat/Cool/Auto temperatures
  • 📅 7-Day Scheduling: Comprehensive inline scheduling with day/night periods and editable Heat/Cool/Auto temperatures
  • 🌡️ Dual Sensors: AHT20 for ambient conditions + DS18B20 for hydronic systems
  • ⚡ Multi-Stage HVAC: Support for 2-stage heating and cooling systems
  • 💨 Advanced Fan Control: Auto, continuous, and scheduled cycling modes
  • 🌤️ Weather Integration: OpenWeatherMap and Home Assistant weather with color-coded icons on display
  • 🌐 Modern Web Interface: Complete tabbed interface with embedded scheduling - no separate pages
  • 📡 Offline Operation: Full functionality without WiFi connection
  • 🔧 Professional PCB: Custom PCB design for clean, permanent installation
  • 🔄 OTA Updates: Over-the-air firmware updates with real-time progress tracking
  • 🔒 Factory Reset: Built-in reset capability via boot button

🚀 Quick Start

Hardware-Main-Display

Hardware Requirements

  • ESP32-S3-WROOM-1-N16 (16MB Flash, No PSRAM)
  • ILI9341 320x240 TFT LCD with XPT2046 Touch Controller
  • AHT20 Temperature/Humidity Sensor (I2C)
  • DS18B20 Temperature Sensor (optional, for hydronic heating)
  • LD2410 24GHz mmWave Motion Sensor (optional, for display wake)
  • 5x Relay Module for HVAC control
  • Custom PCB by Stefan Meisner (files included)

Software Setup

  1. Install PlatformIO IDE
  2. Clone this repository
  3. Open project in PlatformIO
  4. Configuration optimized for ESP32-S3-WROOM-1-N16 (16MB flash)
  5. Memory usage: RAM 15.2% (49728/327680 bytes); Flash 18.5% (1209901/6553600 bytes, default_16mb.csv partition)
  6. Erase flash if you are using firmware from Stefan Meisner (original firmware).
  7. Build and upload to ESP32-S3
  8. Use touch interface to configure WiFi and settings

💻 Web Interface

Access the thermostat's web interface by navigating to its IP address:

Tabbed Interface with Embedded Features

Web Status

Status Tab: Real-time monitoring of:

  • Current temperature and humidity
  • Thermostat and fan modes
  • Relay states and system status

Settings Tab: Complete configuration interface for: Web Settings Web Settings2 Web Settings3

  • Temperature setpoints and control modes
  • MQTT/Home Assistant integration
  • WiFi network settings
  • Multi-stage HVAC parameters
  • Hydronic heating controls
  • Fan scheduling options

Schedule Tab: Comprehensive 7-day scheduling:

  • Day and night periods for each day of the week
  • Editable Heat, Cool, and Auto temperatures for each period
  • Time controls for period transitions
  • Schedule enable/disable and override controls
  • All options always visible - no hidden menus

Schedule Schedule1 Schedule2

System Tab: Device information and firmware updates

🏠 Home Assistant Integration

Automatic discovery and integration with Home Assistant:

  1. Enable MQTT in thermostat settings
  2. Configure MQTT broker details
  3. Thermostat appears automatically in Home Assistant
  4. Full control via Home Assistant interface (climate entity, helpers, and switches)
  5. Bidirectional schedule sync: HA helpers (77 per thermostat) mirror the device schedule; edits on either side stay in sync
  6. Supports climate entity with heating/cooling modes

🛠️ Advanced Features

System Tab System Tab1

Multi-Stage Operation

  • Intelligent staging based on time and temperature
  • Configurable stage 2 activation parameters
  • Prevents system short-cycling
  • Optimizes energy efficiency

Hydronic Heating Support

  • DS18B20 water temperature monitoring
  • Safety interlocks prevent operation when water is too cold
  • Configurable high/low temperature thresholds
  • Perfect for radiant floor heating systems

Fan Control Options

  • Auto: Fan runs only with heating/cooling
  • On: Continuous fan operation
  • Cycle: Scheduled fan operation (configurable minutes per hour)

Motion Detection

  • LD2410 24GHz mmWave Sensor: Automatic display wake on motion detection
  • Hardware Pins: RX=15, TX=16, Motion=18
  • Robust Detection: Works with sensors that don't respond to UART commands
  • Home Assistant Integration: Motion sensor auto-discovery and status publishing
  • Energy Saving: Display automatically sleeps when no motion detected
  • Seamless Operation: Works alongside existing touch controls

Safety Features

  • Watchdog timer prevents system lockups
  • Factory reset via boot button (10+ seconds)
  • Temperature limit enforcement
  • Graceful offline operation

🔧 Factory Reset

Press and hold the boot button for more than 10 seconds while the thermostat is running to restore all settings to defaults.

📄 License

This project is released under the GNU General Public License v3.0. Free to use, modify, and distribute.

🤝 Contributing

Contributions welcome! Please:

  1. Fork the repository
  2. Create a feature branch
  3. Make your changes
  4. Submit a pull request

📞 Support

  • Issues: Use GitHub Issues for bug reports
  • Discussions: GitHub Discussions for questions
  • Documentation: Comprehensive docs included
  • Serial Debug: Detailed logging at 115200 baud

⭐ Version

Current Version: 1.4.001 (January 2026)

Release Notes: 1.4.001

  • Bidirectional MQTT schedule synchronization (thermostat ↔ Home Assistant)
  • Fixed day index off-by-one bug (MQTT Monday=0, firmware Sunday=0)
  • Multi-thermostat support with centralized inbound automation and 77 outbound automations per device
  • 77 Home Assistant helpers per thermostat (14 times, 42 temps, 21 booleans)
  • Added automation generator and schedule templates for HA
  • Updated documentation and quick-start guidance for schedule sync

Previous Highlights (1.3.8)

  • Weather Integration: Dual-source weather support (OpenWeatherMap and Home Assistant)
  • Weather Display: Color-coded standard OWM icons with temperature, conditions, and high/low display
  • Weather Web Interface: Dedicated weather tab with AJAX form submission
  • Anti-Flicker Display: Cached redraw optimization for time and weather elements
  • Enhanced Time Display: Improved format "HH:MM Weekday Mon D YYYY" with flicker elimination
  • Weather Settings: Configurable update intervals (5-60 minutes) with state field for US cities
  • Enhanced OTA Updates: Real-time progress tracking for upload and flash write operations
  • Improved OTA UX: Integrated OTA interface in System tab with status messages and reboot timing
  • 7-Day Scheduling System: Complete inline scheduling with day/night periods and editable Heat/Cool/Auto temperatures
  • LD2410 Motion Sensor Integration: 24GHz mmWave radar for automatic display wake with robust detection
  • Modern Tabbed Web Interface: All features embedded in main page - Status, Settings, Schedule, Weather, and System tabs
  • Enhanced MQTT Integration: Motion sensor auto-discovery and status publishing to Home Assistant
  • ESP32-S3-WROOM-1-N16 platform with 16MB flash optimization
  • Modern Material Design color scheme with enhanced readability
  • Complete thermostat functionality with Option C display system
  • Enhanced MQTT/Home Assistant integration with temperature precision
  • Professional PCB design (hardware by Stefan Meisner)
  • Multi-stage HVAC support with intelligent staging
  • Dual-core FreeRTOS architecture for ESP32-S3

🙏 Credits & Acknowledgments

Hardware Design: Stefan Meisner - smart-thermostat
Alternative Firmware: Jonn Taylor - Enhanced firmware implementation

This project demonstrates the power of open-source collaboration - combining excellent hardware design with advanced firmware capabilities.


Created for the DIY smart home community

Parts

91
QtyValueFootprintReferences
9MountingHoleMountingHole:MountingHole_2.7mm_M2.5H1, H2, H3, H4, H5, H6, H7, H8, H9
610kResistor_SMD:R_0603_1608MetricR1, R2, R3, R4, R13, R14
62N7002Package_TO_SOT_SMD:SOT-23Q1, Q2, Q3, Q4, Q5, Q6
51N4148WDiode_SMD:D_SOD-123D8, D9, D10, D11, D12
5470Resistor_SMD:R_0603_1608MetricR16, R17, R18, R19, R20
5UC2-3NJCustom Footprints:UC23NJK1, K2, K3, K4, K5
4+5VTestPoint:TestPoint_THTPad_D2.0mm_Drill1.0mmTP4, TP4, TP4, TP4
4LEDLED_SMD:LED_0805_2012MetricD2, D5, D6, D7
310uFCapacitor_SMD:C_0603_1608MetricC8, C9, C15
20.1uFCapacitor_SMD:C_0603_1608MetricC3, C14
21KResistor_SMD:R_0603_1608MetricR8, R10
21uFCapacitor_SMD:C_0603_1608MetricC1, C2
222pFCapacitor_SMD:C_0603_1608MetricC5, C6
2470uFCapacitor_SMD:CP_Elec_10x10C10, C11
25.1KResistor_SMD:R_0603_1608MetricR6, R7
110KResistor_SMD:R_0603_1608MetricR5
11kResistor_SMD:R_0603_1608MetricR15
1220Resistor_SMD:R_0603_1608MetricR11
122uFCapacitor_SMD:C_0603_1608MetricC4
12KResistor_SMD:R_0603_1608MetricR9
13v3TestPoint:TestPoint_THTPad_D2.0mm_Drill1.0mmTP3
1470uHCustom Footprints:IND_CDRH127_LDNP-470MC_SUML2
147uFCapacitor_SMD:CP_Elec_6.3x7.7C12
1600ohmInductor_SMD:L_1206_3216MetricL1
1680uFCapacitor_SMD:CP_Elec_16x17.5C13
1AHT20Custom Footprints:AHT20U4
1AMS1117-3.3Package_TO_SOT_SMD:SOT-223-3_TabPin2U3
1BootButton_Switch_SMD:SW_SPST_TL3305ASW2
1BuzzerBuzzer_Beeper:Buzzer_TDK_PS1240P02BT_D12.2mm_H6.5mmBZ1
1Conn_01x04Connector_PinHeader_2.54mm:PinHeader_1x04_P2.54mm_VerticalJ6
1D_ZenerDiode_SMD:D_SMAD1
1ESP32-S3-WROOM-1-N16Custom Footprints:XCVR_ESP32-S3-WROOM-1-N16R2U1
1GNDTestPoint:TestPoint_THTPad_D2.0mm_Drill1.0mmTP5
1LD2410Connector_PinSocket_1.27mm:PinSocket_1x05_P1.27mm_Vertical_SMD_Pin1RightJ4
1LDR07OptoDevice:R_LDR_5.1x4.3mm_P3.4mm_VerticalR12
1LM2596T-5Package_TO_SOT_SMD:TO-263-5_TabPin3U2
1MB6SDiode_SMD:Diode_Bridge_Diotec_ABSBR1
1MSP3218Connector_PinSocket_2.54mm:PinSocket_1x14_P2.54mm_VerticalJ7
1RC+RHConnector_PinHeader_2.54mm:PinHeader_1x02_P2.54mm_VerticalJ2
1ResetButton_Switch_SMD:SW_SPST_TL3305ASW1
1SCLTestPoint:TestPoint_THTPad_D2.0mm_Drill1.0mmTP1
1SDATestPoint:TestPoint_THTPad_D2.0mm_Drill1.0mmTP2
1SP0502BAHTPackage_TO_SOT_SMD:SOT-23D3
1SS34Diode_SMD:D_SMAD4
1Screw_Terminal_01x10TerminalBlock_Phoenix:TerminalBlock_Phoenix_MPT-0,5-10-2.54_1x10_P2.54mm_HorizontalJ3
1UART PWRConnector_PinHeader_2.54mm:PinHeader_1x02_P2.54mm_VerticalJ5
1USB_C_Receptacle_USB2.0Connector_USB:USB_C_Receptacle_G-Switch_GT-USB-7010ASVJ1

More from jrtaylor71/Smart-Thermostat-Alt-Firmware

1
  • 4 layers105.5 × 82.4 mmThermostat (Before routing), the printed circuit board in 3D

    Thermostat (Before routing)

    jrtaylor71/Smart-Thermostat-Alt-Firmware

    A comprehensive, feature-rich smart thermostat firmware for ESP32-S3 microcontrollers with touch display, web interface, and Home Assistant integration.

    75 parts2

Similar boards

  • 4 layers69.5 × 62.6 mmPegasus, the printed circuit board in 3D

    Pegasus

    Queens-Rocket-Engineering-Team/av-hardware

    ECAD for SRAD Avionics hardware

    110 parts1
  • 4 layers230 × 135 mmVancontroller, the printed circuit board in 3D

    Vancontroller

    Camperlux/vancontroller

    VanController: ESP32-S3 12 V campervan controller board (6 fused relays, 6 PWM dimmers, CAN, RS485, GPS) - KiCad 10 design, manufacturing files and enclosure. Free for non-commercial use.

    259 parts
  • 2 layers100 × 70 mmModPrincipal, the printed circuit board in 3D

    ModPrincipal

    Gonzalogontad/ProyectoFinalCESEGG

    118 parts
  • 4 layers55 × 154.1 mmGPS module, the printed circuit board in 3D

    GPS module

    Dizzerin/Rocket-Flight-Data-Computer

    This project uses an STM32H743VGT6 MCU along with some innertial measurement units (IMU)s and barometric pressure sensors to and an SD card to record flight data from a model rocket and for later analysis, graphing, and…

    161 parts1
  • 2 layers100 × 100 mmControl board, the printed circuit board in 3D

    Control board

    pavelpernicka/cvut_materialy

    93 parts
  • 2 layers76 × 45.2 mmMasjid2, the printed circuit board in 3D

    Masjid2

    Mahmoud1205/AthanLamp

    Hardware, software, and devlog of the Athan Lamp project.

    60 partsMIT
  • 4 layers50 × 111 mmBlade, the printed circuit board in 3D

    Blade

    JosephStew-art/Blade-PCB

    Blade PCB project

    118 parts

Questions

How big is the Thermostat PCB?

It measures 101.5 × 83.4 mm and has 4 copper layers, 4.69 mm thick.

What parts does the Thermostat use?

91 parts, built around the ESP32-S3-WROOM-1-N16, AHT20, LM2596T-5.0 and AMS1117-3.3. The full list of its parts is on this page, with links to each part's symbol and footprint where PCBKit's library has them.

Where can I download the Thermostat KiCad files?

From the jrtaylor71/Smart-Thermostat-Alt-Firmware repository on GitHub, at the commit this page was made from: the board is smart-thermostat-pcb/Thermostat.kicad_pcb and its schematic smart-thermostat-pcb/Thermostat-accessories.kicad_sch. PCBKit opens the board in the browser, with nothing to install.

Can I use the Thermostat design in my own project?

Its repository states no licence, so its author keeps all rights: ask jrtaylor71 before reusing the design.