Top Banner
Offline Configurator XML OFFLINE BusAdapter TelevisGo BusAdapter SerialAdapter RadioAdapter RS485 RS485 NETWORK (Internet) ONLINE XML OFFLINE MANAGEMENT AND MONITORING Tool for the Offline configuration of a controller network The Offline Configurator is a software application for PCs that is able to configure a network of controllers by defining structured abstract rules. USER MANUAL
24

Offline Configurator - Oehme-

Feb 16, 2022

Download

Documents

dariahiddleston
Welcome message from author
This document is posted to help you gain knowledge. Please leave a comment to let me know what you think about it! Share it to your friends and learn new things together.
Transcript
Page 1: Offline Configurator - Oehme-

Offline Configurator

XML

OFFLINE

BusAdapter

TelevisGoBusAdapter

SerialAdapter

RadioAdapter

RS485

RS485

NETWORK (Internet)

ONLINE

XML

OFFLINE

MA

NA

GEM

ENT

AN

D M

ON

ITO

RIN

G

Tool for the Offline configuration of a controller network

The Offline Configurator is a software application for PCs that is able to configure a network of controllers by defining structured abstract rules.

USERMANUAL

Page 2: Offline Configurator - Oehme-

Offline Configurator

CONTENTS

1. USING THE MANUAL ........................................................................................... 3

2. INTRODUCTION ................................................................................................... 42.1 STARTING ..........................................................................................................................................................................42.2 OPERATING MODES .......................................................................................................................................................4

3. USER INTERFACE .................................................................................................. 63.1 COMMON PANEL ............................................................................................................................................................6

3.1.2 COMMON ICONS .........................................................................................................................................................................................................................6

3.2 CONTROLLER TEMPLATES............................................................................................................................................73.3 NETWORKING NAMING ................................................................................................................................................9

3.3.1 NETWORK DESIGNER ..................................................................................................................................................................................................................9

3.3.2 NETWORK RULES ....................................................................................................................................................................................................................... 11

3.4 ALARM CATEGORIES ................................................................................................................................................... 133.4.1 TIME INTERVALS ......................................................................................................................................................................................................................... 13

3.4.2 ACTIONS....................................................................................................................................................................................................................................... 14

3.4.3 ALARM CATEGORIES ................................................................................................................................................................................................................. 15

3.5 SCHEDULED ACTIONS ................................................................................................................................................ 173.6 SETTINGS ........................................................................................................................................................................ 213.7 INSTRUMENTS SELECTION PANEL .......................................................................................................................... 213.8 RESOURCES SELECTION PANEL .............................................................................................................................. 223.9 EXPORT PANEL .............................................................................................................................................................. 23

4. WARNINGS ........................................................................................................ 244.1 RESPONSIBILITY AND RESIDUAL RISKS................................................................................................................. 244.2 DISCLAIMER ................................................................................................................................................................. 24

Page 3: Offline Configurator - Oehme-

Offline Configurator Pag. 3/24

To allow quick, easy reference, the guide has been designed with the following features:

Important!: Information that the user must be aware of to prevent any damage to the system or hazards for people, devices, data, etc. Users MUST read and take note of these sections.

Indication/highlighted text: further information on the topic in question that the user should be aware of.

Suggestion: a suggestion that could help the user to understand and make better use of the information provided.

ADVANCED FUNCTIONS All texts inside the yellow boxes refer to functions not available in the standard installation For additional information, please contact the Eliwell Support Service.

1. USING THE MANUAL

Page 4: Offline Configurator - Oehme-

Offline Configurator Pag. 4/24

2. INTRODUCTION

The OfflineConfigurator is a supporting software application for the product TelevisGo; this guide makes reference to concepts used in other specific manuals that the user will refer to.

Most of the TelevisGo functions can be configured OFF-LINE, i.e. from any PC, without having to be connected in a network or to TelevisGo itself.

For this reason, a special application called the OffLineConfigurator has been created.

This tool is available on the Eliwell site, subject to Level II registration: Login to www.eliwell.it and request access to the Level II Restricted Area.

OffLineConfigurator is an application for Windows which allows the following configurations to be made:

• Assignment of long and short aliases to network instruments.• Assignment of long and short aliases to network instrument resources and alarm delay times.• Assignment of actions to be taken in the event of alarms.• Events scheduling.

PREREQUISITES:A PC with one of the following operative systems is required for the use of the OffLineConfigurator:

• Windows XP• Windows Vista• Windows 7

Also, .NET Framework 2.0 or later must be installed (refer to Microsoft sites).

2.1 STARTINGOffLineConfigurator does not require installation: just copy the entire Offline Configurator folder into a folder in the PC where it will be run.

OffLineConfigurator can also be run directly from a USB key. The user can thus have the application with him or her at all times and run it as and when needed on any PC that meets the requirements listed above.

To start OffLineConfigurator, go into the Offline Configurator folder and double click on the file:• Invensys.Tools.OffLineConfigurator.exe

2.2 OPERATING MODESThe OffLineConfigurator makes it possible to create models for assigning values/actions to one or more instruments/resources on the network; working offline, i.e. with no instruments/resources specific to a particular network, the user works by defining general rules to be applied by means of filters:

• Definition of Filter: selects the instruments/resources in a network to be assigned with a value/action• Definition of value/action: defines the value/action to be assigned to the instruments/resources selected by the Filter

