Add, Installation, Home Assistant and Proxmox DE/EN / Integration HA update (v2)

blog/2021-12-10/version-0-72.md

@@ -29,8 +29,8 @@ Mit diesem Kommando lässt sich interaktiv eine funktionierende Konfigurationsda
 
 - [Debian, Ubuntu, Raspberry Pi](/docs/installation/linux)
 - [macOS Homebrew](/docs/installation/macos)
-- [Docker, Synology](/docs/installation/docker)
-- [Manuell (inkl. Windows)](/docs/installation/manual)
+- [Docker](/docs/installation/docker)
+- [Windows](/docs/installation/windows)
 
 ## Changelog
 

blog/2021-12-12/version-0-73.md

@@ -26,8 +26,8 @@ Für einige Fahrzeuge kann **evcc** nun den aktuellen Standort erkennen. Dies wi
 
 - [Debian, Ubuntu, Raspberry Pi](/docs/installation/linux)
 - [macOS Homebrew](/docs/installation/macos)
-- [Docker, Synology](/docs/installation/docker)
-- [Manuell (inkl. Windows)](/docs/installation/manual)
+- [Docker](/docs/installation/docker)
+- [Windows](/docs/installation/windows)
 
 ## Changelog
 

blog/2021-12-19/version-0-74.md

@@ -34,8 +34,8 @@ Die Zielladen Funktionalität ist zurück. Hiermit kann man das EV auf ein besti
 
 - [Debian, Ubuntu, Raspberry Pi](/docs/installation/linux)
 - [macOS Homebrew](/docs/installation/macos)
-- [Docker, Synology](/docs/installation/docker)
-- [Manuell (inkl. Windows)](/docs/installation/manual)
+- [Docker](/docs/installation/docker)
+- [Windows](/docs/installation/windows)
 
 ## Changelog
 

blog/2021-12-29/version-0-76.md

@@ -21,8 +21,8 @@ Diese Version enthält eine Reihe von Fehlerkorrekturen und vielen kleinen Verbe
 
 - [Debian, Ubuntu, Raspberry Pi](/docs/installation/linux)
 - [macOS Homebrew](/docs/installation/macos)
-- [Docker, Synology](/docs/installation/docker)
-- [Manuell (inkl. Windows)](/docs/installation/manual)
+- [Docker](/docs/installation/docker)
+- [Windows](/docs/installation/windows)
 
 ## Changelog
 

blog/2021-12-31/version-0-77.md

@@ -17,8 +17,8 @@ Gegenüber der Version 0.76 haben wir Korrekturen für die Verwendung einiger Ge
 
 - [Debian, Ubuntu, Raspberry Pi](/docs/installation/linux)
 - [macOS Homebrew](/docs/installation/macos)
-- [Docker, Synology](/docs/installation/docker)
-- [Manuell (inkl. Windows)](/docs/installation/manual)
+- [Docker](/docs/installation/docker)
+- [Windows](/docs/installation/windows)
 
 ## Changelog
 

blog/2022-01-09/version-0-80.md

@@ -40,8 +40,8 @@ Diese Version enthält natürlich wieder eine Reihe von Fehlerkorrekturen und vi
 
 - [Debian, Ubuntu, Raspberry Pi](/docs/installation/linux)
 - [macOS Homebrew](/docs/installation/macos)
-- [Docker, Synology](/docs/installation/docker)
-- [Manuell (inkl. Windows)](/docs/installation/manual)
+- [Docker](/docs/installation/docker)
+- [Windows](/docs/installation/windows)
 
 ## Changelog
 

docs/faq.mdx

@@ -108,7 +108,7 @@ Mittels `evcc charger` oder `evcc meter` oder `evcc vehicle` können auf der Kom
 
 `Beispiel: evcc -l debug meter`
 
