Homey Pro User Guide

The Rithum Switch Homey app (available from the Homey App Store), alongside the Rithum Homey Pro Core plugin (available through Rithum and installed on the Rithum Switch system), adds support to integrate the switch with your Homey Pro. It enables Flows and Advanced Flows to be triggered via simple scene buttons or standby gestures, such as the hold gesture.

Zones containing lights devices can be added to the Levels screen to control on/off and brightness of individual lights or all lights in the zone.

It also allows Rithum Stat to be added as a thermostat device in Homey for control via the climate panel and its associated Flow cards.

Rithum App for Homey

Installation

Visit this link to install the Rithum app on your Homey Pro (Note that the Homey Bridge is not supported).

You will see a warning message saying “This app can manage your entire Homey”. Extra permissions are required for our app so that it is able to access all of the Flows configured in your Homey. However, this is read-only, the app will not modify them.

App Configuration (Flows and Advanced Flows)

Configure Flows (in the Homey Mobile or Web app) and Advanced Flows (Homey Web app only) with one of our “When…” trigger cards from Apps > Rithum -

• Standby Screen Held - Triggered by a short hold of a finger on the Rithum Switch screen when in standby

• Scene Button Pressed - Triggered from a Scenes Screen button press on Rithum Switch

Standby Screen Held ‘When…’ Card

Scene Button Pressed ‘When…’ Card

• If Label 1 is entered then it is shown on line 1 instead of the Flow name

• If Label 2 is entered then it is shown on line 2

• If Label 1 is omitted then the Flow name is shown on line 1. The label can be split over the two lines by including a colon, e.g. “Bright: Kitchen” (but will not apply if Label 2 has been entered)

The trigger card fields also serve another purpose - to differentiate between different cards. If the fields of two trigger cards were the same, then both of the associated Flows would be triggered when either of the corresponding Scene buttons were pressed. In some cases it may be desirable to trigger multiple flows with a single button press, but where it isn’t, these fields can be used to make the trigger unique.

If entering button labels, then it will suffice to make the label(s) of each trigger different. If the Flow name is being used instead then enter a value into the Variant field to make the trigger unique.

Furthermore, if there’s a requirement to have the same button labels for multiple Flows (perhaps for use on Rithum Switch in different rooms) then enter a Variant to identify them. The Variant will be displayed when selecting Scene buttons on a switch, but will not be displayed on the button itself.

Dynamic Labels

Scene button labels can be dynamic by including Logic Variable Tags in them, as follows:

Homey Pro Core Plugin for Rithum Switch

The Homey Pro Core plugin enables Rithum Switch to be integrated with your Homey Pro. This plugin is available for purchase here. After purchasing, follow the instructions to assign your licence in your new licence email.

When successfully installed, in the settings menu on your switch:

1. Select Integrations > Add Integration > Homey Pro Core

2. Within a second or two, the Homey Pro(s) on your network should be listed. Select the name of the Homey Pro that you wish to connect to

3. After successfully connecting, press Go There to continue configuration in the Screens > Scenes Screen menu

4. Flows configured with a Scene Button Pressed trigger will be listed as available buttons. Select the buttons that you’d like included on the Scenes Screen by pressing on them, followed by pressing on the tick in the top-right corner to save your selection

5. Your newly added Flow buttons will then be listed alongside any other Scene buttons configured. Use the up and down arrows to reorder your buttons as required

6. Also select Flows to include as child scenes within Group Scene buttons as required

7. If you have configured a Flow with a Standby Screen Held trigger card then go to the Gestures settings menu. Select Hold followed by the name of your connected Homey. Select the Flow to be triggered from the list displayed

8. Configure lighting zones to be included in the Levels screen via the Screens > Levels Screen menu

Rithum Stat Thermostat Device

When Rithum Stat is enabled on Rithum Switch then it will be available to be added as a thermostat device in Homey. Rithum Stat can then be controlled via the climate panel in Homey, or used in Flows via the device's trigger and action cards.

Refer to the Rithum Stat and Climate Screen sections of https://support.rithumhome.com/hc/en-gb/articles/4405491941009-Setup-Use for details of configuration and use on Rithum Switch itself.

From the add new device screen, under Brands, select Rithum:

Select the RithumStat device:

Press "Connect":

Each connected Rithum Switch will be shown for selection, identified by its serial number. Press "Continue":

The added RithumStat will then be included in the zone in which it was added as a thermostat device: 

Press on the device to open the climate control panel.

Device Flow Cards

The RithumStat device provides the following Flow cards:

When...

• Target temperature changed
• Temperature changed
• Mode changed to (Off/Heat)
• Heat is required
• Heat is not required

And...

• Mode is (Off/Heat)
• Heat is required (Yes/No)

Then...

• Set the temperature to (temperature)
• Set the mode to (Off/Heat)

The state of Rithum Stat in your Rithum Switch will then be synchronised with the Rithum Stat device in Homey. Note that any changes made via Rithum Switch may take up to 10 seconds before being reflected in Homey.

If you require any further assistance then please contact us at Rithum support.