Punkte

Überblick

Ein Point ist eine Größe, die Sie messen: Ihr Netzanschluss, ein Stromkreis, ein Gerät. Jeder Point ist an einen Kanal eines rbAmp-Moduls gebunden. Der Hub speichert seine Live-Werte, seine Historie und seine Kosten zu Ihrem Tarif.

Es gibt drei Arten von Points:

• Spannungsbus: die vom Modul gemessene Spannung. Sie ist die Bezugsgröße für die Leistung jedes Points.
• Eingang (Main): Ihre Versorgung, der Anschluss ans Netz. Er zeigt Ihren gesamten Anschluss: was Sie beziehen, einspeisen und bezahlen. (Die Kosten werden für jeden Point berechnet.)
• Reguläre Points: alles Übrige, etwa Stromkreise und Geräte.

Der Eingang und der Spannungsbus werden für Sie angelegt und können nicht gelöscht werden: „The main input and the voltage bus cannot be deleted.“ Standardmäßig ist der Eingang Modul 0, Kanal I0. Die Rolle Eingang lässt sich in der App nicht ändern.

Die Module selbst und das Hinzufügen eines Moduls finden Sie auf der Seite Sensors and modules.

Die Seite Points

Öffnen Sie Management → Points. Die Seite listet Ihre rbAmp-Module, Ihre Points und die freien Kanäle auf. Oben stehen Add a module (siehe Adding modules) und Refresh.

Während die Seite lädt, kann „Device is initializing — retrying…“ erscheinen (der Hub ist gerade gestartet) oder „Couldn't load sensors.“ mit Retry. „No sensors detected.“ bedeutet, dass der Hub kein Modul gefunden hat.

Bus-Warnungen

Die Module teilen sich einen I2C-Bus. Wenn dort etwas schiefgeht, erscheint oben eine Warnung:

Abschnitte

Die Seite hat diese Abschnitte, in dieser Reihenfolge:

1. Remote nodes (ESP-NOW): Auf einem Hub, der Nodes betreiben kann, steht dieser Abschnitt oben — das Funkmodul des Hubs für Nodes und eine Karte pro gekoppeltem Node. Die Kanäle eines Nodes sind Points wie alle anderen (siehe Remote nodes).
2. rbAmp modules (n): eine Karte pro Modul (siehe Module cards).
3. Points (n): Ihre gebundenen Points, je als Live-Kachel. Unter jeder Kachel steht ihre Adresse „module m · channel · I2C bus b · 0xaddr · model“ (bei einem Dreiphasen-Eingang: „module m · L1–L3 (3 phases) · I2C bus b“) und eine Schaltfläche Unbind.
4. Free sensors (n): Kanäle, die noch keinem Point zugeordnet sind, je mit einer Schaltfläche Bind. Ein Kanal, den das eingebaute Modul nicht hat, wird nicht angeboten. Sind alle Kanäle belegt, sagt die Seite: „No free channels. To add a point, connect another rbAmp module or unbind a point you don't need.“

Point entfernen

Unbind entfernt einen Point von seinem Kanal. Der Eingang, ein Reserve-Eingang und der Spannungsbus haben keine Schaltfläche Unbind, und ihre Rolle lässt sich in der App nicht ändern.

Die App bittet um Bestätigung. Der Point wird nicht mehr gemessen und verschwindet aus der Übersicht; der Sensorkanal bleibt frei und kann erneut gebunden werden. Unbind und Delete point (auf der Seite des Points) sind dieselbe Aktion: Beide entfernen den Point und löschen seine gespeicherte Historie endgültig. Falls Sie die Aufzeichnungen des Points später brauchen könnten, laden Sie sie vorher in History herunter (CSV).

Ist der Hub nicht erreichbar, meldet die App „Couldn't unbind the point“ oder „Unbind request failed (device unreachable?)“.

Point anlegen

Drücken Sie Bind bei einem freien Sensor. Der Dialog Bind sensor as a point zeigt oben die Adresse des Sensors („Module m · channel · I2C bus b · 0xaddr“).

Unten steht: „Home Assistant entities for the new point appear after the hub restarts.“

Rollen

Generation und Storage werden auf BASIC-Modulkanälen nicht angeboten. Grid input und Backup input stehen nicht in dieser Liste: Die Rolle Eingang lässt sich in der App nicht ändern.

