---
title: "Shelly BLU TRV"
description: "Integracja głowicy termostatycznej przez HTTP i Shelly BLU Gateway Gen3 — temperatura zadana i bieżąca, położenie zaworu, bateria, RSSI."
url: "https://taphome.com/pl/compatibility/shelly-blu-trv/"
language: pl
lastmod: 2026-04-15
generator: hugo
ai:
  topics: ["http","thermostat","ble","gateway","battery-powered","heating"]
  questions: ["Jak zintegrować Shelly BLU TRV z TapHome?","W jaki sposób TapHome komunikuje się z Shelly BLU TRV poprzez Gateway Gen3?","Ile urządzeń Shelly BLU TRV można sparować z jednym BLU Gateway Gen3?","Jak znaleźć ID komponentu Shelly BLU TRV na bramie?","Kiedy należy kalibrować Shelly BLU TRV?","Dlaczego Shelly BLU TRV zgłasza w TapHome ostrzeżenie o niskim poziomie baterii?"]
---

# Shelly BLU TRV

Komunikacja: Packet Parser → HTTP

- [Strona produktu Shelly BLU TRV](https://www.shelly.com/products/shelly-blu-trv-single-pack)
- [Strona produktu Shelly BLU Gateway Gen3](https://www.shelly.com/products/shelly-blu-gateway-gen3)

> Adres w sieci
> 
> TapHome łączy się z urządzeniem pod adresem podanym przy imporcie. Nadaj urządzeniu stały adres — rezerwację IP w routerze albo jego nazwę mDNS, jeśli ją obsługuje — inaczej integracja przestanie działać, gdy router zmieni adres.
> 
> [Przygotowanie sieci](https://taphome.com/pl/docs/setup/network-preparation/)

## Poradnik integracji

Shelly BLU TRV (model SBTR-001AEU) to zasilana bateryjnie termostatyczna głowica grzejnikowa z łącznością Bluetooth LE 5 i Zigbee 802.15.4. Nie obsługuje bezpośrednio Wi-Fi ani HTTP — TapHome łączy się z głowicą po HTTP poprzez **Shelly BLU Gateway Gen3**, który pośredniczy w wywołaniach JSON-RPC z namespace `BluTrv` do sparowanej głowicy przez BLE.

Pojedynczy Shelly BLU Gateway Gen3 może obsłużyć **wiele głowic BLU TRV** jako komponenty peryferyjne (Shelly sprzedaje pojedyncze opakowania, dwupaki i trzypaki wraz z bramą). Każda głowica jest identyfikowana przez ID komponentu na bramie (typowo 200, 201, 202). Szablon TapHome importuje się raz dla każdej głowicy z tym samym IP bramy i innym ID komponentu.

## Czego potrzebujesz

- **Shelly BLU TRV** (SBTR-001AEU) — głowica zaworu, zawiera 2× baterie AA 1,5 V oraz adapter montażowy do gwintów M28 × 1,5
- **Shelly BLU Gateway Gen3** (SBGT-3B-001) — brama Wi-Fi zasilana z USB-A, która udostępnia peryferia BLE jako HTTP RPC; sprzedawana także w zestawach startowych z głowicą
- **Zasilanie** — TRV działa na 2× AA 1,5 V (typowa żywotność baterii do 2 lat); brama podłącza się do dowolnego portu USB-A (ładowarka telefonu, router, zasilany hub)
- **Sieć** — łączność LAN/Wi-Fi dla bramy; sama głowica nie dołącza do sieci Wi-Fi
- **Gwint zaworu** — montaż bezpośredni na zaworach M30 × 1,5 lub użycie dołączonego adaptera do Danfoss RA/RAV/RAVL, Caleffi, Giacomini i gwintów M28 × 1,5

## Parowanie TRV z bramą

Każdą głowicę TRV sparuj z bramą **przed** importem szablonu w TapHome — ID komponentu jest przydzielane dopiero po udanym sparowaniu.

1. Podłącz Shelly BLU Gateway Gen3 do portu USB-A i poczekaj, aż połączy się z siecią lokalną
2. Naciśnij **przycisk parowania** na bramie — LED sygnalizuje aktywny tryb parowania przez 30 sekund
3. W ciągu 30 sekund albo wyciągnij pasek izolujący baterie z fabrycznie nowej głowicy, albo krótko naciśnij przycisk **Reset** na działającej głowicy
4. Wyświetlacz głowicy miga i po udanym parowaniu pokazuje animację potwierdzającą
5. Dodaj bramę w aplikacji Shelly Smart Control — nowo sparowana głowica pojawia się jako komponent podrzędny bramy z przydzielonym ID komponentu

Kroki 2–4 powtórz dla każdej kolejnej głowicy. Każde parowanie tworzy nowe ID komponentu (200, 201, 202…).

## Konfiguracja

Szablon TapHome łączy się z **IP bramy** (nie z samą głowicą) i kieruje do konkretnej głowicy przez jej ID komponentu na bramie.

### Parametry importu

| Parametr | Opis | Jak uzyskać | Przykład |
|----------|------|-------------|----------|
| `IpAddress` | Adres IP bramy w sieci lokalnej | Aplikacja Shelly Smart Control → Gateway → Settings → Network lub tabela dzierżaw DHCP w routerze | `192.168.0.42` |
| `ID` | ID komponentu BluTrv danej głowicy na bramie | Interfejs webowy bramy (`http://<gateway-ip>`) → lista komponentów → skopiuj numeryczny ID przypisany tej głowicy | `200` |

Każda głowica wymaga własnego importu szablonu. Dla trzech głowic sparowanych z tą samą bramą importuj szablon trzy razy z tą samą wartością `IpAddress` i z wartościami `ID` 200, 201 i 202 (ID są widoczne w interfejsie webowym bramy).

> [!WARNING]
> HTTP Digest Authentication na bramie musi być **wyłączone**, aby TapHome mógł komunikować się z endpointami `/rpc/*` — ten sam warunek, co w innych urządzeniach Shelly Gen2+/Gen3.

## Możliwości urządzenia

### Termostat

Szablon udostępnia głowicę jako urządzenie termostatowe. Temperatura bieżąca jest odczytywana z `$.status.trv:0.current_C`, a wartość zadana z `$.status.trv:0.target_C` (obie pobierane przez `BluTrv.GetRemoteStatus`). Zapis nowej wartości zadanej wysyła `TRV.SetTarget` przez `BluTrv.Call` w zakresie 4–31 °C obsługiwanym przez urządzenie.

Service attribute **stan zaworu** pokazuje bieżące otwarcie zaworu w procentach (`$.status.trv:0.pos`), gdzie 0 % oznacza całkowicie zamknięty, a 100 % całkowicie otwarty. Położenie zaworu sterowane jest przez wewnętrzną pętlę regulacyjną TRV — szablon tylko je odczytuje.

### Bateria

Poziom naładowania baterii jest udostępniany jako 5-stanowy wskaźnik zmapowany z surowej wartości procentowej (`$.battery`):

| Stan | Poziom baterii | Ikona |
|------|----------------|-------|
| **Krytyczny** | &lt; 25 % | Bateria prawie wyczerpana |
| **Niski** | 25–50 % | Niski poziom baterii |
| **Normalny** | 50–75 % | Średni poziom baterii |
| **Pełny** | &gt; 75 % | Bateria pełna |
| **Ładowanie** | Ładowanie (nietypowe dla ogniw AA) | Ikona ładowania |

Service attribute **Wartość [%]** udostępnia surowy odczyt baterii 0–100 %. Na poziomie modułu automatycznie generowane są ostrzeżenia, gdy poziom baterii spadnie poniżej 50 % (Niski poziom baterii) oraz poniżej 25 % (Krytycznie niski poziom baterii).

### Diagnostyka i akcje

Sygnały na poziomie modułu:

- **Siła odbieranego sygnału** — RSSI (dBm) łącza BLE pomiędzy bramą a TRV (`$.rssi`)
- Automatyczne ostrzeżenie, gdy `$.update.has_update` ma wartość `true` (dostępna aktualizacja firmware poprzez Shelly Smart Control)
- Automatyczny błąd z treścią `$.trv[0].errors`, gdy TRV zgłasza problem

Dostępne są dwie akcje serwisowe na poziomie modułu:

- **Restart** — restartuje sparowaną głowicę poprzez `Shelly.Reboot` przekazywaną przez `BluTrv.Call`
- **Kalibracja** — uruchamia kalibrację silnika krokowego (`TRV.Calibrate`) poprzez bramę. Kalibracja trwa do 10 sekund, w czasie których TRV nie odpowiada. Wymagana po pierwszym montażu lub zmianie adaptera.

## Rozwiązywanie problemów

### Brama jest niedostępna

1. Sprawdź, czy brama jest zasilana (świeci dioda LED USB-A) i czy dołączyła do sieci Wi-Fi/LAN (widoczna w aplikacji Shelly Smart Control)
2. Otwórz w przeglądarce `http://<gateway-ip>/rpc/Shelly.GetDeviceInfo` — odpowiedź JSON potwierdza dostępność bramy
3. Jeśli IP uległo zmianie po odnowieniu dzierżawy DHCP, spróbuj hostnamu mDNS `shellyblugwg3-<MAC>.local` (brama ogłasza `_http._tcp.local.`)
4. Upewnij się, że HTTP Digest Auth jest wyłączone na bramie (`Settings → Authentication`)

### Błędy TRV zgłaszane w TapHome

Szablon przekazuje `$.trv[0].errors` jako ogólny ciąg błędu. Typowe flagi i rozwiązania:

- `not_calibrated` — uruchom akcję **Kalibracja**; kalibracja musi zakończyć się w ciągu 10 sekund bez ręcznej ingerencji w zawór
- `not_mounted` — tylna pokrywa TRV jest otwarta lub korpus zaworu nie jest prawidłowo osadzony; ponownie zamontuj TRV na zaworze i zamknij komorę baterii
- `battery_low` — wymień 2× ogniwa AA; ostrzeżenia o baterii są również generowane automatycznie po spadku poniżej 50 % / 25 %
- `ext_temp_missing` — zewnętrzny czujnik został skonfigurowany na TRV, ale przestał przesyłać odczyty; albo ponownie sparuj czujnik, albo wyczyść zewnętrzny odczyt

### Zmiana temperatury zadanej nie jest stosowana

1. Sprawdź service attribute stanu zaworu — jeśli wynosi 0 %, a temperatura zadana jest wyższa niż bieżąca, zawór prawdopodobnie wymaga ponownej kalibracji
2. Upewnij się, że nie jest aktywne ręczne nadpisanie (pierścień obrotowy, aplikacja Shelly lub `TRV.SetPosition` z innego klienta) — zapis wartości zadanej z termostatu TapHome przywraca regulację automatyczną, ale każde lokalne obrócenie pierścienia na TRV ma natychmiastowe pierwszeństwo
3. Potwierdź jakość łącza BLE — RSSI poniżej −85 dBm często powoduje 1–3 s dodatkowego opóźnienia i okazjonalnie zgubione polecenia; rozważ zbliżenie bramy do TRV (zasięg wewnątrz pomieszczenia ≤ 10 m)

### Ostrzeżenie o aktualizacji firmware

Szablon generuje ostrzeżenie o aktualizacji firmware, gdy `$.update.has_update` ma wartość `true`. Aktualizacje firmware dla BLU TRV muszą być wykonywane przez aplikację **Shelly Smart Control** — nie są udostępnione przez lokalne RPC.

> [!TIP]
> Opóźnienie round-trip BLE między bramą a TRV wynosi typowo 1–3 sekundy. Szablon odpytuje co 3000 ms, co jest już blisko praktycznego minimum — dalsze obniżanie tej wartości zwiększa kolizje BLE bez poprawy reakcji.

## Jak zainstalować w TapHome

### Wymagania wstępne

- Urządzenie Shelly zainstalowane i włączone
- Lokalna sieć Wi-Fi (2,4 GHz)
- TapHome CCU w tej samej sieci

### Krok 1 — Podłącz Shelly do Wi-Fi

**Opcja A — Aplikacja Shelly (zalecana):**

1. Pobierz [aplikację Shelly](https://www.shelly.com/en/support/shelly-app) (iOS / Android)
2. Dotknij **+** → **Add Device** i postępuj zgodnie z kreatorem parowania Bluetooth
3. Wprowadź dane logowania Wi-Fi, gdy zostaniesz o to poproszony

**Opcja B — Tryb AP (bez aplikacji):**

1. Przy pierwszym uruchomieniu urządzenie tworzy hotspot: `ShellyXXX-AABBCCDDEE`
2. Połącz telefon/PC z tym hotspotem
3. Otwórz `http://192.168.33.1` → **Internet & Security** → **Wi-Fi Mode - Client**
4. Wprowadź SSID i hasło → **Save**

> [!NOTE]
> Shelly obsługuje tylko sieci **2,4 GHz**. Sieci 5 GHz nie pojawią się podczas skanowania.

### Krok 2 — Znajdź adres IP

Po połączeniu z Wi-Fi znajdź przypisany adres IP za pomocą jednej z poniższych metod:

- **Aplikacja Shelly:** Szczegóły urządzenia → **Device info** → Adres IP
- **Interfejs webowy Shelly:** Połącz się z AP urządzenia przed konfiguracją Wi-Fi — IP zostanie wyświetlone po zapisaniu
- **Tabela DHCP routera:** Szukaj nazwy hosta takiej jak `shelly1pm-AABBCCDDEE`
- **mDNS:** Pinguj `shelly<model>-<mac>.local` (np. `shelly1pm-AABBCCDDEE.local`) z tej samej sieci

> [!TIP]
> Przypisz urządzeniu Shelly **statyczny IP** (rezerwację DHCP) w routerze, aby adres nie zmieniał się po ponownym uruchomieniu routera.

### Krok 3 — Konfiguracja w TapHome

1. W TapHome dodaj nowy moduł **Packet Parser (HTTP)**
2. **IP Address:** wprowadź IP z kroku 2 (np. `192.168.1.50`)
3. **Port:** `80` (domyślny, nie wymaga zmiany)
4. Zaimportuj szablon — TapHome będzie okresowo odpytywać `/status` w celu odczytu stanu urządzenia

> [!NOTE]
> Uwierzytelnianie HTTP jest domyślnie wyłączone na urządzeniach Shelly. Jeśli włączyłeś ochronę logowaniem, TapHome obecnie nie obsługuje HTTP Basic Auth — pozostaw uwierzytelnianie wyłączone dla integracji z TapHome.

## Dostępne urządzenia 2

Te urządzenia pojawią się w TapHome po imporcie.

Shelly BLU TRV Moduł

Atrybuty serwisowe

|                          |                                                    |
|--------------------------|----------------------------------------------------|
| Siła odbieranego sygnału | Siła sygnału Bluetooth LE między bramą a TRV (dBm) |

Akcje serwisowe

|            |                                                                                                           |
|------------|-----------------------------------------------------------------------------------------------------------|
| Restart    |                                                                                                           |
| Kalibracja | Uruchamia kalibrację silnika krokowego (do 10 sekund); wymagana po pierwszym montażu lub zmianie adaptera |

Zmienne niestandardowe

`ID` (numeric) = ID ID komponentu BLU TRV na bramie (przypisywane podczas parowania, zwykle 200+)

Open the Shelly BLU Gateway Gen3 web UI → paired devices → copy the component ID assigned to this TRV

Odczyt (moduł)

```taphome
VAR response := SENDHTTPREQUEST("/rpc/BluTrv.GetStatus?id=" + ID);
IF response.IsSuccess
    Status := response.Content;
END

response := SENDHTTPREQUEST("/rpc/BluTrv.GetConfig?id=" + ID);
IF response.IsSuccess
    Config := response.Content;
END

response := SENDHTTPREQUEST("/rpc/BluTrv.GetRemoteStatus?id=" + ID);
IF response.IsSuccess
    RemoteStatus := response.Content;
END

response := SENDHTTPREQUEST("/rpc/BluTrv.GetRemoteConfig?id=" + ID);
IF response.IsSuccess
    RemoteConfig := response.Content;
END

if(PARSEJSON(RemoteStatus, "$.trv[0].errors", true), adderror("Error: " + PARSEJSON(RemoteStatus, "$.trv[0].errors")));
if(PARSEJSON(Status, "$.update.has_update", true), addwarning("Firmware update is available"));

var battery := PARSEJSON(Status, "$.battery");
if battery < 25
    addwarning("Battery charge is criticaly low");
elseif battery < 50
    addwarning("Low battery");
end
```

Atrybuty serwisowe

Received signal strength

```taphome
PARSEJSON(Status, "$.rssi")
```

Akcje serwisowe

Reboot

```taphome
VAR response := SENDHTTPREQUEST("rpc/BluTrv.Call?id=" + ID + "&method=\"Shelly.Reboot\"&params={\"id\":0}");
if(response.IsSuccess, return("OK"), return(response.Content));
```

Calibrate

```taphome
VAR response := SENDHTTPREQUEST("rpc/BluTrv.Call?id=" + ID + "&method=\"TRV.Calibrate\"&params={\"id\":0}");
if(response.IsSuccess, return("OK"), return(response.Content));
```

Bateria Przełącznik wielowartościowy Tylko do odczytu

Wskaźnik stanu baterii — Krytyczny (&lt;25 %), Niski (25–50 %), Normalny (50–75 %), Pełny (&gt;75 %), Ładowanie

numeric Jednostka: % numeric

Wartości / Stany: Critical · Low · Normal · Full · Charging

Odczyt stanu przełącznika

```taphome
var battery := PARSEJSON(Status, "$.battery");
if battery > 75
    return(3);
elseif battery > 50
    return(2);
elseif battery > 25
    return(1);
else
    return(0);
end
```

Atrybuty serwisowe

Value \[%]

```taphome
PARSEJSON(Status, "$.battery");
```

Termostat Termostat Odczyt i zapis

Termostat zaworu grzejnikowego — odczytuje bieżącą temperaturę i zapisuje wartość zadaną (4–31 °C) poprzez BLU Gateway Gen3

numeric Jednostka: °C

Atrybuty serwisowe

|                  |                                                                                  |
|------------------|----------------------------------------------------------------------------------|
| Stan zaworu \[%] | Aktualne położenie otwarcia zaworu (0 % = zamknięty, 100 % = całkowicie otwarty) |

Odczyt temperatury

```taphome
PARSEJSON(RemoteStatus, "$.status.trv:0.current_C")
```

Odczyt temperatury zadanej

```taphome
PARSEJSON(RemoteStatus, "$.status.trv:0.target_C")
```

Zapis temperatury zadanej

```taphome
VAR response := SENDHTTPREQUEST("rpc/BluTrv.Call?id=" + ID + "&method=\"TRV.SetTarget\"&params={\"id\":0,\"target_C\":" + Se + "}");
IF response.IsSuccess = false
  ADDERROR(response.StatusCode);
END
```

Atrybuty serwisowe

${device\_variable\_valvestate} \[%]

```taphome
PARSEJSON(RemoteStatus, "$.status.trv:0.pos")
```

**Połączenie:** Packet Parser → HTTP • Hostname: `shellyblugwg3-{MAC}.local`

Możliwe ulepszenia (14)

- Manual valve position — Sets the valve to a fixed opening percentage (0-100%); disables automatic regulation until TRV.SetTarget is written again. Could be added as a service action.
- Boost mode — Temporarily opens the valve fully for rapid room warm-up; accepts an optional duration (seconds). Could be exposed as a service action.
- Clear boost — Terminates an active boost and restores the normal target temperature.
- Temporary override — Temporarily overrides the target for a given duration (seconds); auto-expires back to the scheduled target.
- Clear override — Terminates an active override and restores the regular target.
- External temperature input — Supplies a temperature reading from an external sensor (e.g. room sensor) to the TRV regulation loop.
- TRV flags (floor\_heating, accel, auto\_calibrate, anticlog, silent\_mode, power\_save) — Toggle operating flags that affect regulation behaviour (e.g. floor-heating mode keeps valve from fully closing).
- Boost / override state — Object with started\_at and duration when boost or override is active; currently not surfaced as a service attribute.
- Error / state flags (not\_calibrated, not\_mounted, battery\_low, ext\_temp\_missing) — Template only forwards $.trv\[0].errors as a generic error string; individual flags are not exposed as discrete sensors.
- Local schedule rules (up to 10) — Shelly Cron-formatted daily/weekly rules stored on the TRV. TapHome normally drives scheduling externally via smart rules, so this is not exposed.
- Display message — Shows up to 10 characters of scrolling text on the TRV 7-segment display.
- Factory reset — Resets configuration to defaults; pairing information is preserved.
- System diagnostics — Uptime, RAM and clock information from the paired TRV system status; not surfaced in the template.
- Humidity sensor — BLU TRV can ingest humidity from paired BLU H&T peripherals; the template contains an empty ReadHumidityScriptPacketParser so this capability is not implemented.

## Parametry importu

Te wartości podajesz podczas importu pliku XML.

| Pytanie w aplikacji | Domyślnie     |
|---------------------|---------------|
| Adres IP            | `192.168.0.1` |
| Id                  | `200`         |

## Źródła

- Shelly Gen2+/Gen3 RPC API Reference
  
  [shelly-api-docs.shelly.cloud](https://shelly-api-docs.shelly.cloud/gen2/) 2026-04-15
- Shelly Gen2+ System (Sys) Component API
  
  [shelly-api-docs.shelly.cloud](https://shelly-api-docs.shelly.cloud/gen2/ComponentsAndServices/Sys/) 2026-04-15
- Shelly Gen2+ WiFi Component API
  
  [shelly-api-docs.shelly.cloud](https://shelly-api-docs.shelly.cloud/gen2/ComponentsAndServices/WiFi/) 2026-04-15
- Shelly BLU TRV RPC API (BluTrv / TRV.* methods)
  
  [shelly-api-docs.shelly.cloud](https://shelly-api-docs.shelly.cloud/docs-ble/Devices/BLU_ZB/trv/) 2026-04-15
- Shelly BLU TRV Product Page
  
  [www.shelly.com](https://www.shelly.com/products/shelly-blu-trv-single-pack) 2026-04-15
- Shelly BLU Gateway Gen3 API Reference
  
  [shelly-api-docs.shelly.cloud](https://shelly-api-docs.shelly.cloud/gen2/Devices/Gen3/ShellyBluGwG3/) 2026-04-15
- How to pair BLU TRV with BLU Gateway Gen3
  
  [kb.shelly.cloud](https://kb.shelly.cloud/knowledge-base/how-to-pair-blu-trv-with-blu-gateway-gen3) 2026-04-15
- Home Assistant Shelly Integration (BLU TRV support)
  
  [www.home-assistant.io](https://www.home-assistant.io/integrations/shelly/) 2026-04-15

## Powiązana dokumentacja

- [Integracja Packet Parser](https://taphome.com/pl/compatibility/packet-parser-guide/)
- [Packet Parser (HTTP, TCP, UDP, FTP, MQTT)](https://taphome.com/pl/docs/integration/packet-parser/)
- [Funkcje Packet parser](https://taphome.com/pl/docs/script/packet-parser/)
- [Funkcje parsowania](https://taphome.com/pl/docs/script/parsing-functions/)