--- title: "Yeelight" description: "Yeelight Wi-Fi LED-izzók, szalagok és mennyezeti lámpák szabályozása JSON-RPC-n át LAN-on. TapHome sablon a Yeelight LAN Control protokollhoz." url: "https://taphome.com/hu/compatibility/yeelight/" language: hu lastmod: 2026-04-15 generator: hugo ai: topics: ["data-pp","lighting","wifi","json-rpc","lan-control","dimmer"] questions: ["Hogyan integrálhatok Yeelight izzót a TapHome-mal?","Mit vezérel a Yeelight TapHome sablon?","Hogyan kapcsolom be a LAN Control / Developer Mode funkciót egy Yeelight izzón?","A TapHome képes megváltoztatni a Yeelight izzó színét vagy színhőmérsékletét?","Miért nem reagál a Yeelight izzóm a TapHome parancsaira?","Miért hibáznak egyes Yeelight parancsok \"client quota exceeded\" üzenettel?"] --- # Yeelight Kommunikáció: Packet Parser → TCP - [Yeelight Developer Portal](https://www.yeelight.com/en_US/developer) - [Yeelight LAN Control FAQ](https://www.yeelight.com/faqs/lan_control) > Hálózati cím > > A TapHome az importáláskor megadott címen éri el az eszközt. Adjon az eszköznek állandó címet — IP-foglalást a routerben, vagy az mDNS-nevét, ha támogatja —, különben az integráció leáll, amikor a router megváltoztatja a címet. > > [A hálózat előkészítése](https://taphome.com/hu/docs/setup/network-preparation/) ## Integrációs útmutató A Yeelight Wi-Fi okos LED világítási márka — egyszínű izzók, állítható fehér és teljes színű izzók, LED szalagok és mennyezeti lámpák — amelyet a Qingdao Yeelink (a Xiaomi ökoszisztéma része) forgalmaz. Minden LAN-kompatibilis Yeelight termék ugyanazt a JSON-RPC **Inter-Operation Protocol** protokollt beszéli a **55443**-as TCP porton, így egyetlen TapHome sablon lefedi az egész terméksorozatot. A sablon egy fényerő-szabályozó eszközt tesz elérhetővé: fényerő (0–100 %) és be/ki kapcsolás sima átmenetekkel. Az aktuális színmód és színhőmérséklet csak olvasható szervizattribútumként jelenik meg. A TapHome közvetlenül a helyi hálózaton keresztül kommunikál az izzóval — miután a LAN Control be van kapcsolva az izzón, nincs szükség Yeelight fiókra. ## Hardveres csatlakozás A Yeelight izzók normál hálózati feszültségről működnek (jellemzően E27, E14, GU10 foglalat vagy 24 V tápegység LED szalaghoz — terméktől függően). A TapHome és az izzó között nincs szükség huzalozásra — minden kommunikáció Wi-Fi-n keresztül zajlik. Az izzónak **ugyanazon a LAN / VLAN** hálózaton kell lennie, mint a TapHome CCU, mert a JSON-RPC protokoll nem használ hitelesítést és titkosítást, a forgalom pedig soha nem megy át a Yeelight felhőn. > [!WARNING] > A Yeelight LAN protokollja titkosítatlan. Ne tedd elérhetővé az 55443-as TCP portot a publikus internet felől, és tedd az izzókat megbízható hálózati szegmensre — bárki, aki hozzáfér a LAN-hoz, parancsokat küldhet az izzónak. ## Konfiguráció ### A LAN Control bekapcsolása A LAN Control (egyes régiókban **Developer Mode** néven) alapértelmezésben ki van kapcsolva az izzón. Enélkül az izzó elutasítja a TCP kapcsolatokat az 55443-as porton. 1. Nyisd meg a **Yeelight** mobilalkalmazást, és SmartConfig / QuickConnect eljárással párosítsd az izzót a helyi Wi-Fi hálózattal, ha még nincs párosítva. 2. Válaszd ki a cél izzót az alkalmazásban. 3. Koppints a beállítások ikonra (jobb felső sarok), majd nyisd meg a **LAN Control** menüt (egyes firmware-verziókban **Developer Mode** néven). 4. Kapcsold a **LAN Control**-t BE állásba. 5. Jegyezd fel az izzó IP-címét — a Yeelight alkalmazás eszközinformációs oldalán látható, vagy kiolvasható a router DHCP lease tábláiból. A LAN Control bekapcsolása után az izzó figyeli az 55443-as TCP portot, és időnként meghirdeti magát a `239.255.255.250:1982` UDP multicast címen. ### Hálózati konfiguráció - **IP-cím** — a TapHome sablon nem ismer automatikus izzókeresést. Adj az izzónak **statikus IP-t** vagy **DHCP foglalást** a routerben, hogy a lease megújítás után se változzon a címe. - **Azonos LAN szegmens** — a TapHome CCU-nak és az izzónak ugyanabban a broadcast doménben kell lennie. Ha a Wi-Fi és a kábeles kliensek külön VLAN-okon vannak, vegyél fel egy tűzfal szabályt, amely engedélyezi a TCP 55443 forgalmat közöttük. ### Importálási paraméterek A TapHome sablon importálásakor a felhasználó három értéket ad meg: | Paraméter | Leírás | Alapérték | |-----------|--------|-----------| | `ipAddress` | A Yeelight izzó IP-címe a LAN-on | `192.168.0.1` (placeholder — cseréld valós IP-re) | | `Port` | Az izzó TCP vezérlőportja | `55443` | | `Internal poll interval` | Milyen gyakran küldi a sablon a `get_prop` parancsot (milliszekundumban) | `10000` (10 s) | Az alapértelmezett `55443` port a Yeelight LAN Control szabványos portja, és csak akkor érdemes megváltoztatni, ha az izzó nem szabványos portra lett konfigurálva. > [!TIP] > Pollok között a sablon reagál az izzó által küldött `props` értesítésekre is — ezeket az izzó minden állapotváltozáskor magától elküldi. A gyakorlatban ez azt jelenti, hogy a Yeelight alkalmazásban, fali kapcsolón vagy egy másik Home Assistant példányon végzett fényerő- vagy kapcsolási változtatások szinte azonnal megjelennek a TapHome-ban, anélkül, hogy meg kellene várni a következő pollt. ## Eszközképességek ### Fényerő-szabályozó (fényerő és be/ki) A sablon egyetlen fényerő-szabályozó eszközt jelenít meg. Minden pollnál ezt küldi: ```json {"id":951,"method":"get_prop","params":["bright","power"]} ``` és feldolgozza a válasz `result[0]` (fényerő 1–100, 100-zal osztva a TapHome 0.0–1.0 tartományra) és `result[1]` (`"on"` / `"off"`) értékeit. Az írásokat két JSON-RPC parancsra fordítja: - Ha a célszint nullánál nagyobb, a sablon a `set_power ["on","smooth",300]` parancsot küldi, majd a `set_bright [round(level*100),"smooth",500]` parancsot. A 300 ms-os bekapcsolási és az 500 ms-os fényerő-átmenet kellemes fade-et ad a kemény ugrás helyett. - Ha a célszint nulla, a sablon a `set_power ["off","smooth",300]` parancsot küldi. A fényerő-szabályozó az izzó által küldött `props` értesítéseket (power / brightness) is feldolgozza, így a külső állapotváltozások a következő poll bevárása nélkül is megjelennek a TapHome-ban. ### Színmód és színhőmérséklet (csak olvasható) Két modul-szintű szervizattribútum egy külön `get_prop` kérésen (`id=981`) keresztül olvasható: - **Color mode** — `RGB`, `Temperature` vagy `HSV`, a numerikus `color_mode` tulajdonságból (1 / 2 / 3) dekódolva a listener script `SWITCH` kifejezésével. - **Color temperature** — Kelvin érték `"{ct}K"` formátumban (például `"4000K"`). Csak akkor értelmezhető, ha az izzó Temperature módban van. Tipikus, modellfüggő tartomány: **1700–6500 K** színes izzóknál és szalagoknál, **2700–6500 K** mennyezeti lámpáknál (a ceiling3 6000 K-nél lezár). Mindkét attribútum csak diagnosztikai célú — a sablon nem képes színmódot váltani, és nem tud új színhőmérsékletet írni. ### További képességek A Yeelight LAN protokoll RGB- és HSV-színvezérlést (`set_rgb`, `set_hsv`), színhőmérséklet-vezérlést (`set_ct_abx`), színváltó programokat (`start_cf` / `stop_cf`), előre definiált jeleneteket (`set_scene`), eszközön belüli időzítőket (`cron_add`), kétvilágos lámpák háttérvilágításának vezérlését (`bg_*` metódusok) és music mode-ot (`set_music`, egy reverse-TCP csatorna, amely megkerüli a rate-limit-et) is kínál. Ezek közül egyiket sem valósítja meg a jelenlegi TapHome fényerő-szabályozó sablon — aki teljes színt vagy effekteket szeretne, annak ki kell bővítenie a sablont, vagy párhuzamosan használnia a natív Yeelight alkalmazást. > [!TIP] > A szín, színhőmérséklet és jelenetek egy későbbi sablonfrissítésben ugyanazon a TCP csatornán keresztül hozzáadhatók. A PacketParser olvasási/írási scriptjei kibővíthetők a `set_ct_abx`, `set_rgb` vagy `set_scene` parancsokkal az importálási paraméterek módosítása nélkül. ## Hibaelhárítás ### Az izzó nem reagál a parancsokra 1. Ellenőrizd, hogy a **LAN Control** be van-e kapcsolva az izzón (Yeelight app → izzó beállítások → LAN Control). Enélkül az izzó minden TCP kapcsolatot elutasít az 55443-as porton. 2. Ellenőrizd az izzó IP-címét a Yeelight alkalmazásban vagy a router DHCP lease tábláiban, és győződj meg róla, hogy egyezik az `ipAddress` importálási paraméterrel. A Yeelight izzók alapértelmezésben nem tartják fix IP-t — a lease lejárhatott, és az IP megváltozott. 3. Adj az izzónak statikus IP-t vagy DHCP foglalást, hogy a cím ne változzon. 4. Ellenőrizd, hogy a TapHome CCU és az izzó ugyanazon a LAN / VLAN-on van, és hogy az 55443-as TCP portot nem blokkolja tűzfal közöttük. 5. Teszteld a kapcsolatot manuálisan: `telnet {bulb-ip} 55443`, és küldj egy nyers kérést `\r\n` lezárással: ```json {"id":1,"method":"get_prop","params":["bright","power"]} ``` Egy működő izzó `{"id":1,"result":["",""]}` formátumban válaszol. ### Read error: client quota exceeded Minden Yeelight izzóhoz menő TCP kapcsolat **percenként 60 parancsra** van korlátozva, és az izzó összesen legfeljebb **4 egyidejű kapcsolatot** fogad el (összesen 144 parancs/perc a teljes LAN-on). Ha egy másik rendszer is pollozza az izzót — Home Assistant, Yeelight felhő-session, saját script —, a kombinált forgalom rate-limit hibákat válthat ki, amelyeket a TapHome `Read error: client quota exceeded` formában jelent. 1. Kapcsold ki vagy lassítsd az izzót osztozó egyéb integrációkat. 2. Hagyd a TapHome poll intervallumát az alapértelmezett `10000` ms értéken vagy magasabban. Egy `get_prop` plusz két `set_*` írás változásonként biztonságosan a 60 parancs/perc kvóta alatt marad. 3. Zárd be a nem használt `telnet` debug kapcsolatokat — ezek is beleszámítanak a 4 kapcsolatos limitbe. ### A Color temperature szervizattribútum "error" értéket mutat A Color mode és Color temperature szervizattribútumok az izzó `color_mode` és `ct` tulajdonságát olvassák. Ha **mono** (csak fehér) modellről van szó, amely nem támogat állítható fehéret, vagy az izzó éppen RGB vagy HSV módban van, a `ct` érték nem értelmezhető, és a listener script a Color temperature attribútumot `"error"` értékkel jelzi. Ez várt viselkedés, nem hiba. ### A Yeelight alkalmazásban végzett módosítások nem jelennek meg A sablon reagál az izzó által küldött `props` értesítésekre, így a külső változások általában egy másodpercen belül megjelennek. Ha mégsem: 1. Az értesítés érkezhetett olyan pillanatban, amikor a TCP socket éppen újraépült — a következő poll (alapértelmezetten 10 s) újraszinkronizálja. 2. Egyes régebbi firmware-verziók csak akkor küldenek értesítést, ha aktívan parancsot kapnak. Frissítsd az izzó firmware-ét a Yeelight alkalmazáson keresztül. 3. Előfordulhat, hogy az izzó elérte a 4 kapcsolatos limitet — csökkentsd az egyidejű kliensek számát a LAN-on. ## Elérhető eszközök 1 Ezek az eszközök az importálás után jelennek meg a TapHome-ban. Yeelight modul Modul Szerviz attribútumok | | | |-----------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | Színmód | Az izzó által jelzett aktív színmód — RGB, Temperature (állítható fehér) vagy HSV. Csak olvasható — a sablon nem vált színmódot. | | Színhőmérséklet | Aktuális fehérpont Kelvinben (csak Temperature módban érvényes). Csak olvasható — a sablon nem ír színhőmérsékletet. Modellfüggő tartomány: 1700–6500 K színes izzóknál és szalagoknál, 2700–6500 K mennyezeti lámpáknál. | Egyéni változók Figyelő ```taphome VAR jsonResponse := TOSTRING(RECEIVEDBYTES); VAR id := PARSEJSON(jsonResponse, "id", 1); IF(id = 981) VAR error := PARSEJSON(jsonResponse, "error.message", 1); IF(!ISNULL(error)) COMPLETESERVICEATTRIBUTE("Color mode", "", "error"); COMPLETESERVICEATTRIBUTE("Color temperature", "", "error"); ELSE VAR colorMode := PARSEJSON(jsonResponse, "result[0]", 1); VAR colorTemp := PARSEJSON(jsonResponse, "result[1]", 1); IF(!ISNULL(colorMode)) VAR colorModeValue := SWITCH(TODOUBLE(colorMode), 1, "RGB", 2, "Temperature", 3, "HSV", "Unknown"); COMPLETESERVICEATTRIBUTE("Color mode", colorModeValue, ""); ELSE COMPLETESERVICEATTRIBUTE("Color mode", "", "error"); END IF(!ISNULL(colorTemp)) COMPLETESERVICEATTRIBUTE("Color temperature", colorTemp + "K", ""); ELSE COMPLETESERVICEATTRIBUTE("Color temperature", "", "error"); END END END ``` Szerviz attribútumok Color mode ```taphome VAR json := "{\"id\":981, \"method\":\"get_prop\", \"params\":[\"color_mode\", \"ct\"]}"; SENDDATA(json); ``` Color temperature ``` ``` Yeelight fényerő-szabályozó Fényerőszabályzó Olvasás és írás Fényerő (0–100 %) és be/ki vezérlés sima, 300–500 ms-os átmenetekkel. Szín, színhőmérséklet és effektek ebben a sablonban nem érhetők el. numeric Egység: brightness 0–100 % Változó: `receiveError`, Változó: `notificationError`, Változó: `sendError` Szint olvasása ```taphome VAR json := "{\"id\":951, \"method\":\"get_prop\", \"params\":[\"bright\", \"power\"]}"; SENDDATA(json); ``` Szint írása ```taphome IF(Le > 0) VAR jsonPowerOn := "{\"id\":952,\"method\":\"set_power\",\"params\":[\"on\", \"smooth\", 300]}"; SENDDATA(jsonPowerOn); VAR jsonBrightness := "{\"id\":953,\"method\":\"set_bright\",\"params\":[" + ROUND(Le*100) + ",\"smooth\", 500]}"; SENDDATA(jsonBrightness); ELSE VAR jsonPowerOff := "{\"id\":954,\"method\":\"set_power\",\"params\":[\"off\", \"smooth\", 300]}"; SENDDATA(jsonPowerOff); END ``` Figyelő ```taphome VAR jsonResponse := TOSTRING(RECEIVEDBYTES); VAR method := PARSEJSON(jsonResponse, "method", 1); VAR id := PARSEJSON(jsonResponse, "id", 1); STRING onOff; IF(id = 951) receiveError := PARSEJSON(jsonResponse, "error.message", 1); IF(LENGTH(receiveError) = 0) VAR brightnessStr := PARSEJSON(jsonResponse, "result[0]", 1); onOff := PARSEJSON(jsonResponse, "result[1]", 1); IF(!ISNULL(brightnessStr)) Le := TODOUBLE(brightnessStr) / 100.0; END IF(onOff = "on") St := 1; ELSEIF(onOff = "off") Le := 0; St := 0; END END END IF(id > 951 AND id < 955) sendError := PARSEJSON(jsonResponse, "error.message", 1); END IF(method = "props") notificationError := PARSEJSON(jsonResponse, "error.message", 1); IF(LENGTH(notificationError) = 0) VAR brightness := PARSEJSON(jsonResponse, "params.bright", 1); onOff := PARSEJSON(jsonResponse, "params.power", 1); IF(!ISNULL(brightness)) Le := brightness / 100.0; END IF(onOff = "on") St := 1; IF(ISNULL(brightness)) SENDDATA("{\"id\":951, \"method\":\"get_prop\", \"params\":[\"bright\", \"power\"]}"); END ELSEIF(onOff = "off") Le := 0; St := 0; END END END IF(LENGTH(receiveError) > 0) ADDERROR("Read error: " + receiveError); END IF(LENGTH(sendError) > 0) ADDERROR("Write error: " + sendError); END IF(LENGTH(notificationError) > 0) ADDERROR(notificationError); END ``` **Kapcsolat:** Packet Parser → TCP Lehetséges fejlesztések (13) - Set color temperature — Write color temperature (1700–6500 K, model-dependent). Color temperature is exposed as a read-only service attribute but cannot be changed from TapHome. - Set RGB color — Write full RGB color (0–16777215). TapHome dimmer template exposes brightness + on/off only — no color control. - Set HSV color — Write hue (0–359) + saturation (0–100). Not exposed by dimmer template. - Color flow — Scripted sequences of brightness / color / CT changes (sunrise effect, strobe, ambient cycles). Not exposed by dimmer template. - Set scene — Jump directly to a predefined state (color, hsv, ct, cf, auto\_delay\_off). Not exposed by dimmer template. - Toggle power — Single-parameter power toggle. Not exposed — TapHome writes explicit on/off via set\_power instead. - Sleep timer (cron) — On-device auto-off timer in minutes. Not exposed — TapHome uses its own Smart Rules for scheduling instead. - Music mode — Reverse-TCP channel bypassing the 60 cmd/min rate limit. Not used by TapHome. - Relative adjustments — Relative +/- changes without knowing the current value. Not exposed — TapHome always writes absolute brightness. - Save current state as power-on default — Persist current brightness/color to flash so it survives a hard power cut. Not exposed by dimmer template. - Background light control — Secondary light channel on dual-light fixtures (e.g., some ceiling lights). Not exposed by dimmer template. - Extended state properties — Additional properties pushed via props notifications (rgb, hue, sat, flowing, delayoff, music\_on, name). Template only consumes bright and power. - LAN auto-discovery — User must enter the bulb IP manually during import — template does not perform SSDP discovery. A static DHCP lease is strongly recommended. ## Importálási paraméterek Ezeket az értékeket az XML importálásakor adja meg. | Az alkalmazás kéri | Alapérték | |------------------------|---------------| | IP-cím | `192.168.0.1` | | Port | `55443` | | Internal poll interval | `10000` | ## Források - Yeelight WiFi Light Inter-Operation Specification [www.yeelight.com](https://www.yeelight.com/download/Yeelight_Inter-Operation_Spec.pdf) 2026-04-15 [PDF](https://taphome.com/compatibility/devices/yeelight/manufacturer/Yeelight_Inter-Operation_Spec.pdf) - Yeelight Developer — Third-party Control Protocol [www.yeelight.com](https://www.yeelight.com/en_US/developer) 2026-04-15 - python-yeelight library documentation [yeelight.readthedocs.io](https://yeelight.readthedocs.io/en/latest/) 2026-04-15 A gyártói dokumentumok © a mindenkori tulajdonosaikat illetik. A gyártó által közzétett formában, kizárólag tájékoztatásul tesszük elérhetővé őket. ## Kapcsolódó dokumentáció - [Packet Parser integráció](https://taphome.com/hu/compatibility/packet-parser-guide/) - [Packet Parser (HTTP, TCP, UDP, FTP, MQTT)](https://taphome.com/hu/docs/integration/packet-parser/) - [Packet parser függvények](https://taphome.com/hu/docs/script/packet-parser/) - [Elemző függvények](https://taphome.com/hu/docs/script/parsing-functions/)