Skip to the content
PCBKitNew board
2 layers21.5 × 14.9 mmWs2812buttons, the printed circuit board in 3D
Size
21.5 × 14.9 mm
Copper layers
2
Thickness
1.6 mm
Parts
6
Nets
5
Pads
15
Tracks, vias
33, 0
Pours
1
Routed
Yes
KiCad
KiCad 6 (file 20211014)
Created
18 Jul 2022
Updated
25 Mar 2023

Overview

Ws2812buttons is an open-source printed circuit board by Gi7mo, from the Gi7mo/G-CodeButtons repository on GitHub, published under the GPL-3.0 licence. It is a 2-layer board of 21.5 × 14.9 mm with 6 parts on 5 nets, routed with 33 tracks and 0 vias.

It is built around the WS2812B. Its parts include 2 connectors, 1 IC and 1 diode.

Main components

1

README

README.md

G-Code Button PCB for Agent Cain's Gcode Buttons

BOM

Part NO.QtyLCSCAli
Conn_01x031C131339Link
Conn_01x041C131334Link
WS2812-50501C114586Link
ROMER_G1---Link

Assembly

  • Order the pcb at e.g. pcbway or jlcpcb
  • Order the buttons at e.g. aliexpress
  • Order the PH connectors at e.g. aliexpress
  • Assemble the PCB, the led is solderable by hand with a fine tip
  • Wire up the pcbs to your controller
    • You can wire multiple pcb's in series, just go from data out (DO) to data in (DI) and expose only the switch (SW) cable for every pcb to your controller
  • Add them as gcode buttons to your config
text
[gcode_button _EMERGENCY]
pin: ^!PE8
press_gcode:
    M112
  • if you wan't e.g. a color change during press and macro execution, you can do it like this
text
[gcode_button _FILAMENT_UNLOAD]
pin: ^!PC12
press_gcode:
    SET_LED LED=buttons RED=1 GREEN=0 BLUE=0 index=2
    FILAMENT_UNLOAD
    SET_LED LED=buttons RED=1 GREEN=0.5 BLUE=0 index=2
  • assembled
  • bottom
  • skirt

Troubleshooting

  • Problem: My Leds showing Random colors
    • Solution: Add a ~400Ω Resistor on the data line

Notes

  • You can contact me via Discord "Gi7mo!#4618"
  • This readme file contains Amazon Associate, Aliexpress affiliate, PCBWay affiliate links. I make a comission on qualifying purchases.
  • This project does not come with any warranty, if you choose to build/use one, you are doing this at your own risk!

Parts

6
QtyValueFootprintReferences
1B3K-T13L_my_own:Omron B3K-T13LU1
1Conn_01x03_MaleConnector_JST:JST_PH_B3B-PH-K_1x03_P2.00mm_VerticalJ2
1Conn_01x04_MaleConnector_JST:JST_PH_B4B-PH-K_1x04_P2.00mm_VerticalJ1
1G***kibuzzard-62B786EEkibuzzard-62B786EE
1G***kibuzzard-62A4DD9Fkibuzzard-62A4DD9F
1WS2812BLED_SMD:LED_WS2812B_PLCC4_5.0x5.0mm_P3.2mmD1

Questions

How big is the Ws2812buttons PCB?

It measures 21.5 × 14.9 mm and has 2 copper layers, 1.6 mm thick.

What parts does the Ws2812buttons use?

6 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 Ws2812buttons KiCad files?

From the Gi7mo/G-CodeButtons repository on GitHub, at the commit this page was made from: the board is KiCad/ws2812buttons.kicad_pcb. PCBKit opens the board in the browser, with nothing to install.

Can I use the Ws2812buttons design in my own project?

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

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