---
title: "Shelly Sensor Add-On"
description: "Bis zu 4 DS18B20-Fühler, Reed-Kontakt, Analogeingang und 0–10 V Voltmeter am Shelly Plus Add-On, lokal über die HTTP-API des Host-Shelly in TapHome."
url: "https://taphome.com/de/compatibility/shelly-sensor-add-on/"
language: de
lastmod: 2026-10-08
generator: hugo
ai:
  topics: ["http","sensor","wifi","gen2plus","expansion-board","temperature","1-wire"]
  questions: ["Wie integriere ich das Shelly Sensor Add-On mit TapHome?","Welche Shelly-Host-Geräte sind mit dem Sensor Add-On kompatibel?","Wie aktiviere ich das Sensor Add-On in der Shelly-Weboberfläche?","Warum sind meine DS18B20-Fühler nach dem Verdrahten am Add-on in TapHome nicht sichtbar?","Warum meldet TapHome keine Feuchtigkeit vom DHT22 am Shelly Add-On?","Kann das Shelly Sensor Add-On einen fünften DS18B20-Fühler an TapHome übergeben?"]
---

# Shelly Sensor Add-On

Kommunikation: Packet Parser → HTTP

- [Shelly Plus Add-On Produktseite](https://www.shelly.com/products/shelly-plus-add-on)
- [Shelly Sensor Add-On API-Dokumentation](https://shelly-api-docs.shelly.cloud/gen2/Addons/ShellySensorAddon/)

> Netzwerkadresse
> 
> TapHome erreicht dieses Gerät unter der beim Import eingegebenen Adresse. Geben Sie dem Gerät eine feste Adresse — eine IP-Reservierung im Router oder seinen mDNS-Namen, falls es einen unterstützt —, sonst funktioniert die Integration nicht mehr, sobald der Router die Adresse ändert.
> 
> [Netzwerkvorbereitung](https://taphome.com/de/docs/setup/network-preparation/)

## Integrationsanleitung

Das Shelly Sensor Add-On (vermarktet als **Shelly Plus Add-On**) ist eine galvanisch getrennte Erweiterungsplatine, die auf den Add-on-Stecker eines kompatiblen Shelly Plus, Gen3 oder Gen4 aufgesteckt wird. Sie erweitert den Host-Shelly um einen 1-Wire-Temperaturbus (DS18B20), einen Digitaleingang (Reed-/Trockenkontakt), einen Analogeingang (0–10 V / 0–100 %) und ein 0–10 V Voltmeter. Das Add-on ist **kein eigenständiges Wi-Fi-Gerät** — es wird über die HTTP-Schnittstelle des Host-Shelly im lokalen Netzwerk gelesen, TapHome adressiert also die IP des Hosts, nicht eine eigene IP des Add-ons.

Die TapHome-Vorlage stellt vier DS18B20-Temperaturfühler (Component-ID 100–103), einen Reed-Kontakt, einen Analogeingang und ein Voltmeter bereit. Alle Werte werden über die Standard-Shelly Gen2+ JSON-RPC-API auf Port 80 abgefragt — eine Cloud-Verbindung ist nicht erforderlich.

## Hardware-Anschluss

Das Add-on setzt sich über einen proprietären seriellen Stecker auf den Host-Shelly und bezieht 3,3 V DC direkt aus dem Host (Verbrauch unter 0,5 W ohne Sensoren). Die zugänglichen Klemmen sind in einen analog/digitalen Block und drei 1-Wire-Sensorpositionen gruppiert.

### Analoge und digitale Klemmen

- `ANALOG IN` — 0–10 V Analogeingang (Genauigkeit ±5 %, 1 % Meldeschwelle)
- `DIGITAL IN` — Trockenkontakt-/Reed-Schalter-Eingang (True: −15 V bis 0,5 V, False: 2,5 V bis 15 V)
- `VREF OUT` — Referenzspannung (max. 1 mA) zur Versorgung von Sensoren mit Potentiometer-Teilung
- `VREF+R1 OUT` — Referenzspannung mit 10 kΩ Pull-up-Widerstand, ausgelegt für Spannungsteiler mit NTC und Fotowiderstand
- `GND` × 2 — Massenanschlüsse

### 1-Wire-Bus

Drei dreipolige Gruppen (`VCC`, `DATA`, `GND`) teilen sich intern eine gemeinsame 1-Wire-Datenleitung. Bis zu **5 DS18B20-Fühler** können parallel am gemeinsamen Bus verdrahtet werden; alternativ kann ein einzelner DHT22-Sensor den Bus belegen (DHT22 blockiert im aktiven Zustand den OneWire-Scan). Der gesamte VCC-Ausgang ist auf 10 mA begrenzt, was für fünf DS18B20-Fühler ausreicht.

Der maximale Leiterquerschnitt an allen Klemmen beträgt 1 mm² (17 AWG).

> [!WARNING]
> Mische DHT22 und DS18B20-Fühler nicht auf demselben Bus. Der DHT22 blockiert die OneWire-Enumeration, und der Host-Shelly kann den Bus bei angeschlossenem DHT22 nicht neu einlesen.

## Konfiguration

Das Shelly Sensor Add-On besitzt keine eigene IP-Adresse. Trage beim Import der TapHome-Vorlage im Parameter `IpAddress` die IP-Adresse des **Host-Shelly** ein (das Plus-/Gen3-/Gen4-Gerät, auf dem das Add-on sitzt) — Standard ist `192.168.0.1`.

Die gesamte Kommunikation läuft über die Gen2+ JSON-RPC-API per HTTP GET auf Port 80. Einmal pro Poll-Zyklus liest die Vorlage `/rpc/Sys.GetStatus` und `/rpc/SensorAddon.GetPeripherals` in interne Cache-Variablen, anschließend fragt jedes Geräte-Skript seinen eigenen Endpunkt ab (`Temperature.GetStatus`, `Input.GetStatus` oder `Voltmeter.GetStatus`).

### Kompatible Host-Geräte

Das Add-on arbeitet mit folgenden Shelly-Geräten zusammen (aus der Herstellerliste):

- **Shelly Plus:** 1, 1PM, 1 UL, 1PM UL, 2PM, 2PM UL, i4, i4DC, 0-10 V Dimmer PM, RGBW PM
- **Shelly Gen3:** 1, 1PM, 2PM, Shutter, i4, DALI Dimmer, Dimmer 0/1-10 V PM, EM
- **Shelly Gen4:** 1, 1PM, 2PM

Die Firmware des Host-Shelly muss den Dienst `SensorAddon` bereitstellen — ältere Plus-Firmware-Versionen haben ihn möglicherweise nicht. Aktualisiere den Host auf die neueste Firmware, falls das Add-on-Menü in der Weboberfläche fehlt.

### Add-on-Peripherie aktivieren

Das Add-on wird einmalig in der Weboberfläche des **Host-Shelly** konfiguriert — TapHome übernimmt das nicht. Führe vor dem Import der Vorlage folgende Schritte aus:

1. Stecke die Add-on-Platine auf den Add-on-Stecker des Host-Shelly und schalte den Host ein.
2. Öffne die Weboberfläche des Hosts unter `http://{host-ip}/` und melde dich an.
3. Navigiere zu **Settings → Add-on** und registriere das Add-on (dies ruft im Hintergrund `Sys.SetConfig` mit `device.addon_type = "sensor"` auf). Starte den Host auf Aufforderung neu.
4. Öffne **Settings → Components → Peripherals** und klicke auf die Schaltfläche **+**.
5. Wähle den Peripherietyp — Temperature (DS18B20), Digital Input, Analog Input oder Voltmeter.
6. Klicke bei DS18B20 auf **Rescan**, setze bei jedem erkannten Fühler ein Häkchen und wähle **Add and reboot**. Der erste Fühler erhält Component-ID `100`, der zweite `101` usw.
7. Setze bei Digital Input **Mode** auf Switch oder Button (die Vorlage liest `state` aus diesem Component).
8. Bei Analog Input und Voltmeter sind die Standardwerte in Ordnung — relevant sind nur Name und Delta-Schwelle.

Die TapHome-Vorlage **fixiert Component-IDs 100–103** für DS18B20 und ID `100` für Reed-Kontakt, Analogeingang und Voltmeter. Prüfe beim Hinzufügen der Peripherie in der Shelly-Weboberfläche, dass die zugewiesenen IDs dieser Nummerierung entsprechen — wenn du eine Peripherie löschst und neu hinzufügst, vergibt Shelly die nächste freie ID, die über 103 liegen kann, und das TapHome-Gerät erhält stillschweigend keine Daten mehr.

> [!TIP]
> Notiere vor dem Entfernen einer Peripherie deren Component-ID. Wenn du einen DS18B20-Fühler austauschst, bevorzuge in der Weboberfläche die Aktion **Edit → Update address**, damit die Component-ID gleich bleibt.

> [!WARNING]
> Am Host-Shelly muss die **HTTP Digest Authentication deaktiviert sein** — TapHome sendet keine authentifizierten Anfragen. Lasse das Gerät ohne Authentifizierung oder schränke den Zugriff auf Netzwerkebene ein.

## Gerätefunktionen

Die Vorlage gruppiert sieben schreibgeschützte Sensorgeräte unter einem einzigen HTTP-Modul, das auf den Host-Shelly zielt.

### Temperaturfühler (DS18B20)

Vier DS18B20-OneWire-Temperaturfühler werden bereitgestellt, einer je Component-ID 100–103:

- **Temperaturfühler (DS18B20 #1)** — liest `/rpc/Temperature.GetStatus?id=100` → `tC` (°C)
- **Temperaturfühler (DS18B20 #2)** — liest `/rpc/Temperature.GetStatus?id=101` → `tC`
- **Temperaturfühler (DS18B20 #3)** — liest `/rpc/Temperature.GetStatus?id=102` → `tC`
- **Temperaturfühler (DS18B20 #4)** — liest `/rpc/Temperature.GetStatus?id=103` → `tC`

Jedes Gerät hat eine benutzerkonfigurierbare `Id`-Custom-Variable (Standardwert entspricht der Position). Das Polling-Intervall beträgt 15 Sekunden pro Fühler. Die Shelly-Weboberfläche erlaubt die Feinabstimmung von Delta-Schwelle (0,1–5 °C) und Offset (±50 °C) pro Fühler zur Kalibrierung.

### Reed-Kontakt (Digitaleingang)

**Reed Contact (100)** liest `/rpc/Input.GetStatus?id=100` → `state` (boolean). In der Shelly-Oberfläche muss der Eingang als **Switch** oder **Button** konfiguriert sein (nicht **Analog** oder **Count**). Polling-Intervall: 2,5 Sekunden. Der Standardwert der `Id`-Custom-Variable ist `100`.

### Analogeingang

**Analog Input (100)** liest `/rpc/Input.GetStatus?id=100` → `percent` und teilt den Wert durch 100, sodass er als Bruchteil 0,0–1,0 vorliegt, den TapHome für Analogeingänge erwartet. Der Eingang muss in der Shelly-Oberfläche als **Analog** konfiguriert sein. Genauigkeit ±5 %, Meldeschwelle 1 %. Polling-Intervall: 2,5 Sekunden.

Beachte, dass Reed-Kontakt und Analogeingang die Component-ID `100` teilen — die Shelly-Hardware hat am Add-on nur einen Digital- und einen Analogeingang, und der aktive Modus wird durch den **Typ** des Eingangs in der Weboberfläche festgelegt (`switch`/`button` vs. `analog`). Verwende in TapHome entweder das Reed-Kontakt- **oder** das Analog-Input-Gerät, nicht beide gleichzeitig.

### Voltmeter

**Voltmeter (100)** liest `/rpc/Voltmeter.GetStatus?id=100` → `voltage` (V). Der Bereich ist 0–10 V mit ±5 % Genauigkeit und 0,1 V Meldeschwelle. Es ist als `PacketParserVariable` mit der Fähigkeit `sensor` modelliert — die Rohspannung wird als skalarer Wert bereitgestellt, nicht als eigenständiger Voltmeter-Typ. Polling-Intervall: 15 Sekunden.

### Zusätzliche Fähigkeiten

Das Shelly Sensor Add-On unterstützt nativ auch einen **DHT22-Temperatur- und Feuchtigkeitssensor** (ein einzelner Fühler, der auf dem Host die gepaarten Components `temperature:100` und `humidity:100` erzeugt). Die TapHome-Vorlage leitet die Temperatur auf allen vier DS18B20-Geräten weiter, **fixiert das Feuchtigkeits-Skript jedoch auf `NaN`** — DHT22-Feuchtigkeit wird daher nicht bereitgestellt. Wer Feuchtigkeit benötigt, kann die Vorlage um ein separates Read-Skript auf `/rpc/Humidity.GetStatus?id=100` erweitern.

Zwei weitere Funktionen existieren auf Hardware-/Firmware-Ebene, liegen aber außerhalb dieser Vorlage: ein **fünfter DS18B20-Slot** (der Shelly-Bus unterstützt bis zu fünf Fühler; die Vorlage fragt nur IDs 100–103 ab) und der **Impulszählmodus** des Digitaleingangs (`counts.total`, `counts.by_minute`, `freq`), der erfordert, den Eingang in der Shelly-Oberfläche als `type=count` zu konfigurieren. Beides kann in einer zukünftigen Vorlagen-Aktualisierung ergänzt werden.

## Fehlerbehebung

### Host-Shelly antwortet nicht

1. Prüfe, ob der Host-Shelly mit dem Wi-Fi verbunden ist und eine gültige IP hat.
2. Versuche es mit dem mDNS-Hostnamen des Hosts (z. B. `shellyplus1pm-AABBCCDDEE.local`) statt der IP — die IP kann sich nach einem DHCP-Renew geändert haben. Das Add-on erbt den Hostnamen des Hosts und hat keinen eigenen.
3. Öffne im Browser `http://{host-ip}/rpc/Shelly.GetDeviceInfo` — antwortet der Host mit JSON, ist er erreichbar.
4. Prüfe, ob TapHome CCU und der Host-Shelly im selben Netzwerk / VLAN sind.
5. Stelle sicher, dass HTTP Digest Authentication in der Shelly-Weboberfläche deaktiviert ist.

### Sensoren zeigen keine Daten

1. Öffne die Shelly-Weboberfläche → **Components → Peripherals**. Bestätige, dass die Peripherie mit **exakt der Component-ID, die die Vorlage erwartet**, gelistet ist (`temperature:100`–`103`, `input:100`, `voltmeter:100`). Liegt die ID über `103` oder ist verschoben, nummeriere die Peripherie durch Löschen und erneutes Hinzufügen in der richtigen Reihenfolge neu, oder passe die Vorlage an deine IDs an.
2. Für DS18B20: Klicke auf **Rescan** in der Zeile des DS18B20 — die Bus-Adresse sollte aufgelöst werden. Zeigt die Adresse N/A, prüfe die VCC/DATA/GND-Verdrahtung und den 10 kΩ Pull-up an `DATA` (einige generische DS18B20-Boards lassen ihn weg; der Shelly stellt ihn intern bereit).
3. Frage den Endpunkt direkt ab: `GET http://{host-ip}/rpc/Temperature.GetStatus?id=100`. Die Antwort sollte einen Wert `tC` ungleich null enthalten.
4. Starte den Host-Shelly nach dem Hinzufügen oder Entfernen von Peripherie neu. Components erscheinen manchmal erst nach einem Neustart.

### Analogeingang liest null

1. Prüfe, ob `type` des Eingangs in der Shelly-Oberfläche auf `analog` gesetzt ist (nicht `switch`, `button` oder `count`). Die Vorlage liest `percent`, das nur im Analog-Modus gefüllt ist.
2. Prüfe die Verdrahtung — eine 0–10 V Quelle muss zwischen `ANALOG IN` und `GND` liegen. Für Potentiometer-Sensoren (NTC, Fotowiderstand) nutze `VREF+R1 OUT` (mit integriertem 10 kΩ Pull-up) statt `VREF OUT`.
3. Bedenke, dass TapHome den Wert als Bruchteil 0,0–1,0 erhält (die Vorlage teilt `percent` durch 100).

### DHT22-Feuchtigkeit fehlt

Das ist eine gewollte Einschränkung der Vorlage — das Skript `readhumidity` ist in jedem DS18B20-Geräte-Slot auf `NaN` fixiert. Die Add-on-Hardware unterstützt DHT22, für die Bereitstellung der Feuchtigkeit in TapHome muss die Vorlage jedoch um ein eigenes Gerät erweitert werden, das `/rpc/Humidity.GetStatus?id=100` → `rh` liest. DS18B20 und DHT22 können nicht auf demselben Bus koexistieren — entferne die DS18B20-Fühler, wenn du auf DHT22 wechselst.

### Fünfter DS18B20-Fühler ist nicht sichtbar

Die Vorlage fragt nur IDs 100–103 ab. Ein fünfter Fühler, der in der Shelly-Weboberfläche als `temperature:104` registriert ist, existiert zwar am Host, wird aber von TapHome nicht gelesen. Verschiebe entweder den gewünschten Fühler auf einen Slot 100–103 (löschen und in Reihenfolge neu hinzufügen), oder erweitere die Vorlage um ein fünftes Gerät, das `id=104` adressiert.

## Installation in TapHome

### Voraussetzungen

- Shelly-Gerät installiert und eingeschaltet
- Lokales Wi-Fi-Netzwerk (2,4 GHz)
- TapHome CCU im selben Netzwerk

### Schritt 1 — Shelly mit Wi-Fi verbinden

**Option A — Shelly-App (empfohlen):**

1. Laden Sie die [Shelly-App](https://www.shelly.com/en/support/shelly-app) herunter (iOS / Android)
2. Tippen Sie auf **+** → **Add Device** und folgen Sie dem Bluetooth-Kopplungsassistenten
3. Geben Sie Ihre Wi-Fi-Zugangsdaten ein, wenn Sie dazu aufgefordert werden

**Option B — AP-Modus (ohne App):**

1. Beim ersten Einschalten erstellt das Gerät einen Hotspot: `ShellyXXX-AABBCCDDEE`
2. Verbinden Sie Ihr Telefon/PC mit diesem Hotspot
3. Öffnen Sie `http://192.168.33.1` → **Internet & Security** → **Wi-Fi Mode - Client**
4. Geben Sie SSID und Passwort ein → **Save**

> [!NOTE]
> Shelly unterstützt nur **2,4 GHz**-Netzwerke. 5 GHz-Netzwerke werden beim Scannen nicht angezeigt.

### Schritt 2 — IP-Adresse ermitteln

Nach der Verbindung mit Wi-Fi ermitteln Sie die zugewiesene IP-Adresse auf eine der folgenden Arten:

- **Shelly-App:** Gerätedetail → **Device info** → IP-Adresse
- **Shelly-Weboberfläche:** Verbinden Sie sich mit dem Geräte-AP vor der Wi-Fi-Einrichtung — die IP wird nach dem Speichern angezeigt
- **Router-DHCP-Tabelle:** Suchen Sie nach einem Hostnamen wie `shelly1pm-AABBCCDDEE`
- **mDNS:** Pingen Sie `shelly<model>-<mac>.local` (z. B. `shelly1pm-AABBCCDDEE.local`) aus dem selben Netzwerk

> [!TIP]
> Weisen Sie dem Shelly-Gerät eine **statische IP** (DHCP-Reservierung) in Ihrem Router zu, damit sich die Adresse nach einem Router-Neustart nicht ändert.

### Schritt 3 — Konfiguration in TapHome

1. Fügen Sie in TapHome ein neues Modul **Packet Parser (HTTP)** hinzu
2. **IP Address:** Geben Sie die IP aus Schritt 2 ein (z. B. `192.168.1.50`)
3. **Port:** `80` (Standard, keine Änderung erforderlich)
4. Importieren Sie die Vorlage — TapHome fragt regelmäßig `/status` ab, um den Gerätestatus zu lesen

> [!NOTE]
> Die HTTP-Authentifizierung ist auf Shelly-Geräten standardmäßig deaktiviert. Wenn Sie den Anmeldeschutz aktiviert haben, unterstützt TapHome derzeit kein HTTP Basic Auth — lassen Sie die Authentifizierung für die TapHome-Integration deaktiviert.

## Verfügbare Geräte 7

Diese Geräte erscheinen nach dem Import in TapHome.

Shelly Sensor Add-On Modul

Benutzerdefinierte Variablen

Lesen (Modul)

```taphome
var res := sendhttprequest("/rpc/Sys.GetStatus");
SysGetStatus := res.Content;
res := sendhttprequest("/rpc/SensorAddon.GetPeripherals");
SensorAddonGetPeripherals := res.Content;
```

Analogeingang Analogeingang Nur lesen

0–10 V / 0–100 % Analogeingang — liest /rpc/Input.GetStatus?id=100 → percent und teilt durch 100, sodass der Wert als Bruchteil 0,0–1,0 vorliegt. Erfordert, dass der Eingangstyp in der Shelly-Weboberfläche auf analog gesetzt ist. Genauigkeit ±5 %

numeric Einheit: % (normalised) json\_path

Variable: `Id` — Component-ID der Analogeingangs-Peripherie am Host-Shelly (Add-on-Peripherie nutzt 100–199; der erste Analogeingang ist 100)

Eingangslevel lesen

```taphome
var res := sendhttprequest("/rpc/Input.GetStatus?id=" + Id);
parsejson(res.Content, "percent") / 100
```

Reed-Kontakt Reed-Kontakt Nur lesen

Digitaler Trockenkontakt-/Reed-Eingang — liest /rpc/Input.GetStatus?id=100 → state (true = geschlossen, false = offen). Erfordert, dass der Eingangstyp in der Shelly-Weboberfläche auf switch oder button gesetzt ist (teilt Component-ID 100 mit dem Analogeingang — nur ein aktiver Modus gleichzeitig)

boolean json\_path

Variable: `Id` — Component-ID der Digitaleingangs-Peripherie am Host-Shelly (Standard 100)

Lesen

```taphome
var res := sendhttprequest("/rpc/Input.GetStatus?id=" + Id);
parsejson(res.Content, "state")
```

Temperaturfühler (DS18B20 #1) Temperatursensor Nur lesen

Erster DS18B20-Fühler am 1-Wire-Bus — liest /rpc/Temperature.GetStatus?id=100 → tC (°C). Feuchtigkeit ist auf NaN fixiert (Vorlage stellt keinen DHT22 bereit)

numeric Einheit: °C json\_path

Variable: `Id` — Component-ID des ersten DS18B20-Fühlers am Host-Shelly (Standard 100)

Luftfeuchtigkeit lesen

```taphome
NaN
```

Temperatur lesen

```taphome
var res := sendhttprequest("/rpc/Temperature.GetStatus?id=" + Id);
parsejson(res.Content, "tC")
```

Temperaturfühler (DS18B20 #2) Temperatursensor Nur lesen

Zweiter DS18B20-Fühler am 1-Wire-Bus — liest /rpc/Temperature.GetStatus?id=101 → tC (°C)

numeric Einheit: °C json\_path

Variable: `Id` — Component-ID des zweiten DS18B20-Fühlers am Host-Shelly (Standard 101)

Luftfeuchtigkeit lesen

```taphome
NaN
```

Temperatur lesen

```taphome
var res := sendhttprequest("/rpc/Temperature.GetStatus?id=" + Id);
parsejson(res.Content, "tC")
```

Temperaturfühler (DS18B20 #3) Temperatursensor Nur lesen

Dritter DS18B20-Fühler am 1-Wire-Bus — liest /rpc/Temperature.GetStatus?id=102 → tC (°C)

numeric Einheit: °C json\_path

Variable: `Id` — Component-ID des dritten DS18B20-Fühlers am Host-Shelly (Standard 102)

Luftfeuchtigkeit lesen

```taphome
NaN
```

Temperatur lesen

```taphome
var res := sendhttprequest("/rpc/Temperature.GetStatus?id=" + Id);
parsejson(res.Content, "tC")
```

Temperaturfühler (DS18B20 #4) Temperatursensor Nur lesen

Vierter DS18B20-Fühler am 1-Wire-Bus — liest /rpc/Temperature.GetStatus?id=103 → tC (°C). Letzter DS18B20-Slot der Vorlage — der Shelly-Bus unterstützt bis zu 5 Fühler, aber nur IDs 100–103 werden abgefragt

numeric Einheit: °C json\_path

Variable: `Id` — Component-ID des vierten DS18B20-Fühlers am Host-Shelly (Standard 103)

Luftfeuchtigkeit lesen

```taphome
NaN
```

Temperatur lesen

```taphome
var res := sendhttprequest("/rpc/Temperature.GetStatus?id=" + Id);
parsejson(res.Content, "tC")
```

Voltmeter Variable Nur lesen

0–10 V Spannungsmessung — liest /rpc/Voltmeter.GetStatus?id=100 → voltage (V). Als schreibgeschützter Skalarwert über PacketParserVariable bereitgestellt (kein nativer Voltmeter-Typ). Genauigkeit ±5 %, Meldeschwelle 0,1 V

numeric Einheit: V json\_path

Variable: `Id` — Component-ID der Voltmeter-Peripherie am Host-Shelly (Standard 100)

Lesen

```taphome
var res := sendhttprequest("/rpc/Voltmeter.GetStatus?id=" + Id);
parsejson(res.Content, "voltage")
```

**Verbindung:** Packet Parser → HTTP • Hostname: `shellyplus{model}-{MAC}.local`

Mögliche Verbesserungen (7)

- DHT22 Humidity — Template hardcodes readhumidity = NaN on all four DS18B20 temperature devices. The add-on physically supports a DHT22 sensor (temperature + humidity) which creates paired humidity:100 + temperature:100 Components on the host. A separate PacketParser device reading humidity:100 → rh would expose this.
- 5th DS18B20 slot — The Shelly Plus Add-on supports up to 5 DS18B20 probes on the shared 1-Wire bus. The template only wires 4 (IDs 100–103). A fifth probe registered as temperature:104 in the Shelly web UI would not be polled.
- OneWire bus scan — Manufacturer API can discover unmapped DS18B20 probes. Not exposed as a TapHome service action — users must scan via the Shelly web UI. Useful for replacing physical probes.
- Peripheral lifecycle management — Adding/removing/updating peripherals is performed exclusively via the Shelly web UI; the template does not expose these as TapHome service actions by design.
- Enable / disable add-on — Activation is a one-time setup step performed in the Shelly web UI (or via Sys.SetConfig with device.addon\_type = "sensor"). Not exposed by the template.
- Pulse counter mode — Digital input can be configured as type=count and would expose counts.total / counts.by\_minute / freq. Template only reads state (switch/button mode).
- Voltmeter transformed value — Voltmeter supports an optional JavaScript expression (xvoltage.expr) that transforms the raw voltage (e.g. for a voltage-divided NTC temperature reading). Template reads only raw voltage.

## Importparameter

Diese Werte geben Sie beim Import des XML ein.

| In der App abgefragt | Standard      |
|----------------------|---------------|
| IP-Adresse           | `192.168.0.1` |

## Quellen

- Shelly Gen2+/Gen3 RPC API Reference
  
  [shelly-api-docs.shelly.cloud](https://shelly-api-docs.shelly.cloud/gen2/) 2026-04-16
- Shelly Gen2+ System (Sys) Component API
  
  [shelly-api-docs.shelly.cloud](https://shelly-api-docs.shelly.cloud/gen2/ComponentsAndServices/Sys/) 2026-04-16
- Shelly Sensor Add-On — RPC API Reference
  
  [shelly-api-docs.shelly.cloud](https://shelly-api-docs.shelly.cloud/gen2/Addons/ShellySensorAddon/) 2026-04-16
- Shelly Plus Add-on — Product Page
  
  [www.shelly.com](https://www.shelly.com/products/shelly-plus-add-on) 2026-04-16
- Shelly Plus Add-on — Knowledge Base
  
  [kb.shelly.cloud](https://kb.shelly.cloud/knowledge-base/shelly-plus-add-on) 2026-04-16
- Shelly Plus Add-on — Web Interface Guide
  
  [kb.shelly.cloud](https://kb.shelly.cloud/knowledge-base/shelly-plus-add-on-web-interface-guide) 2026-04-16
- Home Assistant — Shelly integration
  
  [www.home-assistant.io](https://www.home-assistant.io/integrations/shelly/) 2026-04-16

## Verwandte Dokumentation

- [Packet-Parser-Integration](https://taphome.com/de/compatibility/packet-parser-guide/)
- [Packet Parser (HTTP, TCP, UDP, FTP, MQTT)](https://taphome.com/de/docs/integration/packet-parser/)
- [Packet-Parser-Funktionen](https://taphome.com/de/docs/script/packet-parser/)
- [Parsing-Funktionen](https://taphome.com/de/docs/script/parsing-functions/)

