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

01 · Überblick

rbAmp-Signalkette: Sensor → Modul → I²C → Master → Cloud / Home Assistant

Was rbAmp ist

rbAmp ist ein kompaktes Hardwaremodul zur präzisen Messung von Netzwechselstromgrößen. Aus Sicht des Integrators ist es ein gewöhnlicher I²C-Slave: Spannung anlegen, ein Register lesen, und Sie erhalten einen sofort nutzbaren Wert in physikalischen Einheiten. Auf der Master-Seite ist keine Signalverarbeitung nötig. Die Werkskalibrierung wird einmal in der Produktion durchgeführt und im Flash des Moduls gespeichert; dem Nutzer bleibt nur, das CT-Zangenmodell zu wählen (siehe 03_sensor_selection.md) und den Bus zu verdrahten.

Datenfluss (in einer Zeile)

Datenfluss der ESPHome-Komponente: Netz, CT-Klemme, rbAmp-Modul, I²C, Komponente rbamp, publish_state() und Home Assistant.

Der entscheidende Vorteil: physikalische Größen kommen vom Modul sofort nutzbar. Auf der ESP32-Seite gibt es keine Signalverarbeitung, keine Kalibriertabellen und keine RMS-/Leistungsrechnung. Die ESPHome-Komponente ist ein schlanker I²C-Client + ein Energieakkumulator + eine Veröffentlichungsschicht zu HA. Für den Grundbetrieb ist kein lambda:-Code nötig.

rbAmp im ESPHome-Ökosystem

Wenn Sie bereits die eingebauten Energiezähler verwendet haben (pzemac über UART, atm90e32 über SPI, cse7766 über UART), folgt dies derselben Struktur. Die Komponente rbamp ist ein „gut erzogener“ Teil von ESPHome: Sie nutzt den Standardtransport i2c:, die Standardsyntax sensor.platform: rbamp, Standard-Sensorslots mit device_class / state_class / unit_of_measurement und unterstützt den vollen Standardsatz an Sensorfiltern und Eigenschaften.

Vergleichen Sie den Aufbau (das mentale Modell ist identisch):

YAML
# ATM90E32 (SPI meter) — shown for comparison only, not part of an rbAmp config:
spi:
  clk_pin: GPIO18
  miso_pin: GPIO19
  mosi_pin: GPIO23

sensor:
  - platform: atm90e32
    cs_pin: GPIO5
    voltage_a:
      name: "Mains Voltage"
    power_a:
      name: "Mains Power"
YAML
# rbAmp (I²C meter) — a separate file, do not paste both:
i2c:
  sda: GPIO21
  scl: GPIO22
  frequency: 50kHz

rbamp:
  id: meter1
  address: 0x50

sensor:
  - platform: rbamp
    rbamp_id: meter1
    voltage:
      name: "Mains Voltage"
    current:                       # power needs voltage AND current declared
      name: "Mains Current"
    power:
      name: "Mains Power"

Die einzigen Unterschiede sind der Transport (i2c: statt spi:) und dass rbamp: als eigener Block deklariert wird (er braucht eine id: + address: für einen Mehrmodul-Bus). Alles Übrige ist gewöhnliches ESPHome: Die Slot-Namen (voltage, current, power, energy, frequency, power_factor) sind wiederzuerkennen, und die Anpassung (name, update_interval, accuracy_decimals, filters:) funktioniert wie gewohnt. Ein ausführliches Anpassungsbeispiel finden Sie unter 06_examples.md §1.1 „UI1 mit Anpassung — alle Standard-ESPHome-Stellschrauben“.

Kanonische Installation — eine Flotte mit mehreren Modulen

Der wichtigste Einsatzfall von rbAmp in ESPHome ist die Überwachung mehrerer Lasten über einen einzigen ESP32-Master. Ein Haus, eine Werkstatt oder ein Schaltschrank hat typischerweise eine Netzeinspeisung und mehrere Abzweige: einen Boiler, eine Klimaanlage, ein E-Auto, einzelne Räume. Ein rbAmp UI1 sitzt an der Einspeisung und zählt Gesamtleistung + Energie; mehrere rbAmp I2/I3 sitzen an den Abzweigen und zählen nur die Ströme je Kanal.

Alle Module hängen an einem einzigen I²C-Bus des ESP32 — jedes mit eigener Adresse aus dem Bereich 0x50..0x77. Die Komponente unterstützt MULTI_CONF = True, daher kann eine einzige YAML-Datei mehrere Blöcke rbamp: deklarieren und sie alle als unabhängige Entitätsmengen in Home Assistant veröffentlichen.

Ein rbAmp-Modul an der Netzeinspeisung und eines je Unterlast teilen sich einen einzigen I²C-Bus zum Master, wobei jede Zange am L-Leiter ihres Abzweigs sitzt.

In diesem Szenario ist der ESP32 der einzige Master: Er sendet einen gemeinsamen General-Call-Snapshot-Broadcast, wenn fleet_gc_enable: true gesetzt ist, und alle Module beginnen gleichzeitig eine neue Akkumulationsperiode zu einem einzigen Zeitpunkt auf dem Draht. Das liefert enge Synchronisation zwischen den Unterzählern — die Kanalsummen stimmen mit der Einspeisungssumme bis auf die Dauer einer einzigen Periode überein.

Eine Konfiguration mit einem einzelnen Modul (UI1 am Netz, ohne Unterzähler) ist der Minimalfall, nicht der Kanon. Bei v1.3 sind beide gültig; die Installation mit mehreren Modulen wird im ersten Kapitel der Dokumentation empfohlen, weil 80 % der Feldinstallationen genau so aussehen.

Was Sie messen

Größe YAML-Slot Bereich Typische Genauigkeit
Effektivspannung (RMS) voltage 0..300 V ±0.5%
Effektivstrom (RMS) (pro Kanal) current / current_1 / current_2 0..100 A (SKU-abhängig) ±0.5..1 % (Modul)
Wirkleistung (vorzeichenbehaftet) power / power_1 / power_2 ±23 kW ±1 % (Modul)
Leistungsfaktor (vorzeichenbehaftet) power_factor / power_factor_1 / power_factor_2 −1..+1 ±0.01 bei PF ≈ 1 (ohmsche Last) mit SCT-013-Sensoren ab 10 A Nennstrom; die eigene Phasenverschiebung des 5-A-Sensors addiert bis zu ~0.015 Messfehler — eine rein ohmsche Last zeigt ~0.985–0.993
Blindleistung (ohne Vorzeichen, √(S² − P²), enthält Verzerrungen; keine Genauigkeit angegeben) reactive_power / reactive_power_1 / reactive_power_2 wie P —
Scheinleistung apparent_power (nur CH0; für CH1/CH2 verwenden Sie einen HA-Template-Sensor, siehe DIY-Integrationen §6) wie P ±2%
Netzfrequenz frequency 50 / 60 Hz (auf BASIC erkannt) —
Akkumulierte Energie (Wh) energy / energy_1 / ... (je Kanal); energy_total / energy_exported_total / energy_net (STANDARD (STD), alle Kanäle) 64-bit hängt von der P-Genauigkeit ab
Blindenergie (varh) reactive_energy / reactive_energy_exported (STANDARD) 64-bit —
Hinweis

Dies sind die eigenen Werte des Moduls. Gemessen wird das Modul plus der angeschlossene Sensor, daher hängt die Gesamtgenauigkeit vom Sensor und seiner Nennstufe ab: Die Erfassungsgrenzen, lesbaren Mindestwerte und Genauigkeitsklassen je Nennwert für die SCT-013-Familie stehen in der BASIC-Genauigkeitstabelle. Module mit werkseitig gepaartem CT-Sensor sowie STD-Module sind dort gesondert angegeben.

Slots gibt es für bis zu sieben Stromkanäle (current_3 ... current_6 sowie die passenden power_N, energy_N, power_factor_N bei Varianten mit mehr Kanälen).

Alle Momentangrößen werden vom Modul selbst in einem Schritt von ~100 ms aktualisiert. Bei BASIC-Modulen erfolgt die Wh-Akkumulation durch den ESP32 anhand der mittleren Leistung, die das Modul über das Intervall zwischen zwei update()-Aufrufen liefert; bei STANDARD-Modulen akkumuliert die Komponente die eigenen Energiezähler des Moduls. Die ESPHome-Komponente verbirgt diese Protokolle — der Nutzer sieht in Home Assistant nur die sofort nutzbaren Sensor-Entitäten.

