Merge branch 'main' of github.com:evcc-io/docs

Author: naltatis

docs/devices/plugins.mdx

@@ -155,25 +155,63 @@ Neben den Attributen, die Plugins zur lesenden Auswertung bereitstellen, werden
 | limitsoc    | int | nein      | `battery` | Setze Ladeziel für Batterie in %. Das Ladeziel wird aus den konfigurierten `MinSoc`, `MaxSoc` und dem aktuellen Ladestand (Attribut `soc`) berechnet. |
 | batterymode | int | nein      | `battery` | Setze Lademodus direkt (1: normal, 2: hold, 3: charge)                                                                                                |
 
-### Charger
+### Charger {#charger}
 
 Wallboxen und Ladegeräte haben folgende Attribute die ausgelesen werden können:
 
-| Attribut  | Typ                 | Erfordert | Beschreibung                        |
-| --------- | ------------------- | --------- | ----------------------------------- |
-| status    | string              | ja        | Status (A..F)                       |
-| enabled   | bool                | ja        | Ist Ladung freigegeben?             |
-| power     | float               | nein      | Ladeleistung in W                   |
-| energy    | float               | nein      | Zählerstand in kWh                  |
-| identify  | string              | nein      | Aktuelle RFID-Kennung               |
-| soc       | int                 | nein      | Ladestand in %                      |
-| phases    | int                 | nein      | Anzahl der physischen Phasen (1..3) |
-| powers    | [float,float,float] | nein      | Phasenleistungen in W               |
-| currents  | [float,float,float] | nein      | Phasenströme in A                   |
-| voltages  | [float,float,float] | nein      | Phasenspannungen in V               |
-| temp      | float               | nein      | Aktuelle Temperatur in °C (Heizung) |
-| templimit | int                 | nein      | Temperaturlimit in °C (Heizung)     |
-| getmode   | int                 | nein      | SG-Ready Modus (Wärmepumpe)         |
+| Attribut    | Typ                 | Erfordert | Beschreibung                         |
+| ----------- | ------------------- | --------- | ------------------------------------ |
+| status      | string              | ja        | Status (A..F)                        |
+| enabled     | bool                | ja        | Ist Ladung freigegeben?              |
+| power       | float               | nein      | Ladeleistung in W                    |
+| energy      | float               | nein      | Zählerstand in kWh                   |
+| identify    | string              | nein      | Aktuelle RFID-Kennung                |
+| soc         | int                 | nein      | Ladestand in %                       |
+| phases      | int                 | nein      | Anzahl der physischen Phasen (1..3)  |
+| powers      | [float,float,float] | nein      | Phasenleistungen in W                |
+| currents    | [float,float,float] | nein      | Phasenströme in A                    |
+| voltages    | [float,float,float] | nein      | Phasenspannungen in V                |
+| temp        | float               | nein      | Aktuelle Temperatur in °C (Heizung)  |
+| templimit   | int                 | nein      | Temperaturlimit in °C (Heizung)      |
+| getmode     | int                 | nein      | SG-Ready Modus (Wärmepumpe)          |
+| getmaxpower | float               | nein      | Maximale Heizleistung in W (Heizung) |
+
+#### Allgemeine Konfigurationsoptionen {#charger-config}
+
+Zusätzlich zu den Plugin-Attributen können folgende Konfigurationsoptionen direkt am Charger gesetzt werden:
+
+| Attribut     | Typ      | Erfordert | Beschreibung                                                    |
+| ------------ | -------- | --------- | --------------------------------------------------------------- |
+| icon         | string   | nein      | Icon für die Darstellung in der Benutzeroberfläche              |
+| features     | []string | nein      | Feature-Flags für spezielle Charger-Eigenschaften (siehe unten) |
+| standbypower | int      | nein      | Standby-Leistung in W (für `switchsocket` Typ)                  |
+
+##### Feature-Flags {#charger-features}
+
+Über das `features` Array können spezielle Eigenschaften des Chargers aktiviert werden:
+
+| Feature          | Beschreibung                                                                                                                                 |
+| ---------------- | -------------------------------------------------------------------------------------------------------------------------------------------- |
+| heating          | Behandelt das Gerät als Heizung (z. B. Wärmepumpe, Heizstab). Beeinflusst die Darstellung in der Benutzeroberfläche.                         |
+| integrateddevice | Gerät ohne Ladesitzungen und ohne angeschlossenes Fahrzeug (z. B. Smartes Schalter, fest installierte Verbraucher).                          |
+| coarsecurrent    | Ladestrom kann nur in 1 A Schritten eingestellt werden (wird in der Regelung berücksichtigt).                                                |
+| welcomecharge    | Aktiviert Welcome Charge Funktion. Ladegerät liefert beim Anschließen kurz Strom, damit das Fahrzeug erkennt, dass der Charger funktioniert. |
+
+**Beispiel mit Features**:
+
+```yaml
+chargers:
+  - name: heizstab
+    type: custom
+    features:
+      - heating
+      - integrateddevice
+    icon: heater
+    status:
+      source: mqtt
+      topic: heater/status
+    # ... weitere Attribute
+```
 
 **Beispiel**
 