-Wird evcc als Linux Systemdienst, wie [hier beschrieben](/docs/installation/manual#evcc-als-service), ausgeführt, können die log-Nachrichten über folgende Befehle verfolgt, bzw. aufgelistet werden:
+Wird evcc als Linux Systemdienst, wie [hier beschrieben](/docs/installation/linux#systemd), ausgeführt, können die log-Nachrichten über folgende Befehle verfolgt, bzw. aufgelistet werden:
 
 - Kontinuierliche Anzeige der evcc log Meldungen  
   `sudo journalctl -fau evcc`

docs/installation/configuration.mdx

@@ -0,0 +1,221 @@
+---
+sidebar_position: 10
+---
+import Tabs from "@theme/Tabs";
+import TabItem from "@theme/TabItem";
+
+# Konfiguration
+
+Diese Anleitung beschreibt, wie du an eine funktionierende `evcc.yaml` Datei kommst.
+
+## Mit Assistenten
+
+Über den `evcc configure` Befehl kannst du dir eine Konfigurationsdatei über einen Terminal-basierten Assistenten erstellen lassen.
+In einem Frage-Antwort-Dialog kannst du deine jeweiligen Geräte konfigurieren.
+
+### Voraussetzungen
+
+Um den Assistenten nutzen zu können, muss evcc auf deinem System installiert sein.
+Zudem musst du den `evcc` Befehl mit der Kommandozeile (Terminal, Shell, Eingabeaufforderung) ausführen können.
+Läuft evcc auf einem System, wo du diesen Zugriff nicht hast (bspw. Home Assistant, Docker), kannst du den Assistenten leider nicht nutzen.
+
+:::note
+`evcc configure` kann auch in einem Docker Container gestartet werden.
+Siehe dafür die Erklärung in [Docker](./docker).
+:::
+
+### Assistent ausführen
+
+Starte die Konfiguration und folge den Anweisungen im Terminal Fenster:
+
+```sh
+evcc configure
+```
+
+Du solltest eine Ausgabe wie die folgende sehen:
+
+![evcc configure](./screenshots/configure.webp)
+
+Nach Abschluss der Konfiguration wird eine `evcc.yaml` Datei im aktuellen Verzeichnis erstellt.
+
+:::note
+Mit `--advanced` kannst du den Assistenten auch in einem erweiterten Modus starten.
+Dann bekommst du zusätzliche Einstellungsmöglichkeiten.
+Für deine erste Konfiguration ist das aber nicht notwendig.
+
+```sh
+evcc configure --advanced
+```
+:::
+
+Teste, ob die Konfiguration funktioniert
+
+```sh
+evcc -c evcc.yaml
+```
+
+Öffne einen Browser und gib die folgende URL ein: `http://localhost:7070`.
+Die evcc Oberfläche sollte nun mit den eigenen Geräten zu sehen sein.
+
+Wenn alles funktioniert kannst du deine `evcc.yaml` an die Stelle verschieben, die für deine Installation notwendig ist.
+
+### Fehlersuche
+
+Sollten Fehler auftreten, kannst du dir mit folgenden Befehlen weitere Informationen anzeigen lassen.
+
+- Syntaxprüfung
+
+  ```sh
+  evcc -c evcc.yaml checkconfig
+  ```
+
+- Zähler (Netz, PV, Batterie)
+
+  ```sh
+  evcc -c evcc.yaml -l debug meter
+  ```
+
+- Fahrzeuge
+
+  ```sh
+  evcc -c evcc.yaml -l debug vehicle
+  ```
+
+- Wallboxen
+
+  ```sh
+  evcc -c evcc.yaml -l debug charger
+  ```
+
+Überprüfe die Ausgaben der jeweiligen Befehle auf Plausibilität.
+
+Du kannst `evcc configure` auch erneut ausführen und deine Angaben korrigieren.
+Beachte, dass der Assistent immer eine komplett neue Konfiguration erstellt.
+Ein gezieltes Verändern einer bestehenden Konfiguration ist nicht möglich.
+Nutze dafür die manuelle Konfiguration.
+
+## Manuell
+
+Sollte der Assistent für dich nicht verfügbar sein, kannst du die `evcc.yaml` Datei manuell erstellen.
+Hier findest du eine minimale Vorlage, die du als Ausgangspunkt nutzen kannst.
+
+### Erstellen
+
+Kopiere den Inhalt in eine neue `evcc.yaml` Datei.
+
+```yaml title="evcc.yaml"
+## minimal configuration example
+
+site:
+  title: Home # display name for UI
+  meters:
+    grid: my_grid
+    pv:
+      - my_pv
+    battery:
+      - my_battery
+
+# define your loadpoints according your needs
+# see https://docs.evcc.io/en/docs/reference/configuration/loadpoints
+loadpoints:
+  - title: Garage # display name for UI
+    charger: my_charger # charger
+    vehicle: my_car # default vehicle
+
+# meter definitions
+# name can be freely chosen and is used as reference when assigning meters to site and loadpoints
+# for documentation see https://docs.evcc.io/docs/devices/meters
+meters:
+  # replace with your real grid meter
+  - name: my_grid
+    type: template
+    template: demo-meter
+    usage: grid
+    power: -1000 # 1 kW feed-in
+  # replace with your real pv system
+  - name: my_pv
+    type: template
+    template: demo-meter
+    usage: pv
+    power: 4000 # 4 kW production
+  # replace with your real battery
+  - name: my_battery
+    type: template
+    template: demo-battery
+    usage: battery
+    power: -1000 # 1 kW battery charging
+    soc: 50 # 50 % state of charge
+
+# replace with your real charger
+# see https://docs.evcc.io/docs/devices/chargers
+chargers:
+  - name: my_charger
+    type: template
+    template: demo-charger
+    status: C # charging
+    power: 2000 # 2 kW charging power
+    enabled: true # optional
+
+# replace with your real vehicle (optional)
+# see https://docs.evcc.io/docs/devices/vehicles
+vehicles:
+  - name: my_car
+    type: template
+    template: offline
+    title: blue e-Golf
+    capacity: 50 # in kWh
+
+# enter your real grid tariff and feed-in price
+# see https://docs.evcc.io/docs/devices/tariffs
+tariffs:
+  currency: EUR
+  grid:
+    type: fixed
+    price: 0.29 # EUR/kWh
+  feedin:
+    type: fixed
+    price: 0.10 # EUR/kWh
+```
+
+Mit dieser Datei kannst du evcc starten.
+Nutze dafür die jeweilige Anleitung für dein System.
+
+### Testen
+
+Starte evcc neu und öffne deinen Browser unter `http://<evcc-ip>:7070`.
+Überprüfe, ob die Werte plausibel sind.
+Solltest du eine Fehlermeldung erhalten, überprüfe deine Angaben.
+
+Oft sind es auch Einrückungs- oder Tippfehler.
+Die Datei ist im [YAML Format](https://wikipedia.org/wiki/YAML) verfasst.
+Mit dem Online-Tool [YAML Lint](https://www.yamllint.com/) kannst du prüfen ob deine Datei das richtige Format einhält.
+
+
+### Anpassen
+
+Die Datei beinhaltet lediglich Demo-Geräte (`demo-charger`, `demo-meter`, `demo-battery`, `offline`).
+Diese haben feste Werte.
+Gehe die Datei nun Stück für Stück durch und passe die Werte an dein Setup an:
+
+- Ersetze die Demo-Geräte durch deine eigenen [Zähler](../devices/meters), [Wallboxen](../devices/chargers) und [Fahrzeuge](../devices/vehicles).
+- Hast du keine Batterie, kannst du den entsprechenden Abschnitt komplett entfernen.
+- Hast du mehrere PV-Anlagen, kannst du die entsprechenden Abschnitte duplizieren.
+- Hast du mehrere Wallboxen, kopiere den Loadpoint- und Charger-Abschnitt und passe die Namen an.
+
+Beachte, dass die einzelnen Einträge sich gegenseitig referenzieren.
+Im `site` Eintrag (`meters`), werden die Zähler (`grid`, `pv`, `battery`) ihren Rollen zugeordnet.
+Hierfür wird immer das `name` Feld benutzt.
+Namen müssen daher eindeutig sein.
+
+Führe diese Änderungen möglichst Schritt für Schritt durch.
+Starte nach jeder Änderung evcc neu und überprüfe die Ausgaben im Browser.
+Dann bemerkst du schnell, wenn du einen Fehler gemacht hast.
+
+### Weitere Informationen
+
+Die [evcc.dist.yaml](https://github.com/evcc-io/evcc/blob/master/evcc.dist.yaml) im Hauptprojekt beinhaltet eine vollständige Liste aller möglichen Konfigurations-Optionen.
+Ausführlichere Erklärungen zu den Optionen findest du unter [Referenz → evcc.yaml](../reference/configuration).
+
+Willst du eine dynamische Demo sehen kannst du dir auch den Inhalt der Datei [demo.yaml](https://github.com/evcc-io/evcc/blob/master/cmd/demo.yaml) ansehen.
+Diese Datei beinhaltet JavaScript-basierte Demo-Geräte, die eine eingeschränkte Funktionalität simulieren.
+Sie wird auch für [demo.evcc.io](https://demo.evcc.io) genutzt.