Basic E3 Tutorial

2013 Elipse Software Ltda. All rights reserved. 02/04/2013 - Version 4.0

Table of Contents
1 Introduction 1.1 Elipse 1.2 The Training 2 Starting the Application 2.1 Projects (.prj) 2.2 Libraries (.lib) 2.3 Domain Configuration (.dom) 2.4 Exercises 2.5 Notes 3 Data Server 3.1 Exercises 3.2 Notes 4 Screens and Frames 4.1 Exercises 4.2 Notes 5 Links 5.1 Exercises 5.2 Notes 6 Scripts 6.1 Exercises 6.2 Notes 4 4 4 6 6 6 6 6 8 9 9 12 13 13 18 19 19 21 22 22 23

CHAPTER

Introduction
This tutorial's goal is to support the training module for E3's execution and programming. Here, you will follow the course's content. During the classes, feel free to practice what you have learned and to solve your questions with the instructor. The training presents a study case which simulates a real application, a supervisory and a control system.

1.1 Elipse
Elipse Software is a Brazilian company, with focus on the production of supervisory software to the automation industry, which started its operations in Porto Alegre in the early 90s. Its first product was Elipse 21, a DOS platform software which became known by its easy operation and compatibility with different manufacturers. In 1996, Elipse released Elipse Windows' first version, which would later become Elipse SCADA. In 2000, Elipse started developing E3, the third generation of the company's supervisory software. Since its release in 2001, E3 has been used in many systems, like operation centers in power companies, industrial plants with various purposes, telemetry and energy control systems, building automation and control, mining, among others. Elipse Software works alongside distributors located in strategic countries like Germany, the Netherlands, Taiwan, India, Canada and others, while maintaining its own office in the United States in Avon, North Carolina.

1.2 The Training

The main goal of this tutorial is to present some of E3's features through a hypothetical application.This hypothetical application does not cover all possibilites in development offered by the tool. However, the quantity and the quality of information presented in this first contact with the software should be enough to learn how to use it with autonomy to create applications. The training sequence is the following: Presenting the tool Creating a new application Creating simulation variables Creating Screens

Introduc tion

 Creating Links Creating Scripts

Your participation is very important to us. At the end of this basic tutorial, it will be requested that you evaluate various aspects of the course, like the quality and quantity of information in the class and in the tutorial, and also the instructor's work. Any suggestion or criticism is welcomed by the development team of this tutorial. Elipse Software wishes you a great training and a really good experience working with E3!

Introduc tion

CHAPTER

Starting the Application

E3 works with three types of project files, described next.

2.1 Projects (.prj)

This type of file contains object definitions, Tags, Screens and other application components.

2.2 Libraries (.lib)

This type of file contains object definitions created by the user (ElipseX) to be used in projects. These libraries can be used again in different projects.

2.3 Domain Configuration (.dom)

This type of file stores four information types: Domain configuration options List of .prj and .lib files Server configurations that are going to be executed in the Domain Security Configurations (users and permissions)

Without this file, the project cannot be executed in E3.

2.4 Exercises
This section contains exercises about this chapter's content.

Starting the Applic ation

2.4.1 Domain
1. Start E3 Studio selecting the Create a New Domain option. The Application Wizard will open.

E3 Application Wizard 2. In the Application Wizard, click the Next button, select the Standard Application option and name the project as "E3Training". 3. Set the application path to C:\E3Training and click Next. 4. In the next Application Wizard window, select the Create a New Domain option and use the same name of the project. 5. Set the screen resolution to 1024x768.

Screen Resolution

Starting the Applic ation

2.5 Notes

Starting the Applic ation

CHAPTER

Data Server
These are some of the objects that can be inserted in the Data Server: Objects that can be inserted in the Data Server OBJECT Counter Tag DESCRIPTION Object which performs either a time counting (in seconds) until it reaches a predetermined value, or performs a certain time counting indefinitely. Object that generates values according to a wave form. It is used to simulate values. It allows generating defined curves or random values. Object with a general purpose, used to keep values of any type, including numbers, texts and other objects. Object for time counting and programming activities. Sets the time (with loops) when actions are executed. Defines groups and subdirectories to organize information. New folders can be inserted into others, as needed.