For each set of defined configurations, the OffLineConfigurator produces user-assignable xml files, filed by name, in the following folders:

• Offline Configurator\MyFiles\ControllerTemplates• Offline Configurator\MyFiles\AlarmCategories• Offline Configurator\MyFiles\ScheduledActions• Offline Configurator\MyFiles\NewtoworkNaming

On connecting to TelevisGo via Internet, it will be possible to upload the xml files created by the OffLineConfigurator , after exporting them (see ‘EXPORT PANEL’ chapter), and then to enter the system update section and proceed with the application of the defined models to the network of instruments (refer to specific sections of corresponding manuals).

Page 5: Offline Configurator - Oehme-

Offline Configurator Pag. 5/24

NETWORK (Internet)

BusAdapter

TelevisGo

BusAdapter

SerialAdapter RadioAdapter

RS485

RS485ONLINE

XML

OFFLINE

Previously created xml files are reusable in new configurations, thus allowing the user to create libraries that can be assigned to the systems being managed when needed.

As this is an offline configuration, the tool does not know which actual devices are in the network and therefore ‘works’ for general categories and identifiers; the user must have the expertise to define configurations that are congruent with the networks they are to be applied to. Any filters, names, values and actions that refer to nonexistent interfaces, devices and resources will have no effect and the ineffectiveness of the setting will not be signalled in any way.

Page 6: Offline Configurator - Oehme-

Offline Configurator Pag. 6/24

3. USER INTERFACE

All the available functions can be accessed from the OffLine Configurator main panel:

Device templates Network naming Alarm categories Scheduled actions SettingsLayout

At the top there are 6 buttons for accessing the different sections:

• Device templates• Network Naming• Alarm categories• Scheduled actions• Layout• Settings

3.1 COMMON PANELWhen one of the 5 OffLine Configurator sections is accessed, a Panel will open with the following standardised structure:

Panel Title

Edit View XML Copy Remove Add Export

Field 1 Field 2 Field 3 Fields 4

Element 1 Field Value 2 Field Value 3 Field Value 4

Element 2 Field Value 2 Field Value 3 Field Value 4

Element 3 Field Value 2 Field Value 3 Field Value 4

Title Bar: gives the name of the section to which the panel refers.

Toolbar: under the title bar, containing all the operating buttons in the panel.

Grid: contains all the previously defined and saved elements. One or more fields are listed that can vary according to the section that the panel refers to. An element can be selected from the grid; the background of the selected element turns blue.

3.1.2 COMMON ICONSIn each of the different sections of OffLine Configurator, at the top of the window, there is the toolbar.Most of the icons displayed are common to all sections and have the same meaning. The descriptions are as follows:

Edit: Accesses the edit window for the element selected in the grid below.

View XML: Views the XML code of the element selected in the grid below.

Copy: Copies the element selected in the grid below; a window will appear for assigning a name to the copy.

Remove: Removes the element selected in the grid below. Important! the removal is immediate and irreversible.

Add: Adds a new element; accesses the edit page for the new element.

Export: Exports the xml files to be uploaded into TelevisGo to configure the network according to the defined rules; accesses a page where the configurations to be exported and the <path>\<filename> to be assigned can be selected (see chapter Export Panel).

Import: Allows the importation of previously exported xml files.

Page 7: Offline Configurator - Oehme-

Offline Configurator Pag. 7/24

3.2 CONTROLLER TEMPLATESIn this section it is possible to define configuration models for assigning aliases and shortened aliases to the resources of the instruments in a network. Also, delay times can be set for alarm resources.

In the grid, under the toolbar, the previously saved configurations (files) are displayed; there are 4 fields:

• Name: name assigned by the user to the configuration.

• Language: the reference language of the configuration.

• Associated actions: total number of actions defined by the configuration.

• File name: the name of the file (.xml) where the configuration is saved.

Click on the Add button (or on Edit, after selecting an element from the grid) to access the window where a new configuration can be defined:

Edit Controller Template

EWCM 4120Save Action Wizard

Actions

General Settings

File name

Description

EnglishLanguage

Add new Action Filters

Value

Code

Name

Alias

Preview

Preview

Alias (short)

Auto Index

Alarm delay

Fuori True False

0 minutes

Filters

Value

CodeName

AliasAlias (short)Alarm delayOut of network

Filters

Value

CodeName

AliasAlias (short)Alarm delayOut of network

GENERAL SETTINGS SECTION:At the top, in the General Settings box, there are the following controls:

• File Name: here, the name can be assigned to the file that will contain the naming rules defined below;

Important!: once the file is saved, the only way the name can be changed is by accessing the folder Offline Configurator\MyFiles\ControllerTemplates and editing the file name with Windows tools (right mouse button -> Rename)

• Description: here, a name/short description can be assigned that will appear in the grid of the Controller Templates panel in the Name field;

• Language: here it is possible to select one of the available dictionaries for defining the naming rules;

The language selected must be the same as the one used by the network instruments in order to ensure the congruence and functionality of any filters set on the names.

Page 8: Offline Configurator - Oehme-

Offline Configurator Pag. 8/24

ACTIONS WIZARD SECTION:The Action Wizard control is at the top left.This has been designed to simplify the configuration of the resources of an Eliwell instrument.Select a model from the drop down menu, then click on the button to open a panel containing all and only the resources related to the selected model.

