Żarówki IKEA w Zigbee2MQTT: GU10, panele i LED
Mark
Autor
Żarówki IKEA w Zigbee2MQTT: GU10, panele i LED

Podoba Ci się ten artykuł?

Tworzenie poradników zajmuje dużo czasu, a na stronie nie chce reklam. Jeśli pomogłem i masz na to ochotę — postaw mi kawę . To motywuje do dalszego pisania!

Żarówki, lampy i sterowniki LED IKEA w Zigbee2MQTT: przegląd modeli, konfiguracja i diagnostyka

„Żarówka TRÅDFRI” to fraza, która w praktyce niczego nie wyjaśnia. Pod tą jedną nazwą marketingową kryje się kilkadziesiąt modeli o różnych gwintach, mocy, możliwościach kolorystycznych i, co najważniejsze z perspektywy Zigbee2MQTT, różnych zestawach obsługiwanych atrybutów. Kiedy ktoś pisze do mnie „mam żarówkę TRÅDFRI i nie mogę ustawić koloru”, pierwsze pytanie zawsze brzmi: jaki dokładnie model, bo część linii w ogóle nie obsługuje koloru, i to nie jest błąd, tylko specyfikacja.
Ten artykuł jest przeglądem najpopularniejszych modeli z rodziny oświetleniowej IKEA obsługiwanej przez Zigbee2MQTT: od prostych żarówek E27 po sterowniki LED do zabudowy, wraz z realnym studium przypadku uszkadzającej aktualizacji OTA. To reprezentatywny wybór, nie pełna, wyczerpująca lista wszystkich wariantów regionalnych i rewizji z bazy Zigbee2MQTT: dokładny status i pełne exposes zawsze warto zweryfikować na stronie konkretnego modelu.
4
Rodziny funkcjonalne
16+
Modeli w przeglądzie
254
a nie 255: pułapka on_level
LED2201G8
Studium przypadku OTA

Seria: IKEA Smart Home × Home Assistant

1
Kompletny przewodnik po Zigbee, Matter, Thread i DIRIGERA

Architektura systemu i mapa całej serii.
2
Diagnostyka parowania w Zigbee2MQTT

Reset, interview, koordynator i błędy w logach.
3
Ten artykuł: żarówki, lampy i sterowniki LED

Przegląd najpopularniejszych modeli, konfiguracja i diagnostyka.
4
Piloty, przyciski i binding

Modele, akcje i sterowanie niezależne od chmury.
5
Czujniki i jakość powietrza

Ruch, otwarcie, zalanie, VINDSTYRKA i STARKVIND.
6
Rolety IKEA

FYRTUR, KADRILJ, TREDANSEN, PRAKTLYSING: parowanie i kalibracja.
7
Gniazdka i pomiar energii

TRETAKT, INSPELNING i Energy Dashboard.
8
DIRIGERA, Matter i Thread

Integracja, migracja z TRÅDFRI i nowa generacja urządzeń.

Jak czytać modele IKEA

Zanim zajmiemy się konkretnymi produktami, warto rozszyfrować konwencję nazewnictwa: ułatwia to samodzielne wyszukiwanie każdego kolejnego modelu w bazie Zigbee2MQTT.
LED…
Klasyczne żarówki Zigbee z generacji TRÅDFRI i nowsze KAJPLATS. Cyfra po LED bywa pomocna jako luźna, orientacyjna wskazówka co do generacji (niższe numery zwykle starsze), ale nie jest oficjalnym, gwarantowanym kodem protokołu ani funkcji: np. LED2201G8 to klasyczna żarówka Zigbee, a LED2405G8 to już linia Matter/Thread z nieoficjalnym trybem Zigbee, mimo tego samego prefiksu LED2. Zawsze sprawdzaj konkretny numer w bazie Zigbee2MQTT.
L15xx / L152x
Wśród starszych paneli FLOALT spotyka się oznaczenia L1527 i L1529, ale IKEA nie publikuje tego jako wiążącej konwencji nazewniczej: sam prefiks L15xx nie powinien być traktowany jako pewny, uniwersalny identyfikator całej kategorii paneli.
ICPSHC…
Sterowniki LED (drivery) do zabudowy: nie samodzielne źródła światła. Końcówka oznaczenia jest równie ważna jak początek: warianty IL-1, IL-2, EU, NA czy IP44 mogą różnić się funkcjonalnie i sposobem obsługi, a Zigbee2MQTT bywa grupuje kilka wariantów regionalnych na jednej stronie definicji.
Gwinty: E27/E26 to standardowy gwint europejski/amerykański, E14/E12 to mniejszy gwint świecowy, GU10 to popularna oprawka reflektorowa w oczkach sufitowych.

Rodziny funkcjonalne: czego faktycznie szukasz

