TapHome
Komunita Beta HVAC integrace

LinkedGo ST802-B Fan Coil Thermostat (Powered by Shelly)

LinkedGo ST802-B je nástěnný Wi-Fi termostat pro fan coil jednotky a podlahové topení, Powered by Shelly. TapHome přes jeho lokální HTTP API čte teplotu a vlhkost v místnosti a nastavuje požadovanou teplotu, rychlost ventilátoru, pracovní režim, zapnutí a vypnutí, protimrazovou ochranu a požadovanou vlhkost. Komunitní šablona, beta.

LinkedGoPacket Parser → HTTP6 zařízeníRevize 1.0 Poslední aktualizace: 10. listopadu 2026

Přidal Libor Kratochvíl

LinkedGo ST802-B Fan Coil Thermostat (Powered by Shelly)

Import do aplikace TapHomeHardware › Packet Parser › Přidat ze šablony

Stáhnout šablonu
Na této stránce

Adresa v síti

TapHome komunikuje se zařízením na adrese zadané při importu. Dejte zařízení stálou adresu — rezervaci IP v routeru, nebo jeho mDNS jméno, pokud ho podporuje —, jinak integrace přestane fungovat, když router adresu změní.

Příprava sítě

Návod na integraci

LinkedGo ST802-B je nástěnný termostat do instalační krabice pro fan coil jednotky a podlahové topení, „Powered by Shelly“. Sám spíná tři rychlosti ventilátoru fan coilu, ventil fan coilu a ventil podlahového topení a má vestavěné čidlo teploty a vlhkosti v místnosti. TapHome s ním komunikuje přes lokální Shelly RPC API (HTTP na portu 80, Wi-Fi) — připojení ke cloudu není potřeba.

Šablona čte teplotu a vlhkost v místnosti a nastavuje požadovanou teplotu, rychlost ventilátoru, pracovní režim, zapnutí a vypnutí, protimrazovou ochranu a požadovanou vlhkost. Jde o komunitní šablonu, jejímž autorem je Libor Kratochvíl.

Připojení hardwaru

Termostat se montuje do 60mm instalační krabice ve zdi, pouze v interiéru (IP20). Napájí se ze sítě 230 V AC; znalostní báze Shelly uvádí vstupní rozsah 90–240 V AC, 50/60 Hz. Maximální zatížení je 1 A induktivní nebo 2 A odporové. Instalace a každá změna zapojení patří kvalifikovanému elektrikáři, se svorkami odpojenými od sítě.

Svorky

SvorkaFunkce
N, Lnapájení, nulový a fázový vodič
H, M, Lovysoká, střední a nízká rychlost ventilátoru — výstup 230 V, každý 1 A
NO, NCventil fan coilu — relé se spínacím a rozpínacím kontaktem, 230 V
FLventil podlahového topení — výstup 230 V
C1, C2bezpotenciálový kontakt (digitální výstup) pro zapnutí a vypnutí tepelného čerpadla nebo plynového kotle
0-10V, GNDanalogový výstup pro rychlost DC motoru ventilátoru a společná svorka
A1/B1, A2/B2RS485 — tato šablona ho nepoužívá
Rozložení svorek ST802-B: síťové svorky N, L, H, M, Lo, NO, NC, FL s připojením ventilátoru a ventilů, plus nízkonapěťové svorky A1/B1, A2/B2, C1/C2, GND, 0-10V.

Zapojení podle funkce termostatu (parametr H02)

Zapojení ventilátoru a ventilů závisí na typu systému, který se na termostatu nastavuje instalačním parametrem H02. Technický návod LinkedGo uvádí jedno schéma pro každou hodnotu H02:

