openhab-addons/bundles/org.openhab.binding.mqtt.homeassistant
Sami Salonen 295df504c8
[mqtt.homeassistant] More readable label for discovered things (#13402)
* [mqtt.openassistant] Better labels for discoverd things

This PR introduces more simple label for things, instead of
"My Sensor (Sensor, Sensor, Sensor, Sensor, Sensor, Switch)" we have
simply "Me Sensor (5x Sensor, Switch)".

Signed-off-by: Sami Salonen <ssalonen@gmail.com>
2022-09-18 21:22:06 +02:00
..
src [mqtt.homeassistant] More readable label for discovered things (#13402) 2022-09-18 21:22:06 +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.