TRIDONIC em-LINK v3 software Single-Battery Emergency Light User Guide

TRIDONIC em-LINK v3 software Single-Battery Emergency Light

Legal information

Copyright
Copyright © Tridonic GmbH & Co KG
All rights reserved.
Manufacturer
Tridonic GmbH & Co KG
Färbergasse 15
6851 Dornbirn AUSTRIA
Tel. +43 5572 395-0
Fax +43 5572 20176
www.tridonic.com
Document number
em-LINK v3
1.0 | 07.2022 | en

How to use these instructions

We are pleased that you have chosen this Tridonic GmbH & Co KG product. So that you can get the most from these instructions, this section provides the following information:

• Signs and icons in these instructions
• Further information
• Target audience of these instructions
• Software version

Signs and icons in these instructions

The following signs and icons are used in these instructions

Table 1: Signs and icons in these instructions

Further information
More information on your emergency lighting system’s setup and function can be found in the sceneCOM selfcontained emergency luminaires manual.
If you should have any further questions, please contact your sales partner.
Target audience of these instructions
These instructions are intended for electricians without any special product training who would like to use the em-LINK v3 software to connect and monitor multiple sceneCOM controllers.
Software version
These instructions are based on software version em-LINK v3 3.0.0.

em-LINK v3 software

The em-LINK v3 software can be used to establish a connection with up to 200 control devices. The EMLinkService must be started on the main computer and must be running at all times.

WARNING

• The em-LINK v3 software will not work if the EMLinkService is not started!
• If the EMLinkService is stopped on the main computer, no connection can be established with the em-LINK v3 web interface. The automatic test book export also stops working.
• Do not shut down the main computer.

For more information see Section Installing the em-LINK v3 software

Once the software has been started on the main computer, the em-LINK v3 software can be accessed via the web interface from any computer in the network to get an overview of all connected control devices.

Note
If you start the software without a licence, the software functions are still available but you can only connect to one control device. You must purchase a licence to connect multiple control devices.

Emergency lighting system
The emergency lighting system is designed for controlling and monitoring self- contained emergency luminaires.

The sceneCOM web application allows you to use just one sceneCOM controller to automate up to 192 self-contained emergency luminaires. It is therefore suitable for small buildings or individual floors, as shown in the figure on the left.

Note
More information on the web application can be found in the sceneCOM self- contained emergency luminaires manual.

Basic functions of the em-LINK v3 software

• Establishing a connection to max. 200 control devices manually or automatically
• Monitoring the connection status of individual control devices
• Accessing the web application for individual control devices
• Monitoring the function of the self-contained emergency luminaires
• Downloading the test books and faults for individual control devices manually or automatically

Interface description

Navigation principles
Different buttons are available in the em-LINK v3 software for commissioning, configuration and maintenance.

Requirements

Before starting the commissioning and configuration process for your em-LINK v3 software, ensure that the following requirements have been met on the main computer:

• Operating system: Linux (Debian-based) or Microsoft Windows

• The Java Runtime Environment (JRE) or Java Development Kit (JDK) 11 software is installed.

• The JAVA HOME and PATH environment variables are present on computer and set to the JDK 11 folder.

• Disk space required: at least 200 MB

• Port 9000 (TCP) is not in use and is not locked.

• Port 9000 (TCP) is accessible for em-LINK v3 web users.

• Port 443 (TCP) and port 8883 (TCP) are accessible to the main computer.

• Optional: mDNS (port 5353 (UDP)) for finding control devices in the same network.
  Before starting the em-LINK v3 software web application, ensure that the following requirements have been met:

• Web browser: Microsoft Edge, Google Chrome, macOS Safari, Mozilla Firefox
  Before establishing the connection to the control devices, ensure that the following requirements have been met:

• One configured REST API & MQTT API consumer on a control device.

• Version 3.0 or higher has been installed on all control devices.

Optimal viewport width
The optimal viewport width is 1,440 px, 1,280 px or 1,024 px.

Note

• The em-LINK v3 software uses the Apple Bonjour service to find the devices via mDNS.
• The em-LINK v3 software accesses the control device via the REST API & MQTT interface.
• If you already have a higher version of Java installed, you must uninstall this version and install Java 11 on your main computer instead.
• It is a good idea to connect the control devices in a separate LAN (e.g. VLAN).

Licensing

A license is required in order to use all of the functions of the em-LINK v3 software. For licensing proceed as follows:

1. Open the menu.
2. Select Licensing.
   • The Licensing view is displayed.
3. Enter the license key. The license key can be obtained from your local sales partner.
4. Tap the Save button.
   • The license is applied.
   • The full functionality of the em-LINK v3 software is now available.

Commissioning

This section describes how to commission the em-LINK v3 software.
The following steps are required:

• Step 1: Install the em-LINK v3 software.
  For more information see Section Installing the em-LINK v3 software

• Step 2: Open the em-LINK v3 web interface.
  For more information see Section Starting the em-LINK v3 web interface

• Step 3: Establish a connection to a maximum of 200 sceneCOM controllers manually or automatically.
  For more information see Section Establishing a connection to control devices

• Step 4: Define the exports (manual or automatic).
  For more information see Section Defining exports

Installing the em-LINK v3 software

1. Run the installation file em-LINK v3.msi on the main computer.

2. Complete the installation by selecting Finish.

   • em-LINK v3 has been installed.

3. Start em-LINK v3 from the start menu.

   • The EMLinkService starts.
     WARNING

   • The em-LINK v3 software will not work if the EMLinkService is not started!

   • If the EMLinkService is stopped on the main computer, no connection can be established with the em-LINK v3 web interface. The automatic test book export also stops working.

   • Do not shut down the main computer.

4. Write down the IP address of the main computer.

Starting the em-LINK v3 web interface

Starting em-LINK v3 on the main computer

1. Start the EMLinkService for em-LINK v3.
2. Open a web browser.
3. In the address line, enter the IP address localhost:9000.
   • The em-LINK v3 web interface is displayed.

Note
The web interface starts in English the first time a connection is established. You can change the language in which the web interface is displayed using the button at the top right corner of the start page.

Starting em-LINK v3 on another computer

Requirements:

• The EMLinkService for em-LINK v3 is running on the main computer.
• The main computer and the other computer are located in the same network.
• The IP address or name of the main computer is known.

1. Open a web browser.
   In the address line, enter the IP address of the main computer which has the em-LINK v3 running on it, along with :9000 at the end, and navigate to this address (e.g. enter “[IP address]:9000”).
   – or –

2. In the address line, enter the name of the main computer which has the em-LINK v3 running on it, along with :9000 at the end, and navigate to this address.

   • The em-LINK v3 web interface is displayed.

Establishing a connection to control devices

There are two ways to establish a connection to the sceneCOM controllers:

• Manually
• Automatically

Entering a connection to a control device manually
Requirement:

• The control devices have been commissioned.

Note
More information on the sceneCOM software can be found in the sceneCOM self- contained emergency luminaires manual.

1. Open the menu.

2. Select Connect manually.

   • The Connect to control device manually view is displayed.

3. Enter the IP address for the control device.
   Note

   • If only the IP address is entered, the control device appears in the list but has no access to data.
   • You can access the web interface via the icon and can create and manage the API consumer and API tokens for the control device via the REST API & MQTT app.
   • A control device can only be added once.
   • Assign a unique consumer name (e.g. CCD1) if you create a new consumer.

4. Enter the consumer name.

5. Enter the generated API token.
   Note
   Copy the token generated in the REST API & MQTT app.

6. Tap Add.

   • The sceneCOM control device controller is added.
   • As soon as the connection has been manually established, the device name, IP address and device designation, if any, are displayed.
     The total number of emergency luminaires and the number of these which are faulty are also displayed.

Automatically adding control devices
Requirement:

• sceneCOM controller has been commissioned.

1. Open the menu.
2. Select Automatic search.
   • The em-LINK v3 software automatically searches the network for control devices.

Note

• If you select Automatic search, mDNS detection is triggered.
• All control devices are displayed as offline (in grey).
• Control devices found are displayed with four possible statuses on the em-LINK v3 web interface.

Connection status: control device is offline; no connection to control device

Connection status: connection to the control device has been established

Connection status: control device is online, but the credentials are invalid or missing

Connection status: attempting to connect to the control device

Note

• There is no connection to the control device until the login data is saved.
• Note that the API consumer and API token must be entered manually for each control device. The total number of emergency luminaires and the number of faulty emergency luminaires are only displayed in the web view once the login data for the control device has been saved.

1. Tap the icon indicating the connection status for the control device.
   • The Connect to control device manually view is displayed.
2. Enter the consumer name.
3. Enter the generated API token.
4. Tap Save.
   • As soon as the connection has been established, the device name, IP address and device designation, if any, are displayed.
     The total number of emergency luminaires and the number of these which are faulty are also displayed.

Configuring the building structure

The following section contains an overview of the options for monitoring and configuring self-contained emergency luminaires in a hierarchy layout. You can define the specific structure in which the view is laid out yourself.

Creating and editing the building structure

1. Open the menu.
2. Select Edit building structure.
   • The Edit building structure view is displayed.
3. Tap the icon to add a new area.
   • The new area is displayed one level below.
4. Tap the icon to change the name of the area.
5. Tap the icon to delete the area.
6. The drag and drop function can be used to move the individual areas and assign them to new levels in the building structure.

Defining exports
The faults and test book can be exported as a PDF or XML file. You can also select whether the faults and test book are exported automatically or manually.

Note
When generating test books with over 100 pages, creating the export as a PDF is not recommended because this may cause problems. For test books with a high number of pages an XML export should always be selected.

Defining the test book export

1. Open the menu.

2. Select Define exports.

   • The Define exports view is displayed.

3. Select the type of export (automatic or manual).

4. Define the options for the automatic test book export (file type, language, interval, time, path and recipient).
   – or –

   • Define the options for the manual test book export (file type, language and path).
     Note

   • The path indicates the desired save location for the exports on the main computer.

   • For the recipient, enter the email address to which the exported files are to be sent.

5. Tap Save.

   • If “Automatic test book export” has been enabled, the test book export settings are saved. The test books are saved on the main computer or sent by email according to the settings. A separate file is created for each control device. Existing files are not overwritten.
   • If “Manual test book export” is selected, the test books will immediately be saved on the main computer or sent by email according to the settings. A separate file is created for each control device. Existing files are not overwritten.

Note

• The button on the em-LINK v3 web interface can be used to manually export the test books for each control device at any time.
• The “Export entire test book” button on the em-LINK v3 web interface can be used to manually export the test books for displayed control devices.

Exporting faults

1. Open the menu.

2. Select Define exports.

   • The Define exports view is displayed.

3. Select the type of export (automatic or manual).

4. Define the options for the automatic export of faults (file type, language, interval, time, path and recipient)
   or
   Define the options for the manual export of faults (file type, language and path).
   Note

   • The path indicates the desired save location for the exports on the main computer.
   • For the recipient, enter the email address to which the exported files are to be sent.

5. Tap Save.

   • If Automatic export of faults has been enabled, the export settings are saved. The faults are saved on the main computer or sent by email according to the settings. A separate file is created for each control device. Existing files are not overwritten.
   • If Manual export of faults is selected, the faults will immediately be saved on the main computer or sent by email according to the settings. A separate file is created for each control device. Existing files are not overwritten.

Note

• The button on the em-LINK v3 web interface can be used to manually export the faults for each control device at any time.
• The Export all faults button on the em-LINK v3 web interface can be used to manually export the faults for all displayed control devices.

Configuring SMTP
Configure the SMTP server to send exports of test books and faults by email.

1. Open the menu.
2. Select Configure SMTP.
   • The Configure SMTP view is displayed.
3. Enter the user name.
4. Enter the password.
5. Enter the host name.
6. Enter the sender address.
7. Enter the port. Port 25 is entered here by default.
8. Select the method of encryption.
9. Tap Save.
   • The settings are saved.

Monitoring

This section describes how to monitor individual control devices using the em- LINK v3 software. This includes:

• Monitoring the connection status of individual control devices
• Accessing the web application for individual control devices
• Monitoring the function of the self-contained emergency luminaires
• Exporting test books for the individual control devices manually or automatically

Overview of monitoring functions
The following contains an overview of the monitoring functions:

Figure 3: Monitoring the function of the self-contained emergency luminaires

control devices or all of them. The connection to the control devices can then be terminated.
Terminate connection| When the connection is terminated via the em-LINK v3 web interface, the test book for the control device is not deleted on the control device itself. The test book also continues to be available via the control device web application.

menu:

·       Connecting to a control device manually

·       Editing the building structure

·       Automatic search

·       Defining exports

·       Configuring SMTP

·       Opening the manual

·       Adding a licence

(9)| Monitor the function of the self-contained emergency luminaires| The type of fault and path of the luminaire are displayed for each faulty emergency luminaire.

Faults are displayed no more than 15 min. after they have occurred.

i Note __

For more information see Section Faults 26

Table 3: Monitoring the function of the self-contained emergency luminaires

Monitoring the functionality of self-contained emergency luminaires
The following provides detailed information about monitoring the function of the self-contained emergency luminaires:

Figure 4: Details about monitoring the function of the self-contained emergency luminaires

of the structure, the IP address and the device designation, if any, of the control device.
Number of emergency luminaires and number of luminaire faults| This shows you the status of the self-contained emergency luminaires:

·       Total no. of emergency luminaires : number of self-contained

emergency luminaires addressed in the system.

·       Of which defective : number of self-contained emergency

luminaires with a fault.

(2)| Open the control device web application| Use this button to open the web application for the corresponding control device.
(3)| Assign control device| Use this button to assign the control device directly to an area in the building.
(4)| Check connection status| The icon indicates the connection status for the control device:

Connection status: connection to the control device is not possible; the control device is offline

Connection status: attempting to connect to the control device

Connection status: connection to the control device has been established

Connection status: control device is online, but the credentials are invalid or missing

inspection tests are documented in the test book. Test book entries are organised in chronological order (most recent test result at the top).

This button can be used to manually export the test book for a control device to the local computer. The test book is exported as a PDF file in the language set on the em-LINK v3 web interface.

Exports always include all test results.

i Note __

A test book export can be defined for all control devices.

For more information see Section Defining exports 18

(6)| Monitoring the function of the self-contained emergency luminaires| The type of fault and path of the luminaire are displayed for each faulty emergency luminaire.

Faults are displayed no more than 15 min. after they have occurred.

i Note __

For more information see Section Faults 26

Table 4: Details about monitoring the function of the self-contained emergency luminaires

Faults
The following section provides an overview of the individual faults that can occur with the self-contained emergency luminaires. You can also get information on what the cause of the error message could be and how the problem can be corrected.

Self-contained emergency luminaire

battery.
Duration test due.| The service interval has been exceeded.| 1.    Carry out maintenance.

2.    Perform a duration test.

Communication error| A luminaire was connected, for example, first to one DALI control line and then to another. As a result a communication error has occurred.| w Delete the luminaire from the system image and readdress it.
Short circuit on DALI line| DALI control line has a short circuit.| w Check the affected line and eliminate the short circuit.
Charging fault| A fault has occurred when the battery was charging.| w Check the battery wiring.

– or –

w Replace the battery.

– or –

w Replace the control gear.

Lamp or control gear failure| The lamp is not correctly connected.| w Check the lamp wiring.
Lamp or LED module is faulty.| w Replace the faulty lamp or LED module.
Control gear is faulty.| w Replace the faulty control gear.
Break on DALI line| DALI control line has a break.| w Check the affected line and eliminate the break.

Table 5: Possible faults for a self-contained emergency luminaire

Note
A report on the faults can be exported automatically or manually.
For more information see Section Defining exports

Maintenance

This section explains how to maintain the em-LINK v3 software.

Software update
You can update the em-LINK v3 software. The software configuration will be retained. Existing test book exports will not be deleted.

Note
The most up-to-date software version is available from your sales partner.

Updating the em-LINK v3 software

• Run the new installation file em-LINK v3.msi.
  • The em-LINK v3 software is updated.

Logo
You can set the logo yourself, so that it appears in the top left corner of the web interface.

Defining and replacing the logo
Requirement:

• The logo is available as a PNG file.

Note

• File name: logo.png
  

• Dimensions: 500 × 250 pixels

1. Open the following folder on the main computer: C:\Program Files (x86)\em-LINK\conf
2. Copy file logo.png to the following folder: C:\Program Files (x86)\em-LINK\conf
3. Reload the web interface.
   • The new logo is displayed in the top left corner of the em-LINK v3 web interface.

Appendix

This section contains the following information:

• Icons

Icons
This section contains an overview of all icons shown in the em-LINK v3 software.

Table 6: Icons in the em-LINK v3 software
This section contains an overview of all menu icons.

References

• Lighting solutions for smart indoor and outdoor lighting – Tridonic

Read User Manual Online (PDF format)

Download This Manual (PDF format)

Download this manual  >>