Home Assistant Integration: evcc☀️🚘- Solar Charging (unofficial)

I was surprised that looks like that there does not exist a simple Home Assistant integration for evcc - even if I do not believe that I have the need for evcc at all, I want to contribute a very simple & basic integration which allow you to control evcc objects simply via the default HA gui.

Please note, that this integration is not official and not supported by the evcc developers. I am not affiliated with evcc in any way. This integration is based on the evcc API and the evcc API documentation.

Disclaimer

Please be aware, that we are developing this integration to best of our knowledge and belief, but cant give a guarantee. Therefore, use this integration at your own risk.

Requirements

A running & configured evcc instance in your network

Main features

Supporting all evcc API-POST & DELETE requests (except POST /api/settings/telemetry/<status>) to adjust the evcc settings, loadpoints and the corresponding vehicles
- Loadpoint mode [Off, Solar, Min+Solar, Fast]
- Phases to use [Auto, 1p, 3p]
- Assign vehicles to loadpoints
- Configure min & max charging currents
- Configure cost limits (€ or CO₂)
- Adjust home-battery settings
- Adjust/create Vehicle & Loadpoint charging plan via HA-Services http://[YOUR-HA-INSTANCE]:8123/developer-tools/service
Supporting most of the other loadpoint and vehicle data that is available via the API - please let me know, if you miss some data - probably it just slipped through my attention during testing.

Example Dashboard

Just take a look at this sample Dashboard (showing Sensors from one load point):

sampledashboard

Installation

Step I: Install the integration

Option 1: via HACS

Add a custom integration repository to HACS: https://github.com/marq24/ha-evcc
Once the repository is added, use the search bar and type evcc☀️🚘- Solar Charging
Use the 3-dots at the right of the list entry (not at the top bar!) to download/install the custom integration - the latest release version is automatically selected. Only select a different version if you have specific reasons.
After you presses download and the process has completed, you must Restart Home Assistant to install all dependencies
Setup the evcc custom integration as described below (see Step II: Adding or enabling the integration)

Option 2: manual steps

Using the tool of choice open the directory (folder) for your HA configuration (where you find configuration.yaml).
If you do not have a custom_components directory (folder) there, you need to create it.
In the custom_components directory (folder) create a new folder called evcc_intg.
Download all the files from the custom_components/evcc_intg/ directory (folder) in this repository.
Place the files you downloaded in the new directory (folder) you created.
Restart Home Assistant
Setup the evcc custom integration as described below (see Step II: Adding or enabling the integration)

Step II: Adding or enabling the integration

You must have installed the integration (manually or via HACS before)!

Option 1: My Home Assistant (2021.3+)

Just click the following Button to start the configuration automatically (for the rest see Option 2: Manually steps by step):

Option 2: Manually steps by step

Use the following steps for a manual configuration by adding the custom integration using the web interface and follow instruction on screen:

Go to Configuration -> Integrations and add "evcc☀️🚘- Solar Charging" integration
Provide a unique name for the integration installation (will be used in each sensor entity_id) created by the integration
Provide the URL of your evcc web server (including the port) - e.g. http://your-evcc-ip-here:7070
Provide area where the wallbox is located

After the integration was added you can use the 'config' button to adjust your settings, you can additionally modify the update interval

Please note, that some of the available sensors are not enabled by default.

Use evcc with your Home Assistant sensor data

Please see the separate document where you can find examples how to provide your evcc instance with HA sensor data.

Are you are go-eCharger V3 (or higher) User?

Do you know, that as owners of a go-eCharger (V3+) there is no need to use evcc for solar surplus charging? Even without any additional hardware! Home Assistant and the go-eCharger APIv2 Connect Integration is all you need. Get all details from https://github.com/marq24/ha-goecharger-api2.

Want to report an issue?

Please use the GitHub Issues for reporting any issues you encounter with this integration. Please be so kind before creating a new issues, check the closed ones, if your problem have been already reported (& solved).

In order to speed up the support process you might like already prepare and provide DEBUG log output. In the case of a technical issue, I would need this DEBUG log output to be able to help/fix the issue. There is a short tutorial/guide 'How to provide DEBUG log' here - please take the time to quickly go through it.

For this integration you need to add:

logger:
  default: warning
  logs:
    custom_components.evcc_intg: debug

Advertisement / Werbung - alternative way to support me

Switch to Tibber!

Be smart switch to Tibber - that's what I did in october 2023. If you want to join Tibber (become a customer), you might want to use my personal invitation link. When you use this link, Tibber will we grant you and me a bonus of 50,-€ for each of us. This bonus then can be used in the Tibber store (not for your power bill) - e.g. to buy a Tibber Bridge. If you are already a Tibber customer and have not used an invitation link yet, you can also enter one afterward in the Tibber App (up to 14 days). [see official Tibber support article]

Please consider using my personal Tibber invitation link to join Tibber today or Enter the following code: 6o0kqvzf (six, oscar, zero, kilo, quebec, victor, zulu, foxtrot) afterward in the Tibber App - TIA!

marq24 / ha-evcc

readme