Skip to the content
2 layersESP32-Pomodoro Timer, the printed circuit board in 3D

Desktop Pomodoro Timer based on ESP32 with LCD1602 (I2C), tactile buttons, buzzer, and KiCad hardware design

Copper layers
2
Thickness
1.6 mm
Parts
6
Nets
48
Pads
76
Tracks, vias
0, 0
Routed
Not yet
KiCad
KiCad 10.0 (file 20260206)
Created
24 Sep 2026
Updated
19 Oct 2026

Overview

ESP32-Pomodoro Timer is an open-source printed circuit board by TamarHoory, from the TamarHoory/ESP32-Pomodoro-Timer repository on GitHub, published under the MIT licence. It is a 2-layer board with 6 parts on 48 nets.

It is built around the ESP32-WROVER-E(4MB). Its parts include 3 switches and 2 ICs. It belongs with the ESP32 and RISC-V boards of this library.

Main components

1

README

README.md

ESP32 Pomodoro Timer ⏱️

A standalone, tactile desktop Pomodoro productivity timer powered by an ESP32 microcontroller and a 16x2 I2C LCD (LCD1602) display. Complete with custom KiCad hardware schematics, (PCB layout currently in progress), and robust, non-blocking Arduino/PlatformIO firmware.


🌟 Highlights

  • Microcontroller: ESP32 (ESP32-WROOM-32 / ESP32 DevKit)
  • Display: 16x2 Character LCD via I2C backpack (PCF8574) with auto-address discovery (0x27 / 0x3F) and real-time visual progress bar.
  • Tactile Push Buttons:
    • Start / Pause: Toggle countdown or resume paused sessions.
    • Reset: Instantly reset session to the configured interval.
    • Set Time: Cycle duration in 5-minute steps (5 min up to 60 min).
  • Audio Feedback: Piezo buzzer delivers audible clicks on button press and a celebratory victory fanfare when the timer completes.
  • Robust Firmware:
    • Clean Finite State Machine (FSM): IDLE, RUNNING, PAUSED, and COMPLETED.
    • Fully non-blocking timekeeping using millis().
    • Software debouncing (50 ms) utilizing internal ESP32 pull-ups (INPUT_PULLUP).
    • Flicker-free LCD updates (no full-screen clears during ticks).
  • Hardware Ready: Includes complete KiCad electrical schematics (.kicad_sch) and printed circuit board design (.kicad_pcb).

📁 Repository Structure

text
ESP32-Pomodoro-Timer/
├── Hardware/                          # KiCad electronics design files
│   ├── ESP32 Pomodoro Timer.kicad_sch # Schematic diagram
│   ├── ESP32 Pomodoro Timer.kicad_pcb # PCB routing and layout
│   └── ESP32 Pomodoro Timer.kicad_pro # KiCad project configuration
│
├── ESP32 Pomodoro Timer/              # PlatformIO embedded firmware
│   ├── include/                       # Header declarations
│   ├── lib/                           # Third-party libraries
│   │   └── LiquidCrystal_I2C/         # I2C LCD control library
│   ├── src/
│   │   └── main.cpp                   # Core application logic & state machine
│   ├── test/                          # Unit tests
│   └── platformio.ini                 # PlatformIO environment configuration
│
├── .gitignore                         # Build and temporary files exclusion
├── diagram.json                       # Wokwi simulation diagram
├── wokwi.toml                         # Wokwi simulation configuration
└── README.md                          # Project documentation

🔌 Hardware Pinout & Wiring

ComponentPin / TerminalESP32 GPIODescription
LCD1602 (I2C Backpack)SDAGPIO 21I2C Data Line (50 kHz clock rate)
SCLGPIO 22I2C Clock Line
VCCVIN / 5VModule power supply & backlight
GNDGNDCommon ground
Start / Pause ButtonPin 1 / SwitchGPIO 18Active-LOW (Internal INPUT_PULLUP)
Pin 2 / SwitchGNDGround connection
Reset ButtonPin 1 / SwitchGPIO 19Active-LOW (Internal INPUT_PULLUP)
Pin 2 / SwitchGNDGround connection
Set Time ButtonPin 1 / SwitchGPIO 23Active-LOW (Internal INPUT_PULLUP)
Pin 2 / SwitchGNDGround connection
Piezo BuzzerPositive (+)GPIO 25PWM tone signal
Negative (-)GNDGround connection

Note on LCD Power: Most LCD1602 I2C backpacks require 5V (VIN) for bright backlight and optimal character contrast. The I2C data lines (SDA/SCL) operate smoothly at 3.3V logic levels on the ESP32.


🖥️ Display UI & State Machine

The firmware implements a responsive, non-blocking finite state machine displayed across 2 rows of 16 characters:

1. Ready / Idle State (STATE_IDLE)

Allows setting the session duration using the Set Time button:

text
+----------------+
|[READY]  Set:25m|
|Time:    25:00  |
+----------------+

2. Focus / Running State (STATE_RUNNING)

Active countdown with elapsed ratio visual progress bar:

text
+----------------+
|FOCUS TIME...   |
|24:12 [===   ]  |
+----------------+

3. Paused State (STATE_PAUSED)

Temporarily pauses countdown without losing elapsed progress:

text
+----------------+
|[PAUSED]        |
|Time:    18:45  |
+----------------+

4. Completed State (STATE_COMPLETED)

Fires when the timer reaches zero, accompanied by a triple-beep audio chime:

text
+----------------+
|*** TIME'S UP **|
|GREAT JOB!   :D |
+----------------+

🚀 Getting Started

Prerequisites

Flashing the Firmware

  1. Clone the repository:

    bash
    git clone https://github.com/TamarHoory/ESP32-Pomodoro-Timer.git
    cd ESP32-Pomodoro-Timer
  2. Open in VS Code:

    • Open VS Code.
    • Go to File > Open Folder... and select the ESP32 Pomodoro Timer folder (or the root workspace).
  3. Build & Upload:

    • Click the PlatformIO Build (✓) icon in the bottom status bar, or run:
      bash
      pio run
    • Connect your ESP32 board and click Upload (→), or run:
      bash
      pio run --target upload
  4. Monitor Serial Output:

    • Open the serial monitor at 115200 baud:
      bash
      pio device monitor

Running via Wokwi Simulation:

You can test and run this project without physical hardware using the Wokwi simulator:

text
  1. Make sure you have the **Wokwi Simulator** extension installed in VS Code.
  2. Open the project folder in VS Code.
  3. Open the `diagram.json` file, and click the **Play** button (or use the command palette `Wokwi: Start Simulator`) to run the interactive simulation with the virtual ESP32, LCD, and buttons.

🛠️ Hardware Fabrication (KiCad)

The Hardware/ folder contains native KiCad files:

  • ESP32 Pomodoro Timer.kicad_sch: Electrical schematic connecting the ESP32 Dev board, tactile buttons, buzzer, and I2C connector header.
  • ESP32 Pomodoro Timer.kicad_pcb: 2-layer PCB layout with traces, component placements, and mounting holes.

To export Gerber files for PCB manufacturing (JLCPCB, PCBWay, etc.):

  1. Open ESP32 Pomodoro Timer.kicad_pro in KiCad.
  2. In the PCB editor, navigate to File > Fabrication Outputs > Gerbers (.gbr).
  3. Generate drill files via File > Fabrication Outputs > Drill Files (.drl).
  4. Compress the output directory into a .zip archive for ordering.

👤 Author

Tamar Hoory


📜 License

This project is open-source and available under the MIT License.

Parts

6
QtyValueFootprintReferences
1BuzzerBuzzer_Beeper:Buzzer_12x9.5RM7.6BZ1
1ESP32-WROVER-EPCM_Espressif:ESP32-DevKitCU1
1RC1602ADisplay:LCD-016N002LU2
1RESETButton_Switch_THT:SW_PUSH_6mm_H4.3mmSW2
1Set TimeButton_Switch_THT:SW_PUSH_6mm_H4.3mmSW3
1Start/StopButton_Switch_THT:SW_PUSH_6mm_H4.3mmSW1

Similar boards

  • 4 layers28 × 80 mmESP32-PoE Rev M, the printed circuit board in 3D

    ESP32-PoE Rev M

    OLIMEX/ESP32-POE

    ESP32 IoT development board with 100Mb Ethernet and 802.3 Power Over Ethernet (POE)

    142 parts415Apache-2.0
  • 6 layers83.5 × 56 mmEspiff v3 1, the printed circuit board in 3D

    Espiff v3 1

    MDCservice/EsPiFF

    An ESP32 in the Raspberry Pi form factor

    172 parts223GPL-3.0
  • 2 layers84.2 × 52 mmPicoPico, the printed circuit board in 3D

    PicoPico

    DavidVentura/PicoPico

    Pico-8 Player

    57 parts141
  • 2 layers80 × 50 mmThermal Camera, the printed circuit board in 3D

    Thermal Camera

    Circuit-Digest/MLX90640-Thermal-Camera

    An Open Source Thermal Imaging IR camera that you can build yourserlf

    66 parts94
  • 4 layers239.5 × 239.5 mmBroadcast clock, the printed circuit board in 3D

    Broadcast clock

    espena/broadcast-clock

    Digital precision studio/broadcast masterclock with WiFi configuration, acts as local NTP server with accurate GPS time sync.

    440 parts28GPL-3.0
  • 2 layers58.8 × 55.7 mmAiO i2s DAC, the printed circuit board in 3D

    AiO i2s DAC

    martinroger/ipodesp32

    An iPod emulator for 2006-2013 BMW Mini Coopers that need Bluetooth

    102 parts24MIT
  • 2 layers99.1 × 49.9 mmRc fabgl, the printed circuit board in 3D

    Rc fabgl

    PickledDog/rc-fabgl

    FabGL terminal board for RC2014

    47 parts17Apache-2.0
  • 2 layers82 × 82 mmFtduino32, the printed circuit board in 3D

    Ftduino32

    harbaum/ftduino32

    ESP32 based variant of the ftDuino

    157 parts5

Questions

What parts does the ESP32-Pomodoro Timer use?

6 parts, built around the ESP32-WROVER-E(4MB). 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 ESP32-Pomodoro Timer KiCad files?

From the TamarHoory/ESP32-Pomodoro-Timer repository on GitHub, at the commit this page was made from: the board is Hardware/ESP32 Pomodoro Timer.kicad_pcb and its schematic Hardware/ESP32 Pomodoro Timer.kicad_sch. PCBKit opens the board in the browser, with nothing to install.

Can I use the ESP32-Pomodoro Timer design in my own project?

Its repository publishes it under the MIT licence: you may reuse it on that licence's terms (keep the author's notice, and for a copyleft licence share your changes alike).