Skip to main content

Chargers

To control charging, evcc needs to be able to communicate with at least one Charger.

The configuration is formatted as follows:

chargers:
- name: wallbox
type: ...

All of the Chargers listed on this page are supported by evcc. Once you have adapted the code samples to suit your Charger(s) in evcc.yaml, you can test the connection using the evcc charger command, which returns the current status of all connected Chargers. If you just want to test one Charger at a time, use evcc charger --name my_charger.

$ ./evcc charger

Power: 0W
Current L1..L3: 0A 0A 0A
Charge status: A
Enabled: false

Features

  • 1P/3P: Support for automatic phase switching. Wider power range (usually 1.4 to 11 kW).
  • RFID: Integration of an RFID card reader for vehicle identification.
  • mA regulation: Finer charging current regulation (mA instead of A) for better use of PV surplus.
  • ISO 15118: Support for Plug & Charge (vehicle identification, SoC transmission)

Filter by feature


ABB

Terra AC

Requires firmware >= 1.6.5

chargers:
- name: my_charger
type: template
template: abb

# RS485 via adapter (Modbus RTU)
modbus: rs485serial
id: 1
device: /dev/ttyUSB0 # USB-RS485 Adapter Adresse
baudrate: 9600 # Prüfe die Geräteeinstellungen, typische Werte sind 9600, 19200, 38400, 57600, 115200
comset: "8N1" # Kommunikationsparameter für den Adapter

# RS485 via TCP/IP (Modbus RTU)
modbus: rs485tcpip
id: 1
host: 192.0.2.2 # Hostname
port: 502 # Port

# Modbus TCP
modbus: tcpip
id: 1
host: 192.0.2.2 # Hostname
port: 502 # Port
Sponsor Token Required

More information on 💚 evcc Sponsorship can be found here.

TerraAC

chargers:
- name: my_charger
type: template
template: ocpp-abb
stationid: EVB-P12354 # Station ID of the charging point. Only required if multiple OCPP charging stations are set up to assign them correctly. A single OCPP charging station can also be automatically assigned. Note: In exceptional cases, it may be necessary to manually append this ID to the OCPP URL of the charging station in the form ws://<evcc-address>:8887/<stationid>. Most charging stations automatically add the ID internally. (optional)
Sponsor Token Required

More information on 💚 evcc Sponsorship can be found here.

ABL

eM4 (SBCx)

chargers:
- name: my_charger
type: template
template: abl-em4

# Modbus TCP
modbus: tcpip
id: 255
host: 192.0.2.2 # Hostname
port: 502 # Port
Sponsor Token Required

More information on 💚 evcc Sponsorship can be found here.

eMH1, eMH2

chargers:
- name: my_charger
type: template
template: abl

# RS485 via adapter (Modbus RTU)
modbus: rs485serial
id: 1
device: /dev/ttyUSB0 # USB-RS485 Adapter Adresse
baudrate: 38400 # Prüfe die Geräteeinstellungen, typische Werte sind 9600, 19200, 38400, 57600, 115200
comset: "8E1" # Kommunikationsparameter für den Adapter

# RS485 via TCP/IP (Modbus RTU)
modbus: rs485tcpip
id: 1
host: 192.0.2.2 # Hostname
port: 502 # Port
timeout: 10s # optional
Sponsor Token Required

More information on 💚 evcc Sponsorship can be found here.

Alfen Eve

The "Active load balancing" license is required for external Modbus control of the charger. Enable "Active Load Balancing" and select "Energy Management System" as Data Source in the configuration. It is recommended to set "ValidityTime" ("TCP/IP EMS" menu) to 300s. When using "Double" charger both loadpoints need to be added. The the first port (or single) is accessable on ID 1, second port on ID 2.

chargers:
- name: my_charger
type: template
template: alfen

# Modbus TCP
modbus: tcpip
id: 1
host: 192.0.2.2 # Hostname
port: 502 # Port
Sponsor Token Required

More information on 💚 evcc Sponsorship can be found here.

Alphatec

Ladesäule Twin

The motherboard requires current firmware. You can recognize a current software version by the fact that the serial number on the brown relay starts with 2022 or there is a 15 on the small white relays. Otherwise, please contact the manufacturer directly.

chargers:
- name: my_charger
type: template
template: alphatec

# RS485 via adapter (Modbus RTU)
modbus: rs485serial
id: 1
device: /dev/ttyUSB0 # USB-RS485 Adapter Adresse
baudrate: 9600 # Prüfe die Geräteeinstellungen, typische Werte sind 9600, 19200, 38400, 57600, 115200
comset: "8N1" # Kommunikationsparameter für den Adapter

# RS485 via TCP/IP (Modbus RTU)
modbus: rs485tcpip
id: 1
host: 192.0.2.2 # Hostname
port: 502 # Port
Sponsor Token Required

More information on 💚 evcc Sponsorship can be found here.

Wallbox Mini, Power

The motherboard requires current firmware. You can recognize a current software version by the fact that the serial number on the brown relay starts with 2022 or there is a 15 on the small white relays. Otherwise, please contact the manufacturer directly.

chargers:
- name: my_charger
type: template
template: alphatec

# RS485 via adapter (Modbus RTU)
modbus: rs485serial
id: 1
device: /dev/ttyUSB0 # USB-RS485 Adapter Adresse
baudrate: 9600 # Prüfe die Geräteeinstellungen, typische Werte sind 9600, 19200, 38400, 57600, 115200
comset: "8N1" # Kommunikationsparameter für den Adapter

# RS485 via TCP/IP (Modbus RTU)
modbus: rs485tcpip
id: 1
host: 192.0.2.2 # Hostname
port: 502 # Port
Sponsor Token Required

More information on 💚 evcc Sponsorship can be found here.

Amperfied

Wallbox connect.business

chargers:
- name: my_charger
type: template
template: amperfied

# Modbus TCP
modbus: tcpip
id: 255
host: 192.0.2.2 # Hostname
port: 502 # Port
Sponsor Token Required

More information on 💚 evcc Sponsorship can be found here.

Wallbox connect.home

chargers:
- name: my_charger
type: template
template: amperfied

# Modbus TCP
modbus: tcpip
id: 255
host: 192.0.2.2 # Hostname
port: 502 # Port
Sponsor Token Required

More information on 💚 evcc Sponsorship can be found here.

Wallbox connect.solar

chargers:
- name: my_charger
type: template
template: amperfied-solar

# Modbus TCP
modbus: tcpip
id: 255
host: 192.0.2.2 # Hostname
port: 502 # Port
Sponsor Token Required

More information on 💚 evcc Sponsorship can be found here.

Wallbox Energy Control

Please read the wiring and configuration manual carefully. All boxes must be configured for external control in follower mode (DIP S5/4 OFF). Each box needs an individual Modbus ID (DIP S4). Ensure correct RS485 cabling including bus termination (DIP S6/2).

chargers:
- name: my_charger
type: template
template: heidelberg

# RS485 via adapter (Modbus RTU)
modbus: rs485serial
id: 1
device: /dev/ttyUSB0 # USB-RS485 Adapter Adresse
baudrate: 19200 # Prüfe die Geräteeinstellungen, typische Werte sind 9600, 19200, 38400, 57600, 115200
comset: "8E1" # Kommunikationsparameter für den Adapter

# RS485 via TCP/IP (Modbus RTU)
modbus: rs485tcpip
id: 1
host: 192.0.2.2 # Hostname
port: 502 # Port
Sponsor Token Required

More information on 💚 evcc Sponsorship can be found here.

Audi

Audi Wallbox pro

The device has to have a fix IP address (manuall or via DHCP).

The identification of a vehicle using the RFID card is not possible.

Important: A mostly flawless functionality can only be provided with an external energy meter and no usage of CT coils, due to sosftware bugs of the Wallbox. Using a LAN connection is highly recommended.

chargers:
- name: my_charger
type: template
template: ellipro
ski: # SKI (Subject Key Identifier)
ip: 192.0.2.2 # IP address (optional)

Wallbox plus

The device has to have a fix IP address (manuall or via DHCP).

The identification of a vehicle using the RFID card is not possible.

Important: A mostly flawless functionality can only be provided with an external energy meter and no usage of CT coils, due to sosftware bugs of the Wallbox. Using a LAN connection is highly recommended.

Note: If you've added an energy meter to your charger please use the Pro or Connected+ integration.

chargers:
- name: my_charger
type: template
template: elliconnect
ski: # SKI (Subject Key Identifier)
ip: 192.0.2.2 # IP address (optional)

Bender

CC612

The 'Modbus TCP Server' must be enabled. The setting 'Register Address Set' must NOT be set to 'Phoenix' or 'TQ-DM100'. Use the third selection labeled 'Ebee', 'Bender', 'MENNEKES' etc. Set 'Allow UID Disclose' to On.

chargers:
- name: my_charger
type: template
template: bender
host: 192.0.2.2 # IP address or hostname
port: 502 # Port (optional)
Sponsor Token Required

More information on 💚 evcc Sponsorship can be found here.

CC613

The 'Modbus TCP Server' must be enabled. The setting 'Register Address Set' must NOT be set to 'Phoenix' or 'TQ-DM100'. Use the third selection labeled 'Ebee', 'Bender', 'MENNEKES' etc. Set 'Allow UID Disclose' to On.

chargers:
- name: my_charger
type: template
template: bender
host: 192.0.2.2 # IP address or hostname
port: 502 # Port (optional)
Sponsor Token Required

More information on 💚 evcc Sponsorship can be found here.

BMW i Wallbox

Requires firmware version 3.10.42 (C-series) bzw. 1.11 (X-series). For phase switching the Keba phase switch (KeContact S10) is also required and the switching control via Modbus must be set in the wallbox settings. For the X-series in the web menu, for the C-series via Modbus by setting the value "3" in register 5050.

chargers:
- name: my_charger
type: template
template: keba-modbus

# Modbus TCP
modbus: tcpip
id: 255
host: 192.0.2.2 # Hostname
port: 502 # Port
Sponsor Token Required

