pxe-la/immergas_opentherm_library

Arduino/ESP8266 OpenTherm Library for HVAC system control communication

OpenTherm Arduino/ESP8266/ESP32 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() {
	ot.handleInterrupt();
}

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

void setup()
{
    ot.begin(handleInterrupt);
}

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
    ot.setBoilerTemperature(64);
    //Get Boiler Temperature
    float temperature = ot.getBoilerTemperature();
    delay(1000);
}

In details OpenTherm Library described here.

OpenTherm Adapter Schematic

Arduino UNO Connection

License

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