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 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: The mapping is structured like this:
| HA MQTT | Framework | Example MQTT topic |
| HA MQTT | Framework | Example MQTT topic | | ------------------------- | ------------- | ------------------------------------- |
|-----------------------|---------------|------------------------------------| | Object | Thing | `homeassistant/../../object` |
| Object | Thing | homeassistant/../../object | | Component+Node | Channel Group | `homeassistant/component/node/object` |
| Component+Node | Channel Group | homeassistant/component/node/object| | &rarr; Component Features | Channel | `state/topic/defined/in/comp/config` |
| -> Component Features | Channel | state/topic/defined/in/comp/config |
## Requirements ## Requirements
The HomeAssistant MQTT requires two transformations to be installed: The HomeAssistant MQTT requires two transformations to be installed:
* JINJA-Transformations * JINJA-Transformations
* JSONPath-Transformations * JSONPath-Transformations
These can be installed under Settings->Addons->Transformations These can be installed under `Settings` &rarr; `Addon` &rarr; `Transformations`
## Limitations ## Limitations
@ -25,3 +24,14 @@ These can be installed under Settings->Addons->Transformations
* The HomeAssistant Cover Components only support OPEN/CLOSE/STOP. * The HomeAssistant Cover Components only support OPEN/CLOSE/STOP.
* The HomeAssistant Light Component only supports RGB color changes. * The HomeAssistant Light Component only supports RGB color changes.
* The HomeAssistant Climate Components is not yet supported. * 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.