Skip to content

Latest commit

 

History

History
759 lines (633 loc) · 18 KB

README.md

File metadata and controls

759 lines (633 loc) · 18 KB
Raw

Configuration examples for EVCC

Build Status

Configuration examples for the EVCC EV Charge Controller.

Meters

Chargers

Vehicles

Details

Meters

Discovergy (Grid or PV meter/ HTTP)

- type: default
  power: # power reading
    type: http # use http plugin
    auth:
      type: basic
      user: [email protected] # Discovergy user name
      password: demo # password 
    uri: https://api.discovergy.com/public/v1/last_reading?meterId=659a3da00324400da66cef81e1cbe3c5 # append meter id
    jq: .values.power
    scale: 0.001

E3DC (Battery)

- type: default
  power:
    type: modbus
    uri: e3dc.fritz.box:502
    id: 1 # ModBus slave id
    register: # manual register configuration
      address: 40070
      type: holding
      decode: int32
    scale: -1 # reverse direction
  soc:
    type: modbus
    uri: e3dc.fritz.box:502
    id: 1 # ModBus slave id
    register: # manual register configuration
      address: 40082
      type: holding
      decode: uint16

E3DC (PV Meter)

- type: default
  power:
    type: modbus
    uri: e3dc.fritz.box:502
    id: 1 # ModBus slave id
    register: # manual register configuration
      address: 40067 # (40068 - 1) "Photovoltaikleistung in Watt"
      type: holding
      decode: int32s
    scale: -1 # reverse sign

Generisch (MQTT)

- type: default
  power: # power reading
    type: mqtt # use mqtt plugin
    topic: mbmd/sdm1-1/Power # mqtt topic
    timeout: 10s # don't use older values

Generisch (Script)

- type: default
  power:
    type: script # use script plugin
    cmd: /bin/sh -c "echo 0" # actual command
    timeout: 3s # kill script after 3 seconds

Kostal Inverter (Grid Meter)

- type: default
  power:
    type: modbus # use ModBus plugin
    model: kostal
    uri: 192.168.178.52:1502 
    id: 71 # Configured Modbus Device ID 
    register: # manual register configuration
      address: 252 # (see https://www.kostal-solar-electric.com/de-de/download/-/media/document-library-folder---kse/2018/08/30/08/53/ba_kostal_interface_modbus-tcp_sunspec.pdf)
      type: holding
      decode: float32s #swapped float encoding

Kostal Inverter (PV Meter)

- type: modbus
  model: kostal
  uri: 192.168.0.1:1502
  id: 71
  power: Power

Kostal Smart Energy Meter (Grid Meter)

- type: modbus
  model: kostal
  uri: 192.168.0.1:502
  id: 71
  power: Power
  energy: Energy

Modbus (Ethernet)

- type: modbus
  model: sdm
  uri: rs485.fritz.box:23
  rtu: true # rs485 device connected using ethernet adapter
  id: 2
  power: Power # default values, optionally override
  energy: Sum # default values, optionally override

Modbus (RTU)

- type: modbus
  model: sdm
  uri: rs485.fritz.box:23
  rtu: true # rs485 device connected using ethernet adapter
  id: 2
  power: Power # default value, optionally override
  energy: Sum # energy value (Zählerstand)

Multiple Grid Inverters combined (PV Meter)

- type: default
  power:
    type: calc # use the calc plugin
    add: # The add function sums up both string values
    - type: modbus
      model: sunspec
      value: 160:1:DCW # string 1
      uri: 192.168.178.52:1502 
      id: 71 # Configured Modbus Device ID 
    - type: modbus  
      value: 160:2:DCW # string 2
      uri: 192.168.178.52:1502 
      id: 71 # Configured Modbus Device ID

SMA Sunny Boy Storage (Battery)

- type: modbus
  uri: 192.168.178.91:502 # 
  id: 126 # ModBus slave id
  model: sma-sunspec
  power: Power # default value, optionally override
  soc: ChargeState # battery soc (Ladezustand)

SMA Sunny Home Manager 2.0 / SMA Energy Meter 30

- type: sma
  serial: 1234567890 # Serial number of the device

SMA Sunny Island (Battery)

- type: modbus
  model: sunny-island
  uri: 192.168.1.4:502
  id: 126
  power: Power # default values, optionally override
  soc: ChargeState # battery soc (Ladezustand)

SMA SunnyBoy / TriPower / other SunSpec PV-inverters (PV Meter)

