scad a tutorial us

Copyright 2002 - 2. 22 SP 20 - Elipse Software Ltda.All rights reserved.

Supervision and Control System

ELIPSE SOFTWARE

TUTORIAL

Summary1. INTRODUCTION....................................................................................................................1-1

2. INSTALLATION .....................................................................................................................2-1

2.1. SYSTEM SET UP ....................................................................................................................2-12.2. INSTALLING ..........................................................................................................................2-12.3. UPDATING.............................................................................................................................2-12.4. ABOUT THE HARDKEY ..........................................................................................................2-22.5. HARDKEY UPDATE ................................................................................................................2-2

3. CASE STUDY...........................................................................................................................3-1

4. STARTING UP.........................................................................................................................4-1

4.1. SHORTCUT KEYS ..................................................................................................................4-24.1.1. Configurator ..................................................................................................................4-24.1.2. Runtime .........................................................................................................................4-3

4.2. COMMAND LINE OPTIONS.....................................................................................................4-3

5. TAGS.........................................................................................................................................5-1

5.1. TAGS TYPE ...........................................................................................................................5-25.1.1. Rules for Tags names ....................................................................................................5-2

5.2. CREATING TAGS ...................................................................................................................5-35.2.1. PLC ...............................................................................................................................5-35.2.2. Tag DDE .....................................................................................................................5-105.2.3. Tag Demo....................................................................................................................5-125.2.4. Tag Block ....................................................................................................................5-135.2.5. Tag Ram ......................................................................................................................5-165.2.6. Tag Matrix...................................................................................................................5-175.2.7. Tag Bit.........................................................................................................................5-195.2.8. Tag Expression ............................................................................................................5-215.2.9. Tag Chrono..................................................................................................................5-245.2.10. Tips about Tags ...........................................................................................................5-255.2.11. Alarms Page ................................................................................................................5-275.2.12. Alarms and Alarms Group...........................................................................................5-29

6. SCREEN CREATION .............................................................................................................6-1

6.1.1. Screen General Properties .............................................................................................6-26.1.2. Screen Style Properties..................................................................................................6-4

7. SCREEN OBJECT...................................................................................................................7-1

7.1. SCREEN OBJECT EDITION .....................................................................................................7-2

7.2. SCREEN OBJECT PROPERTIES ...............................................................................................7-47.2.1. Frame page ....................................................................................................................7-47.2.2. Tags Page ......................................................................................................................7-67.2.3. Size and Pos Page..........................................................................................................7-87.2.4. Object Inserting and Running........................................................................................7-97.2.5. Bitmaps Utilization........................................................................................................7-97.2.6. Drills............................................................................................................................7-12

8. SCRIPTS...................................................................................................................................8-1

8.1. GENERAL CONSIDERATIONS .................................................................................................8-18.2. APP BROWSER & X-REFERENCE...........................................................................................8-38.3. OPERATORS & CONSTANTS ..................................................................................................8-58.4. FLOW CONTROL....................................................................................................................8-7

8.4.1. ..............................................................................8-78.4.2. ....................................................................................................8-88.4.3. ..............................................................................................8-88.4.4. ..............................................................................................8-8

8.5. SPECIAL FUNCTIONS .............................................................................................................8-88.6. TIPS AND OPTIMIZATION .......................................................................................................8-98.7. DRILL .................................................................................................................................8-13

9. HISTORICAL ..........................................................................................................................9-1

9.1. HISTORICAL TYPES ...............................................................................................................9-19.2. HISTORICAL ANALYSIS .........................................................................................................9-4

9.2.1. Analysis Setting.............................................................................................................9-69.3. TIPS AND OPTIMIZATION .......................................................................................................9-89.4. DRILL .................................................................................................................................9-11

10. REPORTS............................................................................................................................10-1

10.1. DRILLS ............................................................................................................................10-1

11. RECIPES .............................................................................................................................11-1

11.1.1. Recipe General Properties ...........................................................................................11-111.1.2. Editing Recipes............................................................................................................11-3

12. PASSWORDS......................................................................................................................12-1

13. DATABASES.......................................................................................................................13-1

14. REMOTE APPLICATION................................................................................................14-1

15. OTIMIZATION ..................................................................................................................15-1

16. EXHIBITS ...........................................................................................................................16-1

16.1. DRIVER KLOCKNER MOELLER.........................................................................................16-1

16.2. DRIVER SIEMENS 3964R .................................................................................................16-4

elcome to the training. This manual introduces the Elipse Scada trainingmodule and it aims to aid the learning of the contents given during trainingclasses. For a better learning, we suggest that you read this manual carefully,make your own notes during the class, ask the trainer as much as you can to

solve any questions, and pratice what you learned. We appreciate your interest and wishyou success with your new tool.

Welcome

W

Check the following list for syntaxis and some conventions used in this manual.

Example Description

SILO6.BMP Capital letters indicate file names and other termsin the operational system level.

General Bold characters indicate field names that must besearched on the screen, in menus or in the objectfilling cards.

Characters in quotation marks must be typed inthe indicated field without the quotation marks.

Screen1.Show() Italic expressions are program parts (scripts) thatmust be typed in the reserved spaces, and thencompiled to verify errors.

<Object_Name>.enabled Expression between the < > sign must bereplaced by the referred object name (Screenobjects or Tags) while editing a script.

their properties.

Click in firld A The directions with markers in the beginning ofthe sentence are part of a procedure or task.

CTRL+ENTER Small capital letters are used to identify keynames in the keyboard. When they are followedby a (+) signal, you must hold the first key downwhile pressing the other.

Conventions

I N T R O D U Ç Ã O

Elipse Software 1-1 Elipse Scada

He Elipse Scada is a software for the creation of process supervision andcontrol applications for several areas. It can be completely configured by theuser which allows the monitoring process variables in real time throughgraphs and objects that are related to field physical variables. Furthermore, the

user will be able to operate and send or receive information to the data acquisitionequipment.

It is also possible to make calculations using the programming language, to createhistorical databases, reports, recipes, and even to supervises and control remotely aprocess.

The software is avilable in four modules: View, MMI (Man Machine Interface),Professional and Power.

All the forementioned modules have Configurator, Runtime, and Master versions.

The Configurator is dedicated to the process supervision applications development. Inorder to conductor tests, the Configurator can run applications up to ten minutes.

The Runtime is used to run process supervision applications after they have beendeveloped making use of the Configurator.

The Master embodies in the same tool one Configurator module and one Runtimemodule, which allow the set up and running in one sole product.

In the absence of a protection device (hardkey), the software can be run in demo mode.The Demo is used to asses the software and it has all the existing resources as in theConfigurator. However, it works with a maximum f 20 Tags, allowing thecommunication with the data acquisition equipment up to 10 minutes, with thecondition that there is the respective communication driver. It does not use a hardkeyand can be freely reproduced.

Capítulo

1. Introduction

T

I N T R O D U Ç Ã O


In order to know which version we are using, at any time, even in runtime mode, wejust have to press the combination: CTRL + SHIFT + V.

See the following for an abstract of the functional feactures of each version:

PRODUCT TAGS ENVIRONMENT MAIN FUNCTIONS

ELIPSE VIEW Unlimited 300or 75

Windows95/98/2000Me/NT/XP

MonitoringDriverSupports DDE

ELIPSE MMI Unlimited 300or 75


Elipse View plus:Historical analysisAlarmsRecipesReportsSPC (CEP)

ELIPSE PRO Unlimited 300or 75


Elipse MMI plus:Support to ODBCNetwork Support

ELIPSE POWER Unlimited Windows95/98/2000Me/NT/XP

Elipse PRO plus:Support toOscilographies, SOE(Sequence of Events),COS (Change of Statesof DNP 3.0/IEC-870-5protocols)

Further, as additional modules, there are two tools that can work together with any ofthe above mentioned products, which are the Elipse Watcher and the Elipse Web.

The Elipse Watcher - ng, registry and digitaltransmission in real time, making it possible the visualization of images withprogrammable definitions and size by the user, besides allowing an image databasescreation with search for period or event, and image transmission in real time to remotestations via local network or dialed line.

On the order hand, the Elipse Web is a supervision application server to Internet,where by means of a navigatior such as the Netscape or the Internet Explorer it ispossible to get connected with a station and send/receive data in real time.

I N S T A L A Ç Ã O


2.1.System Set up

See the following for the minimum requirement for the machine (PC):

Pentium 100 MHz or superior

Memory 16 MB (32 MB recommended)

SVGA Monitor(800 x 600, 256 colors or superior)

Microsoft Windows 95 / 98 / Millenium/ XP or NT

1 parallel port.

2.2.Installing

1 Insert the Hardkey in your computer parallel port, if there is already a printer inthis port place the hardkey first and then connect the printer in the same port.

2 Introduce the floppy disk or CD-ROM in the respective drive, and through theStart button choose the Run option.

3 In the unit that you are using, choose the INSTALL.EXE command, and followthe instructions that are displayed on the screen.

2.3.Updating

Periodically, Elipse launches new software Releases that contain new tolls and/orupdates for the already existing ones. Such updates can be obtained through commonmedia (Floppy disk or CD-ROM) or through our site: www.elipse.com.br. In the case

Chapter

2. Installation



of updating, only the files that change with each release are available in Internet whichturns the updated version smaller than the installed one.

2.4.About the Hardkey

Some older keys have some compatibility difficulties with HP (Hewlett-Packard)®-

correction of such problem there are two procedures:

a) Run through the Running command of your Windows or one of the MS_DOSsections the hinstall.exe program that is copied during the installation process to thesame directory in which the software was installed) that is responsible for the hardkeyinstallation according to the syntax below, selecting the Bi-directional option.

HINSTALL.EXE [options]

Options:

/i Installs the hardkey driver (HASP)

/iu update

/r remove

/portmode=<type>

tipo: Normal normal port mode

ECP Enchanced Control Port modo

BiDi Bidirecional mode

Auto automatic mode

b)To run a printer set up utility in the c:\Windows directory or your machineequivalent, disabling the Bi-directional communication option..

2.5.Hardkey update

In the case you need an eventual version change (e.g. MMI to PRO) or even theincrease in the number of tags in one application, the safety key will be able to beremotely programmed. For that purpose, besides the usual commercial procedures, theuser will be able to follow the next steps, so that the update is performed as fast aspossible:



Put the key in the parallel port.Run CUSTOMER.EXE, program that is copied in the same installationdirectory, and select Get ID option.Select Save option, providing a name to the file with any extension (sugestion :.TXT).Send the file via e-mail to Elipse Software®.

When you receive a new file, run again the CUSTOMER.EXE program.

Run Config option..Provide the received file name, and the key will be programmed.

C A S E S T U D Y


n our training example, we will create an application as shown below.

The mentioned System shows a candy plant sunoptic. For the production, it isnecessary four basic products: water, syrup, glucose and sugar, whose qualities

are controller for each new type of candy to be produced through the use of recipesthat are programmed by the operator. After the individual weighing of each products,they are homogenized in the mixer which in turn transfers the moisture to a storagetank. This transference between tanks can be automatic or controlled by a valve drive.

From the storage tank, the moisture is transferred to the cookers through pumping thatit also controlled by the application. The system operator can visualize each tanktemperature in the same screen, control the engines frequency and open or close valvesthat drive the moisture to the cookers.

The system will also show alarm status, in the case the parameters exceed theestablished limits. (e.g. excessive temperature increase), besides creating temperaturetrend graphics, generate operating database and its respective reports.

Throughout the register screen, it is possible to create new products and edit the alreadyexisting ones. There is also a Query procedure for batch processes that allow historicaldata Query, visualization and printing.

Chapter

3. Case Study

I

C A S E S T U D Y


1 Dosage Screen

2 Register Screen

3 Printing Screen

C A S E S T U D Y


4 Opening Screen

5 Historical Alarms Visualizing Screen

C A S E S T U D Y


6 Bath Screen

C A S E S T U D Y


7 Trend Screen

I N I C I A N D O


O start up the Elipse Scada:

Click the Start button in the Windows task bar;

Select Programs, after the Elipse Windows 32 and Windows 32 group.

Elipse Scada Initial Screen:

Chapter

4. Starting Up

T

Menu bar

Toolbar

Work area

I N I C I A N D O


4.1.Shortcut Keys

4.1.1.Configurator

A L W A Y S A V A I L A B L E

KEYS ACTION

Ctrl + O File / Open the Application

Shift + Ctrl + V Help / About Elipse Windows

F1 Help

Shift + F1 Context Help

O N L Y W I T H A N O P E N A P P L I C A T I O N

KEYS ACTION

Ctrl + S File / Open the Application

F10 File / Run the Application

Alt + O File / Organizer

Ctrl + N Screen / New

F8 Screen / Monitoring

Shift + Ctrl + Alt + I Counts the items number in the application

O N L Y I N T H E S C R E E N E D I T I O N

KEYS ACTION

Ctrl + F4 Screen / Close

ESC Objects / Deselect

Ctrl + A Objects / Select All

Ctrl + X Objects / Cut

Shift + Del Objects / Cut

Ctrl + C Objects / Copy

Ctrl + Ins Objects / Copy

Ctrl + V Objects / Paste

Shift + Ins Objects / Paste

Del Objects / Delete

I N I C I A N D O


O N L Y I N T H E F O R M A L R E P O R T E D I T I O N

KEYS ACTION

Ctrl + F4 Close the Report Editing

ESC Objects / Deselect

Ctrl + A Objects / Select All

Del Objects / Delete

4.1.2.Runtime

KEY ACTION

Shift + Ctrl + V Help / About Elipse Windows

Shift + Ctrl + Alt + I Counts the items number in the application

4.2.Command Line Options

The executable file ELIPSE32.EXE accepts the following command line:

ELIPSE32.EXE [-DEMO] [-SETUP] [-EDIT] [appName]

Where:

OPTIONS ACTIONS

-DEMO (optional) is used to run the Elipse as a demo, without verifying the protectionmechanism (hardkey). This option rewrites the .INI file set in the[Protection]Type=

-SETUP (optional) instructs the Elipse to run the Setup program that allows you to setthe options in the Elipse.INI file. It shows the same dialog box as the menu File

-EDIT (optional) instructs the Elipse to run the Configurator. If an application name isinformed in the appName of the command line, this application will be open forSet up.

appName (optional) an application name that will automatically run (in the Runtime or inthe Master module) or it will be open by the set up (in the Configurator moduleor while the EDIT is specified in the master or Demo modules). It is highly

I N I C I A N D O


Note

If you have a Runtime module and the appName parameters is omitted,

(Dialog box File/Open).

Note

When you specify a command line application, the work drive anddirectory are set to the same as the application.

The creation of an Application is the start point to assemble a process supervisionsystem using the Elipse Scada. In the Application, the user will be a:

Application File: .APP

Password File: APX

Application Backup: BAK

Database: .DAT , HDR (Cabeçalhos)

Recipe File: RCP

Communication Drivers: DLL

Arquivos de imagens (BMP, JPG, GIF, etc)

Drill:

Task: To create a new Application.

Click the button New application.

Save application as Example.App, operation that is automatically requested.

I N I C I A N D O


In order to allow a simple and organized view of the entire application, the Elipse

Organizer command in the File menu or pressing the button in the toolbar.

The organizer structure can be compared to a directory tree of the Windows Explorer.In this way, the application structure starts in the upper left corner with the

uped according to

List and Remote Applications. Selecting any of the tree legs of the application will makeit expand showing its content so you will be able to navigate through the applicationhaving all the set up options available for any object.

Starting from the Organizer, you can create all your application only but navigatingthrough the application tree. Selecting any of this legs, the selected object properties willbe editing. For instance, if you select Tags in the Organizer tree, new Tags can becreated, and its properties can be edited selecting the page you wish from the tabs in thetop of the window.

The Organizer Toolbar buttons allow you to quickly perform certain tasks withoutusing the menus. There are 13 buttons as you may see in the following table:

I N I C I A N D O


BUTTON NAME ACTION

Delete It deletes all the selected items in the Organizer.

Duplicate It duplicates the selected item of the Organizer tree.(shortcut = CTRL + RightClick)

App Browser It opens the App Browser, a window that contains theapplication tree and all the objects functions and attributes.

CrossReference

It shows the object cross-references in the App Browser,that is, in which places or other objects the current objecthas a reference.

Compile It compiles the Script that is being used.

Build It compiles all the Scripts that are not compiled.

Rebuild All It recompiles all the Application Scripts allowing the user toaccess each Script with a double click. It generates a list ofthe compiled Scripts showing in red the ones with errors.

If It inserts an If command in the selected Script in the placewhere the cursor is.

Else...If It inserts an Else...If command in the selected Script in theplace where the cursor is.

Else It inserts an Else command in the selected Script in theplace where the cursor is.

For...Next It inserts a For...Next command in the selected Script in theplace where the cursor is.

While...Wendthe place where the cursor is.

Repeat...Until It inserts a Repeat...Until command in the selected Script inthe place where the cursor is.

When you select the Application root in the tree, its properties will be displayed in theright hand side. Here the generic parameters about the application will be set, as well asits behavior in relation to other programs and operational system itself. The variablesthat can be set up here are:

FIELDS DESCRIPTION

Description It defines the application title (that will appear in the title bar) if theTitle Bar option is enabled.

Title bar It shows the Title Bar in the application window.

