OpenMQTT-Gateway/docs/integrate/openhab2.md

Integrate OPENHAB2

MQTT 2 manual setup >=Openhab2.4

You should have a mqtt broker installed (either mosquitto or the OpenHAB2 embedded one)

In paper UI

• In bindings add the MQTT Things binding
• Inbox > MQTT Things binding > Add manualy >MQTT Broker : configure your borker
• Inbox > MQTT Things binding > Add manualy >Generic MQTT Thing : select your previously configured broker as a bridge and enter your thing definition (example RF plug, weather station, PIR sensor)
• Configuration > Things > "Your thing" : click on + and add one channel for each thing parameter (example for a weather station, you will have one channel for the temperature, one channel for the humidity etc..)
• For a state channel define the MQTT topic like this:

For a mi flora or mi jia temperature :

home/+/BTtoMQTT/C47C9999D1B8

• Click on show more

• And add in "Incoming values transformation"

JSONPATH:$.tem

• Click on Save

• Repeat for each channels and each things

• Configuration > Things > "Your thing" : click on a channel and add 1 or several items per channel defining what you want to display in the sitemap or

• Define your items in an item file like this by refering to your mqtt things channels: For a mi flora and mi jia

// MI JIA
Number humidity		"Humidité air[%.1f %%]" <water>		    {channel="mqtt:topic:dc2222e6:humidite-mijia"}
Number temperature 	"Température[%.1f °C]"  <temperature>	    {channel="mqtt:topic:dc2222e6:temperature-mijia"}
Number battery   	"Batterie capteur[%.1f %]"<volt>	    {channel="mqtt:topic:dc2222e6:batterie-mijia"}

// MI FLORA
Number humidity_P	"Hygrométrie plante[%.1f %%]" <water>	    {channel="mqtt:topic:1fb33334:humidite-miflora"}
Number temperature_P 	"Température plante[%.1f °C]" <temperature> {channel="mqtt:topic:1fb33334:temperature-miflora"}
Number fertility_P	"Fertilité plante[%.1f uS/cm]" 	            {channel="mqtt:topic:1fb33334:fertilite-miflora"}
Number lux_P		"Luminiosité plante[%.1f lux]"              {channel="mqtt:topic:1fb33334:lux-miflora"}

For a switch channel, add a channel by choosing the type "On/Off switch"

define the MQTT state topic like this: home/+/433toMQTT

• Click on show more

• add in "Incoming values transformation" JSONPATH:$.value

• define the command topic like this: home/+/commands/MQTTto433

• add the value corresponding to ON state and to OFF state 1312081 1312084

• Click on Save

• Repeat for each channels and each things

• Configuration > Things > "Your thing" : click on a channel and add 1 or several switch per channel or

• Define your items in an item file like this by refering to your mqtt thing channel:

Switch OMGSwitch "Prise 1" <poweroutlet> {channel="mqtt:topic:08998877:Power1"}

Presence detection (from @rickitaly)

in thing file:

Thing mqtt:topic:omgentrance (mqtt:broker:localBroker) {
Channels:
    Type string : blepresence "People Presence"  [ stateTopic="home/home_presence/OpenMQTTGatewayEntrance"]
}

in item file

String OMG_BLE_Entrance "BLE Entrance Detector" { channel="mqtt:topic:omgentrance:blepresence" }
Switch   Presence_Keys_Rick      "Rick's Keys"       <keyring>      (People, gKeys)        {expire="240s,OFF"}

In rule file:

rule "BLE Presence Detector"
when
Item OMG_BLE_Entrance received update
then
val String msg = (OMG_BLE_Entrance.state as StringType).toString
val String id  = transform("JSONPATH", "$.id", msg).toString
if(id == "xx:xx:xx:xx:xx:xx")
    Presence_Keys_Rick.postUpdate(ON)
end