Skip to content

Addressable Pixels

Addressable pixels are configured as physical outputs first, then organized into targets on the Lighting page including elements and groups. Most WS2812B type pixels will work, 5V are commonly used. for shorter and smaller strings, for longer runs 12V pixels may be needed to combat voltage drop and would need to be powered sufficiently with the ground connected together. Because of the voltage output of the controller data pin if you need longer wiring between the controller and the first pixel you may need to use a null pixel near the controller to rebuffer the signal for the long run.

Display prerequisite

Pixel Lighting and Pixel Effects appear after at least one Pixel Strip module is configured in Configure > Connections > Inputs, Outputs, and Modules.

Add the physical pixel output

  1. Open Configuration.
  2. Go to Connections.
  3. Expand Inputs, Outputs, and Modules.
  4. Add a pixel strip or addressable LED output.
  5. Set the strip ID.
  6. Select data pin.
  7. Apply I/O Changes and the controller will reboot.
  8. Open Lighting and verify the strip appears.

The manual’s common addressable pixel module is WS2812B addressable pixels (Paid Link). After adding the physical output, set the correct pixel count, color order, and power injection plan for the installed strip.

Pixel output controls

ControlWhat it does
Strip IDName used by Lighting and Behavior
Data pinController pin connected to the pixel data line

Create useful targets

  1. Open Configuration > Lighting.
  2. Create pixel elements for logical prop areas.
  3. Combine elements into Groups
  4. Define group layout if effects need spatial direction.
  5. Create palettes.
  6. Create effects that target those groups.

Group and layout controls

ControlWhat it does
Group nameTarget label used by effects and actions
Strip/rangePhysical pixels included in the group
OrderDirection effects should travel through the group
LayoutPosition data for grids, rings, paths, or non-linear installs
PaletteNamed color set reused by effects
EffectAnimation preset applied to a group

Testing pixels

Test in this order: strip output, single group, palette, effect, behavior trigger. If colors are wrong, change color order. If only part of the strip responds, check count, data direction, power injection, and shared ground.