Homebridge go-eCharger

A homebridge integration for the go-eCharger wallbox.

:warning: This plugin is currently beta. It should work but is only tested in a small variety of different cases. Please feel free to install it, use it and give feedback.

Prerequisites

• go-eCharger installed and connected to the same network
• activated HTTP API v1 (App / Internet / Erweiterte Einstellungen / Aktiviere lokale HTTP API v1)
• activated HTTP API v2 (App / Internet / Erweiterte Einstellungen / Aktiviere lokale HTTP API v2)

Configuration

You can use this plugin to add multiple go-eChargers to HomeKit. Therefore, multiple platform configurations are needed. If you are using homebridge-config-ui-x you can simply use the ui to configure the plugin.

:warning: Adding more than one charger is not fully tested. Please provide feedback if issues with multiple chargers occur.

Basically each platform configuration consists of three configuration values:

| key | type | description | |---|---|---| | instanceId | string | Some identifier for your wallbox. May be any string. | | hostname | string | The dns hostname or ip address of your go-eCharger. | | enableAdvancedAccessories | boolean | Enables advanced accessories. This is meant for users who want to have more control via HomeKit. |

Available Accessories

The following accessories are available in HomeKit, when using this plugin:

| name | type | advanced mode | description | |---|---|---|---| | Allow Charging | lock | | If unlocked everyone can charge. Locked state restricts charging to authenticated users (RFID / app). | | Car Charging | contact sensor | | Notifies you when a car is plugged in and starts or ends charging. | | Allow PWM Signal | contact sensor | X | Alerts you if the charger was unlocked via RFID card, app or because Allow Charging was unlocked | | Allow Cable Unplug | lock | X | If unlocked the type 2 cable (on the side of the charger) can only be unplugged when no car is connected. If locked the type 2 cable will be always locked. If you want the plug to be unlocked after charging, this must be set using the go-eCharger app. As soon as changed via HomeKit this setting will be set again as described. | | Status LED | light bulb | X | With this accessory you can control the brightness of the LEDs of your wallbox. | | LED Save Energy | switch | X | If enabled, the LEDs will turn off after 10 seconds of standby. | | Wallbox Temperature | temperature sensor | X | When charging, the go-eCharger returns the current temperature in degrees celsius. If this setting is not returned by your charger, the accessory will display an error. |

Support & Contribution

This project is not commercially developed or maintained. Therefore, it might take some time after opening an issue until it is solved. But anyway: If you experience any bugs feel free to open an issue or create a pull request. Contribution is always welcome.

Further information

To get further information about the go-eCharger please visit the manufacturer's website go-e.co.

The API documentation can be found in the following repository goecharger/go-eCharger-API-v1.