TapHome
Službeni · TapHome Provjereno Senzori

Shelly Gas

Wi-Fi detektor plina Shelly Gas (CNG ili LPG) integriran sa sustavom TapHome preko HTTP-a. Prati stanje alarma i koncentraciju plina u ppm, uz utišavanje alarma i samotestiranje.

ShellyPacket Parser → HTTP3 uređajaRevizija 1.0 Posljednje ažuriranje: 30. ožujka 2026.
Shelly Gas

Uvoz u aplikaciju TapHomeHardver › Packet Parser › Dodaj iz predloška

Preuzmite predložak
Na ovoj stranici

Ovaj uređaj podržava mDNS

Umjesto IP adrese uređaju možete pristupiti na adresi:

shellygas-{MAC}.local

Zamijenite {MAC} MAC adresom svog uređaja (velika slova, bez dvotočaka).

TapHome podržava mDNS. Naziv računala (hostname) pouzdaniji je od statične IP adrese.

Adresa u mreži

TapHome komunicira s uređajem na adresi unesenoj pri uvozu. Dodijelite uređaju stalnu adresu — rezervaciju IP adrese u usmjerivaču ili njegovo mDNS ime ako ga podržava — inače integracija prestaje raditi kada usmjerivač promijeni adresu.

Priprema mreže

Upute za integraciju

Shelly Gas (model SHGS-1) je Wi-Fi detektor plina s napajanjem iz mreže, dostupan u dvije varijante: CNG (prirodni plin / metan) i LPG (propan / butan). Obje varijante koriste isti API i isti predložak TapHome. Uređaj se uključuje izravno u utičnicu, neprekidno prati koncentraciju plina i pri prekoračenju pragova pokreće zvučni i svjetlosni alarm.

TapHome s uređajem komunicira preko HTTP-a u lokalnoj mreži, veza s oblakom nije potrebna. Predložak periodički očitava krajnju točku /status kako bi dobio stanje alarma i koncentraciju plina te omogućuje utišavanje alarma i pokretanje samotestiranja senzora.

Dostupna je i MQTT varijanta ovog predloška (Shelly GAS MQTT). MQTT predložak koristite ako je uređaj postavljen za komunikaciju preko MQTT brokera umjesto HTTP-a.

Konfiguracija

Shelly Gas se spaja preko Wi-Fi mreže. Pri uvozu predloška u TapHome unesite IP adresu uređaja (u predlošku je unaprijed upisan primjer 192.168.0.1).

Varijante CNG i LPG konfiguriraju se jednako: razlikuje se fizički senzor, a API i predložak su isti.

Mogućnosti uređaja

Praćenje alarma plina

Predložak sadrži prekidač s više vrijednosti koji čita trenutačno stanje alarma iz odgovora /status (gas_sensor.alarm_state). Uređaj javlja jedno od sljedećih stanja:

StanjeZnačenje
No alarmNormalan rad, plin nije otkriven
Mild gas leakKoncentracija plina >= 1800 ppm
Heavy gas leakKoncentracija plina >= 3000 ppm
Self TestU tijeku je samodijagnostika senzora
Alarm state is unknownNeprepoznato stanje (zamjenska vrijednost)

Pragovi alarma fiksno su zadani u uređaju i ne mogu se promijeniti iz sustava TapHome ni preko API-ja.

Koncentracija plina

Uređaj senzor čita trenutačnu koncentraciju plina u dijelovima na milijun (ppm) iz odgovora /status (concentration.ppm). Vrijednost se ažurira svakih 15 sekundi. Tijekom zagrijavanja senzora nakon uključivanja očitanje može biti nevaljano.

Utišavanje aktivnog alarma

Uređaj tipkalo šalje zahtjev GET /mute koji utišava zujalicu alarma bez poništavanja stanja alarma. Stanje alarma ostaje aktivno dok koncentracija plina ne padne ispod praga.

Servisna dijagnostika

Predložak ima 9 servisnih atributa za praćenje uređaja:

  • Podaci o uređaju: naziv hosta, MAC adresa, vrijeme uređaja, vrijeme rada, iskorištenost RAM-a
  • Povezivost: oblak omogućen / spojeno na oblak, spojeno na MQTT, dostupno ažuriranje firmvera

Servisne radnje

Dostupne su dvije servisne radnje:

  • Postavi glasnoću: podešava glasnoću zujalice alarma (1 = najtiše, 11 = najglasnije) preko /settings?set_volume={value}
  • Samotestiranje: pokreće samodijagnostiku senzora (oko 30 sekundi) preko /self_test

Dodatne mogućnosti

Shelly Gas u odgovoru /status daje i radno stanje senzora (normal / warmup / fault), napredak samotestiranja, oznaku valjanosti koncentracije, jačinu Wi-Fi signala i upravljanje vanjskim pogonom ventila (izlaz na priključku 11–13 V, 500 mA). Dostupna je i krajnja točka za poništavanje utišavanja (/unmute) koja ponovno uključuje zujalicu alarma nakon utišavanja. Te se mogućnosti mogu dodati u budućem ažuriranju predloška.

Rješavanje problema

Uređaj ne odgovara

  1. Provjerite je li Shelly spojen na Wi-Fi i ima li valjanu IP adresu
  2. Umjesto IP adrese pokušajte koristiti mDNS naziv hosta (shellygas-AABBCCDDEE.local): IP adresa se možda promijenila nakon obnove DHCP zakupa
  3. U pregledniku otvorite http://{device-ip}/shelly: ako odgovori s vrstom uređaja SHGS-1, uređaj je dostupan
  4. Provjerite jesu li centralna jedinica TapHome (CCU) i Shelly u istoj mreži / VLAN-u

Koncentracija plina uvijek pokazuje nulu

  1. Provjerite da senzor nije u načinu zagrijavanja: nakon uključivanja senzoru treba vremena da se stabilizira prije nego što počne javljati valjana očitanja
  2. Provjerite concentration.is_valid u odgovoru /status: ako je false, senzor se još zagrijava
  3. Provjerite je li uređaj ispravno postavljen (varijanta CNG blizu stropa, varijanta LPG blizu poda, jer se plin ovisno o gustoći diže ili spušta)

Alarm se ne aktivira

  1. Pragovi alarma su fiksni: blago curenje >= 1800 ppm, jako curenje >= 3000 ppm. Niže koncentracije ispod tih razina ne aktiviraju alarm
  2. Iz sustava TapHome pokrenite samotestiranje (servisna radnja) i provjerite rad senzora i zujalice
  3. Provjerite polje gas_sensor.sensor_state u odgovoru /status: ako pokazuje fault, senzor je možda potrebno zamijeniti

Uređaji Shelly Gen1 podržavaju samo 2 istodobne HTTP veze. Ako TapHome i drugi sustav (npr. Home Assistant) istodobno očitavaju isti uređaj, komunikacija može postati nepouzdana. Koristite interval očitavanja od 10 do 30 sekundi.

Kako ga instalirati u TapHome

Preduvjeti

  • Uređaj Shelly ugrađen i uključen
  • Lokalna Wi-Fi mreža (2,4 GHz)
  • TapHome CCU u istoj mreži

Korak 1 — Spojite Shelly na Wi-Fi

Opcija A — aplikacija Shelly (preporučeno):

  1. Preuzmite aplikaciju Shelly (iOS / Android)
  2. Dodirnite + → Add Device i slijedite čarobnjak za uparivanje preko Bluetootha
  3. Kada se to zatraži, unesite podatke za prijavu na Wi-Fi

Opcija B — način rada AP (bez aplikacije):

  1. Pri prvom uključivanju uređaj stvara pristupnu točku: ShellyXXX-AABBCCDDEE
  2. Spojite telefon ili računalo na tu pristupnu točku
  3. Otvorite http://192.168.33.1 → Internet & Security → Wi-Fi Mode - Client
  4. Unesite SSID i lozinku → Save