Was die ESPHome-Komponente hinzufügt

  • Sofort nutzbare HA-Sensoren — jeder Slot hat bereits seine device_class, state_class und Einheiten gesetzt. Der Sensor energy erscheint sofort im Energie-Dashboard, ohne manuelle Konfiguration.
  • Ein YAML für beide Modulreihen — beim Start erkennt die Komponente, ob ein BASIC- oder ein STANDARD-Modul angeschlossen ist, und übernimmt Kanalzahl, Variante und Funktionen vom Modul selbst. topology: wird nicht benötigt. Schlüssel, die nur für eine Generation gelten, werden auf der anderen mit einer Protokollzeile ignoriert.
  • Energie am Gerät (STANDARD) — das Modul führt eigene kumulative Zähler; die Komponente akkumuliert sie, sodass Summen Neustarts von ESP32 und Modul überleben und monoton bleiben. Gesamtsummen-Sensoren: energy_total, energy_exported_total, energy_net, reactive_energy, reactive_energy_exported. start_current_ua: legt den Strom fest, unterhalb dessen ein Kanal keine Energie zählt.
  • NVS-Persistenz der Wh — die Gesamtenergie wird alle 5 Minuten (und beim sauberen Herunterfahren, damit ein Neustart oder OTA das letzte Intervall nicht verliert) in den Flash des ESP32 geschrieben und vor dem ersten publish_state wiederhergestellt. Home Assistant sieht nach einem Neustart nie einen momentanen Nullwert und deutet ihn nie als Zählerrücksetzung.
  • Deklarative Sensorkonfiguration — zwei YAML-Zeilen (sensor_class: + ct_models: für UI3 bzw. ct_model: für UI1) legen Familie und CT-Modell je Kanal fest. Die Werkskoeffizienten lädt das Modul automatisch — keine Kalibrierschritte im Startablauf.
  • Abfrageplan über PollingComponent::update() mit einem konfigurierbaren update_interval (standardmäßig 60 s).
  • Entkoppelte Takte für RT-Lesung und Snapshot (v1.4+) — der optionale Schlüssel latch_interval: lässt den Zyklus Snapshot → Wh-Integration in eigenem Takt laufen, während update_interval: weiterhin steuert, wie oft die ESPHome-Komponente den Echtzeitblock V/I/P/PF/Q liest. Typischer Einsatz: update_interval: 3s + latch_interval: 60s — frische Dashboard-Werte alle 3 s, Snapshot-Buslast nur einmal pro Minute. Die Energieintegration fügt keinen eigenen Fehler hinzu, über die Genauigkeit der Wirkleistung des Moduls hinaus (die masterseitige Integration nutzt die tatsächliche Wanduhr-Differenz dt zwischen den Snapshot-Ereignissen).
  • NACK-Robustheit — eine dreischichtige Disziplin ist umgesetzt: standardmäßig 50 kHz, Wiederholung pro Byte und ein Plausibilitätsfilter für NaN/Inf. Details unten.
  • Einmalige Adressvergabe — der Schlüssel new_address: ändert die I²C-Adresse des Moduls in einem einzigen Startzyklus. Bei Firmware v1.3 funktioniert er im Produktionsmodus ohne Werks-Provisioning-Sperre (zweiphasiger Adress-Commit, automatisch erkannt). Praktisch für die Massenkonfiguration einer Charge von Geräten, nachdem sie im Schaltschrank montiert sind.
  • Mehrmodul-Bus — MULTI_CONF = True erlaubt, mehrere Blöcke rbamp: auf einem ESP32 zu deklarieren und sie alle der Reihe nach abzufragen.
  • Flotten-General-Call-Synchronisation (v1.3) — der Schlüssel fleet_gc_enable: true aktiviert den Empfang des GC-Snapshot-Broadcasts vom ESP32. Alle Module mit diesem Flag und passender group_id: beginnen gleichzeitig eine neue Periode. An eine Fähigkeit gebunden; bei Alt-Firmware protokolliert sie eine Warnung und überspringt, ohne anzuwenden. Nur BASIC-Module.
  • Identitätsschnittstelle (v1.3) — die öffentlichen Methoden get_variant_str() / get_capability_hex() / get_uid_hex() / get_firmware_version() / get_last_error_str() sind aus lambda: und über einen Template-text_sensor.platform: template erreichbar. Damit lassen sich die aktuelle Variante des Moduls (UI1/UI3/I2…), die Fähigkeiten-Bitmap, die UID und die Firmware-Version in HA anzeigen.
  • Lesen-Vergleichen-Schreiben beim Start (v1.3) — sensor_class: / ct_model: / ct_models: werden nur dann in den Flash geschrieben, wenn der angeforderte Wert vom gespeicherten abweicht. Das Zurückschreiben der Konfiguration beim Start sinkt von ca. 2.8 s (UI3-Erstinstallation) auf ~0 ms bei stabiler Konfiguration. Der alte Rat, „ct_model: nach der Prüfung aus dem YAML zu entfernen“, ist überholt — die Konfiguration ist idempotent.
  • Schutz der Werkskalibrierung (v1.8.1+) — bei einem Modul, das zusammen mit seinem eigenen eingebauten Sensor kalibriert wurde (WIRED_CT / BUILTIN_CT), wird eine Änderung von Klasse oder Modell aus dem YAML mit einer Protokollzeile abgewiesen. Die Dienstoption ct_model_force: true überstimmt dies bewusst.
  • Der SCT-Nennwertwechsel erhält die Genauigkeit (v1.9) — die Auswahl eines anderen SCT-013-Nennwerts über ct_model: erhält die werkseitige Kalibrierung je Exemplar: Bei Firmware bis 1.4.19 schließt die Komponente den Wechsel mit dem erforderlichen Modul-Neustart ab und skaliert die Messwerte; neuere Firmware erledigt das im Modul.

