Hager TJA670 domovea Basic & TJA470 domovea Expert
This document provides a comprehensive guide for installing and configuring the Hager TJA670 domovea Basic and TJA470 domovea Expert systems. It covers system overview, software installation, initial setup, project management, available functions, device details, and integration with external services.
1 Introduction
The objective of this document is to familiarize installers with the domovea server's configuration interface. It outlines the steps required for correct configuration, including system installation, network connection, and the use of mobile devices or PCs.
1.1 Document Objective
This document aims to guide installers through the configuration process of the domovea server. Key requirements include having the equipment installed, the server connected to the internet via a DHCP-enabled router, and being equipped with a mobile device (smartphone, tablet, PC) connected to the same network. An installer also needs a professional account on the myHager portal.
Note: It is highly recommended to use your own DHCP router (Wi-Fi + 3G/4G) for configuration and testing.
1.2 General Information on KNX Installations
A KNX installation is an electrical system where products communicate via a bus (wired or radio) to send or receive commands. Products can be classified by their connection to the KNX bus (wired or radio) and by their function (input, output, or system products).
- Wired products: Connected to the KNX bus via a KNX-compliant cable.
- Radio products: Connected via a KNX radio link, which can be unidirectional (emitters only) or bidirectional (emitters and receivers).
- Input products: Send commands (e.g., push buttons, presence sensors).
- Output products: Receive commands and control connected loads (e.g., lighting, shutters).
- System products: Essential for installation operation (e.g., bus power supply, media coupler).
2 General Description
2.1 System Presentation
domovea is a command and visualization software for KNX and IoT installations, allowing access to home automation functions via electronic devices. It offers features like disabling sequences, configuring the home based on events, and visualizing command execution.
2.2 System Overview
The domovea system comprises three modules:
- Server: TJA670 or TJA470, the physical interface between the KNX bus and the home IP network.
- Client: Software installed on a smartphone, tablet, or PC for user interface.
- Configurator: Software used to configure and program the client interface, accessible via PC, smartphone, or tablet using the Hager Pilot application or a web browser.
The system structure involves the KNX bus, a LAN network (router/switch/WLAN), and internet connectivity, allowing interaction with devices like smartphones, tablets, PCs, and smart home assistants (Google Home, Amazon Echo).
Diagram Description: A diagram shows the KNX bus connecting to the domovea server (TJA670/TJA470). The server is connected via LAN to a router/switch/WLAN, which provides internet access. Clients (PC, smartphone, tablet) connect to the network. Smart home assistants like Google Home and Amazon Echo are also shown connected to the network, indicating integration capabilities.
2.3 domovea Solution
The domovea server is available in two versions: Basic (TJA670) for basic functions and Expert (TJA470) for advanced functions. A summary table compares features like integrated configurator, maximum devices, IP cameras, voice assistant integration, sequence limits, remote access, KNX/IP interface, virtual thermostats, and video intercom integration.
2.4 Presentation of the TJA670-TJA470 domovea Server
2.4.1 Configuration Server
The server connects an IP network to KNX bus systems. It requires two applications: Hager Pilot for configuration and the domovea application for the end-user. The product connects to the KNX bus via connector 13 and to the local IP network via Ethernet ports 15 and 16. Compatible operating systems are iOS 11 or Android 6 and above.
Diagram Description: A diagram shows the physical connections of the TJA670/TJA470 server. It highlights the KNX bus connection (terminal 13), Ethernet ports (15, 16), power input (24V), and status LEDs (OK, on-line, off-line). The diagram also shows the internal components and their numbering.
2.4.2 Software Version Update for the domovea Server
Before the first update, it is mandatory to update the server's software. Updates can be performed automatically by connecting the server to an internet-enabled router or manually by copying the update file to a USB pen drive.
Automatic Update: Connect the server to a router with internet access. The connection and update are automatic. Refer to section 5.2.1.1 for details.
Manual Update: Download the update file from the Hager website. Copy it to an empty USB pen drive, insert the USB drive into one of the server's USB ports. The 'OK' LED will blink for about a minute, then stay lit. Remove the USB drive to complete the update.
2.4.3 Auto/Router Functionality
Both Ethernet inputs can be used to connect the server to the local network. They are switched inputs associated with a single software interface. The table below details the behavior based on the switch settings (online/auto, PC, offline/auto/PC) and the network connection status.
| Switches | Ethernet Input Reaction | Connection to Internet | Status on KNX Bus | |
|---|---|---|---|---|
| COM ② SEL | Ethernet Input 1 | Ethernet Input 2 | ||
| online Auto | This is the normal operating mode when connected to an external router (ISP). The server can be configured via DHCP or with a fixed IP address. In DHCP client mode (factory default), the server requests an IP address from the router. If none is assigned within 40 seconds, it defaults to 192.168.0.253. With a fixed IP, parameters are set in the 'Configuration-Interface' menu. Note: With a fixed IP, the server does not automatically adopt the default address in case of IP conflict. | active | active | |
| PC | Used when the PC is directly connected to the server. This mode activates the integrated DHCP server. The two inputs are interchangeable and configured with specific parameters: IP address: 192.168.0.253, Subnet mask: 255.255.255.0, Default gateway: 192.168.0.1, Assignable IP range: 192.168.0.10 to 192.168.0.50. | active | active | |
| offline Auto/PC | This mode configures the server as a DHCP client. If no IP address is assigned by a DHCP server after 40 seconds, the server assumes the default address: 192.168.0.253 / 255.255.255.0. | inative | inative |
2.4.4 Technical Specifications
| Specification | Details |
|---|---|
| KNX Power Supply | KNX Bus TBTS 30 V = |
| Bus Current Consumption | 10 mA max. - 30 V = |
| External Power Supply or PoE 15 16 | 24 V – 30 V = via TGA200 type TRS Hager or PoE |
| Typical/Standby Consumption (2-wire bus) | 35 mA / 12 mA - 24 V = |
| Max. Auxiliary Power Consumption | 760 mA max. - 24 V = |
| Standby Consumption (24 V Ethernet and USB unused) | 330 mA |
| Max. Dissipation (24 V output) | 10 W (without USB), 15 W (with 2 USB max.) |
| PoE Power Consumption | PoE Class 3: 13 W |
| Ethernet Network Communication | 2 x 100/1000 BaseT |
| Max. Length of 24 V Power Cable | 10 m |
| 2-wire Bus Connections 10 11 | 0.2 - 1.5 mm² |
| Power Terminals 1 | 0.75 - 2.5 mm² |
| Ethernet / IP Network Ports 15 16 | 2 x RJ45 |
| Operating Temperature | -5 °C to +45 °C |
| Storage Temperature | -20 °C to +70 °C |
| Width | 6 modules (DIN rail) |
| Dimensions (W x H x D) | 106 x 90 x 67 mm |
| USB Interface 2 9 14 | 2 |
| Installation Mode | DIN rail (EN60715) |
| Operating Altitude | < 2000 m |
| Pollution Level | 2 |
| Surge Voltage | 4 kV |
| Protection Indices | • Housing: IP20 • Protected Housing: IP30 |
| Impact Resistance | IK04 |
2.5 Software Installation
2.5.1 Hager Pilot Application Installation
On Mobile Device: Search and download the Hager Pilot app from the App Store® or Google Play Store®. Install the app; an icon will appear on the screen.
On Windows PC: Search and download the Hager Pilot app from the Hager website. Install the app; an icon will appear on the screen.
Download on App Store Available on Google Play
Hager Pilot
2.5.2 Launching the Hager Pilot Application
Connect your mobile or fixed device to the same network as the server. Open the Hager Pilot application. A server visualization window will appear. Select the TJA670-XXXXX or TJA470-XXXXX server. If the server is not listed, tap 'Add a server' and enter the IP address, server name, or serial number. For remote servers, use the serial number found in the remote access menu.
2.5.3 Accessing the Configurator without Hager Pilot
In some cases, direct access to the configurator is necessary. This can be done via a web browser by entering the server's IP address (obtained from the local DHCP server or default 192.168.0.253 if the switch is in 'PC' mode). Alternatively, using the file explorer, UPnP devices appear in the 'Network' section; double-clicking the TJA670 or TJA470 icon opens the configuration in the browser.
2.5.4 Logging into the Server
At this stage, only the administrator profile ('admin' with password '1234') is active. Log in using these credentials.
2.6 System Usage
To use the system with mobile devices or PCs, the domovea application must be installed.
2.6.1 domovea Application Installation
On Mobile Device: Search and download the domovea application from the App Store® or Google Play Store®. Install the app; an icon will appear on the screen.
On Windows PC: Search and download the domovea application from the Hager website. Install the app; an icon will appear on the screen.
Download on App Store Available on Google Play
domovea
2.6.2 Launching the domovea Application
Connect your mobile or fixed device to the server's network. Open the domovea application. A server selection window will appear. Select the TJA670-XXXXX or TJA470-XXXXX server to connect.
2.6.3 Logging in with the domovea Application
The default administrator login is 'admin' with the password '1234'.
2.7 Connection via Integrated KNX/IP Interface
The domovea server allows connection to the KNX bus via an IP link for ETS configuration. It uses the KNXnet/IP standard for communication between KNX lines and IP networks. This IP interface access is local.
Diagram Description: A diagram illustrates the connection of the domovea server to the KNX bus and the IP network (LAN, router/switch). It shows how the server acts as an interface for ETS software to communicate with the KNX bus.
With ETS, the domovea server appears as a communication interface for the KNX bus. The interface displays information such as individual address, MAC address, IP address, and port.
3 First Use
After selecting the server and during the first use, there are three ways to start the installation:
- Creating a new project.
- Importing a backup file.
- Performing an installation rediscovery.
3.1 New Project
This procedure allows creating a new installation and manual configuration of domovea. Click 'New Project' and enter the project name. Optional project information can be added by clicking 'Customer Information'. Refer to tutorial 2 for more details.
3.2 From an Existing Backup File
This procedure allows creating a new installation from a backup file. Five compatible file formats are supported: Easytool (*.txa), TX100 (*.txh), domovea 1 (*.ddb), domovea 2 (*.hbox), and ETS (*.knxproj). Click 'Import' and select the backup file. Refer to tutorial 3 for more details.
3.3 Via Rediscovery
This process allows creating a new installation when no backup is available. It relies on rediscovering the installation. Only products recognized by the Easytool configurator will be considered. Click 'Rediscovery'.
4 My Project
The project view differs based on the domovea server version (Basic TJA670 or Expert TJA470). The Basic version displays 'easytool' and 'domovea' applications, while the Expert version also includes 'access' for videoporteiro configuration.
Available applications depend on the domovea server version:
- Easytool Configurator: Click the 'easytool' icon to access KNX product configuration. Refer to the TXA101 configurator installation manual for more information.
- Access Configurator (TJA470 Domovea Expert only): Click the 'access' icon to configure the Elcom videoporteiro. Refer to the relevant manual for details.
- domovea Configurator: Click the 'domovea' icon to configure the domovea application.
5 Available Functions: Menus
5.1 Account Configuration
This section allows configuring the user account. General parameters are accessible from the top-right menu.
Click the user icon to access the menu, then click the user icon again. The window allows activating/deactivating the user profile, adding descriptions, changing the password, setting the time format, and selecting the interface language. Click 'Save' to confirm changes.
5.2 Parameters
The Parameters section provides access to Configuration, Users, Data Management, and About information.
5.2.1 Configuration
This option allows product configuration. General parameters are accessible from the top-right menu. Click the menu icon, then 'Configuration'.
5.2.1.1 Update
Click 'Update' to view software versions (server, BSP, JVM). Select the update mode: automatic installation (default), manual installation, or check for updates. The option 'Never check for available updates' prevents the server from checking for new software versions.
5.2.1.2 Interface
Click 'Interface' to view and modify the server name, MAC address, IP address (automatic or manual), and DNS server (automatic or manual). Click 'Save' to apply changes.
5.2.1.3 Remote Access
Remote access allows connecting to the configuration server and client from an internet-connected device. Configure the remote address link and activate remote access (default: activated). Click 'Save' to confirm. Connection can be made via Hager Pilot or the domovea client by selecting the server or entering its IP address/name/serial number. Alternatively, use a web browser with the remote access link.
Refer to tutorial 4 for more information on activating remote access.
5.2.1.4 Time Management
Click 'Time Management' to select the time zone and synchronize with an internet time server (NTP). You can also manually set the date and time. Click 'Save' to confirm.
5.2.1.5 domovea
Click 'domovea' to configure the KNX group address format (1, 2, or 3 levels) and select the currency. Click 'Save' to apply changes.
5.2.1.6 Easytool
Click 'Easytool' to activate help for input channels (Rocker function), enable automatic search for new products, set the search periodicity (default: 10 min), and save settings.
5.2.2 Users
This section allows managing administrator and user accounts. Two operations are available: granting administrator rights and creating/managing additional accounts.
5.2.2.1 Transfer of Administrator Rights
Upon completion of configuration, transfer administrator rights to the owner. Click the user icon, then 'Users'. Enter myHager account credentials, installation country, and follow on-screen instructions. The Admin account becomes invalid after the transfer.
Refer to tutorial 5 for more information.
5.2.2.2 Creation and Management of Additional Accounts
After transferring rights, create and manage additional accounts. Click the user icon, then 'Users'. To create a new account, click 'New', enter credentials, choose account type (Installer, Main User, Restricted User), select language, and click 'Save'.
To modify an existing account, select it, click 'Alter', make changes, and click 'Save'.
Refer to tutorial 6 for more information.
5.2.3 Data Management
Manage domovea project configuration files stored on the server. Files can be downloaded for external backup. Click the menu icon, then 'Data Management'. 'Reset Installation' resets the server to its current configuration (backups, users, network settings are unaffected). 'Factory Reset' restores factory settings, deleting all data.
The reference backup is the last backup made by the installer and cannot be deleted. It allows restoring the system to the state it was in when the client received it.
- Click 'Restore' to restore the reference configuration from the server.
- Click 'Download' to save the project to a file (*.hbox).
Backup allows creating a security copy of the installation. Click 'Save' to create a backup, 'Restore' to restore from a saved configuration, or 'Download' to save the project to a file.
5.2.4 About
This menu provides information on the configuration interface software version and privacy policies. Click 'About' to view the domovea software version and 'Close' to exit.
About Window: Displays 'Hager Pilot' version 2.1.0, software license information, privacy policy, and copyright notice.
6 My domovea Installation
6.1 Dashboard (Control Panel)
Once an installation is selected, the Dashboard provides an overview of the installation elements:
- Number of groups.
- Number of devices.
- Number of valid or invalid automations.
- Number of active and inactive measurements.
- Check for unconfigured devices.
- Check for unconfigured automations.
The dashboard displays sections for 'Architecture', 'Groups', 'Devices', 'Automations', and 'Measurements', showing counts and status for each.
6.2 Installation
6.2.1 Devices
A device is any KNX installation equipment controllable or viewable via domovea, such as lighting, shutters, or heating (up to 500 devices per installation). For products not recognized by the easytool configurator, domovea can only retrieve data from the installation. Ensure KNX products have compatible object formats.
Click 'Add a device' to create a device: select the device type (KNX, Camera, IoT) and choose the specific device. Configure device properties and add group addresses if necessary. Refer to tutorial 7 for adding KNX devices not detected by easytool.
6.2.2 Groups
A group represents a part of the installation, such as a room, floor, or zone. Groups structure the project (up to 100 groups per installation). Click 'Create a new group' to start, then name and optionally describe the group. Repeat for each group. After creating groups, assign devices by selecting them and choosing the target group.
Refer to tutorial 8 for creating groups in domovea with Hager Pilot.
6.3 Automations
(Only with TJA470 - Domovea Expert) Automations are not available on the TJA670 Basic server; they are available in the client application (domogram). Refer to tutorial 9a for configuring domograms.
6.3.1 Sequences
Sequences create complex scenarios for conditional functions based on sensor states. A sequence consists of triggers, conditions, and actions. Triggers evaluate events, conditions perform complex evaluations, and actions control output devices. Up to 100 sequences are allowed.
Click 'New' in the Sequence section to create a sequence. Edit the sequence, add a description, then add triggers, conditions, and actions. Click 'OK' or 'Register' to save preferences. Refer to tutorial 9b for configuring sequences.
6.3.2 Home Status
Home Status defines the overall state of the house, allowing activation or deactivation of sequences. Four default statuses exist (Home, Away, Night, Vacation), with up to four additional statuses possible (total of 8). Click 'New' in the Home Status section to create a new status, name it, choose an icon, and add a description. Then, add triggers and select sequences to execute. Refer to tutorial 10 for configuring Home Status.
6.4 Measurements
6.4.1 Measurements
The domovea energy visualization function helps reduce energy costs. KNX products transmit data to the domovea server, which archives and displays it on visualization devices. Up to 100 measurement devices are supported. Devices can be added automatically by the server or manually for energy devices (electricity, gas, water). Refer to section 6.2.1 for device creation.
6.4.2 Subscriptions
A subscription defines energy consumption costs based on tariffs and data (day, hour). Up to 10 subscriptions are allowed. Click 'New' in the Subscriptions section to create a subscription, choosing the type (electricity, water, gas), setting consumption or production, and either using a predefined model or adding tariffs manually. Refer to tutorial 11 for configuring energy tariffs.
6.5 User Rights Management
This function defines user access rights to the installation, varying by application case. For example, a child might only access their room, or a hotel receptionist might manage all rooms while guests have limited access.
Click 'User rights', select the user, and define accessible groups, devices, and sequences. Refer to chapter 5.2.2 Users for user account creation. Tutorial 12 provides more details.
6.6 Configuration
This section is identical to the project configuration (see chapter 5.2.1 Configuration).
7 List and Details of Devices
7.1 KNX Devices
7.1.1 Comfort
This section lists devices available for project creation, detailing their actions and visualization states.
| Devices | Actions | Visualization |
|---|---|---|
| Light | On Off Adjust intensity to x % |
On Off Intensity to x % |
| RGB(T)(W) Light | On Off Adjust intensity to x % Set color Adjust white temperature (e.g., 4000°) |
On Off Intensity to x % Color White temperature |
| Controlled Socket | On Off |
On Off |
| Weather Automation | Activate facade shading x Activate shading on all facades Deactivate facade shading x Deactivate shading on all facades Activate presence Activate absence |
Facade shading x activated Shading activated on all facades Facade shading x deactivated Shading deactivated on all facades Heat protection activated Heat recovery activated Presence Absence |
| Shutters | Open Close Open lamellas Close lamellas Shutter position to x % Lamella position to x % |
Open Closed Shutter position to x % Lamella position to x % |
| Thermostat | Heating mode Cooling mode Comfort mode Eco mode Night mode Protection mode Adjust heating setpoint to x °C Adjust cooling setpoint to x °C |
Current temperature to x °C Heating mode Cooling mode Comfort mode Eco mode Standby mode Protection mode Setpoint temperature to x °C |
| Virtual Thermostat (TJA470 Domovea Expert only) | Valve open Valve closed Valve position in % |
Comfort mode Eco mode Standby mode Protection mode |
7.1.2 Security
| Devices | Actions | Visualization |
|---|---|---|
| General Heating Control | On Off |
On Off Zone status x HVAC zone mode x Current zone temperature x Power cut-off |
| Hot Water | Override Forced |
Override activated Forced activated |
| KNX Scenario | Start action x | Action x started |
| Forced | Activate/deactivate forced mode | Forced mode activated/deactivated |
| Audio | On Off Play Pause Adjust volume to x % Mute mode Repeat mode Random mode Next source (or playlist) Previous source (or playlist) Next designation Previous designation |
On Off Playing Pause Volume to x % Mute mode activated Repeat mode activated Random mode activated Playing music Playing playlist Artist playing |
| Ventilation | Activate/deactivate ventilation Adjust speed level to x % Adjust turbo mode |
Status indication Speed level to x % Turbo mode activated |
7.1.2 Security
| Devices | Actions | Visualization |
|---|---|---|
| Alarm Zone | Arm Disarm Arm complete system Disarm complete system Arm zone x Disarm zone x |
Armed Disarmed Intrusion detection Complete system armed Complete system disarmed Zone x armed Zone x disarmed |
| Central Intrusion | Protected entry Anomaly Discrete Alarm Intrusion Intrusion confirmed Alert Silent alarm Fire alarm Technical alarm |
7.1.3 Sensors
| Devices | Actions | Visualization |
|---|---|---|
| Electric Lock | Open door | Door open |
| Temperature | None | Temperature to x °C |
| Wind | None | Wind to x km/h |
| CO2 | None | CO2 to x ppm |
| Humidity | None | Humidity to x % |
| Luminosity | None | Luminosity to x lux |
| Binary Input | None | On Off |
| Rain | None | Rain |
| Smoke | None | Smoke alarm Heat alarm Room alarm Detector status Local deactivation Manual test Lifespan Beat frequency |
| Weather Station | None | Luminosity to x lux Rain External temperature to x °C Internal temperature to x °C External humidity to x % Wind speed to x km/h |
7.1.4 Energy
| Devices | Actions | Visualization |
|---|---|---|
| Electricity | None | Power Energy Tariff Flow Count |
| Gas | None | Flow Count |
| Water | None | Flow Count |
7.1.5 Generic
| Devices | Actions | Visualization |
|---|---|---|
| Generic Device ON/OFF | On Off |
On Off |
| Generic Device Dead Man | On Off |
On Off |
| Generic Impulse Device | On | On |
| Generic Device | Insert value x on KNX bus | Value equals x |
7.2 Cameras
This section describes how to create a link between an IP camera and the domovea installation. Click 'Add a device', select 'IP Camera' under 'Camera', then 'Search for cameras' to discover devices on the network. Click 'Add', optionally change the device name, and click 'Test' to verify the camera image. Manual installation is also possible by selecting 'Onvif' if your camera is compatible, or 'Generic' for other types, then entering configuration parameters.
Refer to tutorial 13 for more information.
7.3 IoT Devices
domovea also serves as a supervision tool for smart home IoT devices.
7.3.1 Philips Hue
Add a Philips Hue device by clicking 'Add a device', selecting 'Philips Hue' under 'IoT'. Click 'Search Philips Hue' if your bulb is not listed, then 'Link' on the Hue point to detect it. Click 'Add', optionally change the device name, and fill in KNX group addresses if needed.
Refer to tutorial 14 for controlling Philips Hue devices.
7.3.2 Sonos
Add a Sonos device by clicking 'Add a device', selecting 'Sonos' under 'IoT'. Click 'Search Sonos speakers' if your speaker is not listed, then 'Add'. Optionally change the device name and fill in KNX group addresses.
Refer to tutorial 15 for controlling Sonos speakers.
7.3.3 Netatmo
Add a Netatmo weather station by clicking 'Add a device', selecting 'Netatmo' under 'IoT'. Enter your Netatmo account username and password, click 'Add', optionally change the device name, and fill in KNX group addresses.
Refer to tutorial 16 for adding a Netatmo weather station.
7.4 Additional Connectivity Control with the Exterior
To allow external devices to control the installation, access must be authorized. Click 'Groups' at the top of the screen. Select a group to enable external access and click the padlock icon. Repeat for each group. Note that for subgroups, the padlock must be opened for each subgroup individually.
Refer to tutorial 17 for activating external access with skills like Alexa, Google, IFTTT.
7.4.1 Alexa
Add Amazon Alexa voice assistant by going to the Amazon Alexa website or app. Select 'Skills', install the 'Hager domovea' skill, enter your Alexa and myHager account credentials, and follow the instructions.
Refer to tutorial 18 for controlling domovea with Alexa.
7.4.2 Google Home
Add Google Home voice assistant by going to Google or the Google Home app. Navigate to 'More settings', 'Home control' under 'Assistant', then 'Parameters'. Click '+' and search for 'domovea'. Enter your myHager account credentials and follow the instructions.
Refer to tutorial 19 for controlling domovea with Google Assistant.
7.4.3 IFTTT
Declare the IFTTT service by visiting the IFTTT website. Create an account if necessary, search for domovea applications, and associate your domovea installation with other connected objects following the instructions.
Refer to tutorial 20 for creating an Applet with IFTTT.
