Homebridge-rinnai-touch-plugin NPM

Homebridge Plugin for the Rinnai Touch WiFi Module

This Homebridge Plugin allows you to control a Brivis HVAC system via a Rinnai Touch WiFi Module. It supports the following operation modes:

Single Temperature Set Point (ie. one controller with 1 to 5 zones including the Common zone)
Multi Temperature Set Point (ie. one controller per zone, up to 4)

Functions available:

Displaying the current state (eg. idle, heating, cooling)
Switching to Off, Heating or Cooling modes
Displaying the current temperature (depends on controller model)
Setting the desired temperature
Switching zones On and Off
Switching the circulation fan On and Off as well as setting rotation speed
Turning the water pump On and Off (for Evaporative Cooling only)
Advancing to the next period of the Programme Schedule. (eg. Leave -> Return)
Switching between Manual and Schedule control modes
MQTT client. See MQTT.md for details.

Accessories

This plugin will add one or more accessories to the Home app depending on your Rinnai Touch status. Accessories are discovered automatically without any need to modify the config.json file. The following table describes each type of accessory.

Accessory	Description
Thermostat / Heater Cooler	Displays the current temperature, units (Celsius or Fahrenheit) and mode of the Brivis HVAC system. It allows you to set the desired temperature and change the mode. Modes are:`OFF` - System is off`HEAT` - System is in heating mode`COOL` - System is in cooling mode`AUTO` - Returns system into Auto mode and the current period of the programme schedule (this option can be hidden with the `showAuto` config option). It will return to the `HEAT` or `COOL` mode when completeNOTES:One accessory will be added for each controllerTemperature units in the accessory do not determine which unit to use when displaying temperatures in the Home app. This is controlled by your phone's settings
Zone Switch	Shows if the zone is currently On or Off and allows you to change it. Zone Switches are shown if the operation mode is 'Single Temperature Set Point' and at least one zone is enabled (excluding the Common zone)NOTE: The 'Heater Cooler' accessory can be used as a zone switch
Fan	Displays the current state and speed setting of the circulation fan. Allows you to turn it Off or set the rotation speedNOTE: The fan can only be used when the Thermostat is in the `OFF` mode or `COOL` mode for Evaporative Cooling
Advance Period Switch	Shows if the Period of the Programme Schedule has been advanced and allows you to change it
Manual Switch	Shows if the Manual mode is On or Off and allows you to change it
Pump	Displays the current state of the pump if you have Evaporative Cooling. Allows you to turn it On or OffNOTE: The pump can only be used when the Thermostat is in `COOL` mode.

Installation

Note: This plugin requires homebridge to be installed first.

To install or upgrade to the latest version of this plugin:

npm install -g homebridge-rinnai-touch-plugin@latest

Configuration

This is a platform plugin that will register accessories and their services with the Bridge provided by homebridge. The plugin will attempt to discover your Rinnai Touch accessories automatically thus requiring zero configuration to the config.json file.

If you find the auto config is not correct for your system or some defaults are not to your liking there are some overrides you can define in the config.json file.

NOTE: Homebridge version 1.0.0 and onwards require an entry in the config.json file

Option	Description	Default Value (if not supplied)
`platform`	Must be `"RinnaiTouchPlatform"`
`name`	The name of the platform	`"Rinnai Touch"`
`address`	IP Address of the WiFi moduleNOTE: leave blank for auto discovery
`port`	Port to use for the WiFI moduleNOTE: leave blank for auto discovery	`27847`
`controllerType`	The type of accessory to use for the controller(s). Options are:`T` for Thermostat`H` for Heater Cooler	`T`
`zoneType`	The type of accessory to use for controlling zones (only applicable for Single Temperature Set Point). Options are:`N` for None (ie. don't show any accessory for zones`S` for Switch`H` for Heater Cooler	`S`
`showFan`	Show the fan accessory in the Home app	`true`
`showAuto`	Show the `AUTO` option in the Thermostat menu	`true`
`showAdvanceSwitches`	Show the Advance Period switch accessory in the Home app	`true`
`showManualSwitches`	Show the Manual switch accessory in the Home app	`true`
`closeConnectionDelay`	The time (ms) to wait for the TCP connection to fully close. Increasing this may reduce `Connection Refused` errors from occuring	`1100`
`connectionTimeout`	The time (ms) to wait to close the TCP connection after the last request. Set to `-1` to keep the connection open indefinitely, or `0` to close immediately	`5000`
`clearCache`	Clear all the plugin's cached accessories from homebridge to force full discovery of accessories on restart	`false`
`debug`	Output debug information to the Homebridge log	`false`
`mqtt`	See MQTT.md for details	`{}`

Example: Bare mimimum (requried for Homebridge 1.0.0 onwards)

"platforms": [
    {
        "platform": "RinnaiTouchPlatform"
    }
],

Example: Use the 'Heater Cooler' accessory and turn on debug logging

"platforms": [
    {
        "platform": "RinnaiTouchPlatform",
        "name": "Rinnai Touch",
        "controllerType": "H",
        "debug": true
    }
],

Example: No Auto option, Advance Period & Manual switches

This is useful if you only use Manual Control of your HVAC (ie. no programme schedules).

"platforms": [
    {
        "platform": "RinnaiTouchPlatform",
        "name": "Rinnai Touch",
        "showAuto": false,
        "showAdvanceSwitches": false,
        "showManualSwitches": false
    }
],

Version History

See Change Log.

Known Limitations

The plugin only supports a TCP connection over a LAN so no other connections can be active at the time. This would typically be the TouchApp by Rinnai.
If the TCP connection is not closed properly then no further connections can be made to the module. I've tried to mitigate this as best I can by keeping TCP connections as short as possible and only allowing one request at a time. If it does happen I find rebooting my router clears it but rebooting the module itself should work also.
Multi controller and Evaporative cooling configurations were not able to be tested so may not function properly.
Due to the lag between sending a command to the module and it correctly reflecting that command in it's status there may be a short delay of a few seconds before the Home app shows the correct values. eg. When switching from HEAT to COOL mode some details such as the desired temperature will take a few seconds before the current value is shown.
If the number of zones is different between the Heat and Cool modes the Zone Switches are dynamically added or removed as necessary. The downside of this is that you will loose any changes you made to the accessory (eg. name).
If the WiFi module does not supply a current temperature then the temperature will display as zero in the Thermostat/Heater Cooler accessory. I would have prefered it showed as blank but couldn't find a way to do it. This appears to be a limitation of the service within Homebridge.
The WiFi module will close the TCP connection after 5 minutes of inactivity. If the connection timeout is set to never (ie. -1) the plugin will attempt to automatically reconnect.
The 'Heater Cooler' accessory is not currently supported by Home Assistant. See https://github.com/home-assistant/core/issues/30384