Zamiast myśleć w kategoriach modeli, wygodniej myśleć w kategoriach rodzin funkcjonalnych, które IKEA konsekwentnie stosuje w całej ofercie: trzech głównych i jednej zbiorczej dla modeli specjalnych.
Warm White
Tylko jedna, stała barwa (najczęściej okolice 2700K: dokładna wartość i odcień różnią się między modelami i partiami produkcyjnymi) ze sterowaniem jasnością. Eksponuje wyłącznie state, brightness, level_config.
White Spectrum
Płynna zmiana temperatury barwowej (mired). Dodatkowo color_temp i color_temp_startup. Zakres mired bywa różny między modelami: patrz sekcja niżej.
Color/White Spectrum
Pełna paleta barw (color_xy, color_hs) z regulacją temperatury barwowej. Jedyna rodzina z kolorem czerwonym czy niebieskim.
Modele specjalne i ograniczone
Lampy dekoracyjne o stałej barwie, ale zmiennej jasności, modele filamentowe, żarówki zgłaszające tylko część atrybutów typowych dla swojej klasy oraz nowe modele Matter (KAJPLATS) pracujące w nieoficjalnym, ograniczonym trybie Zigbee. Zawsze sprawdzaj rzeczywiste exposes konkretnego modelu, nie tylko przynależność do jednej z trzech głównych rodzin.
Ta klasyfikacja jest ważniejsza niż konkretny model przy planowaniu zakupów: jeśli chcesz sceny kolorowe w salonie, upewnij się, że kupujesz z rodziny Color/White Spectrum, a nie tylko White Spectrum, bo z zewnątrz opakowania bywa to trudne do odróżnienia.

Żarówki E27/E26: najpopularniejsze modele

To najpopularniejsza kategoria, obejmująca żarówki do standardowych opraw. W bazie Zigbee2MQTT znajdziesz między innymi LED1623G12 (Warm White, 1000 lm), LED1732G11 (White Spectrum, 1000 lm), LED1924G9 (Color/White Spectrum, 800-810 lm), LED2004G8 (White Spectrum, przezroczysta, 800-810 lm) oraz nowszą linię KAJPLATS (np. LED2405G8): produkt natywnie Matter over Thread, z ukrytym, nieoficjalnym trybem Zigbee zachowanym głównie dla zgodności przez Touchlink. Traktuj KAJPLATS jako osobną kategorię, nie jako zwykłego następcę klasycznych żarówek Zigbee: pełne omówienie jego ograniczeń znajdziesz w dalszej części artykułu.
Jasność wyrażana jest w skali, która różni się między warstwami: zobacz tabelę niżej. CCT ustawiana jest w skali mired, gdzie kelwiny = 1 000 000 / mired. Dokładny zakres mired zależy od konkretnego modelu, więc nie ma jednego uniwersalnego zakresu dla całej rodziny IKEA: orientacyjnie 454 mired to ok. 2200K, 370 mired to ok. 2700K, a 250 mired to ok. 4000K (niższa wartość mired = chłodniejsza barwa). RGB konfigurowany jest przez color_xy (CIE 1931) albo color_hs: Zigbee2MQTT może przeliczać wartości między reprezentacjami (opcja color_sync, domyślnie włączona), ale wynik jest ograniczony fizycznym gamutem żarówki i nie musi być identyczny wizualnie: nie każdy punkt XY odpowiada sensownej temperaturze barwowej, a nie każda biel CCT jest dobrze odwzorowana przez RGB.
Warstwa
Zakres jasności
Zigbee Level Control
najczęściej 0–254
MQTT (Zigbee2MQTT)
0–254
Home Assistant UI
0–100%
Niektóre pola HA/API
0–255
Nie porównuj bezpośrednio wartości liczbowych z różnych warstw: ta sama „jasność” bywa inną liczbą zależnie od tego, po której stronie stosu ją odczytujesz.
Najczęstszy problem: domyślnie IKEA blokuje zmianę koloru/temperatury barwowej na wyłączonym urządzeniu. Rozwiązanie: włączenie execute_if_off w color_options (dla jasności analogiczna opcja siedzi w level_config):
mosquitto_pub -t "zigbee2mqtt/FRIENDLY_NAME/set" -m '{"color_options":{"execute_if_off":true}}'
Opcję można też ustawić w panelu Zigbee2MQTT, jeśli dane expose jest dostępne dla Twojego modelu: nie każda żarówka IKEA udostępnia color_options, więc jeśli nie widzisz go na stronie urządzenia ani w panelu, nie próbuj wymuszać tej opcji ręcznie tylko dlatego, że działa w innym modelu. Część użytkowników zgłaszała dla wybranych modeli i wersji firmware konieczność ponownego ustawienia tej opcji po zaniku zasilania: przed uogólnianiem tego zachowania sprawdź, jak zachowuje się Twój konkretny egzemplarz.

Żarówki E14/E12/E17: te same zasady, trudniejszy dostęp

