Skip to the content
2 layers22 × 59 mmInterface, the printed circuit board in 3D

A LED Tube that works wireless and runs on a ESP32 with Arduino Framework

Size
22 × 59 mm
Copper layers
2
Thickness
1.6 mm
Parts
7
Nets
7
Pads
25
Tracks, vias
21, 0
Pours
1
Routed
Yes
KiCad
KiCad 7 (file 20221018)
Created
15 Mar 2024
Updated
14 Sep 2026

Overview

Interface is an open-source printed circuit board by nichtrami, from the nichtrami/led_tube repository on GitHub, published under the Apache-2.0 licence. It is a 2-layer board of 22 × 59 mm with 7 parts on 7 nets, routed with 21 tracks and 0 vias.

It belongs with the interfaces and adapters boards of this library.

README

README.md

LED Tube

Overview

This project controls 2-meter-long LED tubes built from a WS2812B LED strip with 120 LEDs. The firmware runs on an ESP32 (Arduino Core) and supports standalone operation, a custom wireless DMX protocol over ESP-NOW, wired DMX input, and an (experimental) Art-Net path.

The codebase builds two different devices from the same sources, selected via the DEVICE_MODE build flag in platformio.ini:

DevicePlatformIO envBoardRole
Tubeled_tubeSeeed XIAO ESP32-S3Drives one LED tube and receives commands
BridgebridgeESP32 dev boardGenerates/forwards commands to the tubes

Hardware Components

Schematics and PCB designs live in pcb/, enclosure models in body/.

Datasheets for the components used are not redistributed in this repository. The part numbers are given in the schematics and can be looked up on the manufacturers' sites.

User Interface (both devices)

  • Three buttons: Up, Down, Enter
  • A monochrome 0.91" OLED display (SSD1306) connected via I2C, showing the current menu item

Operating Modes

Tube

  1. Standalone – the tube shows a locally selected color and effect.
  2. Wireless DMX – the tube listens on a configurable DMX address and renders the data it receives from a bridge over ESP-NOW.

Bridge

  1. Master – generates beat-synchronized choreography (driven by a configurable BPM) for a configurable number of tubes and broadcasts it over ESP-NOW.
  2. DMX – reads a wired DMX universe (via esp_dmx) and forwards the relevant slice to the tubes over ESP-NOW.
  3. Art-Net – receives Art-Net over Ethernet (W5500). Experimental / partially implemented.

Channels

The Channel menu item (1–3) maps to distinct Wi-Fi channels for the ESP-NOW link, so multiple independent light systems can run side by side without interference. The bridge and its tubes must use the same channel.

Wireless Protocol

Communication uses ESP-NOW broadcast (no pairing). The payload is a lightweight DMX frame:

text
[ size (1 byte) ][ start_address (1 byte) ][ data ... up to 240 bytes ]

Each tube occupies TUBE_DATASET_SIZE (4) channels: effect, red, green, blue.

Pin Configuration

Pins are defined in src/Config.hpp.

Tube (Seeed XIAO ESP32-S3)

  • LED data: GPIO 4
  • OLED (I2C): SDA GPIO 3, SCL GPIO 2
  • Buttons: Up GPIO 9, Down GPIO 7, Enter GPIO 8

Bridge (ESP32 dev board)

  • LED data: GPIO 14
  • OLED (I2C): SDA GPIO 26, SCL GPIO 25
  • Buttons: Up GPIO 27, Down GPIO 32, Enter GPIO 33
  • DMX input: RX GPIO 16, EN/TX GPIO 17
  • Ethernet (W5500, SPI): CS GPIO 5, SCK GPIO 18, MISO GPIO 19, MOSI GPIO 23, RST GPIO 4

Building & Flashing

This is a PlatformIO project.

bash
# Tube firmware
pio run -e led_tube -t upload

# Bridge firmware
pio run -e bridge -t upload

Configuration values selected in the on-device menu are persisted to NVS flash and restored on boot.

Dependencies

Managed automatically by PlatformIO (see platformio.ini):

  • FastLED
  • Adafruit GFX Library
  • Adafruit SSD1306
  • esp_dmx
  • Ethernet
  • ArtNet

ESP-NOW / Wi-Fi and Preferences (NVS) are provided by the ESP32 Arduino Core.

Parts

7
QtyValueFootprintReferences
3SW_Push1825910-6:SW_1825910-6-4DOWN1, ENTER1, UP1
2MountingHoleMountingHole:MountingHole_2.2mm_M2H1, H2
1B7B-XH-A6N137:JST_B7B-XH-AJ1
1~DM-OLED096-636:MODULE_DM-OLED096-636I2C_OLED_DISPLAY1

More from nichtrami/led_tube

2
  • 2 layers131.8 × 51.8 mmBridge, the printed circuit board in 3D

    Bridge

    nichtrami/led_tube

    A LED Tube that works wireless and runs on a ESP32 with Arduino Framework

    17 parts1Apache-2.0
  • 2 layers26.3 × 59 mmLed tube, the printed circuit board in 3D

    Led tube

    nichtrami/led_tube

    A LED Tube that works wireless and runs on a ESP32 with Arduino Framework

    15 parts1Apache-2.0

Similar boards

  • 2 layersEncoder, the printed circuit board in 3D

    Encoder

    byrantech/laptop

    anyon_e, a highly integrated, high end, open source laptop. Attempt the impossible.

    7 parts4.3kMIT
  • 2 layers40 × 20 mmSensor smd, the printed circuit board in 3D

    Sensor smd

    scottbez1/splitflap

    DIY split-flap display

    7 parts4.2k
  • 2 layers19.8 × 30 mmZ limit, the printed circuit board in 3D

    Z limit

    opulo-inc/lumenpnp

    The LumenPnP is an open source pick and place machine.

    7 parts3.7k
  • 2 layers35.6 × 58.2 mmDisplay Carrier, the printed circuit board in 3D

    Display Carrier

    AxxAxx/AxxSolder

    STM32 Based soldering station for JBC cartridges, 9-24 VDC and USB-PD power

    7 parts1.7kGPL-3.0
  • 2 layers20.3 × 16.3 mmMap MPX, the printed circuit board in 3D

    Map MPX

    rusefi/rusefi

    rusefi - GPL internal combustion engine control unit

    7 parts1.2k
  • 2 layers26 × 44 mmCompact carrier board, the printed circuit board in 3D

    Compact carrier board

    jamro/tiny-engineer

    A small desktop robot that brings an AI coding assistant to life, physically acting out when it reads files, thinks, writes code, and finishes work.

    7 parts1.1k
  • 2 layers26.4 × 53.8 mmAtari pickup, the printed circuit board in 3D

    Atari pickup

    hoglet67/RGBtoHDMI

    Bare-metal Raspberry Pi project that provides pixel-perfect sampling of Retro Computer RGB/YUV video and conversion to HDMI

    7 parts1kGPL-3.0
  • 2 layersRj45 breakout, the printed circuit board in 3D

    Rj45 breakout

    rene-dev/stmbl

    AC Servo Driver for STM32F4

    7 parts990GPL-3.0

Questions

How big is the Interface PCB?

It measures 22 × 59 mm and has 2 copper layers, 1.6 mm thick.

What parts does the Interface use?

7 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 Interface KiCad files?

From the nichtrami/led_tube repository on GitHub, at the commit this page was made from: the board is pcb/interface_pcb/interface.kicad_pcb and its schematic pcb/bridge_pcb/bridge.kicad_sch. PCBKit opens the board in the browser, with nothing to install.

Can I use the Interface design in my own project?

Its repository publishes it under the Apache-2.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).