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 (ESP32 Standard edition)
  • 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 a Gateway Premium II (P2)
  • Gateway connectors
  • Preferred order of connection
  • Service jack
  • EMS/thermostat wires
  • Power source selection
    • Board version 1.6/1.7
    • Board version 1.5
    • Power considerations
    • First boot -> Check the LED
• Connecting a Gateway Standard or Regular
  • Gateway connectors
  • Preferred order of connection
  • Service jack
  • EMS/thermostat wires
    • First boot -> Check the LED
• Connecting the Gateway to the boiler 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
  • Buderus
    • Logamatic
    • Logamax
  • Nefit
    • 9000i
    • Trendline
    • Topline
    • Proline
    • Baseline
    • Nefit Bosch Heat pumps
    • Smartline
  • Junkers
    • Cerapur
  • Worcester
    • Greenstar
  • 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-ESP32 V3
    • MQTT server address and configuration
  • Making the appropriate settings for EMS-ESP V2
    • MQTT server address and configuration
    • MQTT format
• Setting the correct TX mode
  • Changing TX mode
• Observing EMS bus signal quality
  • EMS bus connection status
  • EMS bus signal quality
• Overview of all web interface settings EMS-ESP32
  • Dashboard
    • Devices and Sensors
    • EMS Status
    • EMS-ESP Help
  • Settings
  • WiFi Connection
    • WiFi Status
    • Scan Networks
    • WiFi 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
• Overview of all web interface settings EMS-ESP V2
  • Dashboard
    • Devices and Sensors
    • EMS Status
    • EMS-ESP Help
  • Settings
  • WiFi Connection
    • WiFi Status
    • Scan Networks
    • WiFi 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
• 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
• Updating or downgrading the Gateway firmware
  • Updating firmware via the web interface
  • Using beta firmware
  • Downgrading firmware
  • Building and loading firmware via Platform IO
  • Loading firmware via the ESPtool
  • Loading firmware via OTA (Over The Air)
  • Uploading the firmware via NodeMCU flashtool
    • Gateway Premium II, Standard, Regular
  • Uploading the firmware via ESP Flasher flashtool
    • Gateway S32
    • Gateway E32
  • Troubleshooting
• Updating the Gateway firmware to EMS-ESP V2
  • Updating the firmware via the web interface
  • Uploading the firmware via NodeMCU flashtool
  • Uploading the firmware via ESPTool or Platform I/O
  • 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
• EMS bus compatibility
  • EMS bus versions
    • Other bus protocols
  • Bosch boiler 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
    • The KM100, KM200 goes offline
  • 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 S32
    • Gateway E32
    • Gateway Premium II and older
• Gateway hardware details
  • Gateway feature matrix
  • Details on the current Gateway editions
    • 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)
  • Details on discontinued Gateway editions
    • 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, S32 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
• Using Gateway GPIO
  • General considerations
    • GPIO are hidden inside
    • Safety measures
    • Voltages
    • Current draw
  • Available GPIO pins
    • Gateway S32
    • Gateway E32
  • ADC feature
• 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
  • Pinout MH-ET Live D1 board
  • Other replacements

Home Assistant configuration

• Configuration for Home Assistant (MQTT Discovery)
  • Getting Home Assistant ready for the Gateway
    • MQTT
    • Setting the MQTT format
  • Adding the devices into Home Assistant
    • Create settable devices
• Configuration for Home Assistant YAML part one
  • Getting Home Assistant ready for the Gateway
  • What are those YAML files?
  • MQTT
  • Adding the YAML configuration
    • Adding the preconfigured YAML files
    • Extending configuration.yaml
  • Checking if it all works
• Configuration for Home Assistant part two
  • Adding the preconfigured view to Home Assistant
  • Adding devices to the UI manually
• Adding heating circuits to Home Assistant
• Home Assistant advanced configuration

Domoticz configuration

• Configuration for Domoticz
  • MQTT Autodiscovery
    • Domoticz version
    • Turning on Autodiscovery
    • Adding the hardware in Domoticz
    • Help I don’t see any device
  • Domoticz plugin
    • Installing the plugin
    • Configuring the plugin
    • Using the plugin
    • Updating the plugin
    • More info
• Domoticz or Home Assistant
  • Necessary hardware
    • Raspberry Pi
    • Intel NUC or other mini-pc
  • Domoticz versus Home Assistant
    • Home Assistant
    • Domoticz
    • Making the choice

Other systems configuration

• Configuration for other MQTT systems
  • Tips for other home automation systems
    • Loxone
    • OpenHAB
    • Node-RED
• Configuration for Loxone
  • Using the Restful API for HTTP
    • virtual inputs
    • Virtual outputs
    • Results
  • Additional Pi with Loxberry
    • Further plugin settings
    • Getting data into Loxone
    • MQTT structure
• Configuration for OpenHAB
  • MQTT structure
• Configuration for ioBroker
• RESTful API

EMS INTERFACE BOARD

• EMS interface boards
  • Introduction
• How to connect the board
  • Available connectors
    • Available connectors on the V1.0 board
    • Available connectors on the V0.9 board
  • Connecting to the controller
    • Arduino
    • Raspberry Pi
    • Wemos D1 Mini
  • 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