Zum Inhalt springen
Smart laden

messaging

Im Abschnitt messaging richtest du Benachrichtigungen zu Ladevorgängen über Dienste wie Telegram, Pushover, ntfy oder E-Mail ein. Unter events legst du fest, bei welchen Ereignissen eine Nachricht verschickt wird, und unter services, über welche Dienste sie ankommt.

Beispiel:

messaging:
events: ...
services: ...

Unter events legst du den Nachrichteninhalt für die vordefinierten Ereignisse fest.

Die verfügbaren Ereignisse sind:

  • start: Laden gestartet
  • stop: Laden beendet
  • connect: Fahrzeug angeschlossen
  • disconnect: Fahrzeug getrennt
  • soc: Ladestand des Fahrzeugs geändert
  • guest: Unbekanntes Fahrzeug erkannt
  • asleep: Fahrzeug lädt trotz Ladefreigabe nicht
  • planoverrun: Ladeplan verfehlt voraussichtlich sein Ziel

Beispiel:

start: # Ereignis Ladestart
title: Laden gestartet
msg: Laden im Modus "${mode}" gestartet

title ist der Titel der Nachricht.

msg ist der eigentliche Nachrichtentext. Titel und Nachricht unterstützen Platzhalter, entweder in der einfachen Form ${variableName} oder als Go-Template ({{.variableName}}). Die verfügbaren Variablen sind unter Nachrichtenformat aufgeführt.

Beispiel (einfache Syntax):

messaging:
events:
start:
title: Laden gestartet
msg: >-
${title} lädt ${vehicleTitle} im Modus ${mode}
stop:
title: Laden beendet
msg: >-
${title}: ${vehicleTitle} hat ${chargedEnergy:%.1fk} kWh in ${chargeDuration} geladen.
PV-Anteil: ${sessionSolarPercentage:%.0f}%
connect:
title: Fahrzeug angeschlossen
msg: >-
${vehicleTitle} bei ${pvPower:%.1fk} kW PV-Leistung an ${title} angeschlossen
disconnect:
title: Fahrzeug getrennt
msg: >-
${vehicleTitle} nach ${connectedDuration} von ${title} getrennt

Beispiel (Go-Template-Syntax mit Berechnungen und Bedingungen):

messaging:
events:
start:
title: "{{.vehicleTitle}}: Laden gestartet"
msg: |
{{.title}} lädt {{.vehicleTitle}} im Modus {{ toString .mode | upper }}.
PV: {{round (divf .pvPower 1000) 1 }} kW
Netz: {{round (divf .grid.Power 1000) 1 }} kW
{{if .battery}}Hausbatterie: {{round (divf .battery.Power 1000) 1 }} kW ({{.battery.Soc }}%){{end}}
stop:
title: "{{.vehicleTitle}}: Laden beendet"
msg: |
{{.title}}: {{round (divf .chargedEnergy 1000) 1 }} kWh in {{.chargeDuration}}.
PV-Anteil: {{round .sessionSolarPercentage 0 }}%
{{- if .sessionPrice}}
Kosten: {{round .sessionPrice 2 }} {{.currency}} ({{round .sessionPricePerKWh 2 }} {{.currency}}/kWh)
{{- end}}
connect:
title: "{{.vehicleTitle}} angeschlossen"
msg: |
{{.vehicleTitle}} an {{.title}} angeschlossen.
Ladestand: {{.vehicleSoc }}% ({{.vehicleRange }} km)
PV: {{round (divf .pvPower 1000) 1 }} kW
disconnect:
title: "{{.vehicleTitle}} getrennt"
msg: |
{{.vehicleTitle}} nach {{.connectedDuration}} von {{.title}} getrennt.

services enthält die Liste der Benachrichtigungsdienste, über die Nachrichten verschickt werden.

Beispiel:

services:
- type: template
template: pushover
app: 12345
recipients:
- 234567

Die verfügbaren Dienste und ihre Parameter sind auf der Seite Benachrichtigungen aufgeführt. Jede Dienstseite zeigt ein fertiges evcc.yaml-Beispiel.

Mit type: custom kannst du außerdem beliebige Plugins mit Schreibzugriff verwenden. Details findest du im Abschnitt benutzerdefinierter Benachrichtigungsdienst.