
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.
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.
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 |
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í zariadenie spustí samotest, ktorý trvá približne tri minúty. LED prstenec počas neho prechádza zelenou → oranžovou → červenou a údaj o plyne nie je platný.
Konfigurácia
Povolenie MQTT na zariadení
- Otvorte webové rozhranie zariadenia v prehliadači.
- Prejdite do Internet and Security → Advanced - Developer Settings.
- Zaškrtnite Enable action execution via MQTT.
- Do poľa Server zadajte hodnotu podľa vzorca
{IP adresa MQTT brokera}:{port}— napríklad192.168.1.10:1883. - Stlačte SAVE. Zariadenie sa znovu pripojí a začne publikovať na brokera.
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.
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.
Zariadenie publikuje na topicu koncentrácie hodnotu
-1vždy, keď meranie nie je platné — počas približne trojminútového zahrievania po zapnutí a počas poruchy senzora. Šablóna toto-1ukladá 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.
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
- Overte, že MQTT je na zariadení povolené a pole Server obsahuje adresu brokera v tvare
{IP}:{port} - Skontrolujte, že endpoint modulu smeruje na MQTT brokera, nie na IP adresu Shelly Gas
- 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
- Prihláste sa MQTT klientom (napríklad MQTT Explorer) na odber
shellies/#a skontrolujte, že správy prichádzajú podshellies/shellygas-<vaše-id>/ - 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.