---
title: "Sonoff SNZB-01"
description: "Buton wireless Zigbee cu detectarea apăsării simple, duble și lungi prin puntea MQTT Zigbee2MQTT. Baterie, tensiune și calitatea legăturii. Șablon TapHome."
url: "https://taphome.com/ro/compatibility/zigbee2mqtt-sonoffsnzb01/"
language: ro
lastmod: 2026-10-08
generator: hugo
ai:
  topics: ["mqtt","sensor","zigbee","zigbee2mqtt","battery-powered","wireless-button"]
  questions: ["Cum integrez Sonoff SNZB-01 cu TapHome prin Zigbee2MQTT?","Ce acțiuni ale butonului detectează șablonul TapHome pentru Sonoff SNZB-01?","Cum configurez friendly name Zigbee2MQTT pentru SNZB-01 în TapHome?","De ce Sonoff SNZB-01 nu raportează apăsările butonului în TapHome?","Raportează șablonul SNZB-01 nivelul bateriei și calitatea legăturii?"]
---

# Sonoff SNZB-01

Comunicație: Packet Parser → MQTT

- [Pagina produsului Sonoff SNZB-01](https://sonoff.tech/product/gateway-and-sensors/snzb-01/)

> 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

Sonoff SNZB-01 este un buton wireless compact Zigbee 3.0, alimentat de o baterie tip monedă CR2450. Comunică cu TapHome indirect — butonul se asociază cu un coordonator Zigbee2MQTT (de ex. Sonoff ZBDongle-P/E sau un stick bazat pe CC2652), care transmite mesajele Zigbee în topicuri MQTT. TapHome se abonează la aceste topicuri MQTT printr-un modul PacketParser MQTT.

Șablonul detectează trei acțiuni ale butonului (apăsare simplă, apăsare dublă, apăsare lungă) și monitorizează procentul bateriei, tensiunea bateriei și calitatea legăturii Zigbee.

## Configurare

### Configurarea Zigbee2MQTT

Înainte de importul șablonului TapHome, SNZB-01 trebuie asociat cu un coordonator Zigbee2MQTT:

1. Deschideți interfața web Zigbee2MQTT și activați modul de asociere (**Permit join**)
2. Pe SNZB-01, scoateți capacul din spate și țineți apăsat butonul de resetare timp de 5 secunde, până când LED-ul clipește de trei ori
3. Dispozitivul apare în lista de dispozitive Zigbee2MQTT cu o adresă IEEE (de ex. `0x00124b001eab21e5`) sau cu un friendly name

### Variabila modulului

După importul șablonului în TapHome, setați variabila personalizată `SonoffSNZB01` pentru a identifica dispozitivul pe brokerul MQTT:

| Variabilă | Descriere | Cum se obține | Exemplu |
|----------|-------------|---------------|---------|
| `SonoffSNZB01` | Friendly name Zigbee2MQTT sau adresa IEEE a SNZB-01 | Interfața web Zigbee2MQTT → Devices → găsiți SNZB-01 → copiați friendly name sau adresa IEEE | `0x00124b001eab21e5` |

Variabila se folosește ca prefix al topicului MQTT — scriptul listener se abonează la `zigbee2mqtt/{SonoffSNZB01}` și `zigbee2mqtt/{SonoffSNZB01}/action`.

> [!TIP]
> Folosirea unui friendly name (de ex. `living_room_button`) în locul adresei IEEE face configurarea mai ușor de citit. Friendly name se poate schimba în interfața web Zigbee2MQTT, în setările dispozitivului.

## Funcțiile dispozitivului

### Detectarea apăsării butonului

Șablonul mapează SNZB-01 ca dispozitiv de tip Buton în TapHome. Evenimentele de apăsare a butonului sosesc pe topicul `zigbee2mqtt/{id}/action` și se convertesc în valori numerice:

| Acțiune fizică | Payload MQTT | Valoare TapHome |
|----------------|-------------|---------------|
| Apăsare simplă (eliberare + așteptare 0,6 s) | `single` | 1 |
| Apăsare dublă | `double` | 3 |
| Apăsare lungă (ținut apăsat 2 secunde) | `long` | 2 |

După citirea stării butonului, valoarea revine la 0 — acțiunile butonului sunt evenimente și nu pot fi citite ulterior.

### Monitorizarea bateriei și a semnalului

Fiecare instanță a butonului oferă trei atribute de service:

- **Baterie** — procentul rămas al bateriei (0–100 %) din topicul JSON de stare. SNZB-01 folosește o baterie tip monedă CR2450, cu o durată de viață tipică de 1–2 ani.
- **BatteryVoltage** — tensiunea bateriei în milivolți, din topicul JSON de stare.
- **LinkQuality** — indicatorul calității semnalului Zigbee (0–255 lqi) din topicul JSON de stare. Valorile mai mari indică un semnal mai bun.

Toate atributele afișează `"-"` până la primirea primului mesaj de la dispozitiv.

### Funcții suplimentare

Puntea Zigbee2MQTT oferă și un topic pentru solicitarea stării (`zigbee2mqtt/{id}/get`), prin care se pot cere la nevoie valorile bateriei și tensiunii, precum și un topic de disponibilitate pentru detectarea stării online/offline. Aceste funcții pot fi adăugate într-o actualizare viitoare a șablonului.

## Rezolvarea problemelor

### Apăsările butonului nu sunt detectate

1. Verificați dacă SNZB-01 este asociat cu coordonatorul Zigbee2MQTT — trebuie să apară în lista de dispozitive cu stare verde
2. Verificați dacă variabila personalizată `SonoffSNZB01` corespunde exact friendly name-ului sau adresei IEEE a dispozitivului (se ține cont de majuscule și minuscule)
3. Folosiți un client MQTT (de ex. MQTT Explorer) pentru a vă abona la `zigbee2mqtt/#` și apăsați butonul — pe topicul `/action` trebuie să apară un mesaj
4. Dacă nu apar mesaje MQTT, dispozitivul poate să fi pierdut conexiunea Zigbee — asociați-l din nou ținând apăsat butonul de resetare timp de 5 secunde

### Valori învechite ale bateriei sau calității legăturii

1. Datele despre baterie și semnal se actualizează doar când dispozitivul se trezește (la apăsarea butonului sau la raportarea periodică)
2. Dacă valorile afișează `"-"`, încă nu s-a primit niciun mesaj — apăsați butonul pentru a declanșa o actualizare
3. Asigurați-vă că coordonatorul Zigbee are o recepție bună — raza de acțiune a SNZB-01 depinde de rețeaua mesh Zigbee

> [!WARNING]
> Sonoff SNZB-01 nu se mai produce și a fost înlocuit de SNZB-01P. Șablonul TapHome rămâne valabil pentru dispozitivele SNZB-01 existente, dar pentru achiziții noi luați în considerare SNZB-01P, care oferă o rază de acțiune mai bună și o baterie de tip pastilă CR2477, mai mare.

## Dispozitive disponibile 1

Aceste dispozitive apar în TapHome după import.

Sonoff SNZB-01 Modul

Variabile personalizate

`SonoffSNZB01` (string) = 0x00124b001eab21e5 Friendly name Zigbee2MQTT sau adresa IEEE a dispozitivului SNZB-01 — se folosește ca prefix al topicului MQTT

Open Zigbee2MQTT web UI → Devices → find SNZB-01 → copy the Friendly name (or use the IEEE address, e.g. 0x00124b001eab21e5)

Buton wireless Buton Citire și scriere

Detectarea apăsării butonului — simplă (1), dublă (3), lungă (2); valoarea revine la 0 după citire

enum

Atribute de service

|                |                                                                                       |
|----------------|---------------------------------------------------------------------------------------|
| Baterie        | Procentul rămas al bateriei (baterie tip monedă CR2450, 0–100 %)                      |
| LinkQuality    | Indicatorul calității semnalului Zigbee — de la 0 (cel mai slab) la 255 (cel mai bun) |
| BatteryVoltage | Tensiunea bateriei în milivolți                                                       |

Citirea stării butonului

```taphome
Bp := 0;
```

Scrierea stării butonului

```taphome
# Simple HTTP Request:
# VAR response := SENDHTTPREQUEST("/example/set/value=" + Bp);
# IF response.IsSuccess = false
#  ADDERROR(response.StatusCode);
# END
#
# Set Http request method, body and headers
# VAR response := SENDHTTPREQUEST("/example/setValue", "GET", "value=" + Bp, "header1:value1", "header2:value2", ...);\r
# Or VAR request := HTTPREQUEST("/example/setValue");
# request.Method := "PUT";
# VAR response := SENDHTTPREQUEST(request);
#r
#
# Send TCP, UDP data:
# VAR data1 := "{\"name\":\"John\", \"age\":" + Bp + "}";
# SENDDATA(data1);
# VAR data2 := TOBYTES("{\"name\":\"John\", \"age\":" + Bp + "}", "iso-8859-1");
# SENDDATA(data2);
# You can process received TCP or UDP data in the Listener script
#
#
# Upload data to FTP:
# FTPUPLOAD("filePath", "somedata=" + Bp, "write"); # use "append" mode to append data to existing file
```

Ascultător

```taphome
Bp := 0;

IF (COMPARE(RECEIVEDMSG.TOPIC, "zigbee2mqtt/"+ SonoffSNZB01 +"/action", CompareOptions.IgnoreCase) = 0)
	var payloadString := TOSTRING(RECEIVEDMSG.PAYLOAD);
	
    IF (COMPARE(payloadString, "single", CompareOptions.IgnoreCase) = 0)
          Bp := 1;
        ELSEIF (COMPARE(payloadString, "long", CompareOptions.IgnoreCase) = 0)
          Bp := 2;
        ELSEIF (COMPARE(payloadString, "double", CompareOptions.IgnoreCase) = 0)
          Bp := 3;
        ELSE
          Bp := 0;
    END  
END;   

IF (COMPARE(RECEIVEDMSG.TOPIC, "zigbee2mqtt/"+ SonoffSNZB01, CompareOptions.IgnoreCase) = 0)
    battery := PARSEJSON(RECEIVEDMSG.PAYLOAD,"battery", true);
    voltage := PARSEJSON(RECEIVEDMSG.PAYLOAD,"voltage", true);
    link := PARSEJSON(RECEIVEDMSG.PAYLOAD,"linkquality", true);
    
END
```

Atribute de service

Battery

```taphome
IF(ISNAN(battery),"-",battery+"%");
```

LinkQuality

```taphome
IF(ISNAN(link),"-",link+"lqi");
```

BatteryVoltage

```taphome
IF(ISNAN(voltage),"-",voltage+"mV");
```

**Conexiune:** Packet Parser → MQTT

Îmbunătățiri posibile (2)

- Proactive State Request — Publish {"battery":""} or {"voltage":""} to request values on demand. Could wake sleeping device.
- Availability Status — Online/offline availability topic. Could detect unreachable devices.

## 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`        |

## Surse

- Zigbee2MQTT — SNZB-01 device page
  
  [www.zigbee2mqtt.io](https://www.zigbee2mqtt.io/devices/SNZB-01.html) 2026-03-30
- Zigbee2MQTT GitHub — SNZB-01 device definition
  
  [github.com](https://github.com/Koenkk/zigbee2mqtt.io/blob/master/docs/devices/SNZB-01.md) 2026-03-30

## 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/)