More information on 💚 evcc Sponsorship can be found here.

cFos Power Brain, Power Brain Solar

S0 meters must be configured separately as charge meter. Phase switching is only available with the Solar variant and must be enabled by the user.

chargers:
- name: my_charger
type: template
template: cfos
host: 192.0.2.2 # IP address or hostname
Sponsor Token Required

More information on 💚 evcc Sponsorship can be found here.

Compleo eBox

chargers:
- name: my_charger
type: template
template: innogy-ebox

# Modbus TCP
modbus: tcpip
id: 1
host: 192.0.2.2 # Hostname
port: 502 # Port
Sponsor Token Required

More information on 💚 evcc Sponsorship can be found here.

CUBOS C11E, C22E

The 'Modbus TCP Server' must be enabled. The setting 'Register Address Set' must NOT be set to 'Phoenix' or 'TQ-DM100'. Use the third selection labeled 'Ebee', 'Bender', 'MENNEKES' etc. Set 'Allow UID Disclose' to On.

chargers:
- name: my_charger
type: template
template: bender
host: 192.0.2.2 # IP address or hostname
port: 502 # Port (optional)
Sponsor Token Required

More information on 💚 evcc Sponsorship can be found here.

Cupra

Charger Connect

The device has to have a fix IP address (manuall or via DHCP).

The identification of a vehicle using the RFID card is not possible.

Important: A mostly flawless functionality can only be provided with an external energy meter and no usage of CT coils, due to sosftware bugs of the Wallbox. Using a LAN connection is highly recommended.

Note: If you've added an energy meter to your charger please use the Pro or Connected+ integration.

chargers:
- name: my_charger
type: template
template: elliconnect
ski: # SKI (Subject Key Identifier)
ip: 192.0.2.2 # IP address (optional)

Charger Connect 2

The device has to be used in the normal charging mode.

The usage of phase switching is currently not possible in evcc.

The identification of a vehicle using the RFID card is not possible.

chargers:
- name: my_charger
type: template
template: elli-2
ski: # SKI (Subject Key Identifier)
ip: 192.0.2.2 # IP address (optional)

Charger Pro

The device has to have a fix IP address (manuall or via DHCP).

The identification of a vehicle using the RFID card is not possible.

Important: A mostly flawless functionality can only be provided with an external energy meter and no usage of CT coils, due to sosftware bugs of the Wallbox. Using a LAN connection is highly recommended.

chargers:
- name: my_charger
type: template
template: ellipro
ski: # SKI (Subject Key Identifier)
ip: 192.0.2.2 # IP address (optional)

Charger Pro 2

The device has to be used in the normal charging mode.

The usage of phase switching is currently not possible in evcc.

The identification of a vehicle using the RFID card is not possible.

chargers:
- name: my_charger
type: template
template: elli-2
ski: # SKI (Subject Key Identifier)
ip: 192.0.2.2 # IP address (optional)

Charger Pro Eichrecht 2

The device has to be used in the normal charging mode.

The usage of phase switching is currently not possible in evcc.

The identification of a vehicle using the RFID card is not possible.

chargers:
- name: my_charger
type: template
template: elli-2
ski: # SKI (Subject Key Identifier)
ip: 192.0.2.2 # IP address (optional)

Dadapower Premium Wallbox

chargers:
- name: my_charger
type: template
template: dadapower

# Modbus TCP
modbus: tcpip
id: 1
host: 192.0.2.2 # Hostname
port: 502 # Port

DaheimLaden Wallbox (via ModbusTCP)

Wallbox must be operated with a recent firmware including Modbus support. Furthermore, “Nachladen” (Smart) or “RSDA” (Touch) must be activated in settings.

chargers:
- name: my_charger
type: template
template: daheimladen-mb
host: 192.0.2.2 # IP address or hostname
port: 502 # Port (optional)

Delta

AC Max Basic

chargers:
- name: my_charger
type: template
template: delta

# RS485 via adapter (Modbus RTU)
modbus: rs485serial
id: 1
device: /dev/ttyUSB0 # USB-RS485 Adapter Adresse
baudrate: 115200 # Prüfe die Geräteeinstellungen, typische Werte sind 9600, 19200, 38400, 57600, 115200
comset: "8N1" # Kommunikationsparameter für den Adapter

# RS485 via TCP/IP (Modbus RTU)
modbus: rs485tcpip
id: 1
host: 192.0.2.2 # Hostname
port: 502 # Port

# Modbus TCP
modbus: tcpip
id: 1
host: 192.0.2.2 # Hostname
port: 502 # Port
Sponsor Token Required

More information on 💚 evcc Sponsorship can be found here.

AC MAX Smart

chargers:
- name: my_charger
type: template
template: delta

# RS485 via adapter (Modbus RTU)
modbus: rs485serial
id: 1
device: /dev/ttyUSB0 # USB-RS485 Adapter Adresse
baudrate: 115200 # Prüfe die Geräteeinstellungen, typische Werte sind 9600, 19200, 38400, 57600, 115200
comset: "8N1" # Kommunikationsparameter für den Adapter

# RS485 via TCP/IP (Modbus RTU)
modbus: rs485tcpip
id: 1
host: 192.0.2.2 # Hostname
port: 502 # Port

# Modbus TCP
modbus: tcpip
id: 1
host: 192.0.2.2 # Hostname
port: 502 # Port
Sponsor Token Required

More information on 💚 evcc Sponsorship can be found here.

SLIM Charger

chargers:
- name: my_charger
type: template
template: delta

# RS485 via adapter (Modbus RTU)
modbus: rs485serial
id: 1
device: /dev/ttyUSB0 # USB-RS485 Adapter Adresse
baudrate: 115200 # Prüfe die Geräteeinstellungen, typische Werte sind 9600, 19200, 38400, 57600, 115200
comset: "8N1" # Kommunikationsparameter für den Adapter

# RS485 via TCP/IP (Modbus RTU)
modbus: rs485tcpip
id: 1
host: 192.0.2.2 # Hostname
port: 502 # Port

# Modbus TCP
modbus: tcpip
id: 1
host: 192.0.2.2 # Hostname
port: 502 # Port
Sponsor Token Required

More information on 💚 evcc Sponsorship can be found here.

Ultra Fast Charger

chargers:
- name: my_charger
type: template
template: delta

# RS485 via adapter (Modbus RTU)
modbus: rs485serial
id: 1
device: /dev/ttyUSB0 # USB-RS485 Adapter Adresse
baudrate: 115200 # Prüfe die Geräteeinstellungen, typische Werte sind 9600, 19200, 38400, 57600, 115200
comset: "8N1" # Kommunikationsparameter für den Adapter

# RS485 via TCP/IP (Modbus RTU)
modbus: rs485tcpip
id: 1
host: 192.0.2.2 # Hostname
port: 502 # Port

# Modbus TCP
modbus: tcpip
id: 1
host: 192.0.2.2 # Hostname
port: 502 # Port
Sponsor Token Required

More information on 💚 evcc Sponsorship can be found here.

E.ON Drive

eBox

chargers:
- name: my_charger
type: template
template: innogy-ebox

# Modbus TCP
modbus: tcpip
id: 1
host: 192.0.2.2 # Hostname
port: 502 # Port
Sponsor Token Required

More information on 💚 evcc Sponsorship can be found here.

vBox

chargers:
- name: my_charger
type: template
template: vestel

# Modbus TCP
modbus: tcpip
id: 255
host: 192.0.2.2 # Hostname
port: 502 # Port
Sponsor Token Required

More information on 💚 evcc Sponsorship can be found here.

E3/DC Easy Connect

DIP switch 10 at the controller needs to be set to 'ON'. A recent controller firmware is recommended.

chargers:
- name: my_charger
type: template
template: phoenix-ev-eth

# Modbus TCP
modbus: tcpip
id: 255
host: 192.0.2.2 # Hostname
port: 502 # Port
Sponsor Token Required

More information on 💚 evcc Sponsorship can be found here.

Easee

Charge

chargers:
- name: my_charger
type: template
template: easee
user: # Email address
password: # same as Easee app or the web portal (https://easee.cloud)
charger: EH______
timeout: 20s # optional
authorize: # Controls wether evcc shall perform authentication against charger. Benefit is a contolled start of charging. Not compatible with RFID identification of vehicles. (optional)
Sponsor Token Required

More information on 💚 evcc Sponsorship can be found here.

Charge Core

chargers:
- name: my_charger
type: template
template: easee
user: # Email address
password: # same as Easee app or the web portal (https://easee.cloud)
charger: EH______
timeout: 20s # optional
authorize: # Controls wether evcc shall perform authentication against charger. Benefit is a contolled start of charging. Not compatible with RFID identification of vehicles. (optional)
Sponsor Token Required

More information on 💚 evcc Sponsorship can be found here.

Charge Lite

chargers:
- name: my_charger
type: template
template: easee
user: # Email address
password: # same as Easee app or the web portal (https://easee.cloud)
charger: EH______
timeout: 20s # optional
authorize: # Controls wether evcc shall perform authentication against charger. Benefit is a contolled start of charging. Not compatible with RFID identification of vehicles. (optional)
Sponsor Token Required

More information on 💚 evcc Sponsorship can be found here.

Home

chargers:
- name: my_charger
type: template
template: easee
user: # Email address
password: # same as Easee app or the web portal (https://easee.cloud)
charger: EH______
timeout: 20s # optional
authorize: # Controls wether evcc shall perform authentication against charger. Benefit is a contolled start of charging. Not compatible with RFID identification of vehicles. (optional)
Sponsor Token Required

More information on 💚 evcc Sponsorship can be found here.

Ebee Wallbox

The 'Modbus TCP Server' must be enabled. The setting 'Register Address Set' must NOT be set to 'Phoenix' or 'TQ-DM100'. Use the third selection labeled 'Ebee', 'Bender', 'MENNEKES' etc. Set 'Allow UID Disclose' to On.

chargers:
- name: my_charger
type: template
template: bender
host: 192.0.2.2 # IP address or hostname
port: 502 # Port (optional)
Sponsor Token Required

