mirrors
/
Tasmota
mirror of https://github.com/arendst/Tasmota.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

Updated openHAB (markdown)

Thomas Dietrich 2018-12-25 12:04:25 +01:00
parent 2506ecbfd1
commit ac5e6202e2
1 changed files with 10 additions and 7 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

17
openHAB.md

@ -1,10 +1,3 @@
**NOTE**
This information applies to the openHAB1 version of the MQTT binding (mqttv1). openHAB has release a new MQTT binding (mqttv2) which complies with openHAB2 enhancements and significantly changes the way the binding is configured. Be aware that if you update your openHAB instance, the new MQTT binding will be installed and mqttv1 will be uninstalled! This means that any MQTT openHAB automations in your openHAB environment will exhibit odd behavior or not operate at all.
Fortunately, the mqttv1 binding can be installed again. To do so, set 'legacy = true' in addons.cfg or turn on 'Include Legacy 1.x Bindings' in PaperUI (Configuration > System). Then re-install the mqttv1 binding. Please note that now that mqttv1 is a legacy binding, it will no longer receive updates or fixes. Installing both versions of the binding will allow you to migrate over time to be ready for the eventuality of mqttv1 end of life.
For users that intend to migrate to mqttv2 some examples for the integration have been added at the end ("Examples for integration with MQTTv2").
## openHAB Integration ## openHAB Integration
@ -36,6 +29,16 @@ The screenshot of an openHAB Sitemap below features a few Sonoff modules for lig
⇨ [MQTT Binding - Getting Started 101](https://community.openhab.org/t/mqtt-binding-v1-11-getting-started-101/33958) ⇨ [MQTT Binding - Getting Started 101](https://community.openhab.org/t/mqtt-binding-v1-11-getting-started-101/33958)
#### MQTT Binding Note
This information applies to the openHAB1 version of the MQTT binding (mqttv1). openHAB has release a new MQTT binding (mqttv2) which complies with openHAB2 enhancements and significantly changes the way the binding is configured. Be aware that if you update your openHAB instance, the new MQTT binding will be installed and mqttv1 will be uninstalled! This means that any MQTT openHAB automations in your openHAB environment will exhibit odd behavior or not operate at all.
Fortunately, the mqttv1 binding can be installed again. To do so, set 'legacy = true' in addons.cfg or turn on 'Include Legacy 1.x Bindings' in PaperUI (Configuration > System). Then re-install the mqttv1 binding. Please note that now that mqttv1 is a legacy binding, it will no longer receive updates or fixes. Installing both versions of the binding will allow you to migrate over time to be ready for the eventuality of mqttv1 end of life.
For users that intend to migrate to mqttv2 some examples for the integration have been added at the end ("Examples for integration with MQTTv2").
----
If not done yet, you first need to **install and activate** the [MQTT binding](https://www.openhab.org/addons/bindings/mqtt1/), the [MQTT action](https://www.openhab.org/addons/actions/mqtt/) and the [JsonPath transformation](https://www.openhab.org/addons/transformations/jsonpath/), e.g. via the openHAB Paper UI Add-ons section. If not done yet, you first need to **install and activate** the [MQTT binding](https://www.openhab.org/addons/bindings/mqtt1/), the [MQTT action](https://www.openhab.org/addons/actions/mqtt/) and the [JsonPath transformation](https://www.openhab.org/addons/transformations/jsonpath/), e.g. via the openHAB Paper UI Add-ons section.
Before continuing, please make sure you assigned **unique MQTT "Topics"** in the Sonoff-Tasmota configuration interface of each Sonoff module. The default MQTT topic is "sonoff", in the examples below we will use names like "sonoff-A00EEA". Before continuing, please make sure you assigned **unique MQTT "Topics"** in the Sonoff-Tasmota configuration interface of each Sonoff module. The default MQTT topic is "sonoff", in the examples below we will use names like "sonoff-A00EEA".