H02SystémNabízené režimy
02trubkový AC fan coil — ventilátor na H/M/Lo, ventil fan coilu na NO/NCchlazení, topení, odvlhčování, větrání
1DC fan coil — rychlost ventilátoru z výstupu 0-10V, ventil fan coilu na NO/NCchlazení, topení, odvlhčování, větrání
2pouze podlahové topení — ventil podlahového topení na FLpodlahové topení
3chlazení AC fan coilem + podlahové topeníchlazení fan coilem, podlahové topení
4chlazení a topení AC fan coilem + podlahové topeníchlazení, topení, podlahové topení, odvlhčování, větrání
6chlazení DC fan coilem + podlahové topeníchlazení fan coilem, podlahové topení, odvlhčování, větrání
7chlazení a topení DC fan coilem + podlahové topeníchlazení, topení, podlahové topení, odvlhčování, větrání
174trubkový AC fan coil — ventil chlazení na NO/NC, ventil topení na FLchlazení, topení, odvlhčování, větrání
Elektrická schémata LinkedGo ST802 pro nastavení H02 0, 1, 2, 3/4, 6/7 a 17 (zapojení ventilu fan coilu a ventilu podlahového topení) a síť RS485, s tabulkou funkcí H02.

Konfigurace

Připojení termostatu k Wi-Fi

Termostat se přidává do sítě v bezplatné aplikaci Shelly Smart Control (App Store, Google Play nebo AppGallery; je potřeba bezplatný účet Shelly). Použijte Wi-Fi síť 2,4 GHz a před začátkem zapněte v telefonu Bluetooth.

  1. Otevřete aplikaci Shelly Smart Control a klepněte na + v pravém dolním rohu.
  2. Zvolte Add via Bluetooth a klepněte na Next; zobrazí se seznam podporovaných zařízení.
  3. Zvolte termostat a klepněte na Next.
  4. Zadejte název a heslo Wi-Fi sítě a klepněte na Add device. Přidávání může trvat několik minut; na konci se zobrazí zpráva o úspěchu.
  5. Pojmenujte zařízení, přiřaďte mu obrázek, vyberte místnost a klepněte na Save.

Pokud aplikace termostat nenajde, podržte na termostatu tlačítko ON/OFF 10 sekund a vyhledávání spusťte znovu. Po připojení termostatu se na jeho displeji zobrazí ikona signálu Wi-Fi.

Pevná IP adresa

TapHome se k termostatu připojuje přes jeho IP adresu. Přidělte mu pevnou adresu — nejjednodušeji rezervací DHCP pro MAC adresu termostatu v routeru —, aby se adresa po restartu routeru nebo termostatu nezměnila. Tuto adresu budete potřebovat při importu šablony.

Vypnutá ochrana heslem

Ochranu termostatu heslem nechte v aplikaci Shelly vypnutou. TapHome nepodporuje HTTP Digest autentizaci zařízení Shelly Gen2+; s nastaveným heslem termostat odpovídá HTTP 401 a každé zařízení v TapHome zobrazí chybu “Thermostat asks for a password (HTTP 401)”.

Pro ověření otevřete v prohlížeči ve stejné síti http://<thermostat IP>/rpc/Shelly.GetDeviceInfo. Pokud vrátí JSON bez výzvy k přihlášení, TapHome dokáže termostat číst.

Jednotka teploty v °C

Jednotku teploty na termostatu nechte nastavenou na stupně Celsia. TapHome čte všechny teploty v °C; když je termostat nastavený na stupně Fahrenheita, modul zobrazí varování “Thermostat uses degrees Fahrenheit”. Aktuální nastavení je vidět na http://<thermostat IP>/rpc/Service.GetConfig?id=0 ("temp_unit": "C").

Instalační parametry na termostatu

Instalační parametry nastavte na tlačítkách termostatu ještě před připojením k TapHome, protože určují, které režimy a požadované hodnoty termostat přijme:

  • H02 — typ systému a pracovní režimy, které termostat nabízí (tabulka výše).
  • H05 — 0 topení i chlazení, 1 pouze chlazení, 2 pouze topení.
  • H23 / H24 — minimální a maximální požadovaná teplota (výchozí 5 °C a 35 °C).
  • A05 / A06 — zapnutí a vypnutí protimrazové ochrany a její teplota v místnosti (0–21 °C, výchozí 5 °C).

