Skip to content

New LED hardware driver: WLED Pixel Bus - #5704

Open
DedeHai wants to merge 234 commits into
wled:mainfrom
DedeHai:WLEDpixelBus_PR
Open

New LED hardware driver: WLED Pixel Bus#5704
DedeHai wants to merge 234 commits into
wled:mainfrom
DedeHai:WLEDpixelBus_PR

Conversation

@DedeHai

@DedeHai DedeHai commented Jun 25, 2026

Copy link
Copy Markdown
Collaborator

This is a major update adding WLED Pixel Bus written from scratch to replace NeoPixelBus and it packs a lot of useful features. From a user perspective the main improvements are less memory use and dynamic adjustment of LED timing to eliminate flickering by fine-tuning the timing from -30% to + 30% in 10% steps (dropdown menu).

The new hardware driver structure allows for fully dynamic updates of LED outputs and LED timings. It also adds glitch free parallel SPI output support on the C3 as well as parallel bit-banging on all platforms including ESP8266.
All parallel outputs (except bit-bang) use ping-pong DMA buffers instead of fully pre-filled buffers - memory usage is optimized and DMA buffers are independent of number of LEDs. Also the calculation from LED colors to DMA buffers is highly speed optimized, making the driver blazing fast - I saw 30% FPS improvements in some cases.
The fully dynamic nature of the driver allows for a "Custom digital bus" in the LED settings to support virtually any LED bus type out there - specify timing, number of color channels, invert any color channel or set any color channel combination. The driver also supports inverting the output signal on any pin (ESP32 only).

The LED config UI was updated to fully support the new driver options.

A lot more testing is required for all different kind of LEDs on all platforms. I am sure there is a ton of bugs and kinks to iron out.

I would like to take this opportunity to thank @Makuna for his outstanding work on NeoPixelBus which served me well as a reference on hardware configurations and special LED types.

  • saves over 10k of heap on ESP32 and about 3k on ESP8266
  • increases available LED outputs on ESP32 C3 from 2 to 14 (2x RMT, 4x parallel SPI, 8x bit-bang)
  • increases available LED outputs on ESP32 S2 with 8x bit-bang if I2S is not available
  • increases available LED outputs on ESP8266 3 to 6 (1x UART, 1xI2S DMA, 4x bit-bang)
  • allows over 1000 LEDs again on ESP8266 thanks to reduced RAM footprint, it does not use a global buffer but writes to LED buffers directly which is slower but uses less RAM.
  • adds support for TM1815
  • improved low-brightness color accuracy to TM1814, TM1815 and APA102 by utilizing LED current settings
  • improved color resolution on 16bit LED types (UCS8903, UCS8904, SM16825)
  • if needed I2S (ESP32 and ESP32 S2) and LCD (ESP32 S3) driver can output on 16 parallel pins changing a #define
  • automatic calculation and optimized use of multiple RMT memory blocks, reducing ISR frequency when not using all RMT outputs and thus increases FPS

ESP32 flash and RAM usage comparison (bit bang disabled)

using NeoPixelBus
RAM: [== ] 24.9% (used 81576 bytes from 327680 bytes)
Flash: [======== ] 83.1% (used 1306493 bytes from 1572864 bytes)
Free Heap: (6 outputs, 256 each): 79.8k

using WLEDpixelBus
RAM: [== ] 24.9% (used 81680 bytes from 327680 bytes)
Flash: [======== ] 83.0% (used 1306053 bytes from 1572864 bytes)
Free Heap: (6 outputs, 256 each): 92.8k

Summary by CodeRabbit

  • New Features
    • Added per-bus Bus Speed Factor (SF/bsf) settings.
    • Added Custom Bus support with channel mapping, inversion, custom timing, and per-channel colors.
    • Expanded supported output driver/type options (bit-bang, parallel SPI, RMT, I2S, LCD where available) and added new LED type options (e.g., TM1815 / custom bus).
  • Bug Fixes
    • Improved ESP8266 direct-to-bus pixel handling and refined gamma/brightness behavior across realtime and particle rendering.
  • Chores
    • Updated capability limits and the LED settings UI + config import/export for the new bus features.

DedeHai added 30 commits March 5, 2026 20:55
DedeHai added 28 commits July 23, 2026 10:24
@DedeHai
DedeHai marked this pull request as ready for review July 28, 2026 19:02
@DedeHai

DedeHai commented Jul 28, 2026

Copy link
Copy Markdown
Collaborator Author

@willmmiles I made a lot of updates and it is now in a pretty good shape. I compiled a TODO list in WLEDpixelBus.cpp with the important things that still should be updated / checked / fixed, all of them are improvements that do not need immediate fixing.
If you find the time, please have another look at it and check if you agree with the general approach of handling things WRT future compatibility. The drivers themselves are (or were at one point) tested. ESP8266 slipped my testing recently so I can't vouch for it not having issues, I focused on the V5 updates mostly.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants