====== Ebusd plugin  ======


Version History...

**Version 0.1.5**

  * Added new icons

**Version 0.1.4**

  * First public release

https://gitlab.com/VVlasy/loxberry-plugin-ebusd



====== Contents ======

  * [[#ebusdplugin-Download|Download]]
  * [[#ebusdplugin-Installation|Installation]]
  * [[#ebusdplugin-Configuration|Configuration]]
  * [[#ebusdplugin-SetModeOverride-Vaillantonly|SetMode Override - Vaillant only]]
  * [[#ebusdplugin-Description|Description]]
  * [[#ebusdplugin-Loxoneconfigsetup|Loxone config setup]]
  * [[#ebusdplugin-Roadmap|Roadmap]]
  * [[#ebusdplugin-Frequentlyaskedquestions|Frequently asked questions]]
  * [[#ebusdplugin-Contactmedirectly!|Contact me directly!]]
  * [[#ebusdplugin-RESTAPIDocumentation|REST API Documentation]]


\\



----

===== Download =====

Use the link in the above table or check out [[https://gitlab.com/VVlasy/loxberry-plugin-ebusd/|the GitLab page]].

===== Installation =====

All instalation steps are handled by the plugin itself once you start the installation on the plugins page of Loxberry.

You can use either the direct link to get the latest release version or download the zip and upload it to your Loxberry directly.

===== Configuration =====

If you have a network eBus Esera Coupler please use the following configuration line as a starting point (although network couplers are not recommended):

“--scanconfig --localhost --accesslevel='*' --enabledefine --device=a.b.c.d:5000 --initsend“

Where a.b.c.d is the IP of your Esera eBus coupler.\\
\\


The main thing for you to configure are the ebusd startup arguments. Please see [[https://github.com/john30/ebusd/wiki/2.-Run#daemon-options|ebusd documentation here]] for more information.

\\


Other possibility is enabling SetMode override. See more about this below.

===== SetMode Override - Vaillant only =====

I created this for my own needs, I did not want to use the original thermostat but still wanted to control the boiler via ebus. It uses a [[https://github.com/john30/ebusd/issues/179#issuecomment-434628658|SetModeOverride message definition]] by [[https://github.com/andig|andig]]. A requirement for this functionality is that there are no other thermostats plugged into an ebus circuit. Vaillant thermostats usually send out SetMode message every 5 seconds. SetModeOverride message is sent out by this plugin every 5 minutes or when a SetMode value is changed.

===== Description =====

Installs [[https://github.com/john30/ebusd|ebusd by john30]], sets it up and provides a Loxone Miniserver compatible HTTP REST API.

\\


Allows reading of ebus values as well as writing. If you add the option to startup arguments you can also directly write hex values to ebus.

===== Loxone config setup =====

See the below attached LoxPlan for usage

{{plugins:ebusd_plugin:1236862270.loxone|1236862270.loxone}}

===== Roadmap =====

  * Custom CSV upload
  * Full settings GUI
  * UDP communication with all the features of the REST API
  * Full REST API documentation

===== Frequently asked questions =====

None yet

\\


===== Contact me directly! =====

<mail@vvlasy.cz>

Or use the [[https://gitlab.com/VVlasy/loxberry-plugin-ebusd/issues|GitLab repository]]!

\\


===== REST API Documentation =====

%%//%%TODO

\\


\\


\\


\\


\\


\\


\\


\\