Externe Integration - Beem Energy

[Terdious]

Beem Energy (externe Integration) — Vorstellung der v1.0.0

Hallo zusammen

Ich stelle euch eine neue externe Integration für Gladys vor: Beem Energy, um eure Beem Solar-Kits (BeemBox der 300-W-Kits, Beem On der 500-W-Kits) zu verfolgen. Dieses Thema dient später dazu, Neuerungen anzukündigen und euer Feedback zu sammeln.

Was ist das?

Eine externe Gladys-Integration, die in ihrem eigenen Container läuft, aus dem Integrationskatalog installiert wird (Bereich Energie) und die Produktion aller Boxen eures Beem-Kontos über die Beem-Cloud (die Boxen haben keinen lokalen Zugriff) hochlädt.

Unterstützte Funktionen

• Jede Box wird zu einem Gladys-Gerät, mit:
  • der Solarleistung in Echtzeit (W);
  • einem Produktionsindex (kWh), der mit der Energieverfolgung von Gladys verbunden werden kann, um eure Produktion halbstündlich neben eurem Verbrauch zu sehen;
  • der Tagesproduktion (kWh);
  • dem Wi-Fi-Signal (%).
• Alle Boxen in einer einzigen Anfrage, standardmäßig alle 2 Minuten.
• Nachts zeigt eine Box im Standby 0 W an, und nicht ihre letzte Leistung.
• Nichts geht verloren um Mitternacht, beim Monatswechsel oder während eines Gladys-Stopps: Der Index wird aus den Monatsgesamten der Cloud neu berechnet.
• Monatliche Historie wird beim Start abgerufen (standardmäßig 24 Monate), für das Jahr, die Gesamtsumme und die Amortisation.
• Schutz vor der Beem-API-Grenze: Das Token wird eine Stunde lang gespeichert, und nach einer Ablehnung (429) wartet die Integration 20 Minuten, statt weiterzumachen.

4 Dashboard-Widgets

In einem Dashboard: Bearbeiten → Box hinzufügen → Integrations-Widgets.

• Beem-Box: Eine Box mit ihrer Tageskurve, ihrem Anteil an der Spitzenleistung, dem Tag, dem Monat, dem Ertrag in kWh/kWc (vergleichbar zwischen einem 300-W-Kit und einem 500-W-Kit), dem Wi-Fi, der Uhrzeit der letzten Abfrage und den Panelen.
• Solaranlage: Die gesamte Anlage, einphasig oder dreiphasig. Bei dreiphasig weist ihr den Boxen jede Phase (L1, L2, L3) zu und erhaltet eine Kurve pro Phase, eine Linie pro Phase, die Phasenbalance und die Boxen mit Unterproduktion.
• Solare Einsparungen (Schätzung): Einsparungen des Tages, des Monats, des Jahres und insgesamt. Mit den Kosten eurer Kits zeigt es auch die Skala und das Amortisationsdatum, sowie das vermiedene CO₂ und die Einsparungen der letzten 12 Monate.
• Produktionshistorie: Balken über 30 Tage oder 12/24 Monate, Rekorde, Vergleich mit dem letzten Jahr, Rangliste der Boxen.

Wie funktionieren die Einsparungen?

Ein Plug-and-Play-Kit hat keinen Netzwerkzähler: Die Schätzung basiert auf eurem Tarif, der im Tab Konfiguration angegeben ist.

• Tarif: Grundtarif oder Spitzen-/Nebenspitzenzeiten. Bei HP/HC wird der Preis des Solar-kWh durch die Stunden gewichtet, in denen eure Panels tatsächlich produzieren.
• Selbstverbrauchsrate: Standardmäßig 100 %.
• Verkauf des Überschusses: Optional, wenn ihr einen Vertrag habt.
• Kosten der Installation: Für die Amortisation.

Szenen

• Auslöser Box mit Unterproduktion: Eine Box ist 30 Minuten stumm, während die anderen produzieren, oder sie produziert deutlich weniger. Er wird einmal pro Box und pro Tag ausgelöst, praktisch, um einen abgeschalteten Mikro-Wechselrichter oder ein verlorenes Wi-Fi zu erkennen.
• Auslöser Tagesproduktionsbilanz: Wird ausgelöst, wenn der Sonnentag beendet ist, mit den kWh des Tages, der Einsparung, dem CO₂ und der besten Box. Ideal für eine Abendnachricht: « 12,3 kWh heute, 2,45 € eingespart ».
• Aktion Solarproduktion lesen: Leistung, Tag, Monat, Jahr, Anteil der Spitzenleistung und Einsparungen, einer Box oder der gesamten Anlage. Zum Beispiel, um die Spülmaschine zu starten, wenn die Sonne scheint.

