openHAB 2.2 binding MQTT support

  • Hero Member

    Finally I'm able to present a first alpha release of the MQTT support of the OpenHAB2 binding.
    I've done some first tests with a RGB node and it looks good, but there is still some work to do.
    So this version is for the category "Don't try this at home!". 😉

    Some important notes and things to test:

    • The binding uses the upcoming MQTT support in smarthome/OpenHAB2, not the old version 1 binding! They may work together, but we need to test that. If you're willing to test that, please let me now.
    • I've tested with OpenHAB2 snapshot #1099. I don't know how far it is compatible to old versions.
    • There is a PR in the smarthome repository to add the functionality of a MQTT broker to OpenHAB2, so a separate broker won't be needed in the future. The binding will be compatible with this addition.
    • I need to adjust logging.


    1. Start OpenHAB2

    2. In karaf console:
      feature:install esh-io-transport-mqtt

    3. Download binding:

    4. Place "org.eclipse.smarthome.mqtt.cfg" in the /etc/openhab2/services or conf/services directory. New filename! (Wassn't my idea!) 😉



    (Use it like the old mqtt.cfg)

    1. Configure MQTT broker via PaperUI
      0_1512124003255_Bildschirmfoto vom 2017-12-01 11-25-59.png

    via *.things file

    Bridge mysensors:bridge-mqtt:gateway [  brokerName="mosquitto", 
                                            startupCheckEnabled=false ] {
    1. Configure or discover things.

    That's it!

  • This is great, it will certainly simplify usage of mySensors over mqtt. I remember that it took me 4-5 hours to set everything up. (I did learn a lot about mqtt and openhab, but still).
    It is still early to mention it, but... if you can somehow get FOTA to work over mqtt from openhab (even if it is via console or whatever), than you are the rock star! 🙂

  • Hero Member

    Thank you @dakipro for your feedback!

    I've updated the jar-file above. It is now possible to autodiscover a gateway if the corresponding broker is connected to OpenHab2.

    0_1513255679474_Bildschirmfoto vom 2017-12-13 20-47-04.png

    At first glance the smarthome-mqtt and the (old) openhab-mqtt seem to work together, I've had no problem configuring both in the same instance. Of course this means we need mqtt.cfg AND org.eclipse.smarthome.mqtt.cfg.

    Yeah, FOTA support would definatly be nice to have, but I'm not yet using it in my MySensors environment, so I first need to figure out how it works. 🙂

  • That is great, I've been a bit inactive with mysensors (moving and family and things) but it should be now possible to ask gateway to present all nodes (ask nodes to present themselves) and add them as things/items?
    I personally prefer to have items configured in the files, but having them autodetected via mqtt and added trough paperUi is definitely an awesome feature, completes the integration via plugin and its functionality.

    I've played yesterday with MyController and I've seen that it has support for all those things over mqtt (get items info, auto add them). It can also do FOTA over mqtt, something no other controller is capable of doing today (not even famous MySController that originally introduces FOTA). I am sure you can find some inspiration in MyController code about how it is done, when the time comes 🙂

    My plan was to use MyController only for maintenance and remote update of nodes, but unfortunately I wasn't able to set it up to work, got a bunch of exceptions when I tried to add nodes to it. I will try previous version, but if this would be supported in openhab, that would benefit both platforms, a LOT 🙂

  • First of all, I'd like to thank you for your contribution, it is greatly appreciated!

    Unfortunately, I could not get the binding to talk to my Mosquitto server, yet. I have installed the addon and configured my MySensors MQTT Gateway as described above. But when I start OpenHAB (the Docker container instantiated from "openhab/openhab:2.2.0-amd64-alpine" to be precise), this is what I get in the openhab.log file:

    2018-01-09 15:45:29.710 [INFO ] [] - MQTT Service initialization completed.
    2018-01-09 15:45:29.711 [INFO ] [t.mqtt.internal.MqttBrokerConnection] - Starting MQTT broker connection 'ineluki'
    2018-01-09 15:45:30.420 [ERROR] [rotocol.mqtt.MySensorsMqttConnection] - No connection to broker: ineluki
    2018-01-09 15:45:30.471 [ERROR] [rotocol.mqtt.MySensorsMqttConnection] - Failed connecting to retry in 10 seconds (Retry No.:0)

    And there is no "retry" after 10 seconds. At the same time this is and only this logged by Mosquitto:

    1515512709: Socket error on client openhab, disconnecting.
    1515512729: New connection from on port 1883.

    Do you have any clue or hint what I might be doing wrong? I'm entirely new to OpenHAB, so please excuse if I'm missing something obvious.

  • Hero Member

    Hi @cgrf !

    Please post the content of "org.eclipse.smarthome.mqtt.cfg".
    My guess is: there is no connection between OpenHAB2 and Mosquitto. The binding is only using the connection, it is not in charge for establishment or reconnects.

    Please check that in org.eclipse.smarthome.mqtt.cfg :


    and in the MQTT GW configuration (in OH2) the names are matching.

    In your case it should look like (or similar to):


  • Hi @TimO,

    Thanks for your response! There is an incoming connection from OpenHAB to Mosquitto, I can see as much in the Mosquitto log. But that connection does not seem to succeed.

    This is the content of my mqtt.cfg:


    That Mosquitto instance currently does not require users to authenticate.

  • Hero Member


    Is there a log entry in OpenHAB that looks like this?

    [DEBUG] [.io.transport.mqtt.MqttService:155  ] - Starting MQTT Service...
    [INFO ] [.i.t.mqtt.MqttBrokerConnection:576  ] - Starting MQTT broker connection 'mosquitto' to 'tcp://' with clientid paho6110733874326 and file store '/tmp/mosquitto'
    [DEBUG] [.io.transport.mqtt.MqttService:155  ] - Starting MQTT Service...
    [INFO ] [.i.t.mqtt.MqttBrokerConnection:576  ] - Starting MQTT broker connection 'mosquitto' to 'tcp://' with clientid paho6110762725063 and file store '/tmp/mosquitto'

    Depending on your log level there only may be the INFO line.

  • @TimO

    I have this INFO line, as included in my first post, that looks similar but not quite the same:

    2018-01-09 15:45:29.711 [INFO ] [t.mqtt.internal.MqttBrokerConnection] - Starting MQTT broker connection 'ineluki'

    The four lines from my first post are actually all lines I have in that log after the UI start-up messages.

  • Hero Member

    @cgrf said in openHAB 2.2 binding MQTT support:

    Starting MQTT broker connection

    You're using the mqtt1 (openhab1-addon) to connect to the broker. The OpenHAB2 binding is based on the current (/upcoming) mqtt-transport implementation of ESH.

    My guess: the file org.eclipse.smarthome.mqtt.cfg is missing in /etc/openhab2/services and there only is a mqtt.cfg file. Just copy the mqtt.cfg file to org.eclipse.smarthome.mqtt.cfg (Same content, different name, different use).

    mqtt.cfg: mqtt1 binding, mqtt-transport, owntracks ...

    org.eclipse.smarthome.mqtt.cfg: ESH-MQTT and I'm only aware of my binding using it yet. But there are a few upcoming (mqtt generic, mqtt2 binding ..)

  • @timo said in openHAB 2.2 binding MQTT support:

    My guess: the file org.eclipse.smarthome.mqtt.cfg is missing

    Excellent guess, that was my problem! My gateway is "online" now. It would have taken me forever to figure that out on my own, so thank you very much! (And yes, reading your first post now I realize that you said so.)

    Should OpenHAB be able to discover the sensors behind the gateway? Or do I need to configure them manually?

  • Hero Member


    Should OpenHAB be able to discover the sensors behind the gateway? Or do I need to configure them manually?

    If you restart the node they should represent themself and will show up in the Inbox in PaperUI.

  • @TimO
    Ok, I've restarted the sensor multiple times now and I assume that it presents itself properly as it is discovered by other controllers (, that is). But in OpenHAB's PaperUI it doesn't show up at all. There is a trace of it in the openhab.log though:

    2018-01-10 09:29:39.268 [WARN ] [al.sensors.child.MySensorsChildSTemp] - Overwrite variable: V_VAR1
    2018-01-10 09:29:39.269 [WARN ] [al.sensors.child.MySensorsChildSTemp] - Overwrite variable: V_VAR2
    2018-01-10 09:29:39.277 [WARN ] [al.sensors.child.MySensorsChildSTemp] - Overwrite variable: V_VAR3
    2018-01-10 09:29:39.289 [WARN ] [al.sensors.child.MySensorsChildSTemp] - Overwrite variable: V_VAR4
    2018-01-10 09:29:39.289 [WARN ] [al.sensors.child.MySensorsChildSTemp] - Overwrite variable: V_VAR5
    2018-01-10 20:38:26.959 [WARN ] [nal.sensors.child.MySensorsChildSHum] - Overwrite variable: V_VAR1
    2018-01-10 20:38:26.980 [WARN ] [nal.sensors.child.MySensorsChildSHum] - Overwrite variable: V_VAR2
    2018-01-10 20:38:26.980 [WARN ] [nal.sensors.child.MySensorsChildSHum] - Overwrite variable: V_VAR3
    2018-01-10 20:38:26.980 [WARN ] [nal.sensors.child.MySensorsChildSHum] - Overwrite variable: V_VAR4
    2018-01-10 20:38:26.981 [WARN ] [nal.sensors.child.MySensorsChildSHum] - Overwrite variable: V_VAR5
    2018-01-10 20:38:27.084 [WARN ] [sors.child.MySensorsChildSMultimeter] - Overwrite variable: V_VAR1
    2018-01-10 20:38:27.086 [WARN ] [sors.child.MySensorsChildSMultimeter] - Overwrite variable: V_VAR2
    2018-01-10 20:38:27.086 [WARN ] [sors.child.MySensorsChildSMultimeter] - Overwrite variable: V_VAR3
    2018-01-10 20:38:27.088 [WARN ] [sors.child.MySensorsChildSMultimeter] - Overwrite variable: V_VAR4
    2018-01-10 20:38:27.089 [WARN ] [sors.child.MySensorsChildSMultimeter] - Overwrite variable: V_VAR5
    2018-01-10 20:39:10.530 [WARN ] [rs.internal.gateway.MySensorsGateway] - Presented child is alredy present in gateway
    2018-01-10 20:39:11.529 [WARN ] [rs.internal.gateway.MySensorsGateway] - Presented child is alredy present in gateway
    2018-01-10 20:39:11.660 [WARN ] [rs.internal.gateway.MySensorsGateway] - Presented child is alredy present in gateway
    2018-01-10 20:40:58.584 [WARN ] [rs.internal.gateway.MySensorsGateway] - Presented child is alredy present in gateway
    2018-01-10 20:40:59.461 [WARN ] [rs.internal.gateway.MySensorsGateway] - Presented child is alredy present in gateway
    2018-01-10 20:40:59.592 [WARN ] [rs.internal.gateway.MySensorsGateway] - Presented child is alredy present in gateway

    While this is happening on MQTT:

    gateway1-out/3/255/0/0/17 2.1.1
    gateway1-out/3/255/3/0/6 0
    gateway1-out/3/255/3/0/11 Combined Climate Sensor
    gateway1-out/3/255/3/0/12 1.0.16
    gateway1-out/3/0/0/0/7 (null)
    gateway1-out/3/7/0/0/30 (null)
    gateway1-out/3/10/2/0/15 (null)
    gateway1-out/3/1/1/0/0 21.9
    gateway1-out/3/0/1/0/1 42
    gateway1-out/3/7/1/0/38 3.98
    gateway1-out/3/255/3/0/0 56

    Have you got another hint for me, maybe? It would be greatly appreciated.

  • Unfortunately, I'm still making no progress here. In the meantime I deleted the MQTT Gateway in the Paper UI and restarted the device to see what would happen. Now I'm seeing an error in openhab.log:

    2018-01-16 19:45:23.419 [INFO ] [.transport.mqtt.MqttBrokerConnection] - Starting MQTT broker connection 'ineluki' to 'tcp://' with clientid openhab2 and file store '/openhab/userdata/tmp/ineluki'
    2018-01-16 19:45:29.680 [INFO ] [.transport.mqtt.MqttBrokerConnection] - MQTT connection to 'ineluki' was lost: MqttException
    2018-01-16 19:45:29.681 [ERROR] [rotocol.mqtt.MySensorsMqttConnection] - MQTT connection offline - {}
    org.eclipse.paho.client.mqttv3.MqttException: MqttException
            at [211:org.eclipse.paho.client.mqttv3:1.0.2]
            at [?:?]
    Caused by: java.lang.NullPointerException
            at org.openhab.binding.mysensors.internal.protocol.mqtt.MySensorsMqttConnection$MySensorsMqttSubscriber.processMessage( ~[?:?]
            at$ClientCallbacks.messageArrived( ~[?:?]
            at org.eclipse.paho.client.mqttv3.internal.CommsCallback.handleMessage( ~[?:?]
            at ~[?:?]
            ... 1 more
    2018-01-16 19:45:29.709 [INFO ] [.reconnect.PeriodicReconnectStrategy] - Try to restore connection to 'ineluki' every 10000ms

    Does this give any clue on what's going wrong?

  • Ok, now I'm seeing items in my Inbox, after I changed my org.eclipse.smarthome.mqtt.cfg from




  • OK, n00b questions again:

    1. where to place the binding-jar and do I have to do something with the jar-file?
    2. no services directory exists in /etc. Create it?
    3. any other things to install? Fresh PaperUI-OpenHab installation so far.
      My system:RpiZero/Scratch+Mosquitto.

  • Hero Member


    1. /usr/share/openhab2/addons/
    2. Thank you for the hint, I've pointed to the wrong directory, it's: /etc/openhab2/services
    3. For additional Informations please have a look at the wiki:

  • Hero Member

    @cgrf Thank you for the hint! At the moment I don't have an explanation for that behaviour.

  • @timo I still cant find mqtt.cfg OR org.eclipse.smarthome.mqtt.cfg. I looked thru the Github stuff but didn't see it.

    Any ideas where to locate either of these files? I assume they have more lines than those four on display in the example.
    Thanks. Sorry I'm still a tool with OH2

  • Hardware Contributor

    @masmat As far as I know .cfg files are only the config files fpr your installed addons and are located in the service directory (see TimO's post above). And they indeed only contain the settings you want to use, which can be 4 lines only. Depends on the addon