Demo Tag

Internal Tag

Timer Tag

Data Folder

3.1 Exercises
This section contains exercises about this chapter's content.

Data Server

3.1.1 System Time

1. To obtain the current system time, it is necessary to create a Demo Tag accessing this information. In E3Training's Data folder, insert a Demo Tag named CurrentTime . Set Demo Tag's Type property to 3 - CurrentTime.

Insert Demo Tag

3.1.2 Simulation of Values

Sometimes, values that simulate movements are necessary. In general, these values are real and come from I/O Tags, but in this tutorial's exercises Demo Type tags will be used. 1. In the Data folder, insert Demo Tags with the following configured properties:

NAME Anima

MINIMUM 0

MAXIMUM 100

PERIOD 5000 100

SCAN

TYPE 4 - RampUp

10

Data Server

Level1 Level2

0 0

100 100

2000 2000

100 100

0 - Random 0 - Random

Data Server

11

3.2 Notes

12

Data Server

CHAPTER

Screens and Frames

Screens are windows for monitoring processes, where objects are inserted to perform the interface between the operator and the system. Each application has an unlimited number of screens. Frames are objects to organize and structure the interface, creating composite views for the user in the Viewer or Browser's main window.

4.1 Exercises
This section contains exercises about this chapter's content.

4.1.1 Screens and Frames

1. Right-click the Viewer and Frames folder and select Insert Frame In - E3Training.prj. 2. In the frame visualization area, right-click and select the Split Horizontal option, according to the next figure.

Insert Frame division 3. Position the bar that appears at about 10% of the screen, from its upper limit, and press the left mouse button to fix the bar's position. 4. Set top splitter's size to 100 px (SplitValue property). 5. Right-click the Screens folder and select the Insert Screen in - E3Training.prj option.

Sc reens and Frames

13

Insert Screen 6. In the List Box, select the Top Splitter option. This causes the screen to be created with the exact size of the splitter. Check the Set as initial Splitter's Screen option and write "ScreenMenu" in the Name field.

Screen Size

7. Create the ChemicalScreen to be opened in the Bottom Splitter. Check the Set as initial Splitter's Screen option.

14

Sc reens and Frames

4.1.2 Figures
1. Right-click in Resources and select Insert Resource in - E3Training.prj.

Insert Resource 2. Select all pictures from the C:\E3Training\Figures folder.

Sc reens and Frames

15

4.1.3 InitialScreen

Initial Screen 1. Set FillStyle property to 12 - bkPicture to enable a background picture. 2. To set the InitialScreenBackground picture as the background, drag the Resource's bitmap to the Screen's PictureFile property. This causes E3 to use the inserted resource, and not the image file (which is external to the application). 3. Create a Text object for each word you wish to include in the Screen.

4.1.4 ScreenMenu

Screen Menu 1. In the ScreenMenu , set the ScreenMenuBackground image as the background picture.

16

Sc reens and Frames

4.1.5 ChemicalScreen

Chemical Screen 1. In ChemicalScreen , set ChemicalScreenBackground image as the background figure. 2. On the conveyor belt, from the library of graphic objects (Gallery), insert the 5GallongBucket figure, which is in the Tanks folder. 3. To view the liquid inside the tanks to the right, draw a rectangle object and set the following properties: BackgroundStyle = 1 - Opaque BackgroundColor = (0, 0, 0) (black) VerticalPercentFill = 20

Sc reens and Frames

17

4.2 Notes

18

Sc reens and Frames

CHAPTER

Links

Links are connections made between properties and objects, or between other properties. Links make animations and other types of common logic's creation easier, thus minimizing the use of scripts. Through the Links tab of the Properties window, you have access to all available properties of the object to be treated and all available types of links to these properties.