I N I C I A N D O


Disable task-switching It disables the exchange among the windows programs, thatmeans, once it is in the Elipse Scada it will no be allowed to go toother applications unless ending the section. (Disables the Alt-taboption).

Disable Screen-Saver It disables any screen saver while running Elipse Scada.

Close Button It enables the Close button and the System Menu.

Minimize Button It enables the minimize button.

Maximize Button It enables the maximize button.

Allow Close Whenever it is Off, it makes the Runtime to complete only whenthe function StopRunning() is selected. When it is On it allows toturn off the Elipse by other means such as a mouse click in theclose button, in the Windows shutdown, and so on.

It opens a window that shows the Elipse version that last recordedthe application, the total time of the application edition, thenumber of the

It opens a window that allow to find items (object, properties)anywhere in the application and to present it for edition.

It opens a window that allows choosing an application for import.After choosing the source application a new window will be openwith a two application tree, so that the user may be able to dragobjects from the origin application to the destination application.

It opens a window for Application protection. There are twoprotections: for set up (Open/Modify/Save) and for Run. In thecase of using a password for the set up the final user will not beable to change the application, unless he knows that the Runtimewill have a password just if there the Set up has one.

StartMaximixed/Minimized/Normal

It defines the setting of initial sizes of the application.

Use Runtime Keypad It enables the keyboard use in the screen through the mouse orTouch Screen.

PointerIt disables the display of the mouse pointer.

Use large buttons Enables the use of large buttons in the screen objects andkeypad.

Drill:

Task: To degine the new application style.

Description property.

I N I C I A N D O


In the Style properties choose Title bar and in the tab Window chooseInitialize Maximized.

T A G S


Process supervision with the Elipse Scada takes place through processvariable readings in the field. The values of these variables will be stored intags.

At least one Tag or Attribute must be associate for each animation object inserted inthe screen. Tags are all the variables (numerical or alphanumeric) involved in oneapplication. It can be of several types, according to purpose of use. Attributes are datafurnished by the Elipse Scada about system parameters and Application components.

For instance, we can consider a tag as furnace temperature, and one of its attributes isthe alarm level from which the siren will be activated.

Tag values or associate Attribute value can be displayed by the animation objects in the

actions, and so on.

In creating Tags, the user will be able to organizer them in Groups as he may wish, soto make it easier the search and identification during the set up process. To creategroups, just select the Tags item in the Organizer and click in New Group. You cancreate groups within other groups, and if you wish to change their position, (e.g. toinclude it in other group) just drag it to another position and the whole content will alsobe moved.

See the following list for the existing type of Tags:

Chapter

5. Tags

A

T A G S


5.1.Tags Type

TYPES DESCRIPTION

PLC It is used to exchange information with the data acquisitionequipment (writing and reading) through communication drivers.The requested parameters are obtained through the help file thatcome along with each communication driver.

DDE (Dynamic Data Exchange) Tag for data exchange with otherapplications. It represents one manner of exchanging databetween applications (e.g. Excel, Acces, Word, etc), or further

manufacturer.

Demo Tag for values simulation. It allows to create defined curves orrandom values from the selection in the buttons that are displayedin the window.

Expression Tag that allows the input of a numerical or alphanumericalexpression (it allows a sum between strings).

Block Similar to the PLCType Tag, however it allows the reading ofseveral simultaneous data. In some cases the use of Block typetags enhances the communication.

RAM Tag of internal use to store values in the memory. Tags of RAMtype are volatile that means, they store values while theapplication is open.

Matrix These are RAM tags set in order to allow vector and matrixaccess.

Counter It allows the creation of counters and timers.

5.1.1.Rules for Tags names

In order to specify tags names some details must be followed:

The variable name cannot contain reserved characters such as: logic and arithmeticoperators, ? , . , - , + , * , etc.

The variable name cannot contain space: This is also valid to the other propertiesthat are not tags, if you wish to use them in scripts (programming language), sincethe compiler will take them as distinct variables.

The tag name cannot be strictly numeric.

The following examples inform the tags creation procedures. If you have an equipmentand wish to perform communications, choose the creation of variables type PLC or

T A G S


Block; otherwise, choose the Demo type, that will allow the simulation of values in theabsence of real data.

5.2.Creating Tags

To create new Tags, just select Tags item (for creating a root) or a specify group (forcreating a group) and click in New Tag, where the following help box will bedisplayed:

In whick name (following the mentioned rules), quantity (in case you create more thanautomatic numbering at the end of the names will be created) and type shall beinformed.

5.2.1. PLC

Tags PLC type are generally used when you wish that a tag access communicationdriver reads/writes a value or a set of values to a single variable. Therefore, it canrepresent any type of variable independently as an input or an output, digital oranalogical, depending on the set up and address required by the communication driver.

T A G S


Each tag PLC or Block must be associated to a communication driver, which will beresponsible for the communication with the specific equipment. You must set up thecommunication driver at least once when a new application takes place.

5.2.1.1.Communication driver

The Elipse Scada drivers are separate files with DDL extension that can be placed inand directory to be defined by user.

To set up a new driver, just click in the Drivers item from the Organizer then in theNew button loading the correspondent DDL file.

By choosing the Set up option it is possible to specify the general data aboutcommunication, as serial port, communication rate, and so on, according to thesupplied documentation to each communication driver. To assist the set up task, youmust access the Driver Help option where the driver set up parameters is displayed.

FIELD DESCRIPTION

Driver Location It shows the path where the DDL file is.

Parameters It allows the communication general parameters set up, such asserial port, communication rate, according to the supplieddocumentation and help.

Abort on Error This option displays a dialog box requesting the annulment of thecommunication with the driver, in case of communication error.This option must be used only in the set up, since its running can

the communication will be suspended.

Hide mouse duringcommunication verify interruption conflict in the serial port (generally not used)

number in case for error (generally disabled).

Retry failedcommunications/Number of Retries

Extra try number in case of communication error. Use thisproperty with caution, because if the equipment presentscontinuous communication errors a general review of allcommunication will be necessary- otherwise it will cause delay onthe general answer of the software.

Consult at the end of this manual the exhibits related to some help examples ofcommunication driver.

Through the Advanced button you will have access to more detailed set u about thedriver operation.

T A G S


FIELD DESCRIPTION

Maintain 16-bit driverbehavior

When enabled, it is the normal operation mode of the 16 bitsversions. If disabled, it operates the hybrid multitask mode that is32 bits version pattern. This operation mode of the 32 bits driversplaces all the communication task in a separate process, inasynchronous way compared to the Elipse Scada normaloperation, speeding up the application process. This method is

obtain a variable value, such as a script (program), where thefollowing step dependes on the tag value update, when theprocess of information exchange between the communicationdriver and the main program becomes synchronous.

Use background writing It also allows the writing perform in parallel process, however itallows placing the write requirement to the driver with the samepriority of others requirements (low priority) or in the top of therequirement list (high priority).

Start driver at applicationstartup

This option allows that on starting an application thecommunication driver be ready to exchange information, or inanother works, it automatically runs its function via some script, inorder to allow the communication.

Keep driver in memory When in set up, this option allows that the elipse Scada does notunload the memory driver every time it returns to the developmentenviromment.

Through the extra Button, available in some drivers, you will have access to specialparameters of the set up, such as modems use and Debug or trace file creation ofcommunication Consult the driver documentation to learn more about theseparameters.

T A G S


Drill:

Task: To set a communication driver to be used.

Load the communication driver and with the help file assistance, fulfill the p1to p4 parameters enabling the in Abort in Error option, and disabling the

option and to not use retries.

T A G S


The following screen is displayed when a tag PLC type is created, presenting thefollowing parameters:

FIELD DESCRIPTION

Name Tag name. You can use as many characters as you wish, butspecial spaces and characters are not allowed when Tags areused in the Scripts.

Change type to It allows the Tag type to be changed.

It allows to separate the Tag in bits, creating Tags Bit to each bitor tag bits set.

Description A brief description about the tag.

Driver It allows selectig a communication driver to the current Tag.Drivers must be installed through the Drivers windows in orderto make them available.

Driver Help It shows the Help of the selected Driver.

T A G S


Tagaccording to the selected driver. This set up is contaned in the

button. Values can be expressed in decimal [-32768, 65535],octal [0o, 177777o] or hexadecimal [0000h, FFFFh].

Scan It defines when the tag values will be updated (mSeg).

Scaling By selecting this option, the Tag values will be converted on anew scale of values determined by the user as the defined limitsin PLC Low, System Low, PLC High and System High.

PLC low It defines the minimum PLC (CLP) value to be read.

System Low It defines the new minimum value to be read in the PLC (CLP).

PLC High It defines the maximum value to be read value conversion.

System High It defines the new maximum value to read value conversion.

Test Connection Here Its tests the communication with the PLC in reading and writingsome values.

Enable Scan reading If this option is enabled, this tag will be read in the specified ratein the Scan field in milliseconds, whenever there is any item inthe application that is being used by the tag (Screen, Historical,Alarms, and so on).

Enable automatic reading It enables automatic reading. It enables the tag to be read incase its value become necessary, and the last reading madeis old (bigger than the scan time).

Enable automatic writing In case of value attribution, whichever through scripts or screenobjects (setpoint, slider) to a tag clp or block element, itspecifies whether the driver will automatically send the newvalue to the equipment.

Drill:

Task: To create tag PLC type to represent a digital input.

Select Tags object in the Organizer, click in New Tag button;

Key in DI in the property Tag name;

Key in 1 in the How many field;

Choose the Tag PLC type, and then click in the OK button.

Select General page. In this page, associate the communication driver, that isalready set, through the driver list box. Specify the parameters from n1 to n4according to the Help file, or through the appendage found in the end of this

T A G S


manual. In the Test Connection Here section, there is the possibility ofreading/writing values directly in the variable addressed in the equipment.

If the read variable is a word whose bits are relevant digital information we canseparate them. Clicking in Acess Bits will open a window to specify whichbits will be expanded. The bits use can be made as if abdnormal tag, being only

equipment. Such characteristics will be seen ahead with more details in section5.2.8.

Task: To create a tag PLC type to represent a digital output.

Select Tags object in the Organizer, click in the New Tag button:

Key in DO in the property Tag name;


Choose Tag PLC type and then click in the OK button.

Task: To create a new group of tags, with three tags of tank level of the PLC type.

Select the Tags object in the Organizer, click in the New Group button:

Key in Levels in the property Name

Select Levels group by clicking in New tag;

Key in Tank01 in the Name field;


Choose the tag PLC type, and then click in the OK button.

3 tags of the PLC type will be created with part of the name alike, but withdifferent numerical index (in crescent order) once there are not two tags withthe same name.

If the equipment values that are being read are kept in a different scale formfrom that used in your system, you can specify a conversion on the tag,stipulating the inferior and superior levels in the System. By using the variablein any part of the software (except in the Organizer in the Test ConnectionHere function, where the values without conversion are shown), its scales willbe automatically calculated in each reading or writing.

T A G S


5.2.2.Tag DDE

Tag DDE is used to exchange data between the Elipse Scada and other application(Excel, Access, Word, etc.) using DDE (Dynamic Data Exchange).

In a Windows network, Elipse Scada uses NET DDE and becomes able to exchangedata with other Elipse Scada, among other ways, through Tag DDE. For that purpose,you need to specify the computer name, the server application, the topic and the item,as you can see in the following box:

FIELDS DESCRIPTION

Name Tag name. You can use as many characters as you wish, but specialspaces and characters are not allowed when the tags are used in theScripts.

Change It allows changing the tag type.

T A G S


Description It is a brief description about the tag.

Computer It defines the computer name where the server application DDE comesacross. The default computer is the current computer, but if there is aWindows network other computer is the current, but if there is aWindows network other computers will be available to exchange datausing the NET DDE.

Server Name It defines the DDE server name that can be used on a Windowsapplication (e.g. Excel, Word, etc) or a DDE driver furnished by yourequipment manufacturer. The is of available programs to DDE serveris displayed when the arrow near this box is pressed.

Topic It defines the DDE Server Topic, depending on the Server type. It canbe a document (e.g. an Excel table). The available Topic list isdisplayed when the arrow near this box is pressed.

Item It defines the DDE Server Item, depending on the Server type. It canbe a document item (e.g. a cell of an Excel table).

Test Connection It allows that you test the DDE set up. A message can indicate aconnection error or a received value by the set item.

Scalling By selecting this option, the Tag values will be converted into a newvalue scale established by the user according to the defined limits inthe Server Low, System Low, Server High and System High.

Server Low It defines the minimum value to be read by the Server.

System Low It defines a new minimum value to read conversion values.

Server High It defines the maximum value to be read by the Server.

System High It defines a new maximum value to read conversion values.

Drill:

Task: To create a link between an Excel cell and a Tag DDE type.

Select the Tags object in the Organizer, and click in the New Tag button:

Key in Spreadsheet in the property Tag name;


Choose the Tag DDE type, and then click in the OK button.

Open the Microsoft Excel, and key in any value in the first cell on a newspreadsheet.

In the Spreadsheet tag, choose Server Name: Excel, Topic: Sheet1, Item:R1C1 or L1C1 (depending on the excel, if in English or in Portuguese);

Click in Test Connection and key in value in the cell will be displayed.

T A G S


5.2.3.Tag Demo

The Tag Demo is used to the value simulation. It allows you create defined curves orrandom values according to the curve type selected in the six buttons of the Generalpage of the Tag Demo (see picture below).

FIELD DESCRIPTION

Name Tag name. You can use as many characters as you wish butspecial space and characters are not allowed when the Tags areused in the Scripts.

Change type to It allows changing the Tag type.

It allows separate Tags in bits, creating Tag Bits for each Tag bitor bit set.

Description It is a brief description about Tag.

Type It defines the curve type to be used by the current tag Demo.

Low Limit It defines a minimum value to the Tag Demo.

T A G S


High Limit It defines a maximum value to the Tag Demo.

Increment It defines the increment to the Tag Demo when a saw tooth curveis selected.

Delay It defines the period number between each value creating to theTag Demo. For instance, if it is 1, a value is created in eachperiod, if it is 2, it create a value in each two periods, and so on.

It is used together with the period attribute to control the timerange to data variation.

Period It defines the msec number between the creation of each newvalue to the Tag Demo. It is used together with the delay attributeto control the time range to data variation.

Enabled It defines the initial status of the Tag Demo. Enabled or Disabled.The Tag Demo values are created only when this option isselected, otherwise, the tag Demo value will remain the same.

Task: To create a Tag Demo type to the mixer animation in the Funnel.

Select the Tags object in the Organizer, and choose New Tag. In the nameproperty key in Mix, and accept it with the OK button.

In the Mix tag properties, choose the triagonal wave option, with inferior 0and superior 9 limits.

5.2.4.Tag Block

The Tags Block have the same purpose as the PLC tags, that means, they exchangeinformation with the data acquisition equipment through the communication driverssupplied by Elipse Software.

Its goal, however, is to allow that several tags have its values read or writtensimultaneously, increasing the phisical environment and decreasing the scanningmedium time of the variables. In general, each block must be associated to acommunication driver. It has a scan time that is the same for all its variable.

If you have an application with too many PLC tags, and want to change them intoblock element tags, you can use the Change type option where the destiny block mustbe chosen (if changing block). From that on the tag will be changed into a blockelement, including the change in all its internal references (use of screen, expressions,scripts and other objects).

T A G S


FIELDS DESCRIPTION

Name Tag name. You can use as many characters as you wish, butspecial spaces and characters are not allowed when the tagsare used in the Scripts.

Change type to It allows changing the tag type.


Driver It allows the selection of a communication driver to the currentTag. The drivers must be installed through the Drivers window inorder to make them available.

Driver Help Is shows the help of the selected Driver.

Tag according to the selected Driver.

ScanTag according to the selected driver. This set up is contained in

-32768,65535], octal [0o, 177777o] or hexadecimal [OOOOh,FFFFh].

T A G S


Change Size It defines when the tag values will be updated (mSeg).

Add Element It changes the block size to be monitored by the Elipse Scada.

Enable scan reading It allows you to add a new element in the selected Tag.

Enable automatic reading It enables automatic reading in block.

Enable automatic writing It enables automatic writing to the block.

B L O C K E L E M E N T S

Each Tag Block element has properties that can be accessed by selecting the elementyou seek in the application tree of the Organizer. The following page will be thendisplayed in the right side of the window.

The same regards made to the PLC tags is valid to block elements, namely:

Use of scales in the elements;

Writing and reading in the elements;

Changing into bits;

Alarms use.

T A G S


FIELD DESCRIPTION

Name Tag name. You can as many characters as you wish, but specialspace and characters are not allowed when the tags are used in theScripts.


It allows separating the tags in bits, creating Tags Bit for each bit orbit set of the Tag.

Block Index It allows changing the element order in the block by keing in thedesired index.

Scaling By selecting this option, the tag values will be converted into a newvalue scale estabilized by the user according to the defined limits inPLC Low, System Low, PLC High and System High.

PLC Low It defines the minimum value to be read in the PLC (CLP).

System Low It defines the new minimum value to the conversion of the readvalues.

PLC High It defines the maximum value to be read in the PLC (CLP).

System High It defines the new maximum value to the conversion of the readvalues.

Test Connection Here It tests the communication with the PLC reading and writing somevalues.

