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

08 · Home Assistant — Tiefenanalyse

Dieses Kapitel behandelt die HA-spezifischen Details der Arbeit mit rbAmp: Erkennung, die native API, das Energie-Dashboard, Langzeitstatistiken, Lovelace-Karten, Automationen und den Betrieb in Umgebungen, in denen HA in Docker oder WSL läuft.

Cross-references:


1 · Erkennung: mDNS oder manuelle IP

ESPHome-Knoten melden sich per mDNS (Multicast-DNS), wenn das YAML einen Block api: enthält. Die ESPHome-Integration in HA hört auf diese Ankündigungen und bietet neue Geräte automatisch an.

Was die automatische Erkennung braucht, um zu funktionieren:

  • Der ESP32 und HA müssen im selben Layer-2-Netzsegment liegen (ein VLAN, kein Router dazwischen). mDNS ist Multicast und überquert einen Router ohne zusätzliche Konfiguration nicht (mDNS-Reflektor / Avahi-Proxy).
  • UDP-Multicast darf vom Router oder einer Client-Isolation am Access Point nicht blockiert werden. Consumer-APs haben oft eine Funktion „AP-Isolation“ oder „Wireless Isolation“ — sie blockiert Multicast zwischen Geräten. Deaktivieren Sie sie für das IoT-VLAN oder für die betroffenen Geräte.
  • HA muss mDNS korrekt auflösen. In Docker- / WSL-Umgebungen ist dafür mitunter zusätzliche Netzwerkkonfiguration nötig (siehe §10).

Erkennungsablauf:

  1. Flashen Sie den ESP32 und lassen Sie ihn starten. Er verbindet sich mit WLAN und meldet sich per mDNS als .local.
  2. In HA: Einstellungen (Settings) → Geräte & Dienste (Devices & Services) → Integrationen (Integrations). Es erscheint ein Banner „Neue Geräte gefunden“, oder suchen Sie ESPHome in der Integrationsliste mit einem Erkennungs-Abzeichen.
  3. Klicken Sie beim neuen Eintrag auf „Configure“ (Konfigurieren). HA fragt nach dem Verschlüsselungsschlüssel, sofern einer konfiguriert ist (§3).
  4. Alle Sensoren werden dem Gerät automatisch hinzugefügt.

Manuelles Hinzufügen (falls mDNS blockiert ist)

Einstellungen (Settings) → Geräte & Dienste (Devices & Services) → Integration hinzufügen (Add Integration) → ESPHome.

Geben Sie die IP des ESP32 ein (prüfen Sie die DHCP-Tabelle des Routers oder das ESPHome-Startlog — die Zeile [I][wifi:189]: IP: 192.168.x.y). Der Standardport ist 6053.

Richten Sie im Router einen statischen DHCP-Lease für die MAC-Adresse des ESP32 ein, damit sich die IP nach einem Router-Neustart nicht ändert.


2 · Native ESPHome-API (Port 6053) vs. MQTT

ESPHome unterstützt zwei Transporte. Beide funktionieren mit rbAmp.

Eigenschaft Native API (Port 6053) MQTT
HA-Integration Erstklassig: eine eigene ESPHome-Integration mit automatischer Erkennung Allgemein: erfordert einen MQTT-Broker, manuelle Entitätseinrichtung oder MQTT-Erkennung
Verschlüsselung Eingebaut (Rauschprotokoll, optional) Hängt von der TLS-Einrichtung des Brokers ab
Latenz Gering — direktes TCP ohne Broker Hängt vom Broker ab
Zuverlässigkeit Automatische Wiederverbindung Hängt von der Verfügbarkeit des Brokers ab
Ohne HA Nutzlos (die API ist HA-spezifisch) Jeder MQTT-Abonnent kann sie nutzen
Einrichtungsaufwand Keine zusätzliche Infrastruktur Erfordert einen laufenden MQTT-Broker

Empfehlung: Die native API (Block api:) verwenden, wenn HA der Hauptverbraucher ist. mqtt: nur ergänzen, wenn Sie einen parallelen Nicht-HA-Verbraucher benötigen (Grafana, Node-RED, eigene Skripte). Beide können in einem YAML koexistieren.

