Skip to the content
2 layers83.2 × 82.6 mmLED Matrix Sim, the printed circuit board in 3D

A collection of visual simulations for a 16x16 WS2812B LED matrix, powered by ESP32.

Size
83.2 × 82.6 mm
Copper layers
2
Thickness
1.6 mm
Parts
21
Nets
31
Pads
83
Tracks, vias
65, 0
Pours
2
Routed
Yes
KiCad
KiCad 9.0 (file 20241229)
Created
27 Apr 2026
Updated
28 Apr 2026

Overview

LED Matrix Sim is an open-source printed circuit board by IsaacRudnick, from the IsaacRudnick/LED-Matrix-Sim repository on GitHub. It is a 2-layer board of 83.2 × 82.6 mm with 21 parts on 31 nets, routed with 65 tracks and 0 vias.

Its parts include 5 resistors, 5 connectors and 5 switches. It belongs with the lEDs and displays boards of this library.

README

README.md

LED Matrix Simulation Hub

A collection of visual simulations for a 16x16 WS2812B LED matrix, powered by ESP32.

Simulations

NameDescriptionReset Condition
Game of LifeConway's cellular automaton with RGB color mixing. Cells inherit averaged colors from parent neighbors.Resets when pattern becomes stable
Langston's AntTurmite simulation where each ant follows a unique Turing machine ruleset: Red (RL - classic), Green (RLR - highway patterns), Blue (LLRR - symmetric), Yellow (LRRL - chaotic). Ants spawn at random positions and wrap around edges.Never (continuous)
Brian's BrainThree-state cellular automaton. Cells are Off, On, or Dying. Off cells with exactly 2 On neighbors turn On; On cells become Dying; Dying cells turn Off. Creates chaotic, self-sustaining patterns.Resets when pattern becomes stable
FireHeat-based fire effect using a palette from black through red, orange, yellow to white.Never (continuous)
RainFalling raindrops with trails against a dark blue background.Never (continuous)
SleepStatic moon + ZZ icon at minimal brightness for nighttime use.Never (static)

Hardware

Bill of Materials

ComponentDetails
MCUESP-32S Dev Module
LED Matrix16×16 WS2812B flexible matrix
Buttons5× momentary tactile pushbuttons
Connectors1× 2-pin Phoenix connector, 1× 3-pin Phoenix connector

PCB design files are in KiCad/. GerberOrder_v3.zip contains ready-to-order Gerbers.

Wiring

The LED matrix is powered directly from the ESP-32S's VIN pin (5V), which is why MAX_BRIGHTNESS is kept low — drawing too much current through VIN can cause instability. The data line connects to GPIO 26. Each button connects between its GPIO pin and GND; the ESP-32S's internal pullups keep the lines high when the button is open — no external pull-up resistors are needed on the PCB.

ButtonGPIO
Brightness Down16
Next Simulation17
Brightness Up18
Previous Simulation19
On / Off5

Controls

ButtonAction
Next SimCycles sub-modes within the current simulation first; once all sub-modes are exhausted, advances to the next simulation
Prev SimCycles sub-modes in reverse; once at sub-mode 0, goes back to the previous simulation at its last sub-mode
Brightness Up / DownAdjusts brightness in steps between MIN_BRIGHTNESS and MAX_BRIGHTNESS
On / OffToggles the display; off state shows a dim sleep icon

The current simulation, sub-mode, brightness, and on/off state are saved to EEPROM and restored on power-up.

3D Printing & Assembly

Print files are in the print_files/ directory. Each file contains exactly the quantity needed — print one of each.

Parts

FileMaterialNotes
FrontPlate.stepWhite PLA → Black PLASee filament change instructions below
BackPanel.stepAny—
SupportArms.stepAnyContains both arms (left and right mirror)
CrossBar.stepAny—

FrontPlate — Filament Change

The front plate has a solid face followed by a raised grid pattern. Print the first layers in white PLA, then pause and switch to black (or other dark) filament at the layer where the grid begins to appear.

The solid white face must be at least 2 layers thick before the grid emerges — 3 layers works well. Set your layer height accordingly and add the filament-change pause in your slicer at the correct layer.

Assembly

  1. BackPanel — Press an M3 nut into each of the 3 hexagonal recesses on the back. Mount the PCB onto the front face of the panel using M3×10 screws through the PCB into the nuts.

  2. SupportArms — Snap both arms into the back panel, then slide them into the dovetail slots on the front plate.

  3. CrossBar — Press the crossbar between the two arms until it friction-fits into place.

Building

Requires PlatformIO.

bash
# Build
pio run

# Upload
pio run -t upload

# Monitor serial output
pio device monitor

You can also use the PlatformIO IDE in VSCode for a more integrated experience. I recommend this.

Note that if your upload fails, you may need to install the CP210x USB to UART Bridge VCP Drivers for your operating system.

Project Structure

text
include/
├── Config.h              # Pin definitions, dimensions, timing constants
├── Display.h             # LED buffer and animation functions
├── Simulation.h          # Base class interface for all simulations
└── simulations/
    ├── GameOfLife.h
    ├── LangstonAnt.h
    ├── BriansBrain.h
    ├── Fire.h
    ├── Rain.h
    └── SleepMode.h
src/
├── main.cpp              # Setup, loop, simulation registry
├── Display.cpp           # showBuffer, fadeOut, sweepIn, mapXYtoIndex
└── simulations/
    ├── GameOfLife.cpp
    ├── LangstonAnt.cpp
    ├── BriansBrain.cpp
    ├── Fire.cpp
    ├── Rain.cpp
    └── SleepMode.cpp
print_files/
├── FrontPlate.step
├── BackPanel.step

Adding a New Simulation

  1. Create header in include/simulations/YourSim.h:
cpp
#ifndef YOURSIM_H
#define YOURSIM_H

#include "Simulation.h"

class YourSim : public Simulation {
public:
    void init() override;
    bool update() override;
    void render(uint8_t buffer[HEIGHT][WIDTH][3]) override;
    uint16_t getFrameDelayMs() override { return 33; }
    bool shouldReset() override { return false; }
    const char* getName() override { return "Your Sim"; }

private:
    // Your state here
};

#endif
  1. Create implementation in src/simulations/YourSim.cpp

  2. Add to main.cpp:

cpp
#include "simulations/YourSim.h"

YourSim yourSim;

Simulation* simulations[] = {
    // ... existing simulations
    &yourSim,
    &sleepMode  // Keep sleep last
};

Configuration

Key constants in include/Config.h:

ConstantDefaultDescription
DEFAULT_BRIGHTNESS20Normal brightness (0-255)
SLEEP_BRIGHTNESS1Sleep mode brightness
DEBOUNCE_DELAY_MS50Button debounce time
FADE_STEPS20Animation smoothness
SWEEP_TIME_MS1500Transition sweep duration

Simulation-specific constants are in their respective header files.

Dependencies

  • FastLED 3.8.0
  • ESP32 Arduino framework

Parts

21
QtyValueFootprintReferences
510kResistor_THT:R_Axial_DIN0207_L6.3mm_D2.5mm_P10.16mm_HorizontalR6, R7, R8, R9, R10
3Conn_01x01MountingHole:MountingHole_3.2mm_M3_DIN965_PadM1, M2, M3
2Conn_01x02TerminalBlock:TerminalBlock_MaiXu_MX126-5.0-02P_1x02_P5.00mmJ2, J3
2Conn_01x04Connector_PinSocket_2.54mm:PinSocket_1x04_P2.54mm_VerticalJ4, J5
1C_PolarizedCapacitor_THT:CP_Radial_D5.0mm_P2.50mm0.1uF1
1Conn_01x03TerminalBlock:TerminalBlock_MaiXu_MX126-5.0-03P_1x03_P5.00mmJ1
1Jumper_3_OpenConnector_PinHeader_2.54mm:PinHeader_1x03_P2.54mm_VerticalJP1
1SW_PushDownButton_Switch_THT:SW_PUSH_6mmSW6
1SW_PushLeftButton_Switch_THT:SW_PUSH_6mmSW3
1SW_PushMidButton_Switch_THT:SW_PUSH_6mmSW1
1SW_PushRightButton_Switch_THT:SW_PUSH_6mmSW4
1SW_PushUpButton_Switch_THT:SW_PUSH_6mmSW2
1~ESP32-DevKit-V1-DOIT-main:ESP32_30pin_NoMountingHolesESP32

Similar boards

  • 2 layers28.3 × 39.8 mmLevelShifter, the printed circuit board in 3D

    LevelShifter

    gusmanb/logicanalyzer

    24 channel, 100Msps logic analyzer hardware and software

    21 parts5.1kGPL-3.0
  • 2 layers171.2 × 72.9 mmAmiga gfxcard before pour, the printed circuit board in 3D

    Amiga gfxcard before pour

    mntmn/amiga2000-gfxcard

    MNT VA2000, an Open Source Amiga 2/3/4000 Graphics Card (Zorro II/III), written in Verilog

    21 parts1k
  • 2 layers93.9 × 46 mmRectifier, the printed circuit board in 3D

    Rectifier

    rene-dev/stmbl

    AC Servo Driver for STM32F4

    21 parts990GPL-3.0
  • 2 layers45.5 × 42.9 mmEsphome han reader, the printed circuit board in 3D

    Esphome han reader

    hackclub/OnBoard

    💡 Join 1,000 teenagers and make your first PCB with a $100 grant!

    21 parts915
  • 2 layers31.8 × 14.5 mmEsp prog, the printed circuit board in 3D

    Esp prog

    drandyhaas/KiCadRoutingTools

    A set of Python/Rust tools to aid routing in KiCad

    21 parts744MIT
  • 2 layers23.5 × 15.8 mmQuiverAttachPCB, the printed circuit board in 3D

    QuiverAttachPCB

    Arrow-air/project-quiver

    Project Quiver documentation, designs, and project artifacts.

    21 parts617CERN-OHL-S-2.0
  • 2 layers69.9 × 41.3 mmHeaterMeterLCD, the printed circuit board in 3D

    HeaterMeterLCD

    CapnBry/HeaterMeter

    HeaterMeter and LinkMeter Arduino BBQ Controller

    21 parts557MIT
  • 2 layers161.3 × 111.8 mmDoj, the printed circuit board in 3D

    Doj

    kelu124/echomods

    Open source ultrasound processing modules and building blocks

    21 parts463

Questions

How big is the LED Matrix Sim PCB?

It measures 83.2 × 82.6 mm and has 2 copper layers, 1.6 mm thick.

What parts does the LED Matrix Sim use?

21 parts. 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 LED Matrix Sim KiCad files?

From the IsaacRudnick/LED-Matrix-Sim repository on GitHub, at the commit this page was made from: the board is KiCad/KiCad.kicad_pcb and its schematic KiCad/KiCad.kicad_sch. PCBKit opens the board in the browser, with nothing to install.

Can I use the LED Matrix Sim design in my own project?

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