More information on 💚 evcc Sponsorship can be found here.

echarge

cPH1

Charge mode must be configured as manual

chargers:
- name: my_charger
type: template
template: hardybarth-ecb1
host: 192.0.2.2 # IP address or hostname
Sponsor Token Required

More information on 💚 evcc Sponsorship can be found here.

cPH2, cPμ2

chargers:
- name: my_charger
type: template
template: hardybarth-salia
host: 192.0.2.2 # IP address or hostname
Sponsor Token Required

More information on 💚 evcc Sponsorship can be found here.

EcoHarmony EVSE EPC 2.0 Plus

chargers:
- name: my_charger
type: template
template: obo

# RS485 via adapter (Modbus RTU)
modbus: rs485serial
id: 101
device: /dev/ttyUSB0 # USB-RS485 Adapter Adresse
baudrate: 19200 # Prüfe die Geräteeinstellungen, typische Werte sind 9600, 19200, 38400, 57600, 115200
comset: "8E1" # Kommunikationsparameter für den Adapter

# RS485 via TCP/IP (Modbus RTU)
modbus: rs485tcpip
id: 101
host: 192.0.2.2 # Hostname
port: 502 # Port

# Modbus TCP
modbus: tcpip
id: 101
host: 192.0.2.2 # Hostname
port: 502 # Port

Edgetech Smart EVSE

chargers:
- name: my_charger
type: template
template: smartevse

# RS485 via adapter (Modbus RTU)
modbus: rs485serial
id: 1
device: /dev/ttyUSB0 # USB-RS485 Adapter Adresse
baudrate: 9600 # Prüfe die Geräteeinstellungen, typische Werte sind 9600, 19200, 38400, 57600, 115200
comset: "8N1" # Kommunikationsparameter für den Adapter

# RS485 via TCP/IP (Modbus RTU)
modbus: rs485tcpip
id: 1
host: 192.0.2.2 # Hostname
port: 502 # Port

Elli

Charger Connect

The device has to have a fix IP address (manuall or via DHCP).

The identification of a vehicle using the RFID card is not possible.

Important: A mostly flawless functionality can only be provided with an external energy meter and no usage of CT coils, due to sosftware bugs of the Wallbox. Using a LAN connection is highly recommended.

Note: If you've added an energy meter to your charger please use the Pro or Connected+ integration.

chargers:
- name: my_charger
type: template
template: elliconnect
ski: # SKI (Subject Key Identifier)
ip: 192.0.2.2 # IP address (optional)

Charger Connect 2

The device has to be used in the normal charging mode.

The usage of phase switching is currently not possible in evcc.

The identification of a vehicle using the RFID card is not possible.

chargers:
- name: my_charger
type: template
template: elli-2
ski: # SKI (Subject Key Identifier)
ip: 192.0.2.2 # IP address (optional)

Charger Pro

The device has to have a fix IP address (manuall or via DHCP).

The identification of a vehicle using the RFID card is not possible.

Important: A mostly flawless functionality can only be provided with an external energy meter and no usage of CT coils, due to sosftware bugs of the Wallbox. Using a LAN connection is highly recommended.

chargers:
- name: my_charger
type: template
template: ellipro
ski: # SKI (Subject Key Identifier)
ip: 192.0.2.2 # IP address (optional)

Charger Pro 2

The device has to be used in the normal charging mode.

The usage of phase switching is currently not possible in evcc.

The identification of a vehicle using the RFID card is not possible.

chargers:
- name: my_charger
type: template
template: elli-2
ski: # SKI (Subject Key Identifier)
ip: 192.0.2.2 # IP address (optional)

Charger Pro Eichrecht 2

The device has to be used in the normal charging mode.

The usage of phase switching is currently not possible in evcc.

The identification of a vehicle using the RFID card is not possible.

chargers:
- name: my_charger
type: template
template: elli-2
ski: # SKI (Subject Key Identifier)
ip: 192.0.2.2 # IP address (optional)

EM2GO

Home

Requires FW Version >= E3C_V1.1. mA regulation requires FW version >= E3C_V1.3.

chargers:
- name: my_charger
type: template
template: em2go-home
host: 192.0.2.2 # IP address or hostname

Pro Power, OCPP/ONC

Recent firmware with Modbus support required (Pro Power: 1.01 and OCPP/ONC: 3.15)

chargers:
- name: my_charger
type: template
template: em2go

# Modbus TCP
modbus: tcpip
id: 255
host: 192.0.2.2 # Hostname
port: 502 # Port

Ensto Chago Wallbox

The 'Modbus TCP Server' must be enabled. The setting 'Register Address Set' must NOT be set to 'Phoenix' or 'TQ-DM100'. Use the third selection labeled 'Ebee', 'Bender', 'MENNEKES' etc. Set 'Allow UID Disclose' to On.

chargers:
- name: my_charger
type: template
template: bender
host: 192.0.2.2 # IP address or hostname
port: 502 # Port (optional)
Sponsor Token Required

More information on 💚 evcc Sponsorship can be found here.

ESL Walli LIGHT

DIP switch 10 at the controller needs to be set to 'ON'. A recent controller firmware is recommended.

chargers:
- name: my_charger
type: template
template: phoenix-ev-eth

# Modbus TCP
modbus: tcpip
id: 255
host: 192.0.2.2 # Hostname
port: 502 # Port
Sponsor Token Required

More information on 💚 evcc Sponsorship can be found here.

eSystems ghostONE

The device has to be used in the normal charging mode.

The usage of phase switching is currently not possible in evcc.

The identification of a vehicle using the RFID card is not possible.

chargers:
- name: my_charger
type: template
template: ghost
ski: # SKI (Subject Key Identifier)
ip: 192.0.2.2 # IP address (optional)

Etrel

INCH

The charger must be switched to "Power" charging mode.

chargers:
- name: my_charger
type: template
template: etrel
host: 192.0.2.2 # IP address or hostname
port: 502 # Port (optional)
Sponsor Token Required

More information on 💚 evcc Sponsorship can be found here.

INCH Duo

The charger must be switched to "Power" charging mode.

chargers:
- name: my_charger
type: template
template: etrel-duo
host: 192.0.2.2 # IP address or hostname
port: 502 # Port (optional)
Sponsor Token Required

More information on 💚 evcc Sponsorship can be found here.

EVBox

Elvi

chargers:
- name: my_charger
type: template
template: elvi
stationid: EVB-P12354 # Station ID of the charging point. Only required if multiple OCPP charging stations are set up to assign them correctly. A single OCPP charging station can also be automatically assigned. Note: In exceptional cases, it may be necessary to manually append this ID to the OCPP URL of the charging station in the form ws://<evcc-address>:8887/<stationid>. Most charging stations automatically add the ID internally. (optional)
meter: true # optional
Sponsor Token Required

More information on 💚 evcc Sponsorship can be found here.

Livo

The device requires a fixed IP addres.

chargers:
- name: my_charger
type: template
template: livo
ski: # SKI (Subject Key Identifier)
ip: 192.0.2.2 # IP address (optional)

EVSE DIN

chargers:
- name: my_charger
type: template
template: evse-din

# RS485 via adapter (Modbus RTU)
modbus: rs485serial
id: 1
device: /dev/ttyUSB0 # USB-RS485 Adapter Adresse
baudrate: 9600 # Prüfe die Geräteeinstellungen, typische Werte sind 9600, 19200, 38400, 57600, 115200
comset: "8N1" # Kommunikationsparameter für den Adapter

# RS485 via TCP/IP (Modbus RTU)
modbus: rs485tcpip
id: 1
host: 192.0.2.2 # Hostname
port: 502 # Port

EVSE-WiFi

chargers:
- name: my_charger
type: template
template: evsewifi
host: 192.0.2.2 # IP address or hostname

Fronius Wattpilot (OCPP)

chargers:
- name: my_charger
type: template
template: ocpp-fronius-wattpilot
stationid: EVB-P12354 # Station ID of the charging point. Only required if multiple OCPP charging stations are set up to assign them correctly. A single OCPP charging station can also be automatically assigned. Note: In exceptional cases, it may be necessary to manually append this ID to the OCPP URL of the charging station in the form ws://<evcc-address>:8887/<stationid>. Most charging stations automatically add the ID internally. (optional)
Sponsor Token Required

More information on 💚 evcc Sponsorship can be found here.

Garo GLB, GLB+, LS4, LS4 compact

The 'Modbus TCP Server' must be enabled. The setting 'Register Address Set' must NOT be set to 'Phoenix' or 'TQ-DM100'. Use the third selection labeled 'Ebee', 'Bender', 'MENNEKES' etc. Set 'Allow UID Disclose' to On.

chargers:
- name: my_charger
type: template
template: bender
host: 192.0.2.2 # IP address or hostname
port: 502 # Port (optional)
Sponsor Token Required

More information on 💚 evcc Sponsorship can be found here.

go-e

Charger Gemini, HOME+, HOMEfix (V3)

Requires firmware 052.1 or later.

For 1P/3P-Phase switching the HTTP API v2 in the charger setup needs to be activated.

The “simulate unplugging” option should be activated in the Go-E app ("Car" menu item).

chargers:
- name: my_charger
type: template
template: go-e-v3
host: 192.0.2.2 # IP address or hostname
Sponsor Token Required

More information on 💚 evcc Sponsorship can be found here.

Charger HOME+, HOMEfix, Pro

Requires firmware 040.0 or later. HTTP API v1 or v2 must be activated.

chargers:
- name: my_charger
type: template
template: go-e
host: 192.0.2.2 # IP address or hostname
Sponsor Token Required

More information on 💚 evcc Sponsorship can be found here.

HardyBarth

cPH1

Charge mode must be configured as manual

chargers:
- name: my_charger
type: template
template: hardybarth-ecb1
host: 192.0.2.2 # IP address or hostname
Sponsor Token Required

More information on 💚 evcc Sponsorship can be found here.

cPH2, cPμ2

chargers:
- name: my_charger
type: template
template: hardybarth-salia
host: 192.0.2.2 # IP address or hostname
Sponsor Token Required

More information on 💚 evcc Sponsorship can be found here.

Heidelberg Energy Control

Please read the wiring and configuration manual carefully. All boxes must be configured for external control in follower mode (DIP S5/4 OFF). Each box needs an individual Modbus ID (DIP S4). Ensure correct RS485 cabling including bus termination (DIP S6/2).

chargers:
- name: my_charger
type: template
template: heidelberg

# RS485 via adapter (Modbus RTU)
modbus: rs485serial
id: 1
device: /dev/ttyUSB0 # USB-RS485 Adapter Adresse
baudrate: 19200 # Prüfe die Geräteeinstellungen, typische Werte sind 9600, 19200, 38400, 57600, 115200
comset: "8E1" # Kommunikationsparameter für den Adapter

# RS485 via TCP/IP (Modbus RTU)
modbus: rs485tcpip
id: 1
host: 192.0.2.2 # Hostname
port: 502 # Port
Sponsor Token Required

More information on 💚 evcc Sponsorship can be found here.

Hesotec eSat, eBox

chargers:
- name: my_charger
type: template
template: hesotec

# Modbus TCP
modbus: tcpip
id: 1
host: 192.0.2.2 # Hostname
port: 502 # Port
Sponsor Token Required

More information on 💚 evcc Sponsorship can be found here.

Homecharge Homecharger HC11L, HC22L

The charger must be equipped with a built-in meter (models HC11L/HC22L Energy or Profi). For the OCPP configuration, you need to access the EFR-SECC charge controller at http://host/secc. For login credentials, ask your dealer or the vendor EFR (www.efr.de).

chargers:
- name: my_charger
type: template
template: homecharge
stationid: EVB-P12354 # Station ID of the charging point. Only required if multiple OCPP charging stations are set up to assign them correctly. A single OCPP charging station can also be automatically assigned. Note: In exceptional cases, it may be necessary to manually append this ID to the OCPP URL of the charging station in the form ws://<evcc-address>:8887/<stationid>. Most charging stations automatically add the ID internally. (optional)
Sponsor Token Required

More information on 💚 evcc Sponsorship can be found here.

Innogy eBox

chargers:
- name: my_charger
type: template
template: innogy-ebox

# Modbus TCP
modbus: tcpip
id: 1
host: 192.0.2.2 # Hostname
port: 502 # Port
Sponsor Token Required

More information on 💚 evcc Sponsorship can be found here.

INRO Pantabox

chargers:
- name: my_charger
type: template
template: pantabox
host: 192.0.2.2 # IP address or hostname

Juice Charger Me

The 'Modbus TCP Server' must be enabled. The setting 'Register Address Set' must NOT be set to 'Phoenix' or 'TQ-DM100'. Use the third selection labeled 'Ebee', 'Bender', 'MENNEKES' etc. Set 'Allow UID Disclose' to On.

chargers:
- name: my_charger
type: template
template: bender
host: 192.0.2.2 # IP address or hostname
port: 502 # Port (optional)
Sponsor Token Required

More information on 💚 evcc Sponsorship can be found here.

KEBA KeContact P20, P30, C/X Series

Requires firmware version 3.10.42 (C-series) bzw. 1.11 (X-series). For phase switching the Keba phase switch (KeContact S10) is also required and the switching control via Modbus must be set in the wallbox settings. For the X-series in the web menu, for the C-series via Modbus by setting the value "3" in register 5050.

chargers:
- name: my_charger
type: template
template: keba-modbus

# Modbus TCP
modbus: tcpip
id: 255
host: 192.0.2.2 # Hostname
port: 502 # Port
Sponsor Token Required

More information on 💚 evcc Sponsorship can be found here.

Kontron Solar Charger

The device has to be used in the normal charging mode.

The usage of phase switching is currently not possible in evcc.

The identification of a vehicle using the RFID card is not possible.

chargers:
- name: my_charger
type: template
template: ghost
ski: # SKI (Subject Key Identifier)
ip: 192.0.2.2 # IP address (optional)

Kostal Enector

The wallbox must be configured as satellite/slave using the DIP switches on the mainboard and Modbus RTU must be enabled (bank S1: 4=ON, 5=ON, 7=OFF). No external meter should be connected directly to the wallbox, as all functions are controlled directly by evcc. For Kostal systems with Smart Energy Meter (KSEM), the additional activation code (Solar Pure Mode / Solar Plus Mode) for the KSEM is not required.

chargers:
- name: my_charger
type: template
template: mennekes-compact

# RS485 via adapter (Modbus RTU)
modbus: rs485serial
id: 50
device: /dev/ttyUSB0 # USB-RS485 Adapter Adresse
baudrate: 57600 # Prüfe die Geräteeinstellungen, typische Werte sind 9600, 19200, 38400, 57600, 115200
comset: "8N2" # Kommunikationsparameter für den Adapter

# RS485 via TCP/IP (Modbus RTU)
modbus: rs485tcpip
id: 50
host: 192.0.2.2 # Hostname
port: 502 # Port
Sponsor Token Required

More information on 💚 evcc Sponsorship can be found here.

KSE wBX16

chargers:
- name: my_charger
type: template
template: kse

# RS485 via adapter (Modbus RTU)
modbus: rs485serial
id: 100
device: /dev/ttyUSB0 # USB-RS485 Adapter Adresse
baudrate: 9600 # Prüfe die Geräteeinstellungen, typische Werte sind 9600, 19200, 38400, 57600, 115200
comset: "8E1" # Kommunikationsparameter für den Adapter

# RS485 via TCP/IP (Modbus RTU)
modbus: rs485tcpip
id: 100
host: 192.0.2.2 # Hostname
port: 502 # Port
Sponsor Token Required

More information on 💚 evcc Sponsorship can be found here.

LadeFoxx EvLoad, Mikro 2.0

chargers:
- name: my_charger
type: template
template: phoenix-charx

# Modbus TCP
modbus: tcpip
id: 255
host: 192.0.2.2 # Hostname
port: 502 # Port

LRT HOME Essential+

The motherboard requires current firmware. You can recognize a current software version by the fact that the serial number on the brown relay starts with 2022 or there is a 15 on the small white relays. Otherwise, please contact the manufacturer directly.

chargers:
- name: my_charger
type: template
template: alphatec

# RS485 via adapter (Modbus RTU)
modbus: rs485serial
id: 1
device: /dev/ttyUSB0 # USB-RS485 Adapter Adresse
baudrate: 9600 # Prüfe die Geräteeinstellungen, typische Werte sind 9600, 19200, 38400, 57600, 115200
comset: "8N1" # Kommunikationsparameter für den Adapter

# RS485 via TCP/IP (Modbus RTU)
modbus: rs485tcpip
id: 1
host: 192.0.2.2 # Hostname
port: 502 # Port
Sponsor Token Required

More information on 💚 evcc Sponsorship can be found here.

Mennekes

AMEDIO Professional

The 'Modbus TCP Server' must be enabled. The setting 'Register Address Set' must NOT be set to 'Phoenix' or 'TQ-DM100'. Use the third selection labeled 'Ebee', 'Bender', 'MENNEKES' etc. Set 'Allow UID Disclose' to On.

chargers:
- name: my_charger
type: template
template: bender
host: 192.0.2.2 # IP address or hostname
port: 502 # Port (optional)
Sponsor Token Required

More information on 💚 evcc Sponsorship can be found here.

AMTRON ChargeControl

The 'Modbus TCP Server' must be enabled. The setting 'Register Address Set' must NOT be set to 'Phoenix' or 'TQ-DM100'. Use the third selection labeled 'Ebee', 'Bender', 'MENNEKES' etc. Set 'Allow UID Disclose' to On.

chargers:
- name: my_charger
type: template
template: bender
host: 192.0.2.2 # IP address or hostname
port: 502 # Port (optional)
Sponsor Token Required

More information on 💚 evcc Sponsorship can be found here.

Amtron Compact 2.0s

The wallbox must be configured as satellite/slave using the DIP switches on the mainboard and Modbus RTU must be enabled (bank S1: 4=ON, 5=ON, 7=OFF). No external meter should be connected directly to the wallbox, as all functions are controlled directly by evcc. For Kostal systems with Smart Energy Meter (KSEM), the additional activation code (Solar Pure Mode / Solar Plus Mode) for the KSEM is not required.

chargers:
- name: my_charger
type: template
template: mennekes-compact

# RS485 via adapter (Modbus RTU)
modbus: rs485serial
id: 50
device: /dev/ttyUSB0 # USB-RS485 Adapter Adresse
baudrate: 57600 # Prüfe die Geräteeinstellungen, typische Werte sind 9600, 19200, 38400, 57600, 115200
comset: "8N2" # Kommunikationsparameter für den Adapter

# RS485 via TCP/IP (Modbus RTU)
modbus: rs485tcpip
id: 50
host: 192.0.2.2 # Hostname
port: 502 # Port
Sponsor Token Required

More information on 💚 evcc Sponsorship can be found here.

AMTRON Premium

chargers:
- name: my_charger
type: template
template: mennekes-hcc3

# Modbus TCP
modbus: tcpip
id: 255
host: 192.0.2.2 # Hostname
port: 502 # Port
Sponsor Token Required

More information on 💚 evcc Sponsorship can be found here.

AMTRON Professional

The 'Modbus TCP Server' must be enabled. The setting 'Register Address Set' must NOT be set to 'Phoenix' or 'TQ-DM100'. Use the third selection labeled 'Ebee', 'Bender', 'MENNEKES' etc. Set 'Allow UID Disclose' to On.

chargers:
- name: my_charger
type: template
template: bender
host: 192.0.2.2 # IP address or hostname
port: 502 # Port (optional)
Sponsor Token Required

More information on 💚 evcc Sponsorship can be found here.

Amtron Start 2.0s

The wallbox must be configured as satellite/slave using the DIP switches on the mainboard and Modbus RTU must be enabled (bank S1: 4=ON, 5=ON, 7=OFF). No external meter should be connected directly to the wallbox, as all functions are controlled directly by evcc. For Kostal systems with Smart Energy Meter (KSEM), the additional activation code (Solar Pure Mode / Solar Plus Mode) for the KSEM is not required.

chargers:
- name: my_charger
type: template
template: mennekes-compact

# RS485 via adapter (Modbus RTU)
modbus: rs485serial
id: 50
device: /dev/ttyUSB0 # USB-RS485 Adapter Adresse
baudrate: 57600 # Prüfe die Geräteeinstellungen, typische Werte sind 9600, 19200, 38400, 57600, 115200
comset: "8N2" # Kommunikationsparameter für den Adapter

# RS485 via TCP/IP (Modbus RTU)
modbus: rs485tcpip
id: 50
host: 192.0.2.2 # Hostname
port: 502 # Port
Sponsor Token Required

More information on 💚 evcc Sponsorship can be found here.

AMTRON Xtra

chargers:
- name: my_charger
type: template
template: mennekes-hcc3

# Modbus TCP
modbus: tcpip
id: 255
host: 192.0.2.2 # Hostname
port: 502 # Port
Sponsor Token Required

More information on 💚 evcc Sponsorship can be found here.

my-PV AC ELWA 2

chargers:
- name: my_charger
type: template
template: ac-elwa-2

# Modbus TCP
modbus: tcpip
id: 1
host: 192.0.2.2 # Hostname
port: 502 # Port
Sponsor Token Required

More information on 💚 evcc Sponsorship can be found here.

NRGKick

Connect

NRGkick charging unit via HTTP (older than 2022/2023)

chargers:
- name: my_charger
type: template
template: nrgkick-connect
host: 192.0.2.2 # IP address or hostname
mac:
password: # Password of the user account (use single quotes in case of leading zeros)

Gen2

chargers:
- name: my_charger
type: template
template: nrggen2

# Modbus TCP
modbus: tcpip
id: 1
host: 192.0.2.2 # Hostname
port: 502 # Port
Sponsor Token Required

More information on 💚 evcc Sponsorship can be found here.

OBO Bettermann Ion

chargers:
- name: my_charger
type: template
template: obo

# RS485 via adapter (Modbus RTU)
modbus: rs485serial
id: 101
device: /dev/ttyUSB0 # USB-RS485 Adapter Adresse
baudrate: 19200 # Prüfe die Geräteeinstellungen, typische Werte sind 9600, 19200, 38400, 57600, 115200
comset: "8E1" # Kommunikationsparameter für den Adapter

# RS485 via TCP/IP (Modbus RTU)
modbus: rs485tcpip
id: 101
host: 192.0.2.2 # Hostname
port: 502 # Port

# Modbus TCP
modbus: tcpip
id: 101
host: 192.0.2.2 # Hostname
port: 502 # Port

OpenEVSE

Requires firmware 7.0 or later.

chargers:
- name: my_charger
type: template
template: openevse
host: 192.0.2.2 # IP address or hostname
user: # User account (e.g. email address, user id, etc.) (optional)
password: # Password of the user account (use single quotes in case of leading zeros) (optional)

openWB

Pro

chargers:
- name: my_charger
type: template
template: openwb-pro
host: 192.0.2.2 # IP address or hostname

series2

The wallbox has to be configured as loadpoint.

chargers:
- name: my_charger
type: template
template: openwb
host: 192.0.2.2 # IP address or hostname

Software 2.x

Requires Software 2.x. The following changes are necessary under the 'Einstellungen' tab:

  • Steuerungsmodus: secondary
  • Steuerung über Modbus als secondary: An
chargers:
- name: my_charger
type: template
template: openwb-2.0

# Modbus TCP
modbus: tcpip
id: 1
host: 192.0.2.2 # Hostname
port: 1502 # Port

Optec Mobility One

The 'Modbus TCP Server' must be enabled. The setting 'Register Address Set' must NOT be set to 'Phoenix' or 'TQ-DM100'. Use the third selection labeled 'Ebee', 'Bender', 'MENNEKES' etc. Set 'Allow UID Disclose' to On.

chargers:
- name: my_charger
type: template
template: bender
host: 192.0.2.2 # IP address or hostname
port: 502 # Port (optional)
Sponsor Token Required

More information on 💚 evcc Sponsorship can be found here.

Orbis Viaris

chargers:
- name: my_charger
type: template
template: orbis-viaris
stationid: EVB-P12354 # Station ID of the charging point. Only required if multiple OCPP charging stations are set up to assign them correctly. A single OCPP charging station can also be automatically assigned. Note: In exceptional cases, it may be necessary to manually append this ID to the OCPP URL of the charging station in the form ws://<evcc-address>:8887/<stationid>. Most charging stations automatically add the ID internally. (optional)
Sponsor Token Required

More information on 💚 evcc Sponsorship can be found here.

PC Electric Garo

Only devices configured as master can be used right now!

chargers:
- name: my_charger
type: template
template: pcelectric-garo
host: 192.0.2.2 # IP address or hostname
port: 8080 # Port (optional)
Sponsor Token Required

More information on 💚 evcc Sponsorship can be found here.

Peblar Home, Home Plus, Business

Peblar chargers with firmware version 1.6 and onwards support Modbus TCP via port 502. The Modbus server needs to be enabled via the charger web interface. Ensure that smart charging strategies are disabled and set to Default.

chargers:
- name: my_charger
type: template
template: peblar

# Modbus TCP
modbus: tcpip
id: 1
host: 192.0.2.2 # Hostname
port: 502 # Port
Sponsor Token Required

More information on 💚 evcc Sponsorship can be found here.

Phoenix Contact

CHARX

chargers:
- name: my_charger
type: template
template: phoenix-charx

# Modbus TCP
modbus: tcpip
id: 255
host: 192.0.2.2 # Hostname
port: 502 # Port

EM-CP-PP-ETH

chargers:
- name: my_charger
type: template
template: phoenix-em-eth

# Modbus TCP
modbus: tcpip
id: 180
host: 192.0.2.2 # Hostname
port: 502 # Port

EV-CC-AC1-M3-CBC-RCM-ETH, EV-CC-AC1-M3-CBC-RCM-ETH-3G, EV-CC-AC1-M3-RCM-ETH-XP, EV-CC-AC1-M3-RCM-ETH-3G-XP

DIP switch 10 at the controller needs to be set to 'ON'. A recent controller firmware is recommended.

chargers:
- name: my_charger
type: template
template: phoenix-ev-eth

# Modbus TCP
modbus: tcpip
id: 255
host: 192.0.2.2 # Hostname
port: 502 # Port
Sponsor Token Required

More information on 💚 evcc Sponsorship can be found here.

EV-SER (Modbus RTU)

chargers:
- name: my_charger
type: template
template: phoenix-ev-ser

# RS485 via adapter (Modbus RTU)
modbus: rs485serial
id: 1
device: /dev/ttyUSB0 # USB-RS485 Adapter Adresse
baudrate: 9600 # Prüfe die Geräteeinstellungen, typische Werte sind 9600, 19200, 38400, 57600, 115200
comset: "8N1" # Kommunikationsparameter für den Adapter

# RS485 via TCP/IP (Modbus RTU)
modbus: rs485tcpip
id: 1
host: 192.0.2.2 # Hostname
port: 502 # Port

Porsche

Mobile Charger Connect

chargers:
- name: my_charger
type: template
template: pmcc
ski: # SKI (Subject Key Identifier)
ip: 192.0.2.2 # IP address (optional)

Mobile Charger Plus

chargers:
- name: my_charger
type: template
template: pmcp
ski: # SKI (Subject Key Identifier)
ip: 192.0.2.2 # IP address (optional)

Wallbox

The device has to be used in the normal charging mode.

The usage of phase switching is currently not possible in evcc.

The identification of a vehicle using the RFID card is not possible.

chargers:
- name: my_charger
type: template
template: porsche-wallbox
ski: # SKI (Subject Key Identifier)
ip: 192.0.2.2 # IP address (optional)

Pracht Alpha XT, XT+, Mono XT, Mono XT+, PNI

chargers:
- name: my_charger
type: template
template: pracht-alpha

# RS485 via adapter (Modbus RTU)
modbus: rs485serial
id: 1
device: /dev/ttyUSB0 # USB-RS485 Adapter Adresse
baudrate: 9600 # Prüfe die Geräteeinstellungen, typische Werte sind 9600, 19200, 38400, 57600, 115200
comset: "8N1" # Kommunikationsparameter für den Adapter

# RS485 via TCP/IP (Modbus RTU)
modbus: rs485tcpip
id: 1
host: 192.0.2.2 # Hostname
port: 502 # Port

# Modbus TCP
modbus: tcpip
id: 1
host: 192.0.2.2 # Hostname
port: 502 # Port
timeout: 10s # optional
Sponsor Token Required

More information on 💚 evcc Sponsorship can be found here.

Pulsares SimpleBox

chargers:
- name: my_charger
type: template
template: pulsares

# RS485 via adapter (Modbus RTU)
modbus: rs485serial
id: 1
device: /dev/ttyUSB0 # USB-RS485 Adapter Adresse
baudrate: 9600 # Prüfe die Geräteeinstellungen, typische Werte sind 9600, 19200, 38400, 57600, 115200
comset: "8N1" # Kommunikationsparameter für den Adapter

# RS485 via TCP/IP (Modbus RTU)
modbus: rs485tcpip
id: 1
host: 192.0.2.2 # Hostname
port: 502 # Port

Pulsatrix

chargers:
- name: my_charger
type: template
template: pulsatrix
host: 192.0.2.2 # IP address or hostname
Sponsor Token Required

More information on 💚 evcc Sponsorship can be found here.

Qcells Q.HOME EDRIVE A

The charger must be in “Fast” mode and decoupled from the inverter system.

chargers:
- name: my_charger
type: template
template: solax

