evcc-io · naltatis · Mar 21, 2025 · Dec 15, 2024 · Dec 15, 2024 · Dec 15, 2024
diff --git a/.gitignore b/.gitignore
@@ -18,3 +18,9 @@
 npm-debug.log*
 yarn-debug.log*
 yarn-error.log*
+
+# Emacs backup file
+*~
+
+# IDEs
+/.idea
diff --git a/docs/Home.md b/docs/Home.md
@@ -19,11 +19,11 @@ Dazu wird evcc auf einem System im lokalen Netzwerk installiert, so dass es mit
   - [Wallboxen und schaltbaren Steckdosen](/docs/devices/chargers)
   - [Erzeugungsanlagen, Batteriespeichern und Energiemessgeräten (Zähler)](/docs/devices/meters)
   - [Fahrzeugen](/docs/devices/vehicles)
-- [Plugins](/docs/reference/plugins) um nahezu beliebige Wallboxen / Zähler / Fahrzeuge hinzuzufügen: Modbus, HTTP, MQTT, Javascript, WebSockets und Shell Skripte
+- [Plugins](/docs/devices/plugins) um nahezu beliebige Wallboxen / Zähler / Fahrzeuge hinzuzufügen: Modbus, HTTP, MQTT, Javascript, WebSockets und Shell Skripte
 - Status [Benachrichtigungen](/docs/reference/configuration/messaging) über [Telegram](https://telegram.org), [PushOver](https://pushover.net) und [viele mehr](https://containrrr.dev/shoutrrr/)
 - Datenanalyse mit [InfluxDB](https://www.influxdata.com) und [Grafana](https://grafana.com/grafana/)
-- Stufenlose Regelung der Ladeströme mit unterstützten Wallboxen (z.b. bei smartWB als [OLC](https://board.evse-wifi.de/viewtopic.php?f=16&t=187) bezeichnet)
-- [REST](/docs/integrations/rest-api)- und [MQTT](/docs/integrations/mqtt-api)-APIs zur Integration in andere Heimautomationssysteme (z.B. [HomeAssistant](/docs/integrations/home-assistant))
+- Stufenlose Regelung der Ladeströme mit unterstützten Wallboxen (z. B. bei smartWB als [OLC](https://board.evse-wifi.de/viewtopic.php?f=16&t=187) bezeichnet)
+- [REST](/docs/integrations/rest-api)- und [MQTT](/docs/integrations/mqtt-api)-APIs zur Integration in andere Heimautomationssysteme (z. B. [HomeAssistant](/docs/integrations/home-assistant))
 
 ## Anforderungen
 

diff --git a/docs/devices/heating.mdx b/docs/devices/heating.mdx
@@ -68,7 +68,7 @@ loadpoints:
     charger: heatpump_control
     meter: heatpump_power
     # Hier können auch die bekannten Parameter für loadpoints angegeben werden,
-    # insbesondere auch um zu kurze Laufzeiten zu verhindern, z.B.
+    # insbesondere auch um zu kurze Laufzeiten zu verhindern, z. B.
     enable:
       threshold: -1300 # aktivieren bei 1.300 W Überschuss für 5 Minuten
       delay: 5m
@@ -141,7 +141,7 @@ Dieses Code-Beispiel enthält einige Redundanzen.
 Wir werden später Templates für die einfachere Konfiguration gängiger Konstellationen bereitstellen.
 :::
 
-Neben `setmode` und `getmode`, kannst du optional auch die aktuelle Temperatur (`temp`) [via Plugin](/docs/reference/plugins) hinzufügen.
+Neben `setmode` und `getmode`, kannst du optional auch die aktuelle Temperatur (`temp`) [via Plugin](./plugins) hinzufügen.
 Diese dient lediglich zur Anzeige und wird bei Wärmepumpen nicht für die Steuerung verwendet.
 
 ## Heizstäbe

diff --git a/docs/devices/plugins.mdx b/docs/devices/plugins.mdx
diff --git a/docs/devices/smartswitches.mdx b/docs/devices/smartswitches.mdx
@@ -42,7 +42,7 @@ chargers:
     standbypower: 50
 ```
 
-Das heißt, in diesem Modus wird der Zustand des Ladepunkts abhängig von der gemessenen Leistung bestimmt: 
+Das heißt, in diesem Modus wird der Zustand des Ladepunkts abhängig von der gemessenen Leistung bestimmt:
 
 - Laden: (Leistung > `standbypower`)
 - Geladen: (Leistung ≤ `standbypower`)

diff --git a/docs/faq.mdx b/docs/faq.mdx
@@ -26,7 +26,7 @@ site:
 
 Hier gibt es verschiedene Nutzungsmöglichkeiten.
 Notwendig ist auf jeden Fall ein auslesbarer Netzzähler.
-Bei einem [variablen Stromtarif](./features/dynamic-prices) (z.B. Nachtstrom, Tibber, Awattar) ist automatisches preisabhängiges Laden möglich.
+Bei einem [variablen Stromtarif](./features/dynamic-prices) (z. B. Nachtstrom, Tibber, Awattar) ist automatisches preisabhängiges Laden möglich.
 Ansonsten kann man evcc zur Fernsteuerung (start/stop) der Wallbox nutzen.
 Darüber hinaus kann man die Ladung einer Fahrzeugbatterie auf einen bestimmten Ladestand (SoC) begrenzen. In diesem Fall ist es aber zwingend notwendig, dass das Fahrzeug in die Konfiguration mit aufgenommen wird.
 
@@ -52,7 +52,7 @@ Mehrere Wallboxen und damit Ladepunkte können in evcc verwendet werden. Es ist
 
 Bei kleinen PV-Anlagen und/oder im Winter macht es Sinn nur 1-phasig zu laden, um den vorhandenen Überschuss bestmöglich ohne Netzbezug zu nutzen.
 
-Bei Wallboxen die keine automatische Phasenumschaltung beherrschen, kann man in der Zuleitung zur Wallbox mittels eines Lasttrennschalters (z.B. Hager HAB304) die Phasen 2 & 3 abschalten. Wenn die volle Leistung benötigt wird, schaltet man die Phasen wieder zu.
+Bei Wallboxen die keine automatische Phasenumschaltung beherrschen, kann man in der Zuleitung zur Wallbox mittels eines Lasttrennschalters (z. B. Hager HAB304) die Phasen 2 & 3 abschalten. Wenn die volle Leistung benötigt wird, schaltet man die Phasen wieder zu.
 
 :::danger Achtung
 Dieses manuelle Umschalten darf nur erfolgen, wenn das Fahrzeug **NICHT** mit der Wallbox verbunden ist.
@@ -68,7 +68,7 @@ Damit evcc weiß, dass nicht mehr 3-phasig geladen werden kann muss die entsprec
 
 yaml ist sehr syntax-empfindlich. Fehler fallen nicht immer sofort ins Auge.
 
-Eine schnelle Hilfe bieten yaml-Tester wie z.B. (https://onlineyamltools.com/validate-yaml)
+Eine schnelle Hilfe bieten yaml-Tester wie z. B. (https://onlineyamltools.com/validate-yaml)
 
 ### Etwas funktioniert nicht. Was nun?
 
@@ -152,7 +152,7 @@ Die IP-Verbindung zum betreffenden Gerät ist prinzipiell vorhanden, jedoch wird
 Die Gründe dafür können vielfältig sein. Typisch sind:
 
 - Der am Gerät offene Port stimmt nicht mit dem in der evcc-Konfiguration angegebenen Zielport überein.
-- Der externe Zugriff auf das Gerät ist nicht aktiviert (z.B. bei Solaredge-Wechselrichtern im Auslieferungszustand).
+- Der externe Zugriff auf das Gerät ist nicht aktiviert (z. B. bei Solaredge-Wechselrichtern im Auslieferungszustand).
 - Die maximal mögliche Anzahl an parallelen Verbindungen, die das Zielgerät verwalten kann, ist erschöpft. Andere Verbindungen z. B. von Hausautomationen, Skripten oder weiteren Instanzen von evcc müssen ggf. zunächst beendet werden, bevor eine neue Verbindung möglich ist. Im ungünstigsten Fall lässt das Zielsystem nur eine einzige Verbindung zu.
 - Blockade durch eine Firewall.
 
@@ -325,7 +325,7 @@ Batterieverluste durch die Umwandlung werden nicht berücksichtigt.
 **Berechnung von Ersparnis und effektivem Energiepreis**
 
 Der Algorithmus unterscheidet zwischen Netzstrom und selbst erzeugter Sonnenenergie (PV, Batterie).
-Der Kostenvorteil deiner Sonnenenergie ergibt sich aus der Differenz zwischen deinem Netzbezugspreis (z.B. 30 ct/kWh) und deinem Einspeisetarif (z.B. 8 ct/kWh).
+Der Kostenvorteil deiner Sonnenenergie ergibt sich aus der Differenz zwischen deinem Netzbezugspreis (z. B. 30 ct/kWh) und deinem Einspeisetarif (z. B. 8 ct/kWh).
 Jede geladene kWh selbst produzierter Energie ist in diesem Beispiel 22 ct (30 ct - 8 ct) günstiger als der Netzbezug.
 Hast du 2 kWh eigene Energie geladen entspricht das einer **Ersparnis** von 44 ct.
 
@@ -341,7 +341,7 @@ evcc hilft dir aber den Anteil der geladenen Sonnenenergie zu maximieren.
 
 **Berechnung des Sonnenenergieanteils**
 
-Wenn du gleichzeitig Energie aus verschiedenen Quellen beziehst (z.B. 50% PV, 50% Netzbezug), wird die selbst erzeugte Energie zuerst dem Haus, also allen nicht von evcc gesteuerten Verbrauchern, zugeordnet.
+Wenn du gleichzeitig Energie aus verschiedenen Quellen beziehst (z. B. 50% PV, 50% Netzbezug), wird die selbst erzeugte Energie zuerst dem Haus, also allen nicht von evcc gesteuerten Verbrauchern, zugeordnet.
 Der verbleibende Anteil wird dann auf die Ladevorgänge aufgeteilt.
 Beispiel: Deine PV-Anlage erzeugt 3 kW. Diese 3 kW werden komplett vom Haus verbraucht (bspw. Waschmaschine).
 Parallel lädst du dein Auto mit 3 kW (bspw. Modus = schnell).

diff --git a/docs/features/sessions.mdx b/docs/features/sessions.mdx
@@ -86,7 +86,7 @@ Wurde ein Fahrzeug nicht korrekt erkannt, kannst du in dieser Ansicht auch die F
 
 ## Schaltbare Steckdosen
 
-Im Gegensatz zu Wallboxen gibt es bei schaltbaren Steckdosen (z.B. Schuko-Ladegerät, E-Bike, ...) oder fest verkabelten Anlagen (z.B. Wärmepumpe, Heizstab, ...) keine Möglichkeit, den Ladevorgang zu erkennen.
+Im Gegensatz zu Wallboxen gibt es bei schaltbaren Steckdosen (z. B. Schuko-Ladegerät, E-Bike, ...) oder fest verkabelten Anlagen (z. B. Wärmepumpe, Heizstab, ...) keine Möglichkeit, den Ladevorgang zu erkennen.
 Diese Verbraucher tauchen aktuell trotzdem in der Liste der Ladevorgänge mit langen Zeiträumen auf.
 Wird evcc neu gestartet, wird ein neuer Ladevorgang protokolliert.
 Dies kann auch über aktives Stoppen und Starten am Ladepunkt (Modus: aus) manuell erfolgen.

diff --git a/docs/installation/docker.mdx b/docs/installation/docker.mdx
@@ -61,7 +61,7 @@ In diesem Abschnitt werden drei Möglichkeiten zur Installation von evcc über D
 
 ### via Docker UI
 
-Hast du ein System mit einer Docker GUI (z.B. Synology, QNAP, Portainer, Unraid, ...) kannst du die Installation auch über diese Oberfläche vornehmen.
+Hast du ein System mit einer Docker GUI (z. B. Synology, QNAP, Portainer, Unraid, ...) kannst du die Installation auch über diese Oberfläche vornehmen.
 Hier sind die relevanten Angaben, die du eintragen musst:
 
 #### Verfügbare Docker Images {#images}

diff --git a/docs/installation/home-assistant.mdx b/docs/installation/home-assistant.mdx
@@ -96,7 +96,7 @@ Falls dieser Ordner noch nicht exisiert, erstelle ihn manuell.
 Um die Konfigurationsdatei anzulegen bzw. zu editieren, hast du verschiedene Möglichkeiten, hier ein paar zur Auswahl:
 - [Visual Studio Code](https://github.com/hassio-addons/addon-vscode), in Visual Studio Code wähle das Hamburger-Menü oben links aus und wähle "File", "Open Folder...", select `/addon_configs/49686a9f_evcc`
 - [File Editor](https://github.com/home-assistant/addons/tree/master/configurator), stelle sicher, dass Du die Option "Enforce Basepath" in der Addon Konfiguration deaktiviert hast, starte das Addon neu und navigiere nach `/addon_configs/49686a9f_evcc`
-- [Advanced SSH & Web Terminal](https://github.com/hassio-addons/addon-ssh), navigiere nach `/addon_configs/49686a9f_evcc` und verwende z.B. nano
+- [Advanced SSH & Web Terminal](https://github.com/hassio-addons/addon-ssh), navigiere nach `/addon_configs/49686a9f_evcc` und verwende z. B. nano
 
 Unter [Konfiguration](./configuration) findest du eine Anleitung, wie du den Inhalt für die `evcc.yaml` erstellen kannst.
 
@@ -110,7 +110,7 @@ Die Aktualisierung auf die neueste Version von evcc ist in den Home Assistant Up
 
 ## Erweiterte Tips
 
-Um die folgenden Funktionen auszuführen, benötigst du SSH Zugriff auf Home Assistant. Diesen kannst du z.B. mit dem oben erwähnten SSH Addon bekommen.
+Um die folgenden Funktionen auszuführen, benötigst du SSH Zugriff auf Home Assistant. Diesen kannst du z. B. mit dem oben erwähnten SSH Addon bekommen.
 
 - Installiere [Advanced SSH & Web Terminal](https://github.com/hassio-addons/addon-ssh)
 - deaktiviere den "secure mode" in der Addon Konfiguration

diff --git a/docs/installation/linux.mdx b/docs/installation/linux.mdx
@@ -235,7 +235,7 @@ Neben dem Debian/Ubuntu APT Paket, stellen wir auch weitere Binaries für Linux
   - 64-Bit ARM CPU: [evcc_X.XX_linux_arm64.tar.gz](https://github.com/evcc-io/evcc/releases/latest)
   - 32-Bit ARM CPU (e.g. Raspberry Pi 32-Bit OS): [evcc_X.XX_linux_armv6.tar.gz](https://github.com/evcc-io/evcc/releases/latest)
 
-- Entpacke die heruntergeladene Datei (z.B. per Doppelklick auf die Datei).
+- Entpacke die heruntergeladene Datei (z. B. per Doppelklick auf die Datei).
 - Im entpackten Ordner befindet sich ein `evcc` Programm.
 - Öffne ein Terminal und gehe in den Ordner neuen Ordner.
 - Mit folgendem Befehl kannst du prüfen, ob evcc funktioniert:

diff --git a/docs/installation/macos.md b/docs/installation/macos.md
@@ -137,7 +137,7 @@ Hier findest du die Anleitung für die manuelle Installation von evcc auf macOS.
 
 - Lade die entsprechende Datei auf dein System herunter:
   - 64-Bit ARM oder Intel CPU: [evcc_X.XX_macOS_all.tar.gz](https://github.com/evcc-io/evcc/releases/latest)
-- Entpacke die heruntergeladene Datei (z.B. per Doppelklick auf die Datei)
+- Entpacke die heruntergeladene Datei (z. B. per Doppelklick auf die Datei)
 - Es gibt nun einen neuen Ordner mit dem Programm `evcc`.
 - Öffne ein Terminal und gehe in den Ordner mit dem Programm `evcc`
 - Starte evcc mit folgendem Befehl:

diff --git a/docs/integrations/home-assistant.mdx b/docs/integrations/home-assistant.mdx
@@ -14,7 +14,7 @@ Wenn du nach einer Installationsanleitung suchst, findest du diese unter [Instal
 ## Schnittstellen
 
 Falls du Geräte, wie Chargers, Meters oder Fahrzeuge, in evcc integrieren möchtest die von Geräten stammen die evcc nicht
-unterstützt (z.B. Zigbee Smartplugs) kannst du dies über [MQTT](./mqtt-api) oder das
+unterstützt (z. B. Zigbee Smartplugs) kannst du dies über [MQTT](./mqtt-api) oder das
 [REST API](./rest-api) realisieren. 
 
 Dank der beiden evcc Schnittstellen können zusätzliche Ladepunkte für eine Vielzahl von verschiebbaren Lasten (Verbrauchern),

diff --git a/docs/integrations/mqtt-api.md b/docs/integrations/mqtt-api.md
@@ -11,7 +11,7 @@ Nutze Tools wie [MQTT Explorer](https://mqtt-explorer.com/) um die Daten zu visu
 :::
 
 Die MQTT API folgt der [REST API](./rest-api) Struktur.
-Alle API IDs (z.B. die Loadpoint ID) beginnen bei `1`.
+Alle API IDs (z. B. die Loadpoint ID) beginnen bei `1`.
 
 - `evcc`: root topic
 - `evcc/status`: status (`online`/`offline`)

diff --git a/docs/reference/configuration/chargers.mdx b/docs/reference/configuration/chargers.mdx
@@ -39,7 +39,7 @@ name: wallbox1
 
 Dies ist der evcc spezifische Wallbox Typ, mit Hilfe dessen mit der Wallbox kommuniziert werden kann. Bekannte Wallboxen könne über den Typ `template` eingebunden werden. Den passenden (Template)Typ findet man unter [Geräte - Wallboxen](/docs/devices/chargers).
 
-Für unbekannte Wallboxen (oder aus anderen individuellen Gründen) kann die Standard Implementierung über [Plugins](/docs/reference/plugins) genutzt werden.
+Für unbekannte Wallboxen (oder aus anderen individuellen Gründen) kann die Standard Implementierung über [Plugins](/docs/devices/plugins) genutzt werden.g
 
 **Beispiel**:
 
@@ -53,7 +53,7 @@ type: custom
 
 ### `integrateddevice`
 
-Dieser Parameter bewirkt, dass bei Ladegeräten, die ohne "Fahrzeug" betrieben werden (z.B. Wärmepumpe, eBike) kein Fahrzeug angezeigt wird und dadurch auch die Fahrzeugerkennung ausbleibt.
+Dieser Parameter bewirkt, dass bei Ladegeräten, die ohne "Fahrzeug" betrieben werden (z. B. Wärmepumpe, eBike) kein Fahrzeug angezeigt wird und dadurch auch die Fahrzeugerkennung ausbleibt.
 
 In Zusammenhang mit diesem Parameter kann auch ein Icon vergeben werden (siehe [`vehicle.icon`](/docs/reference/configuration/vehicles#icon)), welches dann am Ladepunkt angezeigt wird.
 

diff --git a/docs/reference/configuration/hems.md b/docs/reference/configuration/hems.md
@@ -141,7 +141,7 @@ Um dies zu verhindern, sollte die Geräte ID vom bisherigen System übernommen w
 
 Bietet Unterstützung für den SMA Sunny Home Manager 2.0 (SHM).
 
-Durch die Integration können die [Ladepunkte](loadpoints) dem SHM hinzugefügt werden und somit z.B. für dessen Steuerung berücksichtigt werden.
+Durch die Integration können die [Ladepunkte](loadpoints) dem SHM hinzugefügt werden und somit z. B. für dessen Steuerung berücksichtigt werden.
 
 **Beispiel**:
 

diff --git a/docs/reference/configuration/index.md b/docs/reference/configuration/index.md
@@ -6,11 +6,11 @@ sidebar_position: 1
 
 evcc benötigt eine Konfigurationsdatei in der die Installation beschrieben wird. Ohne diese Datei kann evcc nicht genutzt werden. Die Datei selbst ist im [YAML](https://de.wikipedia.org/wiki/YAML) Format geschrieben. Dieses Format definiert eine Syntax wodurch eine strukturierte Datenstruktur in Textform erstellt werden kann.
 
-Zur Bearbeitung bzw. Erstellung der Konfigurationsdatei empfehlen wir einen Texteditor zu verwenden, welcher die YAML Synthax beherrscht und damit Fehler aufzeigen kann, z.B. [VS Code](https://code.visualstudio.com) mit der [YAML Erweiterung](https://marketplace.visualstudio.com/items?itemName=redhat.vscode-yaml).
+Zur Bearbeitung bzw. Erstellung der Konfigurationsdatei empfehlen wir einen Texteditor zu verwenden, welcher die YAML Synthax beherrscht und damit Fehler aufzeigen kann, z. B. [VS Code](https://code.visualstudio.com) mit der [YAML Erweiterung](https://marketplace.visualstudio.com/items?itemName=redhat.vscode-yaml).
 
 Die Konfigurationsdatei hat standardmäßig den Namen `evcc.yaml` und ist entweder im gleichen Verzeichnis wie das Programm selbst abzulegen, oder bei Linux-Systemen unter `/etc/evcc.yaml`.
 
-Wenn die Konfigurationsdatei nicht gefunden wird, kann diese über einen Parameter beim Aufruf evcc übergeben werden: z.B. `evcc -c /home/evcc.yaml`
+Wenn die Konfigurationsdatei nicht gefunden wird, kann diese über einen Parameter beim Aufruf evcc übergeben werden: z. B. `evcc -c /home/evcc.yaml`
 
 ### Struktur
 
@@ -93,7 +93,7 @@ _Loadpoints_ (Ladepunkte) beschreiben die Ladeinfrastruktur und kombinieren vorh
 
 ### Chargers
 
-_Chargers_ (Wallboxen) beinhaltet eine Liste von Wallboxen und deren Eigenschaften, z.B. wie sie angesprochen werden.
+_Chargers_ (Wallboxen) beinhaltet eine Liste von Wallboxen und deren Eigenschaften, z. B. wie sie angesprochen werden.
 
 [Weiterlesen...](./configuration/chargers)
 

diff --git a/docs/reference/configuration/loadpoints.md b/docs/reference/configuration/loadpoints.md
@@ -16,7 +16,7 @@ loadpoints:
     mode: pv # charge mode (off, now, minpv, pv)
 ```
 
-Referenzen sind hierbei immer die Werte des Parameters `name` (z.B. `wallbox`) in der jeweiligen Gerätekonfiguration.
+Referenzen sind hierbei immer die Werte des Parameters `name` (z. B. `wallbox`) in der jeweiligen Gerätekonfiguration.
 
 Im folgenden werden nun alle möglichen Parameter erklärt.
 
@@ -73,7 +73,7 @@ Wobei hier der Wert `charge` dem Wert eines `name` Parameters in der [Strommessg
 
 Beim Anschluss eines Fahrzeugs an den Ladepunkt wird damit immer davon ausgegangen dass dieses Fahrzeug angeschlossen wurde.
 Die automatische Fahrzeugerkennung wird umgangen.
-Falls doch ausnahmsweise ein anderes Fahrzeug angeschlossen wurde (z.B. Gastfahrzeug) lässt sich dies im Anschluss manuell zuweisen.
+Falls doch ausnahmsweise ein anderes Fahrzeug angeschlossen wurde (z. B. Gastfahrzeug) lässt sich dies im Anschluss manuell zuweisen.
 
 **Beispiel**:
 
@@ -279,7 +279,6 @@ delay: 10m
 
 ---
 
-
 ### `phases`
 
 :::note veraltet in yaml

diff --git a/docs/reference/configuration/log.md b/docs/reference/configuration/log.md
@@ -41,7 +41,7 @@ Definiert den Detailgrad der Protokollierung für verschiedene evcc Komponenten
 - `lp-X`: Der jeweilige Ladepunkt, wobei `X` in der Reihenfolge der Konfiguration der [`loadpoints`](loadpoints) (Ladepunkte) durchnummeriert ist, beginnend bei `1`
 - `sma`: Die SMA HEMS Komponente, falls der SMA Sunnay Home Manager 2.0 per [`hems`](hems) eingebunden ist
 - _`fahrzeug`_: Jedes definierte [`vehicle`](vehicles) (Fahrzeug), hier ist der jeweilige Wert des Parameters [`type`](vehicles#type) (bzw. des templates) anzugeben.
-- Darüber hinaus können je nach Anwendungsfall noch weitere Komponenten spezifiziert werden (z.B. `cache`, `db`, `influx`, `mqtt`, ...)
+- Darüber hinaus können je nach Anwendungsfall noch weitere Komponenten spezifiziert werden (z. B. `cache`, `db`, `influx`, `mqtt`, ...)
 
 **Mögliche Werte jede Komponente**: Identisch zu den Werten von [`log`](#log)