Mniejsze żarówki świecowe obejmują modele takie jak LED1536G5 (E12/E14, White Spectrum: funkcje warto zweryfikować na aktualnej stronie modelu) czy warianty LED1624G9 dostępne w gwincie E12/E14: ten ostatni to konkretna żarówka obsługująca kolor wraz z transition, unfreeze_support i execute_if_off, nie prosty odpowiednik żarówki Warm White.
Procedura resetu zależy od konkretnego modelu i firmware, nie od gwintu: mniejszy gwint sam w sobie niczego nie zmienia. Zawsze sprawdzaj dokładną liczbę cykli na stronie urządzenia w Zigbee2MQTT, zamiast zakładać ją na podstawie rodziny produktów. Fizycznie procedura bywa trudniejsza w żyrandolach i kinkietach z dodatkowymi kloszami. Jeśli masz żyrandol z kilkoma żarówkami E14 na wspólnym obwodzie, resetuj i paruj je pojedynczo: nigdy jednocześnie, bo koordynator nie odróżni, która lampa aktualnie sygnalizuje join. Wszelkie manipulacje przy oprawce (wykręcanie, wkręcanie) wykonuj wyłącznie przy odłączonym zasilaniu obwodu; do izolowania pojedynczej sztuki lepiej użyj oprawki testowej, lampki stołowej albo przełączanego listwowego gniazdka niż wykręcać żarówki pod napięciem.

GU10: wybrane modele i różnice w funkcjach

Podobnie jak przy E27, to lista przykładowych modeli, nie pełny przegląd wszystkich wariantów GU10 z bazy Zigbee2MQTT: sprawdź stronę konkretnego modelu, jeśli szukasz dokładnych lumenów, zakresu CCT czy statusu OTA.
Model
Rodzina
Lumeny
LED1650R5
Warm White
400 lm
LED1837R5
Warm White
400 lm
LED1537R6 / LED1739R5
White Spectrum
400 lm
LED1923R5
Color/White Spectrum
345 lm
Moc świetlna GU10 jest zwykle niższa niż w porównywalnych żarówkach E27, ale to nie wynika wyłącznie z mniejszej obudowy: znaczenie ma też konstrukcja optyczna, kąt świecenia, sprawność zastosowanych LED i miejsce na elektronikę. GU10 dają światło bardziej skupione niż duże E27, więc przy porównywaniu warto patrzeć nie tylko na deklarowane lumeny, ale i na kąt świecenia oraz realne natężenie w miejscu pracy. Jeśli zależy Ci na jasności porównywalnej do E27, licz się z koniecznością większej liczby punktów świetlnych.

Panele świetlne: FLOALT, JORMLIEN, SURTE

FLOALT to seria kwadratowych paneli: wśród starszych wariantów spotyka się oznaczenia L1527 i L1529 (odpowiednio mniejszy i większy format), oba White Spectrum, eksponujące state, brightness, color_temp, color_temp_startup i level_config. Dokładne wymiary, strumień i wersję firmware warto zweryfikować dla konkretnego egzemplarza, ponieważ mogły różnić się między rynkami. Popularny wybór do biur domowych i kuchni.
JORMLIEN (lampy podszafkowe i sufitowe) i SURTE (oprawy wpuszczane, punktowe nad blatem) w praktyce często dzielą wspólną elektronikę sterującą z innymi produktami z tej samej fali produkcyjnej.
Parowanie przebiega tak samo jak żarówek, cyklem zasilania, ale ze względu na stały montaż elektryczny wygodniej jest wykonywać reset przez zwykły włącznik ścienny. Unikaj używania w tym celu bezpiecznika w rozdzielnicy: nie jest przeznaczony do rutynowych, szybkich sekwencji włącz/wyłącz, może przy okazji odciąć inne odbiorniki na tym samym obwodzie i sprzyja pomyłkom. Jeśli panel jeszcze nie jest zamontowany na stałe, wygodniej i bezpieczniej zrobić reset przed montażem, przez tymczasowe, bezpieczne podłączenie wykonane przez osobę kompetentną, albo skorzystać z przycisku resetu, jeśli dany model go ma. Routing: większość klasycznych, stale zasilanych paneli i driverów IKEA pełni funkcję routerów Zigbee, co czyni je wartościowym punktem sieciowym w kuchni czy biurze, ale rolę konkretnego modelu warto potwierdzić w mapie sieci Zigbee2MQTT, a nie zakładać automatycznie na podstawie samej kategorii produktu.
„Zamrożony” panel: trzy różne działania, nie jedno Panel bywa „zamarza” na jednej jasności/kolorze i przestaje reagować na komendy, mimo że available pokazuje wciąż true: availability i faktyczna reakcja na komendę światła to dwa osobne sygnały diagnostyczne, urządzenie mogło po prostu ostatnio odpowiedzieć na inne zapytanie. Rozróżnij trzy różne mechanizmy: unfreeze_support to programowy workaround w Zigbee2MQTT, domyślnie włączony dla znanych „zamrażających się” lamp IKEA, wykonywany automatycznie przed wysłaniem komendy; krótkie ręczne odcięcie zasilania (5–10 sekund) to osobna, awaryjna procedura power cycle; a pełny factory reset to zupełnie inne, dalej idące działanie usuwające konfigurację. Power cycle zwykle przywraca responsywność bez utraty parowania, ale nie należy go mylić z żadnym z pozostałych dwóch mechanizmów.

