Skip to the content
2 layers76.2 × 93.3 mmChristmasPCB2025, the printed circuit board in 3D

This project provides hardware and firmware for an ESP32-C3 based Christmas-themed PCB that controls an array of addressable LEDs and plays Christmas songs via a buzzer.

Size
76.2 × 93.3 mm
Copper layers
2
Thickness
1.6 mm
Parts
23
Nets
29
Pads
83
Tracks, vias
297, 50
Pours
1
Routed
Yes
KiCad
KiCad 9.0 (file 20241229)
Created
6 Dec 2023
Updated
29 Nov 2025

Overview

ChristmasPCB2025 is an open-source printed circuit board by Casperdroid5, from the Casperdroid5/Christmas-PCBs repository on GitHub. It is a 2-layer board of 76.2 × 93.3 mm with 23 parts on 29 nets, routed with 297 tracks and 50 vias.

It is built around the WS2812B and DTSM-61R-V-T/R. Its parts include 9 diodes, 6 resistors, 1 IC, 1 transistor and 1 fuse. It belongs with the ESP32 and RISC-V boards of this library.

Main components

2

README

Christmas-PCB2025/README.md

Christmas ball-card 🎄

This project provides hardware and firmware for an ESP32-C3 based Christmas-themed PCB that controls an array of addressable LEDs and plays Christmas songs via a buzzer. It includes local controls via two buttons, an automatic 6-hour timer, battery monitoring, and as an extra: a WiFi-based configuration interface.


✨ Features

  • LED Control: Drives 8 WS2812B (or compatible) addressable RGB LEDs using the FastLED library.
  • Christmas Music: Plays a selection of classic Christmas songs through a dedicated buzzer.
  • Timer Functionality: Features a 6-hour "ON" timer that cycles every 24 hours (this can be toggled on/off by holding button 1).
  • Local Control: Two physical buttons for easy control of patterns, music, and the timer.
  • WiFi Configuration: A temporary Access Point (AP) mode for changing persistent settings via a simple web interface.
  • Ambient Light Sensing: Support for an LDR (Light Dependent Resistor) to potentially adjust brightness based on the environment. (not implemented)

🛠️ Hardware Requirements

The firmware is designed for a custom board based on the ESP32-C3 microcontroller.

ComponentPin (GPIO)Description
RGB LED Data3Data line for the WS2812B LED strip/array (8 LEDs total).
Buzzer/Speaker10Output for playing musical tones.
Button 14Multi-function button (Pattern change / Timer toggle).
Button 25Music control (Play/Stop).
Battery Sense0Analog input for battery voltage monitoring.
LDR Pin2Analog input for ambient light sensing (Light Dependent Resistor).

⚙️ Software Setup & Building

This project is built using the PlatformIO ecosystem within Visual Studio Code or as a standalone CLI tool.

Dependencies

The platformio.ini file automatically manages these dependencies:

  1. Espressif 32 Platform
  2. Arduino Framework
  3. FastLED (for controlling the addressable LEDs)

Build Instructions

  1. Install PlatformIO (VS Code extension or CLI).
  2. Open the project folder.
  3. Ensure your environment matches the configuration in platformio.ini: [env:esp32-c3-devkitm-1].
  4. Use the PlatformIO commands to build and upload the firmware:
    bash
    # Build the project
    pio run
    
    # Upload to the device (assuming it is connected)
    pio run --target upload

🕹️ Usage & Controls

The device is controlled primarily through the two onboard buttons.

ControlActionFunction
Button 1 (Short Press)Press and release quickly.Change LED Pattern: Cycles through the available light effects.
Button 1 (Long Press)Hold for 1 second.Toggle 6h Timer: Enables or disables the automatic 6-hour run timer.
Button 2 (Any Press)Press to toggle.Play/Stop Songs: Toggles the Christmas music playback.
Both ButtonsHold simultaneously for 1 second.Toggle WiFi AP Mode: Enters the configuration mode for web-based settings.

🌐 Configuration (WiFi Access Point Mode)

The device supports over-the-air (OTA) configuration using a temporary WiFi Access Point.

Entering AP Mode

  1. Press and hold both Button 1 and Button 2 simultaneously for approximately two seconds.
  2. The device will enable the Access Point (create a network you can connect to)