Drill:

Task: To create a communication box with 3 elements.

Procedure: Follow the same procedures as for the tag creation, choosing now in thename property block1, in the how many field 1 and the type block. After you click inOK, it will be asked the block elements number where you must key in 3. Select now

Automatically the other blocks elements will have the following namesTemperature02 and Temperature03.

5.2.5.Tag Ram

Tags Ram are internally used to store values in the memory. This Tags type is volatile,therefore it keeps its values only when the application is running.

There are two ways in order to establish an initial value to the RAM:

T A G S


a) Place the initial value (fix) in the Initial Value field.

b) Store the desired value in one recipe (whose values are changeable), and load itin the application starting, which makes the tags present in the recipe do notbe volatile. More details can be seen in chapter 11, Recipes.

Drill:

Task: To create RAM variables to the register and storage of the raw materialquantities. It is not necessary to specify an initial value.

Procedure: To create a new tags group called Products. To create from this group thefollowing tags RAM: Water, Sugar, Syrup, Glucose, number_recipe and Code (thatwill receive the products code).

5.2.6.Tag Matrix

Tag Matrix allows to create data matrixes or vectors that can be used in calculations,storage, and others. It is possible to map each cell of a matrix as if were a tag, and thenassociate each one of them to a tag or property. In this case, once the cell valuechanges, the tag/property associated takes over a new value and vice versa.

Keep in mind that the operation about matrixes always have row and column startingwith index 1.

T A G S


FIELD DESCRIPTION

Name Tag name. You can use as many characters as you wish, butspecial spaces or characters are allowed when Tags are used inthe Scripts.


Columns It defines the matrix column number.

Rows It defines the matrix row number.

Map It maps all or some of the matrix cells to a tag.

M A P P I N G C E L L S T O T A G S

You can map a matrix or vector cell to a Tag by pressing the Map... button in the TagMatrix General page, and by specifying which are the cells that you wish to map.

Each mapped cell is displayed below the Tag Matrix in the application tree in theOrganizer. When selecting a specific cell, its properties are displayed in the right side ofthe tree. Each mapped cell has 4 property pages: General, Alarms, Scripts and Tags.The 3 first pages are the same of any tag, and the tags page allows to associate a Tag or

T A G S


property to the matrix cell likewise the tags and properties are associated to ScreenObjects (see 7.2.2 section).

5.2.7.Tag Bit

Tag Bit can only be created starting form another tag, and it allows to individuallyaccess each bit of it. Those Tags that allow the separation in bits are: PLC, Demo,Expression, Block Elements, Ram or Remote.

This resource is very useful when a read value of an equipment, such as a byte or word,actually represents 8 or 16 (or more) independent digital status (on or off).

The bit value is obtained through the masking of the bit position with the tag to whichit belongs. On the other hand, the writing is made in two ways: masking and writing thewhole or written word of the individual bit, if the equipment supports such commandthat is implemented in a transparent way to the user in the communication driver.

You can create a Tag Bit from the General page of any of the above mentioned tags.Clicking the button the following windows will be displayed, where youwill be able to select the bits that you wish to be mapped. The bit selection is madeusing the mouse and the SHIFT or CTRL keys, in the same way the items are selectedin a windows list box.

The tag bit can be whether a single bit or a bit set, once they are continuous. Thatmeans that you can map one single Tag Bit, for instance, the 0,1, and 2 bits, but not the10,11 and 24 bits. A check box existing in this window allows to specify if a Tag to eachselected bit must be created or if the continuos bits that are selected must be gatheredin one single Tag. In the next example, 5 tags Bit are created as follows:

TAG BITS

T A G S


BitField1 0, 1, 2

BitField2 5

BitField3 8

bitField4 12

bitField5 20, 21, 22

The tag Bit created are displayed below its respective Tag in the application tree in theOrganizer. When selecting a specific tag Bit, its properties will be displayed in the rightside of the tree.

The Tag Bit General Properties page is displayed when the General tab is selected inthe top of the Tag Bit pages. This page is shown below. Its respective fields aredescribed in the following table.

FIELDS DESCRIPTION

Name Tag name. You can use as many characters as you wish, butspecial spaces and characters are not allowed when the Tags areused in the Scripts.

Description It is a brief description about the Tag.

T A G S


High Word bits andLow Word bits

It defines which bits or bit is part of that Tag.

Drill:

Task: To separate in bits the already created Di and DO tags.

Procedure: Select through the Organizer the DI tag and then the Access Bits. Choosethe bits from 0 to 7, specifying the option Create a tag for each bit. Bits, representing 8digital inputs will be created as the tag DI dure as to tagDO.

5.2.8.Tag Expression

Tag Expression allows you to attribute a numerical or alphanumerical expression to aTag. You can create equations involving any variables, whether numerical,alphanumerical, tags or attributes.

When you key in the expression, which will be the operation performed by the tag, inthe errors field those errors found in the edition up to that moment will automaticallybe displayed.

The same functions, operators and constants used in the Scripts (programmingmodule) can be used in the tags expression (see chapter 9 Scripts).

To use them when editing an expression, just click in the App Browser option (thrirdicon in the Organizer toolbar), where a window will be displayed that makes it possibleto copy all the function / attributes available in the application to the editing line.

T A G S


FIELD DESCRIPTION

Name Tag name. You can use as many characters as you wish, but specialspace and characters are not allowed when the tags are used in theScripts.

Change type to It allows changing the Tag type.

It allows to separate tag in bits, creating Tags Bits for each Tag bit or bitset.

Description It is a brief description about the Tag.

Expression It allows the input of any valid expression to the tag.

Errors It lists syntax errors found in the expression. The error are displayedduring the expression edition, and to make a valid expression the

The same functions, operators and constants used in the Scripts can be used in the tagExpression (see Chapter Scripts, Constants & Operators):

CONSTANTS EXAMPLEInteger (decimal, bin, octal, hex) 1234, 1234d, -1234, 10011b, 733o,

0A100h

T A G S


Real numbers 100011bStrings

OPERATORS EXAMPLE+ (Sum, strings concatenation)- subtração, * multiplicação, / divisão, %resto, ** exponenciação

tag001-screen1.x, tag001/tag002, tag002** 2

LOGICAL OPERATORS EXAMPLE&,|,^,~,<<,>> (bit a bit) flags & 0001hAND,OR,XOR,NOT (lógico) tag001 AND (tag002<20)

LOGICAL OPERATORS EXAMPLE== (comparison), >,<,>=,<=,<> tag001==20

ATTRIBUTING OPERATORS EXAMPLEtag001 = 20tag001 += 20, tag001 *=20 tag001 = tag001 + 20,

tag001 = tag001*20

Drill:

Task: To create a tag expression that will be the combination of two digital tags calledStatus. This tag will show a useful example when you wish to show in the screen an

case, it is necessary to creat a tag expression.

Procedure: Follow the same procedures as to the Tags creation, choosing now theexpression type. In the Name expression field.At this moment there are two paths: You can directly key in the desired text, or use theApp Browser tool to navigate through the application, allowing to copy the desiredfunction, attribute or object directly to the edition place.

In the first case:

Key in in the expressionfield.

In which the final result will be a value from 0 to 3 as the followingpossibilities:

FieldBit1 FieldBit2 FieldBit3 Status

0 0 0 0

0 0 1 1

T A G S


0 1 0 2

0 1 1 3

1 0 0 4

1 0 1 5

1 1 0 6

1 1 1 7

In the second case:

Acess the app Browser button, and click in Tags, selecting the tag DI.

Click twice in it, and search for the FieldBit1 item. After selected, click inCopy to the Script, where the desired item will be transferred to theExpression in the tag Status.

lete the first part of theexpression.

Repeat the procedure to the other field Bit.

5.2.9.Tag Chrono

Tag Chronometer allows performing basic operation to time counting (increasing anddecreasing) and timing, allowing execute tasks when a certain value is obtained.

T A G S


5.2.10.Tips about Tags

IMPORTING TAGS FROM OTHER APPLICATIONS

In order to allow the good use of the work done in the other application or even toallow more than one person to work in the same application, you can import parts ofother applications. Use the Import tool in the Application item in the Organizer tocarry on such task.

I will be asked the source application path that contains the desired objects to becopied. After specifying its place, the following window will display:

T A G S


MAKING COPIES OR MOVING TAGS OR TAGS GROUP

Use the duplication tool to make copies of tags or tags group. The sameprocedure can be used to other objects, such as Screen and Screen objects.

To moves a tag or tags group through the organizer just click in the tag or group anddrag it (without loosen the mouse button) to the final position that can be a root Tagsgroup item and drop it. All its references (links with other objects or scripts) will beupdated.

CHANGING TYPES

You can use the Change type to... tool that accepts multiselection, which event redothe references, that means, the links that variable has in a way to set it in the newdesired type..

SETTING MULTI TAGS

Very often it is necessary to set countless Tags to several attributes in an identical way.It is possible to set up countless Tags at the same time. You must select all the desiredTags in the Organizer- drag the mouse starting from the first Tag until the last Tag in

T A G S


the list. At this moment all Tags display as selected, if you desire to select just some ofthem press the CTRL key while you click in each desired Tag.

Now each action or key in that is made with the already selected tags will be carried onin all tags.

OPT FOR THE COMMUNICATION TAGS IN BLOCKS

Whenever it is possible the use of tags block allows the inserting of the physical means,for in a generic serial communication process, great part of the characters transmittedbelong to control and checking. By using blocks we make such characters to be sent ina smaller number of times due to the encapsulating of the great number of variables inthe same transmission.

COMMUNICATION TAGS SCAN TIME SETTING

Try to program the variable scan time with the closest real values. If a very low scantime is specified to all the variables, probably the following will take place, due to pysicalmeans limitation: not all the variables will be collected in the specified rate, which willcreate a performance decrease in the communication, not allowing that certain variablesthat really need a faster search be in charge of the communication.

TIME INFORMATION IN THE TAGS

Some equipment allow sending time information together with the variable values. Thecommunication driver for such equipment can also return this clock information, ineach consulted tags.

This information can be obtained through the TimeStamp property, in all tags, withan accurcy of 1 ms. When the equipment does not support this kind of information, orwhen the driver is not ready for such procedure, the program itself will perform theinformation task at the moment of collection, filling up with the PLC watch value.

Remark: In the case of Block tag type, the same TimeStamp is informed to all theblock elements, once they have already been consulted at the same time. If they aredistinct events they must be read as tag of PLC type.

5.2.11.Alarms Page

Each Tag that is defined has an Alarms page as the one shown below in which 4 rangevalues and priorities to Alarms can be set. Alarms are used to signalize any event thatmay happen with a variable, also allowing take the appropriate actions through theScripts (programs).

T A G S


To visualize the set Alarms to a Tag, you need to insert an Alarm Screen object,something we will see later. This object can also show the spread alarms that areregistered on an Alarm file or active alarms of the system.

To print the spread alarms in the system you can define a Report through theOrganizer and run the main function of the Print in a Script.

The tags Alarms page displays when the tab Alarms is selected in the top of the Tagpages. That page is shown below and its respective fields are described in the followingtable.

FIELD DESCRIPTION

Lolo Critical Low Alarm. It defines a value range (minor equal) where the Tagis considered to be in a Critical Low Alarm status. It is used when thetag value is below the minimum, that means, extremely low.

Low Low Alarm. It defines a value range (major equal) where the tag isconsidered to be in low alarm status. It is used when the Tag value isbellow the average.

High High Alarm. If defined a value range (major equal).

T A G S


HiHi Critical High Alarm. It defines value range (major equal) where the Tagis considered to be in HighAlarm. It is used when the Tag value isabove the maximum, that means, extremelly high.

Value It defines the priorities for each possible alarm (lolo, low, hi, hihi).

Priority It defines the priorities for each alarm event. Small numbers indicatehigh priority (the priority must be a number from 0 to 999). For a bettercontrol, the high priority alarms will be displayed in foreground in thealarms window (Alarm Screen Object).

Comment A comment or message can be defined for each alarm. Up to 100characters can be used.

Log Alarm Return It enables the message log of Alarm return.

Alarm Group It defines the alarm group, whose file will receive the incidentmessages.

The range between the Low and High levels of the alarm (if set) represents the normaloperation status of the variable. When exceeding these limits, the incident is looged asan active alarm. If the variable rturns to its normal status, the return incident is looged ifthis operation is selected.

5.2.12.Alarms and Alarms Group

Each time an alarms is spread, all the event data are recorded, such as date/Hour, eventtype, tag value, etc. Each alarm can be associated to an alarm group that is defined bythe user, in the Alarm item in the Organizer, as follows:

T A G S


In this page, we can set a file for alarm recording, as well as alert sounds and messagesthat are recognized as standard alarm group.

FIELD DESCRIPTION

Name Alarm Group Name.

Description Description about the group.

Enable Log It enables data recording in disk for group.

Records Maximum register number. The file is rotative, that means, it will onlycontain the number here that will be the most recent ones.

Filename Disk file name.

Create New AlarmGroup

It creates a new Alarm group.

A different alarm group can be used when you want to separate some type of tagsalarms, so that they are stored in separate files. In order to visualize pr print thenm, inthis case, it will be necessary to create separate objects and reports, one for each file.

T A G S


Drill:

CREATING ALARMS FOR TAGS

Task: To create alarms for temperature and level tags.

Procedure: Select the three temperature tags, and in the alarm page create the Low andHigh option specifying low level 25 and high level 150. Repeat the operation for thelevel tags with limits of 10 and 90. Insert the text that you consider interesting in the

C R I A Ç Ã O D E T E L A S


Screen can be defined as a process monitoring window, in which the objectsthat will do the operator interface with the system will be inserted. Eachapplication can have an unlimited number of screen.

You can create a new Screen pressing the new Screen button in the Toolbar or usingthe New command in the Screen menu. In this new Screen, you can define the ScreenObjects, walpaper and other specific features.

For a better graffic quality of the system that is being monitored you can insert awallpaper to the Screen. The format used today by the Elipse Scada is a grafical file withBMP, GIF or JPG extension that can be created in several specific draw Windowsapplications, as the paintbrush (Windows 95/98/2000/etc), CorelDraw, PaintShopPro, Autocad and others.

You can create your own drawing (bitmaps) in any size and color you wish. The ElipseScada will automatically import them without using a conversion process.

To visualize or edit the current Screen properties, double click in an empty window isdisplayed, containing a list of all the Screen in you application. You can create a newScreen using the New button in the right side of the page or remove and then thebdelete button.

Capítulo

6. Screen Creation

A



FIELD DESCRIPTION

List It shows a list of all the existing Screen in its application. The same Screenswill be displayed in the Organizer tree below the Screen option, and whenthey are selected its respective properties are displayed.

New It creates a new Screen.

Delete It deletes the Screen selected in the list.

Go to It closes ythe Organizer and shows the current Screen.

Show It shows the current Screen without is selection.

Hide It hides the current Screen, keeping it in the application.

6.1.1.Screen General Properties

Each Screen that you create for an application is displayed below the Screen option inthe application tree in the Organizer. When selecting a specific Screen, its properties are



displayed in the right side of the tree, or when you double click on its background

(outside the Organizer) or even through the button in the toolbar.

The Screen general Properties is displayed when the General tab in the top of theScreen Page. This page is displayed below and its respective fields are descrived in thefollowing table:

FIELDS DESCRIPTION

Name It defines a name for the current Screen. By using this name, you can open theScreen from any part of the application using the function buttons or screens, aswell as to associate it to Scripts.

Title It defines a Title for the Screen, also used as its description.

Color It defines the background color for the current Screen. This parameters is usedwhen there is no selected bitmap or when the bitmap or when the bitmap doesno fulfill the Screen.

Bitmap It allows to navigate in the directory structure in order to find the BMP files thatare used as Screen background. The bitmap path and name are displayed belowthe check box.



Browser It defines the access to the Screen that will be verified with the access level of theuser when entering the Screen.

Acesslevel

It defines the access to the Screen that will be verified with the access level of theuser when entering the Screen.

6.1.2.Screen Style Properties

The Screen Style property page is displayed when the Style tab is selected in the top ofthe Screen pages. That page is displayed below and its respective fields are described inthe following table.

FIELD DESCRIPTION

Full Screen It determines the Screen to occupy the whole application window.

Windowed It determines the Screen to be displayed inside a window occupy the wholeapplication window according to the specifications in the Size and in thePosition options.

Width It defines the Screen width in pixels.

Height It defines the Screen height in pixels.



X It determines the X coordinate for the left superior corner of the Screen inpixels. For instance, if you are using a windows resolution of 640x480 (VGA),your X coordinate can vary from 0 (zero) to 640 pixels to a window withoutscroll bar.

Y It deteremines the Y coordinates for the left superior corner of the Screen inpixels. For instance, if you are using a Windows resolution of 640x480 (VGA),your Y coordinate can vary from 0(zero) to 480 pixels to a window withoutscroll bar.

Scroll Never It determines the winodw not to have scroll bars, even when its necessary.

ScrollAutomatic

Scroll bars will automatically be displayes when they become necessary.

Close It enables the close button to be displayed in the window (button in the rightsuperior corner). This button can only be seen in the Windows 95/98/NT/XPor superior.

Maximize It allows to maximize the window.

Minimize It allows to minimize the window.

Show Border It inserts a border in the screen.

Resizable It allows to resize the window in the running time.

Moveable It allows the window to be moved in the running time.

Title Bar It displays or hides the Title bar.

Initial Screen It makes the Screen be the first display in the running.

Modal It does not allow the user to leave the Screen without turning it off.

Pop-up It allows the screen to be automatically closed when the user click out sidethe Screen.

Clip Children When selected it makes the background drawing be totally displayed withoutcutting the objects.

Drill:

CREATING

Task: To create the main Screen for the manufacturing monitor.

Procedure:

In the Organizer, select the Screen objects and press the New button, or Click in theNew screen button

in the toolbar, or through the menus, access the NewScreen option.



If you have already created an empty Screen (when starting a new application ascreen is always automatically created) go to the next step.

From this new screen you can define new animation objects, the synoptic backgrounddraw, and all the Screen specific features. The list of existing Screens in the applicationis available in the toolbar for downloading during the set up process and Applicationcreation.

To set up the new Screen properties you can:

From the Organizer, expand the Screen objects screen, selecting or not theScreen.Double click on the Screen in the Work Area, or click in the Screen Properties

button .

Namein the property Title. Select the option Bitmap, press the Find buton and select theBitmap C:\ELIPSE32\LIB\UTIL\FUNDO MODELO.BMP. In the Style guideselect the style options Full screen and Automatic scroll.

Task: To create Screen for system Alarms visualizing.

Procedure:Title style with Window, Scroll Automatic, close button, optionmovable option selected, title bar selected and Initial Screen Selected not selected.

Place the background color orange, through the Other colors option in the main page.

Task: Create Trend Screens, in the same pattern as that one of the Alarm Screen.

Procedure: One of the options would be to repeat the prior procedure. Howeverother interesting option would be to duplicate the prior screen, and only change thenecessary points. Through the Organizer select the Alarms Screen. Next, click in the

second icon in the toolbarthat allow makes copies of any object. Then, a dialog

box is displayed, where must be informed the copy numbers (1). A new Screen calledAlarms_Screen2 will be created. Modify

Task: To create the opening Screen, as Full-Screen; wine background color, Initial



Task: To create the opening Screen, as Full-Screen; wine background color, Initial

Task: To create Recipe Screen, as with window, black background color, and closing

Task: To create Bath Screen, also with window, green background color, and closing

Remark: A reference for the screen look can be seen in chapter 3, Case Study.

O B J E T O S D E T E L A


N application Screen can contain background and objects bitmaps. Theobjects that are inserted over the bitmap constitute a secondary ground in thescreen, in a way that it can be detected, copied, moved, resized, andbracketed, without damaging the background.

The screen objects, therefore, are graphical elements that are related to the tags so thatit is possible to make a friendly interface with the variables. The previously availableobjects are as it follows:

Slider: It allows to visualize or send values toa tag through a potentiometer(sliding button).

Trend: It is used to visualize a trend graphic with up to 16 tags (that can beexchanged in the running), running the real time collection or in background,besides perform variable graphics by time, or the variables relating to others (XY).

Button: For activating or running the specific tasks by the user through themouse or key, being able to assume several formats and functionality..

Gauge: Displayer of analog values with the pointers.

Text: This object allows attributing messages in Tags range values, calledAreas, defining colors and messages fo each Area.

Bars: It is used to visualize the data in volume appearance. It can be displayedup to 16 tags in each bar object.

Display: Numerical/Alphanumerical displayer in real time.

Animation: To create animation using bitmaps defined by the users.

Capítulo

7. Screen Object

A



Setpoint: It is an editing box, for keyboarding and sending values to avariable.

Alarms: It allows the visualization of the activated alarms () or the alarmslogged in the alarm file (Historical).

Browser: It allows the visualization of databases files in the screen.

Bitmap: it allows the visualization of databases files in the screen.

Video: The Video object allows you to show a video source, displaying a real-time video or a playback.

Avi: The AVI object allows you to playback an AVI file. You can edit AVIproperties double-clicking the object.

Preview: The Preview object allows you show a video source.

7.1.Screen Object Edition

The Screen Objects can be created from the toolbar Objects or through the ObjectMenu. Once selected the object that you wish to create, keep the left mouse buttonpressed in the screen area while moving the moouse (a spotted rectangle shows the sizeabd shape of the object). When you drop the button the object will be placed in thespecified area.

Insert any two objects in the screen (e.g: two buttons), so that you can verify and usethe following tips:

MAKING COPIES OF SCREEN OBJECTS

We can copy screen objects by pressing the CTRL key while we drag the object wewish to copy. This action will create a new screen object that will have the sameproperties as the copied object. You can even use the basic Copy (CTRL+C) and Paste(CTRL+ V) commands of the Windows.



OBJECTS OVERLAP

If you have two screen objects, and part of one has to be over the other, you need to

adjust the disposal through the Bring to Front and Send to back buttons.

NAVIGATING COMMAND BETWEEN OBJECTS WITH KEYBOARD/MOUSEINPUT

When inserting a series of screen objects, it is possible (in running) key to shift fromone object to another by using the Tab, as two Set-points for instance. Initially, theshifting through the Tabs follows the object creation command in the screen.

However, it is possible to easily change this command with a little trick::

1) Select the objects in the desired Tab order.2) Press the Bring to Front or Send to Back buttons.

The objects that were brought to the front will be arranged firstly in the navigationcommand, and the other that were sent to the back will be placed lastly.

The Screen Objects Edition, such as aligment, size, position and bracketing is donethrough the toolbar Settle or through the menu. The last selected object will have thefocua in red to be used as a reference. To deselect an object use the key combination:SHIFT+CTRL+left button.

SELECTING ALL THE SCREEN OBJECTS

To select all the objects contained on a screen, just press the Ctrl+A keys.

SELECTING SOME SCREEN OBJECTS

To select the objects contained in an area, use the tool selection . With it youcan select the objects within a mouse delimited area.

USE OF DIRECTIONAL KEYS

In order to move an object in the Elipse Scada with the keyboard, select it an use thedirectional keys, as follows:

Up arrow: It rises the object 1 point up;



Down arrow: It descends the object 1 point down;Right arrow: It moves the object 1 point to the right;Left arrow: It moves the object 1 point to the left;

Combining the directional keys with CTRL, you can make the object transference10 times faster. Combining the directional keys with SHIFT, you can resize theobject.

Some examples:

CTRL+Up arrow: It rises the object 10 points;SHIFT + Left arrow: It decreases in 1 point the object width;CTRL + SHIFT + Right arrow: It increases in 10 points the object width;

7.2.Screen Object Properties

Once a screen object is inserted, its properties can be acessed in many different ways:

a) Through a double click on the object;b) Selecting the object and using the Objects Properties menus;

c) Selecting the object and clicking in the button in the toolbar.d) Via Organizer, in which you can access the screen, and by clicking in the + symbol,

the objects belonging to that screen will be displayed.

All the objects have 3 property pages in common, as follows:

7.2.1.Frame page

Trought the frame page we can set visual styles to the object, as Borders, tridimensionaleffects and titles, among others.



FIELDS DESCRIPTION

Visible It enables or disables a frame arround the object.

Color It defines the object frame color.

Title It enables or disables a title in the object frame.

Text It defines the title text.

Font It defines the font, color and size of the Title font.

Text Line separator It enables or disables a line separator between the text and theobject.

Border It enables or disables a border or frame.

Thickness It defines the border tickness in pixels.



Color It defines the frame border color.

3D effect It selects a 3D effect inside or untsides the object frame.

Thickness It defines the thickness in pixels to the 3D effect.

7.2.2.Tags Page

Through the tags page we can associate the object to one or more variables that can beattributed from any object. In the Objects windows, we have access to the objects inthe Organizer tree, whose properties are displayed in the Properties window. Theobjects selected can be accessed through a click in the ADD button. The most usualoperation that is associated to a tag is made by selecting the referred tag, and adding itin the list. A similar procedure can be used to make association, instead of the aforesaidtags, its alarm level, or its scan time, or any other property that you wish.



FIELD DESCRIPTION

Objects It shows the application tree. According to the selected object, its propertieswill be displayed in the Properies window.

Properties It allows the selection of any property of the object selected in the tree.

Tags selected It lists the Tags that are associated to the object.

Add It adds the selected Tags in the selected tags list.

Remove It removes the selected Tags of the list.



7.2.3.Size and Pos Page

Through this table you can set some position features, besides others genericspecifications.

FIELD DESCRIPTION

X It defines the X coordinates for the left superior corner of theObject in pixels. It is used together with the Y attribute to definethe Object position bsed on the Screen source (0,0).

Y It defines the Y coordinates fo the left superior corner of theObject in pixels. It is used together with the X attribute to define



the Object position based on the Screen source (0,0).

Width It determines the Object width, in pixels. It is used together withthe width attribute to define the Object size.

Height It determines the Object height, in pixels. It is used together withthe width attributes to define the Object size.

Unmovable duringDevelopment

It determines the object can be moved during the set up(It blocksup the Object position change).

Visible on applicationstartup

It determines the Object must be visible when the applicationstarts.

Enabled (receive mouseand keyboard input)

It enables the key and mouse access to the Object (Only valid tothe objects that allow inputs via mouse or keyboard). Forinstance: Slider, Browser).

Show tips during runtime It enables the object to show a tip when the mouse is over it.

7.2.4.Object Inserting and Running

In some objects, such as the animation button, besides the screens, bitmaps can beused. To its editing and generation, several programs, can be used, such as theCorelDraw®, Adobe® and Autocad®, among others. We will show here an examplewith the Paint:, a tool of the Windows 95/98. Taking as an example the followingbitmap, shown below, there are two possible ways:

a) Press the F8 key or the icon that carries on the monitoring of all the openedscreens.

b) Press the F10 key or the icon that makes the total running of the application.

In order to return to the set up mode, just click the ESC key that is already specified asa pattern for leaving the running to create a new application. To change the key or tocreate a new method, it is necessary to change the script of the ESC key that alreadyexistis in the Application item, or to delete it and create a new one, which will be seen inthe next chapter.

7.2.5.Bitmaps Utilization

In some objects, such as the animation button, besides the screens, bitmaps acn beused. To its editing and generation, several programs can be used, such as theCorelDraw®, Adobe® and AutoCad®, among others. We will show here an examplewith the Paint, a tool of the Windows 95/98. taking as an example the following



bitmap, shown below, which is the background of the monitoring main screen of ourexample of application.

USING THE GRAPHICAL EDITION

Our purpose is to cut a slice of the image (the engine) so that we are able to create abitmap type button over it in the application, and when click over that area can activatea digital output in the equipment and signalize with a different color in the screen, forinstance. For such procedure, we need to take the following steeps.

Select the area that you want to animate (in this case the engine) through the

rectangular selection of the tool , and drag the cursor in diagonal in the screen,thus selecting the area.

Through the Edit Copy to menu, specify the positionLIB\HYDRAULIC\MOTORS7PUMPS and save it with the nameMYMOTOR1.BMP, with 256 colors (informed below the file name).

Now, open the file that you have just saved MYMOTOR1.BMP; fulfill a part of thedrawing with a different color, so that we can signalize any event by color (e.g. engineon).



Select the filling icon , and choose an apprioriate color in the palette, in theinferior part of the screen. Now click over the part in the drawing that you wish tocolor.

Through the menu File Save As, save the image with the nameMYMOTOR2.BMP. If you wish to have any other status information, with othercolors, repeat the procedure, saving the image with other names.

See the following useful tips about the Paint:

Use the mouse left button to draw with the front color, and the right button to drawwith the background color.

To draw perfectly horizontal, vertical or 45 degrees lines, press and keep hold theSHIFT key, while you drag the mouse pointer.

The SHIFT key, used together with full and empty rectangle, allows to build perfectsuares. The same takes place with rounded border rectangules. You can obtain circleswith the ellipses.

With the selection line, we can select any drawing area. Pressing the CTRL key, andclicking the mouse over the selected area. If you use CTRL instead of SHIFT, thefigure displacement will create an infinite copy effect.

To choose the foreground color, click with the left button over the selected color inthe color palette. The back ground color can be closen by clicking with the rightbutton over the selected color.

A double click over a color in the palette opens a dialog box that allows its edition.

The movement of a cropping with the mouse left button pressed implies atransparent background, that means, all the cropping area with shade equal to th colorof the selected background will be opaque.

To undo some changes, click in Edit Undo. It can be made up to 3 operations.



7.2.6.Drills

DOSAGE SCREEN SET UP

INSERTING TRANSPARENT IMAGES

Task:. To place the raw material supply tanks on the superior leftcorner in the screen.

Procedure:

Choose the Bitmap object, and insert it as a rectangle in the referred place.

In the Bitmap Name fied, click in Search, choosing the FUNIL2.BMP filein the library directory LIB\HYDRAULIC\TANKS.

Click in Size Setting so that the object get set in the right size if the image.Now, select the option transparent, choosing the gray background.

After placing a tank, you can copy it three times. For that, just select and dragthe object, pressing together the CTRL key, and dropping it in the desiredplace.

Task: To place the identification number of the raw materials tank in the superior leftborder in the screen (1,2,3 and 4).

Procedure:

Choose the Text object, inserting it in the screen.

In order to the object become superimposed to the tank drawing, just it in thetank area and bring it to the front through the menu Arrange / Bring it toFront.

Select the property Zones/Add, in which a new message zone will beinserted.

Key in the Message Pattern Zone property.

Task: To place the raw material mix funnel.

Procedure: Repeat the bitmap object insert procedure, choose the file FUNNIL.BMP.



Task: To place the raw material supply tanks on the inferior left corner in the screen.

Procedure: repeat the bitmap object insert procedure, choose the file SILO6.BMP.

Task: To place the intermediate tank to transfer the mix to the cookers.

Procedure: Repeat the bitmap object insert procedure, choose the file SILO5.BMP.

Task: Next to the 98 and 74 engine, in the superior left side, insert the condensers, alsoas bitmap objects.

Procedure: Repeat the procedure inserting the bitmap CONDENS.BMP.

Task: To insert the material transference valve from the funnel to the tank to manuallycontrol via mouse.

Procedure:

Choose the button object, and insert it as rectangle in the referred place.

Access the object properties, choosing Functionally On/Off and theBitmap type.

In the message field, choose the Normal status the fileV_VERTICAL_OFF.BMP and to the Pressing state the fileV_VERTICAL_ON.BMP. Both files are in directoryLIB\HIDRAULIC\VALV2.

Task: To insert a button to manually control the material agitation in the funnel.

Procedure:

Insert a button in the central left side of the screen, next to the funnel.

Select the Functionally On/Off and Type Text Message (first type).

In the frame table select visible, text Agitation.

In the message table select to normal status the next Off, and Arial font 9White, and for the Pressing the text status On, background color blue withthe same font.

In the Tags table add the property enabled off the tag mix.



INSERTING ANIMATION

Task: To insert animation representing the material agitation.Procedures:

Choose the object type animation, and place it in any place of the screen.

In the Zone pages, add from the directory LIB\MOTION\MIX, the bitmapsfrom AGIT_1 to AGIT_5, and from this one back up to AGIT_1, executinga total of 9 different positions or zones.

Now, select all the zones (drag them with the mouse) and click in the buttonAutoRange, informing from 0 to 9 as limits. Now, each zones is associatedwith a tag value rate that will be associated.

Also select the Zone 1 as Patterm Zone, when you select it.



In the Tags page, add the Tag mix.

In the general page select transparent, background color light green, and clickin the button to set the object size to the image size.

Now, drag the animation until the funnel, and click in to toolbar Bring toFront, in order to place the animation over the bitmap.

Task: To insert visualization of the condenser valve through the animation.Procedures:

Insert another animation object over each of the condensers.



In the Zone pages, insert two bitmaps: VALVE_OFF, that must be selectedas pattern Zone, and VALVE_ON, selected with minimum 1 and maximum1.

In the general page, click in setting image. In the Tags page, associate each oneof them to a bit of the tag DO. As soon as a digital output, that is related to anassociated bit, is in its on status, the animation will show the activated valve.

INSERTING ANIMATED BUTTONS

Task: To create buttons over the engenes in order to manually command its operation.Procedures:

Insert a button type object over each of the engines.

In the general page, choose Bitmap type and functionality On/Off.

In the message page choose the bitmap M& to normal, value 0, andM&PUMPON to pressed value 1, that can be found in LIB\HYDRAULIC\MOTORS&PUMPS.

Click in the image set button (Fit to image).

In the tags page, associate each one of the three button to the first bits in thetag DI.

Task: To create control buttons for output valves.

Procedures:

Repeat.the previous procedure, but now choose in the message page thebitmap HORIZON_CONTR to normal and HORIZON_CONTROL_ONto pressed, that can be found in LIB\HYDRAULIC\MOTORS7PUMPS.

Click in the image, associate for each one of the two valves another bit of thetag DI.

In the tags page, associate for each one of the two valves another bit of the tagDI. Choose also in the message page the value 0 to normal and 1 to pressed.

POSSIBLE TO MODIFY TEXT FOR TWO DIGITAL TAGS

Task: To insert text object that from two bits of the tag DI, which indicate if theengine is on or off, the four possible status of the combination.Procedures:

Below the third engine (nº- 74) insert a text object and disable its frame.



In the Zone Table, add three messages zones.

Zone1 Pattern Zone, background color yellow, font colorred.

Zone2 Message:background color black, font color green;

Zone3 --background color black, font color red;

Zone4 -- ue 3 and maximum value 3,background color back and font color white.

In the tags table, associate it to the tag expression Status.

As the first bit that composed the Status indicates that the engine 1 is on/off,and the second bit the same in relation to the engine 2, the text object willshow four message types, according to the received value.

INSERINDO DISPLAYS

Task: To insert a display with timetable in the inferior right corner in the screen.

Procedure:

Right above the raw material supply silos, insert a display. To disable the frameand choose the font as MsSanSerif regular 10.

In the tags page associate the Tag Code. The code value will be explained inanother example further.

Task: To insert a display with timetable in the inferior right corner in the screen.

Procedure:

Choose the font Arial Regular 9, and disable the frame.

FieldBit1 FieldBit2 FieldBit3 Status Text0 0 0 0 Engines Off0 0 1 1 Engines 3 On0 1 0 2 Engines 2 On0 1 1 3 Engines 2 and 3 On1 0 0 4 Engines 1 On1 0 1 5 Engines 1 and 3 On1 1 0 6 Engines 1 and 2 On1 1 1 7 Engines On



In the tags page, select the item Global Manager, and then the propertycurrentTime.

In the format page, select Date/Hour, and through the Format button selectthe desired format HH:MM:SS.

Task: To insert a temperature display beside the cookers and the raw material silo.

Procedimento:

Disable the frame.

Select font MsSanSerif regular 8, white color.

The display background color blue, numeric format, and size 3.

the temperature tags. Remark: To key in the symbol º, just press the keysCTRL+SHIFT+ALT.

NAVIGATING THROUGH SCREENS

Task: To create buttons for navigation through screens.Procedure:

To create a button that will be inserted in the inferior part of the dosagescreen.

In the general table, choose functionality of momentary type, and associate itto the F1 key (that can be set in the Screen field), and in the option Go toscreen to the Opening screen.

In the message table, choose the font Arial regular 9- Yellow, with the-

messages (normal and pressed).

Trough the copy tools, copy the button, and insert the others by its side. Thenew buttons must have the same functionality, but leading to the other

- - -- -

The calling to the Historical (F5) will not be associated to any Screen, but itwill be user later on the Historical Analysis function.

VISUALIZING ACTIVATED ALARMS

Task: To insert Alarm visualization object.



Procedure: In the superior right corner of the dosage screen, insert an alarm object.Select type Resumed, with the Date, Hour, Alarm Type, Comments (Size 20) andvalue Options.

INSERTING LEVEL IN THE TANKS

Task: to insert bar objects.Procedures:

In any space of the screen, insert a bar graphic.

Select values rate from 0 to 100; orientation downwards to upwards,deselected bipolar, spacing 0, gray background.

In the ruler page, disable it; the same is valid for the frame.

Format its size do that it has the same height of the cooker tank, and narrowenough to fit between the red lines and the right border.

In the Tags page associate it to the Tag level01.

Put it now in the position over the cooker, and choose the option Bring toFront.

Repeat the procedure with the other cooker, as tag level02 and with the rawmaterial storage silo, as tag level03.

OPENING SCREEN SET UP

Task: To insert a title to the Screen.Procedure:

In the opening screen, insert a text object, setting a message Zone. Select it aspattern with background color wine, and font as Bold Arial 20, color Yellow.

Example application Candy Plant

Task: To insert a support Bar to tools.Procedures:

To insert another text in such a way it occupies the whole screen inferiorextension.

Create a message zone, selected as Pattern.



Clean the text content to the message (no text).

Deselect the title and the border in the frame page. In the 3D Effect option,select inside, size 4.

Task: To insert a Button for Screen Exchange.

Procedures:

Insert button right above the bar.

Choose the momentary type, and in the item CGo To Screen, associate it tothe Dosage Screen.

In the message table, place the alignment in the center and key in the text

INSERTING TREND GRAPHIC

Task: To insert a trend grahic in the trend Screen.Procedures:

Insert the trend graphic in the trend Screen.

In the general page, graphic type section, select Time x Data, new data in theright margin, 10 second range of data.

In the advanced page select Real-Time. In the graphic page, key in for the Yaxle the limits from 0 (inferior) to 250 (superior).

To associate Tags to the Object, select the pens table that will display thefollowing tools:

BOTÃO NOME AÇÃO

Real Time Pen It inserts a pen to a tag visualization or property in real-time.The use of this type of pen is enabled to the trend graphicsin Real Time type.

Historical Pen It inserts a pen to the graphical visualization in the historicalfield. The use of this type of pen is enabled to the objectsthat use files, as historical trend, historical Analisis andgraphic report.

Mark It inserts a mark on the graphic that can be a vertical,horizontal or point (cross) line.

Delete Pen It deletes the selected pen.



Line It defines the selected pen to a line graphic.

Area It defines the selected pen to an area grapghic.

Bar It defines the selected pen to a bar graphic. In this case, theuser can select bar as medium, maximum, minimum or justsample.

Up It brings the selected pen to a position above in the pen list.

Down It brings the selected pen to a position below in the pen list.The defined order will be obeyed in the graphic draw, so thepens that are displayed lastly will be in the back, and the firstones in front of it.

When a new pen or mark is inserted, a new line is added to the oen line, as follows:

FIELD DESCRIPTION

Label / Icone It shows the type of the defined pen Real time, Historical orMark. A double click over the icon opens a window for a tag or tothe pen property association.

Label / Enabled It defines the enabled pen. The disabled pens ca be enabled, andvice versa, in the runing.

Label / Nome It defines a name to the pen, not necessarily the associated tag orproperty name. To keyboarding, just click over the text that anedition field will be opened.

Y axis It is used to associate a tag, field or attribute to the Y axis of apen. Clicking over the field you obtain a list of available fields, incase the pen is historical, or a window similar to the App Browser



for linking any item to a pen, in case of real time or mark.

X axis It is us used to associate a tag, field or attribute to the X axis of apen. Clicking over the field you obtain a list of available fields, incase the pen is historical, or a window similar to the App Browserfor linking any item to a pen, in case of real time or mark.

Type It indicates the graphical type to the pen; line, area or bar.

Click in the icon Real Time pen, and add a pen to the list. Double click in the icon inthe list, where the following pn property window is displayed:

Select the Tags table, and next the tag Temp01. Repeat the procedure of inserting pensto the level and temperature tags.



INSERTING HISTORICAL ALARMS OBJECT

Task: To insert a historical alarm in the Alarms Screen.Procedure: Insert the Alarm object in the screen reserved to it. Select type Historical,with the Date, Hour, Alarm Type , Comments (20) and value options.

INSERT ALARM LEVELS IN THE TREND

Task: To insert in the trend object the alarm levels through the use of marks.Procedure:

In the trend screen, select the trend properties by double clicking on it.

Go to the pen page and add a mark through the pen icon mark. The mark arepens that can be inserted in the trend, so that it can represent a straight line(horizontal or vertival) or a point (cross).

Once the mark is selected, there are two ways of setting it: through a doubleclick in the mark icon or through a click in the Axle Y and Axle X field.

In the general page (accessed through a double click in the icon) select it as ahorizontal line, and format it as stripped line.

In the tags page associate it to the high alarm level of the tag temp01,temp01.High.Limit. Repeat the procedure to the low alarmtemp01.Low.Limit, creating a new mark.



INSERTING SLIDER FOR ALARM LEVEL CHANGES

Task: To insert slider in the trend screen to cgange the alarms level.Procedure: Create in the two sliders trend screen, and associate the propertiestemp01.High.Limit and temp01.Low.Limit, so that they can be modified during therunning. The same procedure can be made with setpoints.

INSERTING BUTTONS TO ENABLE/DISABLE THE VISUALIZATION OF THEPENS IN THE TRENDS.

Task: Insert buttons in the trend screen to display or not a trend pen.Procedure: Create in the trend screen a button of checkbox type to each pen linked to a trend, andassociate them to properties Tendencia1.Plotagem.Pen1.Penvisible, so that when



you click on the button it will enable or disable the visualization of the chosen pen. Fora better result, select the button text color according to the color that it represents, andthe background color equal to the screen background.

S C R I P T S

Elipse Software 8-1 Elipse Windows

he scripts are programming language module, in which code lines can becreated that allow a higher flexibility to associate actions to specific events.Each item of the Elipse Scada application has an event list previouslyassociated. Thus, the user will be able to create programs that will be executed

in the incident of a specific event..

8.1.General Considerations

In any programming language it is necessary to create methods in order to specify andorganize the desired instruction running. The Elipse Scada script structure itself isalready organized in this manner, once they are oriented to events.

The events are incidents related to an object that can be handled in order to execute anaction. The events can be physical, as for instance, a keyboard action. In this case, therelavant information would be pressing the key (among others), or if the event comesfrom the mouse, the relevant information would be the cursor position and the buttonstatus. The events can be internal, with a variable value change, but can have a physicalassociation, such as a chamber temperature change from 10 to 11 degrees.

The event conditions that may occur with the objects are already handled by the ElipseScada, and areavailable to the user to connect the program (scripts) to them.

Here there is an event list already available to the script running, listing the generatingtype of action or prevailing in the event generation, with its name and a list of objectsthat support the events.

ACTION NAME USED OBJECTS

Keyboard Press orrelease any key or keys

OnKeyPress,OnKeyRelease

Application (To independentrunning of the screen being

Capítulo

8. Scripts

T

S C R I P T S


combination visualized).Screen (To running only when thescreen with the scripts is open).

Keyboard / TimeWhile any key orcombination is pressed

WhileKeyPressed Application (To independent runningof the screen being visualized)

Screen (to running only when thescreen with the scripts is open)

Keyboard / Mouse Toclick or move the focus(edition) to an object orscreen

OnKillFocus,OnSetFocus

All the screen objects

Mouse (general eventswith buttons)

OnRButtonUp

OnRButtonDown

OnRButtonDblClk

OnLButtonUp

OnLButtonDown

OnLButtonDblClk

OnMouseMove

All the screen objects.

Mouse OnPress

OnRelease

Button Screen object

Mouse / Time WhilePressed Button Screen object

Time WhileRunning Application (To independent runningof the screen being visualized)

Screen (To running only when thescreen with the scripts is open).

Any Alarm type incident OnAlarm Alarms

Disconeccting theSupervision Network(not with the CLP)

OnDisconnect Remote Application

Events with Tags OnAck

OnAlarmHigh

OnAlarmHiHi

OnAlarmLow

OnAlarmLoLo

OnAlarmReturn

OnValueChanged

OnRead

Tags

S C R I P T S


The language used in the script modules are defined by the Elipse Basic, and is verysimilar to the C language, but with visual resource such as the Visual basic. Differentfrom the programs in the mentioned languages, some considerations can be made :

It is not necessary vaiable or function declaration in the beginning of the script. Thevariables that can be tags/ objects/ attributes must be previously created, importedfrom other application, or yet it can be used as patterms that already part of anyapplication, at the moment they are created.

The data type that is attributed to a tag is free, and the supported value can rangefrom a whole number of the 8 bits to a real type of the 64 bits, or yet, a string (text).When repassed to the communication driver or received from it, the conversions tothe supported types to different equipment are made . In the properties case, an iconsupported type data, as listed below:

Numeric attribute (whole number)

Numeric attribute (real number)

String attribute (text)

Boleano attribute (0 or 1).

The variable (tags/attributes( and constants are the basic objects that can bemanipulated in the script. The operators specify what will be carried on with therm; onthe other hand, the expressions match variables and constants to procedure new values.

To make the scripts edition or tags expression easier, the command buttons in theOrganizer toolbar, the App Browser and the X-Reference (Crossed Reference) can beused.

8.2.App Browser & X-Reference

The allows you to easily navigate in the application. When you select anobject in the tree in the window left side, its attributes and functions are displayed in theright side. You can use the App Browser as reference during the script edition. A veryuseful feature is to select object/attribute/function that you seek to copy right to theScript in (Copy to Script ->).

The App Browser window is displayed as follows:

S C R I P T S


FIELD DESCRIPTION

Selected It shows the selected object/attribute/function name, in the same way it willbe copied to the Script.

Objects It lists the application in hierarchy as it is displayed in the Organizer.

Info It shows a brief description of the selected attribute/function.

Properties It lists all the selected object attributes and functions in the Object window.

Show It allows to filter the listed information in the property window. It selects theAttributes and/or Functions that will be displayed to the selected object.

Copy to Script It copies the displayed text in the Selected field to the Script in the cursorcurrent position.

Note

You can also use the App Browser in the edition of Tag expressions. Tocopy the selected object / property / function to a Script or Expressionjust double click over it.

The X-Reference tool has the same structure of the App Browser, however, when youselect an object in the tree in the window left side, its respective references are listed inthe right side. Double click over a reference to go the referred object

S C R I P T S


8.3.Operators & Constants

Here is a list of the constants (and its notations), and the operators that be used in thescripts.

CONSTANTS EXAMPLE

Integer (32 bits, dec) 1234, 1234d, -993

Integer (32 bits, bin) 11001110b (does not allow signal)

Integer (32 bits, octal) 7733o (does not allow signal)

Integer (32 bits, hex) 0A100h, 3B8h (does not allow signal) (if the first digits is A-F,place a zero before)

Real numbers (64 bits) 133.443, 344.939 (does not have scientific notation)

Strings "Temperature", "pressure"

OPERATORS EXAMPLE

+ Addition tag001 + 34

+ Strings connection slider1.Frame.title + " - PLC1" (connects two strings)

- Diminution tag001 - screen1.x

* Multiplication screen1.width * 3.141592

/ Division tag001 / tag002

% Remainder tag001 % tag002 (rremainder of the tag001 / tag002)

** Exponentation tag001 ** 2 (tag001 square)

LOGICAL OPERATORS EXAMPLE

& and bit-a-bit flags & 0F000h (isole the os bits 12-16)

| or bit-a-bit flags | 0F000h (arrow the bits 12-16 para 1)

^ xor bit-a-bit flags ^ 0F000h

~ not bit-a-bit ~ flags (it denies all the flags bits)

<< shift left flags<<2 (it transfers the flags valu two bit to the left)

>> shift right flags>>2 (it transfers the flags value two bit to the right)

AND and lógico tagOnOff AND (tag001 > 200)

OR or lógico tagOnOff OR (tag001 > 200)

XOR xor lógico tagOnOff XOR (tag001 > 200)

NOT not lógico NOT tagOnOff

S C R I P T S


ATTRIBUTINGOPERATORS

EXAMPLE

It returns 1 if the realtion is true, 0, if it is false.

== Comparsiob tag001 == 20

> Higher than tag001 > 20

< Minor than tag001 < 20

>= Higher or equal than tag001 >= 20

<= Minor or equal than tag001 <= 20

<> Different tag001 <> 20

ATTRIBUTINGOPERATORS

EXAMPLE

tag001 = 20

tag001 += 20 (tag001 = tag001 + 20)

tag001 -= 20 (tag001 = tag001 - 20)

tag001 *= 20 (tag001 = tag001 * 20)

tag001 /= 20 (tag001 = tag001 / 20)

tag001 %= 20 (tag001 = tag001 % 20)

tag001 &= 20 (tag001 = tag001 & 20)

tag001 |= 20 (tag001 = tag001 | 20)

tag001 ^= 20 (tag001 = tag001 ^ 20)

tag001 **= 20 (tag001 = tag001 ** 20)

tag001 <<= 20 (tag001 = tag001 << 20)

tag001 >>= 20 (tag001 = tag001 >> 20)

(RUNNING ORDER)

The table below lists the priority and association rules to all the operators. Those listedin the same line have the same priority.

+ - ~ NOT (unary operator)

**

* / %

>> <<

> >= < <=

== <>

&

^

|

S C R I P T S


AND

XOR

OR

= += -= *= /= %= &= |= ^= **= <<= >>=

Note

When attributing a value directly to a PLC tag or Block Element that hasthe property automatic writing enabled, the command is sent directlyto the communication driver that in its turn repast it to the associatedequipment. Such action does not take place only when the avlueattributed is equal to the content that was is the tag. In case you want toforce a writing whatever, the tag Write() function must be executed inany script.

8.4.Flow Control

In order to control the order in which the information is processed, a flux controlinformation is used. The Elipse basic language uses the following set of controls

8.4.1. Command

It is used to make decisions. Formally, its syntax is:

If condition1[instruction block 1]

ElseIf condição2[instruction block 2] ]

. . .Else

[instruction block n] ]EndIf

S C R I P T S


8.4.2.

It repeats an instruction block a certain number of times.

For counter = beginning To end[instruction block]

Next

8.4.3.

It runs an instruction block while a certain condition is real.

While condition[instruction block ]

Wend

8.4.4.

Its runs an instruction block until a certain condition is confirmed as real

Repeat[instruction block]

Until condition

For further information about the syntax and the permission for using control ties,

the performance furing its use.

8.5.Special Functions

The Elipse Scada Special Functios assist the Script edition, allowing more complex taskrunning and a better set up of your system.

The App Browser tool shows the available functions to each object during the Scriptseditions. The following objects have Special Functions that can be visualized selectingthe desired object in the application tree in the App Browser:

S C R I P T S


Global Manager

