openhab-addons/bundles/org.openhab.binding.mqtt.homeassistant
Sami Salonen 2fd2e5175f
[mqtt.homeassistant] Stable jsondb discovery result (#13401)
* [mqtt.homeassistant] Stable jsondb serialization for discovery results

Similar to openhab/openhab-core#2436, we want
to have consistent ordering of data in JSONDB. This is fixing the jsondb
order for mqtt.homeassistant discovery results, specifically, the
"topics" property.

* [mqtt.homeassistant] order using full topic string, not by subcomponent

Signed-off-by: Sami Salonen <ssalonen@gmail.com>
2022-09-18 18:20:49 +02:00
..
src [mqtt.homeassistant] Stable jsondb discovery result (#13401) 2022-09-18 18:20:49 +02:00
NOTICE Fix links and NOTICE files (#9860) 2021-01-18 21:49:06 +01:00
pom.xml Apply spotless and resolver (#13027) 2022-06-27 16:00:37 +02:00
README.md [mqtt] Add documentation about using auto discovery with Tasmota (#12003) 2022-01-11 13:25:27 +01:00

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.