Il Tuya Smart Knob ZG-101Z/D è una manopola rotante senza fili, a batteria, dal costo davvero contenuto: circa 8-12 € su AliExpress. Al momento della scrittura il prezzo è di circa 12 €, ma si trova spesso in offerta, anche a marchio diverso. L’importante è leggere bene la scheda prodotto: deve essere Zigbee, e compatibile nativamente con Zigbee2MQTT o ZHA.
Ne ho acquistati diversi nel tempo, e di recente altri tre. Tutti condividono la stessa scatola, la stessa fattura, lo stesso nome — sono identici all’esterno. Le differenze, però, emergono in Zigbee2MQTT.
Il codice fingerprint cambia tra gli esemplari: _TZ3000_abrsvsou (vendor Tuya) e _TZ3000_gwkzibhs (vendor Moes). Il knob Moes ha in più dei trigger relativi alla luminosità e agli step di transizione — riesce a intercettare questi valori, che possono essere usati come trigger o variabili dentro un’automazione. Per il resto, le due varianti sono pressoché identiche.
Una nota su cui vale la pena soffermarsi riguarda la batteria. Nella descrizione del prodotto viene riportata la sigla CR2430, ma smontando il dispositivo e controllando da vicino, la batteria a bottone installata è in realtà una CR2450.
I tre esemplari acquistati, con il dettaglio del vano batteria aperto
Scheda tecnica
| Variante Tuya | Variante Moes | |
|---|---|---|
| Modello commerciale | ZG-101Z/D | ZG-101Z/D |
| Modello Zigbee | TS004F | TS004F |
| Fingerprint | _TZ3000_abrsvsou | _TZ3000_gwkzibhs |
| Firmware ID | 0122052017 | 0112082025 |
| Vendor Z2M | Tuya | Moes |
| Definizione Z2M | ZG-101Z/D | ZG-101ZD |
| OUI chip | Telink Semiconductor | Telink Semiconductor |
| Tipo nodo | EndDevice | EndDevice |
| Alimentazione | CR2450 3V | CR2450 3V |
Modello commerciale
Modello Zigbee
Fingerprint
_TZ3000_abrsvsou_TZ3000_gwkzibhsFirmware ID
01220520170112082025Vendor Z2M
Definizione Z2M
OUI chip
Tipo nodo
Alimentazione
Un punto importante da sottolineare: la differenza tra le due varianti non è visibile né sulla confezione né sul listing AliExpress. L’unico modo per saperlo è controllare il tab “Informazioni” in Zigbee2MQTT dopo il pairing.
Unboxing e qualità costruttiva
Il dispositivo arriva a casa nei tempi tipici di AliExpress, e la scatola si rivela molto semplice: un box cubico con dentro il dispositivo avvolto in una protezione di plastica, le istruzioni, un adesivo per fissarlo al muro (o dove si preferisce) e la piastra circolare per appenderlo. L’adesivo è resistente — a distanza di anni è ancora ben saldo (verificato anche su altri dispositivi con lo stesso tipo di fissaggio).
La batteria è inclusa e già installata, ed è — come anticipato — una CR2450. Le istruzioni sono ridotte all’osso, ma non sono davvero necessarie: la prima associazione è immediata.
Per cambiare la batteria bisogna svitare una piccola vite sul retro e rimuovere la cover. Il retro è magnetizzato per aderire alla piastra in dotazione. Va detto, per onestà, che il magnete fa il suo lavoro ma non è infallibile: se al buio si cerca il dispositivo a tentoni e lo si spinge per errore, può staccarsi e cadere. Capita, occasionalmente.
Le dimensioni sono adeguate — non così piccolo da sembrare un giocattolo, né così grande da risultare ingombrante: il diametro è di 5 cm, la circonferenza circa 16 cm.
Il materiale, come prevedibile per il prezzo, è economico, ma non sgradevole al tatto. Il peso è bilanciato e la sensazione complessiva è di solidità. La ghiera ruota bene e restituisce un buon feedback tattile, senza fine corsa: gira all’infinito in entrambe le direzioni. Click e doppio click sono precisi, e queste versioni includono anche la pressione prolungata (long press) — davvero utile. In totale il dispositivo intercetta: rotazione a destra, rotazione a sinistra, click singolo, doppio click, pressione prolungata, oltre ai trigger di batteria e — sulla variante Moes — agli step di transizione.
Il vero valore sta nel rapporto qualità-prezzo: costa poco e fa egregiamente il suo lavoro. Con una spesa contenuta è possibile portarsi a casa diversi esemplari — sono discreti e offrono molti eventi utili per automatizzare la casa. Per chi vuole controllare la luminosità delle luci, è un dispositivo da avere: indispensabile. In un tutorial dedicato vedremo come, con le luci giuste, il knob possa controllare non solo la luminosità ma anche la temperatura colore in Kelvin.
Installazione a muro
Le azioni disponibili: la sorpresa che la documentazione non dice
Le azioni disponibili sui due knob sono quasi identiche — la versione Moes aggiunge ed espone qualche funzionalità in più.
Variante Tuya — _TZ3000_abrsvsou
"double"action"hold"action"rotate_left"action"rotate_right"action"single"action- Battery battery level changes
- Operation mode option changed
La documentazione ufficiale Zigbee2MQTT per questa variante (zigbee2mqtt.io/devices/ZG-101Z_D.html) elenca solo rotate_left e rotate_right. Nella realtà dei fatti, come si vede dallo screenshot, il dispositivo espone anche hold, single e double — pressione, doppia pressione e pressione prolungata. Si può fare molto più di quanto sembri a prima vista.
Variante Moes — _TZ3000_gwkzibhs
"double"action"hold"action"rotate_left"action"rotate_right"action"single"action"toggle"action — extra rispetto alla variante Tuya- Action transition time value changes — extra
- Battery battery level changes
- Operation mode option changed
Come si vede, la variante Moes acquistata più di recente espone in più l’azione toggle e il sensore “Action transition time value changes”.
Chi si ferma a leggere la documentazione ufficiale per la variante _TZ3000_abrsvsou crede di avere tra le mani un dispositivo incompleto. Testandolo sul campo, invece, emergono molte più possibilità di quanto la pagina Z2M lasci intendere. La variante Moes, dal canto suo, aggiunge anche i parametri di transizione, come confermato dalla documentazione ufficiale del modello Moes ZG-101ZD:
Le azioni possibili includono: toggle, brightness_step_up, brightness_step_down, color_temperature_step_up, color_temperature_step_down, saturation_move, hue_move, hue_stop, single, double, hold, rotate_left, rotate_right.
Va ricordato che il progetto Zigbee2MQTT è in continua evoluzione: vengono aggiunti regolarmente nuovi dispositivi e nuove proprietà, e talvolta la documentazione non viene aggiornata di pari passo.
Riepilogo — azioni variante Tuya _TZ3000_abrsvsou
| Azione / Evento | Doc Z2M | Realtà in HA |
|---|---|---|
rotate_right | documentata | disponibile |
rotate_left | documentata | disponibile |
single | non documentata | disponibile |
double | non documentata | disponibile |
hold | non documentata | disponibile |
| Battery level changes | sì | sì |
| Operation mode changed | sì | sì |
rotate_right
rotate_left
single
double
hold
Battery level changes
Operation mode changed
Riepilogo — confronto Tuya vs Moes
| Azione / Evento | Variante Tuya | Variante Moes |
|---|---|---|
rotate_right | sì | sì |
rotate_left | sì | sì |
single | sì | sì |
double | sì | sì |
hold | sì | sì |
toggle | no | sì |
| Action transition time | no | sì |
| Battery level changes | sì | sì |
| Operation mode changed | sì | sì |
rotate_right
rotate_left
single
double
hold
toggle
Action transition time
Battery level changes
Operation mode changed
Il nome commerciale ZG-101Z/D corrisponde quindi ad almeno due varianti che, per i comandi e le azioni base, sono identiche — entrambe possono essere acquistate senza rischio. La versione a marchio Moes espone qualche funzionalità in più, che vedremo come sfruttare nel tutorial dedicato. Ma entrambe risultano comunque complete per le azioni base: non si può sbagliare nell’acquisto, perché funzionano entrambe.
Come verificare la tua variante in Zigbee2MQTT
Zigbee2MQTT → Dispositivi → [il tuo knob] → tab Informazioni, campo Modello Zigbee, riga sotto:
_TZ3000_abrsvsou→ variante Tuya, firmware0122052017_TZ3000_gwkzibhs→ variante Moes, firmware0112082025
Il vendor Z2M “Moes” sulla variante ricca è un dettaglio che sorprende: stesso listing AliExpress, stesso aspetto fisico, vendor diverso nel database Z2M. Non è un errore — Moes è un brand OEM che utilizza gli stessi moduli Tuya/Telink.
Bug storici sulla variante Moes (a quanto pare risolti)
Da una ricerca sui forum — che per onestà non ho potuto verificare di persona, non avendoli riscontrati — alcuni utenti segnalavano questi problemi, oggi a quanto pare risolti. Li riporto per correttezza, ma personalmente non ho mai dovuto scollegare e ricollegare il dispositivo: ha sempre funzionato senza intoppi.
- Z2M 2.6.0 (ago 2025): mappatura errata sul profilo “Hobeian” → le azioni non arrivavano
- Z2M 2.6.1 (set 2025): persi
action_step_sizeebrightness_step_up - Versioni successive: risolto — profilo stabile da fine 2025
Se hai la variante Moes e dopo un aggiornamento Z2M il knob smette di rispondere, controlla il profilo assegnato in Z2M → Informazioni. Se non è corretto, rimuovi e ri-aggiungi il device con Z2M aggiornato all’ultima versione.
Modalità command vs event
La modalità da usare per chi lavora con Home Assistant è sempre event. La modalità command serve per il binding diretto a un gruppo Zigbee, che in HA non viene praticamente mai utilizzato — non avrebbe senso, dato che si bypassa l’automazione. La cito comunque perché è una funzionalità presente: chi volesse usarla può farlo.
command | event | |
|---|---|---|
| Funzionamento | Controlla un gruppo Zigbee via binding diretto | Le azioni passano per Z2M → HA |
| Latenza | Minima | Normale |
| Flessibilità | Solo il gruppo Zigbee assegnato | Qualsiasi entità HA |
| Funziona senza HA | Sì | No |
| Consigliato per | Dimmer fisso su un singolo gruppo luci | Qualsiasi automazione HA |
Funzionamento
commandBinding diretto a gruppo ZigbeeeventAzioni via Z2M → HALatenza
commandMinimaeventNormaleFlessibilità
commandSolo il gruppo Zigbee assegnatoeventQualsiasi entità HAFunziona senza HA
commandSìeventNoConsigliato per
commandDimmer fisso su un singolo gruppo lucieventQualsiasi automazione HALa guida completa con i YAML per le automazioni è nel tutorial dedicato: Tuya Smart Knob ZG-101Z/D: configurazione e automazioni YAML .
Durata batteria e comportamento Zigbee
La batteria CR2450 da 3V non è un problema: è già installata nella confezione, e il dispositivo consuma pochissimo. La stima di 12 mesi di autonomia è conservativa — dura tranquillamente di più con un uso normale.
Il dispositivo, come tutti i device a batteria, è un EndDevice: non è un router e non può ripetere il segnale. Deve quindi collegarsi a un altro dispositivo router o direttamente al coordinator principale. Se vuoi approfondire la differenza tra EndDevice e router nel confronto tra protocolli Zigbee, Thread, Matter e WiFi, c’è un articolo dedicato.
Sul segnale: a circa 10 metri dal router più vicino, il valore LQI rilevato è 164 — un buon risultato. Nessuno dei tre dispositivi si è mai disconnesso. In qualche occasione, quelli posizionati più lontani hanno impiegato un istante in più per completare l’azione, ma non è possibile stabilire con certezza se la causa sia il dispositivo stesso o un rallentamento momentaneo di Home Assistant.
Il posizionamento consigliato resta comunque entro 10-15 metri dal coordinator o da un router Zigbee vicino. I tre dispositivi, come visibile dallo screenshot della rete, hanno trovato il proprio collegamento mesh con qualità compresa tra 100 e 164 a seconda dei punti di aggancio.
Conclusioni
I dispositivi mi sono piaciuti molto. Avevo bisogno di controllare la luminosità delle luci e questi dispositivi lo fanno bene — in più offrono il controllo di click singolo, doppio e prolungato.
Per il prezzo richiesto, sono un affare: economici, funzionali ed esteticamente gradevoli. Il pairing è immediato, la risposta veloce. Qualsiasi variante tu riceva va bene — non ci sono problemi di sorta.
Un consiglio quando acquisti: controlla sempre due volte. A volte la documentazione e la descrizione su AliExpress non sono complete — leggi con attenzione anche i commenti degli altri acquirenti. Puoi andare sul sicuro con entrambe le varianti, Tuya e Moes. Se dovessi scegliere, a parità di prezzo opterei per la Moes: marca affidabile, qualche funzione in più.
Pro
- Prezzo sotto i 12 € per unità — tra i controlli rotanti Zigbee più economici sul mercato
- Integrazione locale totale: nessun cloud, nessun bridge proprietario
- Pairing immediato con Z2M su entrambe le varianti
- Entrambe le varianti espongono single/double/hold in HA, nonostante la documentazione Z2M incompleta sulla variante Tuya
- La variante Moes aggiunge
togglee i parametri di transizione - Batteria CR2450 con autonomia reale superiore ai 12 mesi dichiarati
Contro
- Le due varianti non sono distinguibili dalla confezione o dal listing AliExpress
- Documentazione Z2M incompleta sulla variante Tuya (mancano single/double/hold)
- Storico bug Z2M sulla variante Moes (oggi risolti, ma da tenere a mente)
- EndDevice: non contribuisce alla stabilità della rete Zigbee
- Il fissaggio magnetico non è sempre affidabile in caso di urti accidentali