Die native API ist der in diesem Dokument beschriebene Weg. Details zu MQTT stehen in 07_diy_integrations.md §2.


3 · Verschlüsselungsschlüssel

Standardmäßig ist die native API unverschlüsselt — jeder Host im lokalen Netz kann sich mit Port 6053 verbinden. Für ein vertrauenswürdiges Heimnetz ist das vertretbar. Für mehr Sicherheit fügen Sie einen Schlüssel hinzu:

YAML
api:
  encryption:
    key: "BASE64_ENCODED_32_BYTE_KEY"

Schlüssel erzeugen:

Shell
python3 -c "import base64, os; print(base64.b64encode(os.urandom(32)).decode())"

Wenn Sie das Gerät in HA hinzufügen (Einstellungen → Geräte & Dienste → ESPHome → Hinzufügen), geben Sie denselben Schlüssel ein. HA speichert ihn in der Konfiguration der Integration und verwendet ihn automatisch für alle weiteren Verbindungen zu diesem Knoten.

Legen Sie den Schlüssel in secrets.yaml ab:

YAML
# secrets.yaml (untracked, next to the device YAML)
api_key: "BASE64_ENCODED_32_BYTE_KEY"
YAML
# device YAML
api:
  encryption:
    key: !secret api_key

Ändern Sie den Schlüssel, müssen Sie das Gerät in HA entfernen und erneut hinzufügen.


4 · Konfiguration des Energie-Dashboards

Die Energiesensoren von rbAmp (energy sowie energy_1, energy_2, energy_exported, energy_total, energy_exported_total usw.) kommen bereits konfiguriert mit (energy_net verwendet state_class: total, weil er sinken kann; reactive_energy* sind in varh):

YAML
device_class: energy
state_class: total_increasing
unit_of_measurement: Wh

Genau diese Kombination erwartet das HA-Energie-Dashboard für kumulative Verbrauchs- oder Erzeugungssensoren. Keine zusätzlichen Template-Sensoren nötig. Jeder Energiesensor braucht voltage und current, deklariert im selben Block sensor: (fügen Sie internal: true hinzu, um sie vor Home Assistant zu verbergen).

Sensoren zum Energie-Dashboard hinzufügen

Einstellungen (Settings) → Dashboards → Energie (Energy). Das Dashboard hat vier Abschnitte:

Abschnitt Welchen rbAmp-Sensor Sie nehmen
Netzbezug energy (Bezug aus dem Netz) oder energy_total (STANDARD (STD), alle Kanäle)
Rückspeisung ins Netz Braucht ein STANDARD-Modul (STD) — ein BASIC-Modul liefert für den Export immer 0. energy_exported braucht bidirectional: true sowie voltage und current im selben Block; energy_exported_total umfasst alle Kanäle (nur STANDARD (STD))
Solarmodule energy von einem Modul, das die Ausgangsleistung eines Solar-Wechselrichters misst (STANDARD-(STD)-Modul, wenn dasselbe Modul auch die Einspeisung melden muss)
Hausbatterie Nicht zutreffend (rbAmp misst keinen Gleichstrom)
Einzelne Geräte energy_1, energy_2 usw. von einem Modul mit mehreren Kanälen

Für eine einzelne Gesamthausinstallation:

  1. Klicken Sie unter Netzbezug auf „Verbrauch hinzufügen“ [Add consumption].
  2. Wählen Sie die Entität Mains Energy [Mains Energy].
  3. Optional einen Tarif festlegen (EUR/kWh oder Ihre lokale Währung) für die Kostenerfassung.

Bei einer Installation mit drei Modulen (Netz + Solar + E-Auto aus Beispiel 11 in 06_examples.md):

  1. Netzbezug: House Energy (von meter_house).
  2. Rückspeisung ins Netz: Solar Energy Exported (von meter_solar, STANDARD (STD); bei BASIC leer lassen).
  3. Solarmodule: Solar Energy (aus meter_solar) [Solar Energy].
  4. Einzelgerät: EV Charger Energy (von meter_evcharger).

NVS-Persistenz und das Energie-Dashboard

