---
title: "Shelly Gas"
description: "Wi-Fi detektor plynu Shelly Gas — stav alarmu, koncentrácia plynu v ppm, stlmenie a samotest cez HTTP. TapHome šablóna pre CNG a LPG varianty."
url: "https://taphome.com/sk/compatibility/shelly-gas/"
language: sk
lastmod: 2026-03-30
generator: hugo
ai:
  topics: ["http","sensor","wifi","gas-detection","safety"]
  questions: ["Ako integrovať Shelly Gas s TapHome?","Čo monitoruje šablóna Shelly Gas v TapHome?","Ako pripojiť Shelly Gas cez HTTP k TapHome?","Aké sú prahové hodnoty plynového alarmu na Shelly Gas?","Ako stlmiť bzučiak alarmu Shelly Gas z TapHome?","Funguje rovnaká šablóna pre CNG aj LPG varianty?"]
---

# Shelly Gas

Komunikácia: Packet Parser → HTTP

- [Produktová stránka Shelly Gas](https://www.shelly.com/en/products/shop/shelly-gas)
- [API dokumentácia Shelly Gas](https://shelly-api-docs.shelly.cloud/gen1/#shelly-gas)

> Adresa v sieti
> 
> TapHome komunikuje so zariadením na adrese zadanej pri importe. Dajte zariadeniu stálu adresu — rezerváciu IP v routeri, alebo jeho mDNS meno, ak ho podporuje —, inak integrácia prestane fungovať, keď router adresu zmení.
> 
> [Príprava siete](https://taphome.com/sk/docs/setup/network-preparation/)

## Návod na integráciu

Shelly Gas (model SHGS-1) je sieťovo napájaný Wi-Fi detektor plynu dostupný v dvoch variantoch — CNG (zemný plyn / metán) a LPG (propán / bután). Oba varianty používajú rovnaké API a rovnakú TapHome šablónu. Zariadenie sa zapája priamo do elektrickej zásuvky a nepretržite monitoruje koncentráciu plynu, spúšťajúc zvukový a svetelný alarm pri prekročení prahových hodnôt.

TapHome komunikuje so zariadením cez HTTP v lokálnej sieti — nie je potrebné cloudové pripojenie. Šablóna dotazuje endpoint `/status` na stav alarmu a koncentráciu plynu a poskytuje ovládanie na stlmenie alarmu a spustenie samotestu senzora.

K dispozícii je aj MQTT variant tejto šablóny (`Shelly GAS MQTT`). Použite MQTT šablónu ak je zariadenie nakonfigurované na komunikáciu cez MQTT broker namiesto HTTP.

## Konfigurácia

Shelly Gas sa pripája cez Wi-Fi. Pri importe TapHome šablóny zadajte IP adresu zariadenia (predvolená zástupná hodnota `192.168.0.1`).

Oba varianty CNG a LPG sa konfigurujú identicky — líši sa fyzický senzor, ale API a šablóna sú rovnaké.

## Schopnosti zariadenia

### Monitorovanie plynového alarmu

Šablóna poskytuje viacstavový prepínač, ktorý číta aktuálny stav alarmu z odpovede `/status` (`gas_sensor.alarm_state`). Zariadenie hlási jeden z nasledujúcich stavov:

| Stav | Význam |
|------|--------|
| No alarm | Normálna prevádzka — žiadny plyn detekovaný |
| Mild gas leak | Koncentrácia plynu >= 1800 ppm |
| Heavy gas leak | Koncentrácia plynu >= 3000 ppm |
| Self Test | Prebieha samodiagnostika senzora |
| Alarm state is unknown | Nerozpoznaný stav (záložný) |

Prahové hodnoty alarmu sú pevné na úrovni zariadenia a nedajú sa meniť cez TapHome ani API.

### Koncentrácia plynu

Senzorové zariadenie číta aktuálnu koncentráciu plynu v miliontinách (ppm) z odpovede `/status` (`concentration.ppm`). Hodnota sa aktualizuje každých 15 sekúnd. Počas zahrievania senzora po zapnutí môže byť meranie neplatné.

### Stlmenie aktívneho alarmu

Tlačidlové zariadenie odošle požiadavku `GET /mute` na stlmenie bzučiaka alarmu bez zrušenia stavu alarmu. Stav alarmu zostáva aktívny, kým koncentrácia plynu neklesne pod prahovú hodnotu.

### Servisná diagnostika

Šablóna poskytuje 9 servisných atribútov na monitorovanie zariadenia:

- **Informácie o zariadení** — hostname, MAC adresa, čas zariadenia, doba prevádzky, využitie RAM
- **Konektivita** — cloud povolený/pripojený, MQTT pripojený, dostupná aktualizácia firmvéru

### Servisné akcie

K dispozícii sú dve servisné akcie:

- **Nastaviť hlasitosť** — upraví hlasitosť bzučiaka alarmu (1 = najtichší, 11 = najhlasnejší) cez `/settings?set_volume={value}`
- **Samotest** — spustí samodiagnostiku senzora (~30 sekúnd) cez `/self_test`

### Ďalšie schopnosti

Shelly Gas tiež poskytuje prevádzkový stav senzora (`normal` / `warmup` / `fault`), priebeh samotestu, príznak platnosti koncentrácie, silu Wi-Fi signálu a ovládanie externého ventilového manipulátora (11–13V, 500mA jack výstup) v odpovedi `/status`. Endpoint na zrušenie stlmenia (`/unmute`) je dostupný na opätovné povolenie bzučiaka alarmu po stlmení. Tieto schopnosti môžu byť pridané v budúcej aktualizácii šablóny.

## Riešenie problémov

### Zariadenie neodpovedá

1. Overte, že Shelly je pripojený k Wi-Fi a má platnú IP adresu
2. Skúste použiť mDNS hostname (`shellygas-AABBCCDDEE.local`) namiesto IP adresy — IP sa mohla zmeniť po DHCP obnove
3. Otvorte `http://{device-ip}/shelly` v prehliadači — ak odpovie s typom zariadenia `SHGS-1`, zariadenie je dostupné
4. Skontrolujte, či sú TapHome CCU a Shelly v rovnakej sieti / VLAN

### Koncentrácia plynu vždy ukazuje nulu

1. Potvrďte, že senzor nie je v režime zahrievania — po zapnutí senzor potrebuje čas na stabilizáciu pred hlásením platných meraní
2. Skontrolujte `concentration.is_valid` v odpovedi `/status` — ak je `false`, senzor sa stále zahrieva
3. Uistite sa, že zariadenie je správne umiestnené (CNG variant blízko stropu, LPG variant blízko podlahy — plyn stúpa alebo klesá podľa hustoty)

### Alarm sa nespúšťa

1. Prahové hodnoty alarmu sú pevné: mierny >= 1800 ppm, silný >= 3000 ppm — nízke koncentrácie pod týmito úrovňami alarm nespustia
2. Spustite samotest z TapHome (servisná akcia) na overenie funkčnosti senzora a bzučiaka
3. Skontrolujte pole `gas_sensor.sensor_state` v `/status` — ak hlási `fault`, senzor môže vyžadovať výmenu

> [!WARNING]
> Gen1 Shelly zariadenia podporujú len **2 súbežné HTTP pripojenia**. Ak TapHome a iný systém (napr. Home Assistant) dotazujú rovnaké zariadenie súčasne, komunikácia sa môže stať nespoľahlivou. Použite interval dotazovania 10–30 sekúnd.

## Ako nainštalovať v TapHome

### Predpoklady

- Zariadenie Shelly nainštalované a zapnuté
- Lokálna Wi-Fi sieť (2,4 GHz)
- TapHome CCU v rovnakej sieti

### Krok 1 — Pripojte Shelly k Wi-Fi

**Možnosť A — Aplikácia Shelly (odporúčané):**

1. Stiahnite si [aplikáciu Shelly](https://www.shelly.com/en/support/shelly-app) (iOS / Android)
2. Klepnite na **+** → **Add Device** a postupujte podľa sprievodcu Bluetooth párovaním
3. Po výzve zadajte svoje Wi-Fi prihlasovacie údaje

**Možnosť B — AP režim (bez aplikácie):**

1. Pri prvom zapnutí zariadenie vytvorí hotspot: `ShellyXXX-AABBCCDDEE`
2. Pripojte telefón/PC k tomuto hotspotu
3. Otvorte `http://192.168.33.1` → **Internet & Security** → **Wi-Fi Mode - Client**
4. Zadajte SSID a heslo → **Save**

> [!NOTE]
> Shelly podporuje iba **2,4 GHz** siete. 5 GHz siete sa pri skenovaní nezobrazia.

### Krok 2 — Zistite IP adresu

Po pripojení k Wi-Fi zistite priradenú IP adresu jedným z nasledujúcich spôsobov:

- **Aplikácia Shelly:** Detail zariadenia → **Device info** → IP adresa
- **Webové rozhranie Shelly:** Pripojte sa k AP zariadenia pred nastavením Wi-Fi — IP sa zobrazí po uložení
- **DHCP tabuľka routera:** Hľadajte hostname ako `shelly1pm-AABBCCDDEE`
- **mDNS:** Pingnite `shelly<model>-<mac>.local` (napr. `shelly1pm-AABBCCDDEE.local`) z rovnakej siete

> [!TIP]
> Priraďte zariadeniu Shelly **statickú IP** (DHCP rezerváciu) vo vašom routeri, aby sa adresa nezmenila po reštarte routera.

### Krok 3 — Konfigurácia v TapHome

1. V TapHome pridajte nový modul **Packet Parser (HTTP)**
2. **IP Address:** zadajte IP z kroku 2 (napr. `192.168.1.50`)
3. **Port:** `80` (predvolený, nie je potrebné meniť)
4. Importujte šablónu — TapHome bude pravidelne čítať `/status` pre zistenie stavu zariadenia

> [!NOTE]
> HTTP autentifikácia je na zariadeniach Shelly štandardne vypnutá. Ak ste povolili ochranu prihlásením, TapHome momentálne nepodporuje HTTP Basic Auth — pre integráciu s TapHome ponechajte autentifikáciu vypnutú.

## Dostupné zariadenia 3

Tieto zariadenia sa po importe zobrazia v TapHome.

Shelly Gas Modul

Servisné akcie

|                    |
|--------------------|
| Nastaviť hlasitosť |
| Samotest           |

Vlastné premenné

|                                    |                                                                        |
|------------------------------------|------------------------------------------------------------------------|
| `deviceID` (string) = 10521CF2BA9B | Device ID zariadenia Shelly Gas (MAC adresa v hex, napr. 10521CF2BA9B) |

Čítanie (modul)

```taphome
VAR response := SENDHTTPREQUEST("/status");
IF response.IsSuccess
 status := response.Content;
END
```

Servisné akcie

Set Volume \[1 to 11]

Parametre: Volume \[1 to 11] (1–11 Volume)

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

Self test

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

Plynový alarm Viacstavový prepínač Len na čítanie

Stav plynového alarmu — Žiadny alarm, Mierny únik plynu (&gt;= 1800 ppm), Silný únik plynu (&gt;= 3000 ppm), Samotest, Neznámy

enum multi-value switch

Hodnoty / Stavy: No alarm · Mild gas leak · Heavy gas leak · Alarm state is unknown · Self Test

Čítanie stavu prepínača

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

Zápis stavu prepínača

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

Koncentrácia plynu Premenná Len na čítanie

Aktuálna hodnota koncentrácie plynu v miliontinách (ppm)

numeric Jednotka: ppm

Čítanie

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

Zápis

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

Čítanie (modul)

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

Stlmiť aktívny alarm Tlačidlo Čítanie aj zápis

Stlmí bzučiak alarmu bez zrušenia stavu alarmu

action push button

Zápis stavu tlačidla

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

**Pripojenie:** Packet Parser → HTTP • Hostname: `shellygas-{MAC}.local`

Možné vylepšenia (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

## Parametre importu

Tieto hodnoty zadáte pri importe XML.

| Pýta sa v aplikácii | Predvolené    |
|---------------------|---------------|
| IP adresa           | `192.168.0.1` |

## Zdroje

- 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

## Súvisiaca dokumentácia

- [Integrácia Packet Parser](https://taphome.com/sk/compatibility/packet-parser-guide/)
- [Packet Parser (HTTP, TCP, UDP, FTP, MQTT)](https://taphome.com/sk/docs/integration/packet-parser/)
- [Funkcie Packet parsera](https://taphome.com/sk/docs/script/packet-parser/)
- [Parsovacie funkcie](https://taphome.com/sk/docs/script/parsing-functions/)