hager TJA560 User guide

01/2018 –6LE005108C
TJA560
IoT Controller
Installer Manual

2
1. INTRODUCTION...................................................................................................................................4
2. GENERAL INFORMATION ..................................................................................................................4
INTRODUCTION TO THE SYSTEM ...........................................................................................................................42.1
SYSTEM OVERVIEW .................................................................................................................................................42.2
THE IOT CONTROLLER ............................................................................................................................................52.3
SOFTWARE VERSION UPDATE FOR THE CONFIGUARATION SERVER ..............................................................62.4
AUTO/ROUTER FUNCTIONALITY.............................................................................................................................72.5
TECHNICAL SPECIFICATIONS.................................................................................................................................82.6
3. INSTALLATION....................................................................................................................................9
PHYSICAL INSTALLATION.......................................................................................................................................93.1
NETWORK INSTALLATION.......................................................................................................................................103.2 3.2.1 Installation behing a DHCP server...................................................................................................................................................10
3.2.2 Installation without a DHCP server...................................................................................................................................................10
SOFTWARE INSTALLATION.....................................................................................................................................113.3 3.3.1 iOS AND ANDROID: Install the launcher.........................................................................................................................................11
3.3.2 Windows ...........................................................................................................................................................................................11
4. EXAMPLE FOR CONFIGURING A PROJECT....................................................................................12
SKILLS CONFIGURATION ........................................................................................................................................134.1 4.1.1 LINKING THE IoT CONTROLLER TO MYHAGER .........................................................................................................................13
4.1.2 KNX skill ...........................................................................................................................................................................................13
4.1.3 Netatmo skill.....................................................................................................................................................................................13
4.1.4 Philips HUE skill ...............................................................................................................................................................................14
4.1.5 Sonos skill.........................................................................................................................................................................................14
SKILLS CONFIGURATION ........................................................................................................................................154.2 4.2.1 KNX skill ...........................................................................................................................................................................................15
4.2.2 Philips HUE skill ...............................................................................................................................................................................15
4.2.3 Sonos skill.........................................................................................................................................................................................16
4.2.4 Netatmo skill.....................................................................................................................................................................................16
CREATE A SCENE.....................................................................................................................................................184.3
CREATE A DIGIGRAM TO PLAY THE SCENE .........................................................................................................194.4
CREATE A NOTIFICATION........................................................................................................................................194.5
CREATE AN EVENT SIGNALLING NOTIFICATION..................................................................................................204.6
PLAY A SCENE USING GEOLOCALISATION ..........................................................................................................204.7 4.7.1 Configuring the IFTTT account.........................................................................................................................................................20
4.7.2 Create the scenario in IFTTT ...........................................................................................................................................................21
PLAY A SCENE USING AMAZON ECHO..................................................................................................................244.8
5. IOT CONTROLLER FUNCTIONALITIES.............................................................................................26
DASHBOARD.............................................................................................................................................................265.1
CLOUD.......................................................................................................................................................................275.2
SKILLS.......................................................................................................................................................................285.3 5.3.1 Overview...........................................................................................................................................................................................28
5.3.2 KNX link............................................................................................................................................................................................30
5.3.3 Philips HUE.......................................................................................................................................................................................31
5.3.4 Sonos................................................................................................................................................................................................32
5.3.5 Netatmo Weather station..................................................................................................................................................................32
SCENES.....................................................................................................................................................................335.4
SCHEDULES..............................................................................................................................................................345.5
NOTIFICATIONS ........................................................................................................................................................345.6
DIGIGRAMS ...............................................................................................................................................................355.7 5.7.1 Create a digigram.............................................................................................................................................................................35
5.7.2 List of digigrams ...............................................................................................................................................................................35
SETTINGS..................................................................................................................................................................365.8 5.8.1 My account .......................................................................................................................................................................................36
5.8.2 Network.............................................................................................................................................................................................36
5.8.3 General.............................................................................................................................................................................................37
5.8.4 Configuration ....................................................................................................................................................................................38
5.8.5 Devices.............................................................................................................................................................................................38
5.8.6 Account management.......................................................................................................................................................................39
5.8.7 Update ..............................................................................................................................................................................................40

3
LIMITATIONS .............................................................................................................................................................415.9
LIST OF DATAPOINTS ..............................................................................................................................................415.10
LIST OF ALEXA VOCAL COMMANDS......................................................................................................................425.11