Die ESPHome-Komponente speichert die Gesamtenergie alle 5 Minuten im NVS des ESP32 (und beim sauberen Herunterfahren wie Neustart oder OTA). Bei einem STANDARD-Modul stammen die Summen aus den eigenen Energiezählern des Moduls, sie überleben daher auch Neustarts des Moduls und bleiben monoton. Beim Start werden die Werte aus dem NVS wiederhergestellt und sofort veröffentlicht — bevor HA sich verbindet und bevor das erste update_interval auslöst.

Dies verhindert, dass das Energie-Dashboard einen momentanen 0 Wh als Zählerreset deutet. Sieht HA einen total_increasing-Wert auf 0 fallen, behandelt es die Differenz als Abrechnungsperiodengrenze und verwirft den aufgelaufenen Verlauf.

Der schlimmste Datenverlust bei einem plötzlichen Stromausfall beträgt bis zu 5 Minuten Akkumulation (≈ 5 Wh bei durchschnittlich 60 W Last — in den Tagessummen unsichtbar).

last_reset nach OTA oder einem Neustart des ESP32

Das HA-Energie-Dashboard verwendet device_class energy + state_class total_increasing ohne explizite last_reset-Bindung — das ist die empfohlene ESPHome-Konfiguration. Nach einem Neustart des ESP32 stellt die Komponente den Wert aus dem NVS vor dem ersten publish_state wieder her, sodass HA eine durchgehende, monoton steigende Reihe sieht und keinen Reset-Marker in den Verlauf einfügt. Das ist so vorgesehen.

Grenzfälle, in denen ein sichtbarer „Reset“ auftreten kann:

  • NVS ist beschädigt (die Kennung stimmt nicht oder die CRC schlägt fehl). Die Komponente startet bei 0 Wh, und HA verzeichnet einen Bruch. Symptom: Das Dashboard zeigt einen „Morgenpeak“ im Moment, in dem der Knoten nach längerer Ruhezeit startet. Abhilfe: Prüfen Sie das Boot-Log des ESP32 auf Meldungen [E][rbamp_nvs] — sie weisen auf die Ursache hin (inkompatibles NVS-Layout, geringe Ladung im Moment des Schreibens usw.). Stellen Sie aus einer Sicherung des HA-Verlaufs wieder her oder bereinigen Sie den Phantompeak mit den HA-Werkzeugen.

  • Hardwaretausch (neuer ESP32, gleiches Modul). Die Komponente startet bei 0 Wh — das Modul gibt seinen aufgelaufenen Zählerstand nicht über I²C weiter (Modul und Komponente führen getrennte Akkumulatoren; das Modul liefert nur die Momentanwerte zur Integration). HA verzeichnet einen Bruch. Abhilfe: Setzen Sie nach dem Flashen des neuen ESP32 den Anfangswert der Energie mit einem manuellen mqtt.publish (bei MQTT) oder einer vorübergehenden YAML-Änderung mit einer Lambda-Initialisierung. Oder akzeptieren Sie den Bruch als einmaliges Ereignis.

  • update_interval: zwischen Firmware-Builds spürbar geändert (zum Beispiel 60 → 600 s). Die Änderung selbst setzt nichts zurück, aber längere Zyklen erzeugen gröbere „Stufen“ im Diagramm. Optisch sieht es aus wie eine Änderung des Akkumulationsmodus; funktional ist es in Ordnung.

  • Der Recorder von HA wurde gekürzt oder aus einem alten Backup wiederhergestellt. Das liegt nicht auf der Seite von ESPHome, sondern auf der von HA: HA kann einige künftige Werte als „vergangen“ behandeln und den Graphen neu zeichnen. Mit ESPHome hat das nichts zu tun.

Bei einem routinemäßigen OTA-Reflash wird last_reset nicht gesetzt, der NVS-Snapshot wird ca. 50 ms vor der HA-Verbindung wiederhergestellt, und das Energie-Dashboard sieht keinen Bruch. Das ist das Ausgangsszenario.


5 · Versorgungszähler

Der HA-Versorgungszähler (utility_meter) leitet aus jedem Sensor total_increasing periodisch zurückgesetzte Sensoren ab. Damit erhalten Sie tägliche, wöchentliche und monatliche kWh zusätzlich zum rohen Akkumulator.