PILSKOTT i sterowniki SILVERGLANS: gdy nazwa nie odpowiada modelowi w bazie

To jeden z lepszych przykładów na to, dlaczego warto sprawdzać dokładny model, a nie nazwę marketingową. PILSKOTT, wisząca lampa LED, zgłasza się w Zigbee2MQTT poprzez elektronikę lub definicję Zigbee powiązaną ze sterownikiem używanym także w rodzinie SILVERGLANS (ICPSHC24-30-IL44-1), z firmware raportującym się jako „Pendant lamp WW”. To nie znaczy automatycznie, że cały układ elektroniczny jest identyczny: mogą różnić się rewizją PCB, złączami czy parametrami wyjściowymi; bez zdjęć płytki, numerów części czy teardownu nie da się tego jednoznacznie stwierdzić, dlatego nowy fingerprint musiał zostać osobno dodany do konwertera.
Historia z GitHuba: pierwszy użytkownik PILSKOTT zobaczył w logu, że „Pendant lamp WW” nie jest wspierane, mimo bliskiego pokrewieństwa ze sterownikiem SILVERGLANS. Rozwiązanie wymagało dodania nowego fingerprintu do konwertera. Dlatego świeżo kupiony produkt, mimo że blisko spokrewniony z czymś już wspieranym, czasem wymaga aktualizacji Zigbee2MQTT do najnowszej wersji, zanim w ogóle spróbujesz go sparować.
Oznaczenie T2030 bywa przypisywane PILSKOTT jako numer katalogowy: przy weryfikacji zawsze sprawdzaj dokładny identyfikator, po którym rozpoznaje urządzenie sam Zigbee2MQTT, a nie tylko nazwę handlową czy numer z pudełka.

Sterowniki 10 W, 30 W, MITTLED i wersje IP44

ICPSHC24-10EU-IL-1 (10 W) i ICPSHC24-30EU-IL-1 (30 W) to sterowniki LED przeznaczone przede wszystkim do kompatybilnych systemów opraw IKEA: do zabudowy meblowej, szaf czy podświetlenia schodów. Podłączenie innego obciążenia, np. dowolnej taśmy LED 24V z innego sklepu, wymaga zgodności elektrycznej, złączy i parametrów wyjścia; nie należy traktować ich jak uniwersalnego zasilacza do dowolnej taśmy LED. Oba eksponują state, brightness i level_config, bez koloru ani temperatury barwowej. Sterownik reguluje jasność kompatybilnych opraw podłączonych do swojego wyjścia: bez dokumentacji konkretnego modelu nie warto zakładać, czy odbywa się to przez PWM, zmianę prądu, napięcia czy kombinację tych metod.
Dobór drivera: całkowita moc jest ważnym, ale nie jedynym kryterium. Uwzględnij też napięcie, złącza, kompatybilną serię opraw, klasę IP, warunki termiczne i minimalne obciążenie: trzymaj się systemów zgodnych z dokumentacją IKEA i zostaw margines mocy. Przekroczenie limitu driveru to nie tylko kwestia skróconej żywotności: może prowadzić do zadziałania zabezpieczenia, niestabilnego migotania, przegrzewania, a nawet uszkodzenia drivera, przewodów lub złączy. To nie jest problem smart home, lecz bezpieczeństwa instalacji elektrycznej: nie przekraczaj mocy znamionowej ani parametrów wyjściowych.
MITTLED to kolejna seria opraw LED do zabudowy pod szafkami kuchennymi. SILVERGLANS (ICPSHC24-30-IL44-1) ma klasę szczelności IP44, co zwiększa odporność na bryzgi, ale nie oznacza, że urządzenie można zamontować w dowolnym miejscu łazienki: o bezpieczeństwie decyduje też strefa łazienkowa, napięcie, sposób montażu i wymagania krajowe dla pomieszczeń mokrych. Montaż musi odpowiadać instrukcji IKEA i lokalnym przepisom dla danej strefy, a nie tylko samej klasie IP.

power_on_behavior: dlaczego to ustawienie ma znaczenie praktyczne