Erzeugung messen

Montieren Sie die Zange genau wie jede andere: der Pfeil in der normalen Flussrichtung, die bei einem Erzeugungskreis vom Wechselrichter zum Haus zeigt. Es gibt keine umgedrehte Zange, keine besondere Verdrahtung und keinen Software-Schalter. Die Rolle erledigt den Rest: Ab Firmware v1.1.5 zählt ein Generation-Point den Fluss in Pfeilrichtung — von der Quelle zu den Verbrauchern — als Erzeugung; er zeigt dann negative Leistung, und seine Energie geht in Energy out.

⚠️ Negative Leistung an einem Generation-Point ist richtig — nicht „korrigieren“. Dafür ist die Rolle da. Die Zange umzudrehen, damit das Vorzeichen positiv aussieht, ist der einzige Weg, einen korrekt montierten Generation-Point zu verderben: Die Erzeugung landet dann in Energy in, und Produced bleibt bei null.

Zwei Dinge können allerdings schiefgehen:

• invert_sign aus einer älteren Firmware. Vor v1.1.5 brauchte ein Generation-Point es, um überhaupt Erzeugung zu lesen. Nach dem Update löschen Sie es (POST /api/v1/units/<id> {"invert_sign": false}), sonst liest der Point wieder Verbrauch: invert_sign kehrt das Ergebnis zusätzlich zur Rolle um.
• Der falsche Kanaltyp. Die Kanäle eines BASIC-Moduls zählen nur Verbrauch — sie sehen keine Einspeisung. Deshalb werden Generation und Storage dort nicht angeboten. Für Erzeugung braucht man einen Kanal, der die Richtung misst. Welche Module die Richtung messen: the rbAmp module guide.

Phase

Die Phase legt fest, wie die Last des Kanals in den Summen je Leitung einer Leitung zugeordnet wird. Bei einem BASIC-Modul nutzt jeder Kanal den einen Spannungseingang des Moduls, unabhängig von der gewählten Phase.

Die Optionen richten sich nach Ihrer Versorgung:

• noch kein Netzsystem eingestellt: nicht gesetzt, L1, L2, L3, 3 phases;
• einphasig: nicht gesetzt, L1;
• dreiphasig: nicht gesetzt, L1, L2, L3, 3 phases, L1–L2 (two-pole), L2–L3 (two-pole), L3–L1 (two-pole).

Eine Option mit der Markierung „not validated on hardware“ wurde noch nicht an echter Hardware geprüft. Ein Dreiphasen-Eingang ist ein Satz STD-U3I3-Module mit Use as the three-phase input auf seiner Modulkarte (siehe Sensors and modules).

ID wiederverwenden

Wählen Sie die ID eines entfernten Points, warnt der Dialog, dass Home Assistant und MQTT den Point über seine ID kennen und seine alte Historie als einen Point fortführen. Speist der Kanal jetzt eine andere Last, vergeben Sie eine neue ID. Die Schaltfläche heißt dann Bind with the previous ID. Ab Firmware v1.1.6 löscht der Hub beim Entfernen eines Points auch dessen Nettozählungs-Eintrag, sodass eine wiederverwendete ID ihr Guthaben bei null beginnt; bei v1.1.5 und älter übernahm er das Guthaben und den Periodensaldo des entfernten Points.

Meldungen

• „This point will show live values only: the hub keeps history for 12 points.“ — alle 12 Historienplätze sind belegt. Der Point zeigt weiterhin Live-Werte.
• „ID «id» is already used by another point.“ — wählen Sie eine andere ID.
• „Could not bind“ / „Bind request failed (device unreachable?)“ — prüfen Sie die Verbindung zum Hub und versuchen Sie es erneut.

Einen Point, den Sie bei laufendem Hub binden, speichert seine Historie ab dem nächsten Neustart. Der Hub speichert die Historie jedes Points stündlich und bildet Tage, Monate und Jahre aus den Stunden; beim Binden gibt es deshalb keine Historieneinstellung.

Die Seite eines Points

Tippen Sie auf eine Point-Kachel, um ihre Seite zu öffnen.

Kopfzeile