Architektur

Die Kette rbamp-esphome vom Netz und der CT-Zange über das rbAmp-Modul und die ESPHome-Komponente auf dem ESP32 bis zu Home Assistant [Home Assistant].

Die Messlogik sitzt im Modul; der ESP32 fungiert als Brücke zu HA. Bei BASIC-Modulen werden die Wh auf dem ESP32 gegen dessen eigenen Takt integriert, was die Akkumulation über mehrere Module hinweg konsistent hält. STANDARD-Module führen ihre kumulativen Energiezähler selbst, und der ESP32 akkumuliert sie.

Datenfluss innerhalb eines einzelnen update()

Die folgende Beschreibung ist der BASIC-Ablauf. Bei einem STANDARD-Modul ist der Momentanzweig gleich; der Periodenzweig wird durch eine kohärente Lesung der Energiezähler des Moduls ersetzt, deren Differenz zum vorherigen Snapshot zu den laufenden Summen addiert wird (kein Snapshot-Schritt).

Jeder Aufruf von update() bei einem BASIC-Modul führt zwei parallele Zweige aus:

Messfenster des Moduls laufen auf eigenem Takt, und die update()-Schritte des ESP32: Snapshot-Befehl, 50 ms warten, Snapshot lesen, RT-Lesung, veröffentlichen.

Zweig 1 — Momentanwerte (RT-Block)

  1. Prüfen Sie das Statusregister. Ist das Modul beschäftigt (Start, Flash-Schreib-Blackout), überspringen Sie den Vorgang ohne Schreiben.
  2. Für jeden deklarierten RT-Sensor einen float32 aus dem zugehörigen Register lesen.
  3. Plausibilitätsfilter std::isfinite() — verwirft NaN/Inf, die beim Lesen nicht atomarer Register durch Verschmieren entstehen können.
  4. sensor->publish_state(val).

Bei Firmware v1.3 wird der Block der Momentanwerte (U / I / P / PF / Q für alle deklarierten Kanäle) in einem einzigen Burst-Lesezugriff mit READ-Auto-Inkrementierung geholt — eine Adressphase, gefolgt von den Blockbytes. Schlägt der Burst fehl oder unterstützt die Firmware die Fähigkeit nicht, weicht die Komponente auf registerweise Lesungen aus (4 Transaktionen pro Float, jeweils mit eigener Adressphase). WRITE-Auto-Inkrementierung wird nicht unterstützt; registerweise Schreibvorgänge laufen immer Byte für Byte.

Zweig 2 — Periodenmessung (Energieakkumulation)

  1. Zeichnen Sie t_latch = millis() auf.
  2. Senden Sie den Snapshot-Befehl — er schließt die aktuelle Akkumulationsperiode und öffnet sofort die nächste. Eine einzige Transaktion schließt und öffnet zugleich; an der Grenze geht keine Probe verloren.
  3. Nach 50 ms (nicht blockierendes Timeout) wird das Gültigkeits-Flag gelesen. Hat das Modul die Integration noch nicht abgeschlossen (Abfrage schneller als das Integrationsintervall oder ein veralteter Snapshot), wird übersprungen — der nächste Zyklus holt das verpasste Intervall nach.
  4. Lesen Sie die mittlere Wirkleistung über die Periode für jeden Kanal.
  5. E_Wh[ch] += avg_p_W[ch] × (t_latch − last_latch_ms_) / 3_600_000.
  6. Aktualisieren Sie last_latch_ms_ erst nach Erfolg auf allen Kanälen.
  7. Im NVS speichern, wenn seit dem letzten Speichern mehr als 5 Minuten vergangen sind.

