Shelly TRV (SHTRV-01) to bateryjna głowica termostatyczna Wi-Fi od Allterco Robotics. Mocuje się ją bezpośrednio na korpusie zaworu standardowego grzejnika wodnego i zmienia przepływ gorącej wody przez grzejnik, przesuwając trzpień zaworu wewnętrznym silnikiem. TapHome komunikuje się z urządzeniem przez HTTP w sieci lokalnej — bez bramy, bez chmury, bez brokera MQTT.
Ten szablon udostępnia pozycję zaworu jako osobne urządzenie Stan zaworu, dzięki czemu smart rule w TapHome może sterować zaworem bezpośrednio. Własna regulacja temperatury urządzenia jest wyłączona: każda temperatura zadana zapisana z TapHome jest wysyłana razem z target_t_enabled=false, więc firmware nie porusza już zaworem samodzielnie.
Shelly TRV jest produktem wycofanym, zastąpionym przez Shelly BLU TRV działający przez Bluetooth. Istniejące egzemplarze nadal działają, a ten szablon pozostaje w pełni obsługiwany; dla nowych projektów warto rozważyć następcę.
Dla tego samego fizycznego urządzenia dostępne są dwa alternatywne szablony — wybierz jeden w zależności od zamierzonego sposobu sterowania.
| Szablon | Udostępnia | Zastosowanie |
|---|---|---|
| Shelly TRV (główny) | Baterię + termostat w pętli zamkniętej | Sterowanie temperaturą pokoju przez użytkownika końcowego za pomocą temperatury zadanej (5-30 °C). Firmware steruje zaworem wewnętrznie. |
| Shelly TRV (valve) (ten szablon) | Baterię + ściemniacz zaworu + termostat (wariant z temperaturą zadaną) | Smart rules, które wymagają bezpośredniego sterowania zaworem — pozycja zaworu jest udostępniona jako ściemniacz 0-100 %, automatyczna regulacja jest wyłączona. |
Nie importuj obu szablonów dla tego samego fizycznego urządzenia. Oba łączą się z tym samym endpointem i pętle pollingu będą kolidować — zapisy będą sprzeczne, a zachowanie zaworu stanie się nieprzewidywalne.
Instalacja sprzętu
Shelly TRV nie wymaga okablowania — to mechaniczna głowica grzejnikowa z wewnętrzną elektroniką, zasilana wbudowanym akumulatorem (Panasonic NCR18650BD, 3,6 V / 6500 mAh). Mocuje się ją na korpusie zaworu za pomocą metalowej nakrętki zaciskowej. Urządzenie jest przeznaczone wyłącznie do użytku wewnątrz pomieszczeń i musi być chronione przed brudem, wilgocią i bryzgami wody.
Zgodne korpusy zaworów
Jeśli grzejnik ma już głowicę termostatyczną (zwykle pokrętło ze skalą od 1 do 5), korpus zaworu jest najprawdopodobniej zgodny. Grzejniki z małymi zaworami ręcznymi — typowe tam, gdzie zainstalowano osobny termostat pokojowy lub centralny — nie są zgodne.
Natywny gwint: M30 × 1,5. W opakowaniu znajdują się następujące adaptery:
- Danfoss — RA, RAV, RAVL
- Caleffi
- Giacomini
- M28 × 1,5 — Sam, Slovarm, Comap, TA, Herz, MMA, Remagg
- Pont à Mousson
Adaptery firm trzecich (nie wchodzą w skład zestawu) rozszerzają zgodność o Gampper, Ista, Meges, Ondal, Oventrop, Rossweiner, Vaillant i inne.
Procedura montażu
- Upewnij się, że grzejnik jest wyłączony i wystygł.
- Obróć istniejącą głowicę w lewo, aż zawór będzie całkowicie otwarty, a następnie odkręć metalową nakrętkę w lewo i zdejmij ją.
- Jeśli gwint zaworu nie jest natywnym M30 × 1,5, załóż odpowiedni adapter.
- Przymocuj Shelly TRV do korpusu zaworu, obracając metalową nakrętkę w prawo — nie dokręcaj jej jeszcze do końca.
- Obróć wyświetlacz do żądanej orientacji, a następnie całkowicie dokręć metalową nakrętkę.
Nie próbuj obracać urządzenia, gdy metalowa nakrętka jest całkowicie dokręcona — może to je uszkodzić.
Ładowanie
Urządzenie ładuje się przez USB-C ładowarką zgodną ze standardem USB-C o prądzie co najmniej 1 A. Przed pierwszym użyciem naładuj je do pełna przez około 7 godzin. Podczas ładowania linia poziomu baterii na wyświetlaczu miga, a kropka obok dolnej linii sygnalizuje podłączoną ładowarkę. Bateria wystarcza na maksymalnie 2 lata, w zależności od tego, jak często porusza się zawór, oraz od jakości sygnału Wi-Fi.
Podczas ładowania obudowa urządzenia nagrzewa się, a wewnętrzny czujnik temperatury odczytuje niepoprawnie. Gdy ładowarka jest podłączona, spodziewaj się zafałszowanych wartości temperatury pokoju.
Kalibracja
Kalibracja uczy silnik skoku konkretnego korpusu zaworu. Bez niej TapHome nie może odczytywać ani zapisywać pozycji zaworu.
- Krótko naciśnij Reset (tył urządzenia). Wyświetlacz pokaże
CL, a wewnętrzny silnik obraca się w obu kierunkach. - Udana kalibracja kończy się komunikatem
APna wyświetlaczu — urządzenie jest gotowe do połączenia z Wi-Fi. E1oznacza, że kalibracja się nie powiodła: nakrętka nie jest wystarczająco dokręcona albo urządzenie nie jest prawidłowo osadzone. Dokręć nakrętkę lub zamontuj urządzenie ponownie, a następnie przytrzymaj Up lub Down przez 3 sekundy i kilka razy naciśnij Down, aby rozpocząć nową kalibrację.
Gdy urządzenie jest już w TapHome, nowy cykl kalibracji można też uruchomić akcją serwisową Calibrate na module.
Skalibruj urządzenie ponownie po każdym przełożeniu na inny korpus zaworu. Dopóki urządzenie nie zgłosi
calibrated=true, urządzenie Stan zaworu pokazujeDevice is not calibrated, a TapHome odrzuca zarówno zapisy pozycji zaworu, jak i temperatury zadanej.
Konfiguracja sieci
Shelly TRV korzysta z Wi-Fi 2,4 GHz (802.11 b/g/n) o zasięgu do 30 m, zależnie od konstrukcji budynku. Po kalibracji uruchamia się w trybie Access Point (AP na wyświetlaczu).
Jeśli urządzenie nie zostanie dodane do sieci Wi-Fi w ciągu 3 minut, wyłączy się. Krótko naciśnij Reset, aby uruchomić je ponownie.
Łączenie z Wi-Fi
Urządzenie można połączyć przez aplikację mobilną Shelly Cloud albo ręcznie przez jego wbudowany interfejs WWW:
- Połącz telefon lub komputer z siecią Wi-Fi utworzoną przez urządzenie i otwórz
http://192.168.33.1. - Kliknij Internet & Security i wybierz WIFI MODE - CLIENT.
- Zaznacz Connect the Shelly device to an existing WiFi Network, wpisz nazwę sieci i hasło, a następnie naciśnij SAVE.
- Znajdź adres IP urządzenia w sieci lokalnej (lista klientów routera albo narzędzie Shelly device finder dla Windows lub macOS).
Włączenie trybu Client wyłącza tryb Access Point. Aby wrócić do trybu Access Point, przytrzymaj Reset przez 5 sekund.
Rezerwacja DHCP dla urządzenia w routerze utrzymuje stały adres IP używany przez TapHome.
Uwierzytelnianie
Szablon wysyła żądania HTTP bez danych logowania na port 80; HTTPS nie jest obsługiwany w urządzeniach Gen1. Jeśli w interfejsie WWW urządzenia włączono ochronę logowaniem, wyłącz ją — w przeciwnym razie TapHome nie będzie mógł odczytywać danych z urządzenia ani nim sterować.
Konfiguracja
W TapHome zaimportuj szablon i wpisz adres IP urządzenia jako jedyny parametr importu, a następnie utwórz smart rule, która steruje urządzeniem Stan zaworu.
Wyłączenie harmonogramu tygodniowego
Shelly TRV ma wbudowany harmonogram tygodniowy (5 profili, do 20 zmian temperatury na profil). Gdy harmonogram jest aktywny, firmware nadpisuje każdą zapisaną z zewnątrz temperaturę zadaną przy najbliższej zaplanowanej zmianie.
Szablon zgłasza to jako błąd modułu (Schedule is enabled). Zanim oddasz urządzenie pod sterowanie TapHome, wykonaj jedno z poniższych:
- uruchom akcję serwisową Disable schedule na module (wysyła
/settings/thermostats/0?schedule=false), lub - wybierz profil Disable w sekcji Weekly schedule w interfejsie WWW urządzenia albo w aplikacji Shelly Cloud.
Automatyczne sterowanie zaworem
Zarówno urządzenie Stan zaworu, jak i urządzenie Termostat pokazują ostrzeżenie Automatic valve control is on zawsze, gdy urządzenie zgłasza swoją własną regulację temperatury jako aktywną, ponieważ może ona kolidować z działaniem smart rule. Zapis temperatury zadanej z urządzenia Termostat ponownie ją wyłącza (target_t_enabled=false).
Zewnętrzny czujnik pokojowy (zalecane)
Każdy termostat montowany na grzejniku mierzy temperaturę blisko grzejnika, więc wbudowany czujnik odbiega od rzeczywistej temperatury pokoju. Dostępne są dwie ścieżki korekty:
- Czujnik zewnętrzny — Shelly H&T lub kompatybilny czujnik w pomieszczeniu może wysyłać temperaturę otoczenia do TRV. Włącz to w interfejsie WWW urządzenia → Sensor Settings → TEMPERATURE OFFSET → Enable external temperature corrections endpoint.
- Statyczne przesunięcie — użyj akcji serwisowej Set temperature offset na urządzeniu Termostat (zakres ±20 °C), aby skompensować stałą odchyłkę.
Możliwości urządzenia
Szablon udostępnia urządzenie jako wskaźnik baterii, ściemniacz pozycji zaworu i termostat. Diagnostyka i akcje na poziomie modułu są takie same jak w szablonie głównym.
Stan zaworu
Siłownik zaworu jest udostępniony jako ściemniacz (0-100 %). TapHome odczytuje pozycję z thermostats[0].pos i zapisuje ją przez /thermostats/0?pos={0-100}; firmware przesuwa silnik do żądanej pozycji. Ujemna pozycja oznacza, że zawór nie jest skalibrowany, a urządzenie pokazuje Device is not calibrated.
Atrybuty serwisowe raportują Force close, Extra pressure i Automatic calibration correction. Akcje serwisowe przełączają tryb wymuszonego zamknięcia (zawór pozostaje całkowicie zamknięty) oraz tryb dodatkowego nacisku (silniejsze działanie dla sztywnych zaworów), dzięki czemu smart rules mogą obsłużyć scenariusze takie jak awaryjne zamknięcie, wstępne nagrzewanie czy sekwencje boost.
Termostat
Termostat odczytuje zmierzoną temperaturę pokoju (thermostats[0].tmp.value) i zapisaną wartość docelową (thermostats[0].target_t.value). Zapis temperatury zadanej wysyła jednocześnie target_t i target_t_enabled=false do /settings/thermostats/0, aby firmware nie poruszał zaworem samodzielnie — temperatura zadana służy jako wartość odniesienia dla smart rule, która steruje urządzeniem Stan zaworu.
Jedynym atrybutem serwisowym jest Temperature offset [°C] z odpowiadającą mu akcją Set temperature offset. Urządzenie dodaje Temperature sensor error, gdy odczyt czujnika jest nieprawidłowy.
Stan baterii
Bateria jest udostępniona jako przełącznik wielowartościowy wyprowadzony z raportowanego poziomu naładowania i stanu ładowarki. Stan ładowarki ma pierwszeństwo przed poziomem naładowania:
| Stan | Warunek |
|---|---|
| Critical | bat.value 25 % lub mniej |
| Low | bat.value 26-50 % |
| Normal | bat.value 51-75 % |
| Full | bat.value powyżej 75 % |
| Charging | podłączona ładowarka |
Dwa atrybuty serwisowe raportują surowy poziom naładowania (%) i napięcie (V). Moduł zgłasza Low battery poniżej 50 % i Battery charge is criticaly low poniżej 25 %.
Diagnostyka i akcje modułu
Moduł odpytuje /status i /settings co 3 sekundy i udostępnia diagnostykę i akcje całego urządzenia:
- Diagnostyka: SSID Wi-Fi, adres IP, MAC, siła odbieranego sygnału, stan kalibracji, harmonogram wł./wył., jasność wyświetlacza (1-7) i stan obróconego wyświetlacza. Gdy dostępna jest aktualizacja firmware, pojawia się ostrzeżenie.
- Akcje: Disable schedule, Reboot, Calibrate (wyzwala
/calibrate), Update firmware (pobieraSHTRV-01_build.gblz oficjalnego serwera firmware Shelly EU), Set display brightness i Flip display.
Rozwiązywanie problemów
Device is not calibrated
Zapisy pozycji zaworu i temperatury zadanej są odrzucane z komunikatem Device is not calibrated, dopóki TRV nie zakończy udanego cyklu kalibracji.
- Upewnij się, że urządzenie jest mocno osadzone na korpusie zaworu — nakrętka musi być dokręcona na tyle mocno, aby silnik mógł naciskać na trzpień zaworu.
- Uruchom akcję serwisową Calibrate na module albo rozpocznij kalibrację na urządzeniu (przytrzymaj Up lub Down przez 3 sekundy, a następnie kilka razy naciśnij Down). Wyświetlacz pokazuje
CL, gdy silnik porusza się w obu kierunkach. - Po udanej kalibracji atrybut Calibrated zmienia się na
Yes;E1na wyświetlaczu zwykle oznacza nieprawidłowy montaż.
Zawór się porusza, choć żadna smart rule go nie zmieniła
Aktywna jest własna regulacja urządzenia albo harmonogram tygodniowy. Sprawdź ostrzeżenie Automatic valve control is on i atrybut modułu Schedule — zapisz temperaturę zadaną z urządzenia Termostat, aby wyłączyć automatyczne sterowanie, a jeśli harmonogram jest włączony, uruchom Disable schedule.
Temperatura pokojowa jest zbyt wysoka
- Podłączona ładowarka. Odczyty temperatury pokoju są nieważne podczas ładowania. Odłącz USB-C i pozwól urządzeniu wystygnąć.
- Odchylenie wbudowanego czujnika. Czujnik znajduje się blisko grzejnika. Włącz endpoint korekcji temperatury zewnętrznej i sparuj Shelly H&T (lub kompatybilny czujnik) w tym samym pomieszczeniu albo zastosuj statyczne Set temperature offset.
Na wyświetlaczu pojawia się E1 / E2
Aby sprawdzić stan, przytrzymaj jednocześnie Up i Down przez 5 sekund i przewijaj przyciskami Up lub Down.
E1— problem z kalibracją. Zamontuj urządzenie ponownie, ostrożnie dokręć nakrętkę i rozpocznij nowy cykl kalibracji.E2— problem z czujnikiem temperatury. Szablon dodaje na urządzeniu Termostat błądTemperature sensor error. Jeśli problem utrzymuje się po restarcie, skontaktuj się ze wsparciem Shelly.
Urządzenie jest nieosiągalne
- Sprawdź, czy TRV jest połączony z Wi-Fi — przytrzymaj Up i Down przez 5 sekund i przewiń parametry stanu;
COoznacza połączenie z siecią Wi-Fi,APoznacza, że urządzenie jest nadal w trybie Access Point. - Upewnij się, że TapHome Core i TRV znajdują się w tej samej sieci / VLAN.
- Spróbuj nazwy hosta mDNS (
shellytrv-XXXXXX.local) zamiast adresu IP — dzierżawa DHCP mogła się zmienić. - Otwórz
http://{device-ip}/statusw przeglądarce. Jeśli przyjdzie odpowiedź JSON, urządzenie jest osiągalne, a problem leży w konfiguracji TapHome.
Urządzenia Gen1 Shelly akceptują tylko 2 równoczesne połączenia HTTP. Jeśli TapHome i inny system odpytują to samo urządzenie w tym samym czasie, komunikacja staje się zawodna. Pozostaw interwał pollingu na domyślnej wartości szablonu (3 s) i unikaj dodatkowych systemów odpytujących.
Włączenie MQTT na urządzeniach Gen1 Shelly wyłącza połączenie z Shelly Cloud. TapHome używa wyłącznie HTTP — zostaw MQTT wyłączone.