📦

Installation Guide

Everything you need to get EMS-ESP up and running

🔧 Required Hardware

🔌

ESP32 Development Board

The EMS-ESP firmware runs on an ESP32 module from Espressif. The chipsets ESP32-S, ESP32-S2, ESP32-S3 and ESP32-C3 are supported.

See the post here on which development boards we have tested against.

ESP32 Development Boards
🔗

EMS Interface Board

EMS-ESP also requires a separate circuit to read and write to the EMS bus. You can either build your own or purchase a EMS Gateway board directly from BBQKees Electronics.

EMS Gateway S3 EMS Gateway E32 V2

🚀 Installing EMS-ESP

📥 Download & Install

Click the link below to go to the download page and see the multiple methods available to install the firmware onto your ESP32 board.

Install Firmware

⚠️ Important Notice

Pay attention to the Change Log before upgrading so you are aware of any breaking changes.

💾 Backup Recommendation

If you are upgrading from a previous release it's recommended you make a backup copy of any settings and configurations before performing the installation. This can be done from the WebUI Settings page 'Download/Upload'.

💡 LED Status Indicators

When EMS-ESP starts-up and is running, the onboard LED will show the system status.

🔄 During Boot Sequence

1 Flash

EMS bus is not yet connected. If this takes more than a few seconds check the EMS Tx Mode and the physical connection to the EMS bus.

2 Flashes

Network (WiFi or Ethernet) is connecting. If this persists check the EMS-ESP Network settings. EMS-ESP uses 2.4GHz/WPA2 only.

3 Flashes

Both the EMS bus and Network are still trying to connect. This could be due to an incorrect EMS-ESP Board Profile setting.

✨ During Normal Operation

Unless the LED has been disabled in the settings, the LED will show the system status.

Steady Light

Good connection and EMS data is flowing in.

Slow Pulse

Either the WiFi or the EMS bus are still connecting.

Fast Pulse

System is booting up and configuring itself.