Templates update for nightly evcc-io/evcc@960a71c

Author: naltatis

templates/nightly/de/vehicle/volvo-connected_0.yaml

@@ -1,30 +1,40 @@
 product:
   brand: Volvo
-  description: aktuell
+description: |
+  Für die Nutzung mit EVCC benötigst du einen Volvo Account und einen Volvo Connected Car API Key.
+  Erstelle dazu auf der [Account Seite](https://developer.volvocars.com/account/) eine neue Applikation und speichere den primären VCC API Key ab.
+  Veröffentliche nun deine Applikation und wähle unter "Scopes" die Berechtigungen "Connected Vehicle API -> conve:vehicle_relation" und "Energy API -> (alles)" aus.
+  Als Redirect URL kannst du erstmal "http://localhost:9999" (oder etwas anderes nicht erreichbares) verwenden. Der Authorisierungscode wird später händisch aus dem Browser gelesen und eingegeben.
+  Sobald die Applikation erstellt ist, wird sie als "Publication under Review" angezeigt. Das ist nicht weiter schlimm, es funktioniert trotzdem.
+  Erstelle danach einen Token mit `evcc token <auto-name>` und speichere die Tokens in der Konfiguration. Falls Evcc wegen einem invaliden Refresh Token abbricht, lösche die Tokens mit `evcc settings` und generiere sie neu.
+
 render:
   - default: |
       type: template
       template: volvo-connected
-      user: # Benutzerkonto (bspw. E-Mail Adresse, User Id, etc.)
-      password: # Passwort des Benutzerkontos (bei führenden Nullen bitte in einfache Hochkommata setzen)
-      vin: W... # Erforderlich, wenn mehrere Fahrzeuge des Herstellers vorhanden sind (optional)
       title: # Wird in der Benutzeroberfläche angezeigt (optional)
       capacity: 50 # Akkukapazität in kWh (optional)
-      vccapikey: # Volvo developer portal VCC API Key, siehe https://github.com/evcc-io/evcc/discussions/3677#discussioncomment-4106300
+      vccapikey: # Volvo developer portal VCC API Key
+      clientId: # Client ID deiner [Volvo Developer App](https://developer.volvocars.com/).
+      clientSecret: # Client Secret deiner [Volvo Developer App](https://developer.volvocars.com/).
+      accessToken:
+      refreshToken:
+      vin: WF0FXX... # Erforderlich, wenn mehrere Fahrzeuge des Herstellers vorhanden sind (optional)
     advanced: |
       type: template
       template: volvo-connected
-      user: # Benutzerkonto (bspw. E-Mail Adresse, User Id, etc.)
-      password: # Passwort des Benutzerkontos (bei führenden Nullen bitte in einfache Hochkommata setzen)
-      vin: W... # Erforderlich, wenn mehrere Fahrzeuge des Herstellers vorhanden sind (optional)
       title: # Wird in der Benutzeroberfläche angezeigt (optional)
       capacity: 50 # Akkukapazität in kWh (optional)
-      vccapikey: # Volvo developer portal VCC API Key, siehe https://github.com/evcc-io/evcc/discussions/3677#discussioncomment-4106300
+      vccapikey: # Volvo developer portal VCC API Key
+      clientId: # Client ID deiner [Volvo Developer App](https://developer.volvocars.com/).
+      clientSecret: # Client Secret deiner [Volvo Developer App](https://developer.volvocars.com/).
+      accessToken:
+      refreshToken:
+      vin: WF0FXX... # Erforderlich, wenn mehrere Fahrzeuge des Herstellers vorhanden sind (optional)
       icon: car # Icon in der Benutzeroberfläche [car, bike, bus, moped, motorcycle, rocket, scooter, taxi, tractor, rickshaw, shuttle, van, airpurifier, battery, bulb, climate, coffeemaker, compute, cooking, cooler, desktop, device, dishwasher, dryer, floorlamp, generic, heater, heatexchange, heatpump, kettle, laundry, laundry2, machine, meter, microwave, pump, smartconsumer, tool, waterheater] (optional)
       phases: 3 # Die maximale Anzahl der Phasen welche genutzt werden können (optional)
       mode: # Möglich sind Off, Now, MinPV und PV, oder leer wenn keiner definiert werden soll (optional)
       minCurrent: 6 # Definiert die minimale Stromstärke pro angeschlossener Phase mit welcher das Fahrzeug geladen werden soll (optional)
       maxCurrent: 16 # Definiert die maximale Stromstärke pro angeschlossener Phase mit welcher das Fahrzeug geladen werden soll (optional)
       identifiers: # Kann meist erst später eingetragen werden, siehe: https://docs.evcc.io/docs/features/vehicle (optional)
       priority: # Priorität des Ladepunktes oder Fahrzeugs in Relation zu anderen Ladepunkten oder Fahrzeugen für die Zuweisung von PV-Energie (optional)
-      cache: 15m # Zeitintervall nach dem Daten erneut vom Fahrzeug abgefragt werden (optional)

templates/nightly/de/vehicle/volvo_0.yaml

@@ -1,30 +1,40 @@
 product:
   brand: Volvo
-  description: latest
+description: |
+  To use with EVCC, you need a Volvo account and a Volvo Connected Car API Key.
+  To do this, create a new application on the [Account page](https://developer.volvocars.com/account/) and save the primary VCC API key.
+  Now publish your application and select the permissions "Connected Vehicle API -> conve:vehicle_relation" and "Energy API -> (everything)" under "Scopes".
+  You can use "http://localhost:9999" (or something else unreachable) as the redirect URL for now. The authorization code will be read and entered manually from the browser later.
+  Once the application is created, it will be displayed as "Publication under Review". This is not a problem, it still works.
+  Then create a token with `evcc token <car-name>` and save the tokens in the configuration. If Evcc crashes due to an invalid refresh token, delete the tokens with `evcc settings` and generate them again.
+
 render:
   - default: |
       type: template
       template: volvo-connected
-      user: # User account (e.g. email address, user id, etc.)
-      password: # Password of the user account (use single quotes in case of leading zeros)
-      vin: W... # Required if you own multiple vehicles of the same brand (optional)
       title: # Will be displayed in the user interface (optional)
       capacity: 50 # Battery capacity in kWh (optional)
-      vccapikey: # Volvo developer portal VCC API Key, see https://github.com/evcc-io/evcc/discussions/3677#discussioncomment-4106300
+      vccapikey: # Volvo developer portal VCC API Key
+      clientId: # Client ID of your [Volvo Developer App](https://developer.volvocars.com/).
+      clientSecret: # Client Secret of your [Volvo Developer App](https://developer.volvocars.com/).
+      accessToken:
+      refreshToken:
+      vin: WF0FXX... # Required if you own multiple vehicles of the same brand (optional)
     advanced: |
       type: template
       template: volvo-connected
-      user: # User account (e.g. email address, user id, etc.)
-      password: # Password of the user account (use single quotes in case of leading zeros)
-      vin: W... # Required if you own multiple vehicles of the same brand (optional)
       title: # Will be displayed in the user interface (optional)
       capacity: 50 # Battery capacity in kWh (optional)
-      vccapikey: # Volvo developer portal VCC API Key, see https://github.com/evcc-io/evcc/discussions/3677#discussioncomment-4106300
+      vccapikey: # Volvo developer portal VCC API Key
+      clientId: # Client ID of your [Volvo Developer App](https://developer.volvocars.com/).
+      clientSecret: # Client Secret of your [Volvo Developer App](https://developer.volvocars.com/).
+      accessToken:
+      refreshToken:
+      vin: WF0FXX... # Required if you own multiple vehicles of the same brand (optional)
       icon: car # Icon as shown in user interface [car, bike, bus, moped, motorcycle, rocket, scooter, taxi, tractor, rickshaw, shuttle, van, airpurifier, battery, bulb, climate, coffeemaker, compute, cooking, cooler, desktop, device, dishwasher, dryer, floorlamp, generic, heater, heatexchange, heatpump, kettle, laundry, laundry2, machine, meter, microwave, pump, smartconsumer, tool, waterheater] (optional)
       phases: 3 # The maximum number of phases which can be used (optional)
       mode: # Possible values are Off, Now, MinPV and PV, or empty if none should be set (optional)
       minCurrent: 6 # The minimum amperage per connected phase with which the car should be charged (optional)
       maxCurrent: 16 # The maximum amperage per connected phase with which the car shuold be charged (optional)
       identifiers: # Mostly this can be added later, see: https://docs.evcc.io/en/docs/features/vehicle (optional)
       priority: # Priority of the loadpoint or vehicle in relation to other loadpoints or vehicles for allocating pv energy (optional)
-      cache: 15m # Time interval with when data should be reloaded from the vehicle (optional)