---
title: "Shelly Gas MQTT"
description: "Stav plynového alarmu a koncentrace v ppm z detektoru Shelly Gas CNG nebo LPG přes MQTT, plus akce samotestu senzoru. TapHome šablona."
url: "https://taphome.com/cs/compatibility/shelly-gas-mqtt/"
language: cs
lastmod: 2026-10-08
generator: hugo
ai:
  topics: ["mqtt","sensor","wifi","gas-detection","safety"]
  questions: ["Jak integrovat Shelly Gas s TapHome přes MQTT?","Co monitoruje šablona Shelly Gas MQTT v TapHome?","Jak povolit MQTT na Shelly Gas a najít jeho Device ID?","Při jaké koncentraci v ppm se spustí alarm Shelly Gas?","Proč koncentrace plynu v TapHome ukazuje -1?","Kam se má umístit jednotka Shelly Gas CNG nebo LPG?"]
---

# Shelly Gas MQTT

Komunikace: Packet Parser → MQTT

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

> Adresa v síti
> 
> U MQTT brokeru vestavěného v TapHome zadejte v TapHome jako adresu brokeru `127.0.0.1`. V zařízení zadejte IP adresu TapHome Core a jednotce Core dejte rezervaci IP v routeru.
> 
> [Příprava sítě](https://taphome.com/cs/docs/setup/network-preparation/)

## Návod na integraci

Shelly Gas (model SHGS-1) je síťově napájený Wi-Fi detektor hořlavého plynu. Zapojuje se přímo do zásuvky, průběžně měří koncentraci plynu a při překročení prahu spustí vlastní zvukový a světelný alarm. Prodává se jako dva samostatné produkty — **Shelly Gas CNG** pro stlačený zemní plyn (metan) a **Shelly Gas LPG** pro zkapalněný ropný plyn (propan / butan). Oba mají stejný firmware a stejné MQTT topicy, takže tato jedna šablona funguje s oběma; liší se pouze senzorový článek a doporučená výška montáže.

Tato šablona se připojuje k MQTT brokeru, nikoli přímo k zařízení. Modul se přihlásí k odběru `shellies/#` na brokeru a podle Device ID vyfiltruje zprávy patřící konkrétní jednotce Shelly Gas. TapHome přijímá stav alarmu a koncentraci plynu tak, jak je zařízení publikuje, a umí spustit samotest senzoru.

> [!NOTE]
> K dispozici je i HTTP varianta této šablony (`Shelly Gas`). Tuto MQTT šablonu použijte, pokud v instalaci již běží MQTT broker a preferujete push aktualizace; HTTP šablonu použijte, pokud broker není k dispozici.

> [!WARNING]
> Shelly Gas je bezpečnostní zařízení. Integrace do TapHome doplňuje jeho vestavěný bzučák a LED alarm — nenahrazuje je. Bzučák a LED fungují nezávisle na MQTT, na brokeru i na řídicí jednotce TapHome a fungují i tehdy, když je kterýkoli z nich nedostupný.

## Hardware

### Umístění

Jednotka se zapojuje do síťové zásuvky — žádná kabeláž není potřeba. Správná výška montáže závisí na variantě plynu, protože oba plyny se ve vzduchu chovají odlišně.

| Varianta | Detekovaný plyn | Chování ve vzduchu | Doporučené umístění |
|----------|-----------------|--------------------|---------------------|
| Shelly Gas CNG | Stlačený zemní plyn (metan) | Lehčí než vzduch, hromadí se u stropu | 0,3–1 m pod stropem, svisle, a 1,5 m od zdroje plynu |
| Shelly Gas LPG | Zkapalněný ropný plyn (propan / butan) | Těžší než vzduch, hromadí se u podlahy | 0,3 m nad podlahou, do 1,5 m od zdroje plynu |

> [!WARNING]
> CNG a LPG jsou dva samostatné produkty s odlišnými senzory, nikoli přepínatelný režim. Pokud varianta není zřejmá, zkontrolujte označení na zadní straně zařízení.

### Specifikace

| Parametr | Hodnota |
|----------|---------|
| Napájení | 110–230 V ±10 %, 50/60 Hz AC |
| Příkon | < 3 W |
| Citlivost alarmu | 6 % LEL (dolní mez výbušnosti) |
| Hlasitost | ≥ 70 dB |
| Wi-Fi | 802.11 b/g/n, 2400–2484 MHz |
| Dosah | do 50 m venku, do 30 m uvnitř |
| Provozní teplota | −10 °C až +50 °C |
| Výstup konektoru manipulátoru ventilu | 11–13 V, 500 mA (externí příslušenství, tato šablona jej neovládá) |
| Rozměry | 89,5 × 89,5 × 38 mm (bez zástrčky) |

### Lokální signalizace

LED prstenec a bzučák jsou vlastní signalizací zařízení. TapHome vidí pouze dva topicy popsané v části Funkce zařízení, takže tyto signály nesou informace, které se k řídicí jednotce nedostanou.

| LED prstenec | Význam |
|--------------|--------|
| Svítí zeleně | Senzor v normálním provozu |
| Svítí žlutě | Porucha senzoru |
| Bliká červeně | Alarm |
| Bliká červeně / žlutě / zeleně v sledu | Senzor se zahřívá |

| Vzor bzučáku | Událost |
|--------------|---------|
| Dvě krátká pípnutí za sekundu | Zahřívání se spustilo po zapnutí |
| Jedno dlouhé pípnutí za sekundu | Zahřívání skončilo |
| Dlouhé pípnutí jednou za sekundu, dokud porucha trvá | Porucha senzoru |
| Tři krátká pípnutí dvakrát za sekundu | Probíhá samotest |
| Dlouhé pípnutí jednou za sekundu | Samotest úspěšně dokončen |
| Dlouhé pípnutí jednou za sekundu, dokud únik trvá nebo se nezhorší | Mírný únik plynu |
| Pět sekund pípání se sekundovou pauzou, dokud únik trvá | Silný únik plynu |

Po zapnutí se senzor přibližně tři minuty zahřívá. LED prstenec během toho postupně bliká červenou / žlutou / zelenou a údaj o plynu není platný.

## Konfigurace

### Povolení MQTT na zařízení

1. Otevřete webové rozhraní zařízení v prohlížeči.
2. Přejděte do **Internet and Security** → **Advanced - Developer Settings**.
3. Zaškrtněte **Enable action execution via MQTT**.
4. Do pole **Server** zadejte hodnotu podle vzorce `{IP adresa MQTT brokeru}:{port}` — například `192.168.1.10:1883`.
5. Stiskněte **SAVE**. Zařízení se znovu připojí a začne publikovat na brokera.

> [!WARNING]
> Na firmwaru Gen1 povolení MQTT vypne připojení k Shelly Cloud — obojí naráz fungovat nemůže. Zařízení Gen1 také nepodporují MQTT přes TLS, takže broker musí přijímat nešifrované MQTT na portu 1883. Brokera proto držte v důvěryhodné lokální síti.

### Zjištění Device ID

Ve webovém rozhraní přejděte do **Settings** → **Device Info** → **Device ID**. Potřebná je první skupina znaků, nikoli hodnota v závorkách. Jde o Shelly-ID se šesti nebo více znaky, například `35FA58`. Stejný identifikátor se objeví i ve Wi-Fi síti, kterou zařízení vytvoří v režimu přístupového bodu (`ShellyGas-35FA58`), a tvoří prefix MQTT topicu `shellies/shellygas-35FA58/`.

### Nastavení šablony

Šablona si vyžádá tři importní parametry:

| Importní parametr | Výchozí | Hodnota k zadání |
|-------------------|---------|------------------|
| Mqtt Broker IP address | `192.168.0.1` | IP adresa MQTT brokeru — **nikoli** zařízení Shelly Gas |
| Mqtt Broker port | `1883` | Port, na kterém broker naslouchá |
| Device ID | — | Shelly-ID zjištěné výše, např. `35FA58` |

Importní parametr Device ID naplní proměnnou `deviceID` na úrovni modulu, která sestavuje prefix pro každý topic, který modul používá. Modul se přihlásí k odběru `shellies/#` a jeho listener skripty filtrují příchozí zprávy podle tohoto prefixu.

Zařízení výchozím nastavením publikuje aktualizaci každých 30 sekund. Nastavením parametru zařízení `mqtt_update_period` na `0` přejde na hlášení pouze při změně.

## Funkce zařízení

### Plynový alarm

**Plynový alarm** je vícehodnotový přepínač napájený z `shellies/shellygas-<deviceID>/sensor/gas`. Nese úroveň alarmu, kterou zařízení již odvodilo z naměřené koncentrace.

| Hodnota v TapHome | MQTT payload | Význam |
|-------------------|--------------|--------|
| Žádný alarm | `none` | Koncentrace pod 1800 ppm |
| Mírný únik plynu | `mild` | Koncentrace od 1800 ppm |
| Silný únik plynu | `heavy` | Koncentrace od 3000 ppm |
| Samotest | `test` | Publikováno po úspěšném samotestu |
| Stav alarmu je neznámý | `unknown` nebo jiný payload | Zařízení neumí určit úroveň alarmu |

Oba prahy jsou pevně dané firmwarem zařízení a nelze je změnit.

### Koncentrace plynu

**Koncentrace plynu** čte surovou hodnotu z `shellies/shellygas-<deviceID>/sensor/concentration` v milióntinách, v rozsahu 0–65535 ppm. Jde o stejné fyzikální měření jako u Plynového alarmu, ještě před aplikováním firmwarových prahů.

> [!TIP]
> Plynový alarm použijte pro logiku alarmů a Koncentraci plynu pro trendy, grafy a vlastní časná varování pod 1800 ppm. Pravidlo by si nemělo odvozovat vlastní úroveň alarmu z hodnoty v ppm a očekávat, že se shodne se zařízením — bzučák a LED se řídí pevnými firmwarovými prahy.

> [!NOTE]
> Zařízení publikuje na topicu koncentrace hodnotu `-1` vždy, když měření není platné — během přibližně tříminutového zahřívání po zapnutí a během poruchy senzoru. Šablona toto `-1` ukládá tak, jak je; nejde o chybový kód TapHome.

### Samotest

Modul poskytuje servisní akci **Samotest**, která publikuje na `shellies/shellygas-<deviceID>/sensor/start_self_test`. Zařízení během testu pípá tři krátká pípnutí dvakrát za sekundu a po úspěchu publikuje `test` na topicu plynu, což se v TapHome projeví jako hodnota **Samotest** Plynového alarmu.

## Známá omezení

### Ztlumení aktivního alarmu se k zařízení nedostane

Šablona obsahuje tlačítko **Ztlumit aktivní alarm**, ale v aktuální revizi šablony nemá žádný účinek. Tlačítko publikuje na doslovný topic `shellies/shellygas-<deviceid>/sensor/mute` — zástupný text `<deviceid>` se nikdy nenahradí nastaveným Device ID, takže zpráva jde na topic, který žádné reálné zařízení neodebírá. Zbývající tři topicy ve stejné šabloně si prefix sestavují z proměnné `deviceID` správně.

> [!WARNING]
> Na tlačítko Ztlumit aktivní alarm se nespoléhejte. Ztlumení aktivního alarmu z TapHome bude fungovat až po opravě šablony tak, aby topic sestavovala z proměnné `deviceID`. Alarm lze vždy ztlumit přímo na zařízení volbou **Mute** v jeho webovém rozhraní — a to pouze během skutečně aktivního alarmu.

## Řešení problémů

### Do TapHome nepřicházejí žádné hodnoty

1. Ověřte, že MQTT je na zařízení povoleno a pole **Server** obsahuje adresu brokeru ve tvaru `{IP}:{port}`
2. Zkontrolujte, že endpoint modulu směřuje na **MQTT brokera**, nikoli na IP adresu Shelly Gas
3. Potvrďte, že Device ID přesně odpovídá tomu, co ukazuje **Settings** → **Device Info** → **Device ID** — pouze první skupina znaků, bez hodnoty v závorkách
4. Přihlaste se MQTT klientem (například MQTT Explorer) k odběru `shellies/#` a zkontrolujte, že zprávy přicházejí pod `shellies/shellygas-<vaše-id>/`
5. Pokud bylo zařízení přepnuto na hlášení pouze při změně (`mqtt_update_period = 0`), spusťte servisní akci **Samotest** — úspěšný test publikuje na topicu plynu

### Koncentrace plynu ukazuje -1

Měření senzoru není platné. Zařízení se buď ještě zahřívá — přibližně tři minuty po zapnutí — nebo má senzor poruchu. Porucha se na zařízení projeví trvale svítící žlutou LED a dlouhým pípnutím jednou za sekundu. Tato šablona topic se stavem senzoru nečte, takže porucha se do TapHome dostane pouze jako toto `-1`.

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

Tato hodnota je záložní větví šablony. Zachytává zdokumentovaný payload `unknown` i jakýkoli payload mimo čtyři známé hodnoty. Zkontrolujte LED prstenec na zařízení, abyste zjistili, v jakém stavu senzor skutečně je.

### Zařízení zmizelo ze Shelly Cloud

Na firmwaru Gen1 očekávané — povolení MQTT vypíná připojení ke cloudu. Do webového rozhraní se dostanete přes lokální síť, pomocí IP adresy zařízení nebo mDNS hostname `shellygas-<MAC>.local`.

## Jak nainstalovat v TapHome

### Předpoklady

- Zařízení Shelly připojené k Wi-Fi (2,4 GHz), např. přes aplikaci Shelly nebo vlastní přístupový bod zařízení
- MQTT broker běžící ve vaší lokální síti (např. Mosquitto, Home Assistant nebo vestavěný broker TapHome)
- TapHome CCU ve stejné síti jako broker

> [!WARNING]
> Na zařízeních **Gen1** povolení MQTT **vypne Shelly Cloud**. Obojí nemůže běžet současně. Na zařízeních Gen2/Plus toto omezení neplatí.

### Krok 1 — Povolte MQTT na zařízení Shelly

#### Zařízení Gen1 (Shelly 1, 1PM, 2.5, EM, 3EM, Plug S, RGBW2, Dimmer, TRV…)

1. Otevřete webové rozhraní Shelly: `http://<device-ip>/`
2. Přejděte na **Internet & Security** → **Advanced — MQTT**
3. Povolte **MQTT**
4. Nastavte **MQTT Server**: `<broker-ip>:<port>` (např. `192.168.1.10:1883`)
5. Volitelně nastavte **MQTT User** a **MQTT Password**, pokud váš broker vyžaduje autentifikaci
6. Klikněte na **Save** — zařízení se restartuje a připojí k brokeru

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

1. Otevřete webové rozhraní Shelly: `http://<device-ip>/`
2. Přejděte na **Settings** → **MQTT**
3. Povolte **MQTT**
4. Nastavte **Server**: `<broker-ip>:<port>` (např. `192.168.1.10:1883`)
5. **Client ID** je předvyplněné ID zařízení (např. `shellyplus1pm-AABBCCDDEE`) — ponechte tak, pokud nemáte konkrétní důvod ke změně
6. Klikněte na **Save** a restartujte zařízení

U vestavěného brokeru TapHome je `<broker-ip>` IP adresa TapHome Core. Dejte jednotce Core rezervaci IP v routeru, jinak zařízení ztratí broker, když router adresu změní → [Příprava sítě](https://taphome.com/cs/docs/setup/network-preparation/).

> [!TIP]
> Pro ověření funkčnosti MQTT použijte MQTT klienta (např. MQTT Explorer) a přihlaste se k odběru `shellies/#` (Gen1) nebo `<device-id>/#` (Gen2). Měli byste vidět stavové zprávy ze zařízení.

### Krok 2 — Zjistěte Device ID / MQTT Client ID

Některé šablony vyžadují parametr **Device ID** nebo **MQTT Client ID**. Jde o jedinečný identifikátor používaný v MQTT topicích.

- **Gen1:** nachází se na štítku jako MAC adresa (např. `AABBCCDDEE`). Device ID = `shelly<model>-<mac>`, např. `shelly1pm-AABBCCDDEE`
- **Gen2/Plus:** nachází se ve webovém rozhraní Shelly v části **Settings** → **Device Info** → **Device ID**, nebo na štítku zařízení

### Krok 3 — Konfigurace v TapHome

1. V TapHome přidejte nový modul **Packet Parser (MQTT)**
2. **IP Address:** pro vestavěný broker TapHome `127.0.0.1` (jednotka se připojuje sama k sobě, adresa se nikdy nezmění); pro externí broker jeho IP adresa (např. `192.168.1.10`)
3. **Port:** `1883` (výchozí; pro TLS použijte `8883`)
4. **Device ID / MQTT Client ID:** zadejte hodnotu z kroku 2 (pokud to šablona vyžaduje)
5. Importujte šablonu — TapHome se automaticky přihlásí k odběru topiců zařízení

## Dostupná zařízení 3

Tato zařízení se po importu zobrazí v TapHome.

Shelly Gas MQTT Modul

Servisní akce

|          |                                                                                                                                  |
|----------|----------------------------------------------------------------------------------------------------------------------------------|
| Samotest | Spustí samotest senzoru na zařízení — bzučák pípne třikrát dvakrát za sekundu a po úspěšném testu Plynový alarm ohlásí Samotest. |

Vlastní proměnné

`deviceID` (string) Shelly-ID jednotky Shelly Gas — řetězec se šesti nebo více znaky, který tvoří prefix MQTT topicu shellies/shellygas-&lt;deviceID&gt;/ (např. 35FA58). Zjistíte jej ve webovém 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í akce

Self test

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

Plynový alarm Vícestavový přepínač Pouze ke čtení

Úroveň alarmu hlášená senzorem — Žádný alarm, Mírný únik plynu (od 1800 ppm), Silný únik plynu (od 3000 ppm), Samotest nebo Stav alarmu je neznámý. Prahy jsou pevně dané firmwarem zařízení a nelze je změnit.

enum multi-value switch

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

Čtení stavu přepínače

```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 přepínače

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

Koncentrace plynu Proměnná Pouze ke čtení

Naměřená koncentrace hořlavého plynu v milióntinách, rozsah 0–65535 ppm. Během zahřívání senzoru nebo při jeho poruše zařízení hlásí -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
```

Čtení (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
```

Ztlumit aktivní alarm Tlačítko Čtení i zápis

Tlačítko určené ke ztlumení právě aktivního alarmu. V aktuální revizi šablony nemá žádný účinek — topic, na který publikuje, se nesestavuje z nastaveného Device ID.

action push button

Zápis stavu tlačítka

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

**Připojení:** Packet Parser → MQTT • Hostname: `shellygas-{MAC}.local`

Možná vylepšení (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.

## Parametry importu

Tyto hodnoty zadáte při importu XML.

| Ptá se v aplikaci     | Výchozí            |
|-----------------------|--------------------|
| Mqtt Broker IP adresa | `192.168.0.1`      |
| Mqtt Broker port      | `1883`             |
| Device ID             | Zadáte při importu |

## 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ýrobců jsou © jejich příslušných vlastníků. Poskytujeme je tak, jak je výrobce zveřejnil, pouze pro informaci.

## Související dokumentace

- [MQTT Integration](https://taphome.com/cs/compatibility/mqtt-guide/)
- [Packet Parser (HTTP, TCP, UDP, FTP, MQTT)](https://taphome.com/cs/docs/integration/packet-parser/)
- [Funkce Packet parser](https://taphome.com/cs/docs/script/packet-parser/)
- [Funkce pro parsování](https://taphome.com/cs/docs/script/parsing-functions/)
- [Broker MQTT](https://taphome.com/cs/docs/integration/packet-parser/mqtt-broker/)
- [Listener skripty](https://taphome.com/cs/docs/script/listener-scripts/)

