Table of Contents

• Table of Contents

EMS BUS WI-FI GATEWAY

• EMS bus Wi-Fi Gateway
  • What is the EMS bus Wi-Fi Gateway?
    • How to setup the Gateway
• How does it work?
• Connecting a Gateway
  • Items in the box
  • Gateway models
• Connecting a Gateway S32 or S3 (Standard editions)
  • Gateway connectors
  • Preferred order of connection
  • Service jack
  • EMS/thermostat wires
    • First boot -> Check the LED
• Connecting a Gateway E32 V2 (Ethernet + WiFi Edition V2)
  • Gateway connectors
  • Preferred order of connection
  • Service jack
  • EMS/thermostat wires
    • First boot -> Check the LED
• Connecting a Gateway E32 (ESP32 Ethernet edition)
  • Gateway connectors
  • Preferred order of connection
  • Service jack
  • EMS/thermostat wires
  • Ethernet or WiFi
    • First boot -> Check the LED
• Connecting the Gateway to the boiler or heat pump side
  • Service jack
    • Service jack on boilers
    • Service jack on heat pumps
  • EMS/thermostat wires
    • First boot -> Check the LED
• Connecting the Gateway to specific boilers and heatpumps
  • Bosch
    • Condens
    • Other Bosch
  • Buderus
    • Logamatic
    • Logamax
    • Other Buderus
  • Nefit
    • 9000i
    • Trendline
    • Topline
    • Proline
    • Baseline
    • Nefit Bosch Heat pumps
    • Smartline
  • Junkers
    • Cerapur
    • Other Junkers
  • Worcester
    • Greenstar 8000
    • Other Greenstar
    • Other Worcester
  • Sieger
    • BK15
• Connecting the Gateway to your home network
  • Accessing the web interface of the Gateway
  • Making the appropriate settings
  • Finding the IP address of the Gateway
    • Setting a fixed IP address
• Configuring MQTT
  • Check if you have a MQTT broker/server
  • Configuring MQTT
  • Making the appropriate settings for EMS-ESP
    • MQTT server address and configuration
  • Seeing if it works
• Observing EMS bus signal quality
  • EMS bus connection status
  • EMS bus signal quality
• Overview of all web interface settings EMS-ESP V3.4
  • Dashboard
    • Devices and Sensors
    • EMS Status
  • Settings
    • Board profile
    • EMS bus settings
    • General options
    • Formatting options
    • Temperature sensors
    • Logging
    • Customization
  • EMS-ESP Help
  • Network Connection
    • Network Status
    • Scan WiFi Networks
    • Network Settings
  • Access Point
    • Access Point Status
    • Access Point Settings
  • Network Time
    • NTP Status
    • NTP Settings
  • MQTT
    • MQTT Status
    • MQTT Settings
  • Security
    • Manage users
    • Security Settings
  • System
    • System Status
    • OTA Settings
    • Update firmware
• Customization feature
• Scheduler feature
  • Example 1: Timer
  • Example 2: Weekly
• Using the Telnet interface
• Adding external temperature sensors
  • Supported sensors
  • Connecting sensors
    • Gateway S32 and E32
    • Gateway Premium, Premium II, Standard and Regular
    • Gateway 1st edition (round holes)
  • JST connector pinout older Gateways
  • Sensor pull up resistor
    • Resistor location Gateway S32
    • Resistor location Gateway E32
    • Resistor location older Gateways
  • Gateway configuration
    • Renaming sensors and offset
• Updating or downgrading the Gateway firmware
  • Updating firmware via the web interface
  • Using beta firmware
  • Downgrading firmware
  • Uploading the firmware via EMS-ESP Flasher flashtool
    • Gateway S3, S3-LR and E32 V2
    • Uploading
    • After flashing
    • Gateway S32
    • Gateway E32 V1 and V1.5 (gray enclosure)
    • Uploading
    • After flashing
  • Building and loading firmware via Platform IO
  • Loading firmware via the ESPtool
  • Loading firmware via OTA (Over The Air)
  • Troubleshooting
• Connecting multiple Gateways
  • Gateway configuration
  • Home automation configuration
    • Home Assistant with auto discovery
    • Domoticz
    • Other MQTT systems
  • Connecting multiple Gateways to the same EMS system
  • Connecting multiple Gateways to a hybrid system
• EMS bus compatibility
  • EMS bus versions
    • Other bus protocols
  • Bosch boiler and heat pump brands
  • EMS device support list
    • Non supported devices
  • Getting support
  • Home automation system compatibility
