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 14:03:11 +01:00
parent 7bdae8569b
commit 04c7f3ea1b
1 changed files with 7 additions and 5 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

12
openHAB.md

@ -28,18 +28,20 @@ The screenshot of an openHAB Sitemap below features a few Sonoff modules for lig
**Highly recommended:** If you are new to openHAB + MQTT, go through this tutorial: <br>
⇨ [MQTT Binding - Getting Started 101](https://community.openhab.org/t/mqtt-binding-v1-11-getting-started-101/33958)
If not done yet, you first need to **install and activate** the [MQTTv1](https://www.openhab.org/addons/bindings/mqtt1/)/[MQTTv2](https://www.openhab.org/addons/bindings/mqtt/)&ast;, 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.
#### MQTT Binding Note
**&ast; MQTTv1 vs. MQTTv2 Binding Info:**
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.
This article currently applies to the openHAB 1 version of the MQTT Binding (`mqtt1`). The openHAB community has just release a new native openHAB 2 MQTT Binding, which complies with enhancements and significantly changes.
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.
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.
For users that intend to migrate to mqttv2 some examples for the integration have been added at the end ("Examples for integration with MQTTv2").
Fortunately, the mqttv1 Binding can be reinstalled. To do so, turn on "Include Legacy 1.x Bindings" via PaperUI (Configuration > System) or set `legacy = true` in `addons.cfg`. Then reinstall 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 the new MQTT Binding some examples for the integration have been added [at the end of this article](#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.
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".