config

command module

v0.0.0-...-07427f6 Latest Latest Go to latest Published: Feb 12, 2022 License: MIT Imports: 12 Imported by: 0

Details

Valid go.mod file

The Go module system was introduced in Go 1.11 and is the official dependency management solution for Go.
Redistributable license

Redistributable licenses place minimal restrictions on how software can be used, modified, and redistributed.
Tagged version

Modules with tagged versions give importers more predictable builds.
Stable version

When a project reaches major version v1 it is considered stable.
Learn more about best practices

Repository

github.com/evcc-io/config

README ¶

Configuration examples for EVCC

Configuration examples for the EVCC EV Charge Controller.

EVCC supports a growing list of chargers, meters and vehicles. See below for detailed configuration. Additional devices can be configured using custom devices and related plugins.

Contributing

If you want to contribute configurations to this repository please open a Pull Request ("PR"). PRs should contain:

updated or new yaml configuration (see https://github.com/evcc-io/config/tree/master/yaml)
run make to generate compilable Go code (configurations are used for testing) and update the README

Details

Meters

cFos PowerBrain Meter

- type: cfos
  uri: 192.0.2.2:4702 # 4702 is meter 1, 4703 is meter 2
  id: 2 # 2 is meter 1, 3 is meter 2
  # an evcc sponsortoken is required for using this charger

Discovergy Metering Service (Cloud) (Grid)

- type: discovergy
  user: demo@discovergy.com 
  password: demo # password 
  meter: 1ESY1161229886

Discovergy Metering Service (Cloud) (PV)

- type: discovergy
  user: demo@discovergy.com 
  password: demo # password 
  meter: 1ESY1161229886
  scale: -1

E3DC (Battery Meter)

- type: custom
  power:
    source: modbus
    uri: e3dc.fritz.box:502
    id: 1 # ModBus slave id
    register: # manual register configuration for E3/DC "Simple-Mode"
      address: 40069 # Batterie-Leistung in Watt
      type: holding
      decode: int32s
    scale: -1 # reverse direction
  soc:
    source: modbus
    uri: e3dc.fritz.box:502
    id: 1 # ModBus slave id
    register: # manual register configuration for E3/DC "Simple-Mode"
      address: 40082 # Batterie-SOC in Prozent
      type: holding
      decode: uint16

E3DC (Grid Meter)

- type: custom
  power:
    source: modbus
    uri: e3dc.fritz.box:502
    id: 1 # ModBus slave id
    register: # manual register configuration for E3/DC "Simple-Mode"
      address: 40073 # Hausverbrauchs-Leistung in Watt
      type: holding
      decode: int32s

E3DC (PV Meter)

- type: custom
  power:
    source: modbus
    uri: e3dc.fritz.box:502
    id: 1 # ModBus slave id
    register: # manual register configuration for E3/DC "Simple-Mode"
      address: 40067 # Photovoltaikleistung in Watt
      type: holding
      decode: int32s

Eastron SDM Modbus Meter

- type: modbus
  model: sdm # specific non-sunspec meter
  id: 1
  energy: Sum # only required for charge meter usage
  # chose either locally attached:
  device: /dev/ttyUSB0 # serial port
  baudrate: 9600
  comset: 8N1
  # or via TCP:
  uri: 192.0.2.2:502
  rtu: true # serial modbus rtu (rs485) device connected using simple ethernet adapter

FritzDECT

- type: fritzdect
  uri: https://fritz.box # FRITZ!Box ip address (local)
  user: xxxxxxxxxx # FRITZ!Box username (Has to have Smart Home privileges!)
  password: yyyyyyyyyy # FRITZ!Box password
  ain: '007788992233' # switch actor identification number without blanks (see AIN number on switch sticker)
  standbypower: 15 # treat as charging above this power

Fronius Solar API V1 (Battery Meter)

- type: custom
  power:
    source: http
    uri: http://192.0.2.2/solar_api/v1/GetPowerFlowRealtimeData.fcgi
    jq: if .Body.Data.Site.P_Akku == null then 0 else .Body.Data.Site.P_Akku end
  soc:
    source: http
    uri: http://192.0.2.2/solar_api/v1/GetPowerFlowRealtimeData.fcgi
    jq: .Body.Data.Inverters."1".SOC

Fronius Solar API V1 (Grid Meter)

- type: custom
  power:
    source: http
    uri: http://192.0.2.2/solar_api/v1/GetPowerFlowRealtimeData.fcgi
    jq: if .Body.Data.Site.P_Grid == null then 0 else .Body.Data.Site.P_Grid end

Fronius Solar API V1 (PV Meter)

- type: custom
  power:
    source: http
    uri: http://192.0.2.2/solar_api/v1/GetPowerFlowRealtimeData.fcgi
    jq: if .Body.Data.Site.P_PV == null then 0 else .Body.Data.Site.P_PV end

Fronius Symo GEN24 Plus (Battery Meter)

- type: custom
  power:
    source: calc
    add:
    - source: modbus
      model: sunspec
      uri: 192.0.2.2:502
      id: 1
      value: 160:3:DCW # mppt 3 charge
      scale: -1
    - source: modbus
      model: sunspec
      uri: 192.0.2.2:502
      id: 1
      value: 160:4:DCW # mppt 4 discharge
  soc:
    source: modbus
    model: sunspec
    uri: 192.0.2.2:502
    id: 1
    value: ChargeState

Fronius Symo GEN24 Plus (Grid Meter)

- type: modbus
  model: sunspec
  uri: 192.0.2.2:502
  id: 200
  power: 213:W # sunspec model 203 meter

Fronius Symo GEN24 Plus (PV Meter)

- type: custom
  power:
    source: calc
    add:
    - source: modbus
      model: sunspec
      uri: 192.0.2.2:502
      id: 1
      value: 160:1:DCW # mpp 1 pv
    - source: modbus
      model: sunspec
      uri: 192.0.2.2:502
      id: 1
      value: 160:2:DCW # mpp 2 pv

Generic

- type: custom
  power: # power (W)
    source: # plugin type
    # ...
  energy: # optional energy (kWh)
    source: # plugin type
    # ...
  soc: # optional battery soc (%)
    source: # plugin type
    # ...
  currents: # optional currents (A)
    - source: # L1 plugin type
      # ...
    - source: # L2 plugin type
      # ...
    - source: # L3 plugin type
      # ...

Huawei SUN2000 with Sdongle (PV Meter)

- type: custom
  power:
    source: modbus
    uri: 192.0.2.2:502
    model: huawei
    timeout: 30s
    connectdelay: 5s
    delay: 2s
    register:
      address: 32080 # Active generation power
      type: holding
      decode: int32

Huawei SUN2000 with Sdongle and power sensor (Battery Meter)

- type: custom
  power:
    source: modbus
    uri: 192.0.2.2:502
    model: huawei
    timeout: 30s
    connectdelay: 5
    delay: 2s
    register:
      address: 37001
      type: holding
      decode: int32
  soc:
    source: modbus
    uri: 192.0.2.2:502
    model: huawei
    timeout: 30s
    connectdelay: 5
    delay: 2s
    register:
      address: 37004
      type: holding
      decode: uint16
    scale: 0.1

Huawei SUN2000 with Sdongle and power sensor (Grid Meter)

- type: custom
  power:
    source: modbus
    uri: 192.0.2.2:502
    model: huawei
    timeout: 30s
    connectdelay: 5
    delay: 2s
    register:
      address: 37113 # Grid import export power
      type: holding
      decode: int32
    scale: -1
  energy:
    source: modbus
    uri: 192.0.2.2:502
    model: huawei
    timeout: 30s
    connectdelay: 5
    delay: 2s
    register:
      address: 37121 # Grid active energy
      type: holding
      decode: int32
    scale: 0.01
  currents:
  - source: modbus
    uri: 192.0.2.2:502
    model: huawei
    register:
      address: 37107 # Huawei phase A grid current
      type: holding
      decode: int32
    scale: -0.01
  - source: modbus
    uri: 192.0.2.2:502
    model: huawei
    register:
      address: 37109 # Huawei phase B grid current
      type: holding
      decode: int32
    scale: -0.01
  - source: modbus
    uri: 192.0.2.2:502
    model: huawei
    register:
      address: 37111 # Huawei phase C grid current
      type: holding
      decode: int32
    scale: -0.01

Huawei SUN2000-8KTL (PV Meter)

- type: custom
  power:
    source: modbus
    id: 1
    # chose either locally attached:
    device: /dev/ttyUSB0 # serial port
    baudrate: 19200
    comset: 8N1
    # or via TCP:
    uri: 192.0.2.2:502
    rtu: true # serial modbus rtu (rs485) device connected using simple ethernet adapter
    # register details
    register:
      address: 40525
      type: holding
      decode: int32

Kostal Energy Meter via inverter (Grid Meter)

- type: custom
  power:
    source: modbus # use ModBus plugin
    uri: 192.0.2.2:1502 # inverter port
    id: 71
    register: # manual non-sunspec register configuration
      address: 252 # (see ba_kostal_interface_modbus-tcp_sunspec.pdf)
      type: holding
      decode: float32s # may be float32 on specific firmware/devices

Kostal Hybrid Inverter (Battery Meter)

- type: modbus
  model: sunspec
  uri: 192.0.2.2:1502
  id: 71 # kostal default sunspec modbus id
  power: 802:W # sunspec model 802 battery
  soc: 802:SoC # sunspec model 802 battery

Kostal Inverter (PV Meter)

- type: modbus
  model: sunspec
  uri: 192.0.2.2:1502
  id: 71 # kostal default sunspec modbus id

Kostal Piko + Piko BA (Grid Meter)

- type: custom
  power:
    source: calc
    add:
    - source: http
      uri: http://192.0.2.2/api/dxs.json?dxsEntries=67109120 # PV AC Ausgang
      jq: .dxsEntries[0].value
      scale: -1.0
    - source: http
      uri: http://192.0.2.2/api/dxs.json?dxsEntries=83886848 # Netzbezug
      jq: .dxsEntries[0].value
    - source: http
      uri: http://192.0.2.2/api/dxs.json?dxsEntries=83886336 # PV Eigenverbrauch
      jq: .dxsEntries[0].value

Kostal Piko + Piko BA (PV Meter)

- type: custom
  power:
    source: http
    uri: http://192.0.2.2/api/dxs.json?dxsEntries=67109120 # PV AC Ausgang
    jq: .dxsEntries[0].value

Kostal Smart Energy Meter (Grid Meter)

- type: modbus
  model: sunspec
  uri: 192.0.2.2:502
  id: 71 # kostal default sunspec modbus id

LG ESS HOME 8/10 (Battery Meter)

- type: lgess
  usage: battery
  # uri and password are only required once if multiple lgess usages are defined
  uri: https://192.0.2.2/ # URI of the LG ESS HOME inverter
  password: "DE200..." # registration number of the LG ESS HOME inverter

LG ESS HOME 8/10 (Grid Meter)

- type: lgess
  usage: grid
  # uri and password are only required once if multiple lgess usages are defined
  uri: https://192.0.2.2/
  password: "DE200..." # registration number of the LG ESS HOME inverter

LG ESS HOME 8/10 (PV Meter)

- type: lgess
  usage: pv
  # uri and password are only required once if multiple lgess usages are defined
  uri: https://192.0.2.2/
  password: "DE200..." # registration number of the LG ESS HOME inverter

Multiple DC MPP strings combined (PV Meter)

- type: custom
  power:
    source: calc
    add:
    - source: modbus
      model: sunspec
      value: 160:1:DCW # SunSpec Model 160 MPP string 1 DCW
      uri: 192.0.2.2:502
      id: 1
    - source: modbus
      model: sunspec
      value: 160:2:DCW # SunSpec Model 160 MPP string 2 DCW
      uri: 192.0.2.2:502
      id: 1

Multiple PV inverters combined (PV Meter)

- type: custom
  power:
    source: calc
    add:
    - source: modbus
      model: sunspec
      uri: 192.0.2.2:502
      id: 1
    - source: modbus
      model: sunspec
      uri: 192.0.2.3:502
      id: 1

Multiple SMA Speedwire PV inverters combined (PV Meter)

- type: custom
  power:
    source: calc
    add:
    - source: sma
      uri: 192.0.2.2
      password: # optional
      value: ActivePowerPlus
    - source: sma
      uri: 192.0.2.3
      password: # optional
      value: ActivePowerPlus

PowerDog (Grid Meter)

- type: custom
  power:
    source: calc #calculate current overall consumption + (current pv effort * (-1) )
    add:
      - source: modbus
        uri: 192.168.1.2:502 #ip-adress and port (default-port: 502)
        id: 1
        register:
          address: 40026 #register for overall consumption
          type: holding
          decode: int32
  
      - source: modbus
        uri: 192.168.1.2:502 #ip-adress and port (default-port: 502)
        id: 1
        register:
          address: 40002 #register for pv effort
          type: holding
          decode: int32
        scale: -1 #scale with -1 to get a substraction

PowerDog (PV Meter)

- type: custom
  power:
    type: modbus
    uri: 192.168.1.2:502 #ip-adress and port (default-port: 502)
    id: 1
    register:
      address: 40002 #register for pv effort
      type: holding
      decode: int32

Powerfox Poweropti (Cloud)

- type: custom
  power:
    source: http
    uri: https://backend.powerfox.energy/api/2.0/my/main/current
    auth:
      type: basic
      user: xxxxxxxxx
      password: *****
    jq: .Watt

RCT Power (Battery Meter)

- type: rct
  uri: 192.0.2.2
  usage: battery
  cache: 2s

RCT Power (Grid Meter)

- type: rct
  uri: 192.0.2.2
  usage: grid
  cache: 2s

RCT Power (PV Meter)

- type: rct
  uri: 192.0.2.2
  usage: pv
  cache: 2s

SENEC.Home (Battery)

- type: custom
  power:
    source: script
    cmd: >
      /bin/bash -c "set +H; curl --data '{\"ENERGY\":{\"GUI_BAT_DATA_POWER\":\"\"}}' --header \"Content-Type: application/json\" --request POST http://192.0.2.2/lala.cgi | jq .ENERGY.GUI_BAT_DATA_POWER | python3 -c 'import struct;print(struct.unpack(\"!f\",bytes.fromhex(input()[4:12]))[0])'"
    timeout: 5s
    scale: -1
  soc:
    source: script
    cmd: >
      /bin/bash -c "set +H; curl --data '{\"ENERGY\":{\"GUI_BAT_DATA_FUEL_CHARGE\":\"\"}}' --header \"Content-Type: application/json\" --request POST http://192.0.2.2/lala.cgi | jq .ENERGY.GUI_BAT_DATA_FUEL_CHARGE | python3 -c 'import struct;print(struct.unpack(\"!f\",bytes.fromhex(input()[4:12]))[0])'"
    timeout: 5s

SENEC.Home (Grid)

- type: custom
  power:
    source: script
    cmd: >
      /bin/bash -c "set +H; curl --data '{\"ENERGY\":{\"GUI_GRID_POW\":\"\"}}' --header \"Content-Type: application/json\" --request POST http://192.0.2.2/lala.cgi | jq .ENERGY.GUI_GRID_POW | python3 -c 'import struct;print(struct.unpack(\"!f\",bytes.fromhex(input()[4:12]))[0])'"
    timeout: 5s
    scale: -1

SENEC.Home (PV)

- type: custom
  power:
    source: script
    cmd: >
      /bin/bash -c "set +H; curl --data '{\"ENERGY\":{\"GUI_INVERTER_POWER\":\"\"}}' --header \"Content-Type: application/json\" --request POST http://192.0.2.2/lala.cgi | jq .ENERGY.GUI_INVERTER_POWER | python3 -c 'import struct;print(struct.unpack(\"!f\",bytes.fromhex(input()[4:12]))[0])'"
    timeout: 5s

Shelly 3EM (HTTP)

- type: custom
  power:
    source: http
    uri: http://192.0.2.2/status
    jq: .emeters | map(.power) | add
  energy:
    source: http
    uri: http://192.0.2.2/status
    jq: .emeters | map(.total) | add
    scale: 0.001
  currents:
  - source: http
    uri: http://192.0.2.2/emeter/0
    jq: .current
  - source: http
    uri: http://192.0.2.2/emeter/1
    jq: .current
  - source: http
    uri: http://192.0.2.2/emeter/2
    jq: .current

SMA Speedwire Inverter (PV or Battery Meter)

- type: sma
  uri: 192.0.2.2
  password: # optional

SMA Sunny Home Manager 2.0 / Energy Meter (Grid, PV or Battery Meter)

- type: sma
  uri: 192.0.2.2

SolarEdge Energy Meter via inverter (Grid Meter)

- type: custom
  power:
    source: modbus
    model: sunspec
    uri: 192.0.2.2:502 # Port 502 (SetApp) or 1502 (LCD)
    id: 1
    subdevice: 1 # Metering device
    value: 203:W
    scale: -1

SolarEdge Hybrid Inverter (PV Meter)

- type: custom
  power:
    source: calc
    add:
    - source: modbus
      model: sunspec
      uri: 192.0.2.2:502 # Port 502 (SetApp) or 1502 (LCD)
      id: 1
      value: 103:DCW
    - source: modbus
      uri: 192.0.2.2:502 # Port 502 (SetApp) or 1502 (LCD)
      id: 1
      register:
        address: 62836 # Battery 1 Instantaneous Power
        type: holding
        decode: float32s

SolarEdge StorEdge (Battery Meter)

- type: custom
  power:
    source: modbus
    uri: 192.0.2.2:502 # Port 502 (SetApp) or 1502 (LCD)
    id: 1
    register:
      address: 62836 # Battery 1 Instantaneous Power
      type: holding
      decode: float32s
    scale: -1
  soc:
    source: modbus
    uri: 192.0.2.2:502 # Port 502 (SetApp) or 1502 (LCD)
    id: 1
    register:
      address: 62852 # Battery 1 State of Energy (SOE)
      type: holding
      decode: float32s

Solarlog (Grid Meter)

- type: custom
  power:
    source: calc
    add:
    - source: modbus
      uri: 192.0.2.2:502
      id: 1
      register:
        address: 3502 # Pac
        type: input
        decode: uint32s
      scale: -1
    - source: modbus
      uri: 192.0.2.2:502
      id: 1
      register:
        address: 3518 # Pac consumption
        type: input
        decode: uint32s

Solarlog (PV Meter)

- type: custom
  power:
    source: modbus
    uri: 192.0.2.2:502
    id: 1
    register:
      address: 3502 # Pac
      type: input
      decode: uint32s

Solarwatt MyReserve (Battery Meter)

- type: custom
  power:
    source: http
    uri: http://192.0.2.2/rest/kiwigrid/wizard/devices # EnergyManager
    jq: .result.items[] | select(.deviceModel[].deviceClass == "com.kiwigrid.devices.location.Location" ) | .tagValues.PowerConsumedFromStorage.value - .tagValues.PowerBuffered.value
  soc:
    source: http
    uri: http://192.0.2.2/rest/kiwigrid/wizard/devices # EnergyManager
    jq: .result.items[] | select(.deviceModel[].deviceClass == "com.kiwigrid.devices.solarwatt.MyReserve") | .tagValues.StateOfCharge.value

Solarwatt MyReserve (Grid Meter)

- type: custom
  power:
    source: http
    uri: http://192.0.2.2/rest/kiwigrid/wizard/devices # EnergyManager
    jq: .result.items[] | select(.deviceModel[].deviceClass == "com.kiwigrid.devices.location.Location" ) | .tagValues.PowerConsumedFromGrid.value - .tagValues.PowerOut.value

Solarwatt MyReserve (PV Meter)

- type: custom
  power:
    source: http
    uri: http://192.0.2.2/rest/kiwigrid/wizard/devices # EnergyManager
    jq: .result.items[] | select(.deviceModel[].deviceClass == "com.kiwigrid.devices.location.Location" ) | .tagValues.PowerProduced.value

Sonnenbatterie Eco/10 (Battery Meter)

- type: custom
  power:
    source: http
    uri: http://192.0.2.2:8080/api/v1/status
    jq: .Pac_total_W
  soc:
    source: http
    uri: http://192.0.2.2:8080/api/v1/status
    jq: .USOC

Sonnenbatterie Eco/10 (Grid Meter)

- type: custom
  power:
    source: http
    uri: http://192.0.2.2:8080/api/v1/status
    jq: .GridFeedIn_W
    scale: -1 # reverse direction

Sonnenbatterie Eco/10 (PV Meter)

- type: custom
  power:
    source: http
    uri: http://192.0.2.2:8080/api/v1/status
    jq: .Production_W

SunSpec compliant 3-phase meter via inverter (Grid Meter)

- type: modbus
  model: sunspec
  uri: 192.0.2.2:502
  id: 1
  power: 203:W # sunspec model 203 meter

SunSpec compliant battery inverter (Battery Meter)

- type: modbus
  model: sunspec
  uri: 192.0.2.2:502
  id: 1
  soc: ChargeState

SunSpec compliant PV inverter (PV Meter)

- type: modbus
  model: sunspec
  uri: 192.0.2.2:502
  id: 1

Tasmota (HTTP)

- type: custom
  power: # power reading (W)
    source: http
    uri: http://192.0.2.2/cm?cmnd=Status%208
    jq: .StatusSNS.ENERGY.Power
  energy: # energy reading (Wh), for chargemeter usage only
    source: http
    uri: http://192.0.2.2/cm?cmnd=Status%208
    jq: .StatusSNS.ENERGY.Total * 1000

Tesla Powerwall (Battery Meter)

- type: tesla
  uri: https://192.0.2.2/
  usage: battery
  password: *** # for user 'customer'

Tesla Powerwall (Grid Meter)

- type: tesla
  uri: https://192.0.2.2/
  usage: grid
  password: *** # for user 'customer'

Tesla Powerwall (PV Meter)

- type: tesla
  uri: https://192.0.2.2/
  usage: pv
  password: *** # for user 'customer'

VARTA Energiespeicher (Battery Meter)

- type: custom
  power:
    source: modbus
    uri: 192.0.2.2:502
    id: 1
    register:
      address: 1066 # active power
      type: input
      decode: int16
    scale: -1
  soc:
    source: modbus
    uri: 192.0.2.2:502
    id: 1
    register:
      address: 1068 # SOC
      type: input
      decode: int16

VARTA Energiespeicher (Grid Meter)

- type: custom
  power:
    source: modbus
    uri: 192.0.2.2:502
    id: 255
    register:
      address: 1078 # grid power
      type: input
      decode: int16
    scale: -1

VARTA Energiespeicher (PV Meter)

- type: custom
  power:
    source: modbus
    uri: 192.0.2.2:502
    id: 255
    register:
      address: 1102 # PV-sensor power
      type: input
      decode: uint16

Victron Energy (Battery Meter)

- type: custom
  power:
    source: modbus
    uri: 192.0.2.2:502
    id: 100 # com.victronenergy.system
    register:
      address: 842 # active DC power
      type: input
      decode: int16
    scale: -1
  soc:
    source: modbus
    uri: 192.0.2.2:502
    id: 100 # com.victronenergy.system
    register:
      address: 843 # SoC
      type: input
      decode: uint16

Victron Energy (Grid Meter)

- type: custom
  power:
    source: calc
    add:
    - source: modbus
      uri: 192.0.2.2:502
      id: 100 # com.victronenergy.system
      register:
        address: 820 # L1 grid power
        type: input
        decode: int16
    - source: modbus
      uri: 192.0.2.2:502
      id: 100 # com.victronenergy.system
      register:
        address: 821 # L2 grid power
        type: input
        decode: int16
    - source: modbus
      uri: 192.0.2.2:502
      id: 100 # com.victronenergy.system
      register:
        address: 822 # L3 grid power
        type: input
        decode: int16

Victron Energy (PV Meter)

- type: custom
  power:
    source: calc
    add:
    - source: modbus
      uri: 192.0.2.2:502
      id: 100 # com.victronenergy.system
      register:
        address: 808 # ACout pv power L1
        type: input
        decode: uint16
    - source: modbus
      uri: 192.0.2.2:502
      id: 100 # com.victronenergy.system
      register:
        address: 809 # ACout pv power L2
        type: input
        decode: uint16
    - source: modbus
      uri: 192.0.2.2:502
      id: 100 # com.victronenergy.system
      register:
        address: 810 # ACout pv power L3
        type: input
        decode: uint16
    - source: modbus
      uri: 192.0.2.2:502
      id: 100 # com.victronenergy.system
      register:
        address: 811 # ACin pv power L1
        type: input
        decode: uint16
    - source: modbus
      uri: 192.0.2.2:502
      id: 100 # com.victronenergy.system
      register:
        address: 812 # ACin pv power L2
        type: input
        decode: uint16
    - source: modbus
      uri: 192.0.2.2:502
      id: 100 # com.victronenergy.system
      register:
        address: 813 # ACin pv power L3
        type: input
        decode: uint16
    - source: modbus
      uri: 192.0.2.2:502
      id: 100 # com.victronenergy.system
      register:
        address: 850 # DC pv power
        type: input
        decode: uint16

vzlogger (HTTP)

- type: custom
  power: # power reading
    source: 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)

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

vzlogger (split import/export channels)

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

wbec

- type: custom
  power:
    source: mqtt
    topic: wbec/lp/1/power
  energy:
    source: mqtt
    topic: wbec/lp/1/energy
  currents:
    - source: mqtt
      topic: wbec/lp/1/currL1
    - source: mqtt
      topic: wbec/lp/1/currL2
    - source: mqtt
      topic: wbec/lp/1/currL3

Chargers

ABL eMH

- type: abl
  # chargers based on the ABL EVCC2/3 controller
  # chose either locally attached on serial port:
  device: /dev/ttyUSB0
  baudrate: 38400
  comset: 8E1
  # or via external TCP-RS485 translator:
  # uri: 192.0.2.2:502
  id: 1 
  # an evcc sponsortoken is required for using this charger

Alfen Eve

- type: alfen
  uri: 192.0.2.2:502 # TCP ModBus address
  id: 1
  # an evcc sponsortoken is required for using this charger

Alphatec Wallbox Mini

- type: alphatec
  # chose either locally attached on serial port:
  device: /dev/ttyUSB0
  baudrate: 9600
  comset: 8N1
  # or via external TCP-RS485 translator:
  # uri: 192.0.2.2:502
  id: 1 
  # an evcc sponsortoken is required for using this charger

cFos PowerBrain

- type: cfos
  uri: 192.0.2.2
  # an evcc sponsortoken is required for using this charger

Daheimladen (Cloud API)

- type: daheimladen
  token: # Request your access token from Daheimladen support: info@daheimladen.de
  stationID: xxxxxxxxxxxx990 # "Software Serial Number displayed on the display of the wallbox"

Easee Home (Cloud API)

- type: easee
  user: foo@example.org
  password: *****
  charger: EH______
  cache: 10s
  # an evcc sponsortoken is required for using this charger

EEBUS compatible wallbox (e.g. Mobile Charger Connect)

- type: eebus
  ski: 1234-5678-90ab-cdef-1234-5678-90ab-cdef-1234-5678 # Enter the SKI of the wallbox which can usually be found in the wallbox web interface
  forcePVLimits: true # use Overload Protection to limit PV charging, if false PV surplus is sent as recommended charging levels to the EV, but this is currently unreliable

EVSE DIN

- type: simpleevse
  # http://evracing.cz/simple-evse-wallbox
  id: 1
  # either locally attached:
  device: /dev/ttyUSB0 # serial RS485 interface
  # or via TCP:
  uri: 192.0.2.2:502 # Modbus TCP converter address

EVSE-Wifi

- type: evsewifi
  uri: http://192.0.2.2

FritzDECT

- type: fritzdect
  uri: https://fritz.box # FRITZ!Box ip address (local)
  user: xxxxxxxxxx # FRITZ!Box username (Has to have Smart Home privileges!)
  password: yyyyyyyyyy # FRITZ!Box password
  ain: '007788992233' # switch actor identification number without blanks (see AIN number on switch sticker)
  standbypower: 15 # treat as charging above this power

Generic

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

go-eCharger

- type: go-e
  uri: http://192.0.2.2 # go-e ip address (local)

go-eCharger (Cloud)

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

Heidelberg Energy Control (Modbus RTU)

- type: heidelberg
  device: /dev/ttyUSB0
  baudrate: 19200
  comset: 8E1
  id: 1 # configurable (S2/DIP 1)
  # an evcc sponsortoken is required for using this charger

i-CHARGE CION (Modbus RTU-over-TCP)

- type: custom
  status:
    source: modbus
    uri: 192.0.2.2:502
    rtu: true # Modbus over TCP
    id: 1
    register: # manual register configuration
        address: 139 # CP-Status
        type: holding
        decode: uint16
  enabled:
    source: modbus
    uri: 192.0.2.2:502
    rtu: true # Modbus over TCP
    id: 1 
    register: # manual register configuration
      address: 100 # Zustand
      type: holding
      decode: uint16
  enable:
    source: modbus
    uri: 192.0.2.2:502
    rtu: true # Modbus over TCP
    id: 1
    register: # manual register configuration
      address: 100 # ein / aus
      type: writesingle
      decode: uint16
  maxcurrent:
    source: modbus
    uri: 192.0.2.2:502
    rtu: true # Modbus over TCP
    id: 1
    register: # manual register configuration
      address: 127 # Strom max
      type: writesingle
      decode: uint16

Innogy eBox

- type: innogy
  uri: 192.0.2.2:502
  id: 1 
  # an evcc sponsortoken is required for using this charger

KEBA Connect

- type: keba
  uri: 192.0.2.2
  rfid:
    tag: 765765348 # RFID tag, see `evcc charger` to show tag

Mennekes Amtron XTRA/PREMIUM

- type: amtron
  uri: 192.0.2.2:502 # TCP ModBus address
  id: 1 
  # an evcc sponsortoken is required for using this charger

Mobile Charger Connect (Audi, Bentley, Porsche)

- type: mcc
  uri: https://192.0.2.2
  password: # home user password

NRGKick BT (Bluetooth)

- type: nrgkick-bluetooth
  mac: 00:1E:C0:XX:XX:XX # BT device MAC address (sudo hcitool lescan)
  pin: 1234 # App PIN number (write protection, ignore leading zeros)

NRGKick Connect

- type: nrgkick-connect
  uri: http://192.0.2.2
  mac: 00:1E:C0:XX:XX:XX # BT device MAC address (sudo hcitool lescan)
  password: # password

openWB (MQTT)

- type: openwb
  broker: 192.0.2.2 # openWB IP
  id: 1 # loadpoint id

PC Electric Garo

- type: garo
  uri: http://192.0.2.2:8080/servlet
  meter: <CENTRAL100|CENTRAL101|INTERNAL|EXTERNAL|TWIN> # Value can be found at http://192.0.2.2:8080/servlet/rest/chargebox/status 
  # Only devices configured as master can be used right now!
  # an evcc sponsortoken is required for using this charger

Phoenix EM-CP-PP-ETH Controller (Modbus TCP)

- type: phoenix-em-eth
  uri: 192.168.0.8:502
  meter: # only if a charge meter is connected to the controller
    power: true
    energy: true
    currents: true

Phoenix EV-ETH Controller (Modbus TCP)

- type: phoenix-ev-eth
  uri: 192.168.0.8:502
  meter: # only if a charge meter is connected to the controller
    power: true
    energy: true
    currents: true

Phoenix EV-SER Controller (Modbus RTU)

- type: phoenix-ev-ser
  device: /dev/ttyUSB0
  baudrate: 9600 # configurable (S2/DIP 1)
  comset: 8N1
  id: 1 # configurable (S2/DIP 2–6)

SENEC.Wallbox pro

- type: abl
  # chargers based on the ABL EVCC2/3 controller
  # chose either locally attached on serial port:
  device: /dev/ttyUSB0
  baudrate: 38400
  comset: 8E1
  # or via external TCP-RS485 translator:
  # uri: 192.0.2.2:502
  id: 1 
  # an evcc sponsortoken is required for using this charger

SENEC.Wallbox pro s

- type: heidelberg
  device: /dev/ttyUSB0
  baudrate: 19200
  comset: 8E1
  id: 1 # configurable (S2/DIP 1)
  # an evcc sponsortoken is required for using this charger

Shelly

- type: shelly
  uri: http://192.0.2.2  # shelly device ip address (local)
  channel: 0  # shelly device relay channel 
  standbypower: 15  # treat as charging above this power

Tasmota

- type: tasmota
  uri: http://192.168.xxx.xxx # tasmota device ip address (local)
  # user: xxxx # user, (optional) in case user + password are defined
  # password: xxxxx #  (optional) in case user + password are defined
  standbypower: 15 # treat as charging above this power

TinkerForge WARP Charger

- type: warp
  broker: 192.0.2.2:1883
  topic: warp
  useMeter: true # WARP Charger Pro
  timeout: 30s

TP-LINK Smart Plug

- type: tplink
  uri: 192.0.2.2 # TP-LINK Smart Plug ip address (local)
  standbypower: 15 # treat as charging above this power

Vestel EVC04

- type: vestel
  uri: 192.0.2.2:502 # TCP ModBus address
  id: 255
  # an evcc sponsortoken is required for using this charger

Wallbe (Eco, Pro)

- type: wallbe
  uri: 192.168.0.8:502 # TCP ModBus address
  meter: # only if a charge meter is connected to the controller
    power: true
    energy: true
    currents: true

Walther Werke Basic Evo Pro (Modbus RTU)

- type: heidelberg
  device: /dev/ttyUSB0
  baudrate: 19200
  comset: 8E1
  id: 1 # configurable (S2/DIP 1)
  # an evcc sponsortoken is required for using this charger

wbec

- type: custom
  status:
    source: mqtt
    topic: wbec/lp/1/status
  enabled:
    source: mqtt
    topic: wbec/lp/1/enabled
  enable:
    source: mqtt
    topic: wbec/lp/1/enable
  maxcurrent:
    source: mqtt
    topic: wbec/lp/1/maxcurrent

Vehicles

Audi

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

BMW

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

Citroen

- type: citroen
  title: e-C4 # display name for UI
  capacity: 50 # kWh
  user: user@example.com
  password: xxx
  vin: # optional

evNotify (HTTP)

- type: custom
  title: My Car # display name for UI
  capacity: 64 # kWh
  charge:
    type: http
    uri: https://app.evnotify.de/soc?akey=AKEY&token=1234567890abcdef # evNotify Server + AKEY
    method: GET
    jq: .soc_display
  cache: 5m # cache duration

Fiat

- type: fiat
  title: Neuer 500 # display name for UI
  capacity: 42 # kWh
  user: # user
  password: # password
  vin: ZFAE... # optional
  pin: xxxx #mandatory to deep refresh SoC

Ford

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

Generic

- type: custom
  title: Mein Auto # display name for UI
  capacity: 50 # byttery capacity (kWh)
  soc: # battery soc (%)
    source: # plugin type
    # ...
  status: # optional charge status (A..F)
    source: # plugin type
    # ...
  range: # optional electric range (km)
    source: # plugin type
    # ...

Hyundai

- type: hyundai
  title: Kona # display name for UI
  capacity: 64 # kWh
  user: # user
  password: # password

Kia

- type: kia
  title: e-Niro # display name for UI
  capacity: 64 # kWh
  user: # user
  password: # password

Mini

- type: mini
  title: Cooper SE # display name for UI
  capacity: 32 # kWh
  user: # user
  password: # password
  vin: WBMW... # optional

Nissan

- type: nissan
  title: Leaf # display name for UI
  capacity: 60 # kWh
  user: # user
  password: # password

NIU E-Scooter

- type: niu
  title: NIU E-Scooter # display name for UI
  capacity: 4 # kWh
  user: xxxxxxx # NIU app user
  password: xxxxxx # NIU app password
  serial: NXXXXXXXXXXXXXXX # NIU E-Scooter serial number like shown in app

Opel

- type: opel
  title: Corsa-e # display name for UI
  capacity: 50 # kWh
  user: user@example.com
  password: xxx
  vin: # optional

OVMS

- type: ovms
  title: Open Vehicle Monitoring System # display name for UI
  capacity: 12 # kWh
  user: # user server
  password: # password server
  vehicleid: # vehicle id
  server: dexters-web.de # used ovms server [dexters-web.de or api.openvehicles.com]

Peugeot

- type: peugeot
  title: e-208 # display name for UI
  capacity: 50 # kWh
  user: user@example.com
  password: xxx
  vin: # optional

Porsche

- type: porsche
  title: Taycan # display name for UI
  capacity: 83 # kWh
  user: # user
  password: # password
  vin: WP...

Renault

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

Smart EQ

- type: smart
  title: Smart EQ # display name for UI
  capacity: 17.6 # kWh
  user: # user
  password: # password
  vin: W...

Tesla

- type: tesla
  title: Model S # display name for UI
  capacity: 90 # kWh
  tokens:
    access: ...
    refresh: ...
  vin: # optional

Tronity Cloud Service

- type: tronity
  title: Golf # display name for UI
  capacity: 10 # kWh
  credentials:
    id: # user id
    secret: # secret
  vin: W... # VIN optional
  cache: 5m # optional

Volvo

- type: volvo
  title: Volvo # display name for UI
  capacity: 50 # kWh
  user: # user
  password: # password
  vin: W... # optional

VW (e-Up, e-Golf, etc)

- type: vw
  title: Golf # display name for UI
  capacity: 10 # kWh
  user: # user
  password: # password
  vin: WVWZZZ... # optional

VW ID (ID.3, ID.4, but also e-Golf, e-Up)

- type: id
  title: ID.3 # display name for UI
  capacity: 50 # kWh
  user: # user
  password: # password
  vin: WVWZZZ... # optional

Documentation ¶

There is no documentation for this package.

Source Files ¶

View all Source files

main.go

Directories ¶

Path	Synopsis
registry
templates

?	: This menu
/	: Search site
f or F	: Jump to
y or Y	: Canonical URL