Atrybut power_on_behavior (encja select w HA) określa, co robi żarówka zaraz po fizycznym przywróceniu zasilania: to nie to samo, co logiczne OFF wysłane po Zigbee, restart Zigbee2MQTT, restart Home Assistant czy utrata koordynatora. Najczęściej spotyka się wartości on, off, toggle i previous, ale nie każde urządzenie obsługuje wszystkie warianty: sprawdź listę exposes dla konkretnego modelu.
Realna konsekwencja: w wielu modelach previous przywraca ostatni zapamiętany stan logiczny, ale dokładne zachowanie po krótkim i długim zaniku napięcia może zależeć od firmware: nie zakładaj z góry jednego scenariusza. Sprawdź to praktycznie: ustaw previous, zgaś lampę po Zigbee, odłącz zasilanie na 10 sekund, przywróć je i zanotuj efekt, a potem powtórz test zostawiając lampę włączoną przed odcięciem prądu. Dla domownika niezaznajomionego z automatyzacją nieoczekiwany efekt może wyglądać jak awaria: skonfiguruj to świadomie i skomunikuj domownikom.

on_level i jasność startowa: pułapka wartości 255

Jedna z bardziej mylących kwestii w całej rodzinie produktów IKEA, potwierdzona w wielu zgłoszeniach w repozytorium Home Assistant Core. Żarówki eksponują to zazwyczaj jako zbiorczy obiekt level_config, który może obejmować między innymi on_level, current_level_startup, on_transition_time, off_transition_time, on_off_transition_time i execute_if_off: dokładny zestaw pól zależy od modelu. Atrybut on_level ma zakres 1-254, gdzie wartość 255 nie oznacza maksymalnej jasności, tylko specjalną wartość „niezdefiniowana”: to znaczenie dotyczy przede wszystkim tego konkretnego atrybutu konfiguracyjnego, nie każdej komendy jasności w ogóle.
Efekt praktyczny: jeśli ustawisz suwak on_level na maksimum (wizualnie sugerujące 255), żarówka wcale nie zapali się na pełnej jasności: będzie się zachowywać, jakby ta opcja w ogóle nie była ustawiona. Żeby wymusić realnie najwyższą, zdefiniowaną jasność startową, ustaw wartość 254, nie 255. Podobny mechanizm bywa spotykany przy current_level_startup, ale warto to zweryfikować per model, zamiast zakładać identyczne działanie każdego pola startowej jasności.
Uwaga: podobny level_config bywa eksponowany przez niektóre gniazdka IKEA (np. TRADFRI control outlet), mimo że nie potrafią ściemniać: atrybuty takie jak on_level w rzeczywistości nic nie robią na tym urządzeniu. To udokumentowane zachowanie producenta, nie błąd integracji. Pełny opis gniazdek i pomiaru energii znajdziesz w osobnym artykule serii.

color_mode, XY, CCT: jak to się przełącza

Żarówki Color/White Spectrum obsługują tryb temperatury barwowej (color_temp) i pełnego koloru (color_xy / color_hs), ale w danym momencie aktywny jest jeden sposób sterowania kolorem, nie oba jednocześnie: ostatnia odpowiednia komenda wybiera aktywny tryb. Atrybut color_mode wskazuje ten aktywny tryb, ale nie każda żarówka raportuje go identycznie: Home Assistant i Zigbee2MQTT bazują na informacji o ostatnio aktywnym trybie koloru, a po restarcie stan bywa odtwarzany na podstawie ostatnio znanych wartości, nie zawsze jako bezpośredni, świeży odczyt z żarówki.

Sceny Home Assistant, natywne sceny Zigbee i transition

Warto rozróżnić dwa różne mechanizmy, które potocznie nazywa się tym samym słowem „scena”. Scena Home Assistant to konfiguracja albo migawka bieżącego stanu zapisana po stronie HA, która przy aktywacji wysyła zestaw komend do urządzeń: nie działa bez działającego Home Assistant. Zigbee2MQTT ma osobny mechanizm natywnych scen Zigbee (scene_store, scene_recall, scene_remove) zapisanych bezpośrednio w urządzeniu lub grupie Zigbee: taka scena może teoretycznie zadziałać nawet bez HA, wymaga zwykle jednego wywołania sceny zamiast wielu komend, ale jej wsparcie i pojemność zależą od konkretnej lampy.
Problem z transition: Zigbee2MQTT dokumentuje, że żarówki IKEA obsługują transition tylko dla jednego atrybutu naraz: jeśli w jednej komendzie połączysz zmianę jasności i temperatury barwowej (lub koloru), przejście czasowe zostanie zastosowane tylko do jednego z nich, a drugi zmieni się skokowo. To udokumentowane ograniczenie sprzętowe/firmware, nie błąd integracji. Rozwiązania: wyślij jedną komendę bez transition, rozbij zmianę na dwie komendy z krótkim opóźnieniem między nimi, albo, jeśli wszystkie lampy w grupie to obsługują, użyj natywnej sceny Zigbee, która nie ma tego ograniczenia w taki sam sposób.
Grupy Zigbee tworzone na poziomie koordynatora (nie tylko jako grupy encji w HA) radzą sobie znacznie lepiej z jednoczesnym sterowaniem wieloma żarówkami niż sekwencyjne komendy z automatyzacji: komenda grupowa jest wysyłana jako pojedyncza ramka skierowana do adresu grupy (adresowanie grupowe/groupcast), a nie seria osobnych, kolejkowanych zapytań unicast. To zmniejsza ruch w sieci i poprawia synchronizację, ale nie daje takich samych indywidualnych potwierdzeń wykonania od każdego urządzenia jak sterowanie unicast: pojedyncza lampa w dużej grupie może pominąć komendę, a system nie musi od razu wiedzieć, która jej nie odebrała, mimo że wysyłka samej ramki grupowej się powiodła.