Web Configuration

  1. On a smartphone or computer, search for the new WiFi network created by the device (it will be recognizable by "Kerstbal_NAME".
  2. Connect to the Access Point (your device will likely complain that there is no wifi connection available, connect anyways).
  3. Once connected, you can navigate to http://192.168.4.1 in your browser (like firefox of chrome)
  4. The web interface will allow you to modify settings stored in the Christmas card.

AP Timeout

For security and power-saving, the WiFi Access Point will automatically turn off after 5 minutes (300,000 milliseconds) of inactivity. To re-enable it, repeat the two-button press. Wifi will only work when connected to a USB power source (not using batteries)

Parts

23
QtyValueFootprintReferences
8WS2812BCustomLed:LED_WS2812B_PLCC4_5.0x5.0mm_P3.2mmLED1, LED2, LED3, LED4, LED5, LED6, LED7, LED8
310kResistor_SMD:R_1206_3216Metric_Pad1.30x1.75mm_HandSolderR1, R2, R4
2DTSM-61R-V-T/Reasyeda2kicad:KEY-SMD_4P-L6.2-W6.2-P4.50-LS9.0BUTTON1, BUTTON2
1100Resistor_SMD:R_1206_3216Metric_Pad1.30x1.75mm_HandSolderR5
11N5819_C437199easyeda2kicad:SMA_L4.4-W2.6-LS5.0-RDD1
1200Resistor_SMD:R_1206_3216Metric_Pad1.30x1.75mm_HandSolderR3
12N7002_C306856easyeda2kicad:SOT-23-3_L2.9-W1.3-P1.90-LS2.4-BRQ1
15kResistor_SMD:R_1206_3216Metric_Pad1.30x1.75mm_HandSolderR7
1ESP32-C3_SUPERMINI_THcustom:MODULE_ESP32-C3_SUPERMINIU1
1KSSGK4B16-20CustomPartsCRT:KSSGK4B16-20LS1
1LDR07OptoDevice:R_LDR_5.1x4.3mm_P3.4mm_VerticalLDR1
1Resetable fuse 0.75AFuse:Fuse_1206_3216Metric_Pad1.42x1.75mm_HandSolderF1
1SolderJumper_2_OpenJumper:SolderJumper-2_P1.3mm_Open_Pad1.0x1.5mmJP1

More from Casperdroid5/Christmas-PCBs

1
  • 2 layers61.2 × 78.7 mmChristmas, the printed circuit board in 3D

    Christmas

    Casperdroid5/Christmas-PCBs

    This project provides hardware and firmware for an ESP32-C3 based Christmas-themed PCB that controls an array of addressable LEDs and plays Christmas songs via a buzzer.

    13 parts

Similar boards

  • 2 layers150 × 150 mmBirtdayCard, the printed circuit board in 3D

    BirtdayCard

    Casperdroid5/BirthdayCard

    Personal message ESP32 C3 wroom02 module based birthday card PCB for my brother

    57 parts
  • 2 layers99.1 × 99.1 mmKinderdorp PCB, the printed circuit board in 3D

    Kinderdorp PCB

    Casperdroid5/Kinderdorp-PCB

    An interactive educational PCB designed for children to learn electronics through hands-on experimentation with LEDs, sensors, and programming.

    44 parts
  • 4 layers99 × 53.3 mmPSLab, the printed circuit board in 3D

    PSLab

    fossasia/pslab-hardware

    PSLab Hardware Design and Schematics https://pslab.io

    199 parts1.7kApache-2.0
  • 2 layers26 × 30 mmMicrocontroller, the printed circuit board in 3D

    Microcontroller

    FrameworkComputer/ExpansionCards

    Reference designs and documentation to create Expansion Cards for the Framework Laptop

    34 parts1.1kCC-BY-4.0
  • 4 layers82.6 × 82.5 mmJumperless2, the printed circuit board in 3D

    Jumperless2

    Architeuthis-Flux/Jumperless

    A jumperless breadboard

    208 parts914
  • 2 layers95.3 × 161.9 mmDfh badge, the printed circuit board in 3D

    Dfh badge

    tanaes/whopping_Voron_mods

    135 parts787GPL-3.0
  • 2 layers42.8 × 28.8 mmMM Skirt, the printed circuit board in 3D

    MM Skirt

    PrintersForAnts/Micron

    If you want to purchase full kits there are 3 available (Kits are slowly updating to R1 hardware just make sure to double check the included hardware in your kit and if you have any questions reach out in the discord)

    11 parts741GPL-3.0
  • 2 layers149.6 × 127.1 mmErgodash, the printed circuit board in 3D

    Ergodash

    omkbd/ErgoDash

    keyboard

    187 parts732MIT

Questions

How big is the ChristmasPCB2025 PCB?

It measures 76.2 × 93.3 mm and has 2 copper layers, 1.6 mm thick.

What parts does the ChristmasPCB2025 use?

23 parts, built around the WS2812B and DTSM-61R-V-T/R. 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 ChristmasPCB2025 KiCad files?

From the Casperdroid5/Christmas-PCBs repository on GitHub, at the commit this page was made from: the board is Christmas-PCB2025/ChristmasPCB2025.kicad_pcb and its schematic Christmas-PCB2025/ChristmasPCB2025.kicad_sch. PCBKit opens the board in the browser, with nothing to install.

Can I use the ChristmasPCB2025 design in my own project?

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