Skip to content

Autodiscovery

Jacek Ziółkowski edited this page Sep 15, 2024 · 6 revisions

Important

To use this feature, Topic must be a single word, ex. sonoff and not a compound topic, ex. bathroom/sonoff. If you want/use granular, specific topics, add that to FullTopic instead.

MQTT "+" wildcard is supported (and only this one)


TDM automatically discovers Tasmota devices which follow these FullTopics:

Tasmota default

%prefix%/%topic%/

Tasmota with SetOption19 enabled for HomeAssistant auto-discovery

%topic%/%prefix%/

The FullTopic pattern affects how the LWT topic is constructed and this in turn affects the autodiscovery process. Since TDM doesn't have the option to manually add devices (because it doesn't have to), to make sure that your devices with custom FullTopics are discovered, you must add these FullTopics to config. You can do it using the dialog found in MQTT -> Autodiscovery patterns menu.

image

As the message says, the two default FullTopics are included, so you only need to add your customized ones.

There are two way to do that:

  • if you want to support every custom fulltopic, you can simply replace the changing part in your fulltopic with +.

For example, if you have devices with bedroom/%prefix%/%topic%/, garage/%prefix%/%topic%/ and kitchen/%prefix%/%topic%/, just add +/%prefix%/%topic%/ in the dialog.

  • if you need granular control, you need to specifically add every pattern you want to listen for.

To make sure they are added correctly, simply copy and paste the entire FullTopic from your device config, found in WebUI in Configuration -> Configure MQTT, right by the Save button:

image

After adding your custom FullTopics, reconnect to broker via MQTT menu in TDM, or simply restart the application.

Clone this wiki locally