Systemy WLED / Recepta integracji

Home Assistant + WLED: zbuduj automatyzację efektu z możliwością odtworzenia

Oddziel kontekst pomieszczenia od silnika światła i sprawdź konkretną encję, efekt oraz ścieżkę odzyskiwania przed dodaniem warunków.

Status weryfikacji

Redakcja techniczna / przegląd ścieżki automatyzacji13 min czytania / aktualizacja 2026-09-05

Masz pomysł na oświetlenie, ale nie wiesz, które części będą współpracować? Powiedz, co chcesz zbudować, gdzie to trafi i jaki hardware już masz. Sprawdzimy źródło światła, napięcie, LED IC lub liczbę kanałów, kontroler, driver, zasilacz, okablowanie i ścieżkę sterowania, a następnie dobierzemy praktyczną konfigurację inteligentnego oświetlenia DIY przed zakupem. Ten przegląd przed zakupem jest bezpłatny, aby można było zamówić świadomie i zacząć budowę po dostarczeniu części.

01 / Krótka odpowiedź

Pozostaw taktowanie pikseli i efekty w WLED. Home Assistant powinien dostarczać kontekst i wywoływać znany preset lub stan; encja, konfiguracja i odzyskiwanie tworzą jeden układ.

Dla kogo jest ten poradnik

Użytkownicy Home Assistant sterujący lokalnym urządzeniem WLED

Referencyjny pulpit Home Assistant przedstawiający warstwę automatyzacji nad kontrolerem WLED
Referencja pulpitu / Home Assistant dostarcza kontekst i polecenia, a WLED nadal wykonuje silnik światła

PUNKT KONTROLNY / 01

Przypisz każdej warstwie jedno zadanie

WLED obsługuje w kontrolerze taktowanie pikseli, segmenty i efekty. Home Assistant zarządza nad tą warstwą kontekstem pomieszczenia, harmonogramami i automatyzacjami. Przepływ jest wiarygodny dopiero po sprawdzeniu dokładnej encji WLED i wywoływanej ścieżki sieciowej.

  • Protokół pikseli, mapowanie segmentów i efekty pozostaw w warstwie urządzenia WLED.
  • Używaj Home Assistant do kontekstu i poleceń, nie jako zamiennika kontrolera ani toru zasilania.
  • Razem zapisz encję, ścieżkę integracji, firmware i zachowanie po restarcie.

PUNKT KONTROLNY / 02

Zachowaj znany stan WLED jako możliwy do odtworzenia

Przed dodaniem złożonej automatyzacji zapisz w WLED przetestowany lokalny preset lub stan efektu. Zapisz segment, limit jasności, efekt, paletę, identyfikator presetu, jeśli jest udostępniony, oraz zachowanie po restarcie WLED. Preset jest stanem możliwym do odtworzenia dla jednej konkretnej konfiguracji; nie jest dowodem zachowania innego kontrolera, firmware ani wariantu taśmy.

  • Nazwij stan według pomieszczenia i celu, a nie według tymczasowego eksperymentu.
  • Utrzymuj jasność i prędkość efektu w zmierzonym zakresie instalacji.
  • Sprawdź, jakie presety i opcje efektów udostępnia dokładna encja Home Assistant.

PUNKT KONTROLNY / 03

Zacznij od jednego przewidywalnego działania

Wyzwól jedną encję, wywołaj znany efekt lub preset i sprawdź wynik w rzeczywistej instancji Home Assistant. Przykład używa encji światła i udostępnionej opcji efektu; zastąp wartości encjami i opcjami, które faktycznie przetestowano. Dopiero po ustabilizowaniu ścieżki dodaj obecność, multimedia i czas.

mode: restart
trigger:
  - trigger: state
    entity_id: binary_sensor.media_mode
    to: "on"
action:
  - action: light.turn_on
    target:
      entity_id: light.media_wall
    data:
      effect: "Solid"

PUNKT KONTROLNY / 04

Sprawdź ścieżkę awarii i restartu