# RS485 via adapter (Modbus RTU)
modbus: rs485serial
id: 70
device: /dev/ttyUSB0 # USB-RS485 Adapter Adresse
baudrate: 9600 # Prüfe die Geräteeinstellungen, typische Werte sind 9600, 19200, 38400, 57600, 115200
comset: "8N1" # Kommunikationsparameter für den Adapter

# RS485 via TCP/IP (Modbus RTU)
modbus: rs485tcpip
id: 70
host: 192.0.2.2 # Hostname
port: 502 # Port
Sponsor Token Required

More information on 💚 evcc Sponsorship can be found here.

chargers:
- name: my_charger
type: template
template: schneider-evlink-v3

# Modbus TCP
modbus: tcpip
id: 255
host: 192.0.2.2 # Hostname
port: 502 # Port
Sponsor Token Required

More information on 💚 evcc Sponsorship can be found here.

Schrack i-CHARGE CION

chargers:
- name: my_charger
type: template
template: ichargecion

# RS485 via adapter (Modbus RTU)
modbus: rs485serial
id: 1
device: /dev/ttyUSB0 # USB-RS485 Adapter Adresse
baudrate: 9600 # Prüfe die Geräteeinstellungen, typische Werte sind 9600, 19200, 38400, 57600, 115200
comset: "8N1" # Kommunikationsparameter für den Adapter

# RS485 via TCP/IP (Modbus RTU)
modbus: rs485tcpip
id: 1
host: 192.0.2.2 # Hostname
port: 502 # Port

SENEC

Wallbox pro

chargers:
- name: my_charger
type: template
template: abl

# RS485 via adapter (Modbus RTU)
modbus: rs485serial
id: 1
device: /dev/ttyUSB0 # USB-RS485 Adapter Adresse
baudrate: 38400 # Prüfe die Geräteeinstellungen, typische Werte sind 9600, 19200, 38400, 57600, 115200
comset: "8E1" # Kommunikationsparameter für den Adapter

# RS485 via TCP/IP (Modbus RTU)
modbus: rs485tcpip
id: 1
host: 192.0.2.2 # Hostname
port: 502 # Port
timeout: 10s # optional
Sponsor Token Required

More information on 💚 evcc Sponsorship can be found here.

Wallbox pro s

Please read the wiring and configuration manual carefully. All boxes must be configured for external control in follower mode (DIP S5/4 OFF). Each box needs an individual Modbus ID (DIP S4). Ensure correct RS485 cabling including bus termination (DIP S6/2).

chargers:
- name: my_charger
type: template
template: heidelberg

# RS485 via adapter (Modbus RTU)
modbus: rs485serial
id: 1
device: /dev/ttyUSB0 # USB-RS485 Adapter Adresse
baudrate: 19200 # Prüfe die Geräteeinstellungen, typische Werte sind 9600, 19200, 38400, 57600, 115200
comset: "8E1" # Kommunikationsparameter für den Adapter

# RS485 via TCP/IP (Modbus RTU)
modbus: rs485tcpip
id: 1
host: 192.0.2.2 # Hostname
port: 502 # Port
Sponsor Token Required

More information on 💚 evcc Sponsorship can be found here.

Siemens Versicharge GEN3

Requires firmware >= 2.135

chargers:
- name: my_charger
type: template
template: versicharge

# Modbus TCP
modbus: tcpip
id: 2
host: 192.0.2.2 # Hostname
port: 502 # Port
Sponsor Token Required

More information on 💚 evcc Sponsorship can be found here.

Skoda

Charger Connect

The device has to be used in the normal charging mode.

The usage of phase switching is currently not possible in evcc.

The identification of a vehicle using the RFID card is not possible.

chargers:
- name: my_charger
type: template
template: elli-2
ski: # SKI (Subject Key Identifier)
ip: 192.0.2.2 # IP address (optional)

Charger Pro

The device has to be used in the normal charging mode.

The usage of phase switching is currently not possible in evcc.

The identification of a vehicle using the RFID card is not possible.

chargers:
- name: my_charger
type: template
template: elli-2
ski: # SKI (Subject Key Identifier)
ip: 192.0.2.2 # IP address (optional)

Charger Pro Eichrecht

The device has to be used in the normal charging mode.

The usage of phase switching is currently not possible in evcc.

The identification of a vehicle using the RFID card is not possible.

chargers:
- name: my_charger
type: template
template: elli-2
ski: # SKI (Subject Key Identifier)
ip: 192.0.2.2 # IP address (optional)

iV Charger Connect

The device has to have a fix IP address (manuall or via DHCP).

The identification of a vehicle using the RFID card is not possible.

Important: A mostly flawless functionality can only be provided with an external energy meter and no usage of CT coils, due to sosftware bugs of the Wallbox. Using a LAN connection is highly recommended.

Note: If you've added an energy meter to your charger please use the Pro or Connected+ integration.

chargers:
- name: my_charger
type: template
template: elliconnect
ski: # SKI (Subject Key Identifier)
ip: 192.0.2.2 # IP address (optional)

iV Charger Connect+

The device has to have a fix IP address (manuall or via DHCP).

The identification of a vehicle using the RFID card is not possible.

Important: A mostly flawless functionality can only be provided with an external energy meter and no usage of CT coils, due to sosftware bugs of the Wallbox. Using a LAN connection is highly recommended.

chargers:
- name: my_charger
type: template
template: ellipro
ski: # SKI (Subject Key Identifier)
ip: 192.0.2.2 # IP address (optional)

SMA EV Charger

The charger must be switched to "Fast" charging mode and the user must have "Administrator" rights.

chargers:
- name: my_charger
type: template
template: smaevcharger
host: 192.0.2.2 # IP address or hostname
user: # User account (e.g. email address, user id, etc.)
password: # Password of the user account (use single quotes in case of leading zeros)
Sponsor Token Required

More information on 💚 evcc Sponsorship can be found here.

Smartfox Pro Charger

chargers:
- name: my_charger
type: template
template: ichargecion

# RS485 via adapter (Modbus RTU)
modbus: rs485serial
id: 1
device: /dev/ttyUSB0 # USB-RS485 Adapter Adresse
baudrate: 9600 # Prüfe die Geräteeinstellungen, typische Werte sind 9600, 19200, 38400, 57600, 115200
comset: "8N1" # Kommunikationsparameter für den Adapter

# RS485 via TCP/IP (Modbus RTU)
modbus: rs485tcpip
id: 1
host: 192.0.2.2 # Hostname
port: 502 # Port

smartWB

chargers:
- name: my_charger
type: template
template: smartwb
host: 192.0.2.2 # IP address or hostname

SolarEdge Home EV Charger

Requires firmware version 3.10.42 (C-series) bzw. 1.11 (X-series). For phase switching the Keba phase switch (KeContact S10) is also required and the switching control via Modbus must be set in the wallbox settings. For the X-series in the web menu, for the C-series via Modbus by setting the value "3" in register 5050.

chargers:
- name: my_charger
type: template
template: keba-modbus

# Modbus TCP
modbus: tcpip
id: 255
host: 192.0.2.2 # Hostname
port: 502 # Port
Sponsor Token Required

More information on 💚 evcc Sponsorship can be found here.

Solax X3-EVC

The charger must be in “Fast” mode and decoupled from the inverter system.

chargers:
- name: my_charger
type: template
template: solax

# RS485 via adapter (Modbus RTU)
modbus: rs485serial
id: 70
device: /dev/ttyUSB0 # USB-RS485 Adapter Adresse
baudrate: 9600 # Prüfe die Geräteeinstellungen, typische Werte sind 9600, 19200, 38400, 57600, 115200
comset: "8N1" # Kommunikationsparameter für den Adapter

# RS485 via TCP/IP (Modbus RTU)
modbus: rs485tcpip
id: 70
host: 192.0.2.2 # Hostname
port: 502 # Port
Sponsor Token Required

More information on 💚 evcc Sponsorship can be found here.

Sonnen sonnenCharger

The charger must be switched to "Power" charging mode.

chargers:
- name: my_charger
type: template
template: etrel
host: 192.0.2.2 # IP address or hostname
port: 502 # Port (optional)
Sponsor Token Required

More information on 💚 evcc Sponsorship can be found here.

Spelsberg Wallbox

The 'Modbus TCP Server' must be enabled. The setting 'Register Address Set' must NOT be set to 'Phoenix' or 'TQ-DM100'. Use the third selection labeled 'Ebee', 'Bender', 'MENNEKES' etc. Set 'Allow UID Disclose' to On.

chargers:
- name: my_charger
type: template
template: bender
host: 192.0.2.2 # IP address or hostname
port: 502 # Port (optional)
Sponsor Token Required

More information on 💚 evcc Sponsorship can be found here.

Stark in Strom Easy

chargers:
- name: my_charger
type: template
template: evse-din

# RS485 via adapter (Modbus RTU)
modbus: rs485serial
id: 1
device: /dev/ttyUSB0 # USB-RS485 Adapter Adresse
baudrate: 9600 # Prüfe die Geräteeinstellungen, typische Werte sind 9600, 19200, 38400, 57600, 115200
comset: "8N1" # Kommunikationsparameter für den Adapter

# RS485 via TCP/IP (Modbus RTU)
modbus: rs485tcpip
id: 1
host: 192.0.2.2 # Hostname
port: 502 # Port

Sungrow AC011E-01

chargers:
- name: my_charger
type: template
template: sungrow

# RS485 via adapter (Modbus RTU)
modbus: rs485serial
id: 248
device: /dev/ttyUSB0 # USB-RS485 Adapter Adresse
baudrate: 9600 # Prüfe die Geräteeinstellungen, typische Werte sind 9600, 19200, 38400, 57600, 115200
comset: "8N1" # Kommunikationsparameter für den Adapter

# RS485 via TCP/IP (Modbus RTU)
modbus: rs485tcpip
id: 248
host: 192.0.2.2 # Hostname
port: 502 # Port

# Modbus TCP
modbus: tcpip
id: 248
host: 192.0.2.2 # Hostname
port: 502 # Port
Sponsor Token Required

More information on 💚 evcc Sponsorship can be found here.

