Skip to content

Make main light the primary entity when keep_main_light is on in WLED#45148

Draft
mik-laj wants to merge 2 commits intohome-assistant:nextfrom
mik-laj:patch-36
Draft

Make main light the primary entity when keep_main_light is on in WLED#45148
mik-laj wants to merge 2 commits intohome-assistant:nextfrom
mik-laj:patch-36

Conversation

@mik-laj
Copy link
Copy Markdown
Contributor

@mik-laj mik-laj commented May 2, 2026

Proposed change

Type of change

  • Spelling, grammar or other readability improvements (current branch).
  • Adjusted missing or incorrect information in the current documentation (current branch).
  • Added documentation for a new integration I'm adding to Home Assistant (next branch).
  • Added documentation for a new feature I'm adding to Home Assistant (next branch).
  • Removed stale or deprecated documentation.

Additional information

Checklist

  • This PR uses the correct branch, based on one of the following:
    • I made a change to the existing documentation and used the current branch.
    • I made a change that is related to an upcoming version of Home Assistant and used the next branch.
  • The documentation follows the Home Assistant documentation standards.

Copilot AI review requested due to automatic review settings May 2, 2026 22:13
@mik-laj mik-laj requested a review from frenck as a code owner May 2, 2026 22:13
@home-assistant home-assistant Bot added has-parent This PR has a parent PR in another repo next This PR goes into the next branch labels May 2, 2026
@netlify
Copy link
Copy Markdown

netlify Bot commented May 2, 2026

Deploy Preview for home-assistant-docs ready!

Name Link
🔨 Latest commit 9df6d02
🔍 Latest deploy log https://app.netlify.com/projects/home-assistant-docs/deploys/69f7bbf1a6daed0008705aa5
😎 Deploy Preview https://deploy-preview-45148--home-assistant-docs.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.
🤖 Make changes Run an agent on this branch

To edit notification comments on pull requests, go to your Netlify project configuration.

Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Updates the WLED integration documentation to explain how segment entities are created and named, and how enabling the “Keep Master Light” option affects which light entity is considered primary.

Changes:

  • Reworks the segment documentation into a dedicated “Using WLED segments” section, including naming behavior for segment 0.
  • Adds/expands documentation for the “Keep Master Light” option and its impact on entity naming/primary entity selection.
  • Refactors the “Supported functionality” light entity description to reference the segment behavior section.

Comment thread source/_integrations/wled.markdown Outdated
The **WLED** integration provides the following entities.
If WLED has 1 segment defined (the default), that one segment controls the
whole LED strip. Home Assistant creates a single light {% term entity %} named
after the device (e.g., "Garage Door Light") to control the strip.
Comment thread source/_integrations/wled.markdown Outdated
Comment on lines +105 to +107
of the device and is named after the WLED device (e.g., "Garage Door
Light"). It controls the overall power and brightness of the entire strip.
- **Segment 0** gets its own named {% term entity %} (e.g., "Garage Door Light
Comment thread source/_integrations/wled.markdown Outdated
Comment on lines +78 to +82
If WLED has 2 or more segments, each segment gets its own light
{% term entity %}, as well as its own color palette, speed, intensity, freeze,
and reverse {% term entities %}. Additionally, a master light {% term entity %}
is created. This master {% term entity %} controls the strip power and overall
brightness applied to all segments.
Comment thread source/_integrations/wled.markdown Outdated

The integration creates the following light {% term entities %}:

- **Segment lights**: one light {% term entity %} per segment, controlling its color, effect, speed, and brightness.
Comment thread source/_integrations/wled.markdown Outdated
Comment on lines +58 to +59
Keep Master Light:
description: Keep the master light entity even when there is only 1 segment. See [Keep Master Light option](#keep-master-light-option) for details.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

has-parent This PR has a parent PR in another repo next This PR goes into the next branch

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants