🎥 Watch the Demo

ESP32-based smart 3D printer enclosure controller with precise temperature regulation, adaptive vent/fan control using directional hysteresis, intake fault safety, adaptive cooldown mode, OLED menu with rotary encoder, and a responsive web dashboard for monitoring and control.

• Chamber: DS18B20 placed inside the enclosure
• Intake air: Second DS18B20 on the printer's motherboard vent or fresh air intake path (essential for fault detection)
• Ambient: DHT11 (or DHT22) for room temperature and humidity

• SG90 micro servo with three precise states: Closed • Half-Open • Full-Open
• Advanced directional hysteresis logic for rock-solid temperature stability (eliminates oscillation)
• Use servo tuning code to tune your servo if default values dont work for you

• Standard 4-pin PC fan with full PWM control and tachometer feedback (real RPM shown on OLED & web)
• Enforced minimum 20% duty during operation and cooldown to prevent thermal shock
• Hard-kill transistor (2N2222 + 1kΩ resistor) for true 0 RPM when off – no standby spin

• Material presets:
  • PLA → 30°C
  • ASA → 50°C
  • ABS → 60°C
  • TPU → 25°C
  • PETG → 40°C
• Custom mode: Adjustable 0–120°C (saved persistently)
• Adaptive Cooldown Mode:
  • Starts at 20% fan speed + full vent open
  • Automatically adjusts fan speed to achieve ≈1.5°C/min cooling rate
  • Targets ambient temperature + 3°C
  • Live progress bar + estimated time remaining on both OLED and web dashboard

• Intake fault detection: Triggers emergency max fan + full vent if intake air > chamber +5°C (prevents hot air recirculation)
• Automatic recovery when fault clears

• Crisp SSD1306 128×64 OLED display
• Intuitive rotary encoder with push button for navigation
• Double-click encoder button to safely exit active mode (closes vent, stops fan)
• Blinking chamber temperature for quick visibility
• QR code menu item for instant web dashboard access

• Sleek dark glassmorphism design with live 1-second updates
• Displays all sensors, fan RPM/%, vent state, current mode & target
• Animated spinning fan icon
• Cooldown progress ring + estimated time
• Flashing red banner during intake faults
• One-click button to start cooldown
• Built-in iframe for live printer camera (e.g., http://3d-print-live.local – basic ESP32-CAM sketch Provided with flash button and a Quality selector dropdown menu with snapshot button)
• Accessible via mDNS: http://enclosure-monitor.local

• Persistent settings (last selected mode & custom target) using NVS
• Startup servo calibration routine for reliable homing and positioning
• Built-in LED (GPIO 2) indicates active cooling
• Planned: 3D-printable mounts and cases

You can use your own vent design to work with this code too , just need to turn the servo timmings to your vent style or just use the provided one Use any grease of your choice on the gear and rotating flaps in the aperature vent for better movement (Recommeded) Dont use PLA or any other filament which deform in warm chamber `60C

• Servo: GPIO 5
• Fan PWM: GPIO 33
• Fan Tachometer: GPIO 19
• Fan Power Kill: GPIO 15
• Chamber DS18B20: GPIO 32
• Intake DS18B20: GPIO 13
• DHT11/22: GPIO 23
• Encoder CLK/DT/SW: GPIO 25 / 26 / 27
• OLED: Standard I2C (SDA = GPIO 21, SCL = GPIO 22 on most boards)

• Arduino IDE (v1.8.x or v2.x)
• Internet connection

1. Open Arduino IDE
2. Go to File → Preferences
3. In Additional Boards Manager URLs, paste: https://raw.githubusercontent.com/espressif/arduino-esp32/gh-pages/package_esp32_index.json
4. Click OK

1. Go to Tools → Board → Boards Manager
2. Search and install:
   • esp32 (by Espressif Systems)
   • esp8266 (by ESP8266 Community)

Go to Tools → Board and select your board, for example:

• ESP32 Dev Module
• ESP32 WROOM 32
• NodeMCU 1.0 (ESP8266)
• Generic ESP8266 Module

1. Connect the ESP board via USB
2. Go to Tools → Port
3. Select the COM port that appears

Install the correct USB driver for your board:

• CH340
• CP2102
• FTDI

After installation, restart Arduino IDE.

✅ Your ESP board is now ready to be programmed using Arduino IDE.

• Adafruit SSD1306
• Adafruit GFX
• OneWire
• DallasTemperature
• DHT sensor library (by Adafruit)
• ESP32Encoder
• ESP32Servo
• QRCodeGFX

Download the latest build from releases

1. Open <Rev.x.x>.ino in Arduino IDE

2. Edit WiFi credentials:

   const char *ssid = "YOUR_SSID"; const char *password = "YOUR_PASSWORD";

3. Select your ESP32 board and correct port

4. Upload the sketch

Servo performs a full calibration cycle (open → close → open → close) for accurate homing Use rotary encoder to browse modes → press to activate Access web dashboard at http://enclosure-monitor.local

Place the intake DS18B20 directly at the fresh air entry point or near printer motherboard exhaust vents for early recirculation detection

• Fine-tune servo timing constants (SERVO_OPEN_TIME, etc.) to perfectly match your 3D-printed vent mechanism (if needed)
• Choose a high-quality ≥2000 RPM fan (e.g., Noctua or Arctic) for silent yet powerful airflow
• For ABS/ASA printing, pair with a well-sealed enclosure (IKEA Lack, Prusa enclosure, or custom build)
• Ensure adequate passive intake holes – the cooldown algorithm performs best with good natural airflow

Love the project? Help make it even better!Open issues for bugs, questions, or feature requests Submit pull requests: UI improvements, new material presets, wiring schematics, 3D models, etc.

• Share your builds and modifications in the Discussions or Issues
• you can use Grok AI to make your own changes , it works very well , free version works fine

MIT License

Copyright (c) 2026 Jayant Bhatia

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND...