Skip to main content

MQTT Topics STABLE

Below table is a description of all MQTT topics that might be of use by a user. Replace <panel_name> with the friendly name of your NSPanel:

TopicPayloadDescription
nspanel/<panel_name>/screen_cmd1 or 0Send a 1 or 0 to turn on/off the display.
nspanel/<panel_name>/screen_state1 or 0Current state of the screen.
nspanel/<panel_name>/brightness1 to 100Control the brightness of the screen.
nspanel/<panel_name>/brightness_screensaver0 to 100Control the brightness of the screensaver.
nspanel/<panel_name>/r1_cmd1 or 0Send a 1 or 0 to turn on/off relay 1.
nspanel/<panel_name>/r1_state1 or 0The current state of relay 1.
nspanel/<panel_name>/r2_cmd1 or 0Send a 1 or 0 to turn on/off relay 2.
nspanel/<panel_name>/r2_state1 or 0The current state of relay 2.
nspanel/<panel_name>/temperature_stateCurrent temperatureThe current temperature reading.
nspanel/<panel_name>/screensaver_modescreensaver modeSelect what screensaver to display
Choose from the following:
- with_background
-without_background
-datetime_with_background
-datetime_without_background
or no_screensaver
nspanel/<panel_name>/logLog messageThe panel will send live logs on this topic.

There are more topics that are used internally, these are:

TopicPayloadDescription
nspanel/entities/<type>/<id>/state_<attribute>The value of the attributeAn update of entity state value sent out by MQTTManager. Example:nspanel/entities/light/42/state_kelvin
nspanel/status/timeTime as a stringCurrent time sent by MQTTManager.
nspanel/status/weatherJSONA JSON representation of the current weather and weather forecast.
nspanel/<panel_name>/status_reportJSONJSON payload with current state of the panel.
nspanel/<panel_name>/statusJSONJSON payload with current online/offline state of the panel.
nspanel/<panel_name>/commandJSONJSON payload with a command for the panel to execute.
nspanel/mqttmanager/commandJSONJSON payload from panel with a command for MQTTManager to perform.

MQTT Topics BETA

Below table is a description of all MQTT topics that might be of use by a user. Replace <mac> with the MAC-address of your NSPanel:

TopicPayloadDescription
nspanel/<mac>/screen_cmd1 or 0Send a 1 or 0 to turn on/off the display.
nspanel/<mac>/screen_state1 or 0Current state of the screen.
nspanel/<mac>/brightness_cmd1 to 100Control the brightness of the screen.
nspanel/<mac>/brightness_state1 to 100Current state of the brightness of the screen.
nspanel/<mac>/brightness_screensaver_cmd0 to 100Control the brightness of the screensaver.
nspanel/<mac>/brightness_screensaver_state0 to 100State of the brightness of the screensaver.
nspanel/<mac>/relay1_cmd1 or 0Send a 1 or 0 to turn on/off relay 1.
nspanel/<mac>/relay1_state1 or 0The current state of relay 1.
nspanel/<mac>/relay2_cmd1 or 0Send a 1 or 0 to turn on/off relay 2.
nspanel/<mac>/relay2_state1 or 0The current state of relay 2.
nspanel/<mac>/temperatureCurrent temperatureThe current temperature reading.
nspanel/<mac>/screensaver_mode_cmdscreensaver modeSelect what screensaver to display
Choose from the following:
- with_background
-without_background
-datetime_with_background
-datetime_without_background
or no_screensaver
nspanel/<mac>/screensaver_mode_statescreensaver modeThe currently selected screensaver mode
nspanel/<mac>/logLog messageThe panel will send live logs on this topic.

Below are more topics that are used internally. Replace <manager_address> with the IP address of the manager container.

TopicPayloadDescription
nspanel/mqttmanager_<manager_address>/status/timeTime as a stringCurrent time sent by MQTTManager.
nspanel/mqttmanager_<manager_address>/status/dateDate as a stringCurrent date sent by MQTTManager.
nspanel/mqttmanager_<manager_address>/status/weatherProtobufA protobuf representation of the current weather and weather forecast.
nspanel/<mac>/status_reportProtobufProtobuf payload with current state of the panel.
nspanel/<mac>/statusJSONJSON payload with current online/offline state of the panel.
nspanel/<mac>/commandJSONJSON payload with a command for the panel to execute.
nspanel/mqttmanager_<manager_address>/commandProtobufProtobuf payload from panel with a command for MQTTManager to perform.
nspanel/mqttmanager_<manager_address>/room/<room_id>/stateProtobufProtobuf payload from the manager that represents the "Home page" state to display on the NSPanel for the given room.
nspanel/mqttmanager_<manager_address>/all_rooms_stateProtobufProtobuf payload from the manager that represents the "Home page" state to display on the NSPanel when in "All rooms" mode.
nspanel/mqttmanager_<manager_address>/all_rooms_stateProtobufProtobuf payload from the manager that represents the "Home page" state to display on the NSPanel when in "All rooms" mode.
nspanel/mqttmanager_<manager_address>/entity_pages/<page_id>/stateProtobufProtobuf payload from the manager that represents the "Entities"/"Scenes" state to display on the NSPanel when.
nspanel/mqttmanager_<manager_address>/relay_groups/<group_id>/state1 or 0Current state of the relay group binding 1 for "ON" and 0 for "OFF".
nspanel/mqttmanager_<manager_address>/entities/lights/<light_id>/stateProtobufCurrent state of the light.