# evcc Binding

This binding integrates evcc (opens new window), an extensible Electric Vehicle Charge Controller and home energy management system. The binding is compatible to evcc version 0.123.1 (opens new window) or newer and was tested with version 0.125.0 (opens new window).

You can easily install and upgrade evcc on openHABian using sudo openhabian-config.

evcc controls your wallbox(es) with multiple charging modes and allows you to charge your ev with your photovoltaik's excess current. To provide an intelligent charging control, evcc supports over 30 wallboxes and over 20 energy meters/home energy management systems from many manufacturers as well as electric vehicles from over 20 car manufacturers. Furthermore, evcc calculates your money savings.

This binding enables openHAB to retrieve status data from your evcc installation and to control the charging process. For more advanced features like calculated savings, you have to visit the web UI of evcc.

# Supported Things

device: A running evcc installation.

# Discovery

No auto discovery supported.

# Thing Configuration

# `device` Thing Configuration

Parameter	Type	Description	Advanced	Required
url	String	URL of evcc web UI, e.g. `https://demo.evcc.io`	No	Yes
refreshInterval	Number	Interval the status is polled in seconds (minimum is 15)	Yes	No

Default value for refreshInterval is 60 seconds.

# Channels

# General Channels

Those channels exist only once. Please note that some of them are only available when evcc is properly configured.

Channel	Type	Read/Write	Description
general#batteryCapacity	Number:Energy	R	Capacity of (home) battery
general#batteryPower	Number:Power	R	Current power from battery
general#batterySoC	Number:Dimensionless	R	Current State of Charge of battery
general#batteryDischargeControl	Switch	RW	Enable or disable battery discharge control
general#batteryMode	String	R	Current battery mode
general#prioritySoC	Number:Dimensionless	RW	State of State of Charge for which the battery has priority over charging the ev when charging mode is "pv"
general#bufferSoC	Number:Dimensionless	RW	Until this State of Charge the discharging of a house battery is allowed in "pv" mode, when there is insufficient solar surplus (below the minimum charging power)
general#bufferStartSoC	Number:Dimensionless	RW	State of Charge for which a charging session in "pv" mode is started, even if there is insufficient solar surplus
general#residualPower	Number:Power	RW	Target operating point of the surplus regulation at the grid connection (grid meter)
general#gridPower	Number:Power	R	Current power from grid (negative means feed-in)
general#homePower	Number:Power	R	Current power taken by home
general#pvPower	Number:Power	R	Current power from photovoltaik
general#version	String	R	Current evcc version
general#availableVersion	String	R	Available evcc update version

# Loadpoint Channels

Those channels exist per configured loadpoint. Please note that you have to replace <N> with your loadpoint id/number.

Channel	Type	Read/Write	Description
loadpoint<N>#activePhases	Number	R	Current number of active phases while charging
loadpoint<N>#chargeCurrent	Number:ElectricCurrent	R	Current amperage per connected phase while charging
loadpoint<N>#chargeDuration	Number:Time	R	Charging duration
loadpoint<N>#chargeRemainingDuration	Number:Time	R	Remaining duration until limit SoC is reached
loadpoint<N>#chargeRemainingEnergy	Number:Energy	R	Remaining energy until limit SoC is reached
loadpoint<N>#chargePower	Number:Power	R	Current power of charging
loadpoint<N>#chargedEnergy	Number:Energy	R	Energy charged since plugged-in
loadpoint<N>#charging	Switch	R	Loadpoint is currently charging
loadpoint<N>#enabled	Switch	R	Charging enabled (mode is not "off")
loadpoint<N>#maxCurrent	Number:ElectricCurrent	RW	Maximum amperage per connected phase with which the car should be charged
loadpoint<N>#minCurrent	Number:ElectricCurrent	RW	Minimum amperage per connected phase with which the car should be charged
loadpoint<N>#mode	String	RW	Charging mode: "off", "now", "minpv", "pv"
loadpoint<N>#phases	Number	RW	The maximum number of phases which can be used
loadpoint<N>#limitEnergy	Number:Energy	RW	Amount of energy to charge the vehicle with
loadpoint<N>#title	String	R	Title of loadpoint
loadpoint<N>#vehicleConnected	Switch	R	Whether vehicle is connected to loadpoint
loadpoint<N>#vehicleConnectedDuration	Number:Time	R	Duration the vehicle is connected to loadpoint
loadpoint<N>#vehicleOdometer	Number:Length	R	Total distance travelled by EV
loadpoint<N>#vehiclePresent	Switch	R	Whether evcc is able to get data from vehicle
loadpoint<N>#vehicleRange	Number:Length	R	Battery range for EV
loadpoint<N>#vehicleName	String	R	The unique identifier of the EV used in the evcc configuration (containing no whitespaces nor special characters)
loadpoint<N>#chargerFeatureHeating	Switch	R	'True' for heating device: State of Charge in Degree instead of Percent
loadpoint<N>#chargerFeatureIntegratedDevice	Switch	R	'True' for integrated device: Operate without a "vehicle" (e.g. heat pump, eBike)

# Loadpoint Channels Specific for Vehicles

Channel	Type	Read/Write	Description
loadpoint<N>#limitSoC	Number:Dimensionless	RW	Until which state of charge (SoC) should the vehicle be charged
loadpoint<N>#effectiveLimitSoC	Number:Dimensionless	R	Effective state of charge (SoC) until which the vehicle will be charged
loadpoint<N>#vehicleSoC	Number:Dimensionless	R	Current State of Charge of EV

# Loadpoint Channels Specific for Heating Devices

Channel	Type	Read/Write	Description
loadpoint<N>#limitTemperature	Number:Temperature	RW	Until which Temperature should the heating device be charged
loadpoint<N>#effectiveLimitTemperature	Number:Temperature	R	Effective Temperature until which the heating device will be charged
loadpoint<N>#vehicleTemperature	Number:Temperature	R	Current Temperature of the heating device

# Vehicle Channels

Those channels exist:

1 per configured loadpoint with chargerFeatureHeating = false:
- These channels point to the heating device that is currently active/connected at/to the loadpoint
- Please note that you have to replace <N> with your loadpoint id/number
1 per configured vehicle:
- Please note that you have to replace <ID> with your vehicle id/name

Channel	Type	Read/Write	Description
[loadpoint<N>\|vehicle<ID]>#vehicleTitle	String	R	Title of vehicle
[loadpoint<N>\|vehicle<ID]>#vehicleMinSoC	Number:Dimensionless	RW	Minimum state of charge (SoC) a vehicle should have
[loadpoint<N>\|vehicle<ID]>#vehicleLimitSoC	Number:Dimensionless	RW	Until which state of charge (SoC) should the specific vehicle be charged
[loadpoint<N>\|vehicle<ID]>#vehicleCapacity	Number:Energy	R	Capacity of EV battery
[loadpoint<N>\|vehicle<ID]>#vehiclePlanEnabled	Switch	RW	Plan for charging enabled
[loadpoint<N>\|vehicle<ID]>#vehiclePlanSoC	Number:Dimensionless	RW	Until which state of charge (SoC) should vehicle be charged in plan
[loadpoint<N>\|vehicle<ID]>#vehiclePlanTime	DateTime	RW	When the plan SoC should be reached

# Heating Channels