Do instalačních parametrů se dostanete podržením tlačítka Mode na 5 sekund; displej zobrazí skupiny parametrů (H, P, F …). Skupinu a parametr vyberte tlačítky nahoru a dolů, změňte hodnotu a uložte ji. Úplný seznam parametrů je v technickém návodu LinkedGo.

Přidání termostatu v TapHome

V TapHome přidejte modul z této šablony pod rozhraní Packet Parser a zadejte IP adresu termostatu.

Možnosti zařízení

ZařízeníCo dělá
Thermostatteplota v místnosti, požadovaná teplota (5–35 °C, krok 0,5 °C) a vlhkost v místnosti
Fan speedAuto, Low, Medium, High (automatická, nízká, střední, vysoká rychlost)
Working modeCool, Heat, Dry, Ventilation, Floor heating (chlazení, topení, odvlhčování, větrání, podlahové topení)
Thermostat on/offzapíná nebo vypíná regulační funkci termostatu
Anti-freezeprotimrazová ochrana zapnutá nebo vypnutá
Target humiditypožadovaná vlhkost pro režim Dry (40–75 %)

Které pracovní režimy termostat přijme, závisí na H02. Zařízení nastavené pro 2trubkový AC fan coil (H02 = 0) nabízí Cool, Dry, Heat a Ventilation. Pokud zvolíte režim, který termostat nenabízí (například Floor heating bez ventilu podlahového topení), termostat ho odmítne a TapHome zobrazí režim, který zůstává aktivní. Režim, který šablona nezná, se na zařízení Working mode zobrazí jako chyba.

Informace o modulu a servisní akce

Modul zobrazuje Wi-Fi síť, IP adresu, sílu signálu, MAC adresu, stav služby, režim termostatu (cool, heat nebo auto), jednotku teploty a kalibrační posuny teploty a vlhkosti. Varuje, když je k dispozici aktualizace firmwaru, když je potřeba restart, když termostat hlásí servisní chybu a když je nastavený na stupně Fahrenheita. Servisní akce: aktualizace firmwaru a restart.

Který reléový výstup je právě sepnutý (rychlost ventilátoru, ventil fan coilu, ventil podlahového topení), Shelly API neposkytuje, proto ho TapHome nedokáže zobrazit.

Dobré vědět

  • Po restartu TapHome Core každé zařízení načte svou hodnotu z termostatu, takže změna provedená na tlačítkách termostatu během vypnutého Core se zachová a nikdy se nepřepíše.
  • Hodnotu mimo rozsah termostatu (například požadovanou vlhkost 80 % nebo požadovanou teplotu mimo H23–H24) termostat odmítne; TapHome pak zobrazí hodnotu, která zůstává nastavená.
  • Hodnoty se čtou každých 5–15 sekund; změna na tlačítkách termostatu se v TapHome projeví během této doby.

Řešení problémů

Všechna zařízení zobrazují “HTTP 401”

Na termostatu je zapnutá ochrana heslem. Vypněte ji v aplikaci Shelly a pak v prohlížeči zkontrolujte http://<thermostat IP>/rpc/Shelly.GetDeviceInfo — musí odpovědět bez výzvy k přihlášení.

Zařízení zobrazují “Thermostat answered HTTP …” nebo žádné hodnoty

  1. Zkontrolujte, zda termostat zobrazuje ikonu Wi-Fi a zda se jeho IP adresa nezměnila (pevná adresa nebo rezervace DHCP).
  2. Otevřete http://<thermostat IP>/rpc/Shelly.GetDeviceInfo ze zařízení ve stejné síti jako TapHome Core — pokud vrátí JSON, termostat je dostupný.
  3. Ujistěte se, že TapHome Core a termostat jsou ve stejné síti, nebo že je mezi nimi povolené směrování.

Teploty vypadají špatně

  • Zkontrolujte jednotku teploty — modul varuje, když je termostat nastavený na stupně Fahrenheita.
  • Zkontrolujte kalibrační posuny teploty a vlhkosti zobrazené na modulu.

Pracovní režim nebo rychlost ventilátoru zobrazuje chybu

