TapHome

IKEA TRADFRI E1810

Packet Parser → MQTT
Trimis de
Ultima actualizare: 03. 2026

Necesită gateway extern

tasmota zigbee2tasmota-gateway — pagina produsului

IKEA TRADFRI E1810

Acest dispozitiv comunică prin Zigbee printr-un gateway Tasmota. Înainte de a continua, asigurați-vă că ați importat șablonul Zigbee2Tasmota Gateway și ați împerecheat dispozitivul.

IKEA TRADFRI E1810 este o telecomandă Zigbee compactă cu 5 butoane (în unele regiuni cunoscută și ca E1524). TapHome detectează apăsările butoanelor prin gateway-ul Zigbee2Tasmota, folosind MQTT, și pune la dispoziție fiecare buton ca dispozitiv Buton separat — astfel puteți declanșa scene, controla dimmere, acționa jaluzele sau rula orice automatizare cu Smart Rules.

Telecomanda este alimentată cu baterie (CR2032) și intră în repaus între apăsări, pentru a economisi energia. TapHome monitorizează nivelul bateriei și conectivitatea dispozitivului prin gateway.

Configurare

Împerecherea telecomenzii
  1. Asigurați-vă că Zigbee2Tasmota Gateway este configurat și comutatorul Permit Join este ON în TapHome
  2. Deschideți compartimentul bateriei de pe spatele telecomenzii
  3. Apăsați micul buton de împerechere (lângă bateria CR2032) de 4 ori în 5 secunde
  4. LED-ul roșu al telecomenzii clipește de câteva ori — dispozitivul s-a conectat la rețeaua Zigbee
  5. Notați Device ID-ul (de ex. 0x1234) din atributele de service ale gateway-ului
Parametrii de import ai șablonului

Șablonul dispozitivului necesită 4 parametri:

ParametruDescriereExemplu
MQTT Broker IP AddressAdresa IP a brokerului dvs. MQTT192.168.1.10
MQTT Broker PortPortul brokerului (implicit 1883)1883
Gateway nameTopicul MQTT Tasmota (același ca la șablonul gateway-ului)tasmota_XXXXX
Device IDAdresa scurtă Zigbee de la împerechere0x1234

După import, în TapHome apar 5 dispozitive Buton — câte unul pentru fiecare buton al telecomenzii.

Funcțiile dispozitivului

Corespondența butoanelor

Șablonul creează 5 dispozitive Buton care detectează apăsările butoanelor:

Dispozitiv TapHomeButon telecomandăEveniment Zigbee
Dimmer în josJos (−)DimmerStepDown
Dimmer în susSus (+)DimmerUp
StângaSăgeată stânga (◀)ArrowClick = 1
DreaptaSăgeată dreapta (▶)ArrowClick = 0
ComutareCentru (●)Power

Fiecare buton folosește detectarea impulsurilor — starea butonului revine la 0 și trece scurt la 1 la apăsare. Astfel, butoanele sunt ideale pentru declanșarea Smart Rules în TapHome.

E1810 acceptă în Zigbee2MQTT și evenimente de apăsare lungă și de eliberare, dar șablonul TapHome detectează doar apăsările simple. Acest lucru este suficient pentru majoritatea automatizărilor, cum ar fi comutarea scenelor și pornirea/oprirea.

Utilizări cu Smart Rules

Fiind o telecomandă, aceasta nu controlează direct dispozitivele TapHome. În schimb, TapHome detectează fiecare apăsare de buton, iar dvs. puteți reacționa cu Smart Rules:

  • Comutare → aprinderea/stingerea luminilor, comutarea unei scene
  • Dimmer în sus / în jos → reglarea intensității luminii, schimbarea temperaturii setate a termostatului
  • Stânga / Dreapta → trecerea prin scene, controlul jaluzelelor (deschidere/închidere)

Configurați Smart Rules care se declanșează la schimbarea stării dispozitivului Buton, pentru fiecare buton.

Monitorizarea bateriei și a conectivității

