When MQTT is enabled EMS-ESP will publish MQTT topics for each device. The frequency can be configured from the WebUI to be either sent when data changes are dected or set to a specific period in seconds which is kinder on network traffic.
When MQTT Discovery is enabled, EMS-ESP will automatically create a special Discovery topics (with
/config) for each EMS device entity that has received a valid value in EMS-ESP. If the entity should disappear (i.e. no longer has a valid value in an EMS telegram) then the discovery topic is automatically removed. This is to avoid warnings in systems like Home Assistant. When EMS-ESP starts all prior Discovery topics are removed to keep system clean.
When a value is a boolean it will be rendered according to the Boolean setting you have defined in the settings.
The table below list the topics being published. The format shown in the table below is the MQTT Format as defined in EMS-ESP's settings. Default format is
Nested which uses a single topic to show multiple entries in the payload. Format
Single will send each group as single payloads on multiple topics.
| ||n/a||this is the MQTT will and testament messages|| |
| ||n/a||for events|| |
| ||all||system stats in JSON, default is every minute|| |
| ||all||boolean to show if the hot tap water is running (DHW)|
| ||all||boolean to show if the heating is on|
| ||all||non warm water data from the Boiler device|| |
| ||all||warm water data from the Boiler device|| |
| ||nested||data from the thermostat and for each of its Heating Circuits.|| |
| ||single||In single format each heating circuit is published with own topic|| |
| ||single||hc in single format|| |
| ||nested||data from The Mixer with nests || |
| ||single||data from The Mixer in single format for each of its Heating Circuits where || |
| ||the shower timer and alert toggles plus the duration of the last shower taken|| |
| ||all||all data from the Solar Module (if connected)|| |
| ||nested||temperature readings from any external Dallas temperature sensors attached to the ESP|| |
| ||single||temperature readings from Dallas temperature sensor in single format with unique sensor id|| |
| ||nested||readings from external analog sensors|| |
Using MQTT to send commands~
Refer to the Commands Section for how to use MQTT to send commands to EMS-ESP.
Monitoring the Queue~
If you want more precise monitoring of the MQTT traffic I suggest using MQTT Explorer. The console command
show mqtt will show the status of the MQTT service and also the topic subscriptions and outbound publishing queue. In the WebUI you can see the size of the queue and overall stats are in the