Termostat nahlásil hodnotu, kterou šablona nezná. Shelly API uvádí rychlosti ventilátoru auto, low, medium a high; technický návod LinkedGo uvádí pro DC fan coil pět rychlostí. Zkontrolujte nastavení H02 a hodnotu na displeji termostatu.

Displej zobrazuje E03

E03 je alarmový kód LinkedGo pro poruchu čidla v místnosti. Chyby, které termostat hlásí přes Shelly API, se na modulu zobrazí jako varování “Thermostat reports: …”.

Dostupná zařízení 6

Tato zařízení se po importu zobrazí v TapHome.

LinkedGo ST802-B Modul
Servisní atributy
Wi-Fi
${ipAddress}
${xml_signal_strength} [dB]
MAC
Service state
Thermostat mode
Temperature unit
Temperature offset
Humidity offset [%]
Servisní akce
${xml_update_fw}
Reboot
Vlastní proměnné
SysStatus (string)
WiFiStatus (string)
ServiceConfig (string)
ServiceStatus (string)

LinkedGo ST802-B

Čtení (modul)
VAR r := SENDHTTPREQUEST("/rpc/Sys.GetStatus");
IF r.IsSuccess
    SysStatus := r.Content;
ELSE
    IF r.StatusCode = 401
        ADDERROR(401, "Thermostat asks for a password (HTTP 401). Turn off password protection in the Shelly app, TapHome does not support HTTP Digest.");
    ELSE
        ADDERROR(1, "Thermostat answered HTTP " + TOSTRING(r.StatusCode));
    END
    RETURN(0);
END
r := SENDHTTPREQUEST("/rpc/WiFi.GetStatus");
IF r.IsSuccess
    WiFiStatus := r.Content;
END
r := SENDHTTPREQUEST("/rpc/Service.GetConfig?id=0");
IF r.IsSuccess
    ServiceConfig := r.Content;
END
r := SENDHTTPREQUEST("/rpc/Service.GetStatus?id=0");
IF r.IsSuccess
    ServiceStatus := r.Content;
END
IF PARSEJSON(ServiceConfig, "$.temp_unit", true) = "F"
    ADDWARNING(4, "Thermostat uses degrees Fahrenheit. Set the temperature unit to Celsius in the Shelly app, TapHome reads the values as degrees Celsius.");
END
VAR errors := PARSEJSON(ServiceStatus, "$.errors", true);
IF ! ISNULL(errors)
    ADDWARNING(5, "Thermostat reports: " + TOSTRING(errors));
END
IF ! ISNULL(PARSEJSON(SysStatus, "available_updates.stable", true))
    ADDWARNING(2, "New firmware update is available");
END
IF PARSEJSON(SysStatus, "restart_required", true)
    ADDWARNING(3, "Restart required");
END
Servisní atributy
Wi-Fi
PARSEJSON(WiFiStatus, "ssid", true)
${ipAddress}
PARSEJSON(WiFiStatus, "sta_ip", true)
${xml_signal_strength} [dB]
PARSEJSON(WiFiStatus, "rssi", true)
MAC
PARSEJSON(SysStatus, "mac", true)
Service state
PARSEJSON(ServiceStatus, "state", true)
Thermostat mode
PARSEJSON(ServiceConfig, "thermostat_mode", true)
Temperature unit
PARSEJSON(ServiceConfig, "temp_unit", true)
Temperature offset
PARSEJSON(ServiceConfig, "temp_offset", true)
Humidity offset [%]
PARSEJSON(ServiceConfig, "humidity_offset", true)
Servisní akce
${xml_update_fw}
VAR r := SENDHTTPREQUEST("/rpc/Shelly.Update?stage=\"stable\"");
IF r.IsSuccess
    RETURN("OK");
ELSE
    RETURN("Error " + TOSTRING(r.StatusCode));
END
Reboot
VAR r := SENDHTTPREQUEST("/rpc/Shelly.Reboot");
IF r.IsSuccess
    RETURN("OK");
ELSE
    RETURN("Error " + TOSTRING(r.StatusCode));
END
Thermostat Termostat

Thermostat