TechniSat Technivolt

The 'Modbus TCP Server' must be enabled. The setting 'Register Address Set' must NOT be set to 'Phoenix' or 'TQ-DM100'. Use the third selection labeled 'Ebee', 'Bender', 'MENNEKES' etc. Set 'Allow UID Disclose' to On.

chargers:
- name: my_charger
type: template
template: bender
host: 192.0.2.2 # IP address or hostname
port: 502 # Port (optional)
Sponsor Token Required

More information on 💚 evcc Sponsorship can be found here.

Tesla TWC3

The TWC wallbox cannot be controlled directly. Control is via the vehicle. The vehicle must be associated with the TWC3 loadpoint. At this time only Tesla vehicles are supported.

chargers:
- name: my_charger
type: template
template: twc3
host: 192.0.2.2 # IP address or hostname

Tigo GO EV Charger

The charger must be in “Fast” mode and decoupled from the inverter system.

chargers:
- name: my_charger
type: template
template: solax

# RS485 via adapter (Modbus RTU)
modbus: rs485serial
id: 70
device: /dev/ttyUSB0 # USB-RS485 Adapter Adresse
baudrate: 9600 # Prüfe die Geräteeinstellungen, typische Werte sind 9600, 19200, 38400, 57600, 115200
comset: "8N1" # Kommunikationsparameter für den Adapter

# RS485 via TCP/IP (Modbus RTU)
modbus: rs485tcpip
id: 70
host: 192.0.2.2 # Hostname
port: 502 # Port
Sponsor Token Required

More information on 💚 evcc Sponsorship can be found here.

TinkerForge

WARP Charger Pro

WARP Firmware v2 required. Automatic phase switching requires the additional WARP Energy Manager.

chargers:
- name: my_charger
type: template
template: tinkerforge-warp
host: 192.0.2.2 # IP address or hostname of the MQTT broker
port: 1883 # MQTT broker port (optional)
topic: warp # Topic (omit leading /) (optional)
timeout: 30s # Don't accept values older than this value (optional)
energymanager: # WEM Firmware v2 required. EnergyManager MQTT topic (if installed) (optional)

WARP Charger Smart

WARP Firmware v2 required. Automatic phase switching requires the additional WARP Energy Manager.

chargers:
- name: my_charger
type: template
template: tinkerforge-warp
host: 192.0.2.2 # IP address or hostname of the MQTT broker
port: 1883 # MQTT broker port (optional)
topic: warp # Topic (omit leading /) (optional)
timeout: 30s # Don't accept values older than this value (optional)
energymanager: # WEM Firmware v2 required. EnergyManager MQTT topic (if installed) (optional)

WARP3 Charger Pro

The automatic phase switching for 1p vehicles must be deactivated. Siehe https://docs.warp-charger.com/docs/mqtt_http/api_reference/evse#evse_phase_auto_switch_warp3.

chargers:
- name: my_charger
type: template
template: tinkerforge-warp3
host: 192.0.2.2 # IP address or hostname of the MQTT broker
port: 1883 # MQTT broker port (optional)
topic: warp # Topic (omit leading /) (optional)
timeout: 30s # Don't accept values older than this value (optional)

WARP3 Charger Smart

The automatic phase switching for 1p vehicles must be deactivated. Siehe https://docs.warp-charger.com/docs/mqtt_http/api_reference/evse#evse_phase_auto_switch_warp3.

chargers:
- name: my_charger
type: template
template: tinkerforge-warp3
host: 192.0.2.2 # IP address or hostname of the MQTT broker
port: 1883 # MQTT broker port (optional)
topic: warp # Topic (omit leading /) (optional)
timeout: 30s # Don't accept values older than this value (optional)

Ubitricity Heinz

The 'Modbus TCP Server' must be enabled. The setting 'Register Address Set' must NOT be set to 'Phoenix' or 'TQ-DM100'. Use the third selection labeled 'Ebee', 'Bender', 'MENNEKES' etc. Set 'Allow UID Disclose' to On.

chargers:
- name: my_charger
type: template
template: bender
host: 192.0.2.2 # IP address or hostname
port: 502 # Port (optional)
Sponsor Token Required

More information on 💚 evcc Sponsorship can be found here.

Vestel EVC04 Home Smart, Connect Plus

chargers:
- name: my_charger
type: template
template: vestel

# Modbus TCP
modbus: tcpip
id: 255
host: 192.0.2.2 # Hostname
port: 502 # Port
Sponsor Token Required

More information on 💚 evcc Sponsorship can be found here.

Victron

EV Charging Station

Enter the host of the charger (not the GX device) and ensure that the charger is in manual mode.

chargers:
- name: my_charger
type: template
template: victron-evcs

# Modbus TCP
modbus: tcpip
id: 1
host: 192.0.2.2 # Hostname
port: 502 # Port

EV Charging Station (via GX)

Enter the host of the GX device (not the charger). The charger has to be in manual mode and Modbus has to be configured for ID 100.

chargers:
- name: my_charger
type: template
template: victron

# Modbus TCP
modbus: tcpip
id: 100
host: 192.0.2.2 # Hostname
port: 502 # Port

Viridian EV EVSE EPC 2.0 Plus

chargers:
- name: my_charger
type: template
template: obo

# RS485 via adapter (Modbus RTU)
modbus: rs485serial
id: 101
device: /dev/ttyUSB0 # USB-RS485 Adapter Adresse
baudrate: 19200 # Prüfe die Geräteeinstellungen, typische Werte sind 9600, 19200, 38400, 57600, 115200
comset: "8E1" # Kommunikationsparameter für den Adapter

# RS485 via TCP/IP (Modbus RTU)
modbus: rs485tcpip
id: 101
host: 192.0.2.2 # Hostname
port: 502 # Port

# Modbus TCP
modbus: tcpip
id: 101
host: 192.0.2.2 # Hostname
port: 502 # Port

Volkswagen

Charger Connect 2

The device has to be used in the normal charging mode.

The usage of phase switching is currently not possible in evcc.

The identification of a vehicle using the RFID card is not possible.

chargers:
- name: my_charger
type: template
template: elli-2
ski: # SKI (Subject Key Identifier)
ip: 192.0.2.2 # IP address (optional)

Charger Pro 2

The device has to be used in the normal charging mode.

The usage of phase switching is currently not possible in evcc.

The identification of a vehicle using the RFID card is not possible.

chargers:
- name: my_charger
type: template
template: elli-2
ski: # SKI (Subject Key Identifier)
ip: 192.0.2.2 # IP address (optional)

Charger Pro Eichrecht 2

The device has to be used in the normal charging mode.

The usage of phase switching is currently not possible in evcc.

The identification of a vehicle using the RFID card is not possible.

chargers:
- name: my_charger
type: template
template: elli-2
ski: # SKI (Subject Key Identifier)
ip: 192.0.2.2 # IP address (optional)

ID. Charger Connect

The device has to have a fix IP address (manuall or via DHCP).

The identification of a vehicle using the RFID card is not possible.

Important: A mostly flawless functionality can only be provided with an external energy meter and no usage of CT coils, due to sosftware bugs of the Wallbox. Using a LAN connection is highly recommended.

Note: If you've added an energy meter to your charger please use the Pro or Connected+ integration.

chargers:
- name: my_charger
type: template
template: elliconnect
ski: # SKI (Subject Key Identifier)
ip: 192.0.2.2 # IP address (optional)

ID. Charger Pro

The device has to have a fix IP address (manuall or via DHCP).

The identification of a vehicle using the RFID card is not possible.

Important: A mostly flawless functionality can only be provided with an external energy meter and no usage of CT coils, due to sosftware bugs of the Wallbox. Using a LAN connection is highly recommended.

chargers:
- name: my_charger
type: template
template: ellipro
ski: # SKI (Subject Key Identifier)
ip: 192.0.2.2 # IP address (optional)

Wallbe Eco, Eco 2.0(s), Pro

DIP switch 10 at the controller needs to be set to 'ON'. A recent controller firmware is recommended.

chargers:
- name: my_charger
type: template
template: phoenix-ev-eth

# Modbus TCP
modbus: tcpip
id: 255
host: 192.0.2.2 # Hostname
port: 502 # Port
Sponsor Token Required

More information on 💚 evcc Sponsorship can be found here.

wallbox

Pulsar Plus, Pulsar Max, Commander 2, Copper SB (FW 5.x)

Setup Guide: https://support.wallbox.com/en/knowledge-base/ocpp-activation-and-setup-guide/

  • Switch on “Enable OCPP” (myWallbox app) or enable the “OCPP WebSocket connection” switch (myWallbox Portal)
  • Enable “Improved charger control” (Profile -> Experimental functions) (myWallbox app)
  • URL: ws://[evcc-adresse]:8887/ (local network connection)
  • Charge Point Identity: Custom value (e.g. serial number of charger) which is reused in configuration as stationid
  • Password: leave empty
chargers:
- name: my_charger
type: template
template: pulsarplus-fw5
stationid: EVB-P12354 # Station ID of the charging point. Only required if multiple OCPP charging stations are set up to assign them correctly. A single OCPP charging station can also be automatically assigned. Note: In exceptional cases, it may be necessary to manually append this ID to the OCPP URL of the charging station in the form ws://<evcc-address>:8887/<stationid>. Most charging stations automatically add the ID internally. (optional)
Sponsor Token Required

More information on 💚 evcc Sponsorship can be found here.

Pulsar Plus, Pulsar Max, Commander 2, Copper SB (FW 6.x)

Setup Guide: https://support.wallbox.com/en/knowledge-base/ocpp-activation-and-setup-guide/

  • Switch on “Enable OCPP” (myWallbox app) or enable the “OCPP WebSocket connection” switch (myWallbox Portal)
  • Enable “Improved charger control” (Profile -> Experimental functions) (myWallbox app)
  • URL: ws://[evcc-adresse]:8887/ (local network connection)
  • Charge Point Identity: Custom value (e.g. serial number of charger) which is reused in configuration as stationid
  • Password: leave empty
chargers:
- name: my_charger
type: template
template: pulsarplus
stationid: EVB-P12354 # Station ID of the charging point. Only required if multiple OCPP charging stations are set up to assign them correctly. A single OCPP charging station can also be automatically assigned. Note: In exceptional cases, it may be necessary to manually append this ID to the OCPP URL of the charging station in the form ws://<evcc-address>:8887/<stationid>. Most charging stations automatically add the ID internally. (optional)
Sponsor Token Required

More information on 💚 evcc Sponsorship can be found here.

Walther Werke Basic Evo Pro

Please read the wiring and configuration manual carefully. All boxes must be configured for external control in follower mode (DIP S5/4 OFF). Each box needs an individual Modbus ID (DIP S4). Ensure correct RS485 cabling including bus termination (DIP S6/2).

chargers:
- name: my_charger
type: template
template: heidelberg

# RS485 via adapter (Modbus RTU)
modbus: rs485serial
id: 1
device: /dev/ttyUSB0 # USB-RS485 Adapter Adresse
baudrate: 19200 # Prüfe die Geräteeinstellungen, typische Werte sind 9600, 19200, 38400, 57600, 115200
comset: "8E1" # Kommunikationsparameter für den Adapter

# RS485 via TCP/IP (Modbus RTU)
modbus: rs485tcpip
id: 1
host: 192.0.2.2 # Hostname
port: 502 # Port
Sponsor Token Required

More information on 💚 evcc Sponsorship can be found here.

Webasto

Live

The 'Modbus TCP Server' must be enabled. The setting 'Register Address Set' must NOT be set to 'Phoenix' or 'TQ-DM100'. Use the third selection labeled 'Ebee', 'Bender', 'MENNEKES' etc. Set 'Allow UID Disclose' to On.

chargers:
- name: my_charger
type: template
template: bender
host: 192.0.2.2 # IP address or hostname
port: 502 # Port (optional)
Sponsor Token Required

More information on 💚 evcc Sponsorship can be found here.

NEXT

Mode "HEMS activated" must be enabled. RFID tags can only be read by evcc.

chargers:
- name: my_charger
type: template
template: webasto-next
host: 192.0.2.2 # IP address or hostname
port: 502 # Port (optional)
Sponsor Token Required

More information on 💚 evcc Sponsorship can be found here.

Unite

chargers:
- name: my_charger
type: template
template: vestel

# Modbus TCP
modbus: tcpip
id: 255
host: 192.0.2.2 # Hostname
port: 502 # Port
Sponsor Token Required

More information on 💚 evcc Sponsorship can be found here.

Weidmüller AC Smart

chargers:
- name: my_charger
type: template
template: weidmüller
host: 192.0.2.2 # IP address or hostname
Sponsor Token Required

More information on 💚 evcc Sponsorship can be found here.

Zaptec Go, Pro

chargers:
- name: my_charger
type: template
template: zaptec
id: # Charger ID (optional)
user: # User account (e.g. email address, user id, etc.) (optional)
password: # Password of the user account (use single quotes in case of leading zeros) (optional)
Sponsor Token Required

More information on 💚 evcc Sponsorship can be found here.

Generic support

Custom

Mandatory:

chargers:
- name: my_charger
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: ...
# ...

Optional, additionally add any of the following

    ...
maxcurrentmilis: # set charger max current (mA), maxcurrent: MUST be defined too!
source: ...
# ...
Phases1p3p: # phase switching (1/3)
source: ...
# ...
#1p3p does no longer handle disable/enable. Use tos: true to confirm you understand the consequences
tos: true
features:
# no vehicle
- integrateddevice
# SoC as temperature
- heating
icon: ...

Demo charger

For demonstration purposes. Charger with a fixed set of values.

chargers:
- name: my_charger
type: template
template: demo-charger
status: A # optional
power: 0 # optional
enabled: true # optional

EEBUS compatible Wallbox

chargers:
- name: my_charger
type: template
template: eebus
ski: # SKI (Subject Key Identifier)
ip: 192.0.2.2 # IP address (optional)

OCPP 1.6J compatible charger with Smart Charging Profile

With OCPP the connection will be established from charger (client) to evcc (server). The charger needs to be able to reach evcc via the host name (functioning DNS resolution required!) or via the IP address on port 8887. By default, the first incoming connection with any station identifier is used. In order to be able to clearly assign several charging points, the respective station identifier (stationid: ) and connector number (connector: ) must be configured. Many wallboxes automatically add the station id to the backend URL, some have to do this manually ws://<evcc>:8887/<stationid>. If the charger supports sending metering values try to adjust the interval to a short time span (< 10s) . Use your RFID tags (this allows e.g. vehicle identification) or set your charger to "free charging" or "autostart" to generate the transaction required for charging release.

If the charger does not offer any option to start transactions locally, the remotestart advanced option can be used to automatically start a transaction as soon as a vehicle is connected. This should only be necessary in exceptional cases.

Requirements:

  • If necessary, remove previously configured OCPP profiles (e.g. used for a different backend connection) in the charger configuration
  • Backend URL (Central System) in the charger configuration: ws://[evcc-adresse]:8887/ (possibly add stationid)
  • Protocol: OCPP-J v1.6, ocpp16j, JSON, Websocket, ws:// or similar
  • No encryption, no authentication, no password
  • Local network connection

The specific configuration and the actual usable functionality depend on the charger model and its software.

chargers:
- name: my_charger
type: template
template: ocpp
stationid: EVB-P12354 # Station ID of the charging point. Only required if multiple OCPP charging stations are set up to assign them correctly. A single OCPP charging station can also be automatically assigned. Note: In exceptional cases, it may be necessary to manually append this ID to the OCPP URL of the charging station in the form ws://<evcc-address>:8887/<stationid>. Most charging stations automatically add the ID internally. (optional)
Sponsor Token Required

More information on 💚 evcc Sponsorship can be found here.

Switchable sockets

Switchable Sockets (including smart-home switches) supported by evcc can be operated in one of two modes:

  • Charger Mode (default)
  • Static-Switch Mode

Charger Mode allows use of the Switchable Socket to control the charging of battery-operated devices such as e-Motorcycles, e-Bikes, etc). Charging current is measured and displayed by evcc, and the device is considered "charged" when power draw drops to a trickle (i.e power < standbypower)

In contrast, Static-Switch Mode can be used to easily control consumers such as heat pumps, air conditioning systems, and more. The status of the device is determined by whether the Socket is on or off (on = "charging", off = "charged").

note

When using Static-Switch Mode, it is recommended to define a separate custom Meter in order to display meaningful performance information.

For all Switchable Sockets, the mode depends on how standbypower is configured.

If the value of standbypower is greater than or equal to 0 (standbypower >= 0), then the Socket uses Charger Mode, and the set value is treated as the threshold value (in Watts). So long as the measured socket power is above this threshold value, the device is treated as "charging". If the power falls below this value (usually when the device is trickle-charging when its battery is full), it is treated as "charged" / complete.

If standbypower is set to a negative value, then the Socket uses Static-Switch Mode.

info

The Charging Point parameter phases must be set to 1 when using a switchable socket to ensure proper control.

# loadpoint describes the charger, charge meter and connected vehicle
loadpoints:
- title: Shelly # display name for UI
charger: my_charger # charger
vehicle: audi
mode: pv
---
mincurrent: 9 # 9A*220V=1980W minimum charge current (default 6A)
maxcurrent: 10 # 10A*220V=2200W maximum charge current (default 16A)
phases: 1 # ev phases (default 3)

AVM FritzDECT

chargers:
- name: my_charger
type: template
template: fritzdect
uri: https://fritz.box # HTTP(S) address (optional)
user: # User account (e.g. email address, user id, etc.)
password: # Password of the user account (use single quotes in case of leading zeros)
ain: 307788992233 # The AIN is printed on the type label on the back of the device. Embed it in double quotes in case of leading zeroes.
standbypower: 15 # Power values above this value will be considered as charging pow (optional)

Homematic IP

chargers:
- name: my_charger
type: template
template: homematic
host: 192.0.2.2 # IP address or hostname
port: 2010 # Port (optional)
device: '0001EE89AAD848' # Homematic device id like shown in the CCU web user interface.
user: # User account (e.g. email address, user id, etc.) (optional)
password: # Password of the user account (use single quotes in case of leading zeros) (optional)
standbypower: 15 # Power values above this value will be considered as charging pow (optional)

HomeWizard

chargers:
- name: my_charger
type: template
template: homewizard
host: 192.0.2.2 # IP address or hostname
standbypower: 15 # Power values above this value will be considered as charging pow (optional)

myStrom Switch

chargers:
- name: my_charger
type: template
template: mystrom
host: 192.0.2.2 # IP address or hostname
standbypower: 15 # Power values above this value will be considered as charging pow (optional)

Shelly

chargers:
- name: my_charger
type: template
template: shelly
host: 192.0.2.2 # IP address or hostname
user: # User account (e.g. email address, user id, etc.) (optional)
password: # Password of the user account (use single quotes in case of leading zeros) (optional)
channel: 0 # optional
standbypower: 15 # Power values above this value will be considered as charging pow (optional)

Tasmota single phase

chargers:
- name: my_charger
type: template
template: tasmota
host: 192.0.2.2 # IP address or hostname
user: # admin is default (optional)
password: # Password of the user account (use single quotes in case of leading zeros) (optional)
channel: 1 # Relaychannel number (1-8)
standbypower: 15 # Power values above this value will be considered as charging pow (optional)

H-Series Smart Plug

chargers:
- name: my_charger
type: template
template: tplink
host: 192.0.2.2 # IP address or hostname
standbypower: 15 # Power values above this value will be considered as charging pow (optional)

Tapo P-Series Smart Plug

chargers:
- name: my_charger
type: template
template: tapo
host: 192.0.2.2 # IP address or hostname
user: # User account (e.g. email address, user id, etc.)
password: # Password of the user account (use single quotes in case of leading zeros)
standbypower: 15 # Power values above this value will be considered as charging pow (optional)