demus/openhab-addons
1
0
Fork 0
mirror of https://github.com/openhab/openhab-addons.git synced 2025-01-10 23:22:02 +01:00
Code Issues Packages Projects Releases Wiki Activity
936365031c
openhab-addons/bundles/org.openhab.binding.mqtt.homeassistant
History
Cody Cutrer 98677c18b3
[mqtt.homeassistant] ensure availability topics get subscribed (#13466) 
HASS registers availability topics before calling start(), so
the AbstractMQTTThingHandler was never subscribing/starting the
availability channel(s). So do so in start() of the base class.

I checked other implementations, and either they already handle
re-registering availabilityTopics in their start()
(GenericMQTTThingHandler), or they don't use availabilityTopics
at all from the base class and manage it themselves (Homie).

Note that this shows up as newly-added HASS things not having
a problem (because the components aren't discovered until after
the ThingHandler is started), but if you restart OpenHAB or
disable/enable the thing, the channels (and components) are
cached, thus how availabilityTopics are known before starting.

Signed-off-by: Cody Cutrer <cody@cutrer.us>
2022-10-08 09:12:28 +02:00
..
src [mqtt.homeassistant] ensure availability topics get subscribed (#13466) 2022-10-08 09:12:28 +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

README.md

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.