Application

Tags

Screen

Screen Objects

Alarms

Recipes

Historics

Reports

Query

Plotting

Drivers

Databases

Remotes Applications

The Global Manager item has generic functions that are not specified to any type ofobject. In this group there ar the date and watch functions, strings manipulation andnumeric conversion, files, multimedia, among other functions.

The screen object functions can be accessed first through the screen selection thatcontain it, soon after the object. The plotting function can be found in the trendgraphic objects, historical Analysis and graphic report. And the Query functions areused by the objects, histprical Analysis and graphic report. And the Query functions areused by the objects that make access to tiedisk data, such as the historical trend, thebrowser screen object, and the historical and reports.

8.6.Tips and Optimization

SCRIPTS EDITION

To build a scripts, besides using the App Browser, you can freely edit the lines inany text editor of the Windows. Thus, the pattern operations such as Copy(CTRL+C), Paste (CTRL+V), Cut (CTRL+X) and Undo (CTRL+Z) can be used.Besides that, the Find and Replace tools, present in any script, can be used.

S C R I P T S


SCRIPTS COMPILATION

Always before running an application we must check if it does not have any errors.This is a very important task, once the scripts that contain syntax errors (thatmeans, poperty names or wrong objects or not existing ones) will not run.Using the Compile Scripts, Build Scripts, Rebuild All Scripts buttons that arein the inferior part of the Organizer, we can make this verification in a fastermanner.Use the Compile Scripts button to check script errors that are being edited in themoment. This button will not verifies only the scripts that were not yet compiled.The Rebuild All Scripts button verifies all the application scripts withoutconsidering if the they were changed or not. The time difference that thisoperating takes to be executed regarding the Build Scripts is slightly higher to thelarge application, but is very useful to avoid running errors. When using these twolast options, a window click in the red line, the scripts with errors are automaticallyedited.

SCRIPTS ERROR

If during the script running an error of the following type takes place:

a) The script contain compilation errors and you run it whatever;

b) You are attributing parameters of incompatible types (e.g. forcing a string to adigital attribute).

c) There was a division by zero the Script will be aborted. To avoid this kind ofproblem, always compile your files, and verify the change of this problemshapping again.

SEQUENCING SCRIPTS

As the scripts are priented to events, there is a chance of running the scripts insideothers, due to the used operation sequencing. As the following example:

Script OnAlarmHigh of the variable tag001

tag002 = 1

tag003=0

Script OnValueChanged of the variable tag002

S C R I P T S


Screen1.Activate()

In this case, at the moment that the tag001 is in the alarm condition (that was previoulydefined by the user) the first script attributes a value 1 to the tag002. When performingsuch task, the tag001 script is interrupted, so it can verify in the value attribution causeto the tag002. When this occurs, in general it id verified if the tag002 has any scriptassociatd (so that will be necessary to run them too, since occurred an event to thetag002) or if there is any screen object connected to it.

Thus, the script OnValueChanged of the tag002 is run, and only then is returned to theorigin point, from where it stopped in the script of the tga001.

COMMENTS

It can be insert comments in the scripts with two simples bars placed in the left sidefrom the point where you want to meke a comment.

Examples:

Tag001 = 25 // this is a comment

INTERN VARIABLE

You can create internally variable in the script. After the running, it will be destroyed.The used command is DIM. Example:

DIM FLAG

FOR FLAG=0 To 10

Tag001=FLAG

NEXT

SCRIPT RETURN

If you wantwant to leave a script before its end, use the RETURN command.

Example:

IF Tag001 > 10

RETURN

S C R I P T S


ENDIF

Tag002=10

In the example above, if the Tag001 is higher then 10 the script is abandoned. On thecontrary, its running normally continues.

RESTRICTION THE USE OF INFINITE TIES

If the control ties such as While and Repeat are used to create inifite ties, they caninterrupt the running of other software tasks. As the following example:

WHILE Tag001

Tag002+=Tag003

WEND

In the script above, the available tag001 is evaluated; if real, that is, different from zero,it start the running of the first instruction that increases the tag002 of the value of thetag003. After that, the tag001 is evaluated again, and the running continues with thepossibility of receiving the answer of the communication driver with the tag001 value.In order to eliminate the problem, one of the solution is to force the reading of thetag001 in the end of each loop, as in the example:

WHILE Tag001

Tag002+=Tag003

Tag001.Read()

WEND

LIMITATION IN THE RUNNING SCRIPTS BY TIME

The scripts WhileRunning generally spend more processing time them the otherscripts.

Using the ScriptWindow() function that it is also a tool you can verify while running howlong each script takes to be executed. Thus, you must guarantee that a ScriptWhileRunningFinnish. Its execution before calling it again, in order to avaiod a runningrequest accumulation.

TOO LONG SCRIPTS

S C R I P T S


It aviods the creation of too long scripts. When you separate them in small parts thetime spent consireably decreases; and as said bove, use the debugging function tooptimize the scripts. A deparation between scripts sughestion could be as follows:

Create a RAM type, wich can be called, for instabce, functionA. At some point, in thescript to be separated, make an attribution to the functionA.

Script WhileRunning Aplication

FunctionA=1

In FunctionA create a um script OnValueChanged, and copy the part of the first scriptthat will be executed on it. As the last instruction, return the tag FunctionA to its initialvalue.

Script OnValueChanged - FunctionA

FunctionA=0

BUTTONS SCRIPTS

To the button scripts, choose the OnRelease instead of the OnPress, so that the usernotices the action easier.

8.7.Drill

SCREEN EXHANGE VIA SCRIPT

Task: In the calling button of the Alarm screen, F2, replace the automatic call for ascript.

Procedure: In the general page of the mentioned button, in the ListBox Go ToScreen, choose none. In the scripts page, choose OnRealese. Through the AppBrowser,

S C R I P T S


serach the Alarm Screen, choosing its functions on the inferior right corner. Choose thefunction activate(). Copy it to the script, and next compile it. The final result must be:

Alarmes.Activate()

Run the application, testing its functionality.

SCREEN EXCHANGE IN SPECIFIC ALARM INCIDENT

In one of the level or temperature variable, create a script OnAlarmHigh, running thescreen exchange function to alarm screen, through the execution of the Activate()function of it. The result will be the same of the previous script, but it is being called bytwo different events.

OBJECT COLOR EXCHANGE IN ALARM INCIDENT

In the tag temp01 make through a script OnAlarmHigh change the display color in thescreen, through the property change, and with the help of theRGB(r,g,b) function present in the Global Manager. Example:

Script OnAlarmHigh, temp01:

Dosagem.Display01.backgroundColor = RGB(255,0,0) // red arrow to the background color

Script OnAlarmReturn, temp01:

Dosagem.Display01.backgroundColor = RGB(0,0,255) // return to blue

SCREEN EXCHANGE IN ALARM WITH PRIORITY

To do the same exchange to the Alarms screen, using the OnAlarm of the alarm itemin the Organizer, so that the alarm screen be called in any alarm incident with priority 2(only equal to 2). For that, select the alarm item in the Organizer, choosing the Scriptstable. Create a new script, choosing OnAlarm. Example:

Script OnAlarm:

IF lastAlarmPri == 2

Alarmes.Activate()

ENDIF

The OnMouseMove script is run when the mouse

S C R I P T S


ICONS SENSITIVE TO THE MOUSE

Task: To create an Icon that changes your draw, when you passes the move over it, inthe opening screen..

Procedure: Insert a bitmap object over the created toolbar, bringing it to front (overthe bar). Choose as bitmap the file LIB\UNTIL\LOGIN2.BMP, of transparent type,and background color write. Create a script to reiceve the mouse moves over it;

Script OnMouseMove:

Abertura.Bitmap.SetMouseCapture()

IF Abertura.Bitmap.IsMouseInside()

Abertura.Bitmap.fileName="c:\elipse32\lib\util\login.bmp"

ELSE

Abertura.Bitmap.fileName="c:\elipse32\lib\util\login2.bmp"

ReleaseMouseCapture()

ENDIF

The OnMouseMove script is run when the mouse is moved inside or outside theobject area. On the other hand, the SetMouseCapture function causes all the Windowsmessages, generated by the mouse, to be sent to the object in point. Thus you can test ifthe pointer is inside or outside the area, resulting in the changig of draws.

Run the application, and when you pass the mouse over the bitmap, you will see thatthe drw chages from black and white to colored.

CREATING MANUAL/AUTOMATIC PROCEDURES

Task: To create a button in the Dosage screen that disable the engine and valvescontrol button.

Procedure: Insert a button, aligned in the right side of the button area (inferior part ofthe screen). Choose the on-

button.

a) Force to 0 or 1 a bit or word in the equipment, so that it signs the operation inmanual or automatic.

b) Disable or Enable the objects that send values to the equipment.

S C R I P T S


To run the second task, it is necessary to create two scripts: PnPress and OnRelease. Theinstructions of the first are to enable the objects, when you choose a manual operation,and of the script second are to disable it, according to the script.

OnPress

Dosagem.button1.enabled=1


Notice that the object names can change from one application to the other. Thus,where you read , it is referred to the button that you wish to beenabled or disabled. The same is valid for the other scripts script:

OnRelease



CREATING SOUND SIGNAL WHEN ENTERING IN ALARM

Task: To use the Sound Signal function.

Procedure: Create a script in the item Alarms in the Organizer, OnAlarm. On it, insertthe StartSound command, present in the Global Manager. This command start to playe,in regular range, a sound index that that can be set in its Control panel.

CREATING BUTTONS FOR STOPPING THE SOUND

Task: To use the Sound Signal function.

Procedure: Insert the button over the Alarms object, and bring it to front. Choose themomentary and bitmap type, with the files Calaron.bmp e Calaroff.bmp, located in thedirectory LIB\BUTTON. Create a script OnRelease for it, and execute the StopSound()function, present in the Global Manger.

H I S T Ó R I C O S


he Historical are objects responsible for the storage of tags value in disk. Thestorage can be made per time or event that must be specified to the datarecording.

9.1.Historical Types

The Historical can be created in two different ways: Continuouns, which store thedata continually during the application running (e.g. recording of a cold chambertemperature every ficteen minutes) or in Batch, in case of lots (e.g. recording ofseparate oven temperatures according to production lot code and operator name). Inthe Batch, the data is stored with one or more references, associated to a header of theHistorical in which a Batch can be found. In order to be started (StartBatchProcess())or completed (FinishBathProcess()), the batch processes need special commands, viasome script.

To create or edit a Historical, we need ro select the item Historical in the Organizer.When a new one is created, it will be displayed below this item in the applicationtree.Selecting a specific Historical, its properties will be displayed in the right side of thetree.

Capítulo

9. Historical

T



In the set up pages we have:

FIELD DESCRIPTION

Name It defines the Historical name that will be used in the Organizer tree andin the Scripts (it can be changed in the running).

Description It is a brief description about Historical.

Analysis It allows the visualization of the Historical data in graphic form. You cancall Historical Analysis during the running through the Analysis()function of the Historical.

Update File It updates the Historical File Structure when some change takes placein the Historical set up.

SPC It calls the Processes Statistic Control (CEP) in order to proceed astatistic Analysis of the Historical Data.

Filename It defines the file name to the current Historical.

Write time It defines the frequency in which the data will be written in the Historicalfile.

Max Records It defines a maximum number of registries to the Historical file. TheHistorical file is rotative, that means, when the data exceed the file sizethe registries will be displayed.



Enable Historic atapplication startup

It enables the Historical file writing from the start of the applicationrunning, according to the defined rate scan. Keeo this option disabled ifyou want to control (using Scripts) the creating of Historical datamanually.

Batch process It defines the Historical type as being Batch. When this option isenabled, a Header file (HDR extension) is created with the same nameof the Historical file. The Header file keeps the information about eachbatch.

Network support It enables the network support to the Historical, that is, it allows that theHistorical be accessed (only for reading) by other Elipse applications inthe Network, through a Browser or Report of the Historical Analysistype. This option also makes that each change in the Historical beimmediately recorded, not allowing the operational System to perform a

priorities.

After the historical type set up, we must add the tags in the Historical that will bestored, which is made in the tags table. To each added variable we must establich thefield format, which can be:

Type Numerical Capacity Size ( Bytes )

Char -128 a 127 1

byte 0 a 255 1

short -32768 a 32767 2

word 0 a 65535 2

long -2147483648 a 2147483647 4

dword 0 a 4294967296 4

Float 3.4E +/- 38 (7 digits) 4

Double 1.7E +/- 308 (15 digits) 8

Datehour 1/1/1970 a 05/02/2036 8

String - Field size.



When you choose the historical of Batch type, it will be created another itme in theHistorical object, called Header that can be acessed via Organizer. Tags must beinserted in the header, and their values will be used to identify each one of the batchprocesses.

Following the given example about the oven temoerature storage, where we would liketo have a reference via lot code and operator name. So, there must be in yourapplication two tags, code and operator, that will be inserted associated to the headeritem, and will have their value recorded in the batch beginning and, so you can identifyit.

The header data are registered in a file with HDR extension, with the same name of thehistorical data file name (e.g. If you informed HIST1.DAT as historical data file name,it will be created HIST1.HDR).

There must exist in the header at least one tag, set as string field (text), so that the batchsearch can be made.

9.2.Historical Analysis

Automatically, when a new historical is created, a historical Analysis object is obtainedas a subitem. This object can be created separately in the report item, in order toperform different Analysis in the historical file that is being created, or even in otherfiles that were not created by this application. In the Analysis, the objects plotter (that isthe graphic formation) and Query, that deals with the data filter that will be applied infile to be visualized, are included.



FIELD DESCRIPTION

Name It defines the Historical Analisys name that will be used in theOrganizer tree and in the Scripts.

Title It defines the title to be displayed in the Historical Analysis window.

Analysis It allows the visualization of the Historical Analysis data in graphicform. You can call Historical Analysis during the running through theAnalysis() function of the Historical.

SPC It calls the processes Statistic Control Cep (CEP) in order toproceed in the Historical Analisys of the Historical data.

Show Property pages It defines the Property pages to be displayed in the HistoricalAnalysis window:

All pagesOnly the Analysis page (Graphic)Selected pages (only the selected pages)

Dialog Type It defines the dialog type of the Historical Analysis:Modal (it does not allow to access any other windowbefore being closed)Modeless(does not need to be closed to access otherscreens)

Styles It defines the Style of the Historical Analysis window. Scalable font,Minimize Button, Maximize Button.



9.2.1.Analysis Setting

We can the Analisys way of work through the Graph, Pens, Pen Colors, Settings,Wuery and Setup Printer pages that are usual in the objects that consult thedatabases. We make here a brief explanation about two pages: Setting and Query.

SETTING PAGE

FIELD DESCRIPTION

Source Filename It defines the source file name to the Analysis (DAT extension). Incase of being used for other objects (Reports, Browser) it can bespecified in the Header (HDR extension).

Browser It allows to find the source file to be used.

All Batches It selects all the batches to be printed. This option is available only ifthe source file (Source Filename) is a Historical file with an enabledbatch process.

Last Batch It selects the last batch to be printed. This option is available only ifthe source file (Source Filename) is a Historical file an enables batchprocess.



Specific Batch It select a specific bacth to be printed, as specified in the Field andCriteria. This option is available only if the source file (SourceFilename) is a Historical file with an enabled batch process.

Field It lists the field available to a specific batch selection. Only string typefields will be listed.

Criteria It defines the value to be searched when a specific batch is selected.

QUERY PAGE

It allows to define a time range to select the file data to be visualized.

FIELD DESCRIPTION

No query date A filter will not used, that means, it selects all data. Select this option if thehistorical must visualize all the file data.

Time range It selects the data within a specified time range. It must be provided theinitial and final search date.

Newest data It selects only the new data. Use this option when the historical mustshow the last acquisition in a specified period. The options shown herecan be changed in running through the query properties, available in theOrganizer.

Initial date It determines the time range initial day.



Final date It determines the time range final hour.

Initial time It determines the time range initial hour.

Final time It determines the time range final hour.

Last It defines the unity number used to select the most recent data.

Last/Units It defines the used unity to select the most recent data.

There are other objects that can also work with the data files created by the historicalthat are the Alarm screen objects, Browser and Historical trend, and the text Report,graphic and Historical Analysis.

Drill:

Task: To create a historical object for continuous recording.

Procedure: From the Organizer, create a new historical, with the name Hist1. Specifythe file name as CONTINUO.DAT, writing time of 1000 ms, register maximumnumber: 1000; enable the recording by scan, and in the query page, with no data query.In the tags table, insert the level and temperature tag.

Task: To create a button in the screen, calling the function Historical Analysis..

Procedure: In the F5 button, Analysis in the Dosage Screen, choose the momentarytype. Create a script OnRelease to the button, inserting the function Hist1.Analysis().

9.3.Tips and Optimization

DATA FILE SIZE

The historical file size that will be created can be calculated as follow:

Data File Size= Header size + Register size * in a Register

Header Size = 24 + in Fields * 40

Register Size = 2 + sum of Field Size.

The 2 bytes that are added correspond to the CRC16 type examine, present in eachregistry.



MAKING RECORDING PER EVENTS

To perform the event data recording, you must disable the historical and start theapplication (option in the general page). So, the data will only be registered in a clearrecording command, that must be done through a script. There are two different waysin scripts that can perform such operation, as listed below, supposing that Hist1 is thename of our historical example.