• Troubleshooting
  • Basic Troubleshooting
    • Gateway plugged in to service jack but…
    • Gateway connected to the EMS wires but…
    • Gateway connects to home network but MQTT is not connected
    • Gateway connects to home network but MQTT gives the error ‘TCP Disconnected’
    • MQTT is connected but seemingly no response
    • MQTT is disconnecting all the time after I upgraded the ESP module or Gateway
    • My E32 has no Ethernet or no EMS bus after an firmware update/error
    • The WiFi connection drops when it is connected to a Unifi access point
    • MQTT seems unstable and WiFi drops intermittently and the Gateway does not reconnect
    • When I try to set a parameter on my Junkers/Worcester boiler, nothing happens
  • More troubleshooting
• Help I can’t access my Gateway or maybe I bricked it
  • LED status
    • No LED
    • Blinking or solid LED
  • Reset to factory default with the button
  • Firmware flashing / device reset
• Factory reset
  • Where can I find the button?
    • Gateway E32-V2
    • Gateway S3 and S3-LR
    • Gateway S32 V2.0
    • Gateway S32 V1.0
    • Gateway E32
    • Gateway Premium II and older
• Gateway hardware details
  • Gateway feature matrix
    • Pinout
  • Details on the current Gateway editions
    • Gateway board version E32 V2.0
    • Gateway board version ESP32-S3 V1.0/1.1 (S3)
  • Details on discontinued Gateway editions
    • Gateway board version ESP32 V2.0 (S32)
    • Gateway board version ESP32 V1.5 (E32)
    • Gateway board version ESP32 V1.0/V1.3/V1.4 (E32)
    • Gateway board version ESP32 V1.1 (S32)
    • Gateway board version ESP8266 V1.7 (P2/Premium II)
    • Gateway board version V1.6 (Premium II)
    • Gateway board version V1.5 (Premium II and Standard edition)
    • Gateway board version V1.3 (Premium I and Regular)
    • Gateway board version V0.2 (First edition)
• Powering a Gateway
  • Power options Gateway E32, E32 V2, S32, S3 and S32-LR
    • Service jack
    • External power supply
    • USB port
  • Power requirements external DC power supply
  • Power options Gateway Premium II
    • Service jack
    • Bus power
    • USB port
• EMS bus wiring
  • Using the service jack
    • Splitting service jack power
  • Using the EMS screw terminal
• Using Gateway GPIO
  • General considerations
    • GPIO are hidden inside
    • Safety measures
    • Voltages
    • Current draw
  • Available GPIO pins
    • Gateway S3 and S3-LR
    • Gateway S32
    • Gateway E32 V1.0/V1.5
    • Gateway E32 V2
• Upgrade an ESP8266 Gateway with an ESP32
  • Steps to upgrade to the drop-in replacement
    • Get the right board
    • Solder on the headers
    • Load the EMS-ESP firmware
    • Modify the enclosure
    • Putting it all together
    • If jack power does not work anymore
  • Pinout compatible boards
  • Other replacements

EMS INTERFACE BOARDS

• EMS interface boards
  • Introduction
• Interface board V3.1
  • Available connectors on the V3.1 board
  • Connecting to the controller
  • Drawing power from the service jack
• Interface board V3
  • Available connectors on the V3.0 board
  • Connecting to the controller
• Interface board V1
  • Available connectors on the V1.0 board
  • Connecting to the controller
• Interface board V0.9
  • Available connectors on the V0.9 board
  • Connecting to the controller
• How to connect the boards
  • Connecting to the controller
    • Liligo T7-S3
    • MH-ET Live D1 ESP32
    • WT32-ETH01
    • Arduino
    • Raspberry Pi
    • Wemos D1 Mini (ESP8266)
  • Drawing power from the service jack
  • Drawing power from the EMS bus
  • Connecting to the EMS bus
• Links to code for interfacing with the EMS bus

EMS BUS HAT FOR RASPBERRY PI

• EMS bus HAT for Raspberry Pi
  • Introduction
    • Device compatibility
• How to connect the HAT
  • Available connectors on the board
  • Connecting to the Raspberry Pi
    • Stacking header
  • Connecting to other microcontrollers
  • Connecting to the EMS bus
• Serial port settings for the Pi
  • Raspberry Pi serial port
    • Turning off the Linux serial console
  • Which UART to use
    • Setting the right UART
• Links to code for interfacing with the EMS bus

EMS BUS DOCUMENTATION

• General info on the EMS bus
  • Introduction
  • Links