Home-Assistant-YAML (nicht ESPHome) — gehört in Ihre Home-Assistant-Konfiguration, nicht in das YAML des Knotens.

YAML
# configuration.yaml
utility_meter:
  energy_daily:
    source: sensor.rbamp_ui1_mains_energy
    cycle: daily

  energy_monthly:
    source: sensor.rbamp_ui1_mains_energy
    cycle: monthly

  energy_yearly:
    source: sensor.rbamp_ui1_mains_energy
    cycle: yearly

HA legt drei neue Entitäten an (sensor.energy_daily usw.), die zu Beginn jeder Periode auf 0 zurückgesetzt werden. Sie eignen sich gut für Einzelgeräte-Ansichten im Energie-Dashboard und als Basis für Kostenverfolgungs-Template-Sensoren.

Beispiele für Kosten und kWh/Tag finden Sie in 06_examples.md §10.


6 · Statistik-Sensor für Min / Max / Mittelwert

Der HA-Sensor statistics berechnet über ein einstellbares Zeitfenster aus dem Verlauf eines beliebigen Sensors laufendes Min, Max, Mittelwert und Standardabweichung:

Home-Assistant-YAML (nicht ESPHome) — gehört in Ihre Home-Assistant-Konfiguration, nicht in das YAML des Knotens.

YAML
# configuration.yaml
sensor:
  - platform: statistics
    name: "Mains Power 1h Average"
    entity_id: sensor.rbamp_ui1_mains_power
    state_characteristic: mean
    sampling_size: 60          # last 60 points
    max_age:
      hours: 1

  - platform: statistics
    name: "Mains Power 24h Peak"
    entity_id: sensor.rbamp_ui1_mains_power
    state_characteristic: value_max
    max_age:
      hours: 24

Diese abgeleiteten Sensoren sind nützlich für das Lastmanagement (Spitzenverbrauchsfenster, monatliches Maximum für die Tarifabrechnung) und für die Erkennung von Anomalien (wenn das 24-Stunden-Maximum der Leistung plötzlich über den historischen Werten liegt).


7 · Langzeitstatistiken

HA schreibt Sensoren mit state_class: total_increasing und state_class: measurement in seine Langzeitstatistik-Datenbank (LTS). Die LTS-Daten werden unbegrenzt aufbewahrt (unabhängig von der Aufbewahrung des Kurzzeitrecorders).

So prüfen Sie, dass ein rbAmp-Sensor in der LTS landet:

  1. Entwicklerwerkzeuge → Statistiken [Developer Tools → Statistics].
  2. Finden Sie die Entität (z. B. sensor.rbamp_ui1_mains_energy).
  3. Prüfen Sie, dass seine Zeile eine statistic_id und einen aktuellen last_stats_ts hat.

LTS wird vom Energie-Dashboard für die historischen Ansichten verwendet und über den Download der Statistiken in HA exportiert.

Wenn Sie ein rbAmp-Modul ersetzen (neue Hardware, neue Entitäts-ID), wird der alte LTS-Verlauf nicht automatisch übernommen. Um den Verlauf zu erhalten, behalten Sie für jeden Sensor im neuen YAML denselben name: bei. ESPHome erzeugt die Entitäts-ID aus dem Knotennamen und dem Sensornamen; gleiche Namen ergeben dieselbe statistic_id.


8 · Lovelace-Karten

Energiefluss-Karte (eingebaut)

Das integrierte HA-Energie-Dashboard enthält bereits eine Energiefluss-Karte oben auf der Seite Energie-Einstellungen (Energy settings). Sie wird gezeichnet, sobald das Energie-Dashboard konfiguriert ist (Netzbezug, Solar, Batterie). Keine zusätzliche Konfiguration nötig.

Anzeige (Gauge)

Home-Assistant-YAML (nicht ESPHome) — gehört in Ihre Home-Assistant-Konfiguration, nicht in das YAML des Knotens.

YAML
type: gauge
entity: sensor.rbamp_ui1_mains_power
min: 0
max: 5000
name: "Live Power"
unit: W
severity:
  green: 0
  yellow: 2000
  red: 3500

Sensorliste-Karte

