Sonoff SNZB-01

Packet Parser → MQTT

Trimis de

Ultima actualizare: 10. 2026

Pagina produsului Sonoff SNZB-01

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:

Deschideți interfața web Zigbee2MQTT și activați modul de asociere (Permit join)
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
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.

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

Verificați dacă SNZB-01 este asociat cu coordonatorul Zigbee2MQTT — trebuie să apară în lista de dispozitive cu stare verde
Verificați dacă variabila personalizată SonoffSNZB01 corespunde exact friendly name-ului sau adresei IEEE a dispozitivului (se ține cont de majuscule și minuscule)
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
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

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

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

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

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

Buton wireless

Citirea stării butonului

Bp := 0;

Scrierea stării butonului

# 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

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

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

LinkQuality

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

BatteryVoltage

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.

Descărcați șablon

Surse

Zigbee2MQTT — SNZB-01 device page
www.zigbee2mqtt.io 2026-03-30
Zigbee2MQTT GitHub — SNZB-01 device definition
github.com 2026-03-30

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