Der erste Snapshot nach dem Start setzt den Akkumulator des Moduls zurück und kalibriert den Mastertakt; sein Ergebnis wird über das Flag primed_ verworfen.

NVS-Energiepersistenz

Die akkumulierten Werte werden in der Struktur RbAmpPrefData gespeichert (Summe je Kanal für bis zu sieben Kanäle + Export je Kanal für die Kanäle 0..2):

C++
struct RbAmpPrefData {
  double energy_total_wh[7];
  double energy_export_wh[3];
} __attribute__((packed));

Bei STANDARD-Modulen liegen die Gesamt- und Blindenergie-Akkumulatoren (energy_total, energy_exported_total, reactive_energy*) in einem zweiten, getrennten NVS-Slot, sodass die Werte je Kanal bei einem Upgrade unberührt bleiben. Beide Slots werden alle 5 Minuten und beim sauberen Herunterfahren (Neustart / OTA) geschrieben.

Der NVS-Schlüssel wird aus der Komponenten-ID per XOR mit RBAMP_PREF_VERSION (0x52424D31 = „RBM1“) abgeleitet. Ändert sich die Struktur jemals, verwirft das Erhöhen der Versionskonstante veraltete Daten stillschweigend, statt sie falsch zu interpretieren.

Beim Start stellt setup() die Summen vor dem ersten update() wieder her. Veröffentlichte die Komponente zuerst 0 Wh und sprang dann auf den gespeicherten Wert, würde Home Assistant den Sprung als Zählerreset deuten und einen neuen Verlaufsabschnitt beginnen. Die Wiederherstellung vor der ersten Veröffentlichung verhindert das.

Die Speicherhäufigkeit wird durch zwei Bedingungen bestimmt:

  • Nach Zeit — alle 5 Minuten (SAVE_INTERVAL_MS = 300000).
  • Nach Ereignis — nach jedem erfolgreichen vollständigen Integrationszyklus (alle Kanäle ohne NACK gelesen) und bei einem sauberen Herunterfahren.

Der schlimmste Datenverlust bei einem plötzlichen Stromausfall des ESP32 sind 5 Minuten aufgelaufener Energie. Bei einer mittleren Last von 60 W sind das 5 Wh — unterhalb der Auflösung des Tagesbalkens im Energie-Dashboard.

NVS-Verschleiß — kann der Flash „verschleißen“?

Jedes Speichern schreibt ca. 16 Byte in den NVS-Bereich des ESP32. Die NVS-Schicht von ESP-IDF bündelt kleine Schreibvorgänge in einen einzigen Block und löscht eine Seite (4 KB) nur, wenn der Block voll ist. Bei einem 5-Minuten-Zyklus:

Metrik Wert
Gespart pro Tag 288
Speichervorgänge pro Jahr ~105120
Schreibgröße ~16 Bytes
NVS-Seitengröße 4096 Bytes
Seitenlöschungen pro Jahr ~411 (≈ 105120 × 16 ÷ 4096)
Löschzyklen-Grenze (Datenblatt des NOR-Flash des ESP32) 100000 Zyklen
Zeit bis zum Ausfall (TTF) ca. 240 Jahre pro NVS-Seite

Das NVS des ESP-IDF führt zusätzlich ein Wear-Leveling über die verfügbaren NVS-Seiten durch (die Standardpartition hat 4 Seiten), was die TTF um etwa das 4-Fache erhöht. Das praktische Fazit: Der NVS-Verschleiß bei einem 5-Minuten-Speicherzyklus ist kein begrenzender Faktor — die Hardware wird vorher veraltet sein.

Wann sich eine Frequenzreduzierung lohnt: Setzt ein Anwender SAVE_INTERVAL_MS über eigenen Code unter den Standard (zum Beispiel 30 s), berechnen Sie die TTF mit derselben Formel neu. Eine sichere Untergrenze für 10 Jahre Betrieb liegt bei ca. 30 s.

NACK-Disziplin

ESP32-Boards mit dem ESP-IDF-v5-Treiber i2c_master (den ESPHome, arduino-esp32 v3.x und MicroPython auf dem ESP32 alle verwenden) melden bei Lesevorgängen des Moduls mit 100 kHz regelmäßig NACKs — bei rund 20 % der Transaktionen. Dasselbe Modul mit einem anderen Master (z. B. einem anderen 32-Bit-MCU oder einem Raspberry Pi) zeigt 0 % NACK. Das Problem liegt also auf der Masterseite, nicht am Modul. Details stehen in der API-Referenz unter „I²C-Elektrische Disziplin“.