Przetestuj automatyzację po restarcie WLED, restarcie Home Assistant, chwilowej niedostępności sieci i ponownym włączeniu kontrolera. Ustal, czy światło ma pozostać wyłączone, wrócić do lokalnego stanu WLED czy czekać na nowe polecenie Home Assistant. Nie opisuj odzyskiwania jako automatycznego, dopóki nie uzyskasz takiego wyniku dla dokładnego kontrolera, firmware, integracji i sekwencji zasilania.

  • W dzienniku oddziel restart urządzenia WLED od restartu Home Assistant.
  • Sprawdź, jaki stan zgłasza encja, gdy kontroler jest niedostępny.
  • Zachowaj lokalne lub ręczne odzyskiwanie na czas serwisu i awarii sieci.

PUNKT KONTROLNY / 05

Dodaj sceny i warunki bez ukrywania odpowiedzialności

Gdy pojedyncze działanie jest powtarzalne, użyj sceny Home Assistant lub kolejnych warunków do wyrażenia celu pomieszczenia. W zapisie pozostaw widoczne efekt WLED, przypisanie segmentów i granicę jasności. Przy wielu segmentach opisz encję sterującą każdym z nich i sprawdź działania równoczesne; włączenie jednej encji światła nie definiuje automatycznie bezpiecznego pokazu wielosegmentowego.

  • Dodawaj jeden warunek naraz i zostaw działanie bazowe do diagnostyki.
  • W notatce budowy zapisz encję, efekt lub preset, zakres segmentu i oczekiwane odzyskiwanie.
  • Obecność multimediów, harmonogramy i pulpity traktuj jako opcjonalny kontekst wokół sprawdzonej ścieżki światła.

TRYBY AWARII

Co zwykle nie działa

  • Automatyzacja zależy od nazwy efektu lub presetu zmienionej między wersjami firmware.
  • Scena zakłada kanały RGBW lub segmenty, których wybrana encja nie udostępnia.
  • Oczekuje się, że Home Assistant zastąpi taktowanie WLED, kontroler albo tor zasilania.
  • Pierwsze działanie działa, lecz restart WLED, restart Home Assistant i utrata sieci nie są testowane osobno.
  • Po restarcie kontrolera lub awarii integracji brakuje udokumentowanego lokalnego albo ręcznego odzyskiwania.

PODSTAWA TECHNICZNA / WERSJA

Utrzymuj decyzję w aktualnym stanie

Ten poradnik jest prowadzony jako wersjonowany rekord techniczny. Przed użyciem go w instalacji produkcyjnej ponownie sprawdź aktualną dokumentację protokołu i dokładną rewizję produktu.

Przed instalacją

Porównaj wybrane napięcie, źródło światła, driver, sterownik, firmware i warunki instalacji z rekordem produktu oraz opisem projektu.

FAQ / SZYBKIE ODPOWIEDZI

Częste pytania o tę konfigurację oświetlenia

Czy Home Assistant uruchamia efekty WLED?

Zwykle nie. WLED na kontrolerze obsługuje taktowanie pikseli, segmenty i renderowanie efektów. Home Assistant dostarcza kontekst i wysyła polecenia sprawdzoną ścieżką integracji. Nie zastępuje kontrolera, drivera, zasilacza ani okablowania danych.

Czy każde urządzenie WLED można dodać do Home Assistant?

Nie. Trzeba sprawdzić dokładne urządzenie, firmware, ścieżkę sieciową, mapowanie encji i udostępnione opcje. Oznaczenie WLED, podobna nazwa kontrolera lub pasujące mechanicznie złącze nie dowodzą działania wybranej encji, efektu, segmentu ani presetu.

Co powinno się stać po restarcie Home Assistant lub WLED?

Zdefiniuj i przetestuj oczekiwane zachowanie dla każdego restartu: światło może pozostać wyłączone, wrócić do lokalnego stanu WLED albo czekać na nowe polecenie. Zapisz rzeczywisty wynik dla dokładnego kontrolera, firmware, integracji i sekwencji zasilania oraz zachowaj ręczną ścieżkę serwisową.

MATERIAŁY

Materiały wykorzystane w poradniku

Strona została przepisana dla czytelników LumaCircuit. Te materiały wyznaczają pierwotny temat lub kontekst techniczny; nie zastępują przeglądu konkretnego wariantu ani rekordu testowego LumaCircuit.

03 / Następny poradnik

Połącz naukę z konkretnym montażem.

Poradniki powinny prowadzić do przetestowanego produktu, lepszego pytania lub uczciwszej specyfikacji.

Wróć do wszystkich poradników