ACTIONS SECTION:In the Actions box, the user can define the naming rules; there are two sub-sections:

Left side:Contains the list of currently saved actions: each action is framed in a box; if there are more than two actions a scroll bar will appear.

Add New Actions: click on this button to create a new empty action that can be edited on the right side.

Edits the the selected action: the right side will be filled with the current values that can be edited.

Moves the selected action up one position.

Moves the selected action down one position.

Eliminates the selected action. Important! The elimination is immediate.

Right side:Contains the form for defining/editing the currently selected action.

FILTERSIn this section you can define which instruments on the network the Values below will be applied to.

• Code(*): in this text box, enter the code that the Values below will be applied to;e.g.: INP40096, STA00042, ALM00158 ...Click on the button to access the Resources Selection Panel for making a quick, exact selection.

• Name(*): in this text box, enter the name of the resource that the Values below will be applied to;e.g.: Analogue input TCT gain, remote On/Off, Defrost time-out...Click on the button to access the Resources Selection Panel for making a quick, exact selection.

(*) Upper and lower case letters, numbers and some special characters are accepted ( : , - , _ , <space>).Wildcard characters can be used ( ? represents any character; * represents any sequence of 0 or more characters).

VALUEThis section is for defining the values to be assigned to the resources that will be selected by the filter defined above.

• Alias: in this text box, enter the alias to be assigned to the resources selected by the filter (max 25 characters).

• Preview: this is an automatic field where a preview of the assigned name will appear.

• Short Alias: In this text box, enter the short alias to be assigned to the resources selected by the filter (max 25 characters) (remember that the short alias will be used to identify the resource for text messaging).

• Auto Index: select this checkbox to enable the auto-indexingfunction;

the buttons appear to the right of the Code and Name text boxes, and each time a button is clicked a marker {0}; will be inserted in the Code/Name; when the rule is applied in the network an automatic counter will operate and the current counter value will be inserted in place of the {0} (index);

e.g.: if the name assigned is ‘Defrost Probe {0}’ and the number of filtered resources is 3 elements, the names ‘Defrost Probe 0’, ‘Defrost Probe 1’, ‘Defrost Probe 2’ will be assigned in the order in which they are detected.

In the Start Index box, set the number of counter starts.

• Delay (minutes): this is applicable only for Alarm resources (code ALM*); it sets the delay Tr before the activation of the alarm (the alarm will not generate actions/notifications if it lasts less than the time Tr (expressed in minutes).

• Out of Network: if selected, the resource will not be visible to the system.

On exiting the form, the entered data will be saved automatically.

The configurations (files) defined in this section will be reusable in the Networking Naming Rule section; the user thus has the possibility of structuring his or her configurations in a modular and flexible way, creating libraries that can be used as and when needed.

Page 9: Offline Configurator - Oehme-

Offline Configurator Pag. 9/24

Select

Digital State STA00219 Indice della prima cardDigital State STA00218 Number of analog outputs provided

Digital State STA00317 Device in COOLDigital State STA00215 Number of digital outputs provided

Alarm delayType Code Name Out of NetworkAliasSelected

..........................

Index of the �rst cardNumber of analog outputs providedNumber of analog outputs providedNumber of analog outputs provided

For each resource selected (Selected column) it will be possible to define the following parameters:

• Alias• Out of Network• Alarm Delay (for alarm resources)

Click on the button and all the entered data will be shown in the Actions section, as illustrated previously.

3.3 NETWORKING NAMINGIn this section, the configuration models can be defined for the assignment of

• Aliases and short aliases to the instruments in a network.• Aliases and short aliases to the resources of the instruments in a network.

2 sub-sections are available:

• Network Designer• Network Rules

These sections have analogous functions, with the following differences:

Network Designer has been designed for quicker configuration, but with filters that can act only on: • instruments address

Network Rules has been designed for quicker configuration, but with filters that can act only on:• instruments address• instruments name• instruments model

3.3.1 NETWORK DESIGNERIn the grid, under the toolbar, the previously saved configurations (files) are displayed; there are 4 fields:

• Name: name assigned by the user to the configuration.• Language: the reference language of the configuration.• Associated Actions: total number of actions defined by the configuration.• File name: the name of the file (.xml) where the configuration is saved.

Click on the Add button (or on Edit, after selecting an element from the grid) to access the window where a new configuration can be defined:

Save Check

Actions

General Settings

File name

Description

EnglishLanguage

Add new action

Network naming Rules

0 0Address :

-- None --Template Alias

Alias (short) } 0Auto Index +

0 0: 0 -- None --

0 0: 0 -- None --

Address AliasAlias (short) Index Template

Page 10: Offline Configurator - Oehme-

Offline Configurator Pag. 10/24

GENERAL SETTINGS SECTION:At the top, in the General Settings box, there are the following controls:

• File name: here, the name can be assigned to the file that will contain the naming rules defined below.

IMPORTANT! once the file is saved, the only way the name can be changed is by accessing the folder Offline Configurator\MyFiles\NewtoworkNamingRules and editing the file name using Windows tools (right mouse button -> Rename).

• Description: here, a name/short description can be assigned that will appear in the grid of the Network Naming Rules panel in the Name field.

• Language: here it is possible to select one of the available dictionaries for defining the naming rules.

The language selected must be the same as the one used by the network instruments in order to ensure the congruence and functionality of any filters set on the names.

