
Shelly Gas (model SHGS-1) to zasilany z sieci detektor gazów palnych Wi-Fi. Wpina się bezpośrednio do gniazdka, mierzy stężenie gazu w sposób ciągły i po przekroczeniu progu uruchamia własny alarm dźwiękowy i świetlny. Jest sprzedawany jako dwa osobne produkty — Shelly Gas CNG dla sprężonego gazu ziemnego (metan) i Shelly Gas LPG dla skroplonego gazu ropopochodnego (propan / butan). Oba mają to samo oprogramowanie układowe i te same tematy MQTT, więc ten jeden szablon działa z obydwoma; różnią się jedynie elementem czujnikowym i zalecaną wysokością montażu.
Ten szablon łączy się z brokerem MQTT, a nie bezpośrednio z urządzeniem. Moduł subskrybuje temat shellies/# na brokerze i na podstawie Device ID filtruje wiadomości należące do konkretnej jednostki Shelly Gas. TapHome odbiera stan alarmu i stężenie gazu w postaci publikowanej przez urządzenie oraz potrafi uruchomić autotest czujnika.
Dostępny jest także wariant HTTP tego szablonu (
Shelly Gas). Ten szablon MQTT stosuj, gdy w instalacji działa już broker MQTT i preferowane są aktualizacje push; szablon HTTP — gdy brokera nie ma.
Shelly Gas jest urządzeniem bezpieczeństwa. Integracja z TapHome uzupełnia wbudowany brzęczyk i alarm LED — nie zastępuje ich. Brzęczyk i LED działają niezależnie od MQTT, od brokera i od jednostki sterującej TapHome i działają nadal, gdy którekolwiek z nich jest niedostępne.
Sprzęt
Umiejscowienie
Jednostka wpina się do gniazda sieciowego — nie ma żadnego okablowania. Prawidłowa wysokość montażu zależy od wariantu gazu, ponieważ oba gazy zachowują się w powietrzu inaczej.
| Wariant | Wykrywany gaz | Zachowanie w powietrzu | Zalecane umiejscowienie |
|---|---|---|---|
| Shelly Gas CNG | Sprężony gaz ziemny (metan) | Lżejszy od powietrza, gromadzi się pod sufitem | 0,3–1 m pod sufitem, pionowo, i 1,5 m od źródła gazu |
| Shelly Gas LPG | Skroplony gaz ropopochodny (propan / butan) | Cięższy od powietrza, gromadzi się przy podłodze | 0,3 m nad podłogą, w promieniu 1,5 m od źródła gazu |
CNG i LPG to dwa osobne produkty z różnymi czujnikami, a nie przełączany tryb. Jeśli wariant nie jest oczywisty, sprawdź oznaczenia na tylnej stronie urządzenia.
Specyfikacja
| Parametr | Wartość |
|---|---|
| Zasilanie | 110–230 V ±10%, 50/60 Hz AC |
| Pobór mocy | < 3 W |
| Czułość alarmu | 6% LEL (dolna granica wybuchowości) |
| Poziom dźwięku | ≥ 70 dB |
| Wi-Fi | 802.11 b/g/n, 2400–2484 MHz |
| Zasięg | do 50 m na zewnątrz, do 30 m w pomieszczeniach |
| Temperatura pracy | od −10 °C do +50 °C |
| Wyjście gniazda manipulatora zaworu | 11–13 V, 500 mA (akcesorium zewnętrzne, nieobsługiwane przez ten szablon) |
| Wymiary | 89,5 × 89,5 × 38 mm (bez wtyczki) |
Sygnalizacja lokalna
Pierścień LED i brzęczyk to własna sygnalizacja urządzenia. TapHome widzi wyłącznie dwa tematy opisane w części Funkcje urządzenia, więc te sygnały niosą informacje, które nie docierają do jednostki sterującej.
| Pierścień LED | Znaczenie |
|---|---|
| Świeci na zielono | Czujnik w normalnej pracy |
| Świeci na żółto | Usterka czujnika |
| Miga na czerwono | Alarm |
| Miga czerwono / żółto / zielono w sekwencji | Czujnik się nagrzewa |
| Wzór brzęczyka | Zdarzenie |
|---|---|
| Dwa krótkie sygnały na sekundę | Nagrzewanie rozpoczęte po włączeniu zasilania |
| Jeden długi sygnał na sekundę | Nagrzewanie zakończone |
| Długi sygnał raz na sekundę, dopóki usterka trwa | Usterka czujnika |
| Trzy krótkie sygnały dwa razy na sekundę | Trwa autotest |
| Długi sygnał raz na sekundę | Autotest zakończony pomyślnie |
| Długi sygnał raz na sekundę, dopóki wyciek nie ustanie lub się nie nasili | Łagodny wyciek gazu |
| Pięć sekund sygnału z jednosekundową przerwą, dopóki wyciek nie ustanie | Silny wyciek gazu |
Po włączeniu zasilania urządzenie wykonuje autotest trwający około trzech minut. Pierścień LED przechodzi w tym czasie kolejno zielony → pomarańczowy → czerwony, a odczyt gazu nie jest prawidłowy.
Konfiguracja
Włączenie MQTT w urządzeniu
- Otwórz interfejs webowy urządzenia w przeglądarce.
- Przejdź do Internet and Security → Advanced - Developer Settings.
- Zaznacz Enable action execution via MQTT.
- Wypełnij pole Server według wzoru
{adres IP brokera MQTT}:{port}— na przykład192.168.1.10:1883. - Naciśnij SAVE. Urządzenie połączy się ponownie i zacznie publikować na brokerze.
W oprogramowaniu Gen1 włączenie MQTT wyłącza połączenie z Shelly Cloud — oba nie mogą działać jednocześnie. Urządzenia Gen1 nie obsługują też MQTT przez TLS, więc broker musi przyjmować nieszyfrowane MQTT na porcie 1883. Z tego powodu trzymaj brokera w zaufanej sieci lokalnej.
Odczyt Device ID
W interfejsie webowym przejdź do Settings → Device Info → Device ID. Potrzebny jest pierwszy ciąg znaków, a nie wartość w nawiasach. Jest to Shelly-ID o długości sześciu lub więcej znaków, na przykład 35FA58. Ten sam identyfikator pojawia się w sieci Wi-Fi tworzonej przez urządzenie w trybie punktu dostępowego (ShellyGas-35FA58) i tworzy prefiks tematów MQTT shellies/shellygas-35FA58/.
Konfiguracja szablonu
Szablon prosi o trzy parametry importu:
| Parametr importu | Domyślnie | Wartość do wpisania |
|---|---|---|
| Mqtt Broker IP address | 192.168.0.1 | Adres IP brokera MQTT — nie urządzenia Shelly Gas |
| Mqtt Broker port | 1883 | Port, na którym nasłuchuje broker |
| Device ID | — | Odczytany wyżej Shelly-ID, np. 35FA58 |
Parametr importu Device ID wypełnia zmienną deviceID na poziomie modułu, która buduje prefiks każdego tematu używanego przez moduł. Moduł subskrybuje temat shellies/#, a jego skrypty nasłuchujące filtrują przychodzące wiadomości według tego prefiksu.
Domyślnie urządzenie publikuje aktualizację co 30 sekund. Ustawienie parametru urządzenia mqtt_update_period na 0 przełącza je na raportowanie wyłącznie przy zmianie.
Funkcje urządzenia
Alarm gazowy
Alarm gazowy to przełącznik wielowartościowy zasilany z tematu shellies/shellygas-<deviceID>/sensor/gas. Niesie poziom alarmu, który urządzenie już wyznaczyło ze zmierzonego stężenia.
| Wartość w TapHome | Ładunek MQTT | Znaczenie |
|---|---|---|
| Brak alarmu | none | Stężenie poniżej 1800 ppm |
| Łagodny wyciek gazu | mild | Stężenie od 1800 ppm |
| Silny wyciek gazu | heavy | Stężenie od 3000 ppm |
| Autotest | test | Publikowane po udanym autoteście |
| Stan alarmu jest nieznany | unknown lub dowolny inny ładunek | Urządzenie nie potrafi określić poziomu alarmu |
Oba progi są zapisane na stałe w oprogramowaniu urządzenia i nie można ich zmienić.
Stężenie gazu
Stężenie gazu odczytuje surową wartość z tematu shellies/shellygas-<deviceID>/sensor/concentration w częściach na milion, w zakresie 0–65535 ppm. To ten sam pomiar fizyczny co Alarm gazowy, jeszcze przed zastosowaniem progów oprogramowania układowego.
Alarmu gazowego używaj do logiki alarmów, a Stężenia gazu do trendów, wykresów i własnych progów wczesnego ostrzegania poniżej 1800 ppm. Reguła nie powinna wyznaczać własnego poziomu alarmu ze stężenia w ppm i oczekiwać zgodności z urządzeniem — brzęczyk i LED podążają za stałymi progami oprogramowania układowego.
Urządzenie publikuje
-1w temacie stężenia zawsze, gdy odczyt nie jest prawidłowy — podczas trwającego około trzech minut nagrzewania po włączeniu zasilania oraz przy usterce czujnika. Szablon zapisuje to-1bez zmian; nie jest to kod błędu TapHome.
Autotest
Moduł udostępnia akcję serwisową Autotest, która publikuje w temacie shellies/shellygas-<deviceID>/sensor/start_self_test. W trakcie testu urządzenie emituje trzy krótkie sygnały dwa razy na sekundę, a po powodzeniu publikuje test w temacie gazu, co w TapHome pojawia się jako wartość Autotest Alarmu gazowego.
Znane ograniczenia
Wyciszenie aktywnego alarmu nie dociera do urządzenia
Szablon zawiera przycisk Wycisz aktywny alarm, ale w bieżącej wersji szablonu nie ma on żadnego działania. Przycisk publikuje w dosłownym temacie shellies/shellygas-<deviceid>/sensor/mute — symbol zastępczy <deviceid> nigdy nie zostaje zastąpiony skonfigurowanym Device ID, więc wiadomość trafia do tematu, którego nie subskrybuje żadne rzeczywiste urządzenie. Pozostałe trzy tematy w tym samym szablonie budują swój prefiks ze zmiennej deviceID poprawnie.
Nie polegaj na przycisku Wycisz aktywny alarm. Wyciszenie aktywnego alarmu z TapHome zadziała dopiero po poprawieniu szablonu tak, aby temat był budowany ze zmiennej
deviceID. Alarm zawsze można wyciszyć bezpośrednio na urządzeniu, poleceniem Mute w jego interfejsie webowym — i tylko wtedy, gdy alarm jest rzeczywiście aktywny.
Rozwiązywanie problemów
Do TapHome nie docierają żadne wartości
- Sprawdź, czy MQTT jest włączone w urządzeniu, a pole Server zawiera adres brokera w postaci
{IP}:{port} - Sprawdź, czy punkt końcowy modułu wskazuje na brokera MQTT, a nie na adres IP Shelly Gas
- Potwierdź, że Device ID dokładnie odpowiada temu, co pokazuje Settings → Device Info → Device ID — tylko pierwszy ciąg znaków, bez wartości w nawiasach
- Subskrybuj temat
shellies/#klientem MQTT (na przykład MQTT Explorer) i sprawdź, czy wiadomości przychodzą podshellies/shellygas-<twoje-id>/ - Jeśli urządzenie przełączono na raportowanie wyłącznie przy zmianie (
mqtt_update_period = 0), uruchom akcję serwisową Autotest — udany test publikuje w temacie gazu
Stężenie gazu pokazuje -1
Odczyt czujnika nie jest prawidłowy. Urządzenie albo wciąż się nagrzewa — około trzech minut po włączeniu zasilania — albo czujnik ma usterkę. Usterka objawia się na urządzeniu stale świecącą żółtą diodą LED i długim sygnałem raz na sekundę. Ten szablon nie odczytuje tematu ze stanem czujnika, więc usterka dociera do TapHome wyłącznie jako to -1.
Alarm gazowy pokazuje „Stan alarmu jest nieznany"
Ta wartość jest gałęzią zapasową szablonu. Przechwytuje udokumentowany ładunek unknown oraz każdy ładunek spoza czterech znanych wartości. Sprawdź pierścień LED na urządzeniu, aby zobaczyć, w jakim stanie czujnik faktycznie się znajduje.
Urządzenie zniknęło z Shelly Cloud
Oczekiwane w oprogramowaniu Gen1 — włączenie MQTT wyłącza połączenie z chmurą. Interfejs webowy otwieraj przez sieć lokalną, używając adresu IP urządzenia lub nazwy hosta mDNS shellygas-<MAC>.local.