
Shelly TRV (SHTRV-01) este un cap termostatic Wi-Fi pentru calorifer, alimentat de la baterie, produs de Allterco Robotics. Se montează direct pe corpul robinetului unui calorifer standard cu apă caldă și reglează temperatura camerei acționând tija robinetului cu un motor intern. TapHome comunică cu dispozitivul prin HTTP în rețeaua locală — fără gateway, fără cloud și fără broker MQTT.
Shelly TRV nu se mai produce; succesorul său este Shelly BLU TRV, bazat pe Bluetooth. Unitățile existente funcționează în continuare, iar TapHome oferă în continuare suport complet pentru acest șablon; pentru proiecte noi luați în considerare succesorul.
Pentru același dispozitiv fizic sunt disponibile două șabloane alternative — alegeți unul în funcție de modul de control dorit.
| Șablon | Oferă | Utilizare |
|---|---|---|
| Shelly TRV (principal) | Baterie + termostat cu buclă închisă | Controlul temperaturii camerei de către utilizator prin temperatura setată (5-30 °C). Firmware-ul reglează singur poziția robinetului. |
| Shelly TRV (valve) | Baterie + dimmer pentru robinet + termostat (varianta cu temperatură setată) | Smart rules care au nevoie de comanda directă a robinetului — poziția robinetului este disponibilă ca dimmer 0,0-1,0. |
Nu importați ambele șabloane pentru același dispozitiv fizic. Ambele se conectează la același endpoint, iar ciclurile de interogare se vor suprapune — scrierile vor intra în conflict, iar comportamentul robinetului devine imprevizibil.
Instalarea hardware
Shelly TRV nu are cablaj — este un cap mecanic de calorifer cu electronică internă, alimentat de o baterie Li-ion internă (Panasonic NCR18650BD, 3,7 V / 6500 mAh). Se montează direct pe corpul robinetului caloriferului cu ajutorul unui inel metalic de fixare.
Corpuri de robinet compatibile
Filet nativ: M30 × 1,5. În ambalaj sunt incluse următoarele adaptoare:
- Danfoss — RA, RAV, RAVL
- Caleffi
- Giacomini
- M28 × 1,5 — Sam, Slovarm, Comap, TA, Herz, MMA, Remagg
- Pont à Mousson
Adaptoarele altor producători (neincluse) extind compatibilitatea la Gampper, Ista, Meges, Ondal, Oventrop, Rossweiner, Vaillant și alții.
Procedura de montare
- Asigurați-vă că este oprit caloriferul și că s-a răcit.
- Rotiți capul manual existent al robinetului în sens invers acelor de ceasornic până la deschiderea completă, apoi deșurubați inelul metalic de fixare și scoateți capul.
- Montați adaptorul potrivit, dacă filetul robinetului nu este nativ M30 × 1,5.
- Așezați Shelly TRV pe corpul robinetului și strângeți inelul metalic în sensul acelor de ceasornic — ferm, dar nu excesiv. Atât o strângere prea slabă, cât și una prea puternică duc la eșecul calibrării.
- Rotiți afișajul în orientarea dorită înainte de strângerea completă a inelului.
- Apăsați scurt Reset (pe spatele dispozitivului). Afișajul arată
CL(calibrare), iar motorul intern se mișcă în ambele direcții. O calibrare reușită se încheie cuAPpe afișaj; eșecul este semnalat prinE1.
Calibrarea trebuie efectuată după fiecare remontare pe un alt corp de robinet. Până când
calibrated=true, scrierile temperaturii setate și ale poziției din TapHome sunt respinse cu mesajulDevice is not calibrated.
Încărcarea
Dispozitivul se încarcă prin USB-C (cablul este inclus, adaptorul nu). Un încărcător conform standardului USB-C, de cel puțin 1 A, încarcă complet bateria descărcată în aproximativ 5 ore. Durata tipică de funcționare a bateriei este de ~2 ani (~5 luni de sezon de încălzire continuu, la o utilizare obișnuită).
În timpul încărcării, carcasa dispozitivului se încălzește, iar senzorul intern de temperatură indică valori incorecte. Așteptați-vă la valori distorsionate ale temperaturii camerei cât timp
chargernu estedisconnected.
Configurare
Importul în TapHome
La importul șablonului, TapHome solicită un singur parametru:
| Parametru | Descriere | Valoare implicită |
|---|---|---|
IpAddress | Adresa IP locală sau numele de gazdă mDNS al dispozitivului | 192.168.0.1 |
Portul 80 este fix. HTTPS nu este acceptat la Gen1. Autentificarea HTTP Basic Auth trebuie să fie dezactivată pe dispozitiv — TapHome nu autentifică cererile HTTP către dispozitivele Shelly Gen1.
Folosiți, dacă este posibil, numele de gazdă mDNS (shellytrv-XXXXXX.local) — rămâne valabil chiar dacă se schimbă adresa atribuită prin DHCP. IP Scanner din TapHome (Settings → Network → Scan) găsește atât adresa IP, cât și numele de gazdă mDNS.
Dezactivarea programului săptămânal
Shelly TRV are un program săptămânal integrat (5 profiluri, până la 18 modificări programate pe săptămână pentru fiecare profil). Când programul este activat, firmware-ul suprascrie orice temperatură setată scrisă din exterior la următorul eveniment programat — temperaturile setate din TapHome sunt înlocuite cu valorile din program fără niciun avertisment.
Șablonul semnalează această situație printr-o avertizare (Schedule is enabled). Înainte de a trece dispozitivul sub controlul TapHome, fie:
- declanșați acțiunea de service Dezactivare program pe modul (trimite
/settings/thermostats/0?schedule=false), fie - selectați profilul Disable în aplicația Shelly Cloud sau în interfața web a dispozitivului.
Senzor extern de cameră (recomandat)
Senzorul de temperatură integrat se află fizic aproape de țeava fierbinte a caloriferului și indică de obicei cu 1-3 °C mai mult decât temperatura reală a camerei. Există două modalități de corecție:
- Senzor extern — asociați un termometru Wi-Fi separat (de exemplu Shelly H&T) prin interfața web a dispozitivului → Sensor Settings → Enable external temperature corrections endpoint. Senzorul extern trimite apoi temperatura ambiantă către TRV prin POST.
- Corecție statică — folosiți acțiunea de service Setare corecție temperatură pe dispozitivul Termostat (interval ±20 °C) pentru a compensa o abatere constantă.
Pentru cel mai bun confort termic combinați un senzor extern fiabil cu o mică corecție statică drept rezervă.
Funcțiile dispozitivului
Șablonul principal oferă dispozitivul ca indicator de baterie plus termostat cu buclă închisă. Șablonul pentru robinet păstrează același modul și aceeași baterie, dar oferă poziția robinetului ca dimmer și folosește o variantă a temperaturii setate care dezactivează reglarea PID automată la scriere. Diagnosticarea și acțiunile la nivel de modul sunt identice în ambele șabloane.
Starea bateriei
Bateria este disponibilă ca comutator cu mai multe valori, derivat din nivelul de încărcare raportat și din starea încărcătorului USB-C. Starea încărcătorului are prioritate față de nivel:
| Stare | Condiție |
|---|---|
| Critic | bat.value < 25 |
| Slab | bat.value 25-50 |
| Normal | bat.value 50-75 |
| Plin | bat.value > 75 |
| Încărcare | charger != disconnected |
Două atribute de service suplimentare raportează nivelul brut de încărcare a bateriei (%) și tensiunea celulei (V, nominal ~3,7 V, interval tipic 2,6-4,2 V). Șablonul generează Low battery sub 50 % și Battery charge is critically low sub 25 %.
Termostat (șablonul principal)
Termostat de cameră cu buclă închisă: TapHome scrie temperatura setată, iar firmware-ul TRV reglează singur poziția robinetului pe baza senzorului de temperatură integrat (sau extern).
- Citire: temperatura măsurată a camerei (
thermostats[0].tmp.value) și temperatura setată activă (thermostats[0].target_t.value) - Scriere: temperatura setată 5-30 °C prin
/settings/thermostats/0?target_t={Se}
Atributele suplimentare ale termostatului includ Corecție temperatură [°C], Poziția robinetului [%] (doar citire, pentru vizibilitatea ieșirii PID), Închidere forțată, Presiune suplimentară și Corecție automată a calibrării. Acțiunile de service corespunzătoare permit TapHome să seteze corecția, să comute modul de închidere forțată (robinetul rămâne complet închis indiferent de temperatura setată) și să comute modul de presiune suplimentară (mărește forța de acționare pentru robinetele greu de acționat).
Scrierea temperaturii setate eșuează cu Device is not calibrated cât timp calibrated=false, iar șablonul adaugă o avertizare când programul săptămânal este activat (deoarece firmware-ul va suprascrie scrierile externe la următorul eveniment programat).
Dimmer pentru robinet (șablonul pentru robinet)
Un șablon alternativ oferă actuatorul robinetului direct ca dispozitiv dimmer (0,0-1,0 → 0-100 %). TapHome scrie poziția prin /thermostats/0?pos={Le*100} — firmware-ul mută motorul în poziția solicitată și dezactivează implicit reglarea automată după temperatura setată.
Șablonul pentru robinet adaugă pe dispozitivul robinet atributele de service Închidere forțată, Presiune suplimentară și Corecție automată a calibrării (plus acțiunile de comutare corespunzătoare), astfel încât autorii de smart rules să poată acționa motorul direct în scenarii precum închiderea de urgență, preîncălzirea manuală sau secvențele de boost.
Termostat (varianta din șablonul pentru robinet)
Șablonul pentru robinet oferă în continuare un dispozitiv termostat, astfel încât temperatura setată să poată fi scrisă din același grup de dispozitive TapHome, însă scriptul său de scriere trimite atât target_t, cât și target_t_enabled=false, pentru ca reglarea PID din firmware să nu intre în conflict cu un robinet acționat manual. Setul de atribute de service se reduce la Corecție temperatură [°C] (atributele corpului robinetului, precum force_close și valve_state, trec în schimb pe dispozitivul robinet). Șablonul avertizează când se observă target_t.enabled=true — aceasta indică un conflict între dimmerul robinetului și reglarea automată.
Diagnosticarea și acțiunile modulului
Modulul (capul termostatic) interoghează /status și /settings la fiecare 3 secunde și oferă diagnosticare și acțiuni pentru întregul dispozitiv:
- Diagnosticare: SSID Wi-Fi, adresa IP, MAC, puterea semnalului recepționat (RSSI în dBm), starea calibrării, program activat/dezactivat, luminozitatea afișajului (1-7) și starea de afișaj răsturnat.
- Acțiuni: Dezactivare program, Repornire, Calibrare (declanșează
/calibrate), Actualizare firmware (descarcăSHTRV-01_build.gblde pe serverul oficial de firmware Shelly EU), Setare luminozitate afișaj și Răsturnare afișaj.
Funcții suplimentare
Dispozitivul oferă și câteva funcții Gen1 pe care șabloanele actuale încă nu le pun la dispoziție: detectarea pasivă a ferestrei deschise (/window), acțiunea simetrică Force open, temperatura ambiantă de rezervă (auto_temp), blocarea pentru copii, întârzierea închiderii automate la fereastră deschisă, senzorul temperaturii setate din program (schedule_t), indexul profilului activ, minutele rămase de boost și acțiunea Trigger boost (/thermostats/0?boost_minutes=N), starea termică a electronicii interne (tmp_state) și disponibilitatea actualizării firmware ca senzor. Transmiterea CoIoT push și transportul MQTT sunt acceptate la nivelul dispozitivului, dar nu se folosesc — TapHome interoghează în schimb /status la fiecare 3 s. Acestea pot fi adăugate într-o actualizare viitoare a șablonului.
Depanare
Device is not calibrated
Fiecare scriere a temperaturii setate și a poziției robinetului returnează Device is not calibrated până când TRV finalizează cu succes un ciclu de calibrare.
- Asigurați-vă că dispozitivul este bine așezat pe corpul robinetului — inelul de fixare trebuie să fie suficient de strâns pentru ca motorul să apese pe tija robinetului, dar nu atât de strâns încât să se deformeze.
- Declanșați acțiunea de service Calibrare pe modul (trimite
/calibrate). Afișajul arată pentru scurt timpCL, în timp ce motorul se mișcă în ambele direcții. - La reușită,
calibrateddevinetrue, iar scrierile reușesc; eșecul este semnalat prinE1pe afișaj — de obicei indică o montare incorectă.
Temperatura setată revine la valoarea din program la fiecare câteva ore
Este programul săptămânal, care suprascrie scrierile externe. Verificați atributul de service Program — dacă este activat, declanșați acțiunea Dezactivare program pe modul sau dezactivați profilul activ în aplicația Shelly Cloud.
Temperatura măsurată a camerei este prea mare
Două cauze frecvente:
- Încărcătorul este conectat. Valorile temperaturii camerei nu sunt valabile cât timp
charger != disconnected. Deconectați cablul USB-C și lăsați dispozitivul să se răcească. - Abaterea senzorului integrat. Senzorul se află aproape de țevile fierbinți și indică de obicei cu 1-3 °C mai mult. Fie activați endpointul pentru corecții de temperatură externe și asociați un Shelly H&T (sau un termometru Wi-Fi compatibil) în aceeași cameră, fie aplicați o corecție statică prin Setare corecție temperatură (de ex.
-1.5 °C).
Afișajul arată E1 / E2
E1 — problemă de calibrare. Remontați dispozitivul, strângeți inelul cu atenție și declanșați un nou ciclu de calibrare.
E2 — problemă a senzorului de temperatură. tmp.is_valid devine false în /status, iar șablonul adaugă eroarea Temperature sensor error. Dacă problema persistă după o repornire, senzorul s-a defectat probabil — contactați suportul tehnic Shelly.
Dispozitivul nu este accesibil
- Verificați dacă TRV este conectat la Wi-Fi — apăsați Up + Down timp de 5 s și parcurgeți parametrii de stare;
COindică un client Wi-Fi conectat. - Verificați dacă unitatea centrală TapHome (CCU) și TRV se află în aceeași rețea / VLAN — Shelly Gen1 implicit nu comunică între subrețele.
- Încercați numele de gazdă mDNS (
shellytrv-XXXXXX.local) în locul adresei IP — alocarea DHCP s-ar fi putut schimba. - Deschideți
http://{device-ip}/statusîn browser. Dacă sosește răspunsul JSON, dispozitivul este accesibil, iar problema este în configurarea TapHome.
Dispozitivele Shelly Gen1 acceptă doar 2 conexiuni HTTP simultane. Dacă TapHome și un alt sistem (Home Assistant, Node-RED) interoghează același dispozitiv în același timp, comunicarea devine instabilă. Păstrați intervalul de interogare implicit al șablonului (3 s) și evitați alte sisteme care interoghează dispozitivul.
La dispozitivele Shelly Gen1, activarea MQTT dezactivează ireversibil Shelly Cloud. TapHome folosește doar HTTP — lăsați MQTT dezactivat, cu excepția cazului în care doriți explicit să renunțați la Shelly Cloud.