Skip to the content
2 layers44 × 21 mmXiao led module-, the printed circuit board in 3D

2 sided addressable LED matrix module for Xiao ESP32-C3

Size
44 × 21 mm
Copper layers
2
Thickness
1.6 mm
Parts
52
Nets
71
Pads
234
Tracks, vias
487, 29
Pours
2
Routed
Yes
KiCad
KiCad 9.0 (file 20241229)
Created
25 Sep 2026
Updated
25 Sep 2026

Overview

Xiao led module- is an open-source printed circuit board by n2048-creative-technology, from the n2048-creative-technology/xiao-led-module- repository on GitHub. It is a 2-layer board of 44 × 21 mm with 52 parts on 71 nets, routed with 487 tracks and 29 vias.

It is built around the WS2812B. Its parts include 50 diodes, 1 IC and 1 connector. It belongs with the lEDs and displays boards and the ESP32 and RISC-V boards of this library.

Main components

1

README

README.md

XIAO LED Module

A 44 x 21 mm addressable-LED panel built around a Seeed Studio XIAO ESP32-C3, driving 50 WS2812B-compatible RGB LEDs (2020 package) arranged as two 25-LED daisy chains, plus a 4-pin JST-PH connector for external power/data breakout.

3D Renders

Top side (LED array)Bottom side (XIAO socket)
PCB top 3D renderPCB bottom 3D render

PCB isometric 3D render

Schematic

Schematic

Full-resolution vector version: docs/images/schematic.pdf

PCB Layout

PCB layout

Copper (F.Cu / B.Cu), silkscreen, and solder mask layers, board outline shown.

Board Specs

  • Size: 44.05 mm x 21.05 mm
  • Layers: 2 (F.Cu / B.Cu)
  • MCU: Seeed Studio XIAO ESP32-C3 (socketed, not soldered — see Manufacturing below)
  • LEDs: 50x WS2812B-compatible addressable RGB LED, 2020 package, arranged as two independent 25-LED daisy chains (LEDA / LEDB) driven from separate GPIO pins
  • Power/data breakout: J2, 4-pin JST-PH 2.0mm right-angle SMD connector
  • Power in: +5V rail feeds the LED array; XIAO module handles its own onboard 3.3V regulation

Bill of Materials

All parts verified against the live JLCPCB Open Platform API (real-time stock/pricing).

RefPartLCSC #LibraryQty
D1-D50XL-2020RGBC-2812B (WS2812B-compatible RGB LED)C5349955Extended50
J2WAFER-PH2.0-4PWB (JST-PH-compatible 4-pin SMD connector)C3029442Extended1
U1Seeed XIAO ESP32-C3—Not JLCPCB-assembled, see below1

Part substitution notes

  • D1-D50 (LEDs): the schematic's original part, WS2812B-2020 (LCSC C965555), has only 4 units in live JLCPCB stock — unusable for a 50-LED board. Replaced with XL-2020RGBC-2812B (C5349955, 127,770 in stock) — confirmed via XINGLIGHT's datasheet to share the same 2.0x2.0mm package, the same VDD/GND/DI/DO pin-out, and WS2812 protocol compatibility. Direct drop-in on the existing WS2812_2020 footprint.
  • J2 (connector): the original part, JST S4B-PH-SM4-GW-TB (LCSC C265331), shows 0 units in stock. Replaced with WAFER-PH2.0-4PWB (C3029442, 45,426 in stock) — same 4-pin, 2.0mm-pitch, right-angle SMD JST-PH-compatible connector family, confirmed on the existing JST_1x04_P2.0mm_Horizontal_SMD footprint.
  • U1 (XIAO module): the board footprint (XIAO-ESP32-C3-DIP) is a socket pattern — 14 pads in 2 rows at 2.54mm pitch, each with both a through-hole and an SMD land, designed so a plug-in XIAO module can be inserted rather than reflow-soldered. JLCPCB does not stock a machine-placeable 2.54mm female pin socket (a known limitation for tall THT sockets on their SMT assembly line), so U1 is marked DNP (Do Not Populate) in the BOM/CPL. The board still gets the correct through-holes drilled; hand-solder a standard 1x7, 2.54mm female header pair into the U1 pads after fabrication, then plug in your XIAO ESP32-C3.

