Geräteprofil · Sensoren
Ecowitt Gateway
Hinweis: Dieses Profil beruht auf der Ecowitt-Dokumentation „HTTP API interface Protocol (Generic)“ V1.0.5 (2025-10-08) und auf echten Antworten eines GW1200 und eines GW3000.
Voraussetzungen
- Ein Ecowitt-Gateway mit lokalem Webinterface: GW1100, GW1200, GW2000 oder GW3000 mit aktueller Firmware. Konsolen mit derselben lokalen HTTP-API (z. B. WS3900/WS3910, HP2560) und baugleiche Geräte anderer Marken (z. B. Froggit) sollten ebenfalls funktionieren, sind aber nicht geprüft. Der ältere GW1000 hat keine HTTP-API und wird nicht unterstützt.
- Mindestens ein Außensensor (z. B. WH65/WS69, WS80, WS85, WS90/WH90), der am Gateway angelernt ist.
- Feste IP-Adresse für das Gateway (DHCP-Reservierung im Router).
- Test im Browser:
http://<IP>/get_livedata_infozeigt die Messwerte als JSON.
Einheiten am Gateway einstellen (wichtig)
Das Gateway liefert jeden Wert in der Einheit, die am Gateway eingestellt ist, und hängt die Einheit
an den Wert an (z. B. "9.36 km/h", "0.0 mm/Hr", "1021.2 hPa"). Das Profil erwartet
genau diese Einheiten:
| Größe | Einstellung am Gateway |
|---|---|
| Temperatur | °C |
| Luftdruck | hPa |
| Wind | km/h |
| Regen | mm |
| Sonneneinstrahlung | W/m² |
Die Einheiten stellt man im Webinterface des Gateways (http://<IP>, Bereich Einheiten / Units)
oder in der App WS View Plus bzw. Ecowitt ein.
Bei Wind, Regen, Luftdruck und Sonneneinstrahlung ist die Einheit Teil des Suchmusters. Steht das Gateway z. B. auf m/s, mph, inHg oder Klux, bleibt der betreffende Wert in nomos leer, statt falsch angezeigt zu werden. Bei der Temperatur steht die Einheit in einem eigenen Feld und lässt sich nicht prüfen: Steht das Gateway auf °F, zeigt nomos die Fahrenheit-Zahl als °C an.
Einrichtung
- nomos Config Panel öffnen
- Das Ecowitt-Gateway-Profil unter Skills → Add-ons importieren
- Gerät hinzufügen und die IP-Adresse des Gateways eintragen (Port 80 ist fest)
Ein Passwort ist nicht nötig. Die Lese-Endpunkte des Gateways sind auch dann ohne Anmeldung erreichbar, wenn im Webinterface ein Passwort gesetzt ist.
Datenbereich
Abgefragt wird alle 30 Sekunden GET /get_livedata_info (Intervall änderbar). Einmal pro Stunde
und beim Start kommt GET /get_version dazu. Das Profil liest nur, es schreibt nichts ans Gateway.
Außen
- Temperatur (
temperature, °C), Luftfeuchte (humidity, %), Taupunkt (dewpoint, °C) - Luftdruck relativ (
pressure, hPa = mbar, auf Meereshöhe bezogen); absoluter Luftdruck (pressure_absolute) ausgeblendet. Gemessen wird der Luftdruck vom Innensensor, der im Gateway sitzt oder als WH25/WN32P angelernt ist. Fehlt dieser, bleibt der Wert leer.
Wind
- Windgeschwindigkeit (
windstrength, km/h), Böen (guststrength, km/h), Windrichtung (winddegree, °, 0 = Nord) - Stärkste Böe des Tages (
guststrength_daymax, km/h) ausgeblendet
Regen
- Regen (
rain, ja/nein): ja, solange die Regenrate größer als 0 ist. Gut geeignet als Auslöser für Automationen (Markise einfahren, Bewässerung aussetzen). - Regenrate (
rainrate, mm/h), Regenereignis (rain_event, mm), Regen heute (rain_day, mm) - Regen dieser Woche, dieses Monats und dieses Jahres (
rain_week,rain_month,rain_year, mm) ausgeblendet
Sonne
- Sonneneinstrahlung (
solarradiation, W/m²) - Helligkeit (
light-level, Lux): umgerechnet als W/m² × 126,7, mit demselben Faktor, den Ecowitt selbst verwendet. Der WH65/WS90 misst eigentlich Lux, das Gateway rechnet in W/m² um. Für Beschattungs- Automationen ist der Wert gut brauchbar, ein geeichtes Luxmeter ersetzt er nicht. - UV-Index (
uvi, 0–15)
Innen
- Innentemperatur (
indoor_temperature, °C) und Innenluftfeuchte (indoor_humidity, %) vom Sensor im bzw. am Gateway
Gerät
- Erreichbarkeit (
reachable): nein, sobald die HTTP-Abfrage fehlschlägt - Firmware-Version (
firmware, z. B.GW2000B_V2.1.4) ausgeblendet
Hinweise
- Fehlt ein Sensor, fehlen auch seine Werte: Ohne Solarsensor bleibt Sonne leer, ohne Regenmesser bleibt Regen leer. Das Gateway liefert dann einfach keinen Eintrag.
- Kipplöffel und Piezo-Regenmesser gleichzeitig (z. B. WH40 + WS90): Das Gateway meldet beide in getrennten Listen mit denselben Kennungen. Das Profil übernimmt die Werte des Messers, der in der Antwort zuerst steht (laut Ecowitt-Doku der Kipplöffel).
- Weitere Sensoren werden nicht ausgewertet: Mehrkanal-Thermo/Hygrometer (WN31), Boden (WH51), Blitz (WH57), Luftqualität/CO₂
(WH45/WH46), Leckage (WH55) und Batteriestände. Diese Werte stehen zwar auch in
get_livedata_info, hängen aber von den belegten Kanälen ab. - Gefühlte Temperatur, Windchill und Hitzeindex werden nicht übernommen.
- Die Werte sind so aktuell wie die Funkübertragung der Sensoren (WH65 etwa alle 16 s, WS90 etwa alle 9 s). Ein kürzeres Abfrageintervall als 15 s bringt deshalb nichts.
- Einheiten, Kalibrierung und Wetterdienste werden am Gateway per HTTP POST geändert. Das Profil enthält deshalb keine Schreibbefehle.