Modulul interoghează gateway-ul la fiecare oră (comanda ZbInfo) și monitorizează:

  • Nivelul bateriei — nivelul estimat al bateriei. Când scade sub 30 % se generează un avertisment
  • Tensiunea bateriei — tensiunea brută a celulei CR2032
  • Calitatea legăturii — puterea semnalului Zigbee (0–100 %)
  • Detectarea stării offline — apare un avertisment dacă dispozitivul nu a mai trimis niciun mesaj de mai mult de 12 ore și o eroare după 24 de ore

Atributele de service includ și adresa IEEE a dispozitivului, ID-ul modelului Zigbee, șirul cu numele producătorului și endpointurile active.

Rezolvarea problemelor

Apăsările butoanelor nu sunt detectate
  1. Verificați dacă Device ID-ul din șablon corespunde adresei scurte Zigbee atribuite la împerechere (verificați atributele de service ale gateway-ului sau folosiți ZbStatus în consola Tasmota)
  2. Apăsați o dată butonul de împerechere pentru a trezi telecomanda — aceasta intră în repaus între apăsări, iar prima apăsare după o perioadă lungă de inactivitate poate să nu fie înregistrată
  3. Verificați în consola Tasmota mesajele ZbReceived la apăsarea butoanelor — acestea confirmă că gateway-ul primește evenimentele Zigbee
Telecomanda nu se împerechează
  1. Resetați telecomanda la setările din fabrică: apăsați rapid butonul de împerechere de 4 ori, apoi țineți-l apăsat 10 secunde sau mai mult, până când LED-ul pulsează
  2. În timpul împerecherii, apropiați telecomanda la 2–3 metri de gateway-ul Zigbee
  3. Asigurați-vă că Permit Join este activ pe gateway înainte de a începe secvența de împerechere
Bateria se descarcă repede
  1. Bateria CR2032 durează de obicei 1–2 ani la utilizare normală
  2. Dacă avertismentele de baterie apar des, verificați Calitatea legăturii — un semnal Zigbee slab provoacă mai multe retransmisii și o descărcare mai rapidă a bateriei
  3. Luați în considerare adăugarea unui dispozitiv router Zigbee (orice dispozitiv Zigbee alimentat de la rețea) în apropierea telecomenzii, pentru a îmbunătăți calitatea semnalului

Cum se instalează în TapHome

Cerințe preliminare

  • Gateway Zigbee cu firmware Tasmota (de ex. Sonoff ZBBridge, eWeLink ZB-GW03)
  • Broker MQTT care rulează în rețeaua dvs. locală (brokerul integrat TapHome sau unul extern)
  • TapHome CCU în aceeași rețea

TapHome are un broker MQTT integrat — activați-l în Setări → Hardware → MQTT Broker. Nu este necesar niciun software suplimentar.

Pasul 1 — Configurați gateway-ul Zigbee Tasmota

  1. Încărcați firmware-ul Tasmota pe un coordonator Zigbee acceptat (de ex. Sonoff ZBBridge, eWeLink ZB-GW03)
  2. Conectați gateway-ul la rețeaua dvs. Wi-Fi prin interfața web Tasmota
  3. Accesați Configuration → Configure MQTT și setați:
    • Host: adresa IP a brokerului dvs. MQTT (de ex. 192.168.1.10)
    • Port: 1883
    • Topic: notați numele topicului (de ex. tasmota_XXXXX) — veți avea nevoie de el la importul șablonului

Pentru instrucțiuni detaliate, consultați documentația Tasmota Zigbee.

Pasul 2 — Importați șablonul gateway-ului în TapHome

  1. Descărcați șablonul gateway-ului de pe pagina de compatibilitate Zigbee2Tasmota Gateway
  2. În TapHome, accesați Setări → Hardware → Packet Parser → Import
  3. Importați șablonul cu acești parametri:
    • MQTT Broker IP Address: adresa IP a brokerului dvs. (de ex. 192.168.1.10)
    • MQTT Broker Port: 1883
    • Gateway name: topicul MQTT Tasmota de la pasul 1 (de ex. tasmota_XXXXX)

După import veți vedea două dispozitive: Permit Join (comutator) și Dispozitive găsite (contor).