Shelly podržava samo mreže od 2,4 GHz. Mreže od 5 GHz neće se prikazati pri skeniranju.

Korak 2 — Pronađite adresu uređaja

Uređaji Shelly Gen1 podržavaju mDNS (Zeroconf). Uređaju možete pristupiti preko naziva hosta umjesto IP adrese:

1
shelly<model>-<MAC>.local

Na primjer: shelly1pm-AABBCCDDEE.local (MAC adresa velikim slovima u heksadecimalnom zapisu, bez dvotočaka).

Preporučeno: koristite IP skener TapHome. Otvorite aplikaciju TapHome i pokrenite IP skener (Postavke → Mreža → Skeniranje). Skener pronalazi uređaje u vašoj mreži i prikazuje IP adresu i mDNS naziv hosta. Za pouzdaniju vezu koristite naziv hosta umjesto IP adrese, jer ostaje isti i kada se IP adresa uređaja promijeni nakon ponovnog pokretanja usmjerivača.

Drugi načini za pronalaženje IP adrese:

  • Aplikacija Shelly: detalji uređaja → Device info → IP adresa
  • Web-sučelje Shelly: spojite se na AP uređaja prije postavljanja Wi-Fi mreže — IP adresa prikazuje se nakon spremanja
  • DHCP tablica usmjerivača: potražite naziv hosta poput shelly1pm-AABBCCDDEE

Korak 3 — Konfiguracija u sustavu TapHome

  1. U sustavu TapHome dodajte novi modul Packet Parser (HTTP)
  2. Adresa: unesite mDNS naziv hosta (npr. shelly1pm-AABBCCDDEE.local) ili IP adresu iz koraka 2
  3. Port: 80 (zadano, nije potrebno mijenjati)
  4. Uvezite predložak — TapHome će čitati /status kako bi očitao stanje uređaja

HTTP autentifikacija na uređajima Shelly zadano je isključena. Ako ste uključili zaštitu prijavom, TapHome trenutačno ne podržava HTTP Basic Auth — za integraciju sa sustavom TapHome ostavite autentifikaciju isključenom.

Dostupni uređaji 3

Ovi se uređaji pojavljuju u TapHomeu nakon uvoza.

Shelly Gas Modul
Servisne radnje
Postavi glasnoću
Samotestiranje
Prilagođene varijable
deviceID (string) = 10521CF2BA9BDevice ID uređaja Shelly Gas (MAC adresa u hex obliku, npr. 10521CF2BA9B)

Shelly GAS

Čitanje (modul)
VAR response := SENDHTTPREQUEST("/status");
IF response.IsSuccess
 status := response.Content;
END
Servisne radnje
Set Volume [1 to 11]
Parametri: Volume [1 to 11] (1–11 Volume)
sendhttprequest("/settings?set_volume="+Volume);
Self test
sendhttprequest("/self_test");
Alarm plina Prekidač s više vrijednosti Samo za čitanje

Stanje alarma plina — nema alarma, blago curenje plina (>= 1800 ppm), jako curenje plina (>= 3000 ppm), samotestiranje, nepoznato

enum multi-value switch
Vrijednosti / stanja: No alarm · Mild gas leak · Heavy gas leak · Alarm state is unknown · Self Test

Alarm plina

Čitanje stanja sklopke
var state := parsejson(parsejson(status,"gas_sensor"),"alarm_state");
switch(state, "none", return(0),
"mild", return(1),
"heavy", return(2),
"test", return(4),
return(3));
Zapis stanja sklopke
#return(2);

