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:

charger:
  - 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​

mA regulation

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.

ABL​

eM4 (SBCx)​

mA regulation
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​

mA regulation
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​

1P3PmA regulation

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​

mA regulationRFID
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​

mA regulationRFID
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​

mA regulationRFID1P3P
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​

mA regulation

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 (Beta)​

mA regulationwithout sponsoring

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: # The SKI of the wallbox, usually found on the web interface of the wallbox
    ip: 192.0.2.2 # IP address

Wallbox plus (Beta)​

mA regulationwithout sponsoring

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: # The SKI of the wallbox, usually found on the web interface of the wallbox
    ip: 192.0.2.2 # IP address

Bender CC612/613​

RFID

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​

1P3PmA regulationRFID

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​

mA regulationRFID1P3P

The meter- if present- 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​

mA regulation
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​

RFID

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 (Beta)​

mA regulationwithout sponsoring

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: # The SKI of the wallbox, usually found on the web interface of the wallbox
    ip: 192.0.2.2 # IP address

Charger Pro (Beta)​

mA regulationwithout sponsoring

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: # The SKI of the wallbox, usually found on the web interface of the wallbox
    ip: 192.0.2.2 # IP address

Dadapower Premium Wallbox​

1P3PmA regulationRFIDwithout sponsoring
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)​

without sponsoring

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​

mA regulationRFID
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​

mA regulationRFID
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​

mA regulationRFID
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​

mA regulationRFID
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​

mA regulation
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​

mA regulationRFID

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 Home​

1P3PRFID
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​

RFID

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.

Elli​

Charger Connect (Beta)​

mA regulationwithout sponsoring

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: # The SKI of the wallbox, usually found on the web interface of the wallbox
    ip: 192.0.2.2 # IP address

Charger Pro (Beta)​

mA regulationwithout sponsoring

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: # The SKI of the wallbox, usually found on the web interface of the wallbox
    ip: 192.0.2.2 # IP address

EM2GO​

Home​

1P3PmA regulationwithout sponsoring

Requires Firmware version E3C_V1.1 or newer.

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

Pro Power, OCPP/ONC​

mA regulationwithout sponsoring

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​

RFID

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​

mA regulationRFID

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.

Etrel​

INCH​

mA regulation

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​

mA regulation

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​

without sponsoring
chargers:
  - name: my_charger
    type: template
    template: elvi
    timeout: 2m # optional
    meter: true # Deactivate if the charger has no integrated metering device installed (optional)

EVSE DIN​

without sponsoring
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​

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

Fronius Wattpilot​

1P3PRFIDwithout sponsoring

Requires firmware 36.3 or later.

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

Garo GLB, GLB+, LS4, LS4 compact​

RFID

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)​

1P3PRFID

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​

RFID

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​

mA regulation

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​

without sponsoring

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
    timeout: 2m # optional

Huawei FusionCharge AC​

chargers:
  - name: my_charger
    type: template
    template: huawei-ac
    
    # 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.

Innogy eBox​

mA regulation
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​

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

Juice Charger Me​

RFID

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​

1P3PmA regulationRFID

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.

KSE wBX16​

RFID
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​

without sponsoring
chargers:
  - name: my_charger
    type: template
    template: phoenix-charx
    
    # Modbus TCP
    modbus: tcpip
    id: 255
    host: 192.0.2.2 # Hostname
    port: 502 # Port

Mennekes​

Amedio, Amtron ChargeControl, Professional​

RFID

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​

1P3PmA regulation

The charger needs to be configured as Satellite with help of the DIP-Switches on the baseboard.

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 Start 2.0s​

1P3PmA regulation

The charger needs to be configured as Satellite with help of the DIP-Switches on the baseboard.

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, 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.

NRGKick​

Bluetooth​

without sponsoring

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

chargers:
  - name: my_charger
    type: template
    template: nrgkick-bluetooth
    mac:
    pin:

Connect​

without sponsoring

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)

OBO Bettermann Ion​

without sponsoring
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​

without sponsoring

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​

