Integrationsbeispiel · openHAB 5.1

Balkonkraftwerk einmal pro Woche automatisch an ablesio

Mit dem ablesio-Binding wird dein Zähler zu einem openHAB-Thing. Eine Regel schickt jeden Sonntagabend den Gesamtertrag an ablesio. Beispiel: das Balkonkraftwerk an der Pergola.

Das brauchst du

ablesio Ultimate und in ablesio einen Zähler vom Typ Balkonkraftwerk (hier: „Pergola", Zählernummer = Seriennummer FMH1B0307N)
openHAB 5.1 mit einem Item für den Gesamtertrag in kWh (z.B. aus dem Binding deines Wechselrichters)
das ablesio-Binding – Installation siehe Übersicht

Schritt 1: Token erstellen

In ablesio unter Profil → 🔌 Smart-Home-Integration einen Token erstellen, z.B. mit der Bezeichnung „openHAB".

Neuer API-Token — Der Token wird nur einmal angezeigt.

Schritt 2: Konto und Zähler anlegen

Per Oberfläche: Einstellungen → Things → + → ablesio Binding → ablesio-Konto, Token eintragen – die Pergola erscheint danach in der Inbox. Oder als Datei things/ablesio.things:

Bridge ablesio:account:home "ablesio-Konto" [ apiToken="ablesio_…" ] {
    Thing meter pergola "Pergola" [ meterNumber="FMH1B0307N" ]
}

Thing Pergola in openHAB — Das Thing „Pergola" – ONLINE, mit Kanälen und verknüpften Items. Schematische Darstellung

Schritt 3: Items verknüpfen

Datei items/ablesio.items – beim Gesamtertrag den Kanal deines Wechselrichters eintragen:

Number Pergola_Stand        "Pergola Stand [%.1f kWh]"   { channel="ablesio:meter:home:pergola:value" }
Number Pergola_Uebermitteln "Pergola übermitteln"        { channel="ablesio:meter:home:pergola:submitReading" }
String Pergola_Ergebnis     "Pergola Ergebnis [%s]"      { channel="ablesio:meter:home:pergola:lastSubmitStatus" }
// dein Gesamtertrag, z.B. vom Growatt-Binding – Kanal an deine Anlage anpassen:
Number Pergola_Gesamtertrag "Pergola Gesamtertrag [%.2f kWh]" { channel="…" }

Schritt 4: Wochen-Regel anlegen

Datei rules/ablesio.rules (DSL-Regel, ohne zusätzliches Add-on):

rule "ablesio – Pergola wöchentlich übermitteln"
when
    Time cron "0 0 20 ? * SUN"      // sonntags 20:00
then
    val ertrag = Pergola_Gesamtertrag.state
    if (ertrag instanceof Number) {
        Pergola_Uebermitteln.sendCommand((ertrag as Number).doubleValue)
    } else {
        logWarn("ablesio", "Pergola: kein gültiger Gesamtertrag – übersprungen")
    }
end

Regel mit Log — Log: übermittelt, Ergebnis im Item Pergola_Ergebnis. Schematische Darstellung

Schritt 5: Testen

In der openHAB-Konsole openhab:send Pergola_Uebermitteln 1360.19 eingeben (oder in der Oberfläche einen Wert setzen). Das Item Pergola_Ergebnis zeigt danach ok: … übermittelt.

Schritt 6: In ablesio ansehen

Wöchentliche Ablesungen der Pergola in ablesio — Jede Woche ein Stand: Ertrag und Ersparnis.

Zählerkarte Pergola — Die Zählerkarte zeigt die letzte Ablesung.

Gut zu wissen

Status / Meldung	Bedeutung
Konto OFFLINE: `API-Token abgelehnt: …`	Token ungültig oder widerrufen – neuen Token erstellen und im Konto eintragen
Zähler OFFLINE: `Zähler mit der Zählernummer … gibt es in ablesio nicht`	Zählernummer im Thing prüfen (wie in ablesio eingetragen)
`übersprungen: unverändert`	kein neuer Ertrag seit dem letzten Mal
`Fehler: Für diesen Zähler gibt es am … schon eine Ablesung`	ablesio nimmt einen Stand pro Kalendertag und Zähler an – der wöchentliche Sonntags-Termin passt immer, auch neben Ablesungen per Hand unter der Woche. Zweimal am selben Tag geht nicht; eine falsche Ablesung korrigierst du im Bericht mit ✏️.
`Fehler: kleiner als der letzte Stand`	falsches Item/falscher Kanal? Sonst Wechselrichter getauscht – in ablesio einen Zählerwechsel anlegen

Fragen? Über das Kontaktformular – oder Ablo in der App fragen.