Binding pilotów do żarówek

Bezpośrednie powiązanie pilota z żarówką sprawia, że żarówka reaguje na przyciski nawet bez pośrednictwa Home Assistant: temat rozwijam znacznie szerzej w artykule o pilotach. Warto wiedzieć już tutaj: binding działa na poziomie konkretnych klastrów (genOnOff, genLevelCtrl, lightingColorCtrl): jeśli żarówka nie obsługuje danego klastra (np. prosta Warm White nie ma lightingColorCtrl), binding sterowania kolorem fizycznie nie zadziała: to ograniczenie sprzętowe, nie błąd konfiguracji.
Można też związać pilota z całą grupą Zigbee zamiast pojedynczej żarówki, co eliminuje potrzebę osobnego bindingu do każdej lampy z osobna. Jeśli sterowanie kolorem albo temperaturą przez pilota nie działa, brak klastra lightingColorCtrl po stronie żarówki to tylko jedna z możliwych przyczyn: sprawdź też, czy pilot faktycznie wysyła odpowiednią komendę, czy binding obejmuje właściwy endpoint grupy, i czy pilot nie korzysta z predefiniowanych scen IKEA zamiast bezpośredniego sterowania kolorem. Pamiętaj również, że starsze bindingi utworzone jeszcze przez oryginalny pilot/bramkę IKEA mogą pozostać aktywne równolegle z nowymi.

OTA: LED2201G8 jako studium przypadku

Aktualizacje OTA zwykle przebiegają prawidłowo, ale powinny być wykonywane świadomie, pojedynczo i po sprawdzeniu informacji o danym modelu: nie jest to proces, który warto uruchamiać bezrefleksyjnie na całej grupie naraz. Poniższy przykład to najbardziej pouczający, udokumentowany na GitHubie incydent związany z OTA w historii produktów IKEA, ale pojedynczy, konkretny incydent, a nie normalny scenariusz zwykłej aktualizacji.
Co się stało: repozytorium zigbee-OTA zaczęło oferować dla żarówek LED2201G8 aktualizację do wersji 3.0.21/3.0.22, w rzeczywistości przeznaczoną dla zupełnie innego modelu: LED2107C4. Żarówki, które przyjęły tę niedopasowaną aktualizację, zaczynały jedynie migać w nieskończoność i nie reagowały na standardowy reset. W rzadkich przypadkach błędne metadane albo niedostateczna walidacja zgodności obrazu mogą doprowadzić do przyjęcia niewłaściwego firmware: nie należy jednak zakładać, że dowolny obraz można łatwo wgrać do dowolnej żarówki, mechanizmy OTA zwykle sprawdzają kod producenta, typ obrazu i wersję. Część poszkodowanych relacjonowała na GitHubie trwałą utratę urządzenia i konieczność wymiany w sklepie IKEA: traktuj to jako potwierdzone zgłoszenia użytkowników z konkretnego wątku, nie jako ustaloną statystykę skali problemu.
1
Błąd leżał w metadanych firmware, nie w Zigbee2MQTT ani Home Assistant: nawet oficjalne, zweryfikowane źródło aktualizacji może przez pomyłkę producenta zaoferować niewłaściwy obraz.
2
Użytkownicy, którzy zauważyli niedopasowanie numeru wersji przed aktualizacją (porównując z release notes IKEA), uniknęli problemu.
3
Jeden z poszkodowanych, wymieniając żarówkę na nową pod gwarancją, wykonał force-removal uszkodzonej z bazy Z2M i nadał nowej dokładnie tę samą nazwę (friendly_name): zachowanie tej samej nazwy może uratować automatyzacje korzystające bezpośrednio z topiców MQTT, ale nie gwarantuje zachowania device_id, triggerów urządzenia, bindingów, grup Zigbee, scen ani wszystkich wpisów w rejestrze urządzeń Home Assistant.
Bezpieczna procedura OTA i wymiana uszkodzonej lampy: aktualizuj jedną sztukę testową przed resztą partii, zapisz wersję firmware przed i po, sprawdź binding po aktualizacji, nie odcinaj zasilania w trakcie, nie wykonuj OTA na całej grupie jednocześnie i upewnij się, że routing do lampy jest stabilny. Przy wymianie uszkodzonego urządzenia: zapisz stare encje i automatyzacje, wykonaj force remove tylko jeśli normalne usunięcie jest niemożliwe, sparuj nową lampę, przywróć nazwę, sprawdź encje MQTT i device_id, odtwórz grupy i bindingi, a na końcu przetestuj wszystkie sceny.