1P3PmA regulationISO 15118without sponsoring
chargers:
  - name: my_charger
    type: template
    template: openwb-pro
    host: 192.0.2.2 # IP address or hostname

series2​

without sponsoring

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​

1P3PmA regulationwithout sponsoring

Requires software 2.x

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​

RFID

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 Uni​

without sponsoring
chargers:
  - name: my_charger
    type: template
    template: orbis-viaris
    timeout: 2m # optional

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.

Phoenix Contact​

CHARX​

without sponsoring
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​

without sponsoring
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​

mA regulationRFID

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)​

without sponsoring
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​

ISO 15118mA regulationwithout sponsoring
chargers:
  - name: my_charger
    type: template
    template: pmcc
    ski: # The SKI of the wallbox, usually found on the web interface of the wallbox
    ip: 192.0.2.2 # IP address (optional)

Mobile Charger Plus​

without sponsoring
chargers:
  - name: my_charger
    type: template
    template: pmcp
    ski: # The SKI of the wallbox, usually found on the web interface of the wallbox
    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​

without sponsoring
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​

mA regulation1P3P

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​

without sponsoring
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​

mA regulation
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​

mA regulation

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.121.5

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​

iV Charger Connect (Beta)​

mA regulationwithout sponsoring

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: # The SKI of the wallbox, usually found on the web interface of the wallbox
    ip: 192.0.2.2 # IP address

iV Charger Connect+ (Beta)​

mA regulationwithout sponsoring

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: # The SKI of the wallbox, usually found on the web interface of the wallbox
    ip: 192.0.2.2 # IP address

SMA EV Charger​

mA regulation

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​

without sponsoring
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​

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

SolarEdge Home EV Charger​

1P3PmA regulationRFID

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​

mA regulation1P3P

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​

mA regulation

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​

RFID

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​

without sponsoring
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​

mA regulation

Charger needs to be set to EMS working mode and start by EMS.

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​

RFID

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​

without sponsoring

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​

mA regulation1P3P

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​

mA regulation1P3PRFIDwithout sponsoring

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​

mA regulation1P3PRFIDwithout sponsoring

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​

mA regulation1P3PRFIDwithout sponsoring
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​

mA regulation1P3PRFIDwithout sponsoring
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​

RFID

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
Sponsor Token Required

More information on 💚 evcc Sponsorship can be found here.

EV Charging Station​

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
Sponsor Token Required

More information on 💚 evcc Sponsorship can be found here.

Volkswagen​

ID. Charger Connect (Beta)​

mA regulationwithout sponsoring

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: # The SKI of the wallbox, usually found on the web interface of the wallbox
    ip: 192.0.2.2 # IP address

ID. Charger Pro (Beta)​

mA regulationwithout sponsoring

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: # The SKI of the wallbox, usually found on the web interface of the wallbox
    ip: 192.0.2.2 # IP address

Wallbe Eco, Eco 2.0(s), Pro​

mA regulationRFID

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​

without sponsoring

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
    timeout: 2m # optional

Walther Werke Basic Evo Pro​

mA regulation

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​

RFID

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​

RFID

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​

1P3PRFID
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​

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: ...
      # ...

EEBUS compatible Wallbox​

mA regulationwithout sponsoring
chargers:
  - name: my_charger
    type: template
    template: eebus
    ski: # The SKI of the wallbox, usually found on the web interface of the wallbox
    ip: 192.0.2.2 # IP address (optional)

OCPP 1.6J compatible charger with Smart Charging Profile​

without sponsoring

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>. The charger may need a pre-configured (virtual) token ID/RFID identifier (idtag: ) with which the charging sessions can be started without authorization. If the charger supports sending metering values try to adjust the interval to a short time span.

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
chargers:
  - name: my_charger
    type: template
    template: ocpp
    timeout: 2m # optional

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​

without sponsoring
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​

without sponsoring
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​

without sponsoring
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​

without sponsoring
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​

without sponsoring
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​

without sponsoring
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​

without sponsoring
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​

without sponsoring
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)