Čtení teploty
VAR r := SENDHTTPREQUEST("/rpc/Number.GetStatus?owner=\"service:0\"&role=\"current_temperature\"");
IF r.IsSuccess
    RETURN(PARSEJSON(r.Content, "$.value"));
END
IF r.StatusCode = 401
    ADDERROR(401, "Thermostat asks for a password (HTTP 401). Turn off password protection in the Shelly app, TapHome does not support HTTP Digest.");
ELSE
    ADDERROR(1, "Thermostat answered HTTP " + TOSTRING(r.StatusCode));
END
RETURN(NaN);
Čtení vlhkosti
VAR r := SENDHTTPREQUEST("/rpc/Number.GetStatus?owner=\"service:0\"&role=\"current_humidity\"");
IF r.IsSuccess
    RETURN(PARSEJSON(r.Content, "$.value"));
END
IF r.StatusCode = 401
    ADDERROR(401, "Thermostat asks for a password (HTTP 401). Turn off password protection in the Shelly app, TapHome does not support HTTP Digest.");
ELSE
    ADDERROR(1, "Thermostat answered HTTP " + TOSTRING(r.StatusCode));
END
RETURN(NaN);
Čtení požadované teploty
VAR r := SENDHTTPREQUEST("/rpc/Number.GetStatus?owner=\"service:0\"&role=\"target_temperature\"");
IF r.IsSuccess
    RETURN(PARSEJSON(r.Content, "$.value"));
END
IF r.StatusCode = 401
    ADDERROR(401, "Thermostat asks for a password (HTTP 401). Turn off password protection in the Shelly app, TapHome does not support HTTP Digest.");
ELSE
    ADDERROR(1, "Thermostat answered HTTP " + TOSTRING(r.StatusCode));
END
RETURN(NaN);
Zápis požadované teploty
SENDHTTPREQUEST("/rpc/Number.Set?owner=\"service:0\"&role=\"target_temperature\"&value=" + TOSTRING(Se, "F1"));
Fan speed Vícestavový přepínač
Hodnoty / Stavy: Auto · Low · Medium · High

Fan speed

Čtení stavu přepínače
VAR r := SENDHTTPREQUEST("/rpc/Enum.GetStatus?owner=\"service:0\"&role=\"fan_speed\"");
IF r.IsSuccess = false
    IF r.StatusCode = 401
        ADDERROR(401, "Thermostat asks for a password (HTTP 401). Turn off password protection in the Shelly app, TapHome does not support HTTP Digest.");
    ELSE
        ADDERROR(1, "Thermostat answered HTTP " + TOSTRING(r.StatusCode));
    END
    RETURN(NaN);
END
VAR v := PARSEJSON(r.Content, "$.value", true);
IF v = "auto"
    RETURN(0);
ELSEIF v = "low"
    RETURN(1);
ELSEIF v = "medium"
    RETURN(2);
ELSEIF v = "high"
    RETURN(3);
END
ADDERROR(2, "Unknown fan speed: " + TOSTRING(v));
RETURN(NaN);
Zápis stavu přepínače
VAR val := "high";
IF Mu = 0
    val := "auto";
ELSEIF Mu = 1
    val := "low";
ELSEIF Mu = 2
    val := "medium";
END
SENDHTTPREQUEST("/rpc/Enum.Set?owner=\"service:0\"&role=\"fan_speed\"&value=\"" + val + "\"");
Working mode Vícestavový přepínač
Hodnoty / Stavy: Cool · Heat · Dry · Ventilation · Floor Heating

Working mode

Čtení stavu přepínače
VAR r := SENDHTTPREQUEST("/rpc/Enum.GetStatus?owner=\"service:0\"&role=\"working_mode\"");
IF r.IsSuccess = false
    IF r.StatusCode = 401
        ADDERROR(401, "Thermostat asks for a password (HTTP 401). Turn off password protection in the Shelly app, TapHome does not support HTTP Digest.");
    ELSE
        ADDERROR(1, "Thermostat answered HTTP " + TOSTRING(r.StatusCode));
    END
    RETURN(NaN);
END
VAR v := PARSEJSON(r.Content, "$.value", true);
IF v = "cool"
    RETURN(0);
