07 · DIY-Integrationen
Dieses Kapitel behandelt die Nutzung von rbAmp über das Standard-HA-Energie-Dashboard hinaus: Export in externe Zeitreihendatenbanken, Veröffentlichung über MQTT ohne HA, Laststeuerung im geschlossenen Kreis und das Auslesen von rbAmp durch Nicht-ESPHome-Master.
Cross-references:
- YAML-Schema:
09_api_reference.md - HA-Details:
08_has_integrations.md - Arduino-Client-Bibliothek:
rbamp-arduino - ESP-IDF-Client-Bibliothek:
rbamp-esp-idf - Python (CPython + MicroPython):
rbamp-python
1 · InfluxDB und Grafana über Home Assistant
Der einfachste Weg zu InfluxDB + Grafana erfordert keine YAML-Änderungen. Home Assistant exportiert alle Entitätszustände über seine native Integration nach InfluxDB:
Home-Assistant-YAML (nicht ESPHome) — gehört in Ihre Home-Assistant-Konfiguration, nicht in das YAML des Knotens.
# configuration.yaml in HA
influxdb:
host: 192.168.0.100 # your InfluxDB host
port: 8086
database: homeassistant
default_measurement: state
include:
entities:
- sensor.rbamp_ui1_mains_voltage
- sensor.rbamp_ui1_mains_current
- sensor.rbamp_ui1_mains_power
- sensor.rbamp_ui1_mains_energy
- sensor.rbamp_ui1_mains_power_factor
- sensor.rbamp_ui1_mains_frequency
Jede Sensor-Veröffentlichung von rbAmp (einmal pro update_interval) wird zu einem Punkt in InfluxDB. Grafana fragt dann InfluxDB ab und baut die Dashboards.
Ein minimales Grafana-Panel für die Live-Leistung:
SELECT mean("value") FROM "state"
WHERE "entity_id" = 'sensor.rbamp_ui1_mains_power'
AND $timeFilter
GROUP BY time(1m)
Für InfluxDB 2.x (Flux):
from(bucket: "homeassistant")
|> range(start: v.timeRangeStart, stop: v.timeRangeStop)
|> filter(fn: (r) => r["entity_id"] == "sensor.rbamp_ui1_mains_power")
|> aggregateWindow(every: 1m, fn: mean, createEmpty: false)
Hochauflösendes InfluxDB (unter Umgehung von HA)
Die Zustandsmaschine von HA speichert nur Zustandsänderungen. Für eine dichte Reihe mit einem Punkt alle 60 s (dem Standard von update_interval) ist HA ausreichend. Brauchen Sie eine Auflösung unter einer Minute, senken Sie update_interval und lassen den HA-Recorder + die InfluxDB-Integration mit dieser Rate erfassen:
rbamp:
id: meter1
update_interval: 10s # 10-second resolution — ×6 I²C traffic, acceptable
2 · Direkte MQTT-Veröffentlichung (ohne HA)
ESPHome hat eine eingebaute Komponente mqtt:, die alle Sensorzustände an einen Broker veröffentlicht. rbAmp-Sensoren werden bei jedem update_interval wie alle anderen veröffentlicht.
esphome:
name: rbamp-mqtt
esp32:
board: esp32dev
framework:
type: arduino
logger:
level: INFO
wifi:
ssid: !secret wifi_ssid
password: !secret wifi_password
# NOTE: use mqtt: OR api: — not both at the same time, unless you
# specifically need both the HA native API and MQTT in parallel
# (supported, but non-standard).
mqtt:
broker: 192.168.0.200 # IP of your MQTT broker
port: 1883
username: !secret mqtt_user
password: !secret mqtt_pass
topic_prefix: rbamp/ui1 # all sensor topics under this prefix
birth_message:
topic: rbamp/ui1/status
payload: online
will_message:
topic: rbamp/ui1/status
payload: offline
i2c:
sda: GPIO21
scl: GPIO22
frequency: 50kHz
scan: true
external_components:
- source:
type: local
path: ../components
components: [rbamp]
rbamp:
id: meter1
address: 0x50
update_interval: 60s
ct_model: SCT_013_030
sensor:
- platform: rbamp
rbamp_id: meter1
voltage:
name: "Mains Voltage"
current:
name: "Mains Current"
power:
name: "Mains Power"
energy:
name: "Mains Energy"
frequency:
name: "Mains Frequency"
power_factor:
name: "Mains Power Factor"
Mit topic_prefix: rbamp/ui1 veröffentlicht ESPHome:
| MQTT-Topic | Nutzlast |
|---|---|
rbamp/ui1/sensor/mains_voltage/state |
226.70 |
rbamp/ui1/sensor/mains_current/state |
0.755 |
rbamp/ui1/sensor/mains_power/state |
92.80 |
rbamp/ui1/sensor/mains_energy/state |
1024.341 |
rbamp/ui1/sensor/mains_frequency/state |
50 |
rbamp/ui1/sensor/mains_power_factor/state |
0.542 |
rbamp/ui1/status |
online / offline |
Jeder MQTT-Abonnent — Node-RED, InfluxDB Telegraf, OpenHAB, ein eigenes Python-Skript — kann diese Topics direkt verarbeiten.
MQTT-beibehaltene Nachrichten
Ergänzen Sie retain: true an jedem Sensor, wenn Abonnenten, die sich nach einer Veröffentlichung verbinden, sofort den letzten Wert sehen müssen:
Setzt voraus, dass Sie bereits einen Block mqtt: im YAML des Knotens haben.
sensor:
- platform: rbamp
rbamp_id: meter1
voltage:
name: "Mains Voltage"
# ESPHome MQTT does not set retain on sensor state by default. For retain,
# use a manual publish action:
on_value:
- mqtt.publish:
topic: "rbamp/ui1/voltage"
payload: !lambda 'return to_string(x);'
retain: true
MQTT-Retain und OTA — was Sie wissen müssen
Beibehaltene Nachrichten überstehen einen Neustart des ESP32 (dafür sind sie ja da). Daraus ergeben sich zwei Szenarien, die man im Voraus kennen sollte:
- OTA-Update eines Knotens. Nach dem Flashen startet der ESP32 neu. Die alten Retained-Werte bleiben im Broker und sind für Abonnenten ca. 5..30 Sekunden sichtbar (bis der Knoten sich wieder verbindet und neue veröffentlicht). Kommt der Knoten nie zurück (beschädigte Firmware, fataler Absturz beim Start), werden die alten Retained-Werte unbegrenzt angezeigt. Dadurch wird der Offline-Zustand für Dashboards verdeckt, die nur
stateohnestatuslesen.
Abhilfe: Setzen Sie immer eine will_message: (LWT) auf dem Topic status (wie im Beispiel oben). Der Broker setzt die Nutzlast offline, wenn die Verbindung abbricht; Abonnenten können status beobachten, um hängende Knoten zu erkennen. Die Sensor-Topics behalten in diesem Fall die alten Werte — das ist normal, aber Abonnenten wissen dann, dass die Daten veraltet sind.
- Änderung von
topic_prefix:zwischen Firmware-Builds. Wenn Sietopic_prefix:umbenennen (z. B.rbamp/ui1→rbamp/kitchen) und den Knoten per OTA aktualisieren, bleiben die beibehaltenen Nachrichten unter dem alten Präfix dauerhaft im Broker. Nicht informierte Abonnenten sehen weiterhin veraltete Daten aus den Zombie-Topics.
Gegenmaßnahme: Löschen Sie vor einem OTA mit umbenanntem Präfix die alten Retained-Nachrichten, indem Sie auf jedem alten Topic eine leere Nutzlast mit retain: true veröffentlichen (CLI: mosquitto_pub -h ). Ohne das bleiben die Zombies hängen, bis jemand sie manuell löscht.
- Geburtsnachricht und
start_session: truefür die Wiederverbindung nach einem Broker-Neustart — siehe die Dokumentation des ESPHome-Blocksmqtt:zu den Optionenclean_session:undkeepalive:. Diese Parameter steuern, wie der Broker ausstehende QoS-1/2-Nachrichten bei einer Trennung behandelt.
3 · ESPHome-Lambda-Aktionen
Der ESPHome-Callback on_value wird bei jedem neuen Sensorwert ausgelöst. Sie können ihn für Schwellwertaktionen nutzen, die vollständig auf dem ESP32 laufen, ohne Umweg über HA.
Alarm bei Stromschwelle
Setzt voraus, dass Sie bereits einen Eintrag switch: mit der unten verwendeten ID haben.
sensor:
- platform: rbamp
rbamp_id: meter1
current:
name: "Mains Current"
on_value:
then:
- if:
condition:
lambda: 'return x > 15.0f;' # over-current threshold 15 A
then:
- logger.log:
level: WARN
format: "Over-current: %.2f A — triggering alarm relay"
args: [x]
- switch.turn_on: alarm_relay
Erkennung eines Laststufen-Sprungs (eigenes Lambda)
# Detecting a sharp increase in load (e.g. a compressor start)
globals:
- id: prev_power
type: float
initial_value: '0.0'
sensor:
- platform: rbamp
rbamp_id: meter1
voltage: # power needs voltage AND current in the same block
name: "Mains Voltage"
internal: true
current:
name: "Mains Current"
internal: true
power:
name: "Mains Power"
on_value:
then:
- lambda: |-
float delta = x - id(prev_power);
if (delta > 500.0f) {
ESP_LOGI("rbamp", "Large load step detected: +%.0f W", delta);
}
id(prev_power) = x;
Veröffentlichung auf ein eigenes MQTT-Topic bei Erreichen eines Schwellenwerts
Setzt voraus, dass Sie bereits einen Block mqtt: im YAML des Knotens haben.
sensor:
- platform: rbamp
rbamp_id: meter1
voltage: # power needs voltage AND current in the same block
name: "Mains Voltage"
internal: true
current:
name: "Mains Current"
internal: true
power:
name: "Mains Power"
on_value:
- if:
condition:
lambda: 'return x > 2500.0f;'
then:
- mqtt.publish:
topic: "alerts/high_power"
payload: !lambda >
return "HIGH_POWER:" + to_string((int)x) + "W";
4 · Regelung im geschlossenen Kreis — PID für den Warmwasserbereiter
Ein typischer Anwendungsfall für die rbAmp-Hausmessung ist der Solar-Eigenverbrauch: Warmwasser mit dem Solarüberschuss erwärmen, statt ihn ins Netz einzuspeisen.
Das Muster verwendet zwei rbAmp-Module: eines an der Netzeinspeisung (Bezug / Export), eines am Stromkreis des Warmwasserbereiters. Ein PWM-Relais oder ein SSR am Heizer ermöglicht eine variable Leistungsregelung.
# Conceptual sketch — the concrete PID implementation depends on your
# relay / SSR and load. The PID controller component in ESPHome is the
# recommended building block.
globals:
- id: solar_export_w
type: float
initial_value: '0.0'
- id: heater_setpoint_w
type: float
initial_value: '0.0'
rbamp:
- id: meter_grid
address: 0x50
update_interval: 10s # tighter loop for responsive control
- id: meter_heater
address: 0x51
update_interval: 10s
sensor:
- platform: rbamp
rbamp_id: meter_grid
voltage: { name: "Grid Voltage", internal: true } # power needs voltage AND current
current: { name: "Grid Current", internal: true }
power:
name: "Grid Power"
# Positive = import, negative = export (STANDARD (STD) with correct wiring)
on_value:
- lambda: |-
// If grid power is negative, that is export (solar surplus).
// Raise the heater setpoint to absorb the surplus.
float export_w = -x;
if (export_w > 100.0f) {
float sp = std::min(export_w, 2000.0f);
id(heater_setpoint_w) = sp;
} else {
id(heater_setpoint_w) = 0.0f;
}
output:
- platform: ledc # PWM output to an SSR or 0-10V controller
pin: GPIO5
id: heater_pwm
frequency: 100Hz
interval:
- interval: 10s
then:
- lambda: |-
// Drive PWM proportionally to the setpoint (0–2000 W → 0–100% duty)
float duty = id(heater_setpoint_w) / 2000.0f;
id(heater_pwm).set_level(duty);
: bidirektionale Leistung (negative Werte = Export) erfordert ein STANDARD (STD)-Modul mit korrekter Spannungspolarität. Bei BASIC begrenzt die Firmware die mittlere Wirkleistung über die Periode auf P ≥ 0 — die Momentan-Wirkleistung kann im Moment der Einspeisung noch negativ anzeigen, aber der Akkumulator der Exportperiode bleibt leer. Das Verhalten je Stufe steht in 02_tiers.md, die Polaritätsverdrahtung in 04_hardware.md.
5 · Verkettete Callbacks über die ESPHome-API
Die native ESPHome-API (Port 6053) kann genutzt werden, um externe Python-Skripte über die WebSocket-API auszulösen, ohne dass Home Assistant dauerhaft läuft.
Die Python-Bibliothek aioesphomeapi (pip install aioesphomeapi) bietet direkten asynchronen Zugriff auf Entitätszustände:
import asyncio
from aioesphomeapi import APIClient
async def main():
cli = APIClient("rbamp-ui1.local", 6053, "")
await cli.connect(login=True)
def on_state(state):
# Called on every sensor publication
print(f"State: {state}")
await cli.subscribe_states(on_state)
await asyncio.Event().wait() # runs forever
asyncio.run(main())
Das Muster ist nützlich für:
- Einspeisung der rbAmp-Messwerte in eine eigene Regelschleife, die nicht in das YAML-Lambda-Modell von ESPHome passt.
- Protokollierung in ein eigenes Format oder eine Datenbank.
- Schwellenwertlogik in Python, wenn die 512 KB RAM des ESP32 für komplexe Mathematik zu knapp sind.
Der API-Client läuft auf jedem Python-3.8+-Host im selben Netzwerk — einem Raspberry Pi, einem Docker-Container, einem Entwicklungslaptop.
6 · Scheinleistung — clientseitige Berechnung
Ist apparent_power im Block sensor: deklariert, berechnet die Komponente S = U_rms × I_rms[ch0] auf dem ESP32 aus zwei aktuellen Messwerten. Brauchen Sie die Scheinleistung für mehrere Kanäle (CH1, CH2) oder wollen Sie sie aus HA-Entitäten statt aus der Komponente ableiten, verwenden Sie in HA einen template-Sensor:
Home-Assistant-YAML (nicht ESPHome) — gehört in Ihre Home-Assistant-Konfiguration, nicht in das YAML des Knotens.
# configuration.yaml in HA
template:
- sensor:
- name: "CH1 Apparent Power"
unit_of_measurement: "VA"
device_class: apparent_power
state_class: measurement
state: >
{% set u = states('sensor.rbamp_ui3_mains_voltage') | float(0) %}
{% set i = states('sensor.rbamp_ui3_ch1_current') | float(0) %}
{{ (u * i) | round(1) }}
- name: "CH2 Apparent Power"
unit_of_measurement: "VA"
device_class: apparent_power
state_class: measurement
state: >
{% set u = states('sensor.rbamp_ui3_mains_voltage') | float(0) %}
{% set i = states('sensor.rbamp_ui3_ch2_current') | float(0) %}
{{ (u * i) | round(1) }}
Hinweis: apparent_power im ESPHome-Schema verwendet nur den Strom von CH0. Die obige Vorlage ist für CH1/CH2 bei UI2/UI3-Installationen die empfohlene Methode.
7 · rbAmp ohne ESPHome auslesen
Das rbAmp-Modul ist ein gewöhnlicher I²C-Slave. Jeder I²C-Master kann es mit dem Protokoll aus der API-Referenz des Moduls lesen. Die Schwester-Client-Bibliotheken (Verteil-Repositorys — Platzhalter bis zur Veröffentlichung):
| Bibliothek | Verteilung | Sprache | Zielplattform |
|---|---|---|---|
| Arduino | rbamp-arduino |
C++ | ESP32 (Arduino-Framework), AVR, RP2040 |
| ESP-IDF | rbamp-esp-idf |
C | ESP32 (IDF-Framework) |
| Python (CPython + MicroPython) | rbamp-python |
Python 3 | Raspberry Pi, Linux-SBC, PC, ESP32/RP2040/STM32 mit MicroPython |
Alle Bibliotheken implementieren dieselbe Registerkarte und dasselbe Periodenzählprotokoll wie die ESPHome-Komponente. Sie können unabhängig oder parallel verwendet werden.
Wann Sie ESPHome NICHT verwenden sollten
- Sie haben bereits eine ESP32-Firmware ohne ESPHome und müssen rbAmp-Lesungen ergänzen — verwenden Sie die ESP-IDF-Bibliothek und rufen die API direkt auf.
- Der Master ist ein Raspberry Pi oder ein anderer Linux-SBC — verwenden Sie die Python-Bibliothek.
- Sie haben eine STM32-SPS oder eine eigene Platine — STM32 HAL.
- Ein schneller Prototyp auf einem Arduino UNO oder Leonardo — die Arduino-Bibliothek.
Plattformübergreifende Energieakkumulation — ein Hinweis
Die ESPHome-Komponente verwendet NVS-persistierte double-Akkumulatoren, die einen Neustart überstehen (bei STANDARD-Modulen werden sie zusätzlich aus den eigenen Energiezählern des Moduls gespeist). Die Schwesterbibliotheken nutzen eventuell andere Persistenzmechanismen — Details und Vorwärtskompatibilität einer bestimmten Bibliothek finden Sie in ihrer 10_troubleshooting.md (Abschnitt Energiepersistenz). Wenn Sie von ESPHome auf Bare-Metal-Firmware migrieren, planen Sie die Datenmigration: Exportieren Sie den letzten Wh-Wert aus HA vor dem Wechsel und setzen Sie den Akkumulator der neuen Firmware damit.
8 · Tasmota- / WLED- / OpenHAB-Brücken
Tasmota
Tasmota hat keinen nativen rbAmp-Treiber. Die sauberste Brücke ist, ESPHome als rbAmp-Leser und Tasmota als separaten I²C-Master für andere Geräte zu verwenden, ohne beides zu vermischen.
Wenn Sie Tasmota speziell für rbAmp brauchen, verwenden Sie Berry-Scripting (Tasmota 12.x+), um einen eigenen Treiber zu schreiben, der die I²C-Lesungen durchführt — einzelnes Byte pro Adressphase für Schreibvorgänge, optional READ-Burst für den Block der Momentanwerte (siehe 09 · API-Referenz). Die MicroPython-Bibliothek aus rbamp-python ist eine nützliche Referenz für Registeradressen und Float-Dekodierung.
WLED
WLED (Firmware für LED-Controller) stellt in Benutzerskripten keinen I²C-Master bereit. rbAmp und WLED können nur dann unabhängige Geräte am selben Bus sein, wenn sie auf getrennten Bussegmenten liegen oder sich nicht überschneidende Adressen haben. Eine offizielle Brücke gibt es nicht.
OpenHAB
ESPHome veröffentlicht Daten über MQTT (siehe Beispiel 2) oder die native API (aioesphomeapi). Die OpenHAB-MQTT-Bindung kann die ESPHome-Topics abonnieren und rbAmp-Messwerte in OpenHAB-Regeln und Items bereitstellen. Die Konfiguration der MQTT-Bindung ist in der OpenHAB-Dokumentation beschrieben.
Quelle und Probleme: rb-amp/rbamp-esphome · diese Seite im Repository: docs/07_diy_integrations.md (v1.9.1)