rako WK User manual

WK-HUB Instruction Manual
For programming a wired system: “Wired system Programming
Guide”
Please read HUB info sheet before proceeding with this manual
Contents:
1 Functions of the WK-HUB
2 Installing the WK-HUB
3 Discovering the HUB and Setting the House Number
3.1 Discovering the HUB
3.2 Setting up the HUB using the Webpage Wizard
3.2 Managing the HUB House number
3.3 If you cannot connect to the HUB
4 Linking the HUB for cloud services
4.1 Where to find each cloud service
4.2 Linking the HUB to Cloud services
5 Adding the HUB as a device to Rasoft Pro
6 Uploading the project file
7 Downloading the project file
8 Events
8.1 Setting Events using Rasoft Pro
8.2 Setting Events via the HUB webpages
8.3 Setting Events using the Rako App.
9 Mappings
9.1 Mapping wireless commands to give multi-room functionality
9.2 Triggering Macros from Maps
10 Macros
10.1 Writing Macros
10.2 Triggering Macros
11 Holiday Mode
12 UDP Feedback
12.1 Live feedback
12.2 UDP feedback log
12.3 HUB Webpages logs

2
1 Functions of the WK-HUB
The WK-HUB will add the following features to a Rako wired system:
-Network interface: including remote control via mobile devices and programming
software. Also used for IP integration of 3rd party control systems.
- Cloud Gateway: Interfaces with Amazon Alexa, Google Home, Apple Homekit,
Sonos etc.
-Storing Project file information: Room, Channel and Scene information can be
stored.
-Timed Events: Automatic functions at fixed times including dawn & dusk.
-Mapping: Commands can be redirected to perform other tasks.
-Macros: Series of commands that are triggered by a single command or event.
Specific steps can be enabled and disabled giving conditional functionality.
-Holiday Mode: Replays recorded scene activity, creating an occupied look to a
property.
-Wired-Wireless Interface: The WK-HUB functions as an interface between wireless
signals and the wired network.
2 Installing the WK-HUB
-Step 1: Plug RJ11 cable provided into the WK-HUB and an available RJ11 port in a
RAK-LINK/RAK-STAR/WPCON-C etc.
-Step 2: Plug the Ethernet patch cable from the WK-HUB to a spare port in a router or
network switch.
-Step 3: Mount the WK-HUB to a wall using fixing point at top of case if desired.
WK-HUB Manual Version 1.0.0

3
3 Discovering the HUB and Setting the House Number
Before proceeding with any programming the HUB needs to be
discovered and the House number set. This is done via a webpage
setup wizard.
3.1 Discovering the HUB
Open Rasoft Pro programming software. Ensure that the laptop is
connected to the same network as the HUB.
The HUB should appear in the “Communication” window in the
bottom right of the software with a red stop sign. If it does not
appear press “Refresh”.
3.2 Setting up the HUB using the Webpage Wizard
To access the HUB Webpages right click the communication device
in the bottom right of the software. Select “Open in Browser”
WK-HUB Manual Version 1.0.0

4
Step 1 - Welcome page, select “Next to begin setup”.
Step 2 - Set a Password, this will be used to login to the webpages. It will also be the
password used to login to the App if a password is needed.
Step 3 - Sets the House number of the HUB and therefore system. This should be set to
match the Rasoft Pro project file as defined in the “New Project Wizard”.
Step 4 - Select “Finish” to complete setup.
3.2 Managing the HUB House number
Leaving the HUB on the default House address of 1 is strongly discouraged. Leaving
the House number as 1 drastically increases the likelihood of interface from nearby
Rako systems.
The HUB always has a default House Address of 1 if has not been setup before.  When
beginning any programming using the HUB it is important to first ensure the House is set the
same as the address used when creating the Project File.
The change the House number if the HUB has already been set up as described in 3.2 see
below:
WK-HUB Manual Version 1.0.0

5
As a finally check it is advisable to disconnect and reconnect to the Bridge:
If no pop-up box appears then the HUB House number and Project file House number are
the same.
WARNING
If a pop up box appears with a warning about the House number click “Cancel”. Do not
continue programming this means there is a conflict between the “Project File House
Number” and “HUB House Number”.
3.3 If you cannot connect to the HUB
If the software cannot connect to the HUB first restart the software and ensure that it is fully
updated. If the HUB still does not appear it is most likely a networking issue. If this problem
cannot be solved then the HUB can be connected to point to point using a standard ethernet
cable.
NB
By default the HUB is connected via DHCP, this and other network settings can be edited via the HUB
webpages. It is possible to clear all network settings from a HUB. Please call Rako technical support
for information on how to do this.
4 Linking the HUB for cloud services
To be able to access cloud services the HUB must be linked to a my.rakcontrols.com
account.
4.1 Where to find each cloud service
Some cloud services are configured and customised from the HUB webpage whereas others
are from my.rakocontrols.com
HUB webpage: Sonos Activities (new cloud API and “ACM” style custom IP strings)
including custom and default templates (RCM/WCM-audio style keypads)
My.rakocontrols.com: Amazon Alexa, Google Home and Apple Homekit including “Custom
Scenes” and advanced apple homekit configuration (Channel and Room mode etc.)
WK-HUB Manual Version 1.0.0

