Support for all go-eCharger Wallboxes & go-eController's supporting the APIv2 - of course the APIv2 have to be enabled via the go-e mobile app, before you can use this integration [see instructions].
Please note, that this integration is not official and not supported by the go-e development team. I am not affiliated with go-e.com in any way. This integration is based on the go-e API and the go-e API documentation.
latest successfully tests go-eCharger Firmware Version: 56.2 / go-eController Firmware Version: 1.1.1
The latest go-eCharger firmware 56.8 have not been fully tested with this integration (yet) - So if you have issues with this integration after you updated your go-eCharger firmware higher than 56.2 - as reported here: #11 - then please be so kind and downgrade the firmware again. TIA
-
All documented fields in the official go-eCharger GitHub repository are supported by this integration (with very few exceptions) [see list of currently not handled API keys]
-
Support for 'PV surplus charging' (PV-Überschuss Laden) without additional hardware - no need to pay for evcc. In order to use this feature a small additional manual setup process is required [details can be found below]
-
For all go-eCharger (status) fields that support a numeric status code, this code is available as separate sensor
-
Multilanguage support: a German translation included (any feedback highly appreciated!) & looking forward to other language contributions
-
Hibernation-Mode: only request sensor data from wallbox when system is in use [details can be found below]
Please note that the configuration data will be read only every 24hours from the hardware (to save data) - but you can update the sensors any time with an 'update' button.
-
Owners of a 22kW variant can force 16A only for all relevant settings. (This can be enabled via the integration settings and require a restart of the integration - then with every restart the settings will be inspected and adjusted to a max of 16A if required)
-
Most documented fields in the official go-eCharger GitHub repository are supported by this integration.
-
More sensors will follow up
-
Multilanguage support: a German translation included (any feedback highly appreciated!) & looking forward to other language contributions
Please note that the configuration data will be read only every 24hours from the hardware (to save data) - but you can update the sensors any time with an 'update' button.
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.
- go-eCharger Wallbox running Firmware version 56.1 (or higher) - tested successfully with 56.2 BETA
- enabled APIv2 [see instructions]
- enabled APIv2 Controller running Firmware version 1.1.1 (or higher) - tested successfully with 1.1.2 BETA
- enabled APIv2 [see instructions]
- Add a custom integration repository to HACS: https://github.com/marq24/ha-goecharger-api2
- Once the repository is added, use the search bar and type
go-e APIv2 Connect - 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 go-eCharger custom integration as described below (see Step II: Adding or enabling the integration)
- 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_componentsdirectory (folder) there, you need to create it. - In the
custom_componentsdirectory (folder) create a new folder calledgoecharger_api2. - Download all the files from the
custom_components/goecharger_api2/directory (folder) in this repository. - Place the files you downloaded in the new directory (folder) you created.
- Restart Home Assistant
- Setup the go-e custom integration as described below (see Step II: Adding or enabling the integration)
You must have installed the integration (manually or via HACS before)!
Just click the following Button to start the configuration automatically (for the rest see 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 -> Integrationsand add "go-e APIv2 Connect" integration - Select what go-e device you would like to install:
go-eChargerorgo-eController - Provide the IP address (or hostname) of your go-eCharger or go-eController web server
- Provide area where the wallbox/controller 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.
When you use this integration you do not need the additional hardware (go-eController) in order to allow PV surplus charging. The only thing that is required to add a Home Assistant automation fetching the data from your grid & solar power entities and provide this data to a service of this integration.
If you are not familiar with 'creating an automation in Home Assistant', then you might like to start with a tutorial explaining the basics of automations in HA.
Please note, that only the pgrid value is required - the other two fields/sensors are just optional.
Once you have enabled the automation, you also need to:
- Select the 'logic mode': 'Awattar [Eco]' [API-Key 'lmo']
[Logik/Modus: ECO-Modus] - enable the 'Use PV surplus' [API-Key 'fup']
[Mit PV-Überschuss laden] - enable the 'Allow Charge Pause (car compatibility)' [API-Key 'acp']
[Ladepausen zulassen (Fahrzeug Kompatibilität)]
in the setting of your go-eCharger - this can be done via the integration!
Please note: in order to be able to enable 'Use PV surplus' in the go-eCharger Application you must also configure the "Flexibler Energietarif" [specify "Preisgrenze", "Country", "Anbieter", "Tarif" and so on] even though the "Flexibler Energietarif" switch is "OFF" Probably a bug in the go-echarger software?
Please note that this example is for a for SENEC.Home System - if you are using 'my' SENEC.Home Integration you can use the code below 1:1 - in any other case: You must adjust/replace the sensor identifiers!!!. So if you are not a SENEC.Home user please replace the following:
sensor.senec_grid_state_powerwith the entity that provide the information in WATT you're currently consuming from the grid (positive value) or you are exporting to the grid (negative value). Once the value is negative the go-eCharger might use the available power to start with charging your car.- optional
sensor.senec_solar_generated_powerwith the entity that provided the total power generation by your PV (in WATT) - optional
sensor.senec_battery_state_powerwith the entity that provided the power in WATT currently will be used to charge an additional battery (positive value) or will be consumed from the battery (negative value).
alias: go-e PV surplus charging brigde
description: >-
Simple automation to provide your go-eChargers with the required data so that the wallbox can support PV surplus charging.
trigger:
- platform: time_pattern
seconds: /5
condition: []
action:
- service: goecharger_api2.set_pv_data
data:
pgrid: "{{states('sensor.senec_grid_state_power')}}"
ppv: "{{states('sensor.senec_solar_generated_power')}}"
pakku: "{{states('sensor.senec_battery_state_power')}}"
mode: single
In some cases (when using other solar system integrations) you might run into the situation, that the grid sensor value is positive when you are exporting power to the grid (and negative when you import power from the grid). In this case you need to invert the value of your grid sensor. In HA this can be done very easy via the so called 'pipe' functionality inside templates.
Here is a simple example (just inserted a | float * -1) - which takes the sensor value and convert it to a floating point number (from a string) and then multiply it with -1)
action:
- service: goecharger_api2.set_pv_data
data:
pgrid: "{{states('sensor.other_grid_state_power')|float*-1}}"
...
When you have more than one go-eCharger in your HA installation, you must provide an additional attribute configid in order to let the service know which charger should be used! This configid is the ConfigEntryId of the Integration for your multiple chargers and can look like this 01J4GR20JPFQ7M888Q4C9YAR31.
The simples way to find the corresponding ConfigEntryId's of your multiple configured go-eCharger integrations is by using the GUI of the Service, activate the optional selection field, select the charger and then switch (from GUI) to YAML-Mode mode - this will show you the configid you must use. [See this image for details]
action:
- service: goecharger_api2.set_pv_data
data:
configid: 01J4GR20JPFQ7M888Q4C9YAR31
...
Please note, that this is only required, if you have multiple go-eChargers configured via this integration your HA installation.
After you have your automation up and running you might want to verify that everything is correctly connected together.
Search for the Integration Sensors _pgrid, _ppv & _pakku and check the values - or check the pvopt_average sensors for the current calculates average values.
Simply replace in the URLs the [wallbox-ip] with the ip-address or hostname of your go-eCharger.
http://[wallbox-ip]/api/status?filter=pakku,ppv,pgrid
Please note, that the wallbox drop the stored data after 5 seconds - so if the automation is not running/sending data to the wallbox these values become 'null'.
So you might like to check also the average values (to verify if the wallbox received in the recent past some data):
http://[wallbox-ip]/api/status?filter=pvopt_averagePAkku,pvopt_averagePGrid,pvopt_averagePPv
Unfortunately, it might happen [reported by a user] that the go-eCharger does not finish charging in ECO mode using the PV power (in a timely manner). If you run into the same situation, then you can ensure that charging stops when there is no longer enough PV power, by adding the following automation:
You need to adjust the entity ids: switch.goe_012345_fup, sensor.goe_012345_nrg_11 and sensor.goe_012345_pvopt_averagepgrid (replace the 012345 with your serial number) and your preferred threshold when this automation should be executed (the above: -200 for the pvopt_averagepgrid means, that as soon as the average power you export to the grid is less than 200 watt the automation will be triggered).
alias: go-e FORCE STOP of PV surplus charging
description: >-
Simple automation to ensure that the go-eCharger will stop charging when average PV will drop below given threshold
trigger:
- platform: time_pattern
seconds: /5
condition:
- condition: state
entity_id: switch.goe_012345_fup
state: "on"
- condition: numeric_state
entity_id: sensor.goe_012345_nrg_11
above: 200
- condition: numeric_state
entity_id: sensor.goe_012345_pvopt_averagepgrid
above: -200
action:
- service: goecharger_api2.stop_charging
mode: single
This integration will not always fetch all sensor data from your wallbox. For example the configuration values - they probably do not change every 5 sec. - so in order to reduce the overall system load the integration will refresh the configuration entities just every 24h - OR when you make adjustments to any of the go-eCharger settings via HA. If you want to manually sync the configuration sensors, then you can use the button.goe_[serial]_zfocore 1 ['Read Configuration' button].
Additionally, to the configuration values the number of entities that will be refreshed when no vehicle is connected (car state = 'Idle'), is also drastically reduced. In this case, the integration will only read the full data set every 5 minutes from your wallbox.
So the integration have some sort of hibernation-mode in which only the following entities will be frequently read from your wallbox (based on the configured update interval):
- car: vehicle connection status
- modelStatus: wallbox status
- err: possible error status
- nrg: power values
- trx: authorization required/unlocked (with Card ID)
- tma: temperature values
and when you make use of the PV Surplus Charging fature additionally the values for:
- pgrid
- ppv
- pakku
Once the car status will switch from idle (=1) to something different the integration will leave the hibernation-mode and update all the (none configuration) entities with the configured update interval.
Just as reference here is the list of API keys that the current implementation of the integration will not handle:
- atp: nextTripPlanData (debug)
- awc: awattar country (Austria=0, Germany=1)
- ccu: charge controller update progress (null if no update is in progress)
- cch: color_charging, format: #RRGGBB
- cfi: color_finished, format: #RRGGBB
- cid: color_idle, format: #RRGGBB
- cwc: color_waitcar, format: #RRGGBB
- clp: current limit presets, max. 5 entries
- del: set this to 0-9 to clear card (erases card name, energy and rfid id)
- delw: set this to 0-9 to delete sta config (erases ssid, key, ...)
- ferm: effectiveRoundingMode
- fna: friendlyName
- ido: Inverter data override
- loc: local time
- log: load_group_id
- lrn: set this to 0-9 to learn last read card id
- oct: firmware update trigger (must specify a branch from ocu)
- sch_satur: scheduler_saturday, control enum values: Disabled=0, Inside=1, Outside=2
- sch_sund: scheduler_sunday, control enum values: Disabled=0, Inside=1, Outside=2
- sch_week: scheduler_weekday, control enum values: Disabled=0, Inside=1, Outside=2
- tof: timezone offset in minutes
- utc: utc time
- wsc: WiFi STA error count
- wsm: WiFi STA error message
Implementation of eController features have been provided by @s3ppo (Harald Wiesinger) - thank you very much!
[screenshots are from the Android version]
-
Start the go-er App
-
Select 'Setting' (lower main button bar)
-
Select 'Connection' section as shown here:
'
-
Select 'API Settings' section as shown here:
'
-
Toggle the 'Allow local HTTP API v2' as shown here:
[screenshots are from the Android version]
-
Start the go-e App
-
Select 'Internet'
-
Enable 'Advanced Settings' as shown here:
'
-
Toggle the 'Access to /api/status and /api/set API' (Allow local HTTP API v2) as shown here:
-
DO not forget to press the save Icon!
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.goecharger_api2: debug
It will happen, that the data that is displayed by this integration does not make much sense (to you) - aka 'the data is not plausible'. Of course it could be the case, that something in this integration has been messed up - but so far - in all reported issues the root cause of implausible data was/is, that the go-e device itself already provided this data [you can check this by directly requesting the attribute from the wallbox]
Each sensor of this integration have an API-Key identifier in its entity ID. You can manually request values from your wallbox by using this API key via a regular web browser.
E.g. assuming the value of the sensor in question is sensor.goe_123456_tpa and your wallbox/controller is reachable via the IP 192.168.22.10, then you can request/read the 'original' value via the following link (where tpa is the API key):
http://192.168.22.10/api/status?filter=tpa
so the pattern is:
http://[device-ip]/api/status?filter=[API-KEY]
If the plain data that will be returned in such a request is matching the data displayed by the integration, then I would kindly ask to get in contact with go-e, since in such a case the integration is just the 'messenger'.
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!
- https://github.com/goecharger/go-eCharger-API-v2/blob/main/apikeys-en.md
- https://github.com/goecharger/go-eController-API/blob/main/apikeys-en.md
Footnotes
-
focorestands for: FOrce COnfiguration REquest ↩