Home-Assistant-YAML (nicht ESPHome) — gehört in Ihre Home-Assistant-Konfiguration, nicht in das YAML des Knotens.

YAML
type: entities
title: "rbAmp UI1"
entities:
  - entity: sensor.rbamp_ui1_mains_voltage
    name: Voltage
  - entity: sensor.rbamp_ui1_mains_current
    name: Current
  - entity: sensor.rbamp_ui1_mains_power
    name: Power
  - entity: sensor.rbamp_ui1_mains_power_factor
    name: Power Factor
  - entity: sensor.rbamp_ui1_mains_frequency
    name: Frequency
  - entity: sensor.rbamp_ui1_mains_energy
    name: Energy (total)

Mini-Diagrammkarte (HACS)

Installiert über HACS (§11):

Home-Assistant-YAML (nicht ESPHome) — gehört in Ihre Home-Assistant-Konfiguration, nicht in das YAML des Knotens.

YAML
type: custom:mini-graph-card
entities:
  - entity: sensor.rbamp_ui1_mains_power
    name: Power
hours_to_show: 6
points_per_hour: 4
line_width: 2
show:
  extrema: true
  average: true

Apex Charts (HACS)

Home-Assistant-YAML (nicht ESPHome) — gehört in Ihre Home-Assistant-Konfiguration, nicht in das YAML des Knotens.

YAML
type: custom:apexcharts-card
header:
  title: "Power (W)"
  show: true
graph_span: 24h
span:
  end: now
series:
  - entity: sensor.rbamp_ui1_mains_power
    name: Power
    type: area
    stroke_width: 2
    fill_raw: last
  - entity: sensor.rbamp_ui1_mains_power
    name: 1h avg
    type: line
    stroke_width: 1
    color: orange
    group_by:
      func: avg
      duration: 1h

9 · HA-Automationen vs. ESPHome on_value

Sowohl HA-Automationen als auch ESPHome-on_value-Callbacks reagieren auf Änderungen der rbAmp-Sensoren. Die Wahl des Werkzeugs:

Szenario HA-Automation ESPHome on_value
Push-Benachrichtigung Ja — Zugriff auf alle HA-Dienste (notify, TTS usw.) Nein — der ESP32 hat keinen Benachrichtigungsdienst
Ein Relais am selben ESP32 steuern Möglich (HA → Schalter), aber mit zusätzlicher Latenz Ja — läuft auf dem Gerät, ohne Netzwerkabhängigkeit
Auslösen, wenn HA offline ist Nein Ja — der ESP32 arbeitet eigenständig
Komplexe Bedingungen (Kombination von Entitäten, Verlauf, Kalender) Ja Eingeschränkt — Lambda in C++, ohne Zugriff auf den HA-Zustand
Reaktionslatenz ~1–5 s (WLAN + API-Hin- und Rückweg) ~0 ms (dieselbe Ereignisschleife)
Reaktion auf eine MQTT-Veröffentlichung Ja (MQTT-Auslöser) N/A

Praktischer Rat: Nutzen Sie ESPHome on_value für lokale Aktionen mit geringer Latenz (Relais schalten, LED-Anzeige, Summer), und HA-Automationen für alles, was HA-Dienste braucht (Benachrichtigungen, Szenenaktivierung, Kalenderplanung, Kombinationen mit anderen Entitäten).

Beispiel für eine HA-Automation, die rbAmp und einen HA-Schalter kombiniert:

Home-Assistant-YAML (nicht ESPHome) — gehört in Ihre Home-Assistant-Konfiguration, nicht in das YAML des Knotens.

YAML
automation:
  - alias: "Cut dishwasher when peak tariff starts"
    trigger:
      - platform: time
        at: "16:00:00"              # start of the peak tariff
    condition:
      - condition: numeric_state
        entity_id: sensor.rbamp_ui1_mains_power
        above: 1500                 # only switch off if the load is high
    action:
      - service: switch.turn_off
        target:
          entity_id: switch.dishwasher_socket

10 · WSL und Docker

HA läuft oft in Docker (über das Image homeassistant/home-assistant oder Home Assistant OS in einer VM). ESPHome läuft entweder als HA-Add-on (in derselben Container-Umgebung) oder als separater Docker-Container.

