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
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)
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
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
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
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
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
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
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
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
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
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)
AUTEL AC MaxiCharger, AC Compact (OCPP)
Setup Guide:
- In the Autel Charge app, click on “OCPP Server”
- In the search bar type “Custom” and select it.
- Server URL: ws://[evcc-address]:8887/ (local network connection)
- Charger ID: Leave empty (for use the serial number) or set custom value which is reused in configuration as stationid
- Authorisation Key: leave empty
chargers:
- name: my_charger
type: template
template: ocpp-autel
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)
More information on 💚 evcc Sponsorship can be found here.
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)
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)
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
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
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
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)
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
More information on 💚 evcc Sponsorship can be found here.
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
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
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
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
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
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
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
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)
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)
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)
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)
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)
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
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
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)
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
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)
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)
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
More information on 💚 evcc Sponsorship can be found here.
Livo
The device requires a fixed IP addres. It's important to set up EEBus first. After setting up EEBus the charger will recognize evcc as a HEMS device on the network. Please use the installer tool to select evcc as HEMS. After this has been done, copy the given SKI from the Install app and add it to your yaml.
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)
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)
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
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
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
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
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
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
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)
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
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)
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
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
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
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
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)
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)
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
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
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)
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
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
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
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
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)
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)
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)
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
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
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
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
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
More information on 💚 evcc Sponsorship can be found here.
Schneider EVlink Pro
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
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
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
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
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)
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
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
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)
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)
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
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)
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
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)
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
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
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)
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)
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
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)
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)
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
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
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)
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: ...
- Documentation regarding
status A..F
: https://evsim.gonium.net/#der-control-pilot-cp (DE)
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 addstationid
) - 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)
More information on 💚 evcc Sponsorship can be found here.