@@ -204,6 +242,7 @@ Neben den read-only Werten können über Plugins auch Aktionen getriggert oder K
 | phases1p3p      | int   | nein      | Phasenumschaltung durchführen (erfordert `tos: true`)   |
 | wakeup          | bool  | nein      | Wecke Fahrzeug auf                                      |
 | setmode         | int   | nein      | Ändere SG-Ready Modus (1: reduced, 2: normal, 3: boost) |
+| setmaxpower     | int   | nein      | Setze maximale Heizleistung in W (Heizung)              |
 
 **Beispiel**
 
@@ -220,7 +259,7 @@ chargers:
       payload: ON
 ```
 
-### Vehicle
+### Vehicle {#vehicle}
 
 Fahrzeugparameter können ebenfalls über Plugins ausgelesen werden.
 
@@ -235,14 +274,26 @@ Fahrzeugparameter können ebenfalls über Plugins ausgelesen werden.
 | getmaxcurrent | float  | nein      | Maximaler Ladestrom in A     |
 | finishtime    | string | nein      | Geplantes Ladeende (RFC3339) |
 
+#### Allgemeine Konfigurationsoptionen {#vehicle-config}
+
+Folgende Konfigurationsoptionen können direkt am Fahrzeug gesetzt werden:
+
+| Attribut | Typ    | Erfordert | Beschreibung                                        |
+| -------- | ------ | --------- | --------------------------------------------------- |
+| title    | string | nein      | Anzeigename des Fahrzeugs in der Benutzeroberfläche |
+| icon     | string | nein      | Icon für die Darstellung in der Benutzeroberfläche  |
+| capacity | float  | nein      | Batteriekapazität in kWh                            |
+
 **Beispiel**
 
 Im folgenden Beispiel wird die aktuelle Reichweite des Fahrzeugs aus MQTT Nachrichten gelesen:
 
 ```yaml
 vehicles:
-  - name: Mazda
+  - name: mazda
     type: custom
+    title: Grüner Mazda
+    capacity: 50
     range:
       source: mqtt
       topic: mazda2mqtt/c53/chargeInfo/drivingRangeKm