mDNS in Docker / WSL

mDNS (Multicast-UDP 5353) überschreitet Docker-Netzgrenzen standardmäßig nicht. Ist HA in Docker und der ESP32 im physischen LAN:

  • Docker-Host-Netzwerk (--network host unter Linux) gibt dem Container Zugriff auf Multicast und löst das Problem meist.
  • mDNS-Reflektor: Werkzeuge wie avahi-daemon mit einem korrekten allow-interfaces oder mdns-repeater leiten Multicast zwischen der Docker-Bridge (docker0) und der physischen LAN-Schnittstelle weiter.
  • Manuelles Hinzufügen: mDNS komplett umgehen — den ESP32 in der HA-ESPHome-Integration manuell per IP hinzufügen.

Unter Windows mit WSL2 hat die WSL2-VM ihren eigenen virtuellen Netzwerkadapter. Docker-Container darin können hinter zwei NAT-Schichten liegen (Windows → WSL2 → Docker-Bridge). mDNS funktioniert dann mit großer Wahrscheinlichkeit nicht — fügen Sie das Gerät per IP hinzu.

ESPHome-Add-on vs. eigenständiges ESPHome

Beim HA-ESPHome-Add-on teilt sich der Add-on-Container den Netzwerk-Namensraum mit HA (unter der Annahme von host-Netzwerk, dem Standard bei HA OS). mDNS und Geräteerkennung funktionieren ohne zusätzliche Konfiguration.

Wenn Sie ESPHome als eigenständigen Docker-Container betreiben, stellen Sie sicher, dass der Container Zugriff auf das physische LAN hat (--network host unter Linux) und dass /dev/ttyUSB0 (oder Ihr COM-Port) für das USB-Flashen durchgereicht wird:

Shell
docker run -it --rm --network host \
  -v /path/to/configs:/config \
  --device /dev/ttyUSB0:/dev/ttyUSB0 \
  ghcr.io/esphome/esphome compile /config/ui1.yaml

Statische IP für zuverlässiges OTA

In einer Docker- / VLAN-Umgebung werden statische DHCP-Leases für rbAmp-ESP32-Geräte dringend empfohlen. Sie verhindern:

  • Eine veraltete IP-Adresse, die in HA für den ESPHome-Integrationseintrag gespeichert ist.
  • Ein fehlgeschlagenes OTA-Flashen (esphome upload --device 192.168.x.y).
  • Ein Ausfall jeder Automation, die die API über die IP verwendet.

11 · HACS (Home Assistant Community Store)

HACS ist ein Drittanbieter-Integrationsmanager für HA, der Zugriff auf von der Community entwickelte Karten, Integrationen und Automationen bietet. Für den grundlegenden rbAmp-Betrieb ist er nicht nötig, aber für die umfangreicheren Lovelace-Karten aus §8 nützlich.

Installieren Sie es von https://hacs.xyz/. Installieren Sie dann diese Community-Karten:

Karte HACS-Kategorie Verwendung mit rbAmp
mini-graph-card Frontend Leistungs-/Stromdiagramm über die Zeit
apexcharts-card Frontend Mehrreihen-Diagramme
lovelace-card-mod Frontend Benutzerdefiniertes CSS für jede Karte
energy-flow-card-plus Frontend Verbessertes Energiefluss-Diagramm

Installation und Verwaltung von HACS sind in dessen Dokumentation beschrieben. Die Karten sind in den jeweiligen GitHub-Repositorys dokumentiert.


12 · Push-Benachrichtigungen bei Schwellenwerten

Die HA-Mobil-App (home-assistant.io/integrations/mobile_app) liefert Push-Benachrichtigungen auf iOS und Android. Zusammen mit rbAmp-Sensoren erhalten Sie sofortige Warnungen bei Überstrom, Überleistung, Netzausfall oder anderen Schwellwerten:

Home-Assistant-YAML (nicht ESPHome) — gehört in Ihre Home-Assistant-Konfiguration, nicht in das YAML des Knotens.

