Ga naar inhoud
slim laden

messaging

De sectie messaging configureert meldingen over laadsessies via diensten zoals Telegram, Pushover, ntfy of e-mail. events legt vast bij welke gebeurtenissen berichten worden verstuurd en services legt vast via welke diensten ze worden verstuurd.

Voorbeeld:

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

events

Section titled “events”

events definieert de berichtinhoud voor verschillende vooraf gedefinieerde gebeurtenissen.

De beschikbare gebeurtenissen zijn:

  • start: Laden is gestart
  • stop: Laden is gestopt
  • connect: Voertuig verbonden
  • disconnect: Voertuig losgekoppeld
  • soc: Laadniveau van het voertuig gewijzigd
  • guest: Onbekend voertuig gedetecteerd
  • asleep: Voertuig laadt niet, hoewel laden is vrijgegeven
  • planoverrun: Laadplan haalt naar verwachting zijn doel niet

Voorbeeld:

start: # charge start event
  title: Charge started
  msg: Started charging in "${mode}" mode

title

Section titled “title”

title definieert de tekst voor de titel van het bericht.

msg

Section titled “msg”

msg definieert de tekst voor de inhoud van het bericht. Titels en berichten ondersteunen plaatshouders, in de eenvoudige vorm ${variableName} of als Go-templates ({{.variableName}}). De beschikbare variabelen staan onder berichtformaat.

Voorbeeld (eenvoudige syntaxis):

messaging:
  events:
    start:
      title: Charging started
      msg: >-
        ${title} charging ${vehicleTitle} in ${mode} mode
    stop:
      title: Charging finished
      msg: >-
        ${title}: ${vehicleTitle} charged ${chargedEnergy:%.1fk}kWh in ${chargeDuration}.
        Solar share: ${sessionSolarPercentage:%.0f}%
    connect:
      title: Vehicle connected
      msg: >-
        ${vehicleTitle} connected to ${title} at ${pvPower:%.1fk}kW solar
    disconnect:
      title: Vehicle disconnected
      msg: >-
        ${vehicleTitle} disconnected from ${title} after ${connectedDuration}

Voorbeeld (Go-templatesyntaxis met berekeningen en voorwaarden):

messaging:
  events:
    start:
      title: "{{.vehicleTitle}}: Charging started"
      msg: |
        {{.title}} charging {{.vehicleTitle}} in {{ toString .mode | upper }} mode.
        Solar: {{round (divf .pvPower 1000) 1 }} kW
        Grid: {{round (divf .grid.Power 1000) 1 }} kW
        {{if .battery}}Battery: {{round (divf .battery.Power 1000) 1 }} kW ({{.battery.Soc }} %){{end}}
    stop:
      title: "{{.vehicleTitle}}: Charging finished"
      msg: |
        {{.title}}: {{round (divf .chargedEnergy 1000) 1 }} kWh in {{.chargeDuration}}.
        Solar share: {{round .sessionSolarPercentage 0 }}%
        {{- if .sessionPrice}}
        Cost: {{round .sessionPrice 2 }} {{.currency}} ({{round .sessionPricePerKWh 2 }} {{.currency}}/kWh)
        {{- end}}
    connect:
      title: "{{.vehicleTitle}} connected"
      msg: |
        {{.vehicleTitle}} connected to {{.title}}.
        SoC: {{.vehicleSoc }}% ({{.vehicleRange }} km)
        Solar: {{round (divf .pvPower 1000) 1 }} kW
    disconnect:
      title: "{{.vehicleTitle}} disconnected"
      msg: |
        {{.vehicleTitle}} disconnected from {{.title}} after {{.connectedDuration}}.

services

Section titled “services”

services definieert een lijst van te gebruiken berichtendiensten.

Voorbeeld:

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

De beschikbare diensten en hun parameters staan op de pagina meldingen. Elke dienstpagina toont een kant-en-klaar voorbeeld voor evcc.yaml.

Met type: custom kunt u daarnaast elke plugin met schrijftoegang gebruiken. Zie gebruikergedefinieerde meldingsdienst.