Pasul 3 — Împerecheați un dispozitiv Zigbee

  1. În TapHome, porniți comutatorul Permit Join — se deschide o fereastră de împerechere de 60 de secunde
  2. Pe dispozitivul Zigbee, porniți procedura de împerechere (de obicei țineți apăsat butonul de resetare 5 secunde, până când LED-ul clipește)
  3. Urmăriți contorul Dispozitive găsite — crește când se conectează un dispozitiv nou
  4. Verificați atributele de service ale gateway-ului pentru a vedea ID-ul noului dispozitiv (de ex. 0x1234), producătorul și modelul
  5. Modul de împerechere se dezactivează automat după expirarea timpului

Pasul 4 — Importați șablonul dispozitivului

  1. Descărcați șablonul specific dispozitivului de pe pagina de compatibilitate corespunzătoare
  2. Importați șablonul cu acești parametri:
    • MQTT Broker IP Address: aceeași ca la gateway
    • MQTT Broker Port: 1883
    • Gateway name: același topic MQTT Tasmota ca mai sus
    • Device ID: adresa scurtă de la împerechere (de ex. 0x1234)

Dispozitive disponibile

IKEA TRADFRI E1810 Modul
Atribute de service
Adresă IEEEAdresa IEEE Zigbee (identificator unic de 64 de biți)
ID modelIdentificatorul de model Zigbee raportat de dispozitiv
ProducătorȘirul cu numele producătorului Zigbee raportat de dispozitiv
EndpointuriEndpointuri Zigbee active pe dispozitiv
Calitatea legăturiiIndicatorul calității legăturii Zigbee (0–100 %)
Tensiunea baterieiTensiunea bateriei CR2032
Nivelul baterieiNivelul estimat al bateriei (avertisment sub 30 %)
Variabile personalizate
GWname (string)Numele topicului MQTT Tasmota al gateway-ului Zigbee (se găsește în Configuration → MQTT → Topic)
ID (string)Adresa scurtă Zigbee a senzorului (atribuită la împerechere)
After pairing the sensor via Permit Join, find the device short address in the gateway's Devices Found service attribute or via Tasmota console command ZbStatus

IKEA - TRADFRI - E1810

Citire (modul)
MQTTPUBLISH("cmnd/" + GWname+ "/ZbInfo", ID)
Ascultător
if INDEXOF(RECEIVEDMSG.Topic, "SENSOR") > 0
	var ZbReceived := PARSEJSON(TOSTRING(RECEIVEDMSG.Payload), "ZbReceived." + ID, true);
    var bat := PARSEJSON(ZbReceived, "BatteryPercentage", true);
    if(!ISNULL(bat), BatteryPercentage := bat);
    var volt := PARSEJSON(ZbReceived, "BatteryVoltage", true);
    if(!ISNULL(volt), BatteryVoltage := volt);
    
    var deviceInfo := PARSEJSON(TOSTRING(RECEIVEDMSG.Payload), "ZbInfo." + ID, true);
    if !ISNULL(deviceInfo)
    	LastSeenEpoch := PARSEJSON(deviceInfo, "LastSeenEpoch");
        COMPLETESERVICEATTRIBUTE("IEEEAddr", PARSEJSON(deviceInfo, "IEEEAddr"));
        COMPLETESERVICEATTRIBUTE("ModelId", PARSEJSON(deviceInfo, "ModelId"));
        COMPLETESERVICEATTRIBUTE("Manufacturer", PARSEJSON(deviceInfo, "Manufacturer"));
        COMPLETESERVICEATTRIBUTE("Endpoints", PARSEJSON(deviceInfo, "Endpoints"));
        #COMPLETESERVICEATTRIBUTE("Config", PARSEJSON(deviceInfo, "Config"));
        COMPLETESERVICEATTRIBUTE("Link Quality", ROUND(LINEAR(PARSEJSON(deviceInfo, "LinkQuality"), 0,0, 254, 100)) + "%");
    end
end

if BatteryPercentage < 30
	ADDWARNING("Low battery (<30%)");
end

