Skip to the content
2 layers86.5 × 73.5 mmPCB digitalscreen, the printed circuit board in 3D

This project showcases the design and development of a digital photo frame based on the ESP32. It extracts images from a Micro SD and renders them on a TFT ILI9341 display. It features low power consumption, the hardware includes a TP4056 module, for charging and uninterrupted operation. This project is beginner-friendly and easily customizable.

Size
86.5 × 73.5 mm
Copper layers
2
Thickness
1.6 mm
Parts
27
Nets
50
Pads
135
Tracks, vias
278, 34
Pours
2
Routed
Yes
KiCad
KiCad 10.0 (file 20260206)
Created
23 May 2026
Updated
27 Jun 2026

Overview

PCB digitalscreen is an open-source printed circuit board by pablovazquezmartinez, from the pablovazquezmartinez/Digital-Photo-Frame-ESP32 repository on GitHub, published under the MIT licence. It is a 2-layer board of 86.5 × 73.5 mm with 27 parts on 50 nets, routed with 278 tracks and 34 vias.

It is built around the TP4056-42-ESOP8. Its parts include 10 resistors, 6 connectors, 4 capacitors, 2 diodes and 1 IC. It belongs with the lEDs and displays boards and the ESP32 and RISC-V boards of this library.

Main components

1

README

README.md
image

ESP32 Digital Photo Frame

A DIY digital photo frame project using an ESP32 and an ILI9341 TFT display. This project features a dual SPI bus configuration to eliminate data interference and maximize image loading speeds. The repository also includes a custom PCB design, including all KiCad source and fabrication files. The board is production-ready and plug-and-play.

Key Features

  • Dual SPI Architecture: Uses separate buses for the Display (VSPI) and the SD Card (HSPI) for stable, high-speed performance.
  • Buffer-Optimized Rendering: Fast BMP processing using memory buffering.
  • Random Start: Picks a completely random image from the SD card every time it boots up.
  • Auto-Slideshow (Default): Advances to the next image every 5 seconds automatically.
  • Manual Control: Dedicated buttons for "Next" and "Previous" navigation.
  • Dynamic Mode Toggle: Switch between Manual and Auto modes by holding both buttons for 3 seconds.

Hardware Requirements

  • ESP32 DevKit V1
  • ILI9341 TFT Display (2.8" or 2.4" SPI)
  • Micro SD Card Module
  • 2x Push Buttons
  • Lithium Battery, Charger Module (TP4056) and toggle button (Optional)

Wiring & Pinout

To avoid boot loops and "strapping pin" conflicts, the following pinout is used.

[!IMPORTANT] The display used for the proyect do not have a CS pin. All GND have to be connected to the same GND ESP32 pin. VERY CAREFULL with the polarity of the battery, charger pins and conexions with ESP32. Refer to the Schematics.pdf file in this repository for the full visual circuit diagram.

ComponentPin NameESP32 PinSPI Bus
DisplayVCC3v3-
CLKGPIO 18VSPI
MOSIGPIO 23VSPI
RESGPIO 4-
DCGPIO 2-
BLK3v3-
MISOGPIO 19-
GNDGND-
SD CardCSGPIO 33HSPI
MOSIGPIO 25HSPI
CLKGPIO 22HSPI
MISOGPIO 32HSPI
3V33v3-
GNDGND-
ButtonsNextGPIO 27-
PrevGPIO 26-
GNDGND-
ChargerOut+VIN-
Out-GND-
ComponentPin NameCharger Pin
BatteryREDB+
BLACKB-

Image Preparation

To ensure the frame works correctly, your images must be formatted as follows:

  • Format: BMP (Windows 24-bit / R8 G8 B8).
  • Resolution: 320x240 pixels.
  • Storage: Place images in the root directory of a FAT32 formatted Micro SD card.

Automated Image Batch Converter (Python Script)

To save time, an automated Python utility is provided in the tools/ directory to process images in bulk.

The script prompts you for the full path of your source image folder. It then automatically scales, converts, and exports all compatible files into a newly created Images-ready-to-use/ directory.

Important: The ESP32 firmware expects images to be in the root directory of the SD card. When moving the processed files, copy the contents of the Images-ready-to-use folder directly into the SD card, rather than copying the folder itself.

Prerequisites

Before running the script, you need to have Python 3 installed on your computer and install the required image libraries.

  1. Install Python 3: Ensure Python is installed and added to your system's PATH.
  2. Install Libraries: Open your computer's terminal (Command Prompt, PowerShell, or Terminal) and run the following command to install the required dependencies:
bash
pip install pillow pillow_heif

User Controls

  • Manual Navigation: Press the "Next" (GPIO 27) or "Previous" (GPIO 26) button.
  • Mode Switch: Press and hold both buttons simultaneously for 3 seconds.
    • Green Label: Auto-mode active.
    • Red Label: Manual mode active.
  • On-off control: Press the toggle button conected to the battery.

PCB Design (Hardware)

This project includes the complete design of a production-ready custom carrier board. It is designed to be fully plug-and-play: you simply need to plug the ESP32 and the display into their respective sockets, with no manual soldering required.

Display Compatibility (Extra CS Pin)

The original design of this PCB is optimized for standard 8-pin displays. However, to maximize the project's compatibility, I have added an extra pin for displays that include a CS (Chip Select) pin.

At the hardware level, this additional control pin is physically routed to GPIO 15 on the ESP32.

