homebridge-go-e-charger

A homebridge integration for the go-e charger wallbox.

Usage no npm install needed!

<script type="module">
  import homebridgeGoECharger from 'https://cdn.skypack.dev/homebridge-go-e-charger';
</script>

README

npm npm release license Node.js Package Node.js CI

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.