e3minitutorial_enu

7/29/2019 e3minitutorial_enu

1/24

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

Basic E3 Tutorial


2/24


3/24

Table of Contents1 Introduction 4

41.1 Elipse41.2 The Training

2 Starting the Application 6

62.1 Projects (.prj)

62.2 Libraries (.lib)

62.3 Domain Configuration (.dom)

62.4 Exercises

82.5 Notes

3 Data Server 9

93.1 Exercises

123.2 Notes

4 Screens and Frames 13

134.1 Exercises

184.2 Notes

5 Links 19

195.1 Exercises

215.2 Notes

6 Scripts 22

226.1 Exercises

236.2 Notes


4/24

4 Introduction

1Introduction

CHAPTER

This tutorial 's goal is to support the tra ining 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 a pplication, 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 beca me known by its easy

operation and compatibility with different manufacturers.

In 1996, Elipse relea sed Elipse Windows' first vers ion, which would later become Elipse SCADA.

In 2000, Elipse s tarted 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 hypothetica l

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 firstcontact 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


5/24

Introduction 5

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 as pects of the course, l ike the quality and quantity of information inthe clas s and in the tutorial, and als o 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 rea lly good experience working with E3!


6/24

6 Starting the Application

2Starting the Application

CHAPTER

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

2.1 Projects (.prj)

This type of file conta ins object definitions, Tags, Screens a nd other applicat ion components.

2.2 Libraries (.lib)

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

These l ibraries ca n be used a gain 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 tha t 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.


7/24

Starting the Application 7

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


8/24

8 Starting the Application

2.5 Notes


9/24

Data Server 9

3Data Server

CHAPTER

These a re some of the objects that can be inserted in the Data Server:

Objects that can be inserted in the Data Server

OBJECT DESCRIPTION

Counter Tag Object which performs either a time counting (in seconds) until it

reaches a predetermined value, or performs a certain time counting

indefinitely.

Demo Tag Object that generates va lues a ccording to a wave form. It is used to

simulate values. It a llows generating defined curves or random

values.

Internal Tag Object with a general purpose, used to keep values of any type,

including numbers, texts and other objects.

Timer Tag Object for time counting and programming activities. Sets the time

(with loops) when actions are executed.

Data Folder Defines groups and subdirectories to organize information. New

folders can be inserted into others, as needed.

3.1 Exercises



10/24

10 Data Server

3.1.1 System Time

1. To obtain the current system time, it is necessa ry to create a Demo Tag access ing 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 s imulate 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 MINIMUM MAXIMUM PERIOD SCAN TYPEAnima 0 100 5000 100 4 - RampUp


11/24

Data Server 11

Level1 0 100 2000 100 0 - Random

Level2 0 100 2000 100 0 - Random


12/24

12 Data Server

3.2 Notes


13/24

Screens and Frames 13

4Screens and Frames

CHAPTER

Screens are windows for monitoring process es, 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


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 s ize to 100 px (SplitValue property).

5. Right-click the Screens folder and select the Insert Screen in - E3Training.prj option.


14/24

14 Screens and Frames

Insert Screen

6. In the List Box, select the Top Splitter option. This causes the screen to be created with the

exact s ize 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.


15/24


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.


16/24


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.


17/24


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


18/24


4.2 Notes


19/24

Links 19

5Links

CHAPTER

Links are connections made between properties and objects, or between other properties.

Links make anima tions 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 availa ble properties of

the object to be treated and all available types of links to these properties.

Links Tab

5.1 Exercises


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 displa y the hours, minutes a nd

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 TagCurrentTime (Server - Data). On the

right, select the Value property and click the Copy button. The information goes from the Tag


20/24

20 Links

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

Link

5.1.2 LevelTo simulate the liquid's movement inside the tank, create a Link between the

VerticalPercentFillproperty 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 .


21/24

Links 21

5.2 Notes


22/24

22 Scripts

6Scripts

CHAPTER

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 a re linked to

events, and each E3 object has a list of previously defined events, but it is a lso possible for the

user to define new events.

6.1 Exercises


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, sea rch for the Viewer's Exit method, Application.Exit.

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


23/24

Scripts 23

6.2 Notes


24/24

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: [email protected]

Branch SP

Rua dos Pinheiros, 870 - Conj. 141/142

05422-001 So Paulo - SP

Phone: +55 (11) 3061-2828

Fax: +55 (11) 3061-2828


Branch PR

Av. Sete de Setembro, 4698/1705

80240-000 Curitiba - PR

Phone: +55 (41) 3342-0120

Fax: +55 (41) 3342-0120


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

www.elipse.com.br

[email protected]

USA

40190 Jarvis Gray Lane

Avon - NC - USA 27915

Phone: +1 (252) 995-6885

Fax: +1 (252) 995-5686E-mail: [email protected]

Branch MG

Rua Antnio de Albuquerque, 156

7 andar Sala 705

30112-010 Belo Horizonte - MG

Phone: +55 (31) 2511-2121


Taiwan

9F., N.12, Beiping 2nd St., Sanmin Dist.

807 Kaohsiung City - Taiwan

Phone: +886 (7) 323-8468

Fax: +886 (7) 323-9656


Germany

D-67714 Waldfischbach Deutschland

Phone: +49 (0) 6333-4439

Fax: +49 (0) 6333-2790045


Branch RJ

Praia de Botafogo, 300/525

22250-044 Rio de Janeiro - RJ

Phone: +55 (21) 2158-1015

Fax: +55 (21) 2158-1099E-mail: [email protected]

e3minitutorial_enu

Documents