---
title: "Shelly Gas"
description: "Shelly Gas Wi-Fi gázérzékelő — riasztási állapot, gázkoncentráció ppm-ben, némítás és önellenőrzés HTTP-n. TapHome sablon CNG és LPG variánsokhoz."
url: "https://taphome.com/hu/compatibility/shelly-gas/"
language: hu
lastmod: 2026-03-30
generator: hugo
ai:
  topics: ["http","sensor","wifi","gas-detection","safety"]
  questions: ["Hogyan integrálható a Shelly Gas a TapHome-mal?","Mit figyel a Shelly Gas TapHome sablon?","Hogyan csatlakoztatható a Shelly Gas HTTP-n keresztül a TapHome-hoz?","Mik a gázriasztás küszöbértékei a Shelly Gas-on?","Hogyan némítható el a Shelly Gas riasztó hangjelzője a TapHome-ból?","Ugyanaz a sablon működik mind a CNG, mind az LPG variánssal?"]
---

# Shelly Gas

Kommunikáció: Packet Parser → HTTP

- [Shelly Gas termékoldal](https://www.shelly.com/en/products/shop/shelly-gas)
- [Shelly Gas API dokumentáció](https://shelly-api-docs.shelly.cloud/gen1/#shelly-gas)

> Hálózati cím
> 
> A TapHome az importáláskor megadott címen éri el az eszközt. Adjon az eszköznek állandó címet — IP-foglalást a routerben, vagy az mDNS-nevét, ha támogatja —, különben az integráció leáll, amikor a router megváltoztatja a címet.
> 
> [A hálózat előkészítése](https://taphome.com/hu/docs/setup/network-preparation/)

## Integrációs útmutató

A Shelly Gas (SHGS-1 modell) egy hálózatról táplált Wi-Fi gázérzékelő, amely két változatban érhető el — CNG (földgáz / metán) és LPG (propán / bután). Mindkét változat ugyanazt az API-t és ugyanazt a TapHome sablont használja. Az eszköz közvetlenül a konnektorba dugható, és folyamatosan figyeli a gázkoncentrációt, hang- és fényriasztást aktiválva a küszöbértékek túllépésekor.

A TapHome HTTP-n keresztül kommunikál az eszközzel a helyi hálózaton — felhőkapcsolat nem szükséges. A sablon a `/status` végpontot kérdezi le a riasztás állapotára és a gázkoncentrációra, valamint vezérlést biztosít a riasztás némításához és a szenzor önellenőrzésének elindításához.

Ennek a sablonnak MQTT változata is elérhető (`Shelly GAS MQTT`). Használd az MQTT sablont, ha az eszköz MQTT brokeren keresztüli kommunikációra van konfigurálva HTTP helyett.

## Konfiguráció

A Shelly Gas Wi-Fi-n keresztül csatlakozik. A TapHome sablon importálásakor add meg az eszköz IP-címét (alapértelmezett helyőrző `192.168.0.1`).

Mind a CNG, mind az LPG változat azonosan konfigurálható — a fizikai szenzor különbözik, de az API és a sablon megegyezik.

## Eszközképességek

### Gázriasztás monitorozás

A sablon egy többértékű kapcsolót biztosít, amely a `/status` válaszból olvassa az aktuális riasztási állapotot (`gas_sensor.alarm_state`). Az eszköz az alábbi állapotok egyikét jelenti:

| Állapot | Jelentés |
|---------|----------|
| No alarm | Normál működés — nincs gáz érzékelve |
| Mild gas leak | Gázkoncentráció >= 1800 ppm |
| Heavy gas leak | Gázkoncentráció >= 3000 ppm |
| Self Test | Szenzor öndiagnosztika folyamatban |
| Alarm state is unknown | Ismeretlen állapot (tartalék) |

A riasztási küszöbértékek az eszköz szintjén rögzítettek, és nem módosíthatók a TapHome-on vagy az API-n keresztül.

### Gázkoncentráció

Egy szenzor eszköz a `/status` válaszból olvassa az aktuális gázkoncentrációt milliomod részben (ppm) (`concentration.ppm`). Az érték 15 másodpercenként frissül. A szenzor bekapcsolás utáni bemelegedése során a mért érték érvénytelen lehet.

### Aktív riasztás némítása

Egy nyomógomb eszköz `GET /mute` kérést küld a riasztó hangjelzőjének elnémítására a riasztási állapot törlése nélkül. A riasztási állapot aktív marad, amíg a gázkoncentráció a küszöbérték alá nem csökken.

### Szervizdiagnosztika

A sablon 9 szervizattribútumot biztosít az eszköz monitorozásához:

- **Eszközinformáció** — hostname, MAC-cím, eszközidő, üzemidő, RAM-használat
- **Csatlakozás** — felhő engedélyezve/csatlakozva, MQTT csatlakozva, elérhető firmware-frissítés

### Szervizműveletek

Két szervizművelet érhető el:

- **Hangerő beállítása** — a riasztó hangjelzőjének hangereje állítható (1 = leghalkabb, 11 = leghangosabb) a `/settings?set_volume={value}` végponton keresztül
- **Önellenőrzés** — szenzor öndiagnosztikát indít (~30 másodperc) a `/self_test` végponton keresztül

### További képességek

A Shelly Gas a `/status` válaszában a szenzor üzemi állapotát (`normal` / `warmup` / `fault`), az önellenőrzés előrehaladását, a koncentráció érvényességi jelzőjét, a WiFi jelerősséget és a külső szelepmozgató vezérlését (11–13V, 500mA jack kimenet) is biztosítja. A némítás feloldó végpont (`/unmute`) elérhető a riasztó hangjelzőjének újra aktiválásához a némítás után. Ezek a képességek egy jövőbeli sablonfrissítésben adhatók hozzá.

## Hibaelhárítás

### Az eszköz nem válaszol

1. Ellenőrizd, hogy a Shelly csatlakozik a Wi-Fi-hez és érvényes IP-címe van
2. Próbáld az mDNS hosztnevet (`shellygas-AABBCCDDEE.local`) az IP-cím helyett — az IP megváltozhatott DHCP-megújítás után
3. Nyisd meg a `http://{device-ip}/shelly` címet a böngészőben — ha `SHGS-1` eszköztípussal válaszol, az eszköz elérhető
4. Ellenőrizd, hogy a TapHome CCU és a Shelly ugyanazon a hálózaton / VLAN-on van

### A gázkoncentráció mindig nullát mutat

1. Győződj meg róla, hogy a szenzor nincs bemelegedési módban — bekapcsolás után a szenzornak időre van szüksége a stabilizálódáshoz, mielőtt érvényes méréseket jelentene
2. Ellenőrizd a `concentration.is_valid` értéket a `/status` válaszban — ha `false`, a szenzor még melegszik
3. Győződj meg róla, hogy az eszköz megfelelően van elhelyezve (CNG változat a mennyezet közelében, LPG változat a padló közelében — a gáz sűrűségétől függően emelkedik vagy süllyed)

### A riasztás nem aktiválódik

1. A riasztási küszöbértékek rögzítettek: enyhe >= 1800 ppm, erős >= 3000 ppm — ezek alatti alacsony koncentrációk nem váltanak ki riasztást
2. Futtass önellenőrzést a TapHome-ból (szervizművelet) a szenzor és a hangjelző működésének ellenőrzéséhez
3. Ellenőrizd a `gas_sensor.sensor_state` mezőt a `/status` válaszban — ha `fault` értéket ad, a szenzor cserére szorulhat

> [!WARNING]
> A Gen1 Shelly eszközök csak **2 egyidejű HTTP kapcsolatot** támogatnak. Ha a TapHome és egy másik rendszer (pl. Home Assistant) egyszerre kérdezi le ugyanazt az eszközt, a kommunikáció megbízhatatlanná válhat. Használj 10–30 másodperces lekérdezési intervallumot.

## Telepítés a TapHome-ban

### Előfeltételek

- Shelly eszköz telepítve és bekapcsolva
- Helyi Wi-Fi hálózat (2,4 GHz)
- TapHome CCU ugyanazon a hálózaton

### 1. lépés — Shelly csatlakoztatása a Wi-Fi-hez

**A lehetőség — Shelly alkalmazás (ajánlott):**

1. Töltse le a [Shelly alkalmazást](https://www.shelly.com/en/support/shelly-app) (iOS / Android)
2. Érintse meg a **+** → **Add Device** gombot, és kövesse a Bluetooth párosítási varázslót
3. Adja meg Wi-Fi hitelesítő adatait, amikor a rendszer kéri

**B lehetőség — AP mód (alkalmazás nélkül):**

1. Első bekapcsoláskor az eszköz létrehoz egy hotspotot: `ShellyXXX-AABBCCDDEE`
2. Csatlakoztassa telefonját/PC-jét ehhez a hotspothoz
3. Nyissa meg a `http://192.168.33.1` címet → **Internet & Security** → **Wi-Fi Mode - Client**
4. Adja meg az SSID-t és a jelszót → **Save**

> [!NOTE]
> A Shelly csak **2,4 GHz**-es hálózatokat támogat. Az 5 GHz-es hálózatok nem jelennek meg a keresésben.

### 2. lépés — IP-cím megkeresése

A Wi-Fi-hez való csatlakozás után az alábbi módszerek egyikével keresse meg a hozzárendelt IP-címet:

- **Shelly alkalmazás:** Eszköz részletei → **Device info** → IP-cím
- **Shelly webes felület:** Csatlakozzon az eszköz AP-jához a Wi-Fi beállítás előtt — az IP a mentés után jelenik meg
- **Router DHCP tábla:** Keressen egy hasonló hosztnevet: `shelly1pm-AABBCCDDEE`
- **mDNS:** Pingelje a `shelly<model>-<mac>.local` címet (pl. `shelly1pm-AABBCCDDEE.local`) ugyanarról a hálózatról

> [!TIP]
> Rendeljen **statikus IP**-t (DHCP foglalást) a Shelly eszközhöz a routerben, hogy a cím ne változzon a router újraindítása után.

### 3. lépés — Konfigurálás a TapHome-ban

1. A TapHome-ban adjon hozzá egy új **Packet Parser (HTTP)** modult
2. **IP Address:** adja meg a 2. lépésben kapott IP-t (pl. `192.168.1.50`)
3. **Port:** `80` (alapértelmezett, nem kell módosítani)
4. Importálja a sablont — a TapHome rendszeresen lekérdezi a `/status` végpontot az eszköz állapotának olvasásához

> [!NOTE]
> A HTTP hitelesítés a Shelly eszközökön alapértelmezetten ki van kapcsolva. Ha engedélyezte a bejelentkezésvédelmet, a TapHome jelenleg nem támogatja a HTTP Basic Auth-ot — a TapHome integrációhoz hagyja kikapcsolva a hitelesítést.

## Elérhető eszközök 3

Ezek az eszközök az importálás után jelennek meg a TapHome-ban.

Shelly Gas Modul

Szerviz műveletek

|                    |
|--------------------|
| Hangerő beállítása |
| Önellenőrzés       |

Egyéni változók

|                                    |                                                               |
|------------------------------------|---------------------------------------------------------------|
| `deviceID` (string) = 10521CF2BA9B | A Shelly Gas Device ID-ja (MAC-cím hexában, pl. 10521CF2BA9B) |

Olvasás (modul)

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

Szerviz műveletek

Set Volume \[1 to 11]

Paraméterek: Volume \[1 to 11] (1–11 Volume)

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

Self test

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

Gázriasztó Többértékű kapcsoló Csak olvasható

Gázriasztó állapot — Nincs riasztás, Enyhe gázszivárgás (&gt;= 1800 ppm), Súlyos gázszivárgás (&gt;= 3000 ppm), Önellenőrzés, Ismeretlen

enum multi-value switch

Értékek / Állapotok: No alarm · Mild gas leak · Heavy gas leak · Alarm state is unknown · Self Test

Kapcsoló állapot olvasása

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

Kapcsoló állapot írása

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

Gázkoncentráció Változó Csak olvasható

Aktuális gázkoncentráció milliomod részekben (ppm)

numeric Egység: ppm

Olvasás

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

Írás

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

Olvasás (modul)

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

Aktív riasztás némítása Nyomógomb Olvasás és írás

Elnémítja a riasztó hangjelzőt a riasztási állapot törése nélkül

action push button

Gombállapot írása

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

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

Lehetséges fejlesztések (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

## Importálási paraméterek

Ezeket az értékeket az XML importálásakor adja meg.

| Az alkalmazás kéri | Alapérték     |
|--------------------|---------------|
| IP-cím             | `192.168.0.1` |

## Források

- 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

## Kapcsolódó dokumentáció

- [Packet Parser integráció](https://taphome.com/hu/compatibility/packet-parser-guide/)
- [Packet Parser (HTTP, TCP, UDP, FTP, MQTT)](https://taphome.com/hu/docs/integration/packet-parser/)
- [Packet parser függvények](https://taphome.com/hu/docs/script/packet-parser/)
- [Elemző függvények](https://taphome.com/hu/docs/script/parsing-functions/)