ACTIONS SECTION:

There are two sub-sections:

• Add New Action• Network naming Rules

ADD NEW ACTION• Indirizzo: enter the network address of the instrument to be configured (address filter) here

• Short Alias: in this text box, enter the short alias to be assigned to the instruments selected by the filter (max 25 characters).(remember that the short alias will be used to identify the resource for text messaging).

• Alias: in this text box, enter the alias to be assigned to the instruments selected by the filter (max 25 characters).

• Preview: this is an automatic field where a preview of the assigned name will appear.

• Auto Index: select this checkbox to enable the auto-indexing function; the buttons appear to the right of the Code and Name text boxes, and each time a button is

clicked a marker {0}; will be inserted in the Code/Name; when the rule is applied in the network an automatic counter will operate and the current counter value will be inserted in place of the {0} (index). e.g.: if the name assigned is ‘Refrigerated Counter {0}’ and the number of filtered resources is 3 elements, the names ‘Refrigerated Counter 0’, ‘Refrigerated Counter 1’, ‘Refrigerated Counter 2’ will be assigned in the order in which they are detected.In the Index box, set the number of counter starts.

• Template: rules can be defined for naming the resources of the instruments selected by the filter; the naming mode can be selected in this drop down menu:

• None: in this case, no configuration will be set for the resources of the instrument selected by the filter.

• External: in this case, names can be assigned by reusing the configurations (files) defined in the Controller Templates section; the list of all the currently available configurations will be shown in the Assigned Template list below; the user can select which one to apply.

• Embedded: in this case, the naming rules are ‘newly’ defined; click on the Edit button to access the Controller Templates Panel (see previous chapter).

If Embedded mode is chosen, the rules applied to the resources will be defined (saved) within the rules to be applied to the instruments defined in this section (the same xml file); unlike in the External mode, they will then be embedded and not reusable. The External mode is recommended for a more organised, modular and scalar approach.

• Use the button to add the set action to the Network naming Rules list.

Any value set in this section can be completely changed directly in the Network naming Rules list below.

NETWORK NAMING RULESThis sub-section contains the list of all the correctly assigned actions.

• The Address, Short Alias, Alias, Index and Template fields are freely assignable/editable.

• The button deletes an action.

Important! The removal is immediate and irreversible.

• The button copies the action (which is added at the end of the list)

• The list can be ordered by Address and Alias by clicking on the items in the heading of the list.

The Check 01:02 button on the top left checks that there are no repeated addresses in the Network Naming Rules list.

If there are, the repeats will be highlighted on a red background.

Page 11: Offline Configurator - Oehme-

Offline Configurator Pag. 11/24

3.3.2 NETWORK RULES

In the grid, under the toolbar, the previously saved configurations (files) are displayed; there are 5 fields:

• Name: name assigned by the user to the configuration.• Language: the reference language of the configuration.• Associated Actions: total number of actions defined by the configuration.• External Templates: number of resource configurations that the saved file refers to (see chapter Controller Templates).• File name: the name of the file (.xml) where the configuration is saved.

Click on the Add button (or on Edit, after selecting an element from the grid) to access the window where a new configuration can be defined:

Save

Actions

General Settings

File name

Description

EnglishLanguage

Add new Action Filters

Value

Model

Name

Address

Alias

Preview

Preview

Alias (short)

Auto Index

Filters

Value

AddressName

AliasAlias (short)

Model

Filters

Value

AddressName

AliasAlias (short)

Model

-- None --Controller Template

GENERAL SETTINGS SECTION:At the top, in the General Settings box, there are the following controls:

• File name: here, the name can be assigned to the file that will contain the naming rules defined below.

Important! once the file is saved, the only way the name can be changed is by accessing the folder Offline Configurator\MyFiles\NewtoworkNamingRules and editing the file name using Windows tools (right mouse button -> Rename).

• Description: here, a name/short description can be assigned that will appear in the grid of the Network Naming Rules panel in the Name field.

• Language: here it is possible to select one of the available dictionaries for defining the naming rules.

The language selected must be the same as the one used by the network instruments in order to ensure the congruence and functionality of any filters set on the names.

ACTIONS SECTION:In the Actions box, the user can define the naming rules; there are two sub-sections:

Left side:Contains the list of currently saved actions: each action is framed in a box; if there are more than two actions a scroll bar will appear.

Page 12: Offline Configurator - Oehme-

Offline Configurator Pag. 12/24

Add New Actions: click on this button to create a new empty action that can be edited on the right side.

Edits the the selected action: the right side will be filled with the current values that can be edited.

Moves the selected action up one position.

Moves the selected action down one position.

Eliminates the selected action. Important! The removal is immediate and irreversible.

Right side:Contains the form for defining/editing the currently selected action.

FILTERSIn this section you can define which instruments on the network the Values below will be applied to:

• Address(*): in this text box, enter the address of the instrument that the Values below will be applied to. e.g.: 00:02, 04:02, 11:11.

• Model(*): in this section you can enter the instrument model the Values below will be applied to. e.g.: EWCM 4120. Click on the button to access the Instruments Selection Panel for making a quick, exact selection.

• Name(*): in this text box you can enter the name of the instrument the Values below will be applied to.

(*) Upper and lower case letters, numbers and some special characters are accepted ( : , - , _ , <space>)Wildcard characters can be used ( ? represents any character; * represents any sequence of 0 or more characters).

