The OpenTherm Gateway plugin for Vera

Vera plugin to control the OpenTherm Gateway (see ​http://otgw.tclcode.com/) designed by Schelte Bron. Discussion on the hardware and firmware can be found on ​http://www.domoticaforum.eu/viewforum.php?f=75. The OpenTherm Gateway hardware can be ordered via ​http://www.opentherm-gateway.com/.

Supported features

• Monitor OpenTherm settings
  • OpenTherm version 2.3 messages supported
• Thermostat control in Gateway mode
• Override room temperature setpoint
• Get outside temperature from Vera sensor
• Get room humidity from Vera sensor
• Eco mode allows to change setpoint and/or DHW setting based on pre-defined conditions
• Show firmware version of the Gateway
• Send date and time command
• Send free format command
• Monitor protocol errors (and reset error count)
• Change Gateway configuration through the plugin
• Send notifications on boiler events

Version history

• 0.4 October 27, 2013
  • Supports OTG firmware version 4.0(alpha)
  • Option to create child devices for temperature values
  • Eco mode and options added
    • [ADHW] Change DHW setting when alarm is Armed (away)
    • [ATMP] Change setpoint when alarm is Armed (away)
    • [DTMP] Change setpoint when door(s)/window(s) is/are open
    • Function SetEnergyModeTarget added
  • Moved DHW setting to control tab
  • Split Settings tab in Hardware & plugin Settings tab
  • Added option to show (colored) value indication bars
  • Support to show humidity value on thermostat
    • Function SetRoomHumidity added
  • Now supports different levels of debug output
• 0.3 October 5, 2013
  • Added sending of free format commands
  • Get/update configuration of the gateway
  • Added extra values to display
  • Added error counters to display
  • Display firmware version
  • Send date/time or free format command
  • Full support of all OpenTherm messages
  • Separate variables for hb/lb possible
  • Made variable names more consistent
  • Updated monitor display (e.g. bold on value change)
  • Added notifications
• 0.2 September 28, 2013
  • Monitoring of Gateway
  • Control outside temperature value
  • Send TT and TC commands
• 0.1 September 27, 2013
  • Initial version

Monitor screenshot (UI5)

Installation

• Go to Apps -> Develop Apps -> Create device
• Fill out 'D_OpenThermGateway.xml' under 'Upnp Device Filename'
• Fill out the IP address or select the serial parent device
• Press 'Create'
• Press 'Reload'

Configuration

The following settings are available in the 'Settings' tab.

• Plugin options
  • Communicate using UART - visible when connected via a serial interface
  • Communicate using IP - visible when connected via an IP address
  • Generate debug logging & files - when 'On' will generate logging in the LuaUPnP.log file and will create an otg_msg.txt file
  • Outside temperature sensor - select an temperature sensor to use for the OT= command; temperature updates will be sent to the Gateway
• Gateway configuration
  • Operating mode
  • Domestic hot water enable
  • Non-significant transitions
  • Reference voltage
  • LED A-D function

Usage

• Changing a temperature setpoint in the UI will send a 'TT=' command to the Gateway. The Gateway will use this to force a 'Remote override room setpoint'.
• Pressing the 'Heat' button will send a 'TC=' command, making the current setpoint constant instead of temporary.
• Pressing the 'Off' button will remove the remote override room setpoint, by sending a TT=0 command.

Please note that the display will show a decimal value, but Vera can only handle integer values (i.e. you can only set the Thermostat to 21°C in the UI and not to 21.5°C. You can set a value of e.g. 21.34°C via the function 'SetCurrentSetpoint'.

Notifications

The following notifications are currently available.

• Central heating goes on or off
• Domestic hot water goes on or off
• Cooling goes on or off
• Central heating 2nd circuit goes on or off
• Flame goes on or off
• Fault indication
• Diagnostic indication
• Ambient temperature goes above
• Ambient temperature goes below

Variables

Plugin

• PluginVersion - version number of the plugin
• PluginDebug - 0: debug off; 1: debug on
• LogPath - path to write log file to
• GatewayMode - 0: Monitor; 1: Gateway
• CommandResponse - contains the response of a free format command

Gateway

• Errors - contains comma separated list of Error 01 - Error 04

OpenTherm

Flag variables (status, config, fault) are always either 0 or 1.

Status variables

• StatusCHEnabled - Central heating enable
• StatusCHEnabled- Central heating enable
• StatusDHWEnabled - Domestic hot water enable
• StatusCoolEnabled - Cooling enable
• StatusOTCActive - Outside temp. comp. active
• StatusCH2Enabled - Central heating 2 enable
• StatusFault - Fault indication
• StatusCHMode - Central heating mode
• StatusDHWMode - Domestic hot water mode
• StatusFlame - Flame status
• StatusCooling - Cooling status
• StatusCH2Mode - Central heating 2 mode
• StatusDiagnostic - Diagnostic indication

Config flag variables

• ConfigDHWpresent - Domestic hot water present
• ConfigControlType - Control type (modulating on/off)
• ConfigCooling - Cooling supported
• ConfigDHW - Domestic hot water storage tank
• ConfigMasterPump - Master low-off & pump control allowed
• ConfigCH2 - Central heating 2 present

Fault flag variables

• FaultServiceRequest - Service request
• FaultLockoutReset - Lockout-reset
• FaultLowWaterPress - Low water pressure
• FaultGasFlame - Gas/flame fault
• FaultAirPress - Air pressure fault
• FaultOverTemp - Water over-temperature