Skip to content

Commit

Permalink
add multiple-instances to FAQ (emsesp/EMS-ESP32#2046)
Browse files Browse the repository at this point in the history
  • Loading branch information
proddy committed Sep 24, 2024
1 parent 17054bb commit 3491e8c
Showing 1 changed file with 13 additions and 3 deletions.
16 changes: 13 additions & 3 deletions docs/FAQ.md
Original file line number Diff line number Diff line change
@@ -1,12 +1,12 @@
## How to Hardware Reset
## How to Hardware Reset EMS-ESP?

If you have a GPIO Button configured (enabled by default on all BBQKees boards) pressing this has different actions:

- _single press_: does nothing
- _double press_: re-connects the WiFi
- _hold for 10 seconds_: performs a factory reset. EMS-ESP will restart in Access Point mode

## Decoding EMS Telegrams
## What is an EMS Telegrams?

_Written by @MichaelDvP in [this article](https://github.com/emsesp/EMS-ESP32/discussions/1612#discussioncomment-8408868):_

Expand Down Expand Up @@ -38,10 +38,20 @@ And **mtc716** said _"A thermostat creates a heat curve that is constantly adapt
See [Smart control a heating system with HA?](https://github.com/emsesp/EMS-ESP32/issues/144)
and [thermostat emulation](https://github.com/emsesp/EMS-ESP32/issues/151).

## Bus protocols and Tx mode explained
## What are Bus protocols and Tx modes?

Protocol and timing are different things, you pick the tx-mode that works best.

HT3 is the Junkers electronic and HT3 protocol is the same as EMS, only in first byte (sender) the highest bit is set. Each telegram we send starts with 0B in a Buderus system, but with 8B in Junkers. This makes the devices of the different brands incompatible. EMS-ESP checks the bus on start and select the right protocol automatically. Also Junkers uses different telegram numbers/orders. Bosch labeled modules uses the same telegram numbers as Buderus, but addressing like Junkers, so also incompatible. You can't connect Junkers or Buderus modules to a Bosch heating system.

Tx-mode is the send timing: The client devices send by current modulation, the master by voltage modulation. This allows full duplex (Hardware mode), but depending on line impedance drawing current also influences the voltage. When sending, the master repeats every byte sent by the device to publish it to the other devices. With a Tx-mode of "EMS" we wait for the master byte before sending the next. The older Junkers seems to have a lower timeout so we need to start the next byte before the master echo is completed ("HT3"). "EMS+" is less critical and we can wait a bit longer than one byte to allow voltage to be stabilized after the sending.

## Can you run multiple instances of EMS-ESP?

Yes you can. Keep in mind the following settings:

- (Settings->MQTT Settings) MQTT `Entity ID format` is set to "Multiple instances, short name"
- (Settings->MQTT Settings) MQTT `Client ID` must be unique to avoid conflicts in the MQTT broker
- (Settings->MQTT Settings) MQTT `Base` is unique (just be sure). Usually set this to the hostname.
- (Settings->Network Settings) `Hostname` is unique, to avoid network conflicts
- (Settings->Application Settings) `EMS BUS ID` are different (not both 0x0B)

0 comments on commit 3491e8c

Please sign in to comment.