Uponor Plugin for Homebridge

Uponor Smatrix Pulse heating/cooling integration for Homebridge.

About this Plugin

This plugin is based on and continues the work of the original homebridge-plugin-uponor. The primary goal is to modernize and maintain the plugin with ongoing updates and improvements.

Compatibility

• Homebridge: v1.11.1+ and v2.x (see the Homebridge v2 migration guide)
• Node.js: v22.13+ or v24+

Installation

Install the plugin via the Homebridge UI or manually via npm:

npm install homebridge-uponor

Configuration

Configure the plugin via the Homebridge UI or manually in your config.json:

{
  "platforms": [
    {
      "platform": "UponorPlatform",
      "name": "Uponor",
      "host": "192.168.1.100",
      "displayUnit": "CELSIUS"
    }
  ]
}

Configuration Parameters

• platform (required): Must be "UponorPlatform"
• name (required): Name for the platform (e.g., "Uponor")
• host (required): IP address or hostname of your Uponor R-208 module
• displayUnit (required): Temperature display unit - either "CELSIUS" or "FAHRENHEIT"

Supported devices

This integration communicates with Uponor Smatrix Pulse communication module R-208. It should work with all controllers that support this module.

Accessories

• THERMOSTAT: One Thermostat accessory will be created for each Uponor thermostat.
• COOLING MODE: One Switch to switching between heating and cooling.
• AWAY MODE: One Switch to switching between normal and away.

Catches and limitations

• Uponor API doesn't support heat/cool switch for single thermostat. switch.uponor_cooling_mode change mode for entire system.
• Uponor API does not support turn off action. When climate entity is turned off on Homebridge, the temperature is set to the minimum (default 5℃) when heating mode is active and to the maximum (default 35℃) when cooling mode is active.

Feedback

Your feedback, pull requests or any other contribution are very much welcome.

Credits

Original plugin by alexmobo
Maintained and developed by Michael Päßler