This is an integration for the Home Assistant for the go-e Charger Cloud wallbox (API v2) using this library.
Integrations
-> click 3 dots top right corner -> click Custom repositories
.https://github.com/openkfw/smartenergy.goecharger
as a repository and select Integration
as a category.ADD
, wait for spinner to finish and close the dialog.EXPLORE & DOWNLOAD REPOSITORIES
-> search for go-e
-> select the go-e Charger Cloud
-> wait and click DOWNLOAD
.RESTART
and wait few seconds.ADD INTEGRATION
button.go-e Charger Cloud
-> click -> fill in details -> click SUBMIT
.Example config:
Make sure that there is no trailing slash in the API host, otherwise the validation fails. When pressing submit, validation will also check the connectivity and fails if not able to connect and authenticate.
TBD
Parameter | Name | Description |
---|---|---|
car | car_status | State of the car - connected/charging/etc. |
alw | charging_allowed | Whether the car is allowed to charge at all. |
amp | charger_max_current | Requested current for charging in A. |
wh | energy_since_car_connected | Energy in kWh since car is connected. |
eto | energy_total | Total energy used in kWh. |
psm | phase_switch_mode | Phase switch mode - auto/1/3. |
pnp | phases_number_connected | Number of connected phases - relates to the phase_switch_mode. |
acs | charger_access | Access controll for the device - 0/1. |
N/A | name | Friendly name of the device. |
Parameter | Name | Description |
---|---|---|
acs | access_control | Changes access control to open if desired. |
Parameter | Name | Description |
---|---|---|
amp | charger_max_current | Set the max current. Min and max values are taken from the mca and ama parameters. |
Parameter | Name | Description |
---|---|---|
psm | phase_switch_mode | Set the phase switch mode. |
Following functions are exposed as Home Assistant services, thus can be used by other integrations.
Name | Parameters | Description |
---|---|---|
start_charging | {"device_name": "example_charger", "charging_power": 10} or {"device_name": "example_charger"} |
Starts charging with a specified charging power. charging_power is optional and you can use this service purely to start without setting the charging power. |
stop_charging | {"device_name": "example_charger"} |
Stop charging. |
change_charging_power | {"device_name": "example_charger", "charging_power": 10} |
Change charging power for a given charger. |
set_phase | {"device_name": "example_charger", "phase": 1} |
Change phase for a given charger. phase accepts values 0, 1, 2. |
set_transaction | {"device_name": "example_charger", "status": 0} |
Set the wallbox transaction. status accepts values None (no transaction) and 0 (authenticate all users). |
The integration can be configured either via UI (config flow) as described in the How to use it - HACS section or via configuration.yaml
. For example:
smartenergy_goecharger:
chargers:
- name: examplecharger
host: https://example.api.v3.go-e.io
api_token: 12345
In case you are interested in development, check the guide here.