VALUEIn this text section, set the name of the values to be assigned to the instruments that will be selected by the filter defined above.

• Alias: in this text box, enter the alias to be assigned to the instruments selected by the filter (max 25 characters).

• Preview: this is an automatic field where a preview of the assigned name will appear.

• Short alias: in this text box, enter the short alias to be assigned to the instruments selected by the filter (max 25 characters).(remember that the short alias will be used to identify the resource for text messaging).

• Auto Index: select this checkbox to enable the auto-indexing function;the buttons appear to the right of the Code and Name text boxes, and each time a button is clicked a marker {0}; will be inserted in the Code/Name; when the rule is applied in the network an automatic counter will operate and the current counter value will be inserted in place of the {0} (index).

e.g.: if the name assigned is ‘Refrigerated Counter {0}’ and the number of filtered resources is 3 elements, the names ‘Refrigerated Counter 0’, ‘Refrigerated Counter 1’, ‘Refrigerated Counter 2’ will be assigned in the order in which they are detected.

In the Index box, set the number of counter starts.

• Controller Template: rules can be defined for naming the resources of the instruments selected by the filter; the naming mode can be selected in this drop down menu:

• None: in this case, no configuration will be set for the resources of the instrument selected by the filter.

• External: in this case, names can be assigned by reusing the configurations (files) defined in the Controller Templates section; the list of all the currently available configurations will be shown in the Assigned Template list below; the user can select which one to apply.

• Embedded: in this case, the naming rules are ‘newly’ defined; click on the Edit button to access the Controller Templates Panel (see previous chapter).

If Embedded mode is chosen, the rules applied to the resources will be defined (saved) within the rules to be applied to the instruments defined in this section (the same xml file); unlike in the External mode, they will then be embedded and not reusable. The External mode is recommended for a more organised, modular and scalar approach.

Page 13: Offline Configurator - Oehme-

Offline Configurator Pag. 13/24

3.4 ALARM CATEGORIESThis section is for defining models for the configuration of alarms and consequent actions on the instruments in a network.

Click on the arrow to the right of the button and a submenu appears where one of the following options can be selected:

• Alarm Categories

• Time Intervals

• Actions

The sections related to the three options ‘work together’: In Time Intervals, general time intervals can be defined and names assigned to them; In Actions, general actions to be taken in the event of an alarm can be defined and names assigned to them; In Alarm Categories, you can define the filters (rules) for selecting the network instruments to be configured with alarms within the Time Intervals and the consequent previously defined actions (selectable by name).

3.4.1 TIME INTERVALSIn this section, it is possible to define general time intervals to be reused in the definition of alarms in the Alarm Categories section.

In the grid, under the toolbar, the previously saved configurations (files) are displayed; there are 3 fields:

• Type: with an icon that identifies the type of interval defined:

• indicates Daily Frequency

• indicates Weekly Frequency

• indicates Monthly Frequency

• Name: name assigned by the user to the interval.

• File name: the name of the file (.xml) where the configuration is saved.

Click on the Add button (or on Edit, after selecting an element from the grid) to access the window where a new configuration can be defined:

EditTimeFrameForm

Save

File Name

Description

Enabled

Daily periodicityType

10:30 11:30

• File name: here, the file that will contain the time interval defined below can be named.

Important! once the file is saved, the only way the name can be changed is by accessing the folder Offline Configurator\MyFiles\AlarmCategories and editing the file name using Windows tools (right mouse button -> Rename)

• Description: here, a name/short description can be assigned that will appear in the grid of the Time Intervals panel in the Name field

Page 14: Offline Configurator - Oehme-

Offline Configurator Pag. 14/24

• Enabled: if not selected, this time interval will not be visible to the system.• Type: here, the type of interval can be defined on the basis of three options:

• Daily Frequency: the interval is defined as a time within each day. In this case, the time slot starting time and finishing time can be set with the selectors underneath.

• Weekly Frequency: the interval is defined in days of the week/times within each week. In this case, the type of interval can be defined with the radio buttons:

• Continuous• Periodic

Make reference to the Time Intervals chapter in the TelevisGo manuals.

• Monthly Frequency: the interval is defined in days of the month (1-31)/times within each month. In this case, the type of interval can be defined with the radio buttons:

• Continuous• Periodic

Make reference to the Time Intervals chapter in the TelevisGo manuals.

3.4.2 ACTIONSIn this section you can define the general Actions to be taken in the event of an alarm, to be reused in the Alarm Categories.

In the grid, under the toolbar, the previously saved configurations (files) are listed; there are 3 fields:• Type: With an icon that identifies the type of interval defined:

• send text message via Modem.

• send e-mail.

• send notification to Televis Twin.

• send commands to one or more network instruments.

• send Phone Call.

• Name: name assigned by the user to the Action.

• File name: the name of the file (.xml) where the configuration is saved.

Click on the Add button (or on Edit, after selecting an element from the grid) to access the window where a new configuration can be defined:

Action

Save

File name

Name

Enabled

SMS via ModemType

Number of

SMS via modemEmailTelevisTwinRelaysCommandsPhone Call

File name: here, the file that will contain the action defined below can be named.

Important! once the file is saved, the only way the name can be changed is by accessing the folder Offline Configurator\MyFiles\AlarmCategories and editing the file name using Windows tools (right mouse button -> Rename).