IoT Controller TJA560
Installer Manual
4
1. INTRODUCTION
The descriptions provided in this manual are intended to familiarise the installer with the IoT Controller provided
by Hager.
The procedures described in this manual are intended to help the installer with IoT Controller configuration during
installation.
Product reference: TJA560
2. GENERAL INFORMATION
INTRODUCTION TO THE SYSTEM2.1
The IoT Controller is a gateway between KNX products and third-party connected devices.
It allows access to all functionalities of non-KNX products with an IP connection. It can be installed on a new or
existing installation and does not require the presence of a domovea server.
You can access the system configuration through a web browser.
SYSTEM OVERVIEW2.2
The following diagram describes the physical architecture of an installation centred on an IoT Controller:

IoT Controller TJA560
Installer Manual
5
The system is based on two different networks:
- The KNX network (cable, radio or mixed) on which all KNX sensors, actuators, switches, etc., are
installed,
- The Ethernet network where all IP clients are connected to the LAN (local network): Connected devices
for using functionalities, along with PC, touch screens, or Smartphones for the configuration.
THE IOT CONTROLLER2.3
The TJA560 is a gateway between the KNX products and connected products from third-parties.
The product connects both:
• to the KNX bus via connector ;
• and to the local IP network via the two Ethernet ports, or .
This software operates in conjunction with web browsers installed on tablets, smartphones and PCs.
OS compatibility: iOS 8, Android 4.4, Windows 8.1
Browser compatibility: IE11, Chrome 35, Firefox 37.

IoT Controller TJA560
Installer Manual
6
The following table recapitulates the interpretation of each LED
LED function
LED ref
Status
Description
Power

Off
Unit without power
Blinks green
Unit start-up phase
Lights up green
Unit started
Blinks red
Unit supplied by the power reserve (10 s
max)
Lights up red
OS loading error
KNX

Off
Unit supplied by the power reserve (10 s
max)
Blinks green
Connected to the KNX bus - bus traffic
Lights up green
Connected to the KNX bus –no bus traffic
Lights up red
No KNX bus connection
Ethernet 1 and
2
et
Off
No network (or operating on power reserve –
10 s max)
Blinks green
No DHCP server detected, operating on
fallback IP address
Lights up green
Network detected and IP address allocated
Lights up red
IP address conflict
Blinks red
Waiting for IP address allocation
Portal

Off
No Hager portal connection
Blinks green
Hager portal connection attempt
Lights up green
Hager portal connection established
Lights up red
Hager portal connection inaccessible or
connection refused
Bus voltage
present

Lights up red
Check the bus voltage with a short press of
button . Red LED lit indicates KNX bus
present.
SOFTWARE VERSION UPDATE FOR THE CONFIGUARATION SERVER2.4
It is mandatory to update the IoT Controller software version before any first use.
The update is carried out Automatically when the IoT Controller is connected to an Internet box.
Connection to the network and the remote server is made automatically for the update (see chapter 5.8.7 for
configuration of the automatic update).

IoT Controller TJA560
Installer Manual
7
AUTO/ROUTER FUNCTIONALITY2.5
The switch lets you select the operating mode for the Ethernet network.
Switches
Ethernet port behaviour
SEL
COM
Ethernet Port 1
Ethernet Port 2
Hager Portal
KNX Bus
Auto
On-line
This is the normal operating mode when the IoT
Controller is connected to an external router.
The 2 ports are interchangeable and configurable in DHCP or
in static IP.
- With a client DHCP (default factory set mode), the IoT
Controller waits for an IP address coming from a DHCP server
connected to the network (the router). If, after 40 seconds, no
address has been attributed, the IoT Controller automatically
takes the fallback address: 192.168.0.252
- With a static IP address, the configuration server
immediately recognises the settings defined in the “server
configuration - Internet” tab in the configurator settings menu:
• Interface IP address
• Sub-network mask
• Default gateway address
Warning: Even in the case of an IP address conflict on the
network (other equipment already using the defined IP
address), the module does not automatically switch to the
fallback address.
Connected
Connected
Offline
This mode is a fallback mode in which the 2 ports are
interchangeable. Therefore, they are automatically configured
in client DHCP.
- If no IP address is attributed by a DHCP server after a wait of
40 seconds, the IoT Controller automatically assumes the
following fallback address: 192.168.0.252.
Disconnected
Disconnected
PC
On-line
To use when a PC is directly connected to the IoT
Controller. This mode activates the DHCP server built into
the module. The 2 ports are interchangeable and configured
with the following parameters:
- Interface IP address: 192.168.0.252
- Sub-network mask: 255.255.255.0
- Default gateway address: 192.168.0.1
Connected
Connected
Offline
This mode is a fallback mode. The 2 ports are
interchangeable and configured in client DHCP.
- If no IP address is attributed by a DHCP server after a wait of
40 seconds, the virtual interface of the IoT Controller module
automatically assumes the following fallback address:
192.168.0.253
Disconnected
Disconnected

