diff --git a/docs/source/Plugin/DataAcquisition.repl b/docs/source/Plugin/DataAcquisition.repl index b75783dc4..59501345a 100644 --- a/docs/source/Plugin/DataAcquisition.repl +++ b/docs/source/Plugin/DataAcquisition.repl @@ -28,15 +28,17 @@ For each controller the user can select wether the data should be sent on each I For the Domoticz controllers the value index (IDX) has to be configured. -For some controllers, like Home Assistant/openHAB, there are extra options available. +For some controllers, like Home Assistant (openHAB) MQTT, there are extra options available. * **Group**: This represents the group id to combine all values from multiple tasks into a single grouped-device during MQTT AutoDiscovery. Groups, by design, can span multiple ESPEasy devices, if desired, as long as the Task/Valuename combinations are unique. If a group should only combine Tasks from a single ESPEasy unit, the group id should be unique across multiple ESPEasy units. The group description, default *Group *, can be adjusted in Home Assistant. If the Group value matches the current Unit nr, the Unit name, ``%sysname%``, is used instead of Group . + * When **Group** is used, the Discovery unique id, by default, *doesn't* include the taskname, causing devices with the same Value name in the same group to be overwritten in the MQTT broker. By setting the checkbox **MQTT Discover, Group incl. Taskname** on the Tools/Advanced page, the unique id will be made 'more unique' by including the Taskname. (Not enabled by default for backward compatibility). + * **Retained**: For MQTT Controllers, this setting can be enabled to send the values for the current task with the Retain flag set. The **Publish Retain flag** in the Controller settings will override this by sending *all* task values with Retain flag enabled. * **Send derived**: This checkbox determines if any configured Derived values should also be sent to the controller (and included in the AutoDiscovery if that's available and enabled). -* **Resend MQTT Discovery**: When checked, will start a resend of the MQTT Discovery process for this task after a random delay, when Submit is clicked, so any changed settings will be updated in the MQTT broker. This setting is only available if the controller is enabled, the Auto Discovery feature is available and enabled for the controller. This setting is not stored. +* **Resend MQTT Discovery**: When checked, will initiate a resend of the MQTT Discovery process for this task after a random delay after Submit is clicked, so any changed settings will be updated in the MQTT broker. This setting is only available if the controller is enabled, the Auto Discovery feature is available and enabled for the controller. This setting is not stored. Other controllers, like f.e. FHEM HTTP, do not support additional settings besides the checkbox to enable sending the data. diff --git a/docs/source/Plugin/Task_config_page_Controllers_section.png b/docs/source/Plugin/Task_config_page_Controllers_section.png index d9333203e..50efecb47 100644 Binary files a/docs/source/Plugin/Task_config_page_Controllers_section.png and b/docs/source/Plugin/Task_config_page_Controllers_section.png differ diff --git a/docs/source/Tools/Tools.rst b/docs/source/Tools/Tools.rst index 0e4ceda53..2c23b0a79 100644 --- a/docs/source/Tools/Tools.rst +++ b/docs/source/Tools/Tools.rst @@ -492,6 +492,16 @@ Depending on the internet connection, f.e. when connecting via a low-end mobile On ESP32, tasks like starting the MQTT connection can be delegated to an independent background task, to avoid blocking the normal working of ESPEasy, that will report the result when completed. This feature is enabled by default, as it is the preferred setting, but when this way of connecting is causing issues, it can be disabled. +MQTT Discover, Group incl. Taskname +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +Added: 2026-08-14 + +To make the unique-id for Auto Discovery more unique when a Group is used, the Taskname can be inserted by enabling this option. Not enabled by default for backward compatibility with existing groups Auto-discovered by Home Assistant. + +Only enabled if MQTT Auto Discovery is included in the build. + + Allow OTA without size-check ^^^^^^^^^^^^^^^^^^^^^^^^^^^^