*************************
Configuration for OpenHAB
*************************

.. image:: ../images/openhab-logo.png
  :width: 300
  :alt: Openhab logo

The Gateway communicates via MQTT and publishes and listens to a number of topics.
You can integrate this into OpenHAB with the help of a MQTT server and some automation rules.

You can now just use the MQTT Discovery feature to integrate the Gateway into OpenHAB.
See the `HA Binding`_.

There are users that have integrated the EMS Gateway with OpenHAB without the Auto Discovery.
See the topic on the `OpenHAB forum`_ for an excellent configuration example.

.. image:: ../images/firmware/openhab/openhab1.jpeg
  :width: 400
  :alt: OpenHAB example


MQTT structure
==============

See `Proddy's EMS-ESP Wiki`_ for all the details on MQTT.


.. target-notes::

.. _`OpenHAB forum`: https://community.openhab.org/t/ems-esp-gateway-configuration-for-nefit-buderus-junkers-bosch-boilers/104735

.. _`HA Binding`: https://www.openhab.org/addons/bindings/mqtt.homeassistant/

.. _`Proddy's EMS-ESP Wiki`: https://emsesp.github.io/docs/MQTT/