• Name: here, a name/short description can be assigned that will appear in the grid of the Actions panel in the Name field.

• Enabled: if not selected, this action will not be visible to the system.

Page 15: Offline Configurator - Oehme-

Offline Configurator Pag. 15/24

• Type: here, the type of action can be defined on the basis of six options:

• SMS via Modem: in the event of an alarm, an SMS will be sent on the basis of what has been entered in the fields below:

• Number of: the phone number that the SMS is to be sent to.

IMPORTANT: always enter the international dialling code before the recipient’s telephone number (e.g.: for Italy, enter +39)

• e-mail: in the event of an alarm, an e-mail will be sent on the basis of what has been entered in the fields below:

• e-mail: the e-mail address to which the notification is to be sent.

• Televis Twin: in the event of an alarm, a notification will be sent to aTelevis Twin connected in a network and configured to receive alarms detected by TelevisGo on the basis of what has been entered in the fields below:

• IP1: main IP address of device (e.g.: 192.168.0.23 : 8080).

• IP2: alternative IP 2 address, if any.

• IP3: alternative IP 3 address, if any.

• SMS: enter the phone number you want TXT messages to go to (e.g.: +39 333 7600000).

IMPORTANT: always enter the international dialling code before the recipient’s telephone number (e.g.: for Italy, enter +39)

• Commands: in the event of an alarm, commands will be sent to one or more network instruments on the basis of what has been entered in the fields below:

• Instrument: the instrument to which the commands will be sent (Filter).Click on the Build button and a window will open for the assignment of the filter on the basis of 3 settings:

• ID: the instrument’s ID.

• Family: family number assigned to the instrument.

• Address: address number assigned to the instrument.

• Command on Alarm: sets the commands to be sent to the selected instrument on the basis of what has been entered in the Instrument command.Click on the button to access the Resources Selection Panel for making a quick, exact selection of the function.

• #Arguments: defines one or more topics to be attributed to the function (where necessary):

• to enter a topic, type it into the text box and then click on the button.

• the buttons move the position of the topic up or down in the list.

• the button deletes the selected topic.

• Phone Call: in the event of an alarm, a phone call will be sent on the basis of what has been entered in the fields below:

• Number of: the phone number to be called.

IMPORTANT: always enter the international dialling code before the recipient’s telephone number (e.g.: for Italy, enter +39)

3.4.3 ALARM CATEGORIESIn this section, the actions to be taken in the event of an alarm on one or more Televis network instruments can be defined on the basis of set time slots; the configurations created in the Time Intervals and Actions sections are reused here.

In the grid, under the toolbar, the previously saved configurations (files) are listed; there are 3 fields:

• Name: name assigned by the user to the configuration.

• Scale: ticked if the checking of the higher levels is enabled (see Alarm Categories chapter).

• File name: the name of the file (.xml) where the configuration is saved.

Click on the Add button (or on Edit, after selecting an element from the grid) to access the window where a new configuration can be defined:

Page 16: Offline Configurator - Oehme-

Offline Configurator Pag. 16/24

Alarm categories

Save

Details

Actions

FiltersFile name

NameDevices

Alarms

Time intervalsAlways

My Interval 1My Interval 2My Interval 3My Interval 4

ActionsMy Action 1My Action 2My Action 3My Action 4

Edit

Edit

Enabled

Escalate

Address=00:0?

ID=0

Device

Interface

Name=*2*

Resource

Three sub-sections are highlighted:

• Details: this sub-section is for assigning the details of this configuration:

• File name: here, the file that will contain the time interval defined below can be named.

Important! once the file is saved, the only way the name can be changed is by accessing the folder Offline Configurator\MyFiles\AlarmCategories and editing the file name using Windows tools (right mouse button -> Rename).

• Name: here, a name/short description can be assigned that will appear in the grid of the Alarm Categories panel in the Name field.

• Enabled: if not selected, this time interval will not be visible to the system.

• Scale: if ticked, enables the checking of the higher levels (see Alarm Categories chapter in TelevisGo).

• Time: in this sub-section, one or more time intervals can be selected in which one or more actions can be taken in the event of an alarm.

The selectable intervals are those defined previously in the Time intervals section, plus the option Always, which is preset; selecting Always will disable the other intervals. The selectable actions are those defined previously in the Action section.

• Filters: in this sub-section, the rules (filters) are set for defining the alarm instruments and resources to which the selected actions in the selected time intervals will be assigned.

• InstrumentsClick on the Edit button to open a panel for selecting the instruments that the configuration described below will be applied to.

More than one interface can be set and more than one instrument within each interface.

Filtering can be by

• Interface

• ID(*).

• Name(*) (e.g.: com 1 and/or com2 for lan adapter or 192.168.0.43 for lan adapter).

and by selecting the Instrument interface within the set interface:

• Address(*) (<family>:<address> e.g.: 00:07)

• Model(*).

• Name(*) .

Page 17: Offline Configurator - Oehme-

Offline Configurator Pag. 17/24

• AlarmsClick on the Edit button to open a panel for selecting the alarms that the current configuration will be applied to:Filtering can be by

• Resource

• ID(*).

• Name(*)

Click on the button to access the Resources Selection Panel for making a quick, exact selection.

More than one resource can be used.

(*) Wildcard characters can be used. (? represents any character; * represents any sequence of 0 or more characters. If the field is left empty, the filter will not act on that specific characteristic).

