mirror of
https://github.com/openhab/openhab-addons.git
synced 2025-01-11 15:42:10 +01:00
11ed1c3e66
* [mqtt] HomeAssistant: Doc: Add auto discovery with Tasmota * [mqtt] HomeAssistant: Doc: Minor formatting adjustments Signed-off-by: Moritz 'Morty' Strübe <morty@gmx.net>
38 lines
1.5 KiB
Markdown
38 lines
1.5 KiB
Markdown
# HomeAssistant MQTT Components Binding
|
|
|
|
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` |
|
|
|
|
## Requirements
|
|
|
|
The HomeAssistant MQTT requires two transformations to be installed:
|
|
|
|
* JINJA-Transformations
|
|
* JSONPath-Transformations
|
|
|
|
These can be installed under `Settings` → `Addon` → `Transformations`
|
|
|
|
## Limitations
|
|
|
|
* The HomeAssistant Fan Components only support ON/OFF.
|
|
* 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.
|