0.2.0 • Published 3 years ago

homebridge-go-e-charger v0.2.0

Weekly downloads
-
License
AGPL-3.0-or-later
Repository
github
Last release
3 years ago

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:

keytypedescription
instanceIdstringSome identifier for your wallbox. May be any string.
hostnamestringThe dns hostname or ip address of your go-eCharger.
enableAdvancedAccessoriesbooleanEnables 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:

nametypeadvanced modedescription
Allow CharginglockIf unlocked everyone can charge. Locked state restricts charging to authenticated users (RFID / app).
Car Chargingcontact sensorNotifies you when a car is plugged in and starts or ends charging.
Allow PWM Signalcontact sensorXAlerts you if the charger was unlocked via RFID card, app or because Allow Charging was unlocked
Allow Cable UnpluglockXIf 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 LEDlight bulbXWith this accessory you can control the brightness of the LEDs of your wallbox.
LED Save EnergyswitchXIf enabled, the LEDs will turn off after 10 seconds of standby.
Wallbox Temperaturetemperature sensorXWhen 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.

0.2.0

3 years ago

0.1.1

3 years ago

0.1.0

3 years ago