From 11ed1c3e66c4bccd34e2724d3f7fb8120b00ca5f Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Moritz=20=27Morty=27=20Str=C3=BCbe?= Date: Tue, 11 Jan 2022 13:25:27 +0100 Subject: [PATCH] [mqtt] Add documentation about using auto discovery with Tasmota (#12003) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit * [mqtt] HomeAssistant: Doc: Add auto discovery with Tasmota * [mqtt] HomeAssistant: Doc: Minor formatting adjustments Signed-off-by: Moritz 'Morty' Strübe --- .../README.md | 28 +++++++++++++------ 1 file changed, 19 insertions(+), 9 deletions(-) diff --git a/bundles/org.openhab.binding.mqtt.homeassistant/README.md b/bundles/org.openhab.binding.mqtt.homeassistant/README.md index 6c84cbbc2..409a78875 100644 --- a/bundles/org.openhab.binding.mqtt.homeassistant/README.md +++ b/bundles/org.openhab.binding.mqtt.homeassistant/README.md @@ -1,23 +1,22 @@ # HomeAssistant MQTT Components Binding -HomeAssistant MQTT Components are recognized as well. The base topic needs to be **homeassistant**. +HomeAssistant MQTT Components are recognized as well. The base topic needs to be **homeassistant**. The mapping is structured like this: - -| HA MQTT | Framework | Example MQTT topic | -|-----------------------|---------------|------------------------------------| -| Object | Thing | homeassistant/../../object | -| Component+Node | Channel Group | homeassistant/component/node/object| -| -> Component Features | Channel | state/topic/defined/in/comp/config | +| HA MQTT | Framework | Example MQTT topic | +| ------------------------- | ------------- | ------------------------------------- | +| Object | Thing | `homeassistant/../../object` | +| Component+Node | Channel Group | `homeassistant/component/node/object` | +| → Component Features | Channel | `state/topic/defined/in/comp/config` | ## Requirements The HomeAssistant MQTT requires two transformations to be installed: -* JINJA-Transformations +* JINJA-Transformations * JSONPath-Transformations -These can be installed under Settings->Addons->Transformations +These can be installed under `Settings` → `Addon` → `Transformations` ## Limitations @@ -25,3 +24,14 @@ These can be installed under Settings->Addons->Transformations * The HomeAssistant Cover Components only support OPEN/CLOSE/STOP. * The HomeAssistant Light Component only supports RGB color changes. * The HomeAssistant Climate Components is not yet supported. + +## Tasmota auto discovery + +To activate HomeAssistant discovery support on your Tasmota device you need to do the following: + +* `Configuration` → `MQTT`: You must have unique `Client` name and `Topic` (should be the default). +* `Configuration` → `Other`: The `Device Name` will be used to identify the newly found device. + And you need to enable MQTT, of course. +* `Console`: Enter `SetOption19 1`. + +Your Tasmota device should now show up in your inbox.