6
NB
More detailed descriptions of how to use the more advanced settings within the cloud services are
linked from the relevant section of either the HUB webpages or my.rakcontrols.com
4.2 Linking the HUB to Cloud services
This is linked via the HUB webpages, navigate to the “Cloud” section from the menu on the
right hand side of the screen. This will open a page as below:
NB
Make sure that all “Service Status” is green before proceededing with the following steps:
Step 1 - Press “Connect”: this will link you to the my.rakocontols.com page.
Step 2 - Press “Login/Register” if you already have a
my.rakcontrols.com use the email and password that is
used for this, if not create an account.
Step 3 - Once logged in the code within the HUB will
be automatically verified. Please wait, this process
may take a couple of minutes
WK-HUB Manual Version 1.0.0

7
Step 4 - Once it has linked the HUB will ask to be given a “Nickname”. This is how it will be
referred to in the my.rakocontrols.com interface. It is not the same as the “HUB name” as
defined within the HUB setup wizard.
Once completed the my.rakocontols.com “Devices” page should appear as below:
5 Adding the HUB as a device to Rasoft Pro
Once the HUB has been successfully connected it will need to be added into the software as
a device.
- Select “File”- “New Device” to open the new device wizard. Choose “HUB” as the
device to be added.
- Select “Next” on the “Assign to Room” step. No room or channel needs to be
associated to the HUB.
- Select the HUB from the list, it will appear if you are successfully connected in the
communications window. Click “Refresh” if it does not appear.
- The HUB should now appear in the device list with green text and a blue icon. The
device is now assigned.
- Press the “Update Now” button in the centre of the screen to complete setup. If this
does not appear click on the HUB in the device list.
6 Uploading the project file
Once the entire system has been completed the project file should be uploaded to the
HUB. The HUB stores the Room, Channel and Scene information for the system. This
information is required for the App. to operate correctly.
The “Smartphone/Web Data” tab is used to upload the Project File to the HUB. Once
selected it will open the page as below. Press “Save & Upload Room Data To HUB” to
upload.
WK-HUB Manual Version 1.0.0

8
Type - This will change the appearance of the icon used at the top of the room screen on the
App. It will also affect the keypad that appears. For example a room set to “switch” will show
two buttons: “on” and “off” whereas a “blind” type room will show three buttons: “open”,
“stop” and “close”.
Mode - The mode of the room is only set when “lighting” is selected as the type. It will set the
variety of “keypad” that will appear in the App. Typically it is best to make this match the
physically keypad in the room.
NB
1) If a number of scenes that is not 4, 7 or 16 is desired then “named scenes” should be
selected. Give custom names to the scenes in the room editor and any number of scenes can
be made to appear on the App.
2) While the order of the rooms can be changed from this screen the order of the channels is
always fixed. To get channels in a specific order they must be addressed or mapped in the
desired order.
7 Downloading the project file
If information has been uploaded to the HUB then it is possible to import the Room, Channel
and Scene data into a blank project file.
The tab used for downloading information from the HUB is called “Room Import” select it to
open the page below.
WK-HUB Manual Version 1.0.0

9
-Step 1: Press the “Download Data” at the top of this page. This will open the data for
preview on this page.
- Step 2: Press “Refresh List” if the rooms do not appear. If no rooms appear or only
“default room” or “test bench” then there is no information to be downloaded from the
HUB.
-Step 3: Press “Import Data” to write the Room and Channel information in to the
Project File.
-Step 4: Press “Refresh Channel Levels” to write the Scene data in to the Project File.
8 Events
Events can be viewed, added and changed using either Rasoft Pro, The Rako App or HUB
webpages. It should be noted that calendar event conditions can only be set fom the HUB
webpage interface.
The HUB can generate automated Events that trigger commands at specific times.
WK-HUB Manual Version 1.0.0

10
For example it is possible to automatically turn on the Garden lights on at Dusk and turn off
the Garden lights at Dawn.
8.1 Setting Events using Rasoft Pro
HUB Events can be viewed and edited using Rasoft Pro. To open the events page in the
software select the HUB in the device editor and select the “Events” tab from the top of the
window.
Mappings List:
All Events are listed down the left hand side of the screen. Select it such that it is highlighted
to edit the “Event Trigger/Active Days” and “Output Action” sections for this Event.
Event Trigger/Active Days:
The “Event Trigger” and “Active Days” are the timing conditions that define when the event
will occur.
NB
The dawn and dusk settings can be changed via the location settings in the webpage interface. An
offset from this value can be set from this screen if desired.
WK-HUB Manual Version 1.0.0