Links Tab

5.1 Exercises
This section contains exercises about this chapter's content.

5.1.1 ScreenMenu
1. In the screen's right corner, insert a Display object. 2. Access the object properties and select the Formatting tab. Set the category as Time , and in the Type item, choose 13:06:03 . This formatting will display the hours, minutes and seconds. 3. Access the Links tab in the Display's properties. In the Value property, search on the Source column, with the help of AppBrowser, the Demo Tag CurrentTime (Server - Data). On the right, select the Value property and click the Copy button. The information goes from the Tag Links 19

to the Display, so the link is Simple (Property Source).

Link

5.1.2 Level
To simulate the liquid's movement inside the tank, create a Link between the VerticalPercentFill property of the tank's cut and the Level1 tag's Value property.

Link

5.1.3 Animation
1. Select the Gallon object and press the button to insert an Animation with a linear slide. The object's shadow will appear. Move it to wherever you wish.

Animation with linear slide 2. Right-click the Animation object and access its properties. Create a link between the Value property and the Anima Tag.

Link 3. Modify Animation's Enabled and EnabledSlider properties to False.

20

Links

5.2 Notes

Links

21

CHAPTER

Scripts
Scripts are code pieces (programming) that you can use to create procedures linked to specific events, enabling great flexibility in applications' use and development. All scripts are linked to events, and each E3 object has a list of previously defined events, but it is also possible for the user to define new events.

6.1 Exercises
This section contains exercises about this chapter's content.

6.1.1 Screens
1. Select the "Login" text from the InitialScreen and click the Scripts tab at the bottom of the screen. 2. In the Click event, create a new script with Open Screen as its type.

Pick Open Screen 3. Select Frame1 in the Open Screen field. 4. In the "Exit" text, create a new script in the Click event with Script as its type. 5. With AppBrowser help, search for the Viewer's Exit method, Application.Exit.

6. In the Viewer's properties, set InitialScreen as the Initial Screen.

22

Sc ripts

6.2 Notes

Sc ripts

23

Headquarter Rua 24 de Outubro, 353 - 10 andar 90510-002 Porto Alegre RS Phone: +55 (51) 3346-4699 Fax: +55 (51) 3222-6226 E-mail: elipse@elipse.com.br

Branch MG Rua Antnio de Albuquerque, 156 7 andar Sala 705 30112-010 Belo Horizonte - MG Phone: +55 (31) 2511-2121 E-mail: elipse-mg@elipse.com.br

Branch SP Rua dos Pinheiros, 870 - Conj. 141/142 05422-001 So Paulo - SP Phone: +55 (11) 3061-2828 Fax: +55 (11) 3061-2828 E-mail: elipse-sp@elipse.com.br

Branch PR Av. Sete de Setembro, 4698/1705 80240-000 Curitiba - PR Phone: +55 (41) 3342-0120 Fax: +55 (41) 3342-0120 E-mail: elipse-pr@elipse.com.br

Branch RJ Praia de Botafogo, 300/525 22250-044 Rio de Janeiro - RJ Phone: +55 (21) 2158-1015 Fax: +55 (21) 2158-1099 E-mail: elipse-rj@elipse.com.br

USA 40190 Jarvis Gray Lane Avon - NC - USA 27915 Phone: +1 (252) 995-6885 Fax: +1 (252) 995-5686 E-mail: info@elipse-software.com

Germany D-67714 Waldfischbach Deutschland Phone: +49 (0) 6333-4439 Fax: +49 (0) 6333-2790045 E-mail: elipse@elipse.de

Taiwan 9F., N.12, Beiping 2nd St., Sanmin Dist. 807 Kaohsiung City - Taiwan Phone: +886 (7) 323-8468 Fax: +886 (7) 323-9656 E-mail: evan@elipse.com.br

Check our website for information about a representative in your city or country.

w w w .elipse.c om.br elipse@elipse.c om.br