YAML
automation:
  - alias: "rbAmp over-current alert"
    trigger:
      - platform: numeric_state
        entity_id: sensor.rbamp_ui1_mains_current
        above: 14.0           # alert at 14 A (below a typical 16 A breaker)
        for:
          seconds: 10
    action:
      - service: notify.mobile_app_your_phone_name
        data:
          title: "Over-current warning"
          message: >
            Current is {{ states('sensor.rbamp_ui1_mains_current') | round(2) }} A
            — approaching 16 A breaker limit.
          data:
            push:
              sound:
                name: default
                critical: 1    # a critical alert bypasses Do Not Disturb (iOS)
              interruption-level: critical

  - alias: "rbAmp mains loss alert"
    trigger:
      - platform: numeric_state
        entity_id: sensor.rbamp_ui1_mains_voltage
        below: 10
        for:
          seconds: 5
    action:
      - service: notify.mobile_app_your_phone_name
        data:
          title: "Mains power lost"
          message: "Voltage dropped to {{ states('sensor.rbamp_ui1_mains_voltage') }} V."

Damit der Dienst notify.mobile_app_* verfügbar ist, muss die HA-Companion-App auf dem Zielgerät installiert und die Integration mobile-app in HA eingerichtet sein. Details finden Sie unter https://companion.home-assistant.io/.


13 · Einrichtung des HA-ESPHome-Add-ons

Wenn Sie das HA-ESPHome-Add-on nutzen (für die meisten Anwender empfohlen):

  1. Das Add-on speichert die YAML-Konfigurationen in /config/esphome/ (zugänglich über das Dateisystem von HA oder den Editor des Add-ons).
  2. secrets.yaml liegt neben den Geräte-YAML-Dateien in /config/esphome/.
  3. Dasexternal_componentsDer Pfad muss vom Inneren des Add-on-Containers aus erreichbar sein. Optionen:
    • Empfohlen: die Remote-Form verwenden: source: github://rb-amp/rbamp-esphome@v1.9.0 (die Komponente wird auf GitHub veröffentlicht).
    • Alternativ das Verzeichnis components/rbamp/ nach /config/esphome/components/ kopieren und path: components/ (relativ) angeben.
  4. OTA: Das Add-on führt das OTA-Flashen selbst aus — klicken Sie auf der Gerätekarte auf „Installieren“, und das Add-on versucht ein OTA an die zuletzt bekannte IP. USB-Flashen ist ebenfalls über den seriellen Port des Add-ons verfügbar, wenn der ESP32 am HA-Host angeschlossen ist.

Das Add-on enthält einen eingebauten Log-Viewer (die Schaltfläche „Logs“ auf der Gerätekarte) — das Gegenstück zu esphome logs in der CLI.


14 · Benennung der Entitäten und Stabilität der Entitäts-ID

Entitäts-IDs in HA entstehen aus dem ESPHome-Knotennamen und dem Feld name: des Sensors:

Text
sensor._

Für den Knoten rbamp-ui1 und einen Sensor mit name: "Mains Voltage":

Text
sensor.rbamp_ui1_mains_voltage

Entitäts-IDs erscheinen in Automationen, Template-Sensoren, Lovelace-Dashboards und der Konfiguration des Energie-Dashboards. Das Ändern von name: eines Sensors im YAML erzeugt eine neue Entitäts-ID und bricht jede Referenz auf die alte. Planen Sie Ihre Sensornamen vor der ersten Inbetriebnahme.

So ändern Sie den Namen eines Sensors, ohne die Entitäts-ID zu brechen:

  1. Benennen Sie den Sensor im YAML um.
  2. Flashen Sie das Gerät neu.
  3. In HA: Einstellungen (Settings) → Geräte & Dienste (Devices & Services) → ESPHome → Ihr Gerät → auf die Sensor-Entität klicken → Zahnradsymbol anklicken → die Entitäts-ID wieder auf den alten Wert umbenennen (oder auf einen neuen Wert ändern und alle Verweise anpassen).

Eine Alternative ist die HA-Funktion „Entitäts-ID umbenennen“ (Einstellungen → Entitäten → suchen → Entität anklicken → Name / Entitäts-ID bearbeiten) — damit lösen Sie den Anzeigenamen von der Entitäts-ID. Sie können den Anzeigenamen frei umbenennen, ohne Automationen zu beeinflussen.


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