---
title: "Shelly Gas MQTT"
description: "Stav plynového alarmu a koncentrácia v ppm z detektora Shelly Gas CNG alebo LPG cez MQTT, plus akcia samotestu senzora. TapHome šablóna."
url: "https://taphome.com/sk/compatibility/shelly-gas-mqtt/"
language: sk
lastmod: 2026-10-08
generator: hugo
ai:
  topics: ["mqtt","sensor","wifi","gas-detection","safety"]
  questions: ["Ako integrovať Shelly Gas s TapHome cez MQTT?","Čo monitoruje šablóna Shelly Gas MQTT v TapHome?","Ako povoliť MQTT na Shelly Gas a nájsť jeho Device ID?","Pri akej koncentrácii v ppm sa spustí alarm Shelly Gas?","Prečo koncentrácia plynu v TapHome ukazuje -1?","Kam sa má umiestniť jednotka Shelly Gas CNG alebo LPG?"]
---

# Shelly Gas MQTT

Komunikácia: Packet Parser → MQTT

- [Produktová stránka Shelly Gas](https://www.shelly.com/en/products/shop/shelly-gas)

> Adresa v sieti
> 
> Pri MQTT brokeri vstavanom v TapHome zadajte v TapHome ako adresu brokera `127.0.0.1`. V zariadení zadajte IP adresu TapHome Core a jednotke Core dajte rezerváciu IP v routeri.
> 
> [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 horľavého plynu. Zapája sa priamo do zásuvky, priebežne meria koncentráciu plynu a pri prekročení prahu spustí vlastný zvukový a svetelný alarm. Predáva sa ako dva samostatné produkty — **Shelly Gas CNG** pre stlačený zemný plyn (metán) a **Shelly Gas LPG** pre skvapalnený ropný plyn (propán / bután). Oba majú rovnaký firmvér a rovnaké MQTT topicy, takže táto jedna šablóna funguje s oboma; líši sa len senzorový článok a odporúčaná výška montáže.

Táto šablóna sa pripája na MQTT brokera, nie priamo na zariadenie. Modul sa prihlási na odber `shellies/#` na brokeri a podľa Device ID vyfiltruje správy patriace konkrétnej jednotke Shelly Gas. TapHome prijíma stav alarmu a koncentráciu plynu tak, ako ich zariadenie publikuje, a dokáže spustiť samotest senzora.

> [!NOTE]
> K dispozícii je aj HTTP variant tejto šablóny (`Shelly Gas`). Túto MQTT šablónu použite, ak v inštalácii už beží MQTT broker a preferujete push aktualizácie; HTTP šablónu použite, ak broker nie je k dispozícii.

> [!WARNING]
> Shelly Gas je bezpečnostné zariadenie. Integrácia do TapHome dopĺňa jeho vstavaný bzučiak a LED alarm — nenahrádza ich. Bzučiak a LED fungujú nezávisle od MQTT, od brokera aj od riadiacej jednotky TapHome a fungujú aj vtedy, keď je ktorýkoľvek z nich nedostupný.

## Hardvér

### Umiestnenie

Jednotka sa zapája do sieťovej zásuvky — žiadna kabeláž nie je potrebná. Správna výška montáže závisí od variantu plynu, pretože oba plyny sa vo vzduchu správajú odlišne.

| Variant | Detegovaný plyn | Správanie vo vzduchu | Odporúčané umiestnenie |
|---------|-----------------|----------------------|------------------------|
| Shelly Gas CNG | Stlačený zemný plyn (metán) | Ľahší než vzduch, hromadí sa pri strope | 0,3–1 m pod stropom, zvisle, a 1,5 m od zdroja plynu |
| Shelly Gas LPG | Skvapalnený ropný plyn (propán / bután) | Ťažší než vzduch, hromadí sa pri podlahe | 0,3 m nad podlahou, do 1,5 m od zdroja plynu |

> [!WARNING]
> CNG a LPG sú dva samostatné produkty s odlišnými senzormi, nie prepínateľný režim. Ak nie je variant zrejmý, skontrolujte označenie na zadnej strane zariadenia.

### Špecifikácia

| Parameter | Hodnota |
|-----------|---------|
| Napájanie | 110–230 V ±10 %, 50/60 Hz AC |
| Príkon | < 3 W |
| Citlivosť alarmu | 6 % LEL (dolná medza výbušnosti) |
| Hlasitosť | ≥ 70 dB |
| Wi-Fi | 802.11 b/g/n, 2400–2484 MHz |
| Dosah | do 50 m vonku, do 30 m vnútri |
| Prevádzková teplota | −10 °C až +50 °C |
| Výstup konektora manipulátora ventilu | 11–13 V, 500 mA (externé príslušenstvo, táto šablóna ho neovláda) |
| Rozmery | 89,5 × 89,5 × 38 mm (bez zástrčky) |

### Lokálna signalizácia

LED prstenec a bzučiak sú vlastnou signalizáciou zariadenia. TapHome vidí len dva topicy popísané v časti Funkcie zariadenia, takže tieto signály nesú informácie, ktoré sa k riadiacej jednotke nedostanú.

| LED prstenec | Význam |
|--------------|--------|
| Svieti zeleno | Senzor v normálnej prevádzke |
| Svieti žlto | Porucha senzora |
| Bliká červeno | Alarm |
| Bliká červeno / žlto / zeleno v slede | Senzor sa zahrieva |

| Vzor bzučiaka | Udalosť |
|---------------|---------|
| Dve krátke pípnutia za sekundu | Zahrievanie sa spustilo po zapnutí |
| Jedno dlhé pípnutie za sekundu | Zahrievanie skončilo |
| Dlhé pípnutie raz za sekundu, kým porucha trvá | Porucha senzora |
| Tri krátke pípnutia dvakrát za sekundu | Prebieha samotest |
| Dlhé pípnutie raz za sekundu | Samotest úspešne dokončený |
| Dlhé pípnutie raz za sekundu, kým únik netrvá alebo sa nezhorší | Mierny únik plynu |
| Päť sekúnd pípania so sekundovou pauzou, kým únik netrvá | Silný únik plynu |

Po zapnutí sa senzor približne tri minúty zahrieva. LED prstenec počas toho postupne bliká červenou / žltou / zelenou a údaj o plyne nie je platný.

## Konfigurácia

### Povolenie MQTT na zariadení

1. Otvorte webové rozhranie zariadenia v prehliadači.
2. Prejdite do **Internet and Security** → **Advanced - Developer Settings**.
3. Zaškrtnite **Enable action execution via MQTT**.
4. Do poľa **Server** zadajte hodnotu podľa vzorca `{IP adresa MQTT brokera}:{port}` — napríklad `192.168.1.10:1883`.
5. Stlačte **SAVE**. Zariadenie sa znovu pripojí a začne publikovať na brokera.

> [!WARNING]
> Na firmvéri Gen1 povolenie MQTT vypne pripojenie k Shelly Cloud — obe naraz fungovať nemôžu. Zariadenia Gen1 tiež nepodporujú MQTT cez TLS, takže broker musí prijímať nešifrované MQTT na porte 1883. Brokera preto držte v dôveryhodnej lokálnej sieti.

### Zistenie Device ID

Vo webovom rozhraní prejdite do **Settings** → **Device Info** → **Device ID**. Potrebná je prvá skupina znakov, nie hodnota v zátvorkách. Ide o Shelly-ID so šiestimi alebo viacerými znakmi, napríklad `35FA58`. Rovnaký identifikátor sa objaví aj vo Wi-Fi sieti, ktorú zariadenie vytvorí v režime prístupového bodu (`ShellyGas-35FA58`), a tvorí prefix MQTT topicu `shellies/shellygas-35FA58/`.

### Nastavenie šablóny

Šablóna si vyžiada tri importné parametre:

| Importný parameter | Predvolené | Hodnota na zadanie |
|--------------------|------------|--------------------|
| Mqtt Broker IP address | `192.168.0.1` | IP adresa MQTT brokera — **nie** zariadenia Shelly Gas |
| Mqtt Broker port | `1883` | Port, na ktorom broker počúva |
| Device ID | — | Shelly-ID zistené vyššie, napr. `35FA58` |

Importný parameter Device ID naplní premennú `deviceID` na úrovni modulu, ktorá zostavuje prefix pre každý topic, ktorý modul používa. Modul sa prihlási na odber `shellies/#` a jeho listener skripty filtrujú prichádzajúce správy podľa tohto prefixu.

Zariadenie predvolene publikuje aktualizáciu každých 30 sekúnd. Nastavením parametra zariadenia `mqtt_update_period` na `0` prejde na hlásenie len pri zmene.

## Funkcie zariadenia

### Plynový alarm

**Plynový alarm** je viachodnotový prepínač napájaný z `shellies/shellygas-<deviceID>/sensor/gas`. Nesie úroveň alarmu, ktorú zariadenie už odvodilo z nameranej koncentrácie.

| Hodnota v TapHome | MQTT payload | Význam |
|-------------------|--------------|--------|
| Žiadny alarm | `none` | Koncentrácia pod 1800 ppm |
| Mierny únik plynu | `mild` | Koncentrácia od 1800 ppm |
| Silný únik plynu | `heavy` | Koncentrácia od 3000 ppm |
| Samotest | `test` | Publikované po úspešnom samoteste |
| Stav alarmu je neznámy | `unknown` alebo iný payload | Zariadenie nevie určiť úroveň alarmu |

Oba prahy sú pevne dané firmvérom zariadenia a nedajú sa zmeniť.

### Koncentrácia plynu

**Koncentrácia plynu** číta surovú hodnotu z `shellies/shellygas-<deviceID>/sensor/concentration` v milióntinách, v rozsahu 0–65535 ppm. Ide o to isté fyzikálne meranie ako pri Plynovom alarme, ešte pred aplikovaním firmvérových prahov.

> [!TIP]
> Plynový alarm použite na logiku alarmov a Koncentráciu plynu na trendy, grafy a vlastné skoré varovania pod 1800 ppm. Pravidlo by si nemalo odvodzovať vlastnú úroveň alarmu z hodnoty v ppm a očakávať, že sa zhodne so zariadením — bzučiak a LED sa riadia pevnými firmvérovými prahmi.

> [!NOTE]
> Zariadenie publikuje na topicu koncentrácie hodnotu `-1` vždy, keď meranie nie je platné — počas približne trojminútového zahrievania po zapnutí a počas poruchy senzora. Šablóna toto `-1` ukladá tak, ako je; nejde o chybový kód TapHome.

### Samotest

Modul poskytuje servisnú akciu **Samotest**, ktorá publikuje na `shellies/shellygas-<deviceID>/sensor/start_self_test`. Zariadenie počas testu pípa tri krátke pípnutia dvakrát za sekundu a po úspechu publikuje `test` na topicu plynu, čo sa v TapHome prejaví ako hodnota **Samotest** Plynového alarmu.

## Známe obmedzenia

### Stlmenie aktívneho alarmu sa k zariadeniu nedostane

Šablóna obsahuje tlačidlo **Stlmiť aktívny alarm**, ale v aktuálnej revízii šablóny nemá žiadny účinok. Tlačidlo publikuje na doslovný topic `shellies/shellygas-<deviceid>/sensor/mute` — zástupný text `<deviceid>` sa nikdy nenahradí nastaveným Device ID, takže správa ide na topic, ktorý žiadne reálne zariadenie neodoberá. Zvyšné tri topicy v tej istej šablóne si prefix zostavujú z premennej `deviceID` správne.

> [!WARNING]
> Na tlačidlo Stlmiť aktívny alarm sa nespoliehajte. Stlmenie aktívneho alarmu z TapHome bude fungovať až po oprave šablóny tak, aby topic zostavovala z premennej `deviceID`. Alarm sa vždy dá stlmiť priamo na zariadení voľbou **Mute** v jeho webovom rozhraní — a to len počas skutočne aktívneho alarmu.

## Riešenie problémov

### Do TapHome neprichádzajú žiadne hodnoty

1. Overte, že MQTT je na zariadení povolené a pole **Server** obsahuje adresu brokera v tvare `{IP}:{port}`
2. Skontrolujte, že endpoint modulu smeruje na **MQTT brokera**, nie na IP adresu Shelly Gas
3. Potvrďte, že Device ID presne zodpovedá tomu, čo ukazuje **Settings** → **Device Info** → **Device ID** — len prvá skupina znakov, bez hodnoty v zátvorkách
4. Prihláste sa MQTT klientom (napríklad MQTT Explorer) na odber `shellies/#` a skontrolujte, že správy prichádzajú pod `shellies/shellygas-<vaše-id>/`
5. Ak bolo zariadenie prepnuté na hlásenie len pri zmene (`mqtt_update_period = 0`), spustite servisnú akciu **Samotest** — úspešný test publikuje na topicu plynu

### Koncentrácia plynu ukazuje -1

Meranie senzora nie je platné. Zariadenie sa buď ešte zahrieva — približne tri minúty po zapnutí — alebo má senzor poruchu. Porucha sa na zariadení prejaví trvalo svietiacou žltou LED a dlhým pípnutím raz za sekundu. Táto šablóna topic so stavom senzora nečíta, takže porucha sa do TapHome dostane len ako toto `-1`.

### Plynový alarm ukazuje „Stav alarmu je neznámy"

Táto hodnota je záložnou vetvou šablóny. Zachytáva zdokumentovaný payload `unknown` aj akýkoľvek payload mimo štyroch známych hodnôt. Skontrolujte LED prstenec na zariadení, aby ste zistili, v akom stave senzor skutočne je.

### Zariadenie zmizlo zo Shelly Cloud

Na firmvéri Gen1 očakávané — povolenie MQTT vypína pripojenie ku cloudu. Do webového rozhrania sa dostanete cez lokálnu sieť, pomocou IP adresy zariadenia alebo mDNS hostname `shellygas-<MAC>.local`.

## Ako nainštalovať v TapHome

### Predpoklady

- Zariadenie Shelly pripojené k Wi-Fi (2,4 GHz), napr. cez aplikáciu Shelly alebo vlastný prístupový bod zariadenia
- MQTT broker bežiaci vo vašej lokálnej sieti (napr. Mosquitto, Home Assistant alebo vstavaný broker TapHome)
- TapHome CCU v rovnakej sieti ako broker

> [!WARNING]
> Na zariadeniach **Gen1** povolenie MQTT **vypne Shelly Cloud**. Oboje nemôže bežať súčasne. Na zariadeniach Gen2/Plus toto obmedzenie neplatí.

### Krok 1 — Povoľte MQTT na zariadení Shelly

#### Zariadenia Gen1 (Shelly 1, 1PM, 2.5, EM, 3EM, Plug S, RGBW2, Dimmer, TRV…)

1. Otvorte webové rozhranie Shelly: `http://<device-ip>/`
2. Prejdite na **Internet & Security** → **Advanced — MQTT**
3. Povoľte **MQTT**
4. Nastavte **MQTT Server**: `<broker-ip>:<port>` (napr. `192.168.1.10:1883`)
5. Voliteľne nastavte **MQTT User** a **MQTT Password**, ak váš broker vyžaduje autentifikáciu
6. Kliknite na **Save** — zariadenie sa reštartuje a pripojí k brokeru

#### Zariadenia Gen2 / Plus (Shelly Plus 1, Plus 1PM, Plus 2PM, Plus Plug S, Plus H&T, Pro 3EM…)

1. Otvorte webové rozhranie Shelly: `http://<device-ip>/`
2. Prejdite na **Settings** → **MQTT**
3. Povoľte **MQTT**
4. Nastavte **Server**: `<broker-ip>:<port>` (napr. `192.168.1.10:1883`)
5. **Client ID** je predvyplnené ID zariadenia (napr. `shellyplus1pm-AABBCCDDEE`) — ponechajte tak, pokiaľ nemáte konkrétny dôvod na zmenu
6. Kliknite na **Save** a reštartujte zariadenie

Pri vstavanom brokeri TapHome je `<broker-ip>` IP adresa TapHome Core. Dajte jednotke Core rezerváciu IP v routeri, inak zariadenie stratí broker, keď router adresu zmení → [Príprava siete](https://taphome.com/sk/docs/setup/network-preparation/).

> [!TIP]
> Na overenie funkčnosti MQTT použite MQTT klienta (napr. MQTT Explorer) a prihláste sa na odber `shellies/#` (Gen1) alebo `<device-id>/#` (Gen2). Mali by ste vidieť stavové správy zo zariadenia.

### Krok 2 — Zistite Device ID / MQTT Client ID

Niektoré šablóny vyžadujú parameter **Device ID** alebo **MQTT Client ID**. Ide o jedinečný identifikátor používaný v MQTT topicoch.

- **Gen1:** nachádza sa na štítku ako MAC adresa (napr. `AABBCCDDEE`). Device ID = `shelly<model>-<mac>`, napr. `shelly1pm-AABBCCDDEE`
- **Gen2/Plus:** nachádza sa vo webovom rozhraní Shelly v časti **Settings** → **Device Info** → **Device ID**, alebo na štítku zariadenia

### Krok 3 — Konfigurácia v TapHome

1. V TapHome pridajte nový modul **Packet Parser (MQTT)**
2. **IP Address:** pre vstavaný broker TapHome `127.0.0.1` (jednotka sa pripája sama k sebe, adresa sa nikdy nezmení); pre externý broker jeho IP adresa (napr. `192.168.1.10`)
3. **Port:** `1883` (predvolený; pre TLS použite `8883`)
4. **Device ID / MQTT Client ID:** zadajte hodnotu z kroku 2 (ak to šablóna vyžaduje)
5. Importujte šablónu — TapHome sa automaticky prihlási na odber topicov zariadenia

## Dostupné zariadenia 3

Tieto zariadenia sa po importe zobrazia v TapHome.

Shelly Gas MQTT Modul

Servisné akcie

|          |                                                                                                                                    |
|----------|------------------------------------------------------------------------------------------------------------------------------------|
| Samotest | Spustí samotest senzora na zariadení — bzučiak pípne trikrát dvakrát za sekundu a po úspešnom teste Plynový alarm ohlási Samotest. |

Vlastné premenné

`deviceID` (string) Shelly-ID jednotky Shelly Gas — reťazec so šiestimi alebo viacerými znakmi, ktorý tvorí prefix MQTT topicu shellies/shellygas-&lt;deviceID&gt;/ (napr. 35FA58). Zistíte ho vo webovom rozhraní Shelly v Settings → Device Info → Device ID.

Open the Shelly web interface → Settings → Device Info → Device ID and copy the first string of characters (not the value in brackets). The template asks for it as the 'Device ID' import parameter.

Servisné akcie

Self test

```taphome
mqttpublish("shellies/shellygas-"+deviceID+"/sensor/start_self_test","1");
```

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

Úroveň alarmu hlásená senzorom — Žiadny alarm, Mierny únik plynu (od 1800 ppm), Silný únik plynu (od 3000 ppm), Samotest alebo Stav alarmu je neznámy. Prahy sú pevne dané firmvérom zariadenia a nedajú sa zmeniť.

enum multi-value switch

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

Čítanie stavu prepínača

```taphome
# Simple HTTP Request:
# VAR response := SENDHTTPREQUEST("/example/getValue");
# IF response.IsSuccess
#  VAR content := response.Content;
#  VAR responseHeaders := response.Headers;
#  RETURN(PARSEXML(content, "//element1/value1"));
# ELSE
#  ADDERROR(response.StatusCode + " (" + response.ReasonPhrase + ")");
#  RETURN(NaN);
# END
#
# Set Http request method, body and headers
# VAR response := SENDHTTPREQUEST("/example/getValue", "GET", "some data", "header1:value1", "header2:value2", ...);
# OR
# VAR request := HTTPREQUEST("/example/getValue", "POST", "some data");
# request.headers := { "header1:value1", "header2:value2", ...};
# request.method := "GET";
# request.data := null;
# VAR response := SENDHTTPREQUEST(request);
#
#
# Send TCP, UDP data:
# VAR data1 := BYTECOLLECTION("0a bb ea df 01");
# SENDDATA(data1);
# VAR data2 := "{\"name\":\"John\", \"age\":32}";
# SENDDATA(data2);
# VAR data3 := TOBYTES("{\"name\":\"John\", \"age\":32}", "iso-8859-1");
# SENDDATA(data3);
# Process received TCP or UDP data and set device values in the Listener script
#
#
# Download data from FTP:
# FTPDOWNLOAD("filePath");
```

Zápis stavu prepínača

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

Listener

```taphome
# Parse received bytes:
IF(RECEIVEDMSG.TOPIC = "shellies/shellygas-"+deviceID+"/sensor/gas")
 switch(TOSTRING(RECEIVEDMSG.PAYLOAD),
 "none", Mu := 0,
 "mild",Mu := 1,
 "heavy",Mu := 2,
 "test", Mu := 3,
 Mu := 4);
END
```

Koncentrácia plynu Premenná Len na čítanie

Nameraná koncentrácia horľavého plynu v milióntinách, rozsah 0–65535 ppm. Počas zahrievania senzora alebo pri jeho poruche zariadenie hlási -1.

numeric Jednotka: 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
# Simple HTTP Request:
# VAR response := SENDHTTPREQUEST("/example/getValue");
# IF response.IsSuccess
#  VAR content := response.Content;
#  VAR responseHeaders := response.Headers;
#  RETURN(PARSEXML(content, "//element1/value1"));
# ELSE
#  ADDERROR(response.StatusCode + " (" + response.ReasonPhrase + ")");
#  RETURN(NaN);
# END
#
# Set Http request method, body and headers
# VAR response := SENDHTTPREQUEST("/example/getValue", "GET", "some data", "header1:value1", "header2:value2", ...);
# OR
# VAR request := HTTPREQUEST("/example/getValue", "POST", "some data");
# request.headers := { "header1:value1", "header2:value2", ...};
# request.method := "GET";
# request.data := null;
# VAR response := SENDHTTPREQUEST(request);
#
#
# Send TCP, UDP data:
# VAR data1 := BYTECOLLECTION("0a bb ea df 01");
# SENDDATA(data1);
# VAR data2 := "{\"name\":\"John\", \"age\":32}";
# SENDDATA(data2);
# VAR data3 := TOBYTES("{\"name\":\"John\", \"age\":32}", "iso-8859-1");
# SENDDATA(data3);
# Process received TCP or UDP data and set device values in the Listener script
#
#
# Download data from FTP:
# FTPDOWNLOAD("filePath");
```

Listener

```taphome
# Parse received bytes:
IF(RECEIVEDMSG.TOPIC = "shellies/shellygas-"+deviceID+"/sensor/concentration")
 Va := todouble(TOSTRING(RECEIVEDMSG.PAYLOAD));
END
```

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

Tlačidlo určené na stlmenie práve aktívneho alarmu. V aktuálnej revízii šablóny nemá žiadny účinok — topic, na ktorý publikuje, sa nezostavuje z nastaveného Device ID.

action push button

Zápis stavu tlačidla

```taphome
MQTTPUBLISH("shellies/shellygas-<deviceid>/sensor/mute","1");

# Simple HTTP Request:
# VAR response := SENDHTTPREQUEST("/example/set/value=" + Bp);
# IF response.IsSuccess = false
#  ADDERROR(response.StatusCode);
# END
#
# Set Http request method, body and headers
# VAR response := SENDHTTPREQUEST("/example/setValue", "GET", "value=" + Bp, "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\":" + Bp + "}";
# SENDDATA(data1);
# VAR data2 := TOBYTES("{\"name\":\"John\", \"age\":" + Bp + "}", "iso-8859-1");
# SENDDATA(data2);
# You can process received TCP or UDP data in the Listener script
#
#
# Upload data to FTP:
# FTPUPLOAD("filePath", "somedata=" + Bp, "write"); # use "append" mode to append data to existing file
```

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

Možné vylepšenia (6)

- Sensor state — unknown | warmup | normal | fault — the template does not read it, so a sensor fault does not surface as its own state in TapHome (only indirectly as -1 on the concentration).
- Self-test state — not\_completed | completed | running | pending — the self-test can be started from TapHome, but its progress is not read back.
- Unmute alarm — Any payload unmutes an active alarm. Not published by the template.
- Valve state — unknown | closed | opened | not\_connected | failure | closing | opening | checking — state of the optional external valve manipulator (11–13 V, 500 mA jack).
- Valve control — Accepts the literal payloads 'open' or 'close'. The template does not publish it — this template offers no valve control at all.
- Connection status — Last Will and Testament topic — true on connect, false on disconnect. Could detect an offline sensor.

## Parametre importu

Tieto hodnoty zadáte pri importe XML.

| Pýta sa v aplikácii   | Predvolené         |
|-----------------------|--------------------|
| Mqtt Broker IP adresa | `192.168.0.1`      |
| Mqtt Broker port      | `1883`             |
| Device ID             | Zadáte pri importe |

## 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 MQTT API
  
  [shelly-api-docs.shelly.cloud](https://shelly-api-docs.shelly.cloud/gen1/#shelly-gas) 2026-08-25
- Shelly Gas — Knowledge Base Specification
  
  [kb.shelly.cloud](https://kb.shelly.cloud/knowledge-base/shelly-gas) 2026-08-25
- Shelly Gas Sensor PPM Threshold
  
  [support.shelly.cloud](https://support.shelly.cloud/en/support/solutions/articles/103000226300-shelly-gas-sensor-ppm-threshold) 2026-08-25
- Shelly Gas User and Safety Guide
  
  [kb.shelly.cloud](https://kb.shelly.cloud/knowledge-base/shelly-gas) 2026-08-25
  
  [PDF](https://taphome.com/compatibility/devices/shelly-gas-mqtt/manufacturer/user-guide.pdf)

Dokumenty výrobcov sú © ich príslušných vlastníkov. Poskytujeme ich tak, ako ich zverejnil výrobca, len na informačné účely.

## Súvisiaca dokumentácia

- [MQTT Integration](https://taphome.com/sk/compatibility/mqtt-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/)
- [MQTT broker](https://taphome.com/sk/docs/integration/packet-parser/mqtt-broker/)
- [Listener skripty](https://taphome.com/sk/docs/script/listener-scripts/)

