rbAmp
DE
Shop
Docs
Aktualisiert · Auf GitHub bearbeiten (Edit on GitHub)

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:


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.

YAML
# 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:

Text
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):

Text
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:

YAML
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.

YAML
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.

YAML
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:

  1. 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 state ohne status lesen.

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.

  1. Änderung von topic_prefix: zwischen Firmware-Builds. Wenn Sie topic_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 -t '' -r -n). Ohne das bleiben die Zombies hängen, bis jemand sie manuell löscht.

  1. Geburtsnachricht und start_session: true für die Wiederverbindung nach einem Broker-Neustart — siehe die Dokumentation des ESPHome-Blocks mqtt: zu den Optionen clean_session: und keepalive:. 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.

YAML
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)

YAML
# 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.

YAML
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.

YAML
# 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);
Hinweis

: 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:

Python
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.

YAML
# 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)