if !ISNAN(LastSeenEpoch)
	DATETIME now := NOW();
	var secondsSeen := now.UNIXTIME - LastSeenEpoch;
	if secondsSeen > 12 * 60 * 60
		if secondsSeen > 24 * 60 * 60
			ADDERROR("Device is offline > 24H");
		else
			ADDWARNING("Device is offline > 12H");        
		end
	end
end
Atribute de service
IEEEAddr
MQTTPUBLISH("cmnd/" + GWname+ "/ZbInfo", ID)
ModelId
Manufacturer
Endpoints
Link Quality
Battery Voltage
BatteryVoltage + " V"
Battery Percentage
BatteryPercentage + "%"
Dimmer în jos Buton Doar citire

Detectează apăsarea butonului de jos — se declanșează la evenimentul Zigbee DimmerStepDown

boolean pulse

Dimmer în jos

Ascultător
Bp := 0;
if INDEXOF(RECEIVEDMSG.Topic, "SENSOR") > 0
	var ZbReceived := PARSEJSON(RECEIVEDMSG.Payload, "ZbReceived." + ID, true);
    var button := PARSEJSON(ZbReceived, "DimmerStepDown", true);
    if(!ISNULL(button), Bp := 1);
end
Dimmer în sus Buton Doar citire

Detectează apăsarea butonului de sus — se declanșează la evenimentul Zigbee DimmerUp

boolean pulse

Dimmer în sus

Ascultător
Bp := 0;
if INDEXOF(RECEIVEDMSG.Topic, "SENSOR") > 0
	var ZbReceived := PARSEJSON(RECEIVEDMSG.Payload, "ZbReceived." + ID, true);
    var button := PARSEJSON(ZbReceived, "DimmerUp", true);
    if(!ISNULL(button), Bp := 1);
end
Stânga Buton Doar citire

Detectează apăsarea săgeții stânga — se declanșează la evenimentul Zigbee ArrowClick

boolean pulse

Stânga

Ascultător
Bp := 0;
if INDEXOF(RECEIVEDMSG.Topic, "SENSOR") > 0
	var ZbReceived := PARSEJSON(RECEIVEDMSG.Payload, "ZbReceived." + ID, true);
    var button := PARSEJSON(ZbReceived, "ArrowClick", true);
    if(!ISNULL(button) and button = 1, Bp := 1);
end
Dreapta Buton Doar citire

Detectează apăsarea săgeții dreapta — se declanșează la evenimentul Zigbee ArrowClick

boolean pulse

Dreapta

Ascultător
Bp := 0;
if INDEXOF(RECEIVEDMSG.Topic, "SENSOR") > 0
	var ZbReceived := PARSEJSON(RECEIVEDMSG.Payload, "ZbReceived." + ID, true);
    var button := PARSEJSON(ZbReceived, "ArrowClick", true);
    if(!ISNULL(button) and button = 0, Bp := 1);
end
Comutare Buton Doar citire

Detectează apăsarea butonului central — se declanșează la evenimentul Zigbee Power

boolean pulse

Comutare

Ascultător
Bp := 0;
if INDEXOF(RECEIVEDMSG.Topic, "SENSOR") > 0
	var ZbReceived := PARSEJSON(RECEIVEDMSG.Payload, "ZbReceived." + ID, true);
    var button := PARSEJSON(ZbReceived, "Power", true);
    if(!ISNULL(button), Bp := 1);
end
Conexiune: Packet Parser → MQTT
Îmbunătățiri posibile (3)
  • Dimmer Down Hold — brightness_down_hold event — long press detection not implemented in TapHome template
  • Dimmer Up Hold — brightness_up_hold event — long press detection not implemented
  • Arrow Left/Right Hold — arrow_left_hold / arrow_right_hold — long press events not implemented

Surse

Ați găsit o problemă la acest șablon de dispozitiv?

Spuneți-ne ce nu funcționează, ce lipsește sau cum ar trebui să se comporte șablonul. Feedbackul dvs. ne ajută să păstrăm catalogul corect.

Verificat de TapHome

Doriți să folosiți acest șablon în TapHome Core?

Deschideți acest șablon în Customer Portal pentru a-l aplica într-una dintre locuințele dvs. sau pentru a propune o îmbunătățire și a o trimite înapoi în catalog.

Deschideți în portal