Skip to content

MQTTTopics

olialb edited this page Jun 8, 2026 · 2 revisions

Exposed MQTT topics and usage

The MQTT client is exposing the following topics. Note: {rootTopic} in this section must be replaced with the root topic defined in the [global] section of the ini file. The {panelName} is taken from the [panels] section.

brightness (numeric)

The current brightness of the display is exposed with the topic {rootTopic}/{panelName}/brightness. The value is a percentage value from 0 to 100. A new brigtness value can be set over the command topic {rootTopic}/{panelName}/brightness/set or over {rootTopic}/brightness/set to change the value in all connected panels.

brightness_saver (numeric)

The current brightness of the display when the screensaver is active is exposed with the topic {rootTopic}/{panelName}/brightness_saver. The value is a percentage value from 0 to 100. A new brigtness value for the screensaver can be set over the command topic {rootTopic}/{panelName}/brightness_saver/set or over {rootTopic}/brightness_saver/set to change the value in all connected panels.

timeout (numeric)

The current timeout in seconds until the screensaver is activated is published in {rootTopic}/{panelName}/timeout. 0=no timeout. A new timeout value can be set over the command topic {rootTopic}/{panelName}/timeout/set or over {rootTopic}/timeout/set to change the value in all connected panels.

card (string)

The current active card in the panel is published in format groupName/cardName over {rootTopic}/{panelName}/card. A new card value can be set over the command topic {rootTopic}/{panelName}/card/set or over {rootTopic}/card/set to change to the same card in all connected panels.. You can set the groupname and card name with the format groupName/cardName or just the card in current group with cardName

status_left (switch)

Status of the left status slot in the screensaver (ON/OFF): {rootTopic}/{panelName}/status_left. The status can be set over {rootTopic}/{panelName}/status_left/set ON and OFF or over {rootTopic}/status_left/set to change the value in all connected panels.

image

status_right (switch)

Status of the right info status in the screensaver (ON/OFF): {rootTopic}/{panelName}/status_right. The status can be set over {rootTopic}/{panelName}/status_right/set ON and OFF or over {rootTopic}/status_right/set to change the value in all connected panels.

image

status_card (string)

Shows the active status card for the status slots of the screensaver: {rootTopic}/{panelName}/status_card. The card can be set over {rootTopic}/{panelName}/status_card/set or over {rootTopic}/status_right/set to change the status card in all connected panels.

image

notification (string)

You can send a string with a notification message while the screensaver is active. The message consist of a title and a text seperated by a '|'

Example notification: "Warning|Change battery in windows sensor bed room!"

Last value is published over {rootTopic}/{panelName}/notification. You can send a new notification to a specific panel: {rootTopic}/{panelName}/notification/set or to all connected panels: {rootTopic}/notification/set

image

version (json)

The panel type EU, US,... and the HMI version flashed in the panel are published in json format. The data is read only. Topic: {rootTopic}/{panelName}/version

Clone this wiki locally