IoT Controller TJA560
Installer Manual
8
TECHNICAL SPECIFICATIONS2.6
KNX power supply
KNX bus SELV 30 V =
Safety extra-low voltage
24 V = via power supply SELV Hager TGA200 or
TXA114 or via PoE
Consumption on the bus line
10 mA max - 30 V =
Consumption on the auxiliary power supply
200 mA max - 24 V=
Standard/Standby consumption on the KNX bus
8 mA
Standard/Standby consumption on the 24 V Ethernet
and non-connected USB
100 mA
Maximum dissipation (24V output)
5W
PoE power supply consumption
50 mA
Backup duration for the date and time
1 year minimum
Ethernet network communication
2 x 100/1000 BaseT
Bus connection
0.6 - 0.8 mm²
Power supply socket
0.75 - 2.5 mm²
Ethernet/IP network socket
2 x RJ45
Operating T°
0 °C —> + 45 °C
Storage T°
- 20 °C —> + 70 °C
Footprint
6 x 17.5 mm
USB2 Interface
2
Installation method
DIN rail
Operating altitude
< 2000 m
Pollution level
2
Surge voltage
4 kV
Protection rating (box) (box under faceplate)
IP20
IP30
Impact resistance
IK04
Overvoltage category
III
Standards
EN 60950-1, EN 50491-3, EN 50491-5-2, IEE 802.3 at,
USB 2.0, Handbook KNX 2.1

IoT Controller TJA560
Installer Manual
9
3. INSTALLATION
PHYSICAL INSTALLATION3.1
The IoT Controller TJA560 must be installed in the distribution board or in the VDI box (Voice, Data, Images).
The IoT Controller can also be connected to a PoE (Power over Ethernet) network
If there is no VDI distribution board, the server can be installed in the electric distribution board. In
this case, the ELV (Extra Low Voltage) and SELV (Safety Extra Low Voltage) connections must
be properly secured.

IoT Controller TJA560
Installer Manual
10
NETWORK INSTALLATION3.2
3.2.1 INSTALLATION BEHING A DHCP SERVER
The IoT Controller is connected to a DHCP server (router or any other device having a DHCP functionality).
In this case, the IoT Controller automatically obtains an IP address coming from the DHCP server.
3.2.2 INSTALLATION WITHOUT A DHCP SERVER
It is possible to connect the IoT Controller directly to the installer’s PC. In this case, the vertical switch must be
placed in the on-line position and the horizontal switch in the PC position. This mode activates the DHCP server
built into the module. The 2 ports are interchangeable and configured with the following parameters:
- Interface IP address: 192.168.0.252
- Sub-network mask: 255.255.255.0
- Default gateway address: 192.168.0.1

IoT Controller TJA560
Installer Manual
11
SOFTWARE INSTALLATION3.3
3.3.1 IOS AND ANDROID: INSTALL THE LAUNCHER
The launcher is an application that can find the IoT Controller IP address.
It is available for iOS and Android and can be downloaded from the Apple Store and the Play Store.
Once the application is launched
Select your IoT Controller
The name of your IoT Controller will appear (its default name)
Your platform’s web browser will open the configuration page for your IoT Controller
The connection will also initiate the “push notifications” functionality in addition to the Apple Watch
connection on iOS.
3.3.2 WINDOWS
From any other platform, including a PC using a Windows operating system, open your web browser and enter
your IoT Controller’s IP address.
There are several ways to find your IP address
From the “network” page in the Windows configuration panel, double click the IoT Controller
From your router’s configuration page (Livebox, Freebox, Fritzbox, etc.)

IoT Controller TJA560
Installer Manual
12
4. EXAMPLE FOR CONFIGURING A PROJECT
To make understanding easier, this chapter will outline a concrete example representative of most cases.
Example of a home with various applications:
- Phillips Hue command: ON/OFF + Variation in light brightness + Changing colour.
- Sonos command: Play/Pause + Volume
- Netatmo weather station: displays indoor and outdoor temperature
- Create a scene for musical ambiance in the living room
- Create the event to play this scene from a push button
- Create an event that sends an email notification if the alarm is triggered
- Play a scene depending on the user’s geolocalisation
- Play a scene launched by a vocal commend sent through Amazon Echo
To command the various modules, the various group addresses must be defined
Modules
Commands
Group
addresses
Format
DPT
Phillips Hue
On/Off
1/1/1
1 bit
1.001 switch
Luminosity
1/1/2
4 bit
3.007 dimming control
Colour
1/1/3
1 bit
1.001 switch
Sonos
Play/Pause
2/1/1
1 bit
1.001 switch
Volume
2/1/2
4 bit
3.x
Netatmo
Indoor temperature
3/1/1
16 bit
9.001 temperature °C
Outdoor temperature
3/1/2
16 bit
9.001 temperature °C
For the scene, a group address must be defined that corresponds to the lighting in the living room. We will select
the 4/1/1 address in the DPT 1.001 switch format. We must also define a group address corresponding to the
push button that plays the scene. We will select the 4/1/2 address in the DPT 1.001 switch format.
This is the same for the alarm, we must define a group address the corresponds to triggering the alarm. We will
select the 5/1/1 address in the DPT 1.001 switch format.
The I’m back scene will be played when the user is within a radius of 500 m around the house (IFTTT module
through user geolocation)

IoT Controller TJA560
Installer Manual
13
SKILLS CONFIGURATION4.1
4.1.1 LINKING THE IOT CONTROLLER TO MYHAGER
To use the various services, your myHager account needs to be linked to the IoT Controller
- Click the Cloud tab
- Fill in the user name and password for your
myHager account (or click Sign up for free to
create a myHager account)
4.1.2 KNX SKILL
- Click the Skills tab then Overview
- Click the KNX tab
- Activate the KNX module
- Enter the KNX module physical address
- Select the group address style: Two or three
levels
- Click Save skill to confirm
Refresh the HTML page to verify that the module is connected to the KNX bus
4.1.3 NETATMO SKILL
- Click the Skills tab then Overview
- Click the Netatmo tab
- Activate the Netatmo module
- Click Save skill to confirm

IoT Controller TJA560
Installer Manual
14
4.1.4 PHILIPS HUE SKILL
- Click the Skills tab then Overview
- Click the Philips HUE tab
- Activate the Philips HUE module
- Click Save skill to confirm
4.1.5 SONOS SKILL
- Click the Skills tab then Overview
- Click the Sonos tab
- Activate the Sonos module
- Click Save skill to confirm

IoT Controller TJA560
Installer Manual
15
SKILLS CONFIGURATION4.2
4.2.1 KNX SKILL
- Click the Skills tab then KNX
- Click the Add manually tab
- Enter the group address: 1/1/1
- Enter the object name: ON/OFF
- Select the type of object: DPT 1.001 switch
- Click Create new address to confirm
- Enter the other group addresses in the same way according to the following table:
Modules
Commands
Group
addresses
Format
DPT
Phillips Hue
On/Off
1/1/1
1 bit
1.001 switch
Luminosity
1/1/2
4 bit
3.007 dimming control
Colour
1/1/3
1 bit
1.001 switch
Sonos
Lecture/Pause
2/1/1
1 bit
1.001 switch
Volume
2/1/2
4 bit
3.x
Netatmo
Indoor temperature
3/1/1
16 bit
9.001 temperature °C
Outdoor temperature
3/1/2
16 bit
9.001 temperature °C
Others
Living room light
4/1/1
1 bit
1.001 switch
Music scene
4/1/2
1 bit
1.001 switch
Alarm
5/1/1
1 bit
1.001 switch
It is also possible to import the KNX project configured using the ETS or TXA100 (See chapter 5.3.2)
4.2.2 PHILIPS HUE SKILL
- Click the Skills tab then Philips HUE
- Click Pair bridge to declare the module
- Click Add Lamp to add the desired lamp

