Zum Hauptinhalt springen

HomeWizard Energy Smart-Home-Integration, kostenlos und Open Source

HomeWizard Energy-Integration für Gladys Assistant

HomeWizard P1 Meter, Energy Socket, kWh-Zähler, Wasserzähler und Akku, im lokalen Netz gelesen.

Auf GitHub ansehenAlle externen Integrationen

Lies deine HomeWizard-Energy-Geräte in Gladys aus, über dein lokales Netzwerk: das P1 Meter am P1-Port eines intelligenten Stromzählers (DSMR, Niederlande, Belgien, Luxemburg…), die Energy Socket, die kWh-Zähler (ein- und dreiphasig, Eastron SDM230 und SDM630 eingeschlossen), den Watermeter und die Plug-In Battery. Leistung, Zählerstände, Spannungen, Gas und Wasser, bereit für den Energie-Tab von Gladys, mit einem Dashboard-Widget, zwei Szenenauslösern und drei Szenenaktionen. Kein Konto und keine Cloud: Gladys liest jedes Gerät direkt über die offizielle lokale API von HomeWizard.

Ohne die Hardware entwickelt: Rückmeldungen willkommen. Diese Integration wurde mit echten Antworten von HomeWizard-Geräten gebaut und getestet, aufgezeichnet von den Projekten python-homewizard-energy und Home Assistant, und mit simulierten Geräten (API v1 und v2), nicht mit einem echten Zähler. Wenn etwas nicht wie beschrieben funktioniert, sag es im Gladys-Forum oder in den Issues.

Was du brauchst​

  • Gladys Assistant 5.1.0 oder neuer.
  • HomeWizard-Geräte, eingerichtet in der HomeWizard-Energy-App, im selben Netzwerk wie Gladys.
  • Für jedes Gerät die lokale API:
    • API v1 (alle Modelle außer der Plug-In Battery): in der HomeWizard-Energy-App Einstellungen → Zähler → dein Gerät → Lokale API, eingeschaltet.
    • API v2 (P1 Meter, kWh-Zähler und Plug-In Battery mit aktueller Firmware): sicher (HTTPS), nichts in der App einzuschalten, aber du koppelst jedes Gerät einmal durch einen Druck auf seine Taste (siehe unten). Die Plug-In Battery hat nur diese.
  • Sonst nichts: kein HomeWizard-Konto, kein Schlüssel, kein Internetzugang.

Einrichtung​

  1. Installiere die Integration aus dem Gladys-Katalog.
  2. Öffne ihre Konfiguration. Nichts ist Pflicht; die Optionen sind:
    • IP-Adressen der HomeWizard-Geräte: nur für Geräte, die die automatische Erkennung nicht findet, durch Kommas getrennt (zum Beispiel 192.168.1.40, 192.168.1.41). Dein Router zeigt die Adresse jedes Geräts. Namen auf .local funktionieren hier nicht: Nimm die Adresse.
    • Aktualisierungsintervall: wie oft jedes Gerät gelesen wird, von 2 Sekunden bis 1 Minute (standardmäßig 10 Sekunden). Leistungswerte folgen diesem Takt; Zählerstände, Spannungen, Ströme, Gas und Wasser gehen höchstens einmal pro Minute an Gladys, was für den Energie-Tab reicht und Gladys entlastet.
    • Sprache der Funktionsnamen: Englisch, Französisch, Deutsch oder Spanisch (standardmäßig Französisch). Die Funktionsnamen werden beim Hinzufügen eines Geräts vergeben, und die Meldungen der Szenenaktionen folgen dieser Sprache.
  3. Öffne den Tab Entdecken der Integration: Die gefundenen Geräte stehen dort. Füge die gewünschten hinzu.
  4. Für die API v2 (empfohlen auf den Geräten, die sie bieten, und der einzige Weg für die Plug-In Battery): Klicke auf Koppeln (API v2): Gerätetaste drücken und drück dann innerhalb von 75 Sekunden die Taste jedes zu koppelnden Geräts (beim kWh-Zähler die WLAN-Kopplungstaste, 1 bis 3 Sekunden, nicht länger). Die Meldung unter der Schaltfläche nennt die gekoppelten Geräte. Ein P1 Meter mit eingeschalteter API v1 wird über v1 gelesen, bis es gekoppelt ist.

