openhab-addons/bundles/org.openhab.binding.mqtt.homeassistant/README.md
Moritz 'Morty' Strübe 11ed1c3e66
[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>
2022-01-11 13:25:27 +01:00

1.5 KiB

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 SettingsAddonTransformations

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:

  • ConfigurationMQTT: You must have unique Client name and Topic (should be the default).
  • ConfigurationOther: 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.