Overview of all web interface settings EMS-ESP V3.4¶

There’s a whole range of other settings you can make from within the web interface. Most speak for themselves. Below an overview of all pages. With each new firmware version features are added and sometimes removed. There are so many new features with each release, they might not be explained below yet.

The pages below are based on the V3.4 firmware of EMS-ESP32. The upcoming firmware V3.5 will supprt localization. This means you can switch the language to f.i. Dutch or German.

Dashboard¶

The dashboard page provides a more detailed overview of the status of the Gateway.

Devices and Sensors¶

The Devices and Sensors tab gives you an overview of all devices found on the EMS bus. If you are missing a device, press the ‘Scan Devices’ button.

If you connected DS18B20 sensors these are listed as well.

If you click on one of the devices you get all the details that are reported over the EMS bus:

EMS Status¶

The EMS Status tab gives you information if the bus is connected correctly.

Settings¶

On the EMS-ESP settings page you can change the Tx mode and change the Bus ID of the Gateway. Also you can turn on the Shower Timer and Shower Alert features which give a notification of shower duration in Home Assistant and a cold burst of water after a few minutes.

Board profile¶

EMS-ESP32 V3 works with board profiles. These are sets of predefined pin and Ethernet configuration files.

If you are using a custom pinout, choose ‘Custom’and set your own pins:

EMS bus settings¶

TX mode¶

Here you can set the EMS TX mode to one of three options:

EMS -> General setting for most boilers/ heat pumps.
EMS+ -> For some newer boilers/heat pumps.
HT3 -> Heatronic 3 mode for Junkers.

Bus ID¶

The Gateway has an address on the EMS bus called a Bus ID. It can be changed here if needed. The default is Service key (0x0B).

General options¶

Hide Led -> The blue LED will be turned off by default.
Enable Telnet Console -> Enable the Telnet interface on port 23.
Enable analog sensors -> EMS-ESP support analog sensors but the use is not really documented yet.
Convert temperature values to Fahrenheit -> Switch between Celcius and Fahrenheit.
Underclock CPU speed -> By underclocking the Gateway it becomes a slightly more energy efficient.
Bypass Access Token authorization on API calls -> To use the API you need to send an access token on each call.
This can be turned off, but is also means you make the system less secure.
Enable Read only mode -> This mode will only listen to incoming telegrams. No telegrams are sent by the Gateway.
This also means it’s hard to detect devices on the bus, and you cannot interact with devices in any way.
Enable Shower Timer -> On some Nefit boiler you can use this function for sending a cold burst of water after 3 minutes of showering.
Enable Shower Alert -> This option times the use of hot tap water and sends a notification to Home Assistant.

Formatting options¶

Here you can change the formats used in MQTT and the API.

Temperature sensors¶

If you use the DS18B20 sensors in parasitic mode you need to turn it on here.

Logging¶

Turn on Syslog etc.

Customization¶

Firmware 3.4 introduces a new feature called ‘customization’. With this feauture you can turn on or off each entity for a EMS device, so that they will be included or excluded from MQTT and the API. In firmware 3.5 language features are added as well.

EMS-ESP Help¶

This page provides links to the help function.

Network Connection¶

Network Status¶

The Network Status tab gives you all the network status and parameters.

Scan WiFi Networks¶

Scan WiFi networks provides the option to scan and select a specific WiFi network.

Network Settings¶

The WiFi Settings tab gives you the network teh Gateway is currently connected to. You can also set the Wi-Fi password, network Hostname and set a static IP address.

Access Point¶

Access Point Status¶

The Access Point Status tab gives you the status of the internal access point of the Gateway.

Access Point Settings¶

You can set the AP Wi-Fi name and password and other network settings.

Network Time¶

NTP Status¶

The NTP Status tab gives you information about the network time status.

NTP Settings¶

MQTT¶

MQTT Status¶

The MQTT Status tab gives you information about the MQTT connection to the broker.

MQTT Settings¶

Here you can set a lot of MQTT related parameters.

MQTT Formatting¶

MQTT Discovery is supported by Home Assistant and recent Domoticz beta versions.

Turn on MQTT Discovery to have HA or Domoticz detect all entities automatically. For Domoticz and other systems you can change the topic prefix as well.

Publish Intervals¶

Here you van change the interval for which each entity group is published over MQTT.

Security¶

Manage users¶

Add or remove users of EMS-ESP.

Security Settings¶

Here you can change the super user password. This password is used to sign authentication tokens and also enable admin privileges within the Console.

System¶

System Status¶

See the status of a lot of ESP parameters. You can also reboot the Gateway here or perform a factory reset.

OTA Settings¶

Here you can set OTA (Over the Air) firmare upgrade parameters. With this function you can upload new firmware via WiFi directly from Platform IO to the ESP module.

Update firmware¶

On this page you can update the firmware of the Gateway. First you can download the latest stable version and then upload the bin file or another bin file to the Gateway.

If your Gateway works fine and there are no significant new features, its not recommended to update the firmware just for the sake of updating. Some firmware versions are not stable and can give stability issues.

Also if you have an E32 gateway do not do firmware updates remotely, only when you are near the Gateway. In some cases the board profile may reset to the S32 and you’ll lose Ethernet until you login via WiFi and set it to S32.