Addressable LEDs in Berry~

Support for addressable leds strips and animation. Internally relies on optimized TasmotaLED library, currently supporting WS2812 and SK6812, 3 and 4 channels, over RMT and SPI.

How to use~

Compatibility with Templates~

You can control multiple LED strips. WS2812 - 1 is also controlled by Tasmota's light controls. It is still possible to control this light strip with Berry, but whenever you use Tasmota light controls they will temporarily overrid Berry animations.

To avoid any conflict between native WS2812 and Berry control, you can use Scheme 14 which disables native WS2812.

Led strips, sub-strips~

You first need to define the low-level Leds object that describes the hardware strip of connected leds.

You can then define higher level objects like sub-strips (if there are actually several strips chained together like rings).

Once a Leds object, you can use sub-objects:

The Leds_segment class provides the same interface as the Leds class, with the following differences: - It doesn't have its own buffer, it's a view into the parent strip's buffer - The show() method takes an optional force parameter that, when true, forces a show even if the segment doesn't cover the entire strip - The pixels_buffer() method returns nil since segments don't have their own buffer

Methods are the equivalent low-level from NeoPixelBus. All colors are in 0xRRGGBB format (24 bits) or 0xWWRRGGBB format (32 bits).

Advanced features~

Hardware RMT channels~

This library uses NeoPixelBus library, and RMT hardware support in ESP32. The number of RMT channels, hence the number of simultaneous strips, depends on the CPU type. Tasmota native support for WS2812 uses RMT channel 0; it is not usable in such case.

Currently RMT channel 0 is used by default if no GPIO WS2812-1 is configured, RMT channel 1 otherwise.

pixmat class for 2D pixel buffers~

The pixmat class provides a native high-performance 2D pixel buffer abstraction for Berry.
It supports mono (1‑bpp), RGB (3‑bpp), and RGBW (4‑bpp) formats, with optional serpentine layout.

Constructor~

• bitplane_bytes: packed bits (1‑bpp), each bit becomes a pixel (0 or 255)
• buf: external buffer to wrap (no copy)
• width, height: pixel dimensions
• bpp: bytes per pixel (1=mono, 3=RGB, 4=RGBW)
• serpentine: if true, odd rows are reversed in memory

Methods~

• clear(val): fills matrix with value (default 0)
• get(x,y): returns pixel value (packed int or list)
• set(x,y,rgb): sets pixel with packed RGB
• set(x,y,h,s,v): sets pixel with HSV (converted internally)
• blit(src, dx, dy): copies pixels from another matrix, for mono source 0 becomes transparent
• scroll(dir): scrolls content by one pixel (0=up, 1=left, 2=down, 3=right)

Notes~

• All operations are in-place and use integer math
• Brightness and tinting are supported in set() and blit()
• Mono→color expansion is automatic when blitting
• Ideal for use with Leds.pixels_buffer() to drive 2D LED panels

Example~

var strip = Leds(256, gpio.pin(gpio.WS2812, 32))
var m = pixmat(strip.pixels_buffer(), 32, 8, strip.pixel_size(), true)
m.set(0, 0, 0xFF0000)  # top-left pixel red
strip.show()

A few more examples can be found here.

WLED Palettes Reference~

This page displays all 59 WLED gradient palettes available in the Berry Animation Framework.

Palette Gallery~

Credits~

• WLED Palettes: From WLED Project by Aircoookie
• Conversion: For Tasmota Berry Animation Framework
• Total Palettes: 59 gradient palettes