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)

emontnemery 2018-12-22 09:08:48 +01:00
parent c0826f6888
commit 397f64ba0a
1 changed files with 5 additions and 6 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

11
Home-Assistant.md

@ -61,7 +61,11 @@ On each Tasmota device which should be automatically discovered by Hass, enter t
`SetOption19 1` - Enables MQTT discovery\ `SetOption19 1` - Enables MQTT discovery\
`SetOption55 1` - Enables [abbreviations and base topic](https://www.home-assistant.io/docs/mqtt/discovery/) to shorten the MQTT discovery messages. **Important**: Without `SetOption55 1`, full integration with Hass such as Setup of devices through Hass Web UI (change name and `entity_id`) is not enabled. `SetOption55 1` - Enables [abbreviations and base topic](https://www.home-assistant.io/docs/mqtt/discovery/) to shorten the MQTT discovery messages. **Important**: Without `SetOption55 1`, full integration with Hass such as Setup of devices through Hass Web UI (change name and `entity_id`) is not enabled.
By executing command `SetOption19 1` the 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 feature and remove the retained message, execute command `SetOption19 0` and the homeassistant topic is removed from the MQTT server.\
Note: This will also remove the device from Home Assistant.
#### Important: #### Important:
To keep MQTT discovery messages short, "base topic" feature is used.\ To keep MQTT discovery messages short, "base topic" feature is used.\
@ -70,11 +74,6 @@ The topic will automatically be changed to `topic/prefix/COMMAND`, e.g. `sonoff/
If you want to use a custom `fulltopic`, it MUST end with `%prefix%/` or it will be overwritten with `topic/prefix/COMMAND`.\ 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%/`. This is an example of an allowed `fulltopic`: `tasmota/%topic%/%prefix%/`.
To disable this feature and get rid of the retained message execute command SetOption19 0 and the homeassistant topic is removed from the MQTT server.
Note: This will also remove the device from Home Assistant.
## 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:\
Configuration -> Integrations -> Configured -> MQTT\ Configuration -> Integrations -> Configured -> MQTT\