---
title: "Shelly Gas"
description: "Wi-Fi detektor plina Shelly Gas: stanje alarma, koncentracija plina u ppm, utišavanje i samotestiranje preko HTTP-a. Predložak TapHome za CNG i LPG."
url: "https://taphome.com/hr/compatibility/shelly-gas/"
language: hr
lastmod: 2026-03-30
generator: hugo
ai:
  topics: ["http","sensor","wifi","gas-detection","safety"]
  questions: ["Kako integrirati Shelly Gas sa sustavom TapHome?","Što prati predložak TapHome za Shelly Gas?","Kako spojiti Shelly Gas sa sustavom TapHome preko HTTP-a?","Koji su pragovi alarma plina na uređaju Shelly Gas?","Kako iz sustava TapHome utišati zujalicu alarma Shelly Gas?","Radi li isti predložak za varijante CNG i LPG?"]
---

# Shelly Gas

Komunikacija: Packet Parser → HTTP

- [Stranica proizvoda Shelly Gas](https://www.shelly.com/en/products/shop/shelly-gas)
- [API dokumentacija Shelly Gas](https://shelly-api-docs.shelly.cloud/gen1/#shelly-gas)

> 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](https://taphome.com/hr/docs/setup/network-preparation/)

## 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:

| Stanje | Značenje |
|-------|---------|
| No alarm | Normalan rad, plin nije otkriven |
| Mild gas leak | Koncentracija plina >= 1800 ppm |
| Heavy gas leak | Koncentracija plina >= 3000 ppm |
| Self Test | U tijeku je samodijagnostika senzora |
| Alarm state is unknown | Neprepoznato 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

> [!WARNING]
> 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](https://www.shelly.com/en/support/shelly-app) (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**

> [!NOTE]
> 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:

```
shelly<model>-<MAC>.local
```

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

> [!TIP]
> **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

> [!NOTE]
> 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) = 10521CF2BA9B | Device ID uređaja Shelly Gas (MAC adresa u hex obliku, npr. 10521CF2BA9B) |

Čitanje (modul)

```taphome
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)

```taphome
sendhttprequest("/settings?set_volume="+Volume);
```

Self test

```taphome
sendhttprequest("/self_test");
```

Alarm plina Prekidač s više vrijednosti Samo za čitanje

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

enum multi-value switch

Vrijednosti / stanja: No alarm · Mild gas leak · Heavy gas leak · Alarm state is unknown · Self Test

Čitanje stanja sklopke

```taphome
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

```taphome
#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

Čitanje

```taphome
var v := sendhttprequest("/status");
var content := v.Content;
return(todouble(parsejson(content,"concentration.ppm")));
```

Zapis

```taphome
# 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)

```taphome
parsejson(status, "concentration")
```

Utišaj aktivni alarm Tipkalo Čitanje i pisanje

Utišava zujalicu alarma bez poništavanja stanja alarma

action push button

Zapis stanja tipke

```taphome
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 aplikaciji | Zadano        |
|----------------------|---------------|
| IP adresa            | `192.168.0.1` |

## Izvori

- Shelly Gen1 API Reference
  
  [shelly-api-docs.shelly.cloud](https://shelly-api-docs.shelly.cloud/gen1/) 2026-03-12
- Home Assistant Shelly Integration
  
  [www.home-assistant.io](https://www.home-assistant.io/integrations/shelly/) 2026-03-12
- Shelly Gas — Device-Specific API
  
  [shelly-api-docs.shelly.cloud](https://shelly-api-docs.shelly.cloud/gen1/#shelly-gas) 2026-03-30
- Shelly Gas — Knowledge Base
  
  [kb.shelly.cloud](https://kb.shelly.cloud/knowledge-base/shelly-gas) 2026-03-30

## Povezana dokumentacija

- [Packet Parser Integration](https://taphome.com/hr/compatibility/packet-parser-guide/)
- [Packet Parser (HTTP, TCP, UDP, FTP, MQTT)](https://taphome.com/hr/docs/integration/packet-parser/)
- [Funkcije Packet parsera](https://taphome.com/hr/docs/script/packet-parser/)
- [Funkcije za raščlambu](https://taphome.com/hr/docs/script/parsing-functions/)