3.5 SCHEDULED ACTIONSIn this section it is possible to define the send commands/writing parameters actions for one or more instruments/resources in the network within the set time slots.

Make reference to the basic concepts expressed in the Scheduled Activities chapter of the TelevisGo.

In the grid, under the toolbar, the previously saved configurations (files) are displayed; there are 3 fields:

• Type: with an icon that identifies the type of action taken:

• indicates sending a command.

• indicates writing parameters.

• Name: name assigned by the user to the Action.

• File name: the name of the file (.xml) where the configuration is saved.

Click on the Add button (or on Edit, after selecting an element from the grid) to access the window where a new configuration can be defined:

Scheduled Action

Save

Details

Schedule Action

Filters

EnglishLanguage

Edit

Type=analog

Name=*2*

Address=00:0?

ID=0

Selector

Resource

Device

Interface

File name

Name

Monday 30 june 2011 09:34Starting date

0 0 0 0 Days.Hours:minutes:SecondsRetry interval

0 0 0 0 Days.Hours:minutes:SecondsRetry duration

Periodic Daily Weekly Command Parameter writing

Parameter map Parameters

There are four sub-sections:Details: this sub-section is for defining the information common to all types of action and scheduling:

• File name: here, the file that will contain the Scheduled Action defined here can be named.

Important! once the file is saved, the only way the name can be changed is by accessing the folder Offline Configurator\MyFiles\ScheduledActions and editing the file name using Windows tools (right mouse button -> Rename).

Page 18: Offline Configurator - Oehme-

Offline Configurator Pag. 18/24

• Name: here, a name/short description can be assigned that will appear in the grid of the Scheduled Actions panel in the Name field.

• The starting Date (and time): here, the starting date and time of the scheduled action can be specified: Click on the setting to be changed (day of the month, name of moth, year, hour, minute) then act on the corresponding

command on the right .

• Retry interval: set the retry interval for the action here (Days.Hours:minutes:Seconds).

• Retry duration: set the duration of the retry of the action here (Days.Hours:minutes:Seconds).

Scheduling: the time slots for the actions are defined in this sub-section:

• Type: the type of time slot to be used can be selected here:

• Periodic: set the time interval between two consecutive actions.

Schedule

Type Periodic

0 0 0 0Period Days.Hours:minutes:Seconds

• Daily: set every how many days the action is to be performed and at least one time in the day when it must be performed.

Schedule

Type Daily

0Period

0 0Execution times Add

Remove

02:10:0015:22:30

• Weekly: set every how many weeks and on which day of the week the action is to be performed, and at least one time in the day when it must be performed.

Schedule

Type Weekly

0Period

0 0Execution times

Add

Remove

02:10:0015:22:30

WeekSundayMondayTuesdayWednesdayThursdayFridaySaturday

For details on use refer to the chapter Adding, editing and removing scheduled actions in the TelevisGo manual.

Actions: the actions to be taken are defined in this sub-section:

• Type: the type of action to be taken can be selected here:

• Command:here it is possible to define a command to be given to the instruments selected by the filter in the scheduling.Click on the button to access the Resources Selection Panel for making a quick, exact selection.The topics of the command can be set in the Arguments section (when necessary), in the same way as in the Actions chapter.

Page 19: Offline Configurator - Oehme-

Offline Configurator Pag. 19/24

Action

Type Command

Command Get from list

Arguments

• Writing parameters:here it is possible to define the writing of one or more of the parameters on the instruments selected by the filter in the scheduling.

• Type: there can be two types of writing:

• Parameter map:The parameter writing is done by means of a parameters map file.Enter the name of the file in the File name box (e.g.: map.dat).

The user is responsible for loading the file correctly into TelevisGo (refer to specific manual)

Action

Type Parameter writing

Parameter mapType

File name

• Parameters:in this case the list of parameters to be written are defined one by one:

• Label: enter the parameter label (e.g.: HAL, LAL ...).

• Value: enter the parameter value.

• Add: click here to add the parameter and related value to the list on the right.

• Select an element from the list and click on Remove to remove it.

Action

Tipo Command

ParametersTipo

Add

Label

Value

Add

Label Value

Remove

Once the scheduled action is saved it will no longer be possible to change the Type.

Page 20: Offline Configurator - Oehme-

Offline Configurator Pag. 20/24

Filters: this sub-section is for setting the filters for the selection of the instruments/resources that the defined actions will be applied to.

Click on the Edit button to go to the filter definition page:

Save Add selector View XML

Filters Details

Type=analog

Name=Lower limit probe

Address=00:09

ID=0

Selector

Resource

Device

Interface

AB

CD

E

F

C - Selector D - Interface

AllAnalogDigitalStateAlarm

Resources

Type Add

Save

ID

Name

Save

E - Instrument F - Resource

Address

Name

Model

Save

ID

Name

Type

Save

The filters are set in the same ways as described in the Filters chapter in the TelevisGO manual, with the following differences:

• the sbuttons are the ones on the top left (A) and not the ones next to each element in the tree: these act on the selected element.

• to edit an element of the tree simply select it and edit the section Details (B) (there is no need to click on the edit button).

• as this is an offline configuration, the tool does not know which devices are actually present in the network and therefore ‘works’ for categories and general identifiers; this why there are no Rapid Selection boxes; instead, there is the Resources Selection Panel (click on ) (see Resources Selection Panel chapter)