Installation

1. In Gladys: Integrationen → sucht Beem → Installieren.
2. Tab Konfiguration: die E-Mail und das Passwort der Beem-Anwendung, dann Speichern. Der Button Verbindung testen listet eure Boxen auf.
3. Eure Boxen erscheinen im Tab Entdeckung: Erstellt sie.
4. Optional: Gebt euren Tarif für die Einsparungen an und verbindet den Produktionsindex jeder Box in Integrationen → Energieverfolgung.

Die vollständige Dokumentation ist über den Link „Dokumentation“ im Konfigurationsbildschirm zugänglich.

Voraussetzungen

• Gladys ≥ 5.1.0.
• Ein Beem-Konto mit euren in der Anwendung sichtbaren Boxen.

Wissenswertes

• Vermeidet es, dass dasselbe Beem-Konto gleichzeitig mit mehreren Tools verbunden ist (Home Assistant, Skripte…): Die Beem-Cloud blockiert zu aufdringliche Konten.
• Die tägliche Historie sammelt sich ab der Installation der Integration an. Die Beem-Cloud liefert nur die monatliche Historie.

Feedback willkommen

Die Beem-API ist nicht öffentlich: Vielen Dank an die Home Assistant-Integration CharlesP44/Beem_Energy, die ihre Austausche dokumentiert hat. Ich teste sie auf 6 Boxen: 3 BeemBox (3 × 300 W) und 3 Beem On (2 × 500 W), eine pro Phase.

• Sind die Werte mit der Beem-Anwendung konsistent?
• Wenn euch ein Wert falsch erscheint, zeigt der Button Boxen diagnostizieren im Konfigurationstab an, was die Cloud hochlädt (ohne E-Mail, Passwort oder Token): Fügt es hier oder in einem Issue ein.

Repository und Versionshinweise: Releases · Terdious/gladys-beem-energy · GitHub

[Terdious]

[Terdious]

Update: v1.1.0 — ein aussagekräftigeres Box-Widget

Vielen Dank für das erste Feedback! Diese Version verbessert vor allem das Beem-Box-Widget, um eine Box, die weniger produziert als die anderen oder ausfällt, leichter zu erkennen.

Ausfälle des Tages

• Neue Zeile Ausfälle heute: Die Anzahl der Male, in denen die Box für mindestens 5 Minuten nichts produziert hat, während die anderen Boxen produzierten, mit der Uhrzeit des letzten Ausfalls (z. B. 3 · letzte 09:12, in Orange).
• Ideal, um eine Box zu diagnostizieren, die sich ein- und ausschaltet (schwaches Wi-Fi, unzuverlässiger Mikro-Wechselrichter).

Tageskurve + „Erwartet“-Kurve

• Die Leistungskurve ist geglättet (Durchschnitt über 5 Minuten): Kein Sägezahn-Effekt mehr durch die 30-W-Stufen des Beem-Clouds.
• Eine zweite Kurve „Erwartet“ zeigt, was die Box produzieren würde, wenn sie genauso viel wie die anderen Boxen produzieren würde, bei gleicher Größe (pro kWp). Eine Box, die unter ihren Nachbarn liegt, ist auf einen Blick erkennbar.

Im Vergleich zu den anderen Boxen

• Neue, immer angezeigte Zeile: Der Tagesertrag der Box in % des Medians der Boxen (z. B. 98 % des Medians), oder der Hinweis „stumm“ / „geringer Ertrag“.

Und auch

• Ausrichtung der Panels klar angegeben: SE -30° · ∠30° statt -30° / 30°.
• Die Gesamtzahl zeigt seit wann sie gezählt wird (z. B. „Seit Jan. 2025“), und „Gestern“ erscheint erst, wenn es bekannt ist.
• Die Spitzenleistungsskala ist nicht mehr orange, egal wie hoch der Wert ist.
• Widgets Installation, Einsparungen und Historische Daten: Kein doppelter Titel mehr unter dem Titel der Karte. Er wird nur angezeigt, wenn Sie einen in den Widget-Einstellungen angeben.

Um es zu nutzen

Überwachung → Aktualisieren, nichts weiter zu tun: Die Widgets aktualisieren sich automatisch. Die Ausfälle werden ab der Aktualisierung gezählt.

Vollständige Hinweise: Release v1.1.0 · Terdious/gladys-beem-energy · GitHub