KAJPLATS: natywny Matter, nieoficjalny Zigbee i jego ograniczenia

Seria KAJPLATS (np. LED2405G8) to pierwsza fala żarówek IKEA natywnie zbudowanych wokół Matter over Thread, nie Zigbee. Mają ukryty tryb Zigbee zachowany głównie dla zgodności przez Touchlink, ale jest on oficjalnie niewspierany przez IKEA, mocno okrojony i może zostać ograniczony lub usunięty w przyszłych aktualizacjach: traktuj go jako furtkę awaryjną, a nie docelowy sposób integracji.
Do normalnego korzystania z Matter over Thread potrzebny jest kontroler Matter oraz dostęp do właściwej sieci Thread przez Thread Border Router: to dwie różne role, które może, ale nie musi, pełnić to samo urządzenie. Samo posiadanie „dowolnego huba Thread” w domu nie gwarantuje zarządzania aktualizacjami czy pełnej funkcjonalności KAJPLATS: liczy się kontroler, do którego żarówka została dodana, oraz zgodne dane sieci Thread. Jeśli chcesz użyć w tej roli Apple TV lub HomePod, sprawdź, czy dany model i generacja faktycznie obsługują Thread Border Router: nie każda wersja tych urządzeń to potrafi. Szerzej omawiam architekturę Matter/Thread w artykule o DIRIGERA i nowej generacji urządzeń.
Znane ograniczenia trybu Zigbee w KAJPLATS: zgodnie z dokumentacją Zigbee2MQTT dla tej linii: wejście w tryb Zigbee wymaga osobnej sekwencji (najpierw 6 cykli zasilania do factory reset, potem kolejne 12, a według niektórych modeli nawet 15 cykli, żeby uruchomić parowanie Zigbee), nie każda sztuka wchodzi w ten tryb za pierwszym razem, przełączenie na Zigbee wyłącza Thread, urządzenie nie ma OTA przez Zigbee (aktualizacje idą wyłącznie przez Matter), może pojawić się z pustymi atrybutami model/manufacturer wymagającymi ręcznej korekty, power_on_behavior bywa niepełne w trybie Zigbee w części wariantów (potwierdzone m.in. dla wybranej wersji LED2401G5), sceny, grupy i komenda OffWithEffect mogą zwracać błąd INSUFFICIENT_SPACE, a lampa może nie ogłaszać się (brak announce) po ponownym dołączeniu do sieci lub po przywróceniu zasilania po dłuższej przerwie.

Plan dużej instalacji oświetlenia

Routing
Większość stale zasilanych żarówek i paneli pełni funkcję routerów Zigbee: rozłożenie ich równomiernie buduje gęsty mesh dla bateryjnych czujników i pilotów. Pamiętaj jednak, że żarówka-router bez zasilania (wyłącznik ścienny) znika z sieci i zmusza inne urządzenia do przebudowy tras, dlatego jako stabilny szkielet mesha lepiej sprawdzają się gniazdka i dedykowane repeatery niż punkty świetlne sterowane fizycznym przełącznikiem.
Grupy na poziomie koordynatora
Grupowanie żarówek w tym samym pomieszczeniu w grupy Zigbee (nie tylko encji HA) przyspiesza sterowanie i redukuje obciążenie sieci.
Ujednolicona strategia
Ustal power_on_behavior i on_level od razu, zamiast poprawiać punktowo po fakcie.

Diagnostyka objaw po objawie

Zawsze pierwszy krok
Otwórz stronę dokładnego modelu w Zigbee2MQTT i sprawdź jego exposes, notes, pairing, options i zgłoszone issues: połowa „dziwnych” zachowań jest tam już opisana.
Nie reaguje na zmianę koloru, tylko jasność
Sprawdź, czy to na pewno Color/White Spectrum, nie White Spectrum: najczęstsza przyczyna.
Zmiana temp. barwowej nie działa gdy wyłączona
Włącz execute_if_off; pamiętaj, że może nie przetrwać zaniku zasilania.
Jasność lub temperatura barwowa skacze zamiast płynnego przejścia
To zwykle udokumentowane ograniczenie transition do jednego atrybutu naraz: rozbij komendę na osobne wywołania zamiast łączenia jasności, koloru i przejścia w jednej.
Jasność startowa nie działa mimo maksimum
Sprawdź, czy wartość to nie 255; ustaw 254.
Panel „zamarza” na jednej jasności
Krótkie odcięcie zasilania na 5-10 s zamiast pełnego resetu parowania.
Nowy model „unsupported” mimo znanego sterownika
Zaktualizuj Zigbee2MQTT: nowe warianty bywają dodawane z opóźnieniem względem premiery produktu.
Gniazdko eksponuje atrybuty ściemniania bez efektu
To znane, udokumentowane zachowanie firmware TRADFRI control outlet, nie błąd integracji.
Migotanie, restarty lub niepełny reset po podłączeniu przez ściemniacz
Inteligentnej żarówki Zigbee nie zasilaj przez klasyczny ściemniacz fazowy, chyba że producent wyraźnie dopuszcza taki układ: obcinanie fazy zasilania może zakłócać radio i elektronikę żarówki.
KAJPLATS niedostępny po dłuższym braku zasilania
Znany problem trybu Zigbee: urządzenie może nie wysłać announce po rejoinie/przywróceniu zasilania. Spróbuj krótkiego power cycle lub ręcznego rejoinu.

