Arduino/ESP8266 OpenTherm Library for HVAC system control communication
Switch branches/tags
Nothing to show
Clone or download
ihormelnyk Merge pull request #5 from dwrobel/dw-restore-interrupts
Restore interrupts before leaving sendRequestAync()
Latest commit c23dca4 Nov 13, 2018
Failed to load latest commit information.
examples/OpenTherm_Demo Initial commit Mar 19, 2018
src Update OpenTherm.cpp Nov 12, 2018
LICENSE Initial commit Mar 19, 2018 Update Jun 13, 2018
keywords.txt Initial commit Mar 19, 2018 Fixed OpenTherm commands codes Oct 22, 2018

OpenTherm Arduino/ESP8266 Library

This library provides implementation of OpenTherm protocol.

OpenTherm Library is based on OpenTherm protocol specification v2.2 and works with all OpenTherm compatible boilers. Library can be easily installed into Arduino IDE and compiled for Arduino, ESP8266 and other similar controllers.

OpenTherm protocol requires simple low voltage twowire connection to boiler, but voltage levels (7..15V) still much higher than Arduino/ESP8266 levels, which requires OpenTherm Adapter.

This version of library uses interrupts to achieve better stability and synchronization with boiler.

Using OpenTherm Library you will be able:

  • control your boiler remotely (get status, switch on/off heating/water heating, set water temperature and much more)
  • make custom thermostat

Configuration and Usage:

#include <OpenTherm.h>

You have to choose 2 controller GPIO pins which will be used for communication and connected to OpenTherm Adapter. Controller(Arduino/ESP8266) input pin should support interrupts. Controller output pin should be connected to OpenTherm Adapter input pin and vise versa.

const int inPin = 2;
const int outPin = 3;

Define OpenTherm class instance using constructor which accepts as arguments pin numbers:

OpenTherm ot(inPin, outPin);

Define interrupts handler function for specified above instance:

void handleInterrupt() {

Use begin function to initialize OpenTherm instance, specify interrupts handler function as argument

void setup()

According to OpenTherm Protocol specification master (controller) must communicate at least every 1 sec. So lets make some requests in loop function:

void loop()
    //Set/Get Boiler Status
    ot.setBoilerStatus(enableCentralHeating, enableHotWater, enableCooling);
    //Set Boiler Temperature to 64 degrees C
    //Get Boiler Temperature
    float temperature = ot.getBoilerTemperature();

In details OpenTherm Library described here.

OpenTherm Adapter Schematic

opentherm adapter schmetic

Arduino UNO Connection

opentherm adapter arduino


Copyright (c) 2018 Ihor Melnyk. Licensed under the MIT license.