ELSEIF v = "heat"
    RETURN(1);
ELSEIF v = "dry"
    RETURN(2);
ELSEIF v = "ventilation"
    RETURN(3);
ELSEIF v = "floor_heating"
    RETURN(4);
END
ADDERROR(2, "Unknown working mode: " + TOSTRING(v));
RETURN(NaN);
Zápis stavu přepínače
VAR val := "floor_heating";
IF Mu = 0
    val := "cool";
ELSEIF Mu = 1
    val := "heat";
ELSEIF Mu = 2
    val := "dry";
ELSEIF Mu = 3
    val := "ventilation";
END
SENDHTTPREQUEST("/rpc/Enum.Set?owner=\"service:0\"&role=\"working_mode\"&value=\"" + val + "\"");
Thermostat on/off Přepínač
Hodnoty / Stavy: ON · OFF

Thermostat on/off

Čtení stavu přepínače
VAR r := SENDHTTPREQUEST("/rpc/Boolean.GetStatus?owner=\"service:0\"&role=\"enable\"");
IF r.IsSuccess
    RETURN(PARSEJSON(r.Content, "$.value"));
END
IF r.StatusCode = 401
    ADDERROR(401, "Thermostat asks for a password (HTTP 401). Turn off password protection in the Shelly app, TapHome does not support HTTP Digest.");
ELSE
    ADDERROR(1, "Thermostat answered HTTP " + TOSTRING(r.StatusCode));
END
RETURN(NaN);
Zápis stavu přepínače
SENDHTTPREQUEST("/rpc/Boolean.Set?owner=\"service:0\"&role=\"enable\"&value=" + IF(St, "true", "false"));
Anti-freeze Přepínač
Hodnoty / Stavy: ON · OFF

Anti-freeze

Čtení stavu přepínače
VAR r := SENDHTTPREQUEST("/rpc/Boolean.GetStatus?owner=\"service:0\"&role=\"anti_freeze\"");
IF r.IsSuccess
    RETURN(PARSEJSON(r.Content, "$.value"));
END
IF r.StatusCode = 401
    ADDERROR(401, "Thermostat asks for a password (HTTP 401). Turn off password protection in the Shelly app, TapHome does not support HTTP Digest.");
ELSE
    ADDERROR(1, "Thermostat answered HTTP " + TOSTRING(r.StatusCode));
END
RETURN(NaN);
Zápis stavu přepínače
SENDHTTPREQUEST("/rpc/Boolean.Set?owner=\"service:0\"&role=\"anti_freeze\"&value=" + IF(St, "true", "false"));
Target humidity Proměnná

Target humidity

Čtení
VAR r := SENDHTTPREQUEST("/rpc/Number.GetStatus?owner=\"service:0\"&role=\"target_humidity\"");
IF r.IsSuccess
    RETURN(PARSEJSON(r.Content, "$.value"));
END
IF r.StatusCode = 401
    ADDERROR(401, "Thermostat asks for a password (HTTP 401). Turn off password protection in the Shelly app, TapHome does not support HTTP Digest.");
ELSE
    ADDERROR(1, "Thermostat answered HTTP " + TOSTRING(r.StatusCode));
END
RETURN(NaN);
Zápis
SENDHTTPREQUEST("/rpc/Number.Set?owner=\"service:0\"&role=\"target_humidity\"&value=" + TOSTRING(Va, "F0"));
Připojení: Packet Parser → HTTP

Parametry importu

Tyto hodnoty zadáte při importu XML.

Ptá se v aplikaciVýchozí
IP adresa192.168.1.100

Našli jste problém s touto šablonou zařízení?

Napište nám, co nefunguje, co chybí, nebo jak by se měla šablona chovat. Vaše zpětná vazba nám pomáhá udržet katalog přesný.

Šablona · portál TapHome LinkedGo ST802-B Fan Coil Thermostat (Powered by Shelly) Otevřete tuto šablonu v zákaznickém portálu a použijte ji ve svém domově, nebo navrhněte úpravu a odešlete ji zpět do katalogu. Packet Parser → HTTP Zobrazit v portálu TapHome