EQ3 TRV

This driver allows the control of Eqiva TRV's (i.e. Thermostat Radiator Valve). Compatible models are:

• Eqiva eQ-3 Bluetooth Smart (141771E0/141771E0A)
• Eqiva eQ-3 Bluetooth Smart(UK Version) (142461D0)

Other Eqiva EQ3 models should work as well, but make sure you select a Bluetooth model as there are also non-Bluetooth models.

Compiling from source~

In order to have EQ3 valves working when compiling from source you need to add these define in user_config_override.h:

#ifdef USE_EQ3_ESP32
   #undef USE_EQ3_ESP32
#endif
#define USE_EQ3_ESP32

Setup~

Before you can use the TRV you will need to enable Bluetooth on the TRV:

1. Press the Mode/Menu button for at least 3 seconds.
2. Select the menu item bLE with the control wheel and confirm by pressing the control wheel shortly.
3. The display will show OFF to deactivate the function or On to activate the function.
4. Confirm by pressing the control wheel shortly.

Next you will need to make sure that BLE is enabled in Tasmota:

1. Configuration
2. Configure BLE
3. Enable Bluetooth

To determine the mac addresses of a TRV:

1. Go to the BLE menu in Tasmota
2. Enable active scan
3. In to the tasmota console: TRV devlist

This will give you the mac address of each valve.

After configuring, tasmota will poll the discovered valves and publish their state under stat/EQ3/<MAC Adress> (or stat/EQ3/<BLEAlias> if you have configured an alias for the MAC address of the valve using BLEAlias).

The interval between polls can be configured using TRVPeriod. Tasmots needs to have an NTP or RTC time configured for this to work.

Operating your TRV~

There are 2 ways to control your TRV:

• The Tasmota Console (convenient for setup)
  syntax: TRV <MAC Address> <command> [options]
  example: TRV 001A2216A458 settemp 21.5
• MQTT:
  syntax: cmnd/<tasmota_topic>/EQ3/<MAC Address>/command [options]
  example: cmnd/ble_esp32/EQ3/001A2216A458/settemp 22.5

As you can see from the example the MQTT topic is made of:

• Standard Tasmota %prefix% : cmnd, stat
• %topic% of the BLE_ESP32 gateway device, here ble_esp32
• An EQ3 element to specify this command is specific to the EQ3 driver
• The MAC address or alias of the EQ3
• The command to the EQ3 or result from the EQ3

The EQ3 TRV has 3 modes of operation:

These 3 modes can be set and configured using different commands described below. After submitting a command you will see one or more of the possible results.

Under normal circumstance you will get a JSON formatted response from the valve:

{
  "cmd": "settemp",
  "result": "ok",
  "MAC": "001A2216A458",
  "tas": "ble-esp32-0936",
  "RSSI": -79,
  "stattime": 1642328707,
  "temp": 21.0,
  "posn": 95,
  "mode": "auto",
  "hassmode": "auto",
  "boost": "inactive",
  "dst": "set",
  "window": "closed",
  "state": "unlocked",
  "battery": "GOOD",
  "holidayend": "00-00-00 00:00",
  "windowtemp": 12.0,
  "windowdur": 15,
  "day": 21.0,
  "night": 17.0,
  "offset": 0.0
}

If the mode is holiday, "holidayend" will show when the holiday period and mode is about to end:

{
  "mode": "holiday",
  "holidayend": "22-01-19 17:00"
}

In the response for the command setprofile, "profiledayset" will be added:

{
  "cmd": "setprofile",
  "profiledayset": 4
}

In the response for the command reqprofile, "profiledayn" (n=0…6) will be added:

{
  "cmd": "reqprofile",
  "profileday4": "17.0-07:00,23.0-10:00,17.0-17:00,21.0-23:00,17.0-24:00"
}

Available commands~

Base commands~

TRV subcommands~

Examples~

Request the current status without changing anything:

cmnd/tasmota/EQ3/001A2216A458/state

set a target temperature (21.5 C)

cmnd/tasmota/EQ3/001A2216A458/settemp 21.5

Select TRV mode auto: run the week program as stored in the TRV

cmnd/tasmota/EQ3/001A2216A458/auto

Select TRV mode manual: disable the week program and keep the temperature as selected (settemp/day/night)

cmnd/tasmota/EQ3/001A2216A458/manual

Select TRV mode holiday: suspend the week program or manually applied temperature until 2022 - Jan - 19 - 17:00 and set the temperature to 18.5 C

cmnd/tasmota/EQ3/001A2216A458/setholiday 22-01-19,17:00 18.5

Select TRV temperature day: Switch to comfort temperature

cmnd/tasmota/EQ3/001A2216A458/day

Select TRV temperature night: Switch to reduction temperature

cmnd/tasmota/EQ3/001A2216A458/night

Disable the TRV and enable frost protection.

Until the next programmed timeslot

cmnd/tasmota/EQ3/001A2216A458/valve off

Permanently:

cmnd/tasmota/EQ3/001A2216A458/off

Disable the TRV and open the valve completely (saves potentially battery in summer while the central heating is not working):

Until the next programmed timeslot

cmnd/tasmota/EQ3/001A2216A458/valve on

Permanently:

cmnd/tasmota/EQ3/001A2216A458/on

Change the comfort and reduction temperature to 22 C and 17.5 C

cmnd/tasmota/EQ3/001A2216A458/setdaynight 22 17.5

Enable boost mode (valve 80% open for 5 minutes)

cmnd/tasmota/EQ3/001A2216A458/boost

Disable TRV buttons

cmnd/tasmota/EQ3/001A2216A458/lock

Synchronize current tasmota time with the TRV

cmnd/tasmota/EQ3/001A2216A458/settime

Set the time and date (byte by byte conversion from decimal to hexadecimal)

• Date: 2021 - jan - 04 - 13:00:00
• In hex: 15 - 01 - 04 - 0d:00:00 (yyMMddhhmmss)
• Concatenate: 1501040d0000

cmnd/tasmota/EQ3/001A2216A458/settime 1501040d0000

Set the temperature schedule for day 3 (Tuesday) as

• 20.5 C until 07:30
• 17.0 C until 17:00
• 22.5 C until 22:00
• 18.0 C until 24:00

cmnd/tasmota/EQ3/001A2216A458/setprofile 3 20.5-07:30,17.0-17:00,22.5-22:00,18.0-24:00