Hist1.Open()

Hist1.WriteRecord()

Hist1.Close()

Ou

Hist1.enabled=1

Hist1.WriteRecord()

Hist1.enabled=0

Basically, both perform the same operation, but the second one enables it to recordingby time, while the enabled property is in 1. The writing command, WriteRecord(), obtainsan updated value of the tags that are associated to the historical, creating another dataline.

TIME INFORMATION IN THE HISTORICAL

Each data registry that recorded has, as a patterm, a time information, that is theDataTime field, with 8 databytes (64 bits). Usually, when a data is recorded, thecomputer watch is consulted, and the obtained information is insert in that data linewith an accuracy of 1 millisecond. You can stipulate, however, another date andhoursource. When clicking in the historical object in the Organizer, all the data fieldassociated to it will be displayed below. The first one will always be the DataTimefield. Clicking over this field, there will be the possibility to associate a tag or property,through the tag table. In this case, it can be associated to the property TimeStamp ofany tag, in case the equipment with which there is information being exchanged, givesupport to the information sending from its local watch. So the data value recorded in

HISTORICAL TREND

The screen object trend graphic, when previously set as historical trend, can visualizethe historical data as well as the analisis. The objects associated to the trend, in this case,are not the tags themselves, but the historical fields that that are created when tgas areassociated to the Historical.



To choose data about the file to be associated to the trend, as well as the query manner,a Query page that can be acessed in the trend Advanced page or via OrganizerScreen trend Object is created. The criteria settings are the same already described.

The pens association to the field is done by clicking over the field Axle Y and/or AxleX in the Pens table, acessed by the Trend properties. Clicking over this field, alist withthe historical field names will be displayed.

To make the trend serach the data in the disk or to update its data, it is necessary, viasome script, to run its function UpdateQuery(). If you want that to happen in the fixrange, just insert this command in the script WhileRunning in the screen, informing itsrunning time in milliseconds in the script.

DATA COLLECTION MANNER OF THE TREND GRAPHIC

Through the Advanced page of the trend object we can determine the data collectionmanner. The Real Time first option does that the trend only collects data when thescreen is open. When calling it again, it will be dispalyed clean. The second optioncauses the communication with its tag to take place independently of the screen; so,when you call it, the data will be already loaded. The thrird option, historical trend,allows to recover the data after the computer is off, or even to spread the same datarecorded in disk the historical object. For that, the objects associated to the trend arenot the tags themselves, but the historical field, as it has been already mentioned.

INSERTING MARKS IN THE TREND GRAPHIC

Through the Pens page of the Trend object, we can associate marks ti the graphic, thatcan be vertical, horizontal or point (marks) lines. Each mark can be associated to a tagor property, or even be modified via script.

BROWSER

The browser screen object has the same characteristics of the historical trend, but itshows the data of the text mode, not graphically. The browser does not update its dataautomatically, so you must run the function UpdateQuery() through some scriptwhen you want the update to take place.

This object also to define some properties, such as line numbers that can be visualized,the line that is selected by the user, and son on, besides allowing each field format thatwill be visualized. The Browser also allows the visualization of the batch file, throughthe specification of the correspondent HDR file in the setting page.



9.4.Drill

Task: To create a historical onject with recording by Batch.

Procedure: From the Organizer create a new historical, with the name Hist2. Specifythe file name as BATCH.DAT. Select the historical as batch. In the Header item thatcan be accessed via Organizer (inside the object Hist2), and associate the tag Code(that is the product code) such as a string (text) of 10 characters, and the propertyApplication.Username, as we will see later, is the name of the user that is logging inthe system, also as a string of the 10 characters.

In the Tags table in the object Hist2, add the level and temperature tag.

Task: To set the screen for bath dossier.

Procedure: Insert 3 buttons in the bath screen of momentary type to run three basictasks of the batch, that are star, finish, and restart. Such actions could be run via somesignal coming from the field, although, for test effect, we eill do it manually through the

first one, create a script OnRelease, to the button, running the functionHist2.StartBatchProcess(). For the second one, Hist2.FinishBatchProcess(), and for th thirdHist2.RestartLastBatch().

Task: To create a procedure in the same screen mentioned above, through the use oftwo Browser objects, a system for choosing Analysis by batch.

Procedure: Insert in the bath screen, two Browser objects. In this example, theBrowser will allow choosing the batch that we want to visualize through navigating inthe HDR file. So, the first one must be associated to the file BATCH.HDR(FINDTHE FILE BATCH.DAT, AND THEN CHANGE THE EXTENSION TO.HDR). In the Query page select no data criteria, and in the databases page, click in the

and in the field Application.UsrName

In the second Browser (Browser2), do the association to the data file BATCH.DAT.In the settings page, choose the specific batch option.

Create a script to the Browser, that will be run by pressing the mouse left button twice:

Script OnLButtonDblClk

Header.Open()



Header.GoTo(Browser.curSel)

Header.Edit()

Browser2.Consulta.criteria=Header.Code

HAnalysis.Consulta.criteria=Header.Code

Header.Close()

Browser2.UpdateQuery()

Basically, the script above opens the HDR file in the same line where the user isclicking in the screen. Soon after that it will be pointer as search criteria to Analysis andfor the Browser2, the batch whose code is being visualized by the operator.

The object Browser does not have data update, that means the data file is notreconsulted automatically in regular ranges. This task is performed only when openingin the screen that has the object, or yet, through an update function called UpdateQuery(),that is present in the last line of our example.

To the second button (Finish) we can add the function UpdateQuery() so that whencompleting the batch, the browsers will be update. In this case this button script wouldhave the following setting:

Hist1.FinishBatchProcess()

Browser1.UpdateQuery()

Task: To create in the same screen above a set point for keyboarding the product code.

Procedure: Insert in the dosage screen a set point object, choosing in the format pagethe data with the text type (String). In the tags table associate it to the Tag Code.

R E L A T Ó R I O S


He reports allow to perform the historical data, header and alarm printings, aswell as the immediate data.

There are four types of reports:

Text Report: It can make the data printing in the line and column formatincluding the alarm files. It also allows the printing to filling in disk.

Graphic Report: It makes the graphic printing of the historical data, with thecreation of subtitles.

Form: Use this option to print a form with any texts, momentary values ofvariables and bitmaps.

Historical Analysis: Screen report for visualization/printing of data in thedisk. Use this report when you want to hav several analyses for each file, oreven to remote data analysis, created by other applications.

All the reports have Query table for the specification of the data search range, andthe Setting table to choose the data and batch files, if this option is enabled.

10.1.Drills

CREATING ALARM REPORTS

Task: To create a text type for the alarm printing.

Procedure: Specify the Report1 name, file: ALARMS.DAT, criteria selected by dateand hour.

Task: To create a screen for printing range.

Capítulo

10. Reports

T



Procedure: To create a new screen, window type. As background bitmap, insertLIB\ELECTRIC\DATAHORA.BMP.

HOW TO CHOOSE DATE AND HOUR BEFORE THE PRINTING

There are two ways of performing this task:

a) To create a button, in the screen, whose script OnRelease() will call a setup functionof the report query. Example: Report1.Query.EditProperties().While running a window,similiar to the one in setting, will be displayed.

b) From the bitmap onserted in our printing screen, insert 12 setpoints that will allowto choose the initial and final ranges. Each setpoint will associated to one of theproperties:

Report1.Query.StartHour

Report1.Query.StartMinute

Report1.Query.StartSecond

Report1.Query.StartDay

Report1.Query.StartMonth

Report1.Query.StartYear

Report1.Query.FinalHour

Report1.Query.FinalMinute

Report1.Query.FinalSecond

Report1.Query.FinalDay

Report1.Query.FinalMonth

Report1.Query.FinalYear

PRINTING FOR DISK AND FILE

Task: To create bitmap objects for printing.

Procedure: Insert two objects bitmap type, in the inferior borders in the screen. Thefirst must be associated to the bitmap LIB\UNTIL\DISQUETE.BMP and thesecond, LIB\UNTIL\IMPLYES.BMP. To create a script for the mouse left button asfollows:

OnLButtonUp

\



This scripts uses the printing fuction for file, calling theReport1.PrintToFile(file,bImprimeHeader,burster,bIndicarProgress), where the file isthe file name to be printed in the disk, bPrintHeader enables printing the Header,buster is a string used to separate the fields in the printing, and bIndicar Progress showsa window with a progress indicator.

For the second bitmap, a script as follows:

OnLButtonUp

Report1.Print()

PRINTING FILTERS

Together with the previous functions we can use the functionAddFilter(field,valueLow,valueHigh) before printing, to use a filter in a specific field,together with the date, where the field is the historical field where you want to applythe filter; valueLow and valueHigh are the limit values, within which the print will be

HOW TO PRINT A SCREEN

For that, just create a report of format type, inserting a bitmaps sole object, occupyingthe whole page extension. Name the bitmpa as Bitmap1, and the Form as Form1.

Assume that you establish the screen ALT+S to perform the printing. Follow the nextsteps:

Procedure: Go to the screen setting(if you want the print just in one page) or to theapplication (if you want in all screens). Choose the scripts page, New, typeOnKeyRelease. Click in the capture button and press the keys ALT+S. Now the scriptis created

In it, key in or capture through the App Browser the following functions:

CaptureScreen("c:\teste.bmp")

Form1.Bitmap1.bitmapName="c:\teste.bmp"

Form1.Print()

HOW TO CHANGE THE PRINTER AND RECONFIGURED THE REPORTS

When the reports are saved in the application they have information about the printerpage, and so on. When you change or modify some data about the printing, these datamust be reconfigured.



When selecting the item Reports via Organizer, the reports already created for thatapplication and the registered printer list will be displayed as a subtem. You candetermine a certain report to use alternatively a printer or other of the list, dependingon the desired conditions.

You can associate for example, the Report Form1 to the Printer. While running, thefollowing properties can be changed.:

a) Change the report printer Form1 from Printer to Printer2. (done through the Reportproperties edition)

b) Change the Printer of a certain physical printer model to the other. (done throughthe Printer properties edition).

Task: To create in the printer setup procedure.

Procedure: Inserta bitmap object, with the file LIB\UNTIL\TOOLS.BMP. Selecttransparent, with background light green. To create a script OnLButtonDown:

Form1.SetupPrinter()

Form1.SaveCfg("c:\printer.ptr")

Create also a script in the Application, OnStartRunning, so that when you restart thecomputer, the data about the printer also be reloaded.

Form1.LoadCfg("c:\printer.ptr")

ADITIONAL DRILLS

To create additional buttons to call another reports:

Text report to historical data printing;

Graphic report to same data printing;

From to momentary data printing.

R E C E I T A S


Recipe in the Elipse Scada can be considered as a model that contains aceratin number of variables that can have values manipulated by tags,planning to save/loading the disk or read / writing its values in theequipment.

When creating a new recipe from the Organizer, a Model is being specified. Themodel corresponds to the specification of the tags set.

The tags make part of a model will have one or move value sets that can be read orwritten.

11.1.1.Recipe General Properties

Each recipe that you create for an application is displayed below the recipes option inthe application tree in the Organizer. Once a specific Recipe is selected, its propertis aredisplayed in the right side of the tree.

The Recipe General Propertis page is dispayed when the general tab in the top of therecipes is selected. This page is displayed below and its respective fields are described inthe following table.

Though the tags pag we can associate the tags that will be part of the model that we arecreating.

Capítulo

11. Recipes

A

R E C E I T A S


FIELD DESCRIPTION

Name It defines the Recipe Model name that will be used in the Organizer treeand in the Scripts.

Description It is a brief description about the Recipe Model.

Recipe File It defines the file name to the current recipe model have up to 8characters, and it must not have the extension (Elipse Scada willalways use the RCP extension). You can also specify the file path that

CIPE\Locations are not recommended if you want to copy your application toother computer.

Edit selected label It allows the label edition of the selected Tag in the list below. Label canbe understood as a tag nickname, so that its identification in the recipeis not necessarily the same as the tag name, in order to make theoperration easier.

Edit Data It opens the window Edit Recipe where you can set the recipe definingthe tgas values to be recorded in file.

Labels It shows the labels associated to the tags of the current Recipe Model.

R E C E I T A S


Tag It shows the tags associated to the current Recipe Model. You can addor remove tags in the Tags page of the Recipe.

11.1.2.Editing Recipes

This window will be displayed when pressing the button Edit da in the RecipesGeneral properties page.

Each Recipe within a Recipe Model will be displayed in the list of the combo boxbeside the Recipes field. Selecting any Recipe in the list, you can edit its descriptionand the value of each Tag.

FIELD DESCRIPTION

Recipes It allows the selection of a current Model recipe. You can add a newRecipe by pressing the button New Recipe.

Description It is a brief description about Recipe.

New recipe It creates a new recipe, adding it to the current Model Recipe list. Eachrecipe Model can have several Recipes.

Delete recipe It removes the selected Recipe from the list.

R E C E I T A S


Edit field valuehere

It allows the tag value edition to the current recipe. Use the directionarrows of the keyboard or the mouse to select the tags to be edited.

Recipe data It lists the value of each Tag of the current Recipe.

Drill:

Task: To create a recipe model for product register.

Procedure: In the recipes item, create a new recipe, with the name Model1. Specifythe file MODEL1.RCP, and associate the tags Water, Sugar, Syrupe and Glucose.Click in the fields of each one of the tags, and replace the label value: for Water--------------- , Sugar---------------- Syrup--------------- and Glucose--------------

Now click in the field Edit data, where a dialog box for registering (off-line) the severalrecipes (value set) that can be associated to the tags will be opened, besides the name ofeach recipe.

At this moment, the recipes are already created, but we did not create the manipulationmethods of the running value yet. For such purpose, we can the screen recipes.

Task: To create setpoints for values keyboarding in the screen Recipes.

Procedure: To create in the recipe Screen 5 setpoints for keyboarding/visualization ofvalues in the tags Water, Sugar, Syrup and Glucose, and another setpoint associatedto the tag Code (this last one necessarily in String (text) format).

Task: To create in the screen Recipes the procedure for recipe manipulation.

Procedure: To create in the screen Recipes 5 buttons, which will run the scripts inorder to perform basiz tasks with the recipes that are:

Selecting and Loading: It allows at choose, model1.rcp, there can be several recipes,that means, several values sets. Through a selection procedure, we choose whichrecipe we want to manipulate. For such, we need to obtain a number that is theposition in the file or a recipe number, which will be stored in the tagnumber_recipe.

The line above makes a window to be opened in order to choose the desiredrecipe. Adding the next lines in the same script will make the selected recipe to beloaded, choose name will be copied to the tag Code.

R E C E I T A S


Recipes.Model1.LoadRecipe(Tags.Products.number_recipe)Tags.Products.Code= Recipes.Model1.GetRecDescription (Tags.Products.number_recipe)

Create a New Recipe: It allows opening a new register or a data set in the filemodel1.rcp.

Tags.Products.number_recipe=Recipes.Model1.CreateNewRecord(Tags.Products.Code)

Delete Recipe: From the register number of a recipe we can withdraw it from thefile model1.rcp.

Model1.DeleteRecipe(Tags.Products.number_recipe)

Another suggestion to delete a recipe can be as follows:

IF MessageBox("Do you really want to Delete the recipe?","Delete recipe",0124h)==6Recipes.Model1.DeleteRecipe(Tags.Products.number_recipe)Recipes.Model1.LoadRecipe(1)Tags.Prodcuts.Code=Recipes. Model1.GetRecDescription(1)ENDIF

The MessageBox function is used to make sure the user wishes to delete the recipe.This function is present in the Global Manager and is used as a dialog interface withthe user, when some information or intervention is necessary. Besides that, this manneralso loads the first recipe, so that the setpoints do not keep the values of a recipe thatno longer exists.

Edit Recipe: It is a ready function, present in the software, that replaces theprevious procedures. It opens a pattern window, where the user can create, editor delete recipes. In the case of this example, we will allow the data manipulationin two manners: either through the edit pattern window or through the setpoints.

Recipes.Model1.EditRecipe()

Save Recipe: It allows to load values, present in the tags, for a recipe or position inthe data files, in order to store them. For such task, we need to inform the recipenumber that must be previously created..

Recipes.Model1.SetRecDescription(Tags.Products.number_recipe, Tags.Products.Code)

Recipes.Model1.SaveRecipe(Tags.Products.number_recipe)

Other interesting characteristic in the recipe model is that the same data file created by arecipe or template can be used by another recipe, since they have the same number ofassociated variables.

R E C E I T A S


This allows to load a recipe file in other variable set that are not field variables, allowingthe preparation, in a separate process, of forms and so on, which will be used by theoperator later.

RETAINING TAGS IMPLEMENTING

This tip shows how to implement tags with persistent value, that is, the tag value isregistered when it exists the application, and loaded when the application is run again.

Create a new recipe model (name = recipe) and associate to it the tags and propertiesthat you want to recors.

In the script OnStartRunning of the Application, or even through any other procedure,in which you want to guarantee that the files will be recorded, add the following lines:

IF Recipes.Recipes1.GetRecCount() > 0Recipes.Recipes1.LoadRecipe(1)

ENDIF

In the script OnStopRunning of the Application, or even through any other procedure, inwhich you want to guarantee that the files will be recorded, add the following lines:

IF Recipes.Recipes1.GetRecCount() < 1Recipes.Recipes.CreateNewRecord("Persistent Tags")

ENDIFRecipes.Recipes.SaveRecipe(1)

By doing so, every time the application is finished the tags values are saved in the firstregister (SaveRecipe(1)) of the recipe file. When running the application, it is verified isloaded (LoadRecipe(1)).

S E N H A S


His feature allows to control the access to the Screens through list of names,in which a password, a login and a safety level are attributed to each name.

It in the Screen specification, in the access level field a number different from0 (0 releases the access to all the users) is specified, it is necessary a user to be logged in,and that its safety level allows the access to the Screen.

According to the assigned access level, each user will have some functions available.The user with level 1 is considered a superuser, and when he is logged in he can,through the UserAdministration() function, create, change and remove the attributes ofall users.

By means of the same function, the other users can change their password bykeyboarding the old password and by double validating the new password.

The passwords and levels are recorded on an encrypted and independent file in theapplication directory.

In order to the user be logged in the System, the function Login() must be forcinglyexecuted. In case there were an user already logged in, this function will first provide alogout of the former user through the function Logout() and then a register of the newuser.

Drill:

Task: To create users and register them.

Procedure: To create users with various access levels in the system screen except forthe Openning screen, which will have free access to all users.

Task: To create a Login procedure of the user in the Opening screen.

Capítulo

12. Passwords

T

S E N H A S


Procedure: In the login bitmap object in the opening screen, create a scriptOnLButtonUp, running the function Application.Login(), present in the Application.

Task: To create a password maintenance procedure.

Procedure: In the login bitmap object in the opening screen, create a scriptOnLButtonUp, running the function Application.Login(), present in the Application.

Task: I

Procedure:Insert a display in the opening screen, over the toolbar, and bring it to thefront. Set the font Arial Regular 10- black, left alignment. In the prefix field key in

ags table associate Application.UserName. Also insert a displayshowing the user level access, via property UserAccessLevel.

Task:

EXTRA DRILLS

Task: To use the Message Box functions and create the verification of users logged ornot.

Task:

Procedure:through marking a high alarm in 1 to it. Using the script OnUser of the Applicationperform the following script:

user=1user=0

Remark: the alarm of the variable user must be marked with different prioritycompared to other alarms in the system.

D A T A B A S E S


He Databases option of the Elipse Scada allows to create and manipulate oneor more databases using the Windows ODBC, that allows the connectionwith an already created databasis or to create a new one from an assistantinside the software.

To create a new connection with a new table:

Choose the ODBC driver that you want to use;

Set the connection and the file or directory name that contain data;

Create each one of the fileds, choosing name, data type and syze.

In the Organizer the new table and its respective fields will be displayed, which can bechanged using the special functions of the ODBC in the Scripts:

Create a new connection with the already existing databases:

Create the databasis. In the Excel case, you must use the first line of eachcolumn as a field name;

Close the databasis;

In the Organizer, in Databases, choose Connect to an existing table,press the button New and choose the driver ODBC that you wish to use;

Choose the directory where the databasis is;

The table and its respective fields must be displayed in the tree.

Manipulate the data through the function ODBC

Consult the Advanced manual for further information about Databases.

Capítulo

13. Databases

T

A P L I C A Ç Õ E S R E M O T A S


He Remote Application are used to connect two or more applications that arelinked via local network, modem, serial cable or optical fiber. In order to usethis resource, you need to specify at least one server station and one datacustomer, beside a network driver that will be responsible for the information

exchange.

The following communication drivers are available:

DRIVER DESCRIPTION

Ipx.dll / Ipx32.dll It allows the communication on a network that uses the Novell®IPX/SPX protocol

Tcpip.dll /tcpip32.dll

It is the faster and most used driver. It is necessary to install a TCP/IP

Serial.dll /serial32.dll

It is used for serial or optical fiber communication between twocomputers; the physical environment must be full-duplex.

Dialup.dll /dialup32.dll

It is used for connection via dial line

The basic procedure for creating a remote application is by specifying a serverapplication and one costumer.

In the server application, you must set the network driver, whose procedures can be

In the customer application, you can start, for example, from the server application and

remote tags. Remember that when it is necessary to change the type of a tag we can use

with Block Elements and Remote Tags. When changing a tag to block element, theuser informs in which Block the elements will be inserted; when changing a tag toremote, the user informs in which Remote Application or remote Tags Group the new

Capítulo

14. Remote Application

T



tag will be inserted; when changing the Block Element or Remote tag to another tagtype, the user informs which one is the destiny tag group. Also, when a tag type ischanged to Remote Tag, the Elipse copies the name and the full path of the original tagto the original tag name field in the Remote Tag. Besides that, when a tag type ischanged, some properties or functions are verified to know if they will no longer existsafter the type change, if that happens the change is aborted and a message is displayedto the user.

Desides the remote tags, files can be transferred. The Elipse Scada uses a ressource thatoptimizes the file transference process, for it is able to transfer only the changes of thesame file from one station to another.

FILE TRANSFERENCE EXAMPLE

Here isn an example of application to the trasnference between two applications.

Task: To create a specific screen that will display the transmission progress and itsstatus. The button can call the screen called Transf_file.

Script OnRelease

Transf_File.Show()

File_Remote1.GetFile("C:\Elipsew\Test.dat","C:\Elipsew\Test.dat")

Task: To create a tag expression, with the name transf01, whose content will be andoperation between two properties of the remote file.

(File_Remot1.bytesDone/File_Remote1.totalLength)*100

This tag will display the bytes percentage that had already been transmitted in realationto the total.

Task: to create the screen Transf_file to visualize the transference.

Procedure: To create a graphic with horizontal bars associated to the tag transf01. Tocreate another three text objects, with message zones, in order to visualize the followingproperties:

: It shows the connection status: 0 - Disconnected, 1 -Connected or 2 - Connected.

: It shows the transference status: -1 without transference, 0default, 1 sucessful.

: It shows the file total bytes.



A suggestion for the screen final result can be as follows:

O T I M I Z A Ç Õ E S


O run the setting tasks in the shorter time possible and to obtain a betterperformance in the Application running, we listed here some useful tips:

1. Communication Speed: Try communicate with the data acquisitionequipment in higher rates, once there are no communication problems. In general,dealing with serial communication, the Windows supports sommunication in19200bps, which is preferred in relation to 9600bps.

2. Communication Try number and Scripts OnCommError: In thecommunication driver settings, in the option Retry Default Communication itsis not advisable to run a high number of tries, once the equipment presentscontinous communication errors, it is necessary to revise all the communication,from physical connections to the communication driver. Just raising the trynumbers makes that each tag read be retried in number of the times before thesoftware recognize the communication error, what degrades the communicationperformance as a whole

1) To ver:ify and manage with a better effectiveness the communicationerrors the Script OnCommError in the Driver object can be created,which will be called when any communication error takes place.

2) To manipulate the errors, some of the driver functions can be used,such as:

GetErrorInfo(param)It returns the information about the last occurred error. If stop=0, it returns the

returnd the parameters N1 to N4 or B1 to B4 of the PLC tag or Block that caused the

of the PLC in the network, it is possible to know which equipment is with defaults..

AddFilter(strFilter)Add a communication filter in the Driver, disabling the readings or writings in tags thathave parameters specified in the filter. Thus we can disable the communication with a

Capítulo

15. Otimization

T



specific maintenance equipment, for instance, avoiding errors while while it isdisconnected.

RemoveFilter(strFilter)It removes the filter that was added with AddFilter(strFilter).Example: Assum that we are using the Modbus driver, whose parameter N1 indicatesthe PLC address in the network. A script suggestion would be as follows:

To create a tag of RAM type called ERROTo create a script OnCommError in the communication driver:

ERRO=Driver1.GetErrorInfo(1)Driver1.AddFilter(Str(ERRO,2,0))MessageBox("Ocorreu um erro no PLC: "+StrZero(ERRO,2,0),"Communication error",0040h)

3.: Try to correctly set these parameters in their tags.

The normal procedure is that if a variable must be normally searched, the scan andautomatic reading options must be enabled. If you want to directly control thewriting and reading through the functions Read() and Write(), leave all the optionsdisabled.

4. Tags Advice: Elipse accomplishes optimization in the communication, in order toavoid that the variables be communicated with out reason, through the use of theproperties advise, that indicates if any module (screen object, alarm, historical,report, script, and so on) is in need of the variable update value. Thus a tag thatisnot being used by any object will not be read. If you wish the tag to be readindependently of being used or not, you must, for instance, enble the alarm or evnto force its reading through the function Read() of the tag. In the case of theexpression tags, always that a variable is changed, the tag will be evaluated again, ifit is in the advise mode. On the contrary, it will only be evaluated when somemodule requires its value.

5. How to set up screen objects to improve its performance: Objects such astrend graphics can perform the data collection in background and redraw thegraphic in higher ranges, without lossing the collection. Thus the trend refresh timecan be longer yhan the scan of the variables without damagingits content. Anotherconsideration about the screen object is related to the animation object, when thetransparent spends more processing time then the normal animation.

6. Memory: The RAM memory quality necessary to good perfornance of its systemdepends on the application size. Usually, each application item spends around2kbytes. To know the total item of your application, press the key



Ctrl+Shift+Alt+I. If your machine is limited, you can decrease the requiredmemory quantity, working with lower resolution draw (16 or 256 colors), andcreating animation only in the areas that will be animated..

7. Tie Optimization: If your do not need to align several ties, choose to separatethem, so the script will have a better performance. Example:

Ex :For ...

For ...Next

NextUsually is slower than:

For ...Next

For ...

8. Creating shortcuts for an Elipse application: The Elipse Scada 2.0 installmentautomatically registers the files with APP extension. Therefore, the Elipse Scadaapplications can be automatically run with a double click over the createdapplication.To create an access icon (shortcut) in the desktop (work area), justfind the program (in the explorer or file manager) in the directory or work folder

9. Y2K: The Elipse Scada registers the dates using a format that assures thenormal operation of the software to the next millenium without changes orcharges.

10. Manipulating dates in the ELIPSE: The Elipse uses the JULIAN calendarto manipulate dates, in such case the Y2K is avoided. You can use theproperties day, monyh, year, hour, minute and second, or through the attributecurrentTime. To show a date in any screen format, just insert a displayassociated to the property currentTime, and choose the format as Date/Time andclick in the format button.Observer that the mentined parameters return the current date of the system,are constantly updated and could be replaced by a value (absolute date) of adatabasis (ODBC).

11. Organizing the Object Tabs of the Elipse: By using the Tabs key it ispossible to move an object, such as a Setpoint, for instance, to next object of aseries.



Initially, the shifting through the Tabs follows the object creation order in thescreen. However, it is possible to easily change this order with a little trick;

Select the objects in the desired Tab order.Press the "Bring to Front" or "Send to Back" buttons.

12. Faded Pictures (bitmaps): If you wish to transport an application toanother machine, and the picture fade, the following steps can be taken:

1) Open the explorer.2) In the menu View, click over the option Options.In this dialog

box, DESELECT the option HIDE MS-DOS files extensions toregistered files.

3) Close the dialog box.4) Return to the Elipse and reopen the application. The bitmaps

must be displayed again.

13. Driver Files do not Appear: If you try set a new communication driver inyour application and you can not find a file, the reason must be the WindowsExplorer that is set to hide files with DLL extension. To solve this problem,follow the next steps:

1) Open the explorer2) In the menu View, click over the option Options or Folder

Options3) Select the View table, and in the option Hidden Files choose

Show all files.

14. To show Video Images: The nnew video object allows the camera videos orTV images ro be displayed, you need to have a video board with input fortheses signal. The resolution is defined by the size of the object placed in thescreen, with a frequency of 30 frames/second. To know more about the video

A N E X O S


16.1.Driver Klockner Moeller

File: KLOCKNER.DLLManufacturer: Klockner MoellerEquipment: PS3, PS4-100, PS4-200, PS306, PS316 e PS416Release: 30/05/97

This driver is set to work with all the Klockner Moeller PLC.

Parameters (p) of the Driver communication:

P1 serial port:0 = COM11 = COM22 = COM33 = COM4

P2 transmission velocity0 = default (9600)1 = 1200 bps2 = 2400 bps3 = 4800 bps4 = 9600 bps5 = 19200 bps

P3 timeout time (in centesimal)0 = default (20 centesimal)> 0 = new timeout

P4 eco1 = yes0 = no

Capítulo

16. Exhibits

A N E X O S


Parameters (n) of address to Tags of PLC type:

n1 clp numbern1=3 PS306, PS316 or PS416n1=5 PS3 or PS4-100n1=7 PS4-200

n2 variable typen2= 0 reads byte low of the addressn2= 1 reads byte high of the addressn2= 2 reading/writtingof the address wordn2= 3 reading/writing

n3 variable address (it must be even)For n1=3 or n1=7: MW wanted (0, 2, 4, ...)For n1=5 use the memory physical address (See Address Tables below in decimal)

n4 in the bit position in the word (0-15), when n2=3

Parameters (b) of address to Tags of BLOCK type:

size: block sizeb1 CLP numberb2 initial address (even)b3 - words numberb4 not used

Address table PS3/PS4-100 (Klockner documentation):

Address type n2 Symbol DesignationAccess Physical (hexa)---------------------------------------------------------------intern RAM---------------------------------------------------------------

L 0020 IB0.0 Digital input - masterL 0021 IB0.8 Digital input - master

E 0022 QB0.0 Digital output - masterE 0023 QB0.8 Digital output - masterL 0024 MB0.0 Check Byte - masterL 0025 MB0.8 Check Byte - masterL .... ..... ...

A N E X O S


L 002B MB3.8 Check Byte - masterL 0035 Status word - masterL 0036 Status Word - master

---------------------------------------------------------------

External RAM---------------------------------------------------------------

L 4E85 Status word - 1. slaveL 4E86 Status word - 1. slaveL 4E87 Status word - 2. slaveL 4E88 Status word - 2. slaveL 4E89 Status word - 3. slaveL 4E8A Status word - 3. slaveL 4E8B Type - master

L 4E8C Type - 1. slaveL 4E8D Type - 2. slaveL 4E8E Type - 3. slaveL/E 5E00 IB1.0 Digital input - 1. slaveL/E 5E01 IB1.8 Digital input - 1. slaveL/E 5E02 IB2.0 Digital input - 2. slaveL/E 5E03 IB2.8 Digital input - 2. slaveL/E 5E04 IB3.0 Digital input - 2. slaveL/E 5E05 IB3.8 Digital input - 2. slave

L/E 5E06 QB1.0 Digital output - 1. slaveL/E 5E06 QB1.0 Digital output - 1. slaveL/E 5E06 QB1.0 Digital output - 1. slave... .... ..... ...L/E 5E0B QB3.8 Digital output - 3. slaveL/E 5E0C MB4.0 Check Byte-masterL/E 5E0D MB4.8 Check Byte - master... .... ..... ...L/E 5E47 MB33.8 Check Byte - master

L/E 5E4C IA0.0 Analogic input 1 - masterL/E 5E4D IA0.1 Analogic input 2 - master... .... ..... ...L/E 5E6A IA3.2 Analogic input 3 - slaveL/E 5E6B IA3.3 Analogic input 4 - slaveL/E 5E6C QA0.0 Analogic output - masterL/E 5E6D QA1.0 Analogic output 1. slave

A N E X O S


L/E 5E6E QA2.0 Analogic output 2. slave

L/E 5E6F QA3.0 Analogic output 3. slave---------------------------------------------------------------L=READ E=WRITE

16.2.Driver Siemens 3964R

File: 3964.DLLManufacturer: SiemensEquipament: Siemens, Bosch, WEG, MauellProtocol: 3964RRelease: 28/11/96

This driver communicates via 3964R protocol with any CLP that supports this

need an interface (RK512 or 524).

Micor connection (Elipse) with the Siemens CPUs via 3964 TTY:

Parameters (p) of the Driver communication:

p1 communication port:0=COM11=COM22=COM33=COM4

p2 - baud-rate:0=2400 bps1=4800 bps2=9600 bps3=19200 bps

p3 time-out in centesimals of secondsp4 not used

Parameters (n) of address to Tags of PLC type:

A N E X O S


n1 not usedn2 variable type (see table 1)n3 address part 1 (generally DB number)n4 address part 2 (generally DW number)

Parameters (b) of address to Tags of BLOCK type:

b1 variable type (see table 1)b2 address part 1 (generally DB number)b3 address part 2 (generally DW number)b4 variable number to be read (words or bytes)

Table 1 variable type:

Variable Typel Nº- Address VariablesData block 0 DB/DW WORDSDB continuation 1 DB/DW WORDSMerker (Memory) 2 DB/DW BYTESInput 3 DB/DW BYTESOutput 4 DB/DW BYTES

Counter 5 DB/DW WORDSTimer 6 DB/DW WORDSPeriphery 7 DB/DW BYTESSystem address 8 Absoluto WORDSAbsolute cont. 9 Absoluto WORDSPeriphery cont. 10 DB/DW BYTESData block (with signal) 11 DB/DW WORDS

scad a tutorial us

Documents

master check

generally

generally

slave digital

dynamic data

ntxp windows

slave digital

data acquisition