LumInsight Provisioning Tool User's Guide...You can exit the LumInsight Provisioning Tool by clicking on the Asterisk in the top left hand corner of the screen. A menu drops down to

078-0161-01C

This guide shows you how to use the provisioning tool to create projects, set up the segment controller page, configure TCP/IP, configure GPRS, set control groups, define and provision devices, create devices, create bulk devices, and commission your products.

LumInsight Provisioning Tool User’s Guide

Echelon, LumInsight, and the Echelon logo are trademarks of Echelon Corporation that may be registered in the United States and other countries.

Other brand and product names are trademarks or registered trademarks of their respective holders.

Smart Transceivers, Neuron Chips, and other OEM Products were not designed for use in equipment or systems, which involve danger to human health or safety, or a risk of property damage and Echelon assumes no responsibility or liability for use of the Smart Transceivers or Neuron Chips in such applications.

Parts manufactured by vendors other than Echelon and referenced in this document have been described for illustrative purposes only, and may not have been tested by Echelon. It is the responsibility of the customer to determine the suitability of these parts for each application.

ECHELON MAKES AND YOU RECEIVE NO WARRANTIES OR CONDITIONS, EXPRESS, IMPLIED, STATUTORY OR IN ANY COMMUNICATION WITH YOU, AND ECHELON SPECIFICALLY DISCLAIMS ANY IMPLIED WARRANTY OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.

No part of this publication may be reproduced, stored in a retrieval system, or transmitted, in any form or by any means, electronic, mechanical, photocopying, recording, or otherwise, without the prior written permission of Echelon Corporation.

Printed in the United States of America. Copyright © 2015 - 2016 Echelon Corporation.

Echelon Corporation www.echelon.com

http://www.echelon.com/

LumInsight Provisioning Tool User’s Guide iii

Welcome This document describes the features and operation of Echelon’s LumInsight Provisioning Tool.

Audience This guide is intended for LumInsight users who want to use the graphical user interface of the Provisioning Tool. Use the tool to create LumInsight projects which manage the configuration of SmartServer based segment controllers in a connected lighting system. The project will define the segment controller TCP/IP settings, logical group organization, and the devices monitored and controlled and ultimately managed by the LumInsight CMS..

Examples Throughout this PDF, screen shots will guide you through the process of using the LumInsight Provisioning Tool.

Related Documentation The following manuals are available from the Echelon Web site (www.echelon.com) and provide additional information for the LumInsight products.

Title Part Number Description

LumInsight CMS Installation Guide

078-0159-01C This manual helps you install your LumInsight product.

LumInsight CMS Web Portal User’s Guide

078-0160-01C This manual shows you the dashboard of the LumInsight Web Portal. Use this guide to set up Geozones, update and delete devices, manage alarms, manage group controllers, and troubleshoot your Geozones.

http://www.echelon.com/

iv

LumInsight Provisioning Tool User’s Guide v

Table of Contents Welcome ......................................................................................................... iii Audience ........................................................................................................ iii Examples ....................................................................................................... iii Related Documentation ................................................................................ iii

Introduction ....................................................................................................... 1 Provisioning Tool Starting Tab ..................................................................... 2

Create New Project .................................................................................. 2 Segment Controller Properties Tab ........................................................ 6 TCP/IP Configuration .............................................................................. 7 GPRS Configuration ................................................................................ 8 Time Server ............................................................................................ 10 Web Server ............................................................................................. 12 Lon Channel Driver ............................................................................... 13 Energy Meter ......................................................................................... 13

Device Definition and Positioning ............................................................. 15 Control Groups ............................................................................................. 16 Device Definition .......................................................................................... 18

Device Type ............................................................................................ 18 Edit Lighting Controller Definition ...................................................... 21 Traffic Occupancy Sensor (TOS) Definition ......................................... 21 Edit Traffic Occupancy Sensor Definition ........................................... 22 Streetlight Bridge Definition ................................................................ 23 Direct Control Device Definition .......................................................... 23

Scene Definition ........................................................................................... 25 List of Device Definition .............................................................................. 26 Device Page................................................................................................... 28

Create a Device ...................................................................................... 28 Create Bulk Devices .............................................................................. 29 Create Device from Map ........................................................................ 30 Deleting Devices .................................................................................... 34 Edit Device Location.............................................................................. 34 Export to CSV ........................................................................................ 35 Import from CSV ................................................................................... 35

Commission Page ......................................................................................... 37

Troubleshooting .............................................................................................. 41 Troubleshooting Displays ............................................................................ 42

Advanced Features ......................................................................................... 45 Control Data ................................................................................................. 46 Fault Data .................................................................................................... 46 About Page .................................................................................................... 48 System Information ..................................................................................... 48 Close .............................................................................................................. 49

vi

LumInsight Provisioning Tool User’s Guide 1

1

Introduction

This chapter lets you create a new project with the Provisioning Tool, configure your settings, and set up your GPRS to access the SmartServer. The Time and Web Servers are shown in this chapter.

2 Introduction

Provisioning Tool Starting Tab Download the Provisioning Tool software from the LumInsight product page on the Echelon Web site. The downloads tab is located at the bottom of the page.

After you start the Provision Tool, it opens to a Starting Tab, as shown in Figure 1. You can exit the provisioning tool by clicking on the top left corner of the window and selecting the asterisk, and then selecting the Close button. The Provisioning Tool asks if you want to save your project before you exit the tool. The System Menu also has an About LumInsight Provisioning Tool selection which provides the application version of your software.

Figure 1. LumInsight Provisioning Tool Starting Tab

Create New Project You create a new project by clicking on the New Project button in the top left of the icon bar.

When you first open the tool, only three menus in the menu bar are available: New Project, Open Project, and Open from Controller. All other menus are disabled.

If you have a saved project available, you open it by clicking the Open icon.

If this is your first time in the Provision Tool Software, select New Project, as shown in Figure 2.


Figure 2. New Project Page

Use this screen to create a new project.

First, fill in a Project Name. This field is mandatory. On the screen shown, it is Provisioning _Tool_Project. If you do not supply a name, the default name is Segment Controller New Project.

Next, supply the name of the Author (your name or company name). This field is not mandatory.

The Description box gives you a place to describe your project. This is a free text entry field used to summarize the project with top level information such as the number of fixtures of each type and the groups defined.

The final field is for the File Path. This field is automatically filled by the software when you save your project in a folder. The File Path is not editable.

When you are finished with this page, click on the arrow at the bottom of the screen to move to the next page, Segment Controller Properties.

You can open a project by clicking on the Open Project icon in the menu bar. If a project is already open and you try to open a new project, a dialog box will open to save the current project.

An Open Project Page is shown in Figure 3. You can exit the LumInsight Provisioning Tool by clicking on the Asterisk in the top left hand corner of the screen. A menu drops down to let you Move, Size, Minimize, Maximize, or Close the tool. You can also use the Alt key +F4 to exit the provisioning tool.

4 Introduction

Figure 3. Open Project Page

Once you have created projects, they can be opened from the controller where the project is saved. Click on the Open From Controller Icon in the menu bar. This opens a new window with the project, as shown in Figure 4.

Figure 4. Open from Controller

In the Open Project Segment Controller window you select parameters to allow FTP access to the Segment Controller. All of the fields are mandatory and include:


• HostName: Enter valid host name or TCP/IP address.

• Port: Enter the port number for FTP transfers

• Login: Your valid FTP login id

• Password: Your FPT login password

Once you have completed the fields, click OK.

If you want to save the project on your local computer, click the Save button or use the <ctrl>-s keyboard shortcut. The location of the saved project displays under Project Properties on your screen, as shown in Figure 5.

Figure 5. Save Screen

To save the project directly to your controller, click Save to Controller in the menu bar. All of the required parameters must be completed to save the project to your controller, as shown in Figure 6.

6 Introduction

Figure 6. Save to Controller

Segment Controller Properties Tab The Segment Controller Properties tab lets you set your Segment Controller, TCP/IP configuration settings, GPRS settings, Time Server, Web Server, and Lon Channel Driver settings. This tab is visible when you select the Segment Controller top level tab, and the Segment Controller Properties option in the menu bar.

On this tab, you can select latitude and longitude from the map. Click the icon next to the Latitude and Longitude fields to make your selection. Use the arrow at the bottom of the page to move to the next or previous tab.

The Segment Controller tab is shown in Figure 7.


Figure 7. Segment Controller Properties Tab

Once the Segment Controller Tab opens, enter the Segment Controller Name. This field accepts 50 alphanumeric characters,and dashes (-). The dash cannot be used as the first or last character for your segment controller name. This field is mandatory and it should be unique across the collection of projects you create and eventually import into the CMS. When navigating to different Segment Controllers in your geozone, using a name to provide context is important. A Street Address is a good stategy to embed in this name.

Next enter a Description (optional) for your segment controller.

The Timezone field has a dropdown list of zones. Select yours.

Latitude and Longitude can be entered directly or selected from a map. You select from a map by clicking the icon to the right of the fields.

If you choose the icon, a map opens. Use left click to drag the target to the desired location, and “+” and ‘-‘ icons to zoom to the desired level of zoom. When you double click the map interface, the current cursor location locks in the coordinates when you exit the map interface by clicking the OK button..

TCP/IP Configuration To set your TCP/IP configuration settings, click on TCP/IP tab, located next to the Segment Controller tab. On this tab, you will specify the configuration needed for the Segment Controller. In many systems that use a celluar data network gateway to connect the Segement Controller to the Internet, you will use

8 Introduction

a fixed IP address, Gateway address, and subnet mask. This sets the TCP/IP settings for your SmartServer. Figure 8 shows the TCP/IP Configuration tab.

Figure 8. TCP/IP Configuration

GPRS Configuration The next tab opens the GPRS Configuration tab. The GPRS page shows the steps for your modem connection to access the SmartServer remotely and connect to a TCP/IP network. This allows for communication with host devices. Figure 9 shows the GPRS Configuration tab. The support for GPRS modems connected to the serial interface of the Segment Controller is limited and does not provide the performance found in today’s 3G and LTE networks commonly available. Echelon recommends using a cellar data network gateway connected to the 10/100 Base T Ethernet port of the segment controller.


Figure 9. GPRS Configuration

For GPRS configuration, follow these steps.

1. At Select Modem, select your modem from the dropdown list provided. If you are using an external GSM modem, enter the PIN Number to be sent to the external modem in order to transmit or receive calls.

2. Enter the Access Point Name.

3. Enter the Connection Name.

4. Enter the Phone Number to call when a dial-out connection is used.

5. Enter the IP address of the Remote DNS Server used when making a dial-out connection.

6. Check the Obtain Automatically check box. This will obtain the DNS Server address from the PPP server when establishing a connection.

7. Enter the length of time (between 0.0 and 6533.5) seconds that the connection can idle before it is disconnected.

8. Select Analog or Persistent GPRS. To connect a SmartServer to host devices via modem, you must add and configure the dial-out connection to the modem. Dial out connections are available as analog or persistent GPRS.

9. Select the PPP authentication type to use when connecting to an ISP. Three options are available here. Automatic is the default. With Automatic, the SmartServer auto-matically selects the authentication type to use when connecting to ISP.

10 Introduction

PAP (Point-to-Point Access Protocol): PAP uses unencrypted ASCII encoding to transmit user names and passwords over a network. CHAP (Challenge Handshake Authentication Protocol): CHAP uses a three-way handshake to validate a remote client when the connection is established and may validate it again anytime afterwards. This is the recommended PAP authentication type.

10. Check the check box for Use Dynamic DNS to enable dynamic DNS and enter the host name, the user name, and the password for your Dynamic DNS service provider.

11. By selecting a persistent GPRS connection for the phone number you entered when you checked the Persistent GPRS check box, the following properties must be added. Hostname. Enter the Hostname or IP address of the Web server provided by the ISP for the GPRS connection.

Check Interval. Enter the amount of time after which the SmartServer connects to the ISP automatically. Retry Time. Set the interval (in seconds) that network messages wait for confirmation before being re-sent over the network. The default Retry Time is 120 seconds. Retry Count. Set the number of times a network message is re-sent when no confirmation is received. Verify Mode. Select the method in which the SmartServer simulates internet activity in order to verify that the GPRS connection is active. There are three choices available in Verify Mode: Default: The SmartServer pings the IP address of the Web server, and it opens a TCP connection to the HTTP port (80) of the Web server. If either check succeeds, the GPRS connection is active. Ping Host: The SmartServer pings the IP address of the Web server. Check HTTP Connection: The SmartServer opens a TCP connection to the HTTP port (80) of the Web server.

Time Server You configure the segment controller to synchronize its clock using a time server. A real time clock of the segment controller can be synchronized to a Time Server using the SNTP protocol. The OLS Framework in the Segment Controller is configured to use the time servers shown in figure 10. This configuration is very reliable because the servers accessed are rotated hourly. A refresh can take 0.5-1s for each OLC and you are given the option to cancel the request.

To activate the time server, click on the Time Server tab and fill out the fields shown in Figure 10.


Figure 10. Time Server

The time server tab starts with the Default Time Server field.

1. Enter the Default Time Server IP or Host Name.

2. Select a frequency for Time Synchronization Mode. The options are: Automatic. The SmartServer is synchronized every 1 to 15 minutes and remains within 100ms of the SNTP server. The default is 76. The SmartServer can be used for both LAN and dial-out (modem and GPRS) connection. Sync when dial-up is active. The SmartServer clock is synchronized when a dial-out connection is established. This option can only be used for dial-out connections (modem and GPRS). Fixed Interval. The frequence in which the SmartServer is synchronized is based on the value in the Synchronization Interval property. This option can only be used for ethernet connections. Echelon recommends a 12 hour fixed interval to conserve data on cellular data networks. Disabled. The SmartServer is not synchronized with the SNTP Server. This option is NOT recommended because the real-time clock in the segment controller could drift 30-60s in a month when operating at elevated temperatures.

3. Enter a Time Synchronization Interval. Use this selection to set how often the SmartServer clock is synchronized with the SNTP server. The default synchronization is 12 hours. This option is only available you have selected Fixed Interval for Time Synchronization Mode.

12 Introduction

Web Server Open the Web Server tab to configure your Web Server. This address matches the server address for your target LumInsight CMS. It is used to push operating data to the CMS.

Open the Web Server tab, shown in Figure 11, to configure the SC to send its datalogs to a data collection server.

Once the SC is running, it is automatically configured to send historical data to the Web Server.

Figure 11. Web Server

The Web Server asks for an IP or Host Name.

1. Enter the TCP/IP address or Host Name that will receive the historical data logs sent by the segment controller, such as 192.168.0.13.

2. In the SOAP field, enter the endpoint where the historical catalogs are sent. A recommended field entry is “/DataCollect.asmx”.

3. Enter the HTTP Port (Web Server/SOAP) of the host or TCP/IP that will receive the historical catalogs sent by the segment controller, such as 80.

4. Check the Secured Connection check box to use a secure connection.

5. Enter the User Name and Password that will be used by the host name. To confirm your password, enter it again in the Re-enter Password field.

6. Enter the Retry Time. The default is 120s. This sets the amount of time after which the segment controller will stop attempting to respond to failed historical catalogs.


Lon Channel Driver The Lon Channel Driver tab is the next tab on the Communication Properties screen. Select this tab to set the Lon Channel Driver configuration. The LON Group Controller page opens, as shown in Figure 12.

Figure 12. LON Channel Driver

On this tab you set options for the driver.

1. Repeating. This checkbox option lets you enable the enhanced LonTalk Proxy Protocol used for transmitting messages to devices attached to a power line.

2. Transmitter Time. Here you can change the interval time (in ms) a network message will wait for confirmation before being resent over the network.

3. Retry Count. You can change the number of times a network message is resent when no confirmation is received.

Energy Meter The Energy Meter tab provides a report of the energy data from the data points as well as the total energy values for OLC reported energy usage for a specified configuration. The Energy Meter tab is shown in Figure 13.

14 Introduction

Figure 13. Energy Meter

This tab has two options, Meter Enabled and Log Interval.

Meter Enabled. If the checkbox is checked, LPT chooses the appropriate values for the energy data points. If you leave the checkbox unchecked, LPT drops the data points from the Dashboard Log. Log Interval. Select your log interval.


2

Device Definition and Positioning

This chapter describes control group edits, device definition, fixture definition, and commissioning.

16 Device Definition and Positioning

Control Groups On the Starting Tab page, the Device Definition and Provisioning Tab is next to the Segment Controller. Click this tab. The first page you see will be a list of Control Groups. You can edit selected control groups from this page, shown in Figure 14.

Figure 14. Control Groups

You can edit a control group when you click on the edit icon at the end of a row. This opens the edit window, as shown in Figure 15.


Figure 15. Edit Control Groups

The edit window asks for a Control Group Name. After you have named the group, decide if you want to activate the Dusk/Dawn Sensor. If checked, a Sensor Override dropdown box appears. Make a selection and choose your Local Input Functions from the provided list. Select Output Control from another dropdown list. Click OK when you have finished the entries in the dialog box. Figure 16 displays a list of edited control groups.

If you have selected output control other than None, the Contractor Direct Control option displays. Check the option and the nciOffDelayTime of the group controller. The group controller will be set to 0s. If the box is not checked, nciOffDelayTime is set to to 940s.

Figure 16. List of Edited Control Groups


Device Definition This section shows the steps for creating devices.

Device Type Use this page to create the lighting controller, TOS device, streetlight bridge device and to create direct control type devices.

Figure 17. Device Type

Click on:

And make your selection from lighting controller, TOS device, Streetlight Bridge, and Direct Control Device.

Lighting Controller

There are three tabs to create Lighting Controller Definition: Control, Alarm Limits, and Characteristics. Alarm names can be up to 50 alphanumeric characters, as well as a space, underscore, and hyphen.

The Control tab opens the screen shown in Figure 18. Fill out the fields on this tab as follows.

• Enter the Unique Device Definition Name.


• Select the WarmUp Time. This defines the time the lighting controller will delay dimming commands while the bulb warmup.

• Enter the Low Control Voltage. This defines the minimum control voltage the OLC will use for the connected drivers or ballast.

• Enter the High Control Voltage. This defines the maximum control voltage the OLC will use for the connected drivers or ballast.

• Enter the Default Level. This defines the value applied if the lighting controller determines the segment controller is not communicating to the lighting controller.

Figure 18. Lighting Controller Definition

Alarm Limits

The next tab contains the alarm limits screen. The alarm limits screen is shown in Figure 19. Set your limits here.

Figure 19. Lighting Controller Alarm Limits


Fill out the fields described below.

• Enter the Lamp Fail. This defines the threshold of power drop measured when the lamp fails.

• Enter the Voltage Fault. This is the percentage deviation allowed from the configured supply voltage before the supply voltage alarms are triggered,

• Enter the Power Fault. Another percentage deviation allowed before power fault above or below what is expected based upon the define power profile for the luminaire under control by the lighting controller.

• Enter the Power Factor. This defines the Low limit of power factor measurement to trigger a power fault alarm.

• Enter the Temperature. This is the temperature above which the high temperature alarm is triggered.

• Enter the Supply Voltage. This is the expected nominal supply voltage for the operating fixture.

• Enter the Power Profile values.

Characteristics

The final tab lets you choose the characteristics of the device you are creating.. The characteristics screen is shown in Figure 20.

Figure 20. Lighting Controller Characteristics

The Characteristics fields are described below.

• Select the Lamp Type from the dropdown list. • Enter the BaseLine Power. The electric power is required by fixture. • Enter the Expected Lifetime. This is the expected number of hours of

operation for a lamp before failure. • Enter the URL. You can provide a URL to the data sheet for the fixture.


Click OK. You can now see your added lighting controller in a list, as shown in Figure 21.

Figure 21. Lighting Controller in List

Edit Lighting Controller Definition

Once the lighting controller appears in the list, you can click on the edit icon, shown in the figure above in column 7, to edit the added controller definition. The three tabs for control, alarm limits, and characteristics will display again and you can make changes. Click Cancel if you no longer want to apply changes. Click OK when you have completed your edits.

You can delete a controller that appears in the list. Click on the delete icon, which is in the final column of the description, shown in Figure 21. Selecting Delete will open a confirmation box. If you are certain you want to delete a controller, confirm your choice by clicking Yes.

Traffic Occupancy Sensor (TOS) Definition

Click on the TOS definition to see the create TOS definition page, shown in Figure 22.


Figure 22. TOS Definition

Fill out the fields to define your TOS.

• Enter the unique Name of the Traffic Occupancy Sensor. • Select the Type of TOS from the drop down list. • Select a Heartbeat. The heartbeat propogates occupied/unoccupied

events after a specified time, shown in minutes. • Select the Occupancy Hold Time. This selection holds the occupied

event for specified seconds/minutes. The occupancy full time for the sensor should equal the heartbeat.

• Use Application Repeat. Check this box and the TOS device sends out the SW_SET_OCCUPIED message at transition from SW_SET_UNOCCUPIED to improve performance in a high noise environment when Use Application Repeat is selected.

Edit Traffic Occupancy Sensor Definition

Once the TOS device appears in the list, you can click on the edit icon, shown in the figure above in column 7, to edit the added controller definition. The TOS Definition dialog will display again and you can make changes. Click Cancel if you no longer want to apply changes. Click OK when you have completed your edits.


Streetlight Bridge Definition

Click on Create Streetlight Bridge Definition at the bottom of the screen to see the Create Streetlight Bridge Definition dialog, shown in Figure 23.

Figure 23. Streetlight Bridge Definition

The Create Streetlight Bridge Definition dialog asks you to provide a unique Name for the streetlight bridge and a Description of the device. Click OK when you are done.

Direct Control Device Definition

Click on the Create Direct Control Definition at the bottom of the screen to see the Create Direct Control Definition page, shown in Figure 24. There are two tabs to the Create Direct Control Definition screen, General and Characteristics.

The General tab provides for a unique direct control device Name. You can add a description of the device in the description box.


Figure 24. Direct Control Device Definition

The Characteristics tab, shown above, is similar to the Characteristics tab for the Device Type characteristics tab. Enter the following detail:

• Select the Lamp Type from the drop down list. • Enter the BaseLine Power. This is the electric power required by the

fixture. • Enter the Expected Lifetime. This is the expected number of hours of

operation for a lamp before it fails. • Enter the Fixture Model Number. • Enter the URL. You can enter a link to a Web site data sheet here.


Scene Definition The next selection in the Device and Provisioning Tab lets you create a scene definition, as shown in Figure 25.

Figure 25. Scene Defintion

Click on the Create button to begin. Figure 26 shows a create scene definition screen.

Figure 26. Create Scene


The create scene definition page has the following components.

1. Enter a scene Name. The name must be unique in the scene table. It can contain as many as 32 alphanumeric characters, including hyphens, underscores, and spaces.

2. Select the Scene Count from the dropdown list. The scene count dropdown controls which scenes are visible. Counts require a MAX (1,2,3), MID (2,3,), and MIN (3).

3. The Unoccupied scene level is visible when the Occupancy responsive option is selected.

4. Enter your scene details in the Details text box.

5. Click OK to create the defined scene.

Once a scene is created, you can edit it further by selecting the scene on the Scene Definition page and clicking the edit button . A dialog box will open, as shown in Figure 27.

Figure 27. Edit Scene Definition

You can also delete a scene from the Scene Definition list. A dialog box will open to confirm deletion. You can delete multiple scenes by selecting them from the scene list and right clicking the page. A delete menu will open. Click OK and a confirmation will appear.

List of Device Definition You can display the created device definition and TOS definition lists as shown in Figure 28.


Figure 28. Device Definition List

You can edit or delete any of the items in the list by selecting from the list and clicking the icons in the Edit and Delete columns. Confirmation dialogs will open when you choose to make changes to the list. Click OK to finalize your selection.


Device Page Click on the Device icon in the main menu bar to open the Device page. From this page you can create a device, create a bulk of devices, import or export devices, and replace an existing device using CSV. Figure 29 shows the Device page.

If you have already added devices to your controller, clicking on the Device menu brings up a list of those devices, not shown in the figure.

Figure 29. Device Page

Create a Device To add one device, click on the Create Device button at the bottom of the Device Page. The Create Device dialog will open, as shown in Figure 30.


Figure 30. Create Device

1. Enter a Name for the device. This field is mandatory. The device name must be unique. A device name can contain a maxium of 25 alphnumeric characters. Hyphens (-) also are allowed.

2. Enter the Neuron ID. This field is mandatory. A Neuron ID is 12 hexadecimal characters (0 to 9 digits and “a” through “f” alphabetically).

3. Select your Group Controller from the dropdown list.

4. Select the Type from the drop down list.

If you have selected TOS Definition, the Group Controller and Scene Definition fields are not shown. If you have selected Direct Control, Neuron ID, Group Controller, and Scene Definition are not shown. Check the dialog heading to make sure you are creating the correct device.

5. Select the Scene Definition from the dropdown list.

Create Bulk Devices To add bulk devices, click on the Bulk Create button on the bottom of the Devices page. From the list of devices, select Device Definition from the dropdown list. The Bulk Create screen is shown in Figure 31.


Figure 31. Bulk Create

1. Enter a Name for device. This name requires a 2-character prefix. Numbers are then assigned in the start and count fields.

2. In the Start field, enter the starting device Prefix number.

3. In the Count field, select the number of devices.

4. Select the Group Controller from the dropdown list.

5. Select the Type from a dropdown list.

6. Select the Scene Definition from the dropdown list.

To see the list of the newly added devices, return to the Devices page.

Create Device from Map You can create a device from the map. Click on the device map button and open the map page as shown in Figure 36. Use the following steps to create your device.

1. Click on device from map button. The map page opens as shown in figure 32.

2. Right click on the map to open the context menu. There are two options for creating a device on the map:

• Device Drop

• Bulk Drop


Figure 32. Create Device from Map

Device Drop 1. Click on the device drop context menu to open the Create Device dialog box.

2. Enter Name of device. This field is mandatory and cannot be left empty. The device Name must be unique.

3. Enter the Neuron ID. This field is mandatory and cannot be left empty. The Neuron ID is 12 hexadecimal characters (0 to 9 digits and ‘a’ to ‘f’ alphabetically).

4. Select the Group Controller from the dropdown list. (not shown for TOS)

5. Select the Type from the dropdown list.

6. Select the Scene Definition from the dropdown list. (not shown for TOS)

7. Click OK. A message displays on the map’s left corner telling you how to put the device on the map, as shown in Figure 33.


Figure 33. Message from Map after Creating a Device

To add the device, double click on the map. Once the device appears, you can change its position by dragging and dropping the device.

Your device now appears in the list of devices and will continue to show on the map.

As shown in Figure 33, you can drop a device on the map, or you can bulk drop.

Bulk Drop Click on the bulk drop context menu to open the Bulk Drop dialog box and follow these steps.

1. Enter a Name for device. This name requires a 2-character prefix. Numbers are then assigned in the start and count fields.

2. In the Start field, enter the starting device Prefix number.

3. In the Count field, select the number of devices.

4. Select the Type from dropdown list.

5. Click on OK. A message displays in the left corner of your map regarding placement of your bulk devices, as shown in Figure 34.


Figure 34. Adding Bulk Devices from Map

Double click on the map. Once you locate the devices on the map, you can change device position by dragging and dropping the devices. A view of located bulk devices is shown in Figure 35.

Figure 35. Located Bulk Devices

Your added devices now appear in the list of devices and will continue to show on the map. Figure 36 shows an updated list of devices after a bulk drop.


Figure 36. List of Devices after Bulk Drop

Deleting Devices

You can delete multiple devices from the list of devices page. Using the delete icon lets you select a device, click the icon, and open a confirmation dialog to delete the device. To delete multiple devices, select the devices from the Device page and right click the page. A Delete menu opens. Click the menu to see a confirmation dialog and OK all deletions.

Edit Device Location

On the Devices page, when a device is listed it will display the latitude and longitude. To change the location of a device, click on the icon under Geolocation, shown above. The map will open and you can move the device to the desired location and Save it.


Export to CSV The Export to CSV button is at the bottom of the Device page. A window opens and you can manage the files to export. An opened export window is shown in Figure 37.

Figure 37. Export to CSV

Import from CSV

Select the Import to CSV button at the bottom of the Devices page. You can add a list of devices from a CSV file. Adding a list of devices in this way deletes the existing list of devices shown in the List of Devices display.

Your CSV file must support the following columns, with a comma used as the separator for each field. The columns and an example are provided below.

• Name (Lamp 1,) • Neuron ID (0123C200AEF0,) • Control Group (G2 Controller,) • Type (32W_LED,) • Scene (Basic,) • Latitude (51.7192207564299,) • Longitude (23.2575503115420)

Name Neuron ID Control

Group Type Scene Latitude Longitude

Lamp1 0123C200AEF0 G2 Controller

32W_LED Basic 51.7192207564299 23.2575503115420


Figure 38 shows an open Import from CSV screen.

Figure 38. Import from CSV

In addition to exporting and importing from CSV, you can replace devices from CSV. Click on the Replace from CSV button at the bottom of the screen. You can update all devices whose Neuron IDs match with a file’s Device Neuron ID. If a device’s Neuron ID is not listed, it will be added as a new device and you can edit the ID at a later time. After updating your devices, click Save. Figure 39 shows the replace from CSV screen.

Figure 39. Replace from CSV


Commission Page Click on the Commission button at the top of your page. This opens the Commission Page, shown in Figure 40.

Figure 40. Segment Controller Commissioning

To commission the parameters of your project into the segment controller, use the following steps.

1. Enter the TCP/IP or Host name of the segment controller in the Host field.

2. Enter the User name and Password of the segment controller. The default user name and password are both “ilon”.

3. Click on the Sync button at the bottom of the screen to start commissioning. You can stop the process by clicking the Cancel Sync button.

Progress during commissioning is shown with a view and message bar at the bottom of the screen. In Figure 40, above, you can see that the commissioning process is 1% complete and is currently verifying host. Messages include the following:

• Verifying Host

• Verifying License

• Verifying Firmware Version

• Applying Segment Controller Properties

• Applying Devices

• Setting Real Time Clock


• Setting Polling Manager

• Setting Group Override Input Configuration

• Verifying Configuration (displays operations performed on the devices like Devices Removed from the Segment Controller, Devices Added to Segment Controller, Neuron ID for Devices updated into Segment Controller, Devices Removed from ERDP File, Neuron ID for Device Replaced in ERDP File)

• Finished

After the “Finished” message is displayed, you need to reboot the SmartServer to accept the commissioned segment controller. There is a prompt screen to ask you to reboot, shown in Figure 41. If you choose Yes, the SmartServer will reboot. If you choose No, the sync process will continue without a reboot.

Figure 41. SmartServer Reboot Screen

Once the SmartServer reboots, you will receive a message that the Segment Controller is rebooting and the commissioning process is complete, as shown in Figure 42. Select OK.


Figure 42. Successful Commission



3

Troubleshooting

The LumInsight Provisioning Tool includes a Troubleshooting menu on the starting tab. You can use this feature to test the OLCs connected to segment controllers.

42 Troubleshooting

Troubleshooting Displays When you test an OLC, you want to know if it can switch ON and OFF, and if it can DIM. And you want to know if it is receiving correct feedback from the segment controller.

The Select All button under the Troubleshoot Devices title lets you select all of your devices. This is displayed in the table shown in Figure 43.

Figure 43. Select All Devices

Use the corresponding Unselect All button to unselect your devices. You can toggle the devices by pressing the shift key when clicking a checkbox.

Now click on the Troubleshooting button. The Provisioning Tool will connect to the segment controller to get an update status of the OLCs, their lighting level, and any failure information. The Status column shows the commissioning status. The lighting level of the lamp is displayed in the Feedback column. Any failures detected will show up in the Failures column.

To get information from one or more OLCs from segment controllers, follow these steps.

1. Select all devices by clicking the Select All button at the top of the displayed list. If you want to select a single device, click the box to the left of the device name. You can toggle the devices from “first” device up to “clicked device” by holding down the shift key before clicking the check box.

2. Click on Apply Action, on the bottom of the screen, left side. Search the drop down list.

3. Select your action.

4. Slick on the Apply button, next to the Apply Action button.


5. Click on Troubleshoot.

Each time you send an ON, OFF, or Dimming command to an OLC, the Provisioning Tool asks the segment controller to communicate with the OLC on the power line network. This supplies continual feedback. If the action you select is OLC ON, and then you click Apply, the display reflects the results of the OCL ON action. In addition, the progress is tracked and displayed in the Progress box at the bottom of the Troubleshooting page.

Actions for Troubleshooting include OLC ON, OLC OFF, Dimming, Recommission, and Reboot Segment Controller. The Troubleshooting Devices page, with the Applied Action of OLC ON, is shown in Figure 44.

Figure 44. Troubleshoot Devices

For Dimming information, select Dimming from the dropdown menu under Apply Action. Click on Apply. You can track the progress in the Progress bar and view the results as shown in Figure 45.

44 Troubleshooting

Figure 45. Device Dimming

When the troubleshooting is complete, a dialog box will appear, as shown in Figure 46.

Figure 46. Dimming Complete


4

Advanced Features

The Advanced Features tab is located on the Starting Tab. Use this selection to display Operation Data and Fault Data.

46 Advanced Features

Control Data When the Advanced Feature tab is open, it displays a page called Operation Data, Fault Data Configuration. Inside the page are two tabs called Control Data and Fault Data. Select the Control Data tab, shown in Figure 47.

Figure 47. Control Data

The fields for the Control Data tab are described below.

• Select the Poll Delay from the dropdown list. • Select the Scan Interval from the dropdown list. This is the interval of

time to scan the nvoLcControlData Operation data. • Enter the Start Delay. Time is entered in seconds to delay calculation if the

first scan time does not allow the data server to complete object initialization.

• Disabling the polling persists until you enable it again. This turns off historical data access.

• Enter the Lost Device Threshold. This is the number of confirmed lost devices to raise the system comms alarm.

• Enter the Response Fail Threshold. When the device is not polled at least this number of consecutive times, a lost device alarm is triggered.

Fault Data The Fault Data tab is the second tab on the Advanced Feature page. Select the Fault Data tab. The Fault Data screen is shown in Figure 48.


Figure 48. Fault Data

The fields for the Fault Data tab are described below.

• Select the Poll Delay from the dropdown list. • Select the Scan Interval from the dropdown list. This is the frequency of

time to scan the nvoLcStatus fault data. • Enter the Start Delay. Time is entered in seconds to delay calculation if the

first scan time does not allow the data server to complete object initialization.

• Disabling the polling will persist until you take action to enable it again. This turns off historical data access.

• Enter the Lost Device Threshold. This is the number of confirmed lost devices to raise a system alarm.

• Enter the Response Fail Threshold. When the device is not polled at least this number of consecutive intervals, a lost device alarm is raised.

48 Advanced Features

About Page

Click in the top of the LumInsight Provisioning Tool menu (*) to see information about the application version of your software, shown in Figure 49.

Figure 49. About Page

System Information The About selection opens a dialog of system information, shown in Figure 50.

Figure 50. System Information


Close

To exit the LumInsight Provisioning Tool, click on the asterisk in the top left corner and select Close from the list that opens. If you try to close with a project left open, you will be asked to save the project. Figure 51 shows you how to Close.

Figure 51. Close the LumInsight Provisioning Tool

Documents

LumInsight Provisioning Tool User's Guide...You can exit the LumInsight Provisioning Tool by clicking on the Asterisk in the top left hand corner of the screen. A menu drops down to