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:
- Schnellstart:
05_quickstart.md - YAML-Beispiele (Lovelace, Automationen):
06_examples.md - DIY-Integrationen (MQTT, InfluxDB, Lambda):
07_diy_integrations.md - HA-Dokumentation: https://www.home-assistant.io/
1 · Erkennung: mDNS oder manuelle IP
mDNS-Auto-Erkennung (empfohlen)
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:
- Flashen Sie den ESP32 und lassen Sie ihn starten. Er verbindet sich mit WLAN und meldet sich per mDNS als
..local - 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.
- Klicken Sie beim neuen Eintrag auf „Configure“ (Konfigurieren). HA fragt nach dem Verschlüsselungsschlüssel, sofern einer konfiguriert ist (§3).
- 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:
api:
encryption:
key: "BASE64_ENCODED_32_BYTE_KEY"
Schlüssel erzeugen:
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:
# secrets.yaml (untracked, next to the device YAML)
api_key: "BASE64_ENCODED_32_BYTE_KEY"
# 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):
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:
- Klicken Sie unter Netzbezug auf „Verbrauch hinzufügen“ [Add consumption].
- Wählen Sie die Entität
Mains Energy[Mains Energy]. - 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):
- Netzbezug:
House Energy(vonmeter_house). - Rückspeisung ins Netz:
Solar Energy Exported(vonmeter_solar, STANDARD (STD); bei BASIC leer lassen). - Solarmodule:
Solar Energy(ausmeter_solar) [Solar Energy]. - Einzelgerät:
EV Charger Energy(vonmeter_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.
# 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.
# 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:
- Entwicklerwerkzeuge → Statistiken [Developer Tools → Statistics].
- Finden Sie die Entität (z. B.
sensor.rbamp_ui1_mains_energy). - Prüfen Sie, dass seine Zeile eine
statistic_idund einen aktuellenlast_stats_tshat.
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.
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.
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.
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.
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.
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 hostunter Linux) gibt dem Container Zugriff auf Multicast und löst das Problem meist. - mDNS-Reflektor: Werkzeuge wie
avahi-daemonmit einem korrektenallow-interfacesodermdns-repeaterleiten 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:
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.
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):
- Das Add-on speichert die YAML-Konfigurationen in
/config/esphome/(zugänglich über das Dateisystem von HA oder den Editor des Add-ons). secrets.yamlliegt neben den Geräte-YAML-Dateien in/config/esphome/.- Das
external_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 undpath: components/(relativ) angeben.
- Empfohlen: die Remote-Form verwenden:
- 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:
sensor._
Für den Knoten rbamp-ui1 und einen Sensor mit name: "Mains Voltage":
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:
- Benennen Sie den Sensor im YAML um.
- Flashen Sie das Gerät neu.
- 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)