Skip to content

Code

Code & releases

Three Go modules, versioned independently, released together when the layers below change. Everything is on GitHub — issues, discussions and pull requests included.

GitHub organisationContributing guide

How the layers stack

  • eebus-go

    Use cases — EV charging, self-consumption optimisation, power limitation. This is the import most products need.

  • spine-go

    Data model — SPINE 1.3: entities, features, function types, subscriptions and bindings.

  • ship-go

    Transport & trust — certificates, mDNS discovery, WebSocket, pairing, SHIP handshake.

EEBUSProtocol stack
MIT · Go
Your applicationHEMS · wallbox · heat pump · PV · battery
eebus-goUse cases actors · entities
spine-goSPINE 1.3 data model
ship-goSHIP 1.0.1 transport
NetworkmDNS · TLS · WebSocket

Current versions

from GitHub releases
ModuleVersionReleasedLicenceHighlightsNotes
eebus-gov0.7.0MITUse-case API reshaped, monitoring and limitation of power consumptionChangelog
spine-gov0.7.0MITSPINE 1.3 coverage, binding and subscription handlingChangelog
ship-gov0.6.0MITmDNS provider rework, connection lifecycle fixesChangelog

Versions and dates above are pulled directly from the GitHub releases of each module. The licence link points to the file in the respective repository.

Supporting repositories

The discovery layer underneath SHIP. Neither is EEBUS code, and neither is tagged — go.mod pins them by commit rather than by version.

zeroconf

mDNS and DNS-SD service discovery in pure Go

Commits
254
Last commit
github.com/enbility/zeroconf
go-avahi

Bindings for the Avahi daemon, where the port is already taken

Commits
50
Last commit
github.com/enbility/go-avahi

Implemented use cases

EVSECCEVSE commissioning and configuration
EVCCEV commissioning and configuration
EVCEMEV charging electricity measurement
EVSOCEV state of charge
OSCEVSelf-consumption optimisation during EV charging
OPEVOverload protection by charging current curtailment
LPCLimitation of power consumption — §14a EnWG
LPPLimitation of power production — §9 EEG
MGCPMonitoring of grid connection point

Other open source implementations

EEBUS is a specification, not a single codebase. Where Go does not fit the product, these projects implement the same protocols in other languages — and testing against an independent implementation is one of the better ways to find out whether a device really follows the specification.

openeebusC / C++

SHIP and SPINE in C / C++, for embedded targets where a Go or Java runtime is not an option.

Maintained by
NIBE Group
Licence
Apache-2.0
github.com/NIBEGroup/openeebus
jEEBusJava

SHIP and SPINE as separate Java libraries, plus the controllable-system side of LPC and LPP, from the Smart Grid Communication group at Fraunhofer ISE.

Maintained by
Fraunhofer ISE
Licence
EPL-2.0
openmuc.org/eebusgithub.com/openmuc

Report a problem

Interoperability bugs are the most valuable issues we get. Include the device, the firmware version and a SHIP/SPINE trace if you have one.

Open an issue

Contribute code

New use cases, test coverage and device quirk handling are all welcome. Read the contributing guide first — the SPINE model has conventions worth following.

Contributing guideHow decisions are made

Commercial support

Several consortium partners offer integration work, test-lab access and certification support around the stack on commercial terms.

Find a partner