After entering the data, press Save ( ) to save the changes.

Page 21: Offline Configurator - Oehme-

Offline Configurator Pag. 21/24

3.6 SETTINGSThe OfflineConfigurator language can be defined in this section.

OfflineConfigurator must be rebooted to make the changes effective.

The selected language is effective on the OfflineConfigurator pages only and is different to the language field in the Controller Templates, Networking Naming Rules sections.

3.7 INSTRUMENTS SELECTION PANELThis panel simplifies the selection of the models of the devices in the different OfflineConfigurator sections.Under the toolbar there is a grid with all the possible instruments, coded.The fields in the panel are:

• Model: the name of the Eliwell instrument:

Select Filter

Model

EWCM 4120EWCM 4150

EWCM 809/SEWCM 4180

.............

.............

.............

There is a control in the toolbar for filtering the list of elements in the grid:

• Text Filter: when text is entered in the Filter box, the list in the grid is modified (in real time), keeping all the models whose names will contain the entered characters.The filter can be removed by either clicking on the button or eliminating the contents of the box.

The button takes you to the model selected in the panel; double-clicking the selected resource is the same as single-clicking this button.

Page 22: Offline Configurator - Oehme-

Offline Configurator Pag. 22/24

3.8 RESOURCES SELECTION PANELThis panel simplifies the selection of the models of the resources to be entered in the different OfflineConfigurator sections.Under the toolbar there is a grid with all the possible resources, coded.The fields in the panel are:

• Type: describes the type of resource, of which there can be 4:

• Analogue

• Digital State

• Alarm

• Code: the Unique Eliwell Code that describes the resource.

• Name: the default Name that describes the resource; this depends on the set language (see Settings chapter).

• Has Index: if the checkbox is ticked, this means that the name has a resource index, i.e. a progressive number as a suffix to the name; when this resource is selected, all the resources with the same name (code) and different index are selected.

Select Filter All

Type Code Name Has Index

Digital State STA00219 First card indexDigital State STA00218 Number of analog outputs

Digital State STA00317 Device in COOL modeDigital State STA00215 Number of digital outputs

.............

.............

.............

The elements in the grid can be selected with a click; the selected resource is highlighted with a blue background.

In the toolbar there are controls for filtering the list of elements in the grid:

• Text Filter: when text is entered in the Filter, box, the list in the grid is modified (in real time), keeping all the elements that will contain the entered characters in one or more defined fields (Type, Code, Name).

The Filter can be removed by either clicking on the button or eliminating the contents of the box.

• Filter by type: in the drop down menu, one of the three types of available resources can be selected; the grid will be modified, keeping all the elements of the selected type.The Filter can be removed by selecting the All option (default).

The Text Filter and Filter by Type can be ‘mixed’ together (e.g., all alarms containing the word defrost)

The button takes you to the resource selected in the panel; double-clicking the selected resource is the same as single-clicking this button.

Page 23: Offline Configurator - Oehme-

Offline Configurator Pag. 23/24

3.9 EXPORT PANELThe Export panel is for exporting configurations that have been defined in xml files for subsequent uploading into TelevisGo.The Export panel is in a window similar to this:

Save

Con�guration 1Con�guration 2Con�guration 3

The configurations for exporting can be selected by ticking the checkboxes to the left of each element.Click on Save to open a Windows dialogue box for defining the folder where the file is to be saved.

If the items to be exported are Network naming rules, the panel is as follows:

Save

Network Naming Rules Network Naming Rules to Export

Con�guration 1Con�guration 2Con�guration 3

Con�guration 1Con�guration 3

A B

In this case the configurations to be exported are chosen by selecting the element on the left (A) and clicking on the button.

In the box on the right (B), the order in which the rules are applied can be changed with the buttons.

Page 24: Offline Configurator - Oehme-

Eliwell Controls Srl

Via dell' Industria, 15 Z. I. Paludi

32010 Pieve d' Alpago (BL) - Italy

Telephone +39 (0) 437 986 111

Facsimile +39 (0) 437 989 066

Sales:

+39 (0) 437 986 100 (Italy)

+39 (0) 437 986 200 (other countries)

[email protected]

Technical Support:

Technical helpline: +39 (0) 437 986 300

email: [email protected]

www.eliwell.com9MA10060 - Offline Configurator - 01/13 - EN

© Copyright Eliwell Controls s.r.l. 2013 - All rights reserved

4.1 RESPONSIBILITY AND RESIDUAL RISKSEliwell Controls srl declines any liability for damage due to:

• Unspecified installation/use and, in particular, in contravention of the safety requirements of established legislation or specified in this document;

• Use on equipment which does not provide adequate protection against electrocution, water and dust in the actual installation conditions;

• Use on equipment in which dangerous components can be accessed without the use of specific tools;• Tampering with and/or modification of the product;• Installation/use on equipment which does not comply with established legislation and standards.

4.2 DISCLAIMERThis document is the exclusive property of Eliwell Controls srl and may not be reproduced or circulated unless expressly authorized by Eliwell Controls srl itself. Every care has been taken in preparing this document; however, Eliwell Controls srl cannot accept liability for any damage resulting from its use.The same applies to any person or company involved in preparing and editing this document. Eliwell Controls srl reserves the right to make changes or improvements at any time without notice.

4. WARNINGS