-
Notifications
You must be signed in to change notification settings - Fork 7
Home
Welcome to the ebusd wiki!
ebusd is a daemon for handling communication with eBUS devices connected to a 2-wire bus system ("energy bus" used by numerous heating systems).
It is known to run fine on regular PC hardware as well as on smaller devices like Fritzbox and Raspberry Pi.
The main features of the daemon are:
- actively send messages to and receive answers from the eBUS
- passively listen to messages sent on the eBUS
- regularly poll for messages
- scan for bus participants
- cache all data
- grab unknown messages
- log messages and problems to a log file
- dump sent/received bytes to the log file
- dump received bytes to binary files for later playback/analysis
- listen for client connections on a dedicated TCP port
For installing and building ebusd from the sources, see here: Build and install
Major releases for Debian i386, amd64, and armhf (Raspberry Pi) will be supplied with installable package files. See the latest release info for downloading such a package.
The command line options of ebusd are explained here: Run
The configuration of ebusd depends mainly on the sent/received messages and their structure. A lot of the bus communication was already identified for some Vaillant heat pumps and associated devices. These configuration files are maintained here: ebusd-configuration.
More information on how to write your own configuration files can be found here: Configuration
In order to read data from or send commands to eBUS devices with a running ebusd, you can either use a simple TCP client like "telnet" or "nc" (netcat) and connect to the local port on which ebusd is listening (8888 by default), or you can use the ebusd provided client ebusctl. More information about the ebusd tools can be found here: Tools
The documentation of the available commands offered by the ebusd client interface is available here: Commands