Tabela modeli: szybkie odniesienie

Reprezentatywny wybór, nie pełna lista wszystkich wariantów regionalnych z bazy Zigbee2MQTT. Kolumny OTA i Router opisują ogólną charakterystykę rodziny produktu: przed planowaniem instalacji zweryfikuj status konkretnego egzemplarza na jego stronie w Zigbee2MQTT.
Model
Kategoria
Gwint/typ
Rodzina
OTA
Router
LED1623G12
Żarówka
E27
Warm White
Zigbee
tak*
LED1732G11
Żarówka
E26/E27
White Spectrum
Zigbee
tak*
LED1924G9
Żarówka
E26/E27
Color/White Spectrum
Zigbee
tak*
LED2004G8
Żarówka
E26/E27
White Spectrum
Zigbee
tak*
LED2405G8 (KAJPLATS)
Żarówka
E27
Color/White Spectrum (Matter, nieoficjalny Zigbee)
tylko Matter
do weryfikacji
LED1536G5
Żarówka
E12/E14
White Spectrum
Zigbee
tak*
LED1650R5
Żarówka
GU10
Warm White
Zigbee
tak*
LED1837R5
Żarówka
GU10
Warm White
Zigbee
tak*
LED1537R6 / LED1739R5
Żarówka
GU10
White Spectrum
Zigbee
tak*
LED1923R5
Żarówka
GU10
Color/White Spectrum
Zigbee
tak*
L1527 (FLOALT)
Panel
mniejszy format
White Spectrum
Zigbee
tak*
L1529 (FLOALT)
Panel
większy format
White Spectrum
Zigbee
tak*
ICPSHC24-10EU-IL-1
Sterownik
10 W
Brightness only
sprawdzić
tak*
ICPSHC24-30EU-IL-1
Sterownik
30 W
Brightness only
sprawdzić
tak*
ICPSHC24-30-IL44-1 (SILVERGLANS)
Sterownik
30 W, IP44
Brightness only
sprawdzić
tak*
T2030 (PILSKOTT)
Lampa wisząca
:
Brightness only (driver SILVERGLANS)
sprawdzić
niepotwierdzone
* Klasyczne, stale zasilane żarówki i drivery IKEA zwykle działają jako router Zigbee i mają dostępne OTA przez Zigbee: status ten może się jednak różnić dla konkretnej rewizji lub wariantu regionalnego, dlatego traktuj kolumny jako punkt wyjścia, nie ostateczne potwierdzenie. Stan wiedzy: sierpień 2026.

Czego nie znajdziesz w tym artykule

Pełny poradnik pilotów sterujących tymi żarówkami (binding, akcje, konkretne modele) znajdziesz w artykule o pilotach. Pełną diagnostykę problemów z koordynatorem i parowaniem: w artykule o diagnostyce parowania.

Co dalej

Źródła: dokumentacja poszczególnych urządzeń na zigbee2mqtt.io (w tym strony LED2201G8, LED2109G6, LED1623G12, LED2405G8 i wariantów KAJPLATS), baza zigbee.blakadder.com, zgłoszenia i dyskusje w repozytoriach Koenkk/zigbee2mqtt i Koenkk/zigbee-herdsman-converters, issues w repozytorium home-assistant/core oraz dyskusje na forum Home Assistant Community. Ekosystem IKEA szybko się zmienia, a niektóre fragmenty tego artykułu łączą obserwacje z różnych generacji Zigbee2MQTT i firmware: traktuj konkretne liczby cykli resetu, zakresy CCT i listy exposes jako punkt wyjścia i zawsze zweryfikuj je na aktualnej stronie danego modelu. Stan wiedzy i nazewnictwo modeli: sierpień 2026.
W kolejnym artykule tej serii zajmiemy się pilotami i przyciskami: od podstawowych akcji, przez binding, po sterowanie w pełni niezależne od Home Assistant. Przejdź do artykułu o pilotach i przyciskach →

Społeczność MarkLabs

Dyskutuj na forum

Pytania, doświadczenia i rozwiązania do tego artykułu publikujemy teraz na forum MarkLabs.

Otwórz dyskusję na forum

Wymagane jest bezpłatne konto MarkLabs. Dotychczasowe komentarze bloga nie są przenoszone.

buycoffee.to