Die Aktion Nach HomeWizard-Geräten suchen startet eine neue Suche und zeigt, was gefunden wurde, welche API jedes Gerät nutzt und was die anderen blockiert (lokale API aus, Kopplung nötig, Gerät antwortet nicht). Die Aktion Geräteleuchte blinken lassen lässt die Statusleuchte eines Geräts einige Sekunden blinken, um es unter gleichen Geräten zu finden.

Die Geräte in Gladys​

Ein Gladys-Gerät pro HomeWizard-Gerät, benannt nach Modell und Ende der Seriennummer (HomeWizard P1 Meter aabbcc). Veröffentlicht wird nur, was das Gerät liefert: Ein einphasiger Zähler hat kein L2 und L3, ein Zähler mit einem Tarif keine Tarifzählerstände, ein P1 Meter ohne Gaszähler kein Gas.

P1 Meter

  • Bezogene Leistung und Eingespeiste Leistung (W): was das Haus aus dem Netz bezieht und ins Netz zurückgibt, nie negativ.
  • Zählerstand Bezug (kWh): die gesamte bezogene Energie. Daraus macht der Energie-Tab von Gladys Verbrauch und Kosten; die bezogene Leistung bleibt für die Leistungsspitzen, nach denen manche Verträge abrechnen.
  • Zählerstand Einspeisung (kWh): die gesamte ins Netz gespeiste Energie.
  • Zählerstand Bezug T1… T4 und Zählerstand Einspeisung T1… T4 (kWh): pro Tarif (Tag/Nacht), wenn der Zähler mehrere hat.
  • Spannung L1… L3 (V) und Strom L1… L3 (A), pro Phase, wenn der Zähler sie liefert. Der Strom kommt ohne Vorzeichen: seine Stärke.
  • Gas und Wasser (m³): die an den intelligenten Zähler angeschlossenen Gas- und Wasserzähler, von ihm etwa stündlich abgelesen.
  • WLAN-Signal (%).

Energy Socket

  • Ein/Aus: das Relais, steuerbar.
  • Leistung (W), Energiezähler (kWh: der Verbrauch für den Energie-Tab) und bei neueren Steckdosen Spannung (V) und Strom (A).
  • Tastensperre: aktiv, können weder die Taste der Steckdose noch Gladys sie ausschalten (Gefriertruhe, Router). Steuerbar.
  • LED-Helligkeit (0 bis 100 %): der Leuchtring der Steckdose.
  • WLAN-Signal (%).

kWh-Zähler (HWE-KWH1, HWE-KWH3, SDM230, SDM630)

  • Leistung (W, negativ, wenn der Stromkreis Energie zurückgibt, etwa ein Solarwechselrichter) und bei dreiphasigen Zählern Leistung L1… L3.
  • Zählerstand Bezug (kWh, Verbrauch im Energie-Tab) und Zählerstand Einspeisung (kWh, von Gladys als Erzeugung gezählt: ein kWh-Zähler an einem Solarwechselrichter).
  • Spannung und Strom, oder Spannung L1… L3 und Strom L1… L3 bei dreiphasigen Zählern. WLAN-Signal (%).

Watermeter

  • Wasserdurchfluss (m³/h: 1 l/min sind 0,06 m³/h) und Wasserzählerstand (m³).
  • WLAN-Signal (%). Der Watermeter antwortet nur mit USB-Versorgung: Mit Batterien schläft er, und Gladys kann ihn nicht lesen.

Plug-In Battery (nur API v2)

  • Ladestand (%), Ladeleistung und Entladeleistung (W), Geladene Energie und Entladene Energie (kWh), Ladezyklen, WLAN-Signal (%).

