
Der Shelly Gas (Modell SHGS-1) ist ein netzbetriebener Wi-Fi-Detektor für brennbare Gase. Er wird direkt in eine Steckdose gesteckt, misst die Gaskonzentration laufend und löst beim Überschreiten eines Schwellenwerts seinen eigenen Ton- und Lichtalarm aus. Er wird als zwei getrennte Produkte verkauft — Shelly Gas CNG für Erdgas (Methan) und Shelly Gas LPG für Flüssiggas (Propan / Butan). Beide haben dieselbe Firmware und dieselben MQTT-Topics, sodass diese eine Vorlage mit beiden funktioniert; nur das Sensorelement und die empfohlene Montagehöhe unterscheiden sich.
Diese Vorlage verbindet sich mit einem MQTT-Broker, nicht direkt mit dem Gerät. Das Modul abonniert shellies/# auf dem Broker und filtert die Nachrichten eines bestimmten Shelly Gas anhand seiner Device ID heraus. TapHome empfängt den Alarmzustand und die Gaskonzentration so, wie das Gerät sie veröffentlicht, und kann einen Sensor-Selbsttest starten.
Es gibt auch eine HTTP-Variante dieser Vorlage (
Shelly Gas). Verwenden Sie diese MQTT-Vorlage, wenn in der Installation bereits ein MQTT-Broker läuft und Push-Updates bevorzugt werden; die HTTP-Vorlage, wenn kein Broker vorhanden ist.
Shelly Gas ist ein Sicherheitsgerät. Die TapHome-Integration ergänzt den eingebauten Signalgeber und den LED-Alarm — sie ersetzt sie nicht. Signalgeber und LED arbeiten unabhängig von MQTT, vom Broker und von der TapHome-Steuereinheit und funktionieren weiter, wenn eines davon nicht verfügbar ist.
Hardware
Platzierung
Das Gerät wird in eine Netzsteckdose gesteckt — es gibt keine Verkabelung. Die richtige Montagehöhe hängt von der Gasvariante ab, weil sich die beiden Gase in der Luft unterschiedlich verhalten.
| Variante | Erkanntes Gas | Verhalten in der Luft | Empfohlene Platzierung |
|---|---|---|---|
| Shelly Gas CNG | Erdgas (Methan) | Leichter als Luft, sammelt sich an der Decke | 0,3–1 m unter der Decke, senkrecht, und 1,5 m von der Gasquelle entfernt |
| Shelly Gas LPG | Flüssiggas (Propan / Butan) | Schwerer als Luft, sammelt sich am Boden | 0,3 m über dem Boden, innerhalb von 1,5 m zur Gasquelle |
CNG und LPG sind zwei getrennte Produkte mit unterschiedlichen Sensoren, kein umschaltbarer Modus. Wenn die Variante unklar ist, prüfen Sie die Beschriftung auf der Rückseite des Geräts.
Spezifikation
| Parameter | Wert |
|---|---|
| Stromversorgung | 110–230 V ±10 %, 50/60 Hz AC |
| Leistungsaufnahme | < 3 W |
| Alarmempfindlichkeit | 6 % LEL (untere Explosionsgrenze) |
| Schalldruck | ≥ 70 dB |
| Wi-Fi | 802.11 b/g/n, 2400–2484 MHz |
| Reichweite | bis 50 m im Freien, bis 30 m in Gebäuden |
| Betriebstemperatur | −10 °C bis +50 °C |
| Ausgang Ventilmanipulator-Buchse | 11–13 V, 500 mA (externes Zubehör, wird von dieser Vorlage nicht gesteuert) |
| Abmessungen | 89,5 × 89,5 × 38 mm (ohne Stecker) |
Lokale Anzeige
LED-Ring und Signalgeber sind die geräteeigene Anzeige. TapHome sieht nur die beiden Topics, die unter Gerätefunktionen beschrieben sind — diese Signale tragen also Informationen, die die Steuereinheit nicht erreichen.
| LED-Ring | Bedeutung |
|---|---|
| Dauerhaft grün | Sensor im Normalbetrieb |
| Dauerhaft gelb | Sensorfehler |
| Blinkt rot | Alarm |
| Blinkt rot / gelb / grün in Folge | Sensor wärmt auf |
| Signalgeber-Muster | Ereignis |
|---|---|
| Zwei kurze Pieptöne pro Sekunde | Aufwärmen nach dem Einschalten gestartet |
| Ein langer Piepton pro Sekunde | Aufwärmen beendet |
| Langer Piepton einmal pro Sekunde, bis der Fehler behoben ist | Sensorfehler |
| Drei kurze Pieptöne zweimal pro Sekunde | Selbsttest läuft |
| Langer Piepton einmal pro Sekunde | Selbsttest erfolgreich abgeschlossen |
| Langer Piepton einmal pro Sekunde, bis das Leck weg ist oder sich verschärft | Leichtes Gasleck |
| Fünf Sekunden Piepen mit einer Sekunde Pause, bis das Leck weg ist | Schweres Gasleck |
Nach dem Einschalten führt das Gerät einen Selbsttest durch, der etwa drei Minuten dauert. Der LED-Ring durchläuft dabei grün → orange → rot und der Gasmesswert ist nicht gültig.
Konfiguration
MQTT am Gerät aktivieren
- Öffnen Sie die Weboberfläche des Geräts in einem Browser.
- Gehen Sie zu Internet and Security → Advanced - Developer Settings.
- Aktivieren Sie Enable action execution via MQTT.
- Füllen Sie das Feld Server nach dem Muster
{IP-Adresse des MQTT-Brokers}:{Port}aus — zum Beispiel192.168.1.10:1883. - Drücken Sie SAVE. Das Gerät verbindet sich neu und beginnt, an den Broker zu publizieren.
Auf Gen1-Firmware deaktiviert das Aktivieren von MQTT die Shelly-Cloud-Verbindung — beides gleichzeitig ist nicht möglich. Gen1-Geräte unterstützen außerdem kein MQTT über TLS, der Broker muss also unverschlüsseltes MQTT auf Port 1883 annehmen. Halten Sie den Broker deshalb in einem vertrauenswürdigen lokalen Netzwerk.
Device ID auslesen
Gehen Sie in der Weboberfläche zu Settings → Device Info → Device ID. Benötigt wird die erste Zeichenfolge, nicht der Wert in Klammern. Es handelt sich um eine Shelly-ID mit sechs oder mehr Zeichen, zum Beispiel 35FA58. Derselbe Bezeichner erscheint im Wi-Fi-Netz, das das Gerät im Access-Point-Modus aufspannt (ShellyGas-35FA58), und bildet das MQTT-Topic-Präfix shellies/shellygas-35FA58/.
Vorlage einrichten
Die Vorlage fragt drei Importparameter ab:
| Importparameter | Standard | Einzutragender Wert |
|---|---|---|
| Mqtt Broker IP address | 192.168.0.1 | IP-Adresse des MQTT-Brokers — nicht die des Shelly Gas |
| Mqtt Broker port | 1883 | Port, auf dem der Broker lauscht |
| Device ID | — | Die oben ausgelesene Shelly-ID, z. B. 35FA58 |
Der Importparameter Device ID füllt die Modulvariable deviceID, die das Topic-Präfix für jedes vom Modul verwendete Topic bildet. Das Modul abonniert shellies/# und seine Listener-Skripte filtern die eingehenden Nachrichten nach diesem Präfix.
Standardmäßig veröffentlicht das Gerät alle 30 Sekunden ein Update. Wird der Geräteparameter mqtt_update_period auf 0 gesetzt, meldet es nur noch bei Änderung.
Gerätefunktionen
Gasalarm
Gasalarm ist ein Mehrwertschalter, gespeist aus shellies/shellygas-<deviceID>/sensor/gas. Er trägt die Alarmstufe, die das Gerät bereits aus der gemessenen Konzentration abgeleitet hat.
| TapHome-Wert | MQTT-Payload | Bedeutung |
|---|---|---|
| Kein Alarm | none | Konzentration unter 1800 ppm |
| Leichtes Gasleck | mild | Konzentration ab 1800 ppm |
| Schweres Gasleck | heavy | Konzentration ab 3000 ppm |
| Selbsttest | test | Nach einem erfolgreichen Selbsttest veröffentlicht |
| Alarmzustand ist unbekannt | unknown oder ein beliebiges anderes Payload | Das Gerät kann die Alarmstufe nicht angeben |
Beide Schwellenwerte sind in der Geräte-Firmware fest hinterlegt und nicht änderbar.
Gaskonzentration
Gaskonzentration liest den Rohwert aus shellies/shellygas-<deviceID>/sensor/concentration in parts per million, Bereich 0–65535 ppm. Es ist dieselbe physikalische Messung wie beim Gasalarm, bevor die Firmware ihre Schwellenwerte anwendet.
Verwenden Sie Gasalarm für die Alarmlogik und Gaskonzentration für Trends, Diagramme und eigene Frühwarngrenzen unter 1800 ppm. Eine Regel sollte keine eigene Alarmstufe aus dem ppm-Wert ableiten und erwarten, dass sie mit dem Gerät übereinstimmt — Signalgeber und LED folgen den festen Firmware-Schwellen.
Das Gerät veröffentlicht auf dem Konzentrations-Topic
-1, sobald der Messwert nicht gültig ist — während des rund dreiminütigen Aufwärmens nach dem Einschalten und bei einem Sensorfehler. Die Vorlage speichert dieses-1unverändert; es ist kein TapHome-Fehlercode.
Selbsttest
Das Modul stellt die Serviceaktion Selbsttest bereit, die auf shellies/shellygas-<deviceID>/sensor/start_self_test publiziert. Während des Tests piept das Gerät dreimal kurz, zweimal pro Sekunde, und veröffentlicht bei Erfolg test auf dem Gas-Topic — in TapHome erscheint das als Wert Selbsttest des Gasalarms.
Bekannte Einschränkungen
„Aktiven Alarm stummschalten" erreicht das Gerät nicht
Die Vorlage enthält eine Taste Aktiven Alarm stummschalten, die in der aktuellen Vorlagenrevision jedoch wirkungslos ist. Die Taste publiziert auf das wörtliche Topic shellies/shellygas-<deviceid>/sensor/mute — der Platzhalter <deviceid> wird nie durch die konfigurierte Device ID ersetzt, die Nachricht geht also an ein Topic, das kein reales Gerät abonniert. Die anderen drei Topics derselben Vorlage bilden ihr Präfix korrekt aus der Variablen deviceID.
Verlassen Sie sich nicht auf die Taste „Aktiven Alarm stummschalten". Das Stummschalten eines aktiven Alarms aus TapHome funktioniert erst, wenn die Vorlage so korrigiert ist, dass sie das Topic aus der Variablen
deviceIDbildet. Der Alarm lässt sich jederzeit direkt am Gerät über Mute in dessen Weboberfläche stummschalten — und auch nur, solange tatsächlich ein Alarm aktiv ist.
Fehlerbehebung
In TapHome kommen keine Werte an
- Prüfen Sie, ob MQTT am Gerät aktiviert ist und das Feld Server die Broker-Adresse in der Form
{IP}:{Port}enthält - Kontrollieren Sie, dass der Modul-Endpunkt auf den MQTT-Broker zeigt, nicht auf die IP-Adresse des Shelly Gas
- Bestätigen Sie, dass die Device ID exakt dem entspricht, was Settings → Device Info → Device ID anzeigt — nur die erste Zeichenfolge, ohne den Wert in Klammern
- Abonnieren Sie mit einem MQTT-Client (zum Beispiel MQTT Explorer)
shellies/#und prüfen Sie, ob Nachrichten untershellies/shellygas-<Ihre-ID>/eintreffen - Wurde das Gerät auf Meldung nur bei Änderung umgestellt (
mqtt_update_period = 0), führen Sie die Serviceaktion Selbsttest aus — ein erfolgreicher Test publiziert auf dem Gas-Topic
Gaskonzentration zeigt -1
Der Sensormesswert ist nicht gültig. Entweder wärmt das Gerät noch auf — etwa drei Minuten nach dem Einschalten — oder der Sensor hat einen Fehler. Ein Fehler zeigt sich am Gerät als dauerhaft gelbe LED und ein langer Piepton einmal pro Sekunde. Diese Vorlage liest das Topic mit dem Sensorzustand nicht, ein Fehler erreicht TapHome also nur als dieses -1.
Gasalarm zeigt „Alarmzustand ist unbekannt"
Dieser Wert ist der Rückfallzweig der Vorlage. Er fängt das dokumentierte Payload unknown und jedes Payload außerhalb der vier bekannten Werte ab. Prüfen Sie den LED-Ring am Gerät, um zu sehen, in welchem Zustand der Sensor tatsächlich ist.
Das Gerät ist aus der Shelly Cloud verschwunden
Auf Gen1-Firmware zu erwarten — das Aktivieren von MQTT deaktiviert die Cloud-Verbindung. Erreichen Sie die Weboberfläche stattdessen über das lokale Netzwerk, über die Geräte-IP oder den mDNS-Hostnamen shellygas-<MAC>.local.