---
title: "Zigbee2Tasmota Gateway"
description: "Conectați dispozitive Zigbee la TapHome prin MQTT cu un gateway cu Tasmota. Împerechere, descoperire și coordonarea tuturor șabloanelor Z2T."
url: "https://taphome.com/ro/compatibility/zigbee2tasmota-gateway/"
language: ro
lastmod: 2026-03-29
generator: hugo
ai:
  topics: ["mqtt","zigbee","gateway","tasmota","wifi","ethernet"]
  questions: ["Cum integrez dispozitive Zigbee cu TapHome folosind Tasmota?","De ce hardware am nevoie pentru un gateway Zigbee2Tasmota?","Cum împerechez dispozitive Zigbee cu TapHome prin Tasmota?","Cum găsesc Device ID-ul Zigbee după împerechere?","Care este diferența dintre eWeLink ZB-GW03 și Sonoff ZBBridge?","Cum configurez MQTT pentru gateway-ul Zigbee2Tasmota în TapHome?"]
---

# Zigbee2Tasmota Gateway

Comunicație: Packet Parser → MQTT

- [Documentația Tasmota Zigbee](https://tasmota.github.io/docs/Zigbee/)

> Adresa în rețea
> 
> Pentru brokerul MQTT integrat în TapHome este vorba de un singur broker, accesat din două locuri. Șablonul rulează direct în TapHome Core, de aceea în TapHome adresa brokerului este `127.0.0.1` (acest calculator). Dispozitivul rulează în altă parte a rețelei, de aceea în dispozitiv introduceți adresa IP a unității TapHome Core și atribuiți unității Core o rezervare IP în router — dacă adresa Core se schimbă, dispozitivul nu mai ajunge la broker.
> 
> [Pregătirea rețelei](https://taphome.com/ro/docs/setup/network-preparation/)

## Ghid de integrare

Zigbee2Tasmota (Z2T) este un bridge Zigbee–MQTT ușor, care rulează pe microcontrolere ESP8266/ESP32 cu modul radio Zigbee integrat. Permite TapHome să comunice cu dispozitivele Zigbee prin brokerul MQTT local — fără conexiune la cloud.

Acest șablon de gateway este **condiția preliminară pentru toate șabloanele de dispozitive Zigbee2Tasmota**. Trebuie importat primul, înainte de a adăuga orice șablon de dispozitiv Zigbee. Gateway-ul gestionează împerecherea dispozitivelor și pune la dispoziție în TapHome comutatorul Permit Join și contorul Dispozitive găsite.

## Hardware de gateway acceptat

Următorii coordonatori Zigbee sunt compatibili cu Zigbee2Tasmota:

| Gateway | Procesor | Radio Zigbee | Conectivitate | Note |
|---------|-----------|-------------|--------------|-------|
| **eWeLink ZB-GW03** (recomandat) | ESP32 | EFR32 (EZSP) | Ethernet + Zigbee | Disponibil cu Tasmota preinstalat |
| **Sonoff ZBBridge** | ESP8266 | EFR32 (EZSP) | Wi-Fi + Zigbee | Necesită încărcarea manuală a firmware-ului Tasmota |
| **Sonoff ZBBridge Pro** | ESP32 | CC2652P (ZNP) | Wi-Fi + Zigbee | Până la 128 de dispozitive, necesită încărcarea firmware-ului |

Alte echipamente hardware compatibile sunt Tube's Ethernet Zigbee Gateway (bazat pe EFR32) și gateway-uri DIY construite folosind ESP32 și module CC2530/CC2652.

> [!TIP]
> eWeLink ZB-GW03 este recomandat pentru conectivitatea Ethernet (mai fiabilă decât Wi-Fi) și pentru că este disponibil cu Tasmota preinstalat — nu este necesară încărcarea firmware-ului.

## Configurare

### Configurarea gateway-ului Tasmota

1. Încărcați [firmware-ul Tasmota](https://tasmota.github.io/docs/Getting-Started/) pe coordonatorul Zigbee (omiteți acest pas dacă este preinstalat)
2. Conectați gateway-ul la rețea 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`
4. Notați numele **Topic** (de ex. `tasmota_XXXXX`) — acesta este parametrul **Gateway name** necesar la importul șablonului

> [!TIP]
> TapHome are un broker MQTT integrat — activați-l în **Setări** → **Hardware** → **MQTT Broker**. Nu este necesar niciun software de broker suplimentar.

### Parametrii de import ai șablonului

Șablonul gateway-ului necesită 3 parametri:

| Parametru | Descriere | Exemplu |
|-----------|-------------|---------|
| **MQTT Broker IP Address** | Adresa IP a brokerului dvs. MQTT | `192.168.1.10` |
| **MQTT Broker Port** | Portul brokerului (implicit 1883) | `1883` |
| **Gateway name** | Topicul MQTT Tasmota din Configuration → MQTT → Topic | `tasmota_XXXXX` |

După import, modulul se abonează la `tele/{GWname}/#` și apar două dispozitive: **Permit Join** și **Dispozitive găsite**.

## Funcțiile dispozitivului

### Împerecherea dispozitivelor Zigbee

Comutatorul **Permit Join** controlează modul de împerechere al gateway-ului:

1. Porniți **Permit Join** în TapHome — se publică o comandă `ZbPermitJoin` care deschide o fereastră de împerechere de 60 de secunde
2. Porniți procedura de împerechere pe dispozitivul Zigbee (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 un dispozitiv nou se conectează cu succes la rețea
4. Verificați atributul de service **Dispozitive noi** al gateway-ului pentru a vedea ID-ul dispozitivului împerecheat (de ex. `0x1234`), producătorul și modelul
5. Modul de împerechere se dezactivează automat după expirarea timpului

Device ID-ul (adresa scurtă, de ex. `0x1234`) afișat în atributele de service este necesar la importul șabloanelor specifice dispozitivelor.

### Monitorizarea dispozitivelor

Modulul gateway-ului interoghează `ZbInfo` la fiecare oră, pentru a actualiza informațiile despre toate dispozitivele Zigbee împerecheate. Atributul de service **Dispozitive noi** afișează detaliile dispozitivelor descoperite recent, inclusiv adresa scurtă Zigbee, producătorul și identificatorul modelului.

### Funcții suplimentare

Gateway-ul Zigbee Tasmota acceptă și listarea tuturor dispozitivelor împerecheate (`ZbStatus`), vizualizarea configurației rețelei (`ZbConfig` — PanID, canal, chei de criptare), denumirea dispozitivelor, gestionarea grupurilor și legarea directă între dispozitive. Aceste funcții de diagnosticare și administrare pot fi adăugate într-o actualizare viitoare a șablonului.

## Șabloane de dispozitive Zigbee acceptate

După împerecherea unui dispozitiv, importați șablonul specific dispozitivului respectiv. Fiecare șablon de dispozitiv necesită 4 parametri: adresa IP a brokerului MQTT, portul, Gateway name (același ca la gateway) și Device ID-ul de la împerechere.

Șabloane de dispozitive Zigbee2Tasmota disponibile:

- [Aqara Temperature, Humidity and Pressure Sensor](https://taphome.com/ro/compatibility/zigbee2tasmota-aqara-temperature-humidity-and-pressure-sensor/)
- [Aqara Door and Window Sensor](https://taphome.com/ro/compatibility/zigbee2tasmota-aqara-door-and-window-sensor/)
- [Aqara Vibration Sensor](https://taphome.com/ro/compatibility/zigbee2tasmota-aqara-vibration-sensor/)
- [Aqara Water Leak Sensor](https://taphome.com/ro/compatibility/zigbee2tasmota-aqara-water-leak-sensor/)
- [Aqara Single Switch Module T1 (With Neutral)](https://taphome.com/ro/compatibility/zigbee2tasmota-aqara-single-switch-module-t1-with-neutral/)
- [IKEA TRADFRI E1810 Remote](https://taphome.com/ro/compatibility/zigbee2tasmota-ikea-tradfri-e1810/)
- [Livarno SMART TS0505B](https://taphome.com/ro/compatibility/zigbee2tasmota-livarno-smart-ts0505b/)
- [Moes Smart Switch](https://taphome.com/ro/compatibility/zigbee2tasmota-moes-smart-switch/)

## Rezolvarea problemelor

### Gateway-ul nu se conectează la brokerul MQTT

1. Verificați dacă gateway-ul Tasmota este conectat la rețea (verificați interfața web Tasmota)
2. Verificați dacă adresa IP și portul brokerului MQTT sunt aceleași în configurația MQTT Tasmota și în parametrii de import ai șablonului TapHome
3. Verificați dacă brokerul MQTT rulează și este accesibil pe portul specificat

### Permit Join nu găsește dispozitive

1. Asigurați-vă că dispozitivul Zigbee este în modul de împerechere — majoritatea dispozitivelor necesită ținerea apăsată a unui buton timp de 5 secunde sau mai mult
2. Verificați dacă comutatorul Permit Join este ON în TapHome înainte de a porni procedura de împerechere a dispozitivului
3. La prima împerechere, apropiați dispozitivul Zigbee de gateway (la 2–3 metri)
4. Unele dispozitive necesită o resetare la setările din fabrică înainte de a se putea împerechea cu un coordonator nou

### Device ID-ul nu apare

1. După împerecherea reușită, verificați atributul de service **Dispozitive noi** al modulului gateway-ului pentru ID-ul dispozitivului, producător și model
2. Dacă atributul de service este gol, încercați să comutați Permit Join pe OFF și din nou pe ON, apoi împerecheați din nou dispozitivul
3. Device ID-ul se poate găsi și în consola Tasmota (comanda `ZbStatus`), prin interfața web a gateway-ului

> [!WARNING]
> Canalul radio Zigbee nu trebuie să se suprapună cu canalul Wi-Fi. Pentru cele mai bune rezultate, folosiți canalele Zigbee 15, 20 sau 25, care au interferențe minime cu Wi-Fi. Verificați canalul curent cu comanda `ZbConfig` în consola Tasmota.

## Dispozitive disponibile 2

Aceste dispozitive apar în TapHome după import.

Zigbee2Tasmota Gateway Modul

Atribute de service

|                 |                                                                                                                 |
|-----------------|-----------------------------------------------------------------------------------------------------------------|
| Dispozitive noi | Dispozitive Zigbee descoperite recent — afișează ID-ul dispozitivului, producătorul și modelul după împerechere |

Variabile personalizate

|                   |                                                                                                   |
|-------------------|---------------------------------------------------------------------------------------------------|
| `GWname` (string) | Numele topicului MQTT Tasmota al gateway-ului Zigbee (se găsește în Configuration → MQTT → Topic) |

Citire (modul)

```taphome
MQTTPUBLISH("cmnd/" + GWname+ "/ZbInfo", "");
```

Scriere (modul)

```taphome
if (St = 0, count := NaN, if (isnan(count), count := 0) )
```

Ascultător

```taphome
if INDEXOF(RECEIVEDMSG.Topic, "SENSOR") > 0
    var ModelId := PARSEJSON(RECEIVEDMSG.Payload, "ZbReceived." + ID + ".ModelId", true);
    var Manufacturer := PARSEJSON(RECEIVEDMSG.Payload, "ZbReceived." + ID + ".Manufacturer", true);
    if !ISNULL(Manufacturer) and !ISNULL(ModelId)
    	new := new + ID + " - " + Manufacturer + " (" + ModelId + ")";
    	ID := "";
    	count := count +1;
    end
end

if INDEXOF(RECEIVEDMSG.Topic, "RESULT") > 0
	if PARSEJSON(RECEIVEDMSG.Payload, "$.ZbState.JoinStatus", true) = 1
		ID := PARSEJSON(RECEIVEDMSG.Payload, "$.ZbState.ShortAddr");
	end
end
```

Atribute de service

New devices

```taphome
new
```

Dispozitive găsite Variabilă Doar citire

Contorul dispozitivelor Zigbee împerecheate cu succes — crește în timpul Permit Join când se conectează un dispozitiv nou

numeric

Atribute de service

|                 |                                                                                                          |
|-----------------|----------------------------------------------------------------------------------------------------------|
| Dispozitive noi | Detaliile dispozitivelor împerecheate — ID-ul, producătorul și modelul dispozitivelor Zigbee descoperite |

Citire

```taphome
Va := count
```

Atribute de service

New devices

```taphome
new
```

Permit Join Comutator Citire și scriere

Comutator pentru modul de împerechere Zigbee — deschide o fereastră de 60 de secunde în care dispozitivele noi se pot conecta la rețea

boolean

Valori / Stări: ON · OFF

Scrierea stării comutatorului

```taphome
if St = 1
	MQTTPUBLISH("cmnd/" + GWname+ "/ZbInfo", "");
	new := "";
	ID := "";
end

MQTTPUBLISH("cmnd/" + GWname+ "/ZbPermitJoin", tostring(St));
```

Ascultător

```taphome
if INDEXOF(RECEIVEDMSG.Topic, "RESULT") > 0
    var Status := PARSEJSON(RECEIVEDMSG.Payload, "ZbState.Status", true);
    if Status = 20
        St := 0;
    elseif Status = 21
        St := 1;
    end
end

if (St = 0, count := NaN, if (isnan(count), count := 0) )
```

**Conexiune:** Packet Parser → MQTT

Îmbunătățiri posibile (2)

- Zigbee Device List — Lists all paired devices with short/IEEE addresses. Could provide a device inventory view.
- Zigbee Network Configuration — PanID, ExtPanID, channel, encryption keys. Could expose as service attributes.

## Parametri de import

Introduceți aceste valori când importați XML-ul.

| Solicitat în aplicație                                      | Implicit        |
|-------------------------------------------------------------|-----------------|
| Mqtt Broker Adresă IP                                       | `192.168.0.1`   |
| Mqtt Broker port                                            | `1883`          |
| Gateway name (Tasmota-&gt;Configuration-&gt;MQTT-&gt;Topic) | `tasmota_XXXXX` |

## Surse

- Tasmota Zigbee Documentation
  
  [tasmota.github.io](https://tasmota.github.io/docs/Zigbee/) 2026-03-29
- Zigbee Compatible Devices Database
  
  2026-03-29
- Supported Zigbee Gateway Hardware
  
  [templates.blakadder.com](https://templates.blakadder.com/ewelink_ZB-GW03.html) 2026-03-29

## Documentație asociată

- [MQTT Integration](https://taphome.com/ro/compatibility/mqtt-guide/)
- [Packet Parser (HTTP, TCP, UDP, FTP, MQTT)](https://taphome.com/ro/docs/integration/packet-parser/)
- [Funcții Packet parser](https://taphome.com/ro/docs/script/packet-parser/)
- [Funcții de parsare](https://taphome.com/ro/docs/script/parsing-functions/)
- [MQTT Broker](https://taphome.com/ro/docs/integration/packet-parser/mqtt-broker/)
- [Scripturi listener](https://taphome.com/ro/docs/script/listener-scripts/)

