mirrors
/
Tasmota
mirror of https://github.com/arendst/Tasmota.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

Updated Home Assistant (markdown)

blakadder 2019-04-10 08:44:20 +02:00
parent e23d2529f1
commit 9b303537be
1 changed files with 4 additions and 9 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

13
Home-Assistant.md

@ -65,16 +65,11 @@ On each Tasmota device which should be automatically discovered by Hass, enter t
By executing command `SetOption19 1` the automatic discovery feature is enabled and a retained MQTT message starting with topic "homeassistant/..", as defined in user_config.h HOME_ASSISTANT_DISCOVERY_PREFIX, is sent containing parameters used by Home Assistant to automatically configure a device. By executing command `SetOption19 1` the automatic discovery feature is enabled and a retained MQTT message starting with topic "homeassistant/..", as defined in user_config.h HOME_ASSISTANT_DISCOVERY_PREFIX, is sent containing parameters used by Home Assistant to automatically configure a device.
To disable the automatic discovery feature and remove the retained message, execute command `SetOption19 0` and the homeassistant topic is removed from the MQTT server.\ To disable the automatic discovery feature and remove the retained message, execute command `SetOption19 0` and the homeassistant topic is removed from Home Assistant and MQTT broker.\ Device topic will not revert to defaults, you have to manually change back the topic structure to `%prefix%/%topic%/` in [**MQTT Configuration**](MQTT).
Note: This will also remove the device from Home Assistant.
#### :warning: Important:
#### Important: This feature will change the default Tasmota topic `%prefix%/%topic%/COMMAND`, e.g. `cmnd/sonoff/POWER` to `%topic%/%prefix%/COMMAND`, e.g. `sonoff/cmnd/POWER`.
To keep MQTT discovery messages short, "base topic" feature is used.\ You cannot use custom defined topics while `Setoption19` is on since it will always revert it to `%topic%/%prefix%` due to Home Assistant requirements.
This feature is not compatible with the default Tasmota topic `prefix/topic/COMMAND`, e.g. `cmnd/sonoff/POWER`\
The topic will automatically be changed to `topic/prefix/COMMAND`, e.g. `sonoff/cmnd/POWER`\
If you want to use a custom `fulltopic`, it MUST end with `%prefix%/` or it will be overwritten with `topic/prefix/COMMAND`.\
This is an example of an allowed `fulltopic`: `tasmota/%topic%/%prefix%/`.
## Setup Tasmota devices through Home Assistant ## Setup Tasmota devices through Home Assistant
All automatically discovered entities will show up under:\ All automatically discovered entities will show up under:\