public
/
openhab-addons
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

[mqtt] Add documentation about using auto discovery with Tasmota (#12003) 

* [mqtt] HomeAssistant: Doc: Add auto discovery with Tasmota
* [mqtt] HomeAssistant: Doc: Minor formatting adjustments

Signed-off-by: Moritz 'Morty' Strübe <morty@gmx.net>
This commit is contained in:
Moritz 'Morty' Strübe 2022-01-11 13:25:27 +01:00 committed by GitHub
parent 682cb8a1b5
commit 11ed1c3e66
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 19 additions and 9 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

28
bundles/org.openhab.binding.mqtt.homeassistant/README.md
View File

@ -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` |
| &rarr; 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` &rarr; `Addon` &rarr; `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` &rarr; `MQTT`: You must have unique `Client` name and `Topic` (should be the default).
* `Configuration` &rarr; `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.