# Simple HTTP Request:
# VAR response := SENDHTTPREQUEST("/example/set/value=" + Mu);
# IF response.IsSuccess = false
#  ADDERROR(response.StatusCode);
# END
#
# Set Http request method, body and headers
# VAR response := SENDHTTPREQUEST("/example/setValue", "GET", "value=" + Mu, "header1:value1", "header2:value2", ...);\r
# Or VAR request := HTTPREQUEST("/example/setValue");
# request.Method := "PUT";
# VAR response := SENDHTTPREQUEST(request);
#r
#
# Send TCP, UDP data:
# VAR data1 := "{\"name\":\"John\", \"age\":" + Mu + "}";
# SENDDATA(data1);
# VAR data2 := TOBYTES("{\"name\":\"John\", \"age\":" + Mu + "}", "iso-8859-1");
# SENDDATA(data2);
# You can process received TCP or UDP data in the Listener script
#
#
# Upload data to FTP:
# FTPUPLOAD("filePath", "somedata=" + Mu, "write"); # use "append" mode to append data to existing file
Koncentracija plina Varijabla Samo za čitanje

Trenutačna koncentracija plina u dijelovima na milijun (ppm)

numeric Jedinica: ppm

Koncentracija plina

Čitanje
var v := sendhttprequest("/status");
var content := v.Content;
return(todouble(parsejson(content,"concentration.ppm")));
Zapis
# Simple HTTP Request:
# VAR response := SENDHTTPREQUEST("/example/set/value=" + Va);
# IF response.IsSuccess = false
#  ADDERROR(response.StatusCode);
# END
#
# Set Http request method, body and headers
# VAR response := SENDHTTPREQUEST("/example/setValue", "GET", "value=" + Va, "header1:value1", "header2:value2", ...);\r
# Or VAR request := HTTPREQUEST("/example/setValue");
# request.Method := "PUT";
# VAR response := SENDHTTPREQUEST(request);
#r
#
# Send TCP, UDP data:
# VAR data1 := "{\"name\":\"John\", \"age\":" + Va + "}";
# SENDDATA(data1);
# VAR data2 := TOBYTES("{\"name\":\"John\", \"age\":" + Va + "}", "iso-8859-1");
# SENDDATA(data2);
# You can process received TCP or UDP data in the Listener script
#
#
# Upload data to FTP:
# FTPUPLOAD("filePath", "somedata=" + Va, "write"); # use "append" mode to append data to existing file
Čitanje (modul)
parsejson(status, "concentration")
Utišaj aktivni alarm Tipkalo Čitanje i pisanje

Utišava zujalicu alarma bez poništavanja stanja alarma

action push button

Utišaj aktivni alarm

Zapis stanja tipke
sendhttprequest("/mute");
Povezivanje: Packet Parser → HTTP • Naziv računala (hostname): shellygas-{MAC}.local
Moguća poboljšanja (7)
  • Self-test state — Self-test progress: not_completed | completed | running | pending — available in /status
  • Sensor state — Sensor operational state: normal | warmup | fault — available in /status
  • Concentration validity — Whether gas reading is valid (false during warmup) — available in /status
  • Valve state — External valve state: opened | closed | not_connected | failure | closing | opening | checking
  • Valve control — Open/close external valve manipulator (11–13V, 500mA jack output)
  • Unmute alarm — Re-enables alarm buzzer after muting
  • WiFi Signal Strength — WiFi RSSI in dBm, available in /status response

Parametri uvoza

Ove vrijednosti unosite pri uvozu XML-a.

Pitanje u aplikacijiZadano
IP adresa192.168.0.1

Izvori

Pronašli ste problem s ovim predloškom uređaja?

Recite nam što ne radi, što nedostaje ili kako bi se predložak trebao ponašati. Vaše povratne informacije pomažu nam da katalog bude točan.

Predložak · TapHome portal Shelly Gas Otvorite ovaj predložak na portalu Customer Portal kako biste ga primijenili na jedan od svojih domova ili predložili poboljšanje i poslali ga natrag u katalog. Packet Parser → HTTP Pogledaj u TapHome portalu