goecharger-api-lite 1.0.3

Lightweight Python API for accessing go-eCharger EV wallboxes using local HTTP API v2

goecharger API (lite)

Lightweight Python API for accessing modern go-eCharger EV wallboxes using local HTTP API v2

go-eCharger models:

• Gemini
• Gemini flex
• HOMEfix
• HOME+

Table of contents

• Features
• Installation
• Usage Examples
  • Query Status
    • Pretty Print Status
  • Set Configuration
• Links

Features

• Query Charger Status
• Set Charger Configuration

Installation

pip install goecharger-api-lite

Usage Examples

Query Status

from goecharger import GoeCharger

charger = GoeCharger("192.168.1.150") # --> change to your IP

# get full status
status = charger.get_status(status_type=GoeCharger.STATUS_FULL)

# essential status (car state, wallbox state, wallbox error)
status = charger.get_status(status_type=GoeCharger.STATUS_MINIMUM)

# status for custom API keys (friendly name, OEM manufacturer) 
status = charger.get_status(("fna", "oem"))

Hint: Pretty Print Status

import json

print(json.dumps(status, indent=4))

{
    "fna": "myEVCharger",
    "oem": "go-e"
}

Set Configuration

Set Generic API Key (friendly name)

from goecharger import GoeCharger

charger = GoeCharger("192.168.1.150") # --> change to your IP

# set generic API key (friendly name: "myEVCharger")
charger.set_key("fna", "myEVCharger")

Interrupt EV charging session

from goecharger import GoeCharger

charger = GoeCharger("192.168.1.150") # --> change to your IP

# STOP current charging session
charger.set_forced_state(charger.SettableValueEnums.ForcedState.off)

# restart charging session again
charger.set_forced_state(charger.SettableValueEnums.ForcedState.neutral)

Links

go-E Website (manufacturer)

go-E API v2 specification

go-E API Keys (query status, set configuration)