OpenThermGateway

This is another ESPHome implementation for OpenThermGateway based on @arthurrump's ESPHome OpenTherm and @ihormelnyk's OpenTherm Library

Communication is stable, values will be requested from boiler at initialization, and updated periodically if the thermostat doesn't request them. There is an override for room temperature setpoint, boiler should return it's target temperature but the thermostat will still show the previous temperature requested.

I'm using this hardware DIYLESS OpenTherm Gateway with a ESP32 (WROOM), but it should work with other hardwares.

My boiler is an Atlantic NAEMA 2 MICRO 25 with a Navilink 128 RADIO-CONNECT.

Installation

Add to external section this repo :

external_components:
  - source: github://gduteil/OpenThermGateway
    components: [ openthermgw ]

Alternately you can install the component manually :

Clone this repo and copy my_components in your "config/esphome" folder

Add the configuration in your YAML file (an example is in the repo)

external_components:  
- source:
  type: local
  path: my_components

OTGW Configuration

Change the pins to match your hardware

openthermgw:
  pin_thermostat_in: 17
  pin_thermostat_out: 18
  pin_boiler_in: 13
  pin_boiler_out: 27

  ch_enable: true
  dhw_enable: true
  cooling_enable: false
  otc_active: false
  ch2_active: false

OTGW Temperature sensor

Change the pins and address to match your hardware (see https://esphome.io/components/sensor/dallas.html for information on getting the address)

dallas:
  - pin: 16

sensor:
  # OTGW Temperature sensor
  - platform: dallas
    address: 0x7dc76a750e64ff28
    name: "T°C OTGW"

OpenTherm binary sensors

Example for binary sensors

binary_sensor:
  - platform: openthermgw
    flame_on:
      name: "Flame"

Available binary sensors are :

fault_indication : Fault indication
ch_active : Central Heating active
dhw_active : Domestic Hot Water active
flame_on : Flame on
cooling_active : Cooling active
ch2_active : Central Heating 2 active
diagnostic_indication : Diagnostic event
fault_service : Service required
fault_lockout : Lockout reset enabled
fault_waterpress : Water pressure fault
fault_gasflame : Gas/flame fault
fault_airpress : Air pressure fault
fault_watertemp : Water over-temp fault
fault_watertemp : Water over-temp fault
func_manualoverridepriority : Remote override manual change priority
func_programoverridepriority : Remote override program change priority

OpenTherm sensors

Example for sensors

sensor:
  - platform: openthermgw
    t_roomset:
      name: "Room setpoint"

Available sensors are :

fault_oem : OEM Fault code
t_set : Temperature setpoint for the boiler's supply water
tr_override : Remote override room setpoint
t_set_ch2 : Temperature setpoint for the boiler's supply water on the second heating circuit
t_set_dhw : Domestic hot water temperature setpoint (°C)
diag_oem : An OEM-specific diagnostic/service code
master_ot_version : OpenTherm version Master
slave_ot_version : OpenTherm version Slave
t_roomset : Current room temperature setpoint
pc_relmod : Relative Modulation Level (%)
bar_chpress : Water pressure in CH circuit (bar)
ls_dhwflowrate : Water flow rate in DHW circuit. (litres/minute)
t_room : Room temperature
t_boiler : Boiler water temperature
t_dhw : DHW temperature
t_outside : Outside temperature
t_ret : Return water temperature
t_exhaust : Exhaust temperature
t_dhw_set_ub : Upper bound for adjustment of DHW setpoint
t_dhw_set_lb : Lower bound for adjustment of DHW setpoint
max_t_set_ub : Upper bound for adjustment of max CH setpoint
max_t_set_lb : Lower bound for adjustment of max CH setpoint
max_t_set : Maximum allowable CH water setpoint (°C)
nb_startburner : Number of starts burner
nb_startchpump : Number of starts CH pump
nb_startdhwpump : Number of starts DHW pump/valve
nb_burnerhours : Number of hours that burner is in operation (i.e. flame on)
nb_chpumphours : Number of hours that CH pump has been running
nb_dhwpumphours : Number of hours that DHW pump has been running or DHW valve has been opened
nb_dhwburnerhours : Number of hours that burner is in operation during DHW mode
master_memberid : MemberID code of the master
slave_memberid : MemberID code of the slave

OpenTherm text sensors

Text sensors

    time_date:
      name: "Date"
    dhw_present:
      name: "DHW Present"
      filters:
        - substitute:
          - "OFF -> Not present"
          - "ON -> Present"
    control_type:
      name: "Control type"
      filters:
        - substitute:
          - "OFF -> Modulating"
          - "ON -> On/Off"
    cooling_supported:
      name: "Cooling Supported"
      filters:
        - substitute:
          - "OFF -> No"
          - "ON -> Yes"
    dhw_config:
      name: "DHW Config"
      filters:
        - substitute:
          - "OFF -> Instantaneous"
          - "ON -> Storage tank"
    lowoff_pumpcontrol_allowed:
      name: "Pump Control"
      filters:
        - substitute:
          - "OFF -> Allowed"
          - "ON -> Not allowed"
    ch2_present:
      name: "CH2"
      filters:
        - substitute:
          - "OFF -> Not present"
          - "ON -> Present"

OpenTherm switches

switch:
  - platform: openthermgw
    ch_enable:
      name: "Heater"
    dhw_enable:
      name: "DHW"
    cooling_enable:
      name: "Cooling"
    otc_active:
      name: "OTC"
    ch2_active:
      name: "CH2"

OpenTherm number

Number is used for overrides, setting '0' will disable the override.

number:
  - platform: openthermgw
    t_roomset_override:
      name: "Temperature Override"

gduteil / OpenThermGateway

readme