IoT Controller TJA560
Installer Manual
16
- Click Quick Config to create links with the group addresses
oClick Select on the Turn On/Off command
oSelect the 1/1/1 ON/OFF address by clicking Add
oClick Save to confirm
- Continue in the same way for addresses in groups 1/1/2 (brightness (4 bit) and 1/1/3 (colour loop)
- Click Close to confirm.
4.2.3 SONOS SKILL
- Click the Skills tab then Sonos
- Click Add device to add the desired module
- Click Quick Config to create links with the group addresses
oClick Select on the Play/pause command
oSelect the 2/1/1 Play/pause address by clicking Add
oClick Save to confirm
- Continue in the same way for addresses in groups 2/1/2 (Raise/lower volume (4 bits))
- Click Close to confirm.
4.2.4 NETATMO SKILL
- Click the Skills tab then Netatmo
- Enter the Netatmo account username and password

IoT Controller TJA560
Installer Manual
17
- Click Add module for the Indoor detector for the indoor temperature
- Click Add module for the Outdoor detector for the outdoor temperature
- Click Quick Config for the Indoor detector to create links with the group addresses
oClick Select for the Temperature information
oSelect the 3/1/1 Indoor temperature address by clicking Add
oClick Save to confirm
- Click Close to confirm.
- Click Quick Config for the Outdoor module to create links with the group addresses
oClick Select for the Temperature information
oSelect the 3/1/2 Outdoor temperature address by clicking Add
oClick Save to confirm
- Click Close to confirm.

IoT Controller TJA560
Installer Manual
18
CREATE A SCENE4.3
To create a scene, you must define the various actions to carry out. Below is the list of actions for the Music
scene:
- Turn off the lighting in the living room
- Turn on the Philips Hue lamp with the predefined brightness and colour.
- Start playing music with the predefined volume level.
To create this scene, follow the example:
- Click the Scenes tab
- Click Create new scene
- Enter the name of the scene to create: Music
- Click Action
oSelect the 4/1/1 Living room light address in the KNX folder
oSet the switch to OFF to turn it off
- Click Action
oSelect the Turn on command in the Hue directory
- Click Action
oSelect the Colour command in the Hue directory
oSet the desired colour
- Click Action
oSelect the Brightness command in the Hue directory
oEnter the desired brightness value
- Click Action
oSelect the Play command in the Sonos directory
- Click Action
oSelect the Volume command in the Sonos directory
oEnter the desired sound volume
- Click Save to confirm
It is possible to check the scene’s functionality during configuration by clicking the Test button
located next to the scene name.

IoT Controller TJA560
Installer Manual
19
CREATE A DIGIGRAM TO PLAY THE SCENE4.4
Once the scene has been created, define a command that will play this scene. In our example, it will be the music
push button (4/1/2) that will trigger the scene.
To create this event, follow the example:
- Click the Digigram tab
- Click Create digigram
- Enter the event name: Play music
- Click Trigger
oSelect the 4/1/2 Music scene address in the KNX directory
oSet the switch to ON
- Click Action
oSelect the Play scene command in the System directory
oSelect the Music scene
- Click Create digigram to confirm
CREATE A NOTIFICATION4.5
To create an email alert that the alarm has been triggered, follow the example:
- Click the Notification tab
- Click Create new notification
- Select the type of notification: Email or Push
- Enter the notification name: There is an alarm
- Enter the recipient's email address or select the devices
- Enter the subject
- Enter the message
- Click Save to confirm

IoT Controller TJA560
Installer Manual
20
CREATE AN EVENT SIGNALLING NOTIFICATION4.6
Once the notification has been created, define from which command the notification will be sent. In our example,
triggering the alarm will be notified by the address from group 5/1/1.
To create this event, follow the example:
- Click the Digigram tab
- Click Create digigram
- Enter the event name: Alarm
- Click Trigger
oSelect the 5/1/1 Alarm address in the KNX directory
oSet the switch to ON
- Click Action
oSelect the Notification command in the System directory
oSelect the There is an alarm notification
- Click Create digigram to confirm
PLAY A SCENE USING GEOLOCALISATION4.7
The objective is to play the I’m back scene when the user is within a radius of 500 m around his or her home. To
do this, we will use the IFTTT service.
4.7.1 CONFIGURING THE IFTTT ACCOUNT
oClick the Cloud tab
oClick the IFTTT Channel to access the web
page for the IFTTT service.
oConnect to your IFTTT account or create a
new account