Tus neeg siv phau ntawv

OpenTherm Gateway Plugin for HomeSeer HS4 Manual
Introduction
Thank you for using the OpenTherm Gateway Plugin for HS4! This plugin can be used to
communicate with an OpenTherm Gateway (OTGW). OTGW is an
open source gateway by Schelte
Bron that you can build yourself (or buy from a few webshops) and connect in between your
OpenTherm thermostat and boiler or compatible devices. Please see Requirements for more info.
Please note that, despite its name, the OpenTherm protocol is not an open standard. Information
about it was gathered from leaked documents and downloads, as well as other projects. It may not be
100% correct, but I’m constantly hunting for more information and will update this plugin accordingly. If
you have additional information, please share it with me through the HomeSeer forums.
This plugin will process every known OpenTherm message, unlike scripts or solutions for other home
automation platforms. Those are usually based on the (PS=1) summaries, which are read every at
certain intervals. In other words, this plugin is realtime. Any delay is caused by thermostat/boiler being
busy with other more important messages. The devices page in HS4 also does not update instantly
(but every other second or so). Not using PS=1 also means that you can always use the latest OTGW
firmware (The summary output changed in version 5.0 and may change again in future).
This is my fourth plugin for HS4. My other plugins are the MiLight Plugin, Volvo Plugin and Horizon
Remote Plugin. My main motivation to develop these plugins is to get better and better at C#
development, and because I want the functionality for my own system.
I have tested this plugin thoroughly, but if you find bugs anyway, please let me know.
Bernold
Requirements
To use this plugin, you will need the following:
- HomeSeer HS4. The plugin has only been tested on Windows, but should work on Linux as
well. The version has to be at least 4.2.14.0, as it depends on SDK 1.4.2.0.
- An OpenTherm Gateway (OTGW) connected to your network via Wi-Fi or LAN. USB/COM is
not supported. See chapter ā€œSerial Connectionā€.
Please make sure that it gets a fixed IPv4 address. It helps if you have already connected it in
between your thermostat and boiler and have tested it, for example with the
OpenTherm
Monitor as provided by Schelte Bron, to make sure it works on the intended IP address/port.
Abbreviations
The OpenTherm Association uses several abbreviations, which I have used to name features and
keep their names short(er):
CH = Central Heating
CH2 = Central Heating, 2nd circuit
DHW = Domestic Hot Water
FHB = Fault History Buffer
OEM = Original Equipment Manufacturer
OTC = Outside Temperature Compensation
TSP = Transparent Slave Parameters
V/H = Ventilation/Heat-Recovery
OTGW is an abbreviation of OpenTherm Gateway