Back, der Name des Points und eine Zeile „role · source · status“. Die Quelle ist rbAmp oder rbAmp BASIC. Der Status ist normal, no data oder no such channel on the module.

Chips unter dem Kopf zeigen, was der Point messen kann:

• measures import and export, consumption only oder consumption only (BASIC module);
• current only — monitoring, not energy metering: ein Modul, das nur Strom misst;
• energy kept across restarts;
• phase: phase.

Hinweise

Braucht etwas Aufmerksamkeit, erscheint unter dem Kopf ein Hinweis:

Live-Werte

Voltage (bei einem Dreiphasen-Point der Phasenmittelwert), Current (die Summe der Phasen), Power und, falls die Quelle sie misst, Reactive und PF. Eine Spannung, die mehr als 10 % vom Nennwert abweicht, wird rot als low oder high markiert. Einspeisung erscheint als „↑ W“ in der Farbe für Export.

Ein Dreiphasen-Eingang ergänzt eine Tabelle Per phase (U3I3): L1, L2, L3 mit Spannung, Strom, Leistung, Blindleistung und PF.

Verlauf

Ein kleines Diagramm mit Power, Voltage oder Energy, nach Hours, Days oder Weeks. Es zeigt die letzten 48 Punkte bei Linien und die letzten 24 Balken bei Energie. Erzeugungs-Points zeichnen ihre Leistung als positiv. As a table öffnet dieselben Daten in History.

Zähler

Nicht angezeigt bei Modulen, die nur Strom messen.

• Imported today, mit „≈ Geld“ zum durchschnittlichen Bezugspreis des Tages;
• Exported today (bei einem Erzeugungs-Point Produced today), mit Wert, wenn über null;
• Total imported;
• Total exported (bzw. Produced in total), wenn über null; nicht bei BASIC-Modulen.

Ladestation

Ein Point mit der Rolle Charging station zeigt außerdem Current session: Status und Energy today.

Der Status wird aus der Leistung des Points abgeleitet, auf jedem Kanal — auch auf einem gewöhnlichen rbAmp-Kanal; es ist keine Steuerung der Ladestation beteiligt, und die Bezeichnung trägt den Tooltip „derived from power“. Er zeigt Charging, solange die Leistung des Points über der Ladeschwelle liegt — der eigenen der Station, sonst der Einstellung des Hubs, sonst 500 W — und Available darunter. Energy today ist der heutige Bezug des Points; der Hub führt keine Ladehistorie je Sitzung.

Point-Einstellungen

Unten öffnet Point setup die Einstellungen des Points (siehe Point settings), die Technical details (IDs und Kanal, nützlich für den Support) und Delete point.

Delete point verlangt eine Bestätigung: Der Point wird nicht mehr gemessen und verschwindet aus der Übersicht und der Punkteliste, und seine gespeicherte Historie wird endgültig gelöscht — ab Firmware v1.1.6 zusammen mit seinem Nettozählungs-Eintrag. Der Sensorkanal wird frei und kann erneut gebunden werden. Danach kehren Sie zu Points zurück. Falls Sie die Aufzeichnungen des Points später brauchen könnten, laden Sie sie vorher in History herunter (CSV). Der Eingang und der Spannungsbus können nicht gelöscht werden.

Point-Einstellungen

Point settings speichert nur die Felder, die Sie geändert haben. Solange Sie ungespeicherte Änderungen haben, bleiben Save und Cancel unten am Bildschirm; wollen Sie die Seite verlassen, fragt die App zuerst nach. Es gibt keinen eigenen Bearbeitungsmodus.

Fixed in v1.1.4: Auf Hub-Firmware v1.1.3 und älter konnte auf ESP32-Chiprevisionen vor v3 das Umbenennen eines Points dazu führen, dass er nach dem nächsten Neustart samt Historie verschwand. Aktualisieren Sie den Hub auf v1.1.4, bevor Sie Points umbenennen. Die Revision Ihres Chips sehen Sie, wenn Sie die Platine per USB anschließen und python -m esptool --chip esp32 -p <PORT> chip_id ausführen: Die Ausgabe zeigt etwa „ESP32-D0WD (revision v1.1)“.

Points innerhalb anderer Points