@@ -353,6 +404,51 @@ Der volle Funktionsumfang ist in der [offiziellen jq Dokumentation](https://jqla
 Methoden der Authentifizierung sind `basic`, `bearer` und `digest`.
 Die Namen der jeweiligen Parameter finden sich [hier](https://github.com/evcc-io/evcc/blob/master/plugin/http_auth.go#L23).
 
+#### Authentifizierung {#http-auth}
+
+Für HTTP-Anfragen stehen verschiedene Authentifizierungsmethoden zur Verfügung:
+
+**Basic Authentication**:
+
+```yaml
+auth:
+  type: basic
+  user: <benutzername>
+  password: <passwort>
+```
+
+**Bearer Token** (z. B. für JWT):
+
+```yaml
+auth:
+  type: bearer
+  token: <token>
+```
+
+**Digest Authentication**:
+
+```yaml
+auth:
+  type: digest
+  user: <benutzername>
+  password: <passwort>
+```
+
+**Benutzerdefinierte Authentifizierung**:
+
+Für komplexere Authentifizierungsszenarien können benutzerdefinierte Authentifizierungs-Plugins entwickelt werden.
+Diese werden über den Parameter `source` eingebunden:
+
+```yaml
+auth:
+  source: <plugin-name>
+  user: <benutzername>
+  password: <passwort>
+  # weitere plugin-spezifische Parameter
+```
+
+Dies ermöglicht die Integration von Geräten mit speziellen Authentifizierungsanforderungen, ohne den gesamten HTTP-Plugin-Code anpassen zu müssen.
+
 :::important Wichtig
 XML-Dokumente werden intern automatisch in JSON-Form überführt, welche dann mit jq wie eine native JSON-Antwort weiter gefiltert werden können.
 Attribute bekommen das prefix `attr`.
@@ -378,8 +474,7 @@ insecure: false # set to true to trust self-signed certificates
 jq: .data.tuples[0][1] # parse response json
 scale: 0.001 # factor applied to result, e.g. for kW to W conversion
 cache: 60s # response cache duration
-timeout: 10s # timeout in golang duration format,
-             # see https://golang.org/pkg/time/#ParseDuration
+timeout: 10s # timeout in golang duration format, see https://golang.org/pkg/time/#ParseDuration
 ```
 
 ```yaml

docs/faq.mdx

@@ -259,6 +259,44 @@ EVCC_DATABASE_DSN=/var/lib/evcc/evcc.db evcc password reset
 service evcc start
 ```
 
+### Wie kann ich meine Konfiguration sichern und wiederherstellen? {#backup-restore}
+
+In der evcc UI findest du unter **Einstellungen** → **Experimentell aktivieren** → **Sichern & Wiederherstellen** folgende Optionen:
+
+**Sichern:**
+Lädt eine Kopie deiner Datenbank (evcc.db) herunter.
+Diese enthält alle konfigurierten Geräte, Dienste, Pläne, Ladevorgänge, usw.
+
+**Wiederherstellen:**
+Stellt eine zuvor heruntergeladene Datenbank wieder her.
+Vor dem Überschreiben wird automatisch eine lokale Sicherung (`evcc.db.bak`) angelegt.
+
+:::warning Achtung
+Alle Aktionen sind passwortgeschützt.
+Beim Wiederherstellen werden die aktuellen Daten komplett überschrieben.
+:::
+
+**Zurücksetzen:**
+Du kannst einzelne Bereiche deiner Datenbank löschen:
+
+- **Ladevorgänge:** Löscht den Verlauf deiner Ladevorgänge.
+- **Konfiguration & Einstellungen:** Löscht alle konfigurierten Geräte, Dienste, Pläne, Caches, usw.
+
+:::warning Achtung
+Nach dem Zurücksetzen der Konfiguration musst du alle Geräte neu konfigurieren.
+Deine `evcc.yaml` bleibt dabei unverändert.
+:::
+
+Alternativ kannst du einzelne Caches über die Kommandozeile löschen:
+
+```bash
+# Alle Caches ansehen
+evcc cache get
+
+# Alle Caches löschen
+evcc cache clear
+```
+
 ## PV Vorhersage {#pv-vorhersage}
 
 Du kannst in evcc verschiedene [PV-Vorhersagen](/docs/tariffs#pv-vorhersage) nutzen, um die geschätzte Restproduktion für den aktuellen Tag und die nächsten Tage zu sehen.

docs/features/loadmanagement.mdx

@@ -140,6 +140,16 @@ Für die Umsetzung von Regelanweisungen durch den Netzbetreiber kann der HEMS-Me
 Weitere Informationen findest du unter [§ 14a EnWG & SteuVE](./14a-enwg-steuve).
 :::
 
+## Phasenumschaltung
+
+Hast du eine Wallbox mit automatischer Phasenumschaltung (1P/3P), nutzt evcc diese, um die Grenzwerte einzuhalten.
+Reicht die verfügbare Leistung nicht für 3-phasiges Laden, schaltet evcc automatisch auf 1-phasig um.
+
+Dies gilt auch für Schnellladen und planbasiertes Laden.
+Wenn z. B. durch Lastmanagement nur noch 3,5 kW verfügbar sind, wird auf 1-phasiges Laden (ab 1,4 kW) umgeschaltet, statt die Ladung zu pausieren.
+
+**Voraussetzung:** Die Wallbox muss Phasenumschaltung unterstützen.
+
 ## Einschränkungen
 
 :::info
@@ -149,4 +159,3 @@ Private Nutzung mit kleineren Installationen wird kostenlos bleiben.
 
 - Die aktuellen Werte und Grenzen der einzelnen Schaltkreise werden auf der Konfigurationsseite im UI angezeigt. Die Visualisierung am Ladepunkt ist in Planung.
 - `priority` Einstellungen am Ladepunkt werden noch nicht berücksichtigt.
-- Lastmanagement wird nicht durch die Ladeplanung berücksichtigt.

docs/features/sessions.mdx

@@ -87,12 +87,17 @@ Wurde ein Fahrzeug nicht korrekt erkannt, kannst du in dieser Ansicht auch die F
   caption="Detailansicht eines Ladevorgangs"
 />
 
-## Schaltbare Steckdosen
+## Schaltbare Steckdosen und Wärmeerzeugung
 
-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.
+Im Gegensatz zu Wallboxen gibt es bei schaltbaren Steckdosen (z. B. Schuko-Ladegerät, E-Bike, ...) oder Wärmeerzeugern (z. B. Wärmepumpe, Heizstab, ...) keine Möglichkeit, den Ladevorgang zu erkennen.
+
+### Heizungsanlagen
+
+Für Heizungsanlagen (Wärmepumpen, Heizstäbe, etc.) werden Ladevorgänge täglich um Mitternacht automatisch zurückgesetzt.
+Dadurch werden die Messwerte für jeden Tag neu erfasst und die Liste der Ladevorgänge bleibt übersichtlich.
 
-Die momentane Lösung ist für diese Fälle nicht optimal.
-In einem zukünftigen Release werden wir die Auswertung für Schaltsteckdosen und fest verkabelte Anlagen verbessern.
+### Schaltbare Steckdosen
+
+Für schaltbare Steckdosen werden Ladevorgänge mit langen Zeiträumen protokolliert.
+Wird evcc neu gestartet, wird ein neuer Ladevorgang begonnen.
+Dies kann auch über aktives Stoppen und Starten am Ladepunkt (Modus: aus) manuell erfolgen.

docs/reference/cli/evcc.md

@@ -22,11 +22,12 @@ evcc [flags]
       --metrics                Expose metrics
       --profile                Expose pprof profiles
       --template string        Add custom template file (debug only)
-      --template-type string   Custom template type (charger, meter, tariff, vehicle (debug only)
+      --template-type string   Custom template type (charger, meter, tariff, vehicle) (debug only)
 ```
 
 ## See also
 
+* [evcc cache](evcc_cache.md)	 - Manage cache entries
 * [evcc charger](evcc_charger.md)	 - Query configured chargers
 * [evcc checkconfig](evcc_checkconfig.md)	 - Check config file for errors
 * [evcc completion](evcc_completion.md)	 - Generate the autocompletion script for the specified shell

docs/reference/cli/evcc_cache.md

@@ -0,0 +1,26 @@
+# evcc cache
+
+Manage cache entries
+
+## Options inherited from parent commands
+
+```
+  -c, --config string          Config file (default "~/evcc.yaml" or "/etc/evcc.yaml")
+      --custom-css string      Additional user-defined CSS file for custom styling. No compatibility guarantees.
+      --database string        Database location (default "~/.evcc/evcc.db")
+      --demo                   Enter demo mode. Disables auth, config ui and restart
+  -h, --help                   Help
+      --ignore-db              Run command ignoring service database
+  -l, --log string             Log level (fatal, error, warn, info, debug, trace) (default "info")
+      --log-headers            Log headers
+      --template string        Add custom template file (debug only)
+      --template-type string   Custom template type (charger, meter, tariff, vehicle) (debug only)
+```
+
+## See also
+
+* [evcc](evcc.md)	 - evcc - open source solar charging
+* [evcc cache clear](evcc_cache_clear.md)	 - Clear all cache entries
+* [evcc cache get](evcc_cache_get.md)	 - Get cache entries
+
+

docs/reference/cli/evcc_cache_clear.md

@@ -0,0 +1,34 @@
+# evcc cache clear
+
+Clear all cache entries
+
+```
+evcc cache clear [flags]
+```
+
+## Options
+
+```
+  -f, --force   Force (no confirmation)
+```
+
+## Options inherited from parent commands
+
+```
+  -c, --config string          Config file (default "~/evcc.yaml" or "/etc/evcc.yaml")
+      --custom-css string      Additional user-defined CSS file for custom styling. No compatibility guarantees.
+      --database string        Database location (default "~/.evcc/evcc.db")
+      --demo                   Enter demo mode. Disables auth, config ui and restart
+  -h, --help                   Help
+      --ignore-db              Run command ignoring service database
+  -l, --log string             Log level (fatal, error, warn, info, debug, trace) (default "info")
+      --log-headers            Log headers
+      --template string        Add custom template file (debug only)
+      --template-type string   Custom template type (charger, meter, tariff, vehicle) (debug only)
+```
+
+## See also
+
+* [evcc cache](evcc_cache.md)	 - Manage cache entries
+
+

docs/reference/cli/evcc_cache_get.md

@@ -0,0 +1,28 @@
+# evcc cache get
+
+Get cache entries
+
+```
+evcc cache get [flags]
+```
+
+## Options inherited from parent commands
+
+```
+  -c, --config string          Config file (default "~/evcc.yaml" or "/etc/evcc.yaml")
+      --custom-css string      Additional user-defined CSS file for custom styling. No compatibility guarantees.
+      --database string        Database location (default "~/.evcc/evcc.db")
+      --demo                   Enter demo mode. Disables auth, config ui and restart
+  -h, --help                   Help
+      --ignore-db              Run command ignoring service database
+  -l, --log string             Log level (fatal, error, warn, info, debug, trace) (default "info")
+      --log-headers            Log headers
+      --template string        Add custom template file (debug only)
+      --template-type string   Custom template type (charger, meter, tariff, vehicle) (debug only)
+```
+
+## See also
+
+* [evcc cache](evcc_cache.md)	 - Manage cache entries
+
+