Ein Gerät, das drei Lesungen hintereinander nicht antwortet, bekommt in Gladys das Abzeichen „nicht erreichbar“; seine letzten Werte bleiben.

Dashboard-Widget​

Energie live zeigt den Netzaustausch eines P1 Meters:

  • eine Anzeige Netz mit Vorzeichen: nach rechts, wenn das Haus Strom bezieht, nach links (grün), wenn es Strom einspeist;
  • Kacheln Bezug und Einspeisung, live;
  • mit einem in den Widget-Einstellungen gewählten Solar-kWh-Zähler: Solar (die von diesem Zähler gemessene Erzeugung) und Haus (was das Haus verbraucht: Bezug − Einspeisung + Erzeugung);
  • der aktuelle Tarif, der Gaszählerstand und ob die Zähler antworten.

Einstellungen: das P1 Meter (leer: das erste gefundene) und optional der kWh-Zähler (oder die Steckdose), der deine Solarmodule misst.

Szenen​

Auslöser​

  • Das Haus speist mehr ein als…: Die Leistung, die ein P1 Meter ins Netz einspeist, steigt über eine Schwelle zwischen 100 W und 8 kW. Typischer Fall: Die Solarmodule erzeugen mehr, als das Haus verbraucht.
  • Das Haus bezieht mehr als…: Die Leistung, die ein P1 Meter aus dem Netz bezieht, steigt über eine Schwelle.

Jeder Auslöser feuert einmal, wenn die Leistung über die Schwelle steigt, und erst wieder, nachdem sie um 10 % (mindestens 50 W) darunter gefallen ist: Eine Leistung, die um die Schwelle schwankt, wiederholt ihn nicht. Direkt nach dem Start von Gladys oder der Integration feuert nichts. Die Szene kann die Leistung (W) und die erreichte Schwelle lesen. Um zu reagieren, wenn die Leistung wieder sinkt, nimm die Funktion Bezogene Leistung oder Eingespeiste Leistung in einem Auslöser „Gerätezustand“.

Aktionen​

  • HomeWizard-Steckdose einschalten und HomeWizard-Steckdose ausschalten: Beide melden zurück, ob die Steckdose an ist. Abgelehnt, mit einer Meldung, solange ihre Tastensperre aktiv ist.
  • HomeWizard-Gerät blinken lassen: Die Statusleuchte blinkt einige Sekunden (nicht bei kWh-Zählern, die über die API v1 gelesen werden).

Szenenideen​

  • Solarüberschuss: „Das Haus speist mehr ein als… 1,5 kW“ → die Steckdose des Warmwasserspeichers oder des Autoladers einschalten; „Eingespeiste Leistung“ 10 Minuten unter 200 W → ausschalten.
  • Eine Spitze vermeiden: „Das Haus bezieht mehr als… 5 kW“ → eine unwichtige Steckdose ausschalten und eine Nachricht schicken.
  • Ein Gerät finden: in einer Szene, die du vom Dashboard startest, „HomeWizard-Gerät blinken lassen“.

Fehlerbehebung​

  • Ein Gerät fehlt im Tab Entdecken: Starte Nach HomeWizard-Geräten suchen und lies die Meldung. „Lokale API in der App aus“: Schalte sie in der HomeWizard-Energy-App ein. „Drück nach Koppeln seine Taste“: Das Gerät bietet nur die API v2, kopple es. Gar nicht gefunden: Die Geräte werden über den Gladys-Kern (mDNS) gefunden, nur im selben Netzwerk; gib seine IP-Adresse in der Konfiguration ein.
  • „Token abgelehnt, kopple es neu“: Das Token der Integration wurde gelöscht (Gerät zurückgesetzt, Benutzerliste in der App geleert). Kopple erneut.
  • „Zertifikat abgelehnt“: Das Gerät unter dieser Adresse weist nicht nach, dass es das erwartete HomeWizard-Gerät ist; Gladys schickt ihm nichts. Prüfe die Adresse (eine DHCP-Änderung?) und starte eine Suche.
  • Der Watermeter antwortet nicht: Er muss über USB versorgt werden.
  • Die Werte wirken verspätet: Zählerstände, Spannungen und Gas gehen einmal pro Minute raus; der Gaszähler selbst aktualisiert sich etwa stündlich.