Es gibt eine zweite Komplikation: Gibt i2c_master_transmit_receive() wegen eines NACK ESP_FAIL zurück, setzt der IDF-v5-Treiber den Benutzerpuffer nicht auf null. Daten der vorherigen Transaktion bleiben stehen. Einige dieser veralteten Muster sehen wie plausible Floats aus (z. B. 0x3C 0x2F 0xFB 0x3F → 1.962 V) und bestehen eine naive isfinite()-Prüfung.

Die Komponente implementiert drei Schutzschichten:

Schicht Implementierung Wirkung
Standardmäßig 50-kHz-Bus frequency: 50kHz im YAML-Block i2c: Senkt die NACK-Rate empirisch um etwa den Faktor 5
Wiederholung pro Byte 3 Versuche, 5 ms Pause, bei jedem Byte jedes float32 Entfernt einen vorübergehenden NACK, bevor die Daten verwendet werden
Lockerer Plausibilitätsfilter std::isfinite() ohne harte physikalische Grenzen Fängt NaN/Inf/Denormals aus dem veralteten Puffer ab; lässt gültige Grenzwerte durch (Unterspannung, Trennung)

Mit allen drei Schutzschichten aktiv erreicht die Komponente auf dem Prüfstand bei den empfohlenen 50 kHz mehr als 99 % gültige Lesungen. Firmware v1.1 und v1.3 haben das Wiederherstellungsfenster des I²C-Moduls gehärtet, aber 50 kHz bleibt die empfohlene Einstellung auf ESP-IDF-basierten Mastern, weil die Wechselwirkung der Treiber-Timings bei 100 kHz bestehen bleibt.

Die rbAmp-Bibliotheksfamilie

Diese Komponente ist ein Mitglied der plattformübergreifenden Familie der rbAmp-Client-Bibliotheken. Alle implementieren dasselbe Drahtprotokoll (API-Referenz).

Plattform Repository
ESPHome (diese Komponente) rb-amp/rbamp-esphome
Arduino / arduino-esp32 rb-amp/rbamp-arduino
ESP-IDF rb-amp/rbamp-esp-idf
Python (CPython + MicroPython) rb-amp/rbamp-python

Alle Bibliotheken verwenden dieselben Leitungskonventionen — Schreibvorgänge Byte für Byte mit optionalem READ-Burst, dieselbe Zustandsmaschine für den Periodensnapshot, dieselbe SKU-Variantenerkennung beim Start und dieselben REG_ERROR-Codes. Code von einer dieser Plattformen lässt sich durch eine mechanische Syntaxübersetzung auf eine andere portieren — die Protokolllogik ist identisch. Die kanonische Registerkarte finden Sie in 09 · API-Referenz.

Unterstützte SKUs

Variante Spannungskanal Strommesskanäle Leistung Verfügbare ESPHome-Slots
UI1 ja 1 ja voltage, current, power, energy, frequency, power_factor, reactive_power, apparent_power
UI2 ja 2 ja + current_1, power_1, energy_1, power_factor_1, reactive_power_1
UI3 ja 3 ja + current_2, power_2, energy_2, power_factor_2, reactive_power_2
I1 nein 1 nein current, frequency
I2 nein 2 nein + current_1
I3 nein 3 nein + current_2

Module mit mehr als einem Spannungseingang nutzen stattdessen die phasenbezogenen Slots (voltage_a/b/c, current_a/b/c, ...) — siehe 09 §2.2; die beiden Gruppen können nicht in einem Block sensor: gemischt werden.

Bei Varianten nur mit I bestehen die Slots power, energy und power_factor einen deklarierten Slot voltage (geprüft vom Schema-Validator) — deklarieren Sie sie nur auf UI*-SKUs.

Was als Nächstes kommt

  • 02_tiers.md — die Modulreihen BASIC / STANDARD (STD) und welche YAML-Schlüssel auf jeder verfügbar sind
  • 03_sensor_selection.md — Wahl der CT-Klemme und Verhalten der Schlüssel ct_model: / ct_models:
  • 04_hardware.md — GPIO-Belegung, Pull-ups, der Bus mit mehreren Modulen

Quelle und Probleme: rb-amp/rbamp-esphome · diese Seite im Repository: docs/01_overview.md (v1.9.1)