Firmware Configuration:

If you are using an 8-pin display, you don't need to do anything (it works out of the box). But if your display requires the use of the CS pin, you must enable it in the software by following this simple step:

Go to the main code file (main) and locate line 10. You will need to change the disabled value (-1) to the corresponding pin (15).

cpp
// ❌ Default configuration (8-pin displays without CS):
#define TFT_CS -1

// ✅ Modified configuration (Displays with CS pin connected):
#define TFT_CS 15
photo6_PCB_front

Getting Started

  1. Clone this repository.
  2. Install Adafruit_ILI9341 and Adafruit_GFX libraries in your Arduino IDE.
  3. Upload the main.ino sketch to your ESP32.
  4. Check the Schematics.pdf for wiring details.

Code helped by AI Created by Pablo Vazquez

Parts

27
QtyValueFootprintReferences
510kΩResistor_SMD:R_0805_2012MetricR6, R7, R8, R9, R10
310μFCapacitor_SMD:C_0805_2012MetricC1, C2, C3
21kΩResistor_SMD:R_0805_2012MetricR3, R4
25,1kΩResistor_SMD:R_0805_2012MetricR1, R2
2Conn_01x15_SocketConnector_PinSocket_2.54mm:PinSocket_1x15_P2.54mm_VerticalJ2, J4
2SW_PushButton_Switch_SMD:SW_SPST_PTS645Sx43SMTR92Next_button1, Previous_button1
11,2kΩResistor_SMD:R_0805_2012MetricR5
1100nFCapacitor_SMD:C_0805_2012MetricC4
1Conn_01x02_PinConnector_JST:JST_PH_B2B-PH-K_1x02_P2.00mm_VerticalJ3
1Conn_01x08_SocketConnector_PinSocket_2.54mm:PinSocket_1x09_P2.54mm_VerticalJ6
1LED_GREEN_0805LED_SMD:LED_0805_2012MetricD1
1LED_RED_0805LED_SMD:LED_0805_2012MetricD2
1LOGOLOGOG***
1Micro_SD_CardConnector_Card:microSD_HC_Molex_104031-0811J5
1SW_SPDTButton_Switch_SMD:SW_SPDT_CK_JS102011SAQNOn-off_switch1
1TP4056-42-ESOP8Package_SO:SOIC-8-1EP_3.9x4.9mm_P1.27mm_EP2.29x3mmU1
1USB_C_Receptacle_USB2.0_14PConnector_USB:USB_C_Receptacle_XKB_U262-16XN-4BVC11J1

Similar boards

  • 2 layers60 × 111.3 mmSilkscreen pcb, the printed circuit board in 3D

    Silkscreen pcb

    iandchasse/silkscreen-pcb

    Silkscreen: open-hardware ESP32-S3 e-paper reader mainboard (KiCad 9). Formerly the de-link hub.

    189 parts589CERN-OHL-S-2.0
  • 2 layers96.8 × 91.4 mmInkbadge, the printed circuit board in 3D

    Inkbadge

    cheyao/inkbadge

    Undercity eink PCB badges controlled by a rp2350

    98 parts22
  • 2 layers51 × 21 mmFOX JACK EXT BOARD TOP, the printed circuit board in 3D

    FOX JACK EXT BOARD TOP

    KaliAssistant/Fox-Jack

    Portable social-engineering LAN tool for automated payloads and wired audits — based on Luckfox Pico Max

    35 parts22GPL-3.0
  • 2 layers31.3 × 67 mmRPBoard², the printed circuit board in 3D

    RPBoard²

    euvalennn/rpboard-squared

    Simple RP2350-based devboard

    63 parts9
  • 4 layers88 × 58 mmECG V-0.2, the printed circuit board in 3D

    ECG V-0.2

    Doenec/ecg-esp32

    open source project ecg with esp32 and ad8232

    115 parts8
  • 2 layers210 × 31 mmTrhw, the printed circuit board in 3D

    Trhw

    nimitvijayvargee/trhw

    This is an RP2040 ruler that implements wifi, bluetooth, BLE along with a 4MB Flash storage, LEDs, Input buttons and some cool units and lengths!

    59 parts8
  • 2 layers78 × 36 mmBt nes advantage pcb, the printed circuit board in 3D

    Bt nes advantage pcb

    cajunpanda/bluetooth-nes-advantage

    A bluetooth mod for the NES Advantage classic controller.

    45 parts7MIT
  • 2 layers61 × 61 mmESP32 FC, the printed circuit board in 3D

    ESP32 FC

    MAATHES-THILAK-K/ESP32-S3_FLIGHT_CONTROLLER

    A custom-designed flight controller based on the ESP32-S3 module, built for compatibility with the esp-fc firmware and Betaflight-like configuration.

    69 parts7Apache-2.0

Questions

How big is the PCB digitalscreen PCB?

It measures 86.5 × 73.5 mm and has 2 copper layers, 1.6 mm thick.

What parts does the PCB digitalscreen use?

27 parts, built around the TP4056-42-ESOP8. 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 PCB digitalscreen KiCad files?

From the pablovazquezmartinez/Digital-Photo-Frame-ESP32 repository on GitHub, at the commit this page was made from: the board is hardware/PCB/PCB_digitalscreen.kicad_pcb and its schematic hardware/Digital-Photo-Frame-ESP32.kicad_sch. PCBKit opens the board in the browser, with nothing to install.

Can I use the PCB digitalscreen 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).