Ab Firmware v1.1.8 kann ein Point als innerhalb eines anderen gemessen markiert werden. Nutzen Sie das immer dann, wenn eine Ihrer Zangen schon einen anderen mitmisst: ein Unterverteiler und ein daraus gespeister Stromkreis, ein Summenzähler und eine Last dahinter. Das Feld sagt es in einer Zeile: „If this load sits behind another point's meter (a sub-panel with its own meter, say), pick that point. Its power then counts once, in that point, and not again in the rest of the input.“

Was es ändert und was nicht:

• die Gesamtwerte des Hubs ändern sich nicht — sie werden am Eingang erfasst und hingen nie von Ihren Points ab;
• die nicht gemessene Größe zieht die innere Last nicht mehr doppelt ab. Ohne die Markierung werden Unterverteiler und die Last darin beide gegen den Eingang gerechnet; das nicht gemessene Ergebnis fällt dann zu niedrig aus, und bei gut gemessenem Verteiler kann es negativ werden. → Economics

⚠️ Markieren Sie den inneren Point, nicht den äußeren. Die Einstellung besagt „dieser Point liegt schon innerhalb jenes“. Die umgekehrte Angabe beschreibt einen Verteiler, den Sie nicht haben.

Wird ein Point gelöscht — auch durch Entfernen des Nodes, der ihn trug —, werden die Points darin wieder oberste Ebene. So korrigiert sich die Zahl von selbst, statt einen nicht mehr vorhandenen übergeordneten Point stillschweigend zu behalten.

Über die API geschieht dies mit PATCH /api/v1/units/{id} und {"inside": <point id>}; 0, "" oder null heben es auf, und units-config meldet inside für jeden Point.

Prüfungen von Grenzwerten und Schutzschaltern

• Über 1000 kW: Die App bittet Sie, die Einheiten zu prüfen (das Feld ist in kW), und speichert nicht.
• Mehr als der Leitungsschutzschalter erlaubt oder (beim Eingang) deutlich darunter: Die App warnt und bietet einen passenden Wert an, berechnet aus Schutzschalter, Nennspannung und Anzahl der Leiter.
• Liegt der Schutzschalter über dem Limit des Sensors, warnt die App, dass Strom oberhalb des Limits abgeschnitten wird und die Messung zu wenig zählt: Montieren Sie einen Sensor mit höherem Nennwert. Das Limit ist der Strom, ab dem die Zange zu begrenzen beginnt, so wie der Hub ihn meldet — bei SCT-013-Zangen rund 16 % über dem Nennwert, also etwa 11.6 A bei einer 10-A-Zange — und es ist das obere Ende des Bereichs „accurate … A“, der auf der Modulkarte und in den Point-Einstellungen angezeigt wird. Eine Zange mit dem Nennwert des Schutzschalters warnt nicht. Meldet der Hub keinen solchen Wert, gibt es keinen Bereich und keine Warnung; das gilt für die werkseitig gekoppelten Sensoren eines STD-Moduls. Bei App v1.1.4 und älter prüfte die Kontrolle ein Limit 10 % unter dem Nennwert der Zange, sodass sie auch warnte, wenn der Nennwert dem Schutzschalter entsprach.

Stromsensor

Bei einem SCT-Kanal wählen Sie die tatsächlich montierte Zange. Das neue Modell wird sofort übernommen, und das Modul startet neu; der Hub nicht. War der Kanal werkseitig mit Ihrem Sensor kalibriert, geht diese Kalibrierung verloren und lässt sich nicht wiederherstellen; ändern Sie das Modell also nur, wenn wirklich ein anderer Sensor montiert ist. Bei einem CT-Modul der Serie oder bei einem unkalibrierten Modul lässt sich das Modell nicht wählen. Die unterstützten Modelle stehen unter Channel CT model.

Nach dem Speichern

• „Point settings saved.“
• Nach einer Rollenänderung: „Saved. The role applies immediately; history depth for the new role takes effect after the device reboots.“
• „Not saved: …“ mit dem Grund. Braucht der Hub ein Admin-Token, sagt die App das.

Was der Hub für jeden Point speichert

Jeder Datensatz enthält:

• elektrische Werte: mittlere Spannung, Strom und Leistung, Blind- und Scheinleistung, Leistungsfaktor, Frequenz sowie das Minimum und Maximum von Spannung, Strom und Leistung;
• Energie: im Zeitraum bezogen und eingespeist sowie die Gesamtzähler;
• Kosten und Exportwert zu Ihrem Tarif;
• eine Qualitätsmarkierung: etwa eine Teilperiode, eine nicht synchronisierte Uhr oder eine Lücke.

Wie lange die Historie gespeichert wird

Alles liegt im eigenen Flash-Speicher des Hubs; es ist kein Speichermodul nötig.

Wie viele Points eine Historie speichern

Bis zu 12 Points speichern eine Historie (die ersten zwölf, die Sie angelegt haben). Points darüber zeigen Live-Werte, speichern aber keine Historie.

Einen Point, den Sie bei laufendem Hub binden, speichert seine Historie ab dem nächsten Neustart: Die App erinnert Sie daran („Restart the hub to start its history“).

Daten lesen

• History zeigt einen Point nach Stunde, Tag oder Monat (siehe History). Der Trend auf der Seite des Points kann auch Wochen zeigen.
• Economics zeigt Kosten und Exportwert eines Points nach Zeitraum (siehe Tariffs).
• Die REST-API und der CSV-Export liefern dieselben Datensätze (siehe Source & API).

Fehlerbehebung

Ein Point zeigt keine Daten

• Prüfen Sie, ob das Modul angeschlossen ist und seine Karte unter Points → rbAmp modules erscheint (siehe Sensors and modules).
• Prüfen Sie, ob der Point an den Kanal gebunden ist, an dem die Zange hängt.
• Zeigt die Seite eine Bus-Warnung, siehe Bus warnings.

Die Messwerte eines Points wirken falsch

• Prüfen Sie das Zangenmodell bei SCT-Kanälen (Current sensor) und dass die Zange auf ihrem eigenen Kanal sitzt.
• Prüfen Sie die Richtung der Zange anhand der Pfeilmarkierung (siehe die Dokumentation der rbAmp-Module).

Ein Point ist nach einem Neustart verschwunden

• Haben Sie ihn auf Hub-Firmware v1.1.3 oder älter umbenannt: Das ist ein bekannter Fehler auf ESP32-Chiprevisionen vor v3, behoben in v1.1.4 (siehe Point settings). Aktualisieren Sie den Hub und binden Sie den Kanal dann als neuen Point erneut.

Ein Point hat Live-Werte, aber keine Historie

• Haben Sie ihn bei laufendem Hub angelegt, starten Sie den Hub neu.
• Vielleicht ist es der dreizehnte Point oder ein späterer: Nur zwölf Points speichern Historie, die des Hubs und seiner Nodes zusammen.
• Prüfen Sie, ob die Uhr des Hubs gestellt ist (siehe Time). Datensätze ohne echtes Datum werden übersprungen.

Die nicht gemessene Größe ist negativ oder viel zu klein

• Einer Ihrer Points wird schon von einem anderen gemessen — ein Unterverteiler und ein Stromkreis dahinter. Markieren Sie den inneren als measured inside des äußeren (Firmware v1.1.8, siehe Points inside other points oben).
• Ein erzeugender Stromkreis mit falscher Rolle landet im falschen Block: Erzeugung ist keine Leitung und wird nie abgezogen. → Economics

Ein Erzeugungs-Point zeigt Verbrauch

• Ab Firmware v1.1.5 bestimmt die Rolle selbst die Richtung; ein invert_sign aus einer älteren Firmware kehrt sie zurück. Löschen Sie ihn (siehe Roles).

Der Point eines Nodes hat nach einem Neustart Name, Rolle oder Nennwerte verloren

• Das wurde in Firmware v1.1.8 behoben: Node-Points werden beim Start aus der Node-Liste neu aufgebaut, und bis v1.1.8 wurden ihr Name, ihre Rolle, Nennwerte, Zangenausrichtung und measured inside auf Standardwerte zurückgesetzt. Bei v1.1.7 und älter stellen Sie sie nach jedem Neustart erneut ein — oder aktualisieren Sie den Hub. → Remote nodes

„Measured inside“ lässt sich nicht setzen

• Das Ziel muss ein bestehender Point sein, nicht dieser Point und nicht der Eingang, und die Kette darf nicht zurückführen. Das Feld erscheint erst ab Firmware v1.1.8.