Grenzen​

  • Nur Abfrage (kein Push): Die Leistungswerte sind so frisch wie das Aktualisierungsintervall.
  • Die Akkumodi (Null, voll laden, Standby) und die Cloud-Einstellungen der Geräte werden nicht gesteuert; das Energy Display wird nicht unterstützt.
  • Die Energy Socket und der Watermeter werden über die API v1 gelesen (ihre API v2 ist bei HomeWizard noch in Entwicklung).
  • Externe Zähler eines P1 Meters: ein Gaszähler und ein Wasserzähler; Wärmezähler werden nicht gelesen.
  • Ohne die Hardware entwickelt (siehe oben).

HomeWizard ist eine Marke von HomeWizard B.V. Diese Integration ist nicht mit HomeWizard verbunden.

Konfigurationseinstellungen​

Diese Einstellungen fragt HomeWizard Energy in seinem Konfigurationsbildschirm in Gladys ab.

EinstellungTypPflichtfeldBeschreibung
Deine HomeWizard-Geräte findensectionNeinAktiviere „Lokale API“ für jedes Gerät in der HomeWizard-Energy-App und öffne den Tab „Entdecken“: Geräte im Netz von Gladys werden automatisch gefunden. Neuere Geräte (P1, kWh, Akku) bieten auch die sichere API v2: Starte Koppeln und drück ihre Taste.
IP-Adressen der HomeWizard-GerätestringNeinOptional, durch Kommas getrennt. Nur für Geräte nötig, die die automatische Erkennung nicht findet.
AktualisierungsintervallselectNeinWie oft jedes Gerät gelesen wird. Leistungswerte folgen diesem Takt; Zählerstände, Spannungen und Ströme gehen höchstens einmal pro Minute an Gladys.
Sprache der FunktionsnamenselectNeinWird für die Funktionsnamen neuer Geräte und für die Meldungen der Szenenaktionen verwendet.

So installierst du HomeWizard Energy in Gladys​

  1. Öffne in Gladys Integrationen: HomeWizard Energy erscheint im Katalog neben den nativen Integrationen, mit einem Community-Badge.
  2. Klicke auf Installieren. Gladys lädt das Docker-Image (ghcr.io/guim31/gladys-homewizard:1.0.1) herunter, startet es in einer vom Kern isolierten Sandbox und erzeugt die Oberfläche der Integration (Geräte, Erkennung und Konfiguration).
  3. Öffne den Bildschirm Konfiguration der Integration, fülle die Einstellungen aus und speichere.
  4. Du kannst sie auch direkt über die URL ihres Repositorys installieren: https://github.com/guim31/gladys-homewizard.

HomeWizard Energy benötigt Gladys >=5.1.0. Der Katalog in Gladys wird stündlich aktualisiert, eine neue Version ist also spätestens eine Stunde nach ihrer Veröffentlichung verfügbar.

Du nutzt Gladys noch nicht? Es ist kostenlos und Open Source: folge der Installationsanleitung, um loszulegen.

Über externe Integrationen​

HomeWizard Energy ist eine externe Integration: eine Community-Integration, die als Docker-Container verpackt und auf GitHub veröffentlicht wird. Gladys installiert sie mit einem Klick und führt sie in einer vom Kern isolierten Sandbox aus. Sie wird von guim31 veröffentlicht und gepflegt, nicht vom Gladys-Kernteam.

Abonniere den Newsletter von Gladys Assistant

Ein paar E-Mails im Monat zu neuen Releases und Neuigkeiten aus dem Projekt. Verschickt von Pierre-Gilles Leymarie, dem Gründer des Projekts. Jederzeit abbestellbar 🙂
Zuletzt aktualisiert am