- type: modbus
  uri: 192.168.178.91:502 # 
  id: 126 # ModBus slave id
  model: sma-sunspec
  power: Power # default value, optionally override
  energy: Sum # energy value (Zählerstand)

Solarlog (Grid Meter)

- type: default
  power:
    type: modbus
    uri: 192.168.0.32:502 # IP address of the SolarLog device and ModBus port address
    id: 1
    register:
      address: 3518
      type: input
      decode: uint32s

Solarlog (PV Meter)

- type: default
  power:
    type: modbus
    uri: 192.168.0.32:502 # IP address of the SolarLog  device and ModBus port address
    id: 1
    register:
      address: 3502
      type: input
      decode: uint32s

Sonnenbatterie Eco (Battery/ HTTP)

- type: default
  power: # power reading
    type: http # use http plugin
    uri: http://192.168.1.75:8080/api/v1/status
    jq: .Pac_total_W
    scale: -1 # reverse direction

Sonnenbatterie Eco (Grid meter/ HTTP)

- type: default
  power: # power reading
    type: http # use http plugin
    uri: http://192.168.1.75:8080/api/v1/status
    jq: .GridFeedIn_W
    scale: -1 # reverse direction

Sonnenbatterie Eco (PV meter/ HTTP)

- type: default
  power: # power reading
    type: http # use http plugin
    uri: http://192.168.1.75:8080/api/v1/status
    jq: .Production_W

Tesla Powerwall (Battery)

- type: tesla
  uri: http://192.168.1.4/api/meters/aggregates
  usage: battery # grid meter: `site`, pv: `solar`, battery: `battery`

Tesla Powerwall (Grid meter)

- type: tesla
  uri: http://192.168.1.4/api/meters/aggregates
  usage: site # grid meter: `site`, pv: `solar`, battery: `battery`

Tesla Powerwall (PV meter)

- type: tesla
  uri: http://192.168.1.4/api/meters/aggregates
  usage: solar # grid meter: `site`, pv: `solar`, battery: `battery`

vzlogger (HTTP)

- type: default
  power: # power reading
    type: http # use http plugin
    uri: http://demo.volkszaehler.org/api/data/<uuid>.json?from=now
    jq: .data.tuples[0][1] # parse response json

vzlogger (Push Server/ Websocket)

- type: default
  power:
    type: ws # use websocket plugin
    uri: ws://volkszaehler:8082/socket
    jq: .data | select(.uuid=="<uuid>") .tuples[0][1] # parse response json
    timeout: 30s
    scale: 1

vzlogger (split import/export channels)

- type: default
  power:
    type: calc # use calc plugin
    add:
    - type: http # import channel
      uri: http://volkszaehler/api/data/<import-uuid>.json?from=now
      jq: .data.tuples[0][1] # parse response json
    - type: http # export channel
      uri: http://volkszaehler/api/data/<export-uuid>.json?from=now
      jq: .data.tuples[0][1] # parse response json
      scale: -1 # export must result in negative values

Chargers

EVSE Wifi

- type: evsewifi
  uri: http://192.168.1.4 # SimpleEVSE-Wifi address

Generisch

- type: default
  status: # charger status A..F
    type: ...
    # ...
  enabled: # charger enabled state (true/false or 0/1)
    type: ...
    # ...
  enable: # set charger enabled state
    type: ...
    # ...
  maxcurrent: # set charger max current
    type: ...
    # ...

Generisch (MQTT)

- type: default
  status: # charger status A..F
    type: mqtt
    topic: some/topic1
  enabled: # charger enabled state (true/false or 0/1)
    type: mqtt
    topic: some/topic2
  enable: # set charger enabled state
    type: script
    cmd: /bin/sh -c "echo ${enable}"
  maxcurrent: # set charger max current
    type: script
    cmd: /bin/sh -c "echo ${maxcurrent}"

go-eCharger (Cloud)

- type: go-e
  token: 4711c # or go-e cloud API token
  cache: 10s # go-e cloud API cache duration

go-eCharger (Lokal)

- type: go-e
  uri: http://192.168.1.4 # either go-e local address

KEBA Connect

- type: keba
  uri: 192.168.1.4:7090 # KEBA address
  rfid:
    tag: 765765348 # RFID tag, see `evcc charger` to show tag

Mobile Charger Connect

- type: mcc
  uri: https://192.168.1.4 # Mobile Charger Connect address
  password: # home user password

NRGKick Bluetooth

- type: nrgkick-bluetooth
  macaddress: 00:99:22 # MAC address
  pin: # pin

NRGKick Connect

- type: nrgkick-connect
  uri: http://192.168.1.4
  mac: 00:99:22 # MAC address
  password: # password

OpenWB (remote-controlled using MQTT)

- type: default
  status:
    # with openWB, charging status (A..F) this is split between "plugged" and "charging"
    # the openwb plugin combines both into status (charging=C, plugged=B, otherwise=A)
    type: openwb # use openwb plugin
    plugged:
      type: mqtt
      topic: openWB/lp/1/boolPlugStat
    charging:
      type: mqtt
      topic: openWB/lp/1/boolChargeStat
  enabled:
    type: mqtt
    topic: openWB/lp/1/ChargePointEnabled
    timeout: 30s
  enable:
    type: mqtt
    topic: openWB/set/lp1/ChargePointEnabled
    payload: ${enable:%d} # write payload definition
  maxcurrent:
    type: mqtt
    topic: openWB/set/lp1/DirectChargeAmps
    payload: ${maxCurrent:%d} # write payload definition

Phoenix EM-CP Controller (Ethernet/Modbus TCP)

- type: phoenix-emcp
  uri: 192.168.0.8:502 # TCP ModBus address
  id: 1

Phoenix EV-CC Controller (Modbus)

- type: phoenix-evcc
  device: /dev/ttyUSB0
  baudrate: 9600
  comset: 8N1
  id: 1 # slave id

Simple EVSE (Ethernet/Modbus TCP)

- type: simpleevse
  uri: 192.168.0.8:502 # TCP ModBus address

Simple EVSE (USB)

- type: simpleevse
  device: /dev/usb1 # RS485 ModBus device

Wallbe (Eco, Pro)

- type: wallbe
  uri: 192.168.0.8:502 # TCP ModBus address

Wallbe (pre 2019 EV-CC-AC1 controller)

- type: wallbe
  uri: 192.168.0.8:502 # TCP ModBus address
  legacy: true # enable for older Wallbes with Phoenix EV-CC-AC1-M3-CBC-RCM controller

Vehicles

Audi (eTron etc)

- type: audi
  title: eTron # display name for UI
  capacity: 14 # kWh
  user: # user
  password: # password
  vin: WAUZZZ... # optional
  cache: 5m # cache API response

BMW (i3)

- type: bmw
  title: i3 # display name for UI
  capacity: 65 # kWh
  user: # user
  password: # password
  vin: WBMW... # optional
  cache: 5m # cache API response

Ford (Kuga, Mustang, etc)

- type: ford
  title: Kuga # display name for UI
  capacity: 10 # kWh
  user: # user
  password: # password
  vin: WF0FXX... # optional
  cache: 5m # cache API response

Generisch

- type: default
  title: Mein Auto # display name for UI
  capacity: 50 # kWh
  charge:
    type: ...
    # ...
  cache: 5m # cache duration

Generisch (Script)

- type: default
  title: Auto # display name for UI
  capacity: 50 # kWh
  charge:
    type: script # use script plugin
    cmd: /bin/sh -c "echo 50" # actual command
    timeout: 3s # kill script after 3 seconds
  cache: 5m # cache duration

Hyundai (Kona, Ioniq)

- type: hyundai
  title: Kona # display name for UI
  capacity: 64 # kWh
  user: # user
  password: # password
  cache: 5m # cache API response

Kia (e-Niro, e-Soul, etc)

- type: kia
  title: e-Niro # display name for UI
  capacity: 64 # kWh
  user: # user
  password: # password
  cache: 5m # cache API response

Nissan (Leaf)

- type: nissan
  title: Leaf # display name for UI
  capacity: 60 # kWh
  user: # user
  password: # password
  region: NE # carwings region, leave empty for Europe
  cache: 5m # cache API response

Porsche

- type: porsche
  title: Taycan # display name for UI
  capacity: 83 # kWh
  user: # user
  password: # password
  vin: WP...
  cache: 5m # cache API response

Renault (Zoe)

- type: renault
  title: Zoe # display name for UI
  capacity: 60 # kWh
  user: # user
  password: # password
  vin: WREN... # optional
  cache: 5m # cache API response

Tesla

- type: tesla
  title: Model S # display name for UI
  capacity: 90 # kWh
  user: # email
  password: # password
  vin: WTSLA...
  cache: 5m # cache API response

VW (eUp, ID.3, ID.4, etc)

- type: vw
  title: ID.3 # display name for UI
  capacity: 10 # kWh
  user: # user
  password: # password
  vin: WVWZZZ... # optional
  cache: 5m # cache API response