Manufacturing

production/ contains regenerated, verified fabrication files:

  • xiao_led_module_gerbers.zip — Gerbers + Excellon drill file (upload directly to JLCPCB's PCB order)
  • bom.csv — JLCPCB-format BOM (Comment/Designator/Footprint/LCSC Part #) covering the 51 machine-assembled parts (50 LEDs + J2). U1 is intentionally excluded — see part substitution notes above.
  • positions.csv — CPL / pick-and-place file, generated with --exclude-dnp so U1 is correctly omitted from placement while everything else retains accurate position/rotation/side data

3D view in KiCad

  • D1-D50 (LEDs): the WS2812_2020 footprint carries a real, present STEP model — renders correctly out of the box.
  • J2 (connector): the SMD JST-PH "SM4" footprint family has no 3D model anywhere, including KiCad's own upstream kicad-packages3D repo — a known gap in the official library, not something fixable from this repo. A through-hole JST-PH variant (S4B-PH-K, LCSC C157926, 18,711 in stock) does have a working model, but switching to it means a mechanical footprint change (SMD → THT); left as SMD per current board design.
  • U1 (XIAO module): the footprint's bundled 3D models point at ${AMZPATH}, a third-party model pack (from whoever originally authored this footprint) that isn't publicly distributed anywhere findable. Seeed's own official OPL KiCad library ships the identical footprint with the same broken reference. JLCPCB-side alternatives (direct XIAO ESP32-C3 module SKUs C19189385 and C18212168) are both essentially out of stock (0 and 1 units, respectively) regardless, so U1 was staying DNP either way — the missing 3D preview here is cosmetic only.

Design Rule Check status

kicad-cli pcb drc reports 12 violations (4 starved-thermal errors on zone-connected pads, plus silkscreen/track warnings) — all confirmed pre-existing in the original committed board, unrelated to this sourcing pass (verified via git stash diff-check: identical violation set before and after the BOM/CPL changes). No new errors introduced by the part substitutions.

Repo Layout

text
xiao led module.kicad_pro   KiCad project
xiao led module.kicad_sch   Schematic
xiao led module.kicad_pcb   PCB layout
docs/images/                 Renders and diagrams (this README)
production/                   JLCPCB-ready fabrication output:
  xiao_led_module_gerbers.zip    Gerbers + drill (upload as-is)
  bom.csv                        JLCPCB BOM (50 LEDs + J2; U1 excluded, DNP)
  positions.csv                  CPL / pick-and-place file (DNP-excluded)
  gerbers/                       Individual Gerber/drill layer files

Parts

52
QtyValueFootprintReferences
50WS2812BPCM_SparkFun-LED:WS2812_2020D1, D2, D10, D11, D12, D13, D14, D15, D16, D17, D18, D19, D20, D21, D22, D23 +34
1Conn_01x04PCM_SparkFun-Connector:JST_1x04_P2.0mm_Horizontal_SMDJ2
1XIAO-ESP32-C3-DIPNew_XIAO_Series_Footprints:XIAO-ESP32-C3-DIPU1

Similar boards

  • 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
  • 2 layers285.5 × 95 mmReviung46 ver1 1, the printed circuit board in 3D

    Reviung46 ver1 1

    gtips/reviung

    The REVIUNG41 is 41-key column staggered keyboard.

    119 parts517MIT
  • 2 layers177.7 × 144.5 mmCOMM PANEL, the printed circuit board in 3D

    COMM PANEL

    jrsteensen/OpenHornet

    OpenHornet 1:1 F/A-18C Simulator Repository

    275 parts431

Questions

How big is the Xiao led module- PCB?

It measures 44 × 21 mm and has 2 copper layers, 1.6 mm thick.

What parts does the Xiao led module- use?

52 parts, built around the WS2812B. 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 Xiao led module- KiCad files?

From the n2048-creative-technology/xiao-led-module- repository on GitHub, at the commit this page was made from: the board is xiao led module.kicad_pcb and its schematic xiao led module.kicad_sch. PCBKit opens the board in the browser, with nothing to install.

Can I use the Xiao led module- design in my own project?

Its repository states no licence, so its author keeps all rights: ask n2048-creative-technology before reusing the design.