GE Industrial Solutions 6KCV300WPD User Manual

6KCV3oOWPD

Win+Drive

GE Motors & Industrial Systems

GEL100340

These instructions do not purport to cover all details or variations in equipment, nor to provide every
possible contingency to be met during installation, operation, and maintenance. If further information is

desired or if particular problems arise that are not covered

sufficiently

for the purchaser’s purpose, the
matter should be referred to GE Motors & Industrial Systems.This document contains proprietary infor­mation of General Electric Company, USA and is furnished to its customer solely to assist that customer

in the installation, testing, operation, and/or maintenance of the equipment described. This document
shah not be reproduced in whole or in part nor shah its contents be disclosed to any third party without

the written approval of GE Motors & Industrial Systems.

0

1997 by General Electric Company, USA. All rights reserved.

Table of Contents

Wintllrive

1.

Introduction

1.1

About

1.2

Document Conventions ........................................................................................................................

1.3

Installation

1.3.1 System requirements ...................................................................................................................

1.3.2

2.

Developing a

2.1What

2.2 Introducing

2.2.1

2.2.2 The Code Generation ..................................................................................................................

2.2.3

2.2.4

2.3 The Development Process

3.

FastTrack to

3.1

Menu Summaries .................................................................................................................................

3.1.1 Managing

3.1.2 Editing schematics

3.1.3 Changing the view of the schematics

3.1.4

3.15 Working with compound blocks

3.1.6 Debugging projects

3.1.7 Tools ............................................................................................................................................

3.1.8 Options ........................................................................................................................................

3.1.9 Window operations

3.1.10 Help

4.

The Win+Drive

4.1 Starting Win+Drive

4.1.1 Starting from Windows

4.1.2 Starting from Windows 3.1

4.2 Opening

4.2.1 Creating

4.2.2 Opening an

4.3

Saving

4.4

The

4.4.1 Menus .........................................................................................................................................

4.4.2 Toolbar.. ......................................................................................................................................

4.4.3 Block Selection Bar...................................................................................................................

4.4.4 Statusbar

4.4.5 Windows ....................................................................................................................................

4.4.6 Schematics Windows.................................................................................................................

4.4.7 Output Window

4.4.8 Monitor Windows ......................................................................................................................

4.4.9 Trace Windows

4.4.10 Getting Help ............................................................................................................................

4.5

Exiting

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

Manual ................................................................................................................................

this

of Win+Drive ....................................................................................................................

Installation

The

Win+Drive Application ..........................................................................................................

Win+Drive?. ............................................................................................................................

is

the Tools ...........................................................................................................................

The

Schematic Editor ..................................................................................................................

The Simulator

The

Library Editor.......................................................................................................................

Win+Drive ..............................................................................................................................

Inserting

menu

Design Environment..

Projects ................................................................................................................................

a Project .................................................................................................................................

Win+Drive

Win+Drive .............................................................................................................................

Sequence ...........................................................................................................

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

Files and Printing

into

items

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

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

a new project...............................................................................................................

existing

Screen Layout ...........................................................................................................

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

1

1
2
2
2
2

3

3

3

3

3

3

3

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

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

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

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

the schematics .............................................................................................

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

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

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

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

95

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

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

project..

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

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

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

4

5

5
5

6
6
7
7

8

8
8
9

9
10
10
10
10
10
10
10
10

11
11

11
12
12
13

13

14

15

15

16

16

i

GEL100340

5.

Creating Software Schematics

5.1 Placing Software Blocks

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

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

5.1.1 Toolbar Placing Blocks by Drag&Drop from the Block

5.1.2

Placing

5.2 Connecting

Blocks

Software Blocks

5.3 Placing Text and Labels

5.3-l Placing a Text

5.3.2 Placing a Label

5.3.3

Modifying

5.3.4 Moving Texts or Labels

5.4 Editing the Ports of Blocks

5.4.1

Opening the Ports Editor Dialog

54.2 Setting the Port Connection

5.4.3 Setting the Port Attributes

5.5

Editing

Block Parameters

5.6 Changing the View

5.6.1

Positioning

56.2

Changing the Zoom factor

using

the Insert Menu

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

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

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

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

the Text ....................................................................................................................

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

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

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

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

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

of the Schematic

the View

................................................................................................................. 22

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

5.6.3 Displaying additional Information on the Window

5.7

Modifying

Schematics

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

5.7.1 Selecting blocks and lines .........................................................................................................

5.7.2 Moving selected items
and

5.7.3 Copying

5.7.4

Resizing

5.7.5

Deleting items

5.7.6

Rotating

Moving via the

items

Blocks

5.8 Printing Schematics

5.8-l

Printing

5.8.2

Printing

5.8.3 Page Setup

in Window
in

Page Mode

for Printing

5.8.4 Setting Stamp Variables

5.8.5 Stamp

6.

ConnectiontoExternal

definition file format

Variables ...............................................................................................................

6.1 Variables and Logicals

6.2 The Variables

Dialog

6.3 The Logicals Dialog

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

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

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

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

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

Clipboard ....................................................................................

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

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

Mode

............................................................................................................... 26

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

............................................................................................................ 28

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

....................................................................................................................... 30

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

6.4 Connecting Block Ports to Logicals

7.

Working

7.1

with

Hierachy and Compound

Creating and Opening Compound Blocks

7.1-l Creating a New Compound Block

7.1.2 Opening an existing Compound Block

7.1.3

Renaming

7.2 Block Inputs

Compound Block ..................................................................................................

a

and Outputs ...................................................................................................................

7.2.1 Placing Input and Output Ports

7.2.2 Renaming Ports

7.2.3

Changing

7.3 Updating and

Closing

7.4 Copying Compound Blocks

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

the Size of Ports ........................................................................................................

a Compound

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

17
17

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

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

17

18
18

19
19
19

19

19
20

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

20

20
21

21

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

22

22

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

22
23

23

23
23
24
24
24
25
25

27

28

30

..................................................... 30

%.

31

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

Blocks .........................................................................................

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

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

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

32
33
33
33
33

34

34

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

34
34
34

Block ........................................................................................

35
35

WintDrive

7.5

7.6

Deleting

Using

Compound Blocks

Compound

Blocks ...................................................................................................................

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

7.7 Export and ImportofCompound Blocks ...........................................................................................

7.7.1 ExportofCompound Blocks .....................................................................................................

of

7.7.2 Import

8.

Generating Programs ..................................................................................................................................

8.1

Generating

Compound Blocks .....................................................................................................

the Program

from

the Schematic .....................................................................................

8.2 Execution Order.................................................................................................................................

8.3

Compiling

8.4 Generating

the Program ......................................................................................................................

a Cross Reference ............................................................................................................

8.5 Editing the Block Icons ......................................................................................................................

8.6

Changing Build

9. Simulating Programs on the PC

9.1

Setting Probes ....................................................................................................................................

9.1.1 Setting Probes from the Edit menu

9.1.2 Setting Probes by the Context Sensitive Menu

9.2

Removing

9.3 Configuration of the Monitor Window

9.3.1 Monitor

9.3.2

Changing

9.3.3 Zoom within the Monitor Window

9.4 Configuration of the Trace Window

Options ....................................................................................................................

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

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

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

Probes ...............................................................................................................................

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

Configuration Dialog

the

List

of Probes

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

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

............................................................................................ 43

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

9.5 Running the Model ............................................................................................................................

9.5 .lDisplaying

9.5.2

Changing

10.

Changing

10.1

Settings

Scheme

Settings ...............................................................................................................................

10.2 General Settings

10.3 Changing the Colors

Values

Values

during Simulation

during Simulation

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

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

of Win+Drive .............................................................................................................

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

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

10.4 Setting up External Tools .................................................................................................................

35
36
36
36

37
39
39
39

40

40
40
40
41
41
41
41

42
42
43
43

43

44

44

44
45
45

46

46

47

Appendix A. Block Library

A.1

Block

library for

A.2 Introduction

DGFC 386

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

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

HELP ........................................................................................................

A.3 Block.. .....................................................................................................................................................

Group .......................................................................................................................................................

I/o

Group .................................................................................................................................................

Mathematics Group
Logical
Timer

Group ..........................................................................................................................................

Group .............................................................................................................................................

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

Delay Group .............................................................................................................................................

Function Group ........................................................................................................................................

Control Group ..........................................................................................................................................

Arithmetic

Variable Group

Generator

Group .....................................................................................................................................

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

Group ......................................................................................................................................

49

49
49
49
50
50

50
5 1
51
51

52
52
53

53
53

I

. . .

111

GEL100340

Input port..................................................................................................................................................

Parameter ................................................................................................................................................

output port

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

A.4 Blocksinalphabetical order ....................................................................................................................

alarm ........................................................................................................................................................

and ............................................................................................................................................................

cfix

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

delay.........................................................................................................................................................

diamobs ....................................................................................................................................................

exe1 ..........................................................................................................................................................

exe2 ..........................................................................................................................................................

exe4 ..........................................................................................................................................................

exe8 ..........................................................................................................................................................

fabs ...........................................................................................................................................................

fadd ..........................................................................................................................................................

fass ...........................................................................................................................................................

fchs ...........................................................................................................................................................

fcnt

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

fcmp .........................................................................................................................................................

fdelay ........................................................................................................................................................

fdiv

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

feq ............................................................................................................................................................

ffd

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

ffjk

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

fge

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

fgt

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

fle

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

flt

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

fmod .........................................................................................................................................................

fmul

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

fmux

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

fne

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

fprc ...........................................................................................................................................................

fsel.................................................. ..........................................................................................................

fsub ...........................................................................................................................................................

fti

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

fun

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

fvar

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

gsine

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

gsquare .....................................................................................................................................................

gtriangl

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

iabs ...........................................................................................................................................................

iadd.. .......................................................................................................................................................

iass..

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

ichs .........................................................................................................................................................

icmp ........................................................................................................................................................

icnt

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

ida..

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

idelay

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

idiv

. . . . . . . . . . . . . .._.........................................................................................................................................

ids

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

..-..................................................................................

..“.~.........~...........~............................~...............~..........

54
54
54
55
56
57
58
59
60
65
66
67
68
70
70
72
73
74
75
76
77

78

79

80
81
82
83
84
85
86
87
89
90
91
92
93
94
95
96
97
98

99
100
101
102
103
104
105
108
109
110

iv

Wintllrive

ieq..

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

ige..

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

igt

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

ile..

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

ilt

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

imod

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

imul

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

imux

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

ine

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

iprc .........................................................................................................................................................

isel

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

isub

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

itf

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

ivar

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

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

land

lnot

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

lor

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

lxor

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

mfti

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

mitf

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

not ..........................................................................................................................................................

Oda

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

ods ..........................................................................................................................................................

Or

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

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

Pwr

rbit

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

l-fix ..........................................................................................................................................................

speedobs .................................................................................................................................................

sqrt..........................................................................................................................................................

T .............................................................................................................................................................

tbd ..........................................................................................................................................................

tme

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

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

tpc ...........................................................................................................................................................

wbit

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

wfix

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

xor ..........................................................................................................................................................

112

113

114
115
116
117

118
119
121
122
123
124
125
126
127
128
129
130
131
132
133
134
137
139

140
141
142
144
146

147
148

150
152

154

155

156

158

V

GEL100340

Appendix B Compound Library for

Compound Library for DGFC ...............................................................................................................

B. 1

B.2 Introduction

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

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

DGFC

Brief Library description ........................................................................................................................

How to use the Compound Library ........................................................................................................

Import compound block .........................................................................................................................

Input

port priority

Compound block

B.3

Library

contents .....................................................................................................................................

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

name ..........................................................................................................................

Analog Input ..........................................................................................................................................

AntiWindUp-PID

Cycle

Time

DC-MOTOR.

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

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

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

Deadband ...............................................................................................................................................

Digital-Input
First-Run..
FULL-RAMP

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

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

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

Integrator................................................................................................................................................

Lim-integrator

Limit..

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

Low-Pass-Filter

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

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

Ramp ......................................................................................................................................................

Sign

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

Time-Derivative
Time-Integrator..

Time-LimJnt

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

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

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

Ts ............................................................................................................................................................

Units-Converter

Glossary ................................................................................................................................................

B.4

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

159

160
161
162
162

162
162
162

163

164

16.5

167

168

169

17 1
173
174
176
178
180

182
184

187

188
190

192

194
195
197

WhOrive

List of Figures

Figure

2.3.1

Design

Flow .............................................................................................................................

Figure 4.4.2.1 Toolbar ....................................................................................................................................

Figure 4.4.3.1 Block Selection Bar ...............................................................................................................

Figure

Figure 4.4.5.1 Schematic Window
Figure
Figure
Figure

4.4.4.1 Status

Bar

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

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

4.4.7.1 Output window..

4.4.8.1

Monitor Window ....................................................................................................................

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

4.4.9.1 Trace Window ........................................................................................................................

Figure 5.1 Block ......................................................................................................................................

Figure

5.3.3.1

Change Text

Dialog

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

Figure 5.4-l. 1 Ports Editor Dialog ................................................................................................................

Figure 5.5
Figure

Figure
Figure
Figure 5.8.2.1 Block Print List Dialog
Figure
Figure
Figure
Figure
Figure
Figure 6.3.1
Figure
Figure
Figure

.. 1

Block Parameter Dialog .........................................................................................................

5.7.6.1

Rotate Block Dialog

5.8.1

58.2

Window Print Mode

Page Print Mode Dialog .........................................................................................................

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

Dialog

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

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

5.8.3.1 Page Setup Dialog1(page setup) ..........................................................................................

5.8.3.2 Page Setup

5.8.3.3

5.8.4.1

6.2.1

Page Setup Dialog 3 (grid setup) ...........................................................................................

StampVariables

Variable Editor Dialog ...........................................................................................................

Logical

7.1.1.1

New Compound Block...........................................................................................................

Dialog2(stamp setup) ........................................................................................

Dialog

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

Variable Editor Dialog ..............................................................................................

7.1.2.1 Open Compound Dialog ........................................................................................................

7.1.3.1

Rename Compound Dialog ....................................................................................................

Figure 7.4.1 Copy Compound Dialog ........................................................................................................

Figure 7.5.1 Delete Compound Dialog ......................................................................................................

Figure

7.7.1.1

Export Compound

Figure 7.7.2.1 Import Compound Dialog

Dialog

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

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

Figure 7.7.2.2 Import Variables Dialog .........................................................................................................

Figure
Figure
Figure
Figure
Figure 9.3.1
Figure 9.3.2.1 Setting the List of Probes
Figure 9.5.1

Figure
Figure
Figure 10.2.1 Colors Dialog
Figure

7.7.2.3 Import Action .........................................................................................................................

8.2-l

8.2.2

9.1.2.1

Execution
Changing the
Set Debug Window

order......................................................................................................................

execution

order ................................................................................................

Dialog

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

Oscillogram Configuration Dialog

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

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

Set Run Steps Dialog .............................................................................................................

10.1.1

10.1.2 Settings

Set Scheme

Dialog

Dialog

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

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

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

Tools

10.4.1

Dialog

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

4
11
12
12
13
14
15

15

17

19

20

21

24
25
26
26
27

27

27

28
30
3 1
33
33
34

35
35
36
37

37
37

39

40
42

42
43
44

45

45

46

47

Vii

WintDrive

1.

Win+Drive is a graphic programming tool for the Windows

graphic assembly of blocks which represent pieces of program code. Win+Drive is especially useful for
designing the software of control systems. The tool generates C code that can be compiled and run
ent target platforms including the PC itself.

I.1

This manual decribes how to install and to use Win+Drive. It contains the following chapters:

lntruduction

TM

operating system. Programs can be built by the

on differ-

About this Manual

Chapter 1 describes the document conventions and the installation process.
Chapter 2 gives an overview of the concepts and features of Win+Drive.
Chapter 3 contains a quick reference to the features of Win+Drive. Summaries of the menus and keyboard
actions are given.
Chapter 4 describes the basic components of the Win+Drive design environment. This includes how to
open, save and close projects, the different elements of the screen layout including menus, toolbars and
windows for schematics, compiler and simulator output. Also how to get online help is explained here.
Chapter 5 shows how to create schematics using Win+Drive. This includes the placing and connecting of

software blocks, the editing of block ports and parameters and methods to view, modify and print sche­matics.
Chapter 6 explains how software parts developed and created by Win+Drive are connected to the target

system using variables.

Chapter 7 describes how

shows how these compound blocks are created and used within other blocks. Also the transfer of com­pound blocks from one project to another is explained.

Chapter 8 explains how program code is generated from Win+Drive schematics. This also includes the

automatic run of the compiler.
Chapter 9 provides information about the simulation of Win+Drive generated programs on the PC includ­ing the display of simulation results in tabular form and graphically.

Chapter 10 contains the necessary information how to change general settings of Win+Drive.
Appendix A (a printout of the Win+Drive on-line help) details all the supplied blocks.

appendix was current at time of printing: for latest information, always refer to the on-line help.

Appendix B (a printout of the Win+Drive on-line help) details all the supplied compound blocks.

that this appendix was current at time of printing: for latest information, always refer to the on­line help.

hierachy

can be used within Win+Drive projects by using compound blocks. It

Note that this

Note

The user of Win+Drive and thus the reader of this manual should be familiar with the Windows operating
system and user interface. Throughout this manual all information that is common
omitted to prevent redundancy and overhead.

to

Windows applications is

GEL100340

12

Document Conventions

Within this document the following visual orientation help are used:

Font Function

1.3

Bold Names

Italic Items to input (i.e. filenames).

SMALL CAF’ITALS

Fixed spacing

Installation of Win+Drive

of menus, commands and register cards.

Key codes.

Code examples, contents of text files.

The Win+Drive environment is composed of three elements :

- WlN+Drive

is the base software of the graphic editor and contains the New Project tool to

create a project.

-

WIN-PRJ

-

visual c++

1.5x is the Microsoft C ++ compiler used to compile the diagrams created with

is the software that allows a user to create an application

WIN-PRJ.

This section presents the minimum system requirements and a recommended installation sequence.

1.3. I

System requirements

The minimum system requirements of Wm+Drive are:

IBM or compatible personal computer with 386 processor or higher

-

-

operating system Windows 3.1,3.11, Windows 95

-

at least 4 Mbyte of free disk space

-

8 Mbytes system memory (16 Mbytes recommended)

1.3.2

The Installation Sequence

The installation sequence of the various elements is not critical, but observing the following sequence will
simplify the installation:

1. visual c++

2.

WIN+Drive

1.5x

Refer to the Getting Started manual, GEL100354, for installation details.

WintDrive

2

2.1

The control of systems by electronics was traditionally done by analog circuits. These analog circuits operate
continuously. Their structure can be described by block diagrams based on general blocks like PI controllers,

adders etc.

Using digital software control by microcontrollers for the same control tasks is possible in many cases. Now
the continuous operation is replaced by the cyclic execution of a control program. Programs consist of a

sequence of operations. For describing programs, typically text files containing program code in assembler or
high-level languages like “C” are used. This kind of representation is often not appropriate for the description
of control tasks.

Win+Drive is a graphical program generator for the Windows

control tasks. Building control programs is as easy as drawing block diagrams. Basic pieces of code are
placed on a schematic and are connected. Parts of the whole control structure can be put into compound
blocks that are inserted into schematics once or several times. From this graphical representation code is
generated that can be compiled and executed on the PC for simulation and on the target system.

Developing a

What is Win+Dfive?

Win+Drive

Application

TM

operating system especially designed for

2.2 Introducing the Tools

2.2.1 The Schematic Editor

The schematic editor is the most important interactive tool of Win+Drive. It is used to create and edit the

schematics. These contain the basic blocks which represent library elements with pieces of code within them
and compound blocks which are schematics by themselves. The blocks are connected by connection lines to
make the output value of the calculation of one block the input value of another one. Texts and labels can be
inserted into the schematic as comments.

There are numerous commands to modify schematics. Schematics can be printed for documentation purposes.

22.2

While the schematic editor is an interactive tool with a lot of user commands the code generation is a batch
process that is started by only a few commands. It generates C code from the schematics and compiles it to

executable binaries. The PC itself or the target system can be selected as the platform for the code generation.

The Code Generation

2.2.3 The Simulator

The generated code can be executed on the PC. For this purpose Win+Drive includes a simulation and prob­ing shell. Probes can be set on ports of blocks to be displayed during simulation graphically or in tabular lists.
The simulation can be run for one or several cycles.

2.2.4 The library Editor

For creating and modifying the basic blocks which build the library for Win+Drive applications some tools
for creating and modifying the library are provided. This includes an editor for the graphic symbols of the

blocks and a library tool for the administration of the source code of the basic blocks.

3

2.3 The Development Process

GEI-100340

Figure 23.1: Design Flow

The total process for developing a Win+Drive application consists of the following steps:

1.

Create a new project.

2.

Create the schematics by placing basic blocks and connecting them. This is done using the schematic
editor. If complex projects have to be created you can create compound blocks to insert hierachy into your
project.

3.

Generate code from the schematics and compile them for the PC as the target system.

4.

Simulate the generated code on the PC for debugging. If errors are found go back to step 2. Change the
schematic, generate and compile once more and simulate again.

5.

Generate code for the target system and compile it.

6.

Run the compiled code on the target system.

4

WintDrive

3 Fast Track to

3.1

Menu Summaries

Wiit+Drive

This section summarizes most of the Win+Drive procedures by giving a comprehensive menu overview. This
is also an index to the individual description of each menu action within this User’s Guide.

3.1.1 Managing Files and Printing

To

Create a new project

Open an existing project

Close a project
Save a project
Rename a

Load a Basic Block into
Project

Import a compound
block

Export a compound
block

Print a window or
schematic

Setting up the page for

printing

Exiting the program

project

&ew

Open.. CTRL+O

Close

Save

Save As..

Load Basic

Block

Import

Compound

Block..

Export

Compound

&lnt

Shortcut Comments

CTRL-FN

CTRL+S The current project is saved to disk.

I

CTRL+P A dialog is opened for printing

Creates an empty

named when it is saved.

Opens an existing file by showing the

standard Windows
selecting a project file.

The current project is closed.

The current project is saved with a new
name. The standard Save As File dialog

I

is opened.

This block is only available during the

current

Get a hierachical block from another
project (after exporting).

Export a compound block to a file for
inserting it into another project.

The current session of Wm+Drive is

session.

schematic

Fileopen

dialog for

that will

See paragraph

be

4.2.1

4.2.2

4.3

4.3

4.3

51.2

7.7.2

7.7.1

5.8

5.8.3

4.5

3.1.2 Editing schematics

GEL100340

Comments

Put a part of a schematic Cu$
into the clipboard

Copy a part of a

COPY

schematic into the

cliDboard

Insert from clipboard

Delete the selected part

Easte

Qelete

of a schematic
Select the whole

Select All

schematic
Remove the whole

Remove All

contents of the

schematic

Edit the list of logical ~ogicals..
variables

Edit the list of variables

Xariabies..

CTRL+X

CTRL+C

CTRL+V

DEL
CTRL+A

The parts of a schematic which were put 5.7.3
into the clipboard

by

Cut or Copy are

inserted into the current schematic
The selected part of the schematic is

57.5

deleted.
The total contents of the schematic is

5.7.1

selected.
The total contents of the schematic is

5.7.5

deleted.

A dialog window is opened for editing

6.3
(inserting, deleting, changing) the logical
variables of the project.

A dialog window is opened for editing 6.2
(inserting, deleting, changing) the
variables of the oroiect.

3.1.3

To

Zoom into schematic
Zoom out of schematic
Zoom original size

Show whole schematic

Showing/hiding the

block

Showing/hiding the
execution order

Showing/hiding

ofblockandpc&names

Changing the view of the schematics

View Shortcut Comments See paragraph

ZoomJn

Zoom Qut
Zoom

mole

Block

toilbar

execution

Order

the

info

Quick Info

Showing/hiding the Quick

value

of

signals

1:l

Toolbar

1

Xalue

1

CT++
ALT+­ALT+l

IIncreases the zoom factor. 5.6

1

Decreases the zoom factor. 5.6

Sets the zoom factor to a value of 1. 5.6.2

ALT+2 Changes the zoom factor to a value that 5.6

the entire contents of the schematic fits

into the window.
If this menu item is checked the toolbar 4.4.2

for selecting blocks is visible.

If this menu item is checked the 8.2

execution order is displayed within the
schematics.

If this menu item is checked the names of 5.6.3

)

the blocks and ports are displayed when
the cursor moves on them.

If this menu item is checked the actual 9.5.1

value of a signal is displayed during
simulation if the cursor moves on it.

wow3

6

WintDrive

3.1.4 Inserting items into the schematics

TO Insert Shortcut Comments

See paragraph

Insert an

Insert an output port

Insert a text

Insert a label

Insert a block

3.1.5

To

input port

Working with compound

Input Port

Qutput Port

Text

Label

(Group name of
blocks)

An input port is inserted into a
compound block which is used as a
connection to the upper level of

hierarchy for input signals.
An output port is inserted into a

compound block which is used as a
connection to the upper level of
hierarchy for output signals.

A text is inserted. This is used as a
comment only.

A label for the selected block is inserted.
This label is a comment that moves
together with the block.

Within the Insert menu the list of all
groups of basic blocks is shown. If one
item is selected a submenu with all basic
blocks belonging to this group is opened.
Selecting one item from this submenu
inserts the block into the schematic.

7.2.1

7.2.1

5.3.1

5.3.2

5.1

hlocks

Compound Shortcut Comments See paragraph

Create a new compound New
block
Open an existing Qpen..
compound block

Delete a compound
block

Rename a compound
block of the project is displayed; this can be

Copy a compound block Coey..
within a project

Close the actual

compound block associated window.

Updating
of changed compound
blocks

the instances

Delete..

Eename..

I

I Close

Update
Instances

I

1

CTRL+F41 Closes the compound block and its

A new compound block is created. An 7.1.1
associated window is opened.
A list with the existing compound blocks 7.1.2
of the actual project is opened. The
selected item will be opened in a new
window for editing.

A list with the existing compound blocks 7.5
of the project is opened. The selected
item will be deleted.

A list with the existing compound blocks 7.1.3
used for renaming the blocks.

The entire contents of an existing 7.4

compound block is copied into a new one

1

within the same project.

The instances of the compound block 7.3
that was edited are updated.

I

(7.3

WDM)S

3.1.6

Debugging

GEL100340

prujects

To

Simulate several cycles

Stop the simulation
Unload the model

Set probe on signal.

Create a monitor

Create a trace
Remove a probe

Remove all probes

3.1.7 Tools

Debug

I

conthme

stop

I

Unload DLL

Se& Probe

create

Create Trace

Remnve Probe

Remove &I
Probes

&$onitor

Shortcut Comments See paragraph

F5

F8

FlO The model is simulated several times. 9.5

AL,T+FS The model is unloaded and the data is 9.5

I

IReloads the model into memory and

initializes it.

~

The model is simulated once on the PC 9.5

The number of cycles is determined by a

didOE.

removed from the monitors
The model is removed from memory.
A probe is set on the selected signal

(connection line)
After selecting this menu item a signal is

selected which is monitored.
After selecting this menu item a signal is

selected to trace a signal.

Afier selecting this menu item a probe is 9.2

selected which will be removed.
All probes within the project are

removed.

9.5

9.5

9.1

9.1.1

9.1.1

9.2

Woo06

Generate a cross

3.1.8 Options

/oIyoRI

::,,

Set

Set the microcontroller

C166asthetarget

system

Set the settings of the
schematic

Set general settings
Set the colors

Setting the external tools Xools

the

PC as the target

-

PC Simulation

Target
Execution

I

I I

ISchgme

Settings..
settings..

dolors..

r

Code will be generated for the target 8.4

I

system

I

I

‘A dialog is opened for setting options of

the schemes
A dialog is opened for general settings. 10.2
A dialog is opened for setting the colors

within the schematics.

A dialog is opened that where external 10.4

tools that extend the tools menu are
defined

10.1

10.3

3.1.9

Window operations

WintDrive

To

Place the windows side
by side on the screen

Place the windows in a

cascade

Arrange the icons of the

closed windows
Close all open windows

Select a window

3.1.10

Help menu

To

Open the help file

Search for help on a

snecific tonic

Get help about how to
use heln

Get help about the basic

blocks

Get general information

about Win+Drive

Window

Tile

Cascade

Arrange Icons

Close All

(list of open

windows)

Help

contents

,zrh

for help

How to use help

‘&lock Help

I

About

Shortcut Comments

All open windows are arranged that they
don’t overlap.

All open windows are arranged in a
cascade.

The icons are arranged within the main
window of Win+Drive.

All windows are closed.
The menu includes a list of all windows.

If one menu item is clicked the

corresponding window gets the focus.

Shortcut

Comments

The help file is opened; the contents 4.4.10

tonic is disolaved.

1

The search dialog of the help system is

I

ODened.

A help file about how to use help is

opened.
A help cursor is shown. After selecting a
block the appropriate help page

opened.

A dialog with general information about

Win+Drive is opened.

will

See paragraph

4.45

4.4.5

4.4.5

4.4.5

4.4.5

woo09

See paragraph

4.4.10

4.4.10

4.4.10

be

4.4.10

GEI-100340

4. The

4.1 Starting

After Win+Drive is installed a program group called “Win+Drive” is created. It contains the following items:

m

starting

-

starting the Image editor

-

opening the Win-tDrive help

-

uninstalling

Files with the extension.

4.1. I Starting from Wind0 ws 95

From the

Win+Drive will be started.

Alternatively you can create a shortcut to Win+Drive on the desktop or within any folder.

Win+Drive project files with the extension.

This will start Win+Drive and open the selected project file.

4.1.2 Starting from Windows 3.1

Open the Win+Drive group within the program manager and double-click the Win+Drive icon within this

window. Win+Drive will be started.

From the file manager Win+Drive project files with the extension .

Win+Drive and open the selected file.

Win+Drive

Win+Drive

W&Drive

Start

button select

Win+Drive

WDR

Design Environment

will be associated with the Win+Drive application.

the Program

item, then

WDR

the Win+Drive

cart also be double-clicked within the explorer or any folder.

group and finally

WDR

can be double-clicked to start

the Win+Drive

item.

4.2

42.1 Creating a newproject

To create a new project select the menu item New from the

name

If another project was open and modified when a new project is created a dialog is opened for asking if the
old project should be saved.

4.22

To open an existing project the menu item

dows file open dialog is opened for selecting the project file. Win+Drive project files always have the exten-

sion
An existing project can also be opened from the list of recently used projects at the bottom of the
After opening a project a window with the top schematic is opened and shown.

4.3

For saving a project to disk the menu item
newly created a standard windows dialog for entering the name and path of the project file is opened.

To save a project under a new filename use the menu item
the windows dialog for entering the file name will always be opened.

After saving a project the project is still active and can be modified. To close a project the menu item

from
be saved to disk. After closing the project no project is active. A new project can be created or another exist­ing project can be opened.

Opening Projects

nuname.wdr.

Opening an existing project

. WDR.

Saving a Project

the File

A window for the main schematic titled

menu has to be selected. If the project was modified a dialog is opened asking whether it should

Open

Save

from the

from the

File

File

menu. A new project will be created with the

Scheme

File

Save As

is opened with no contents.

menu has to be selected. The standard win-

File

menu.

menu has to be selected. If the project was

from the

File

menu. Selecting this action

Close

10

WintDrive

4.4 The

Win+Drive

Screen Layout

The Win+Drive screen layout closely resembles the layout of Windows MD1 applications (Multiple Docu­ment Interface) like Microsoft Word or Excel. The main window includes a menu bar, a toolbar and a block

selection bar at the top and a statusbar at the bottom. Between these bars there is the client area where one or
more child windows can appear. If the size of the child windows is larger than the client space of the main
window scroll bars appear which can be used to move the actual visible portion of the total client area that is

used by all child windows.

The Win+Drive main window can be

minimized, resized and maximized by the standard methods of Win-

dows. In most cases it will be run in maximized mode.

4.4. I Menus

The menus are located at the top of the main window. Each menu item can be accessed by the standard

methods of Windows (clicking by the mouse or keycodes). A complete overview of all menu items is given in

Chapter 3.

4.4.2

Toolbar

The toolbar provides a fast method to access often used menu items. Clicking one of the toolbar buttons

equals accessing the equivalent menu item.

12 3 45 6

7

8 9

ICI

11 12 13 14 15 16

Figure 4.4.2.1:

Toolbar

By the buttons of the toolbar the following commands can be accessed by a simple mouse click

1. Open a tile (see paragraph 4.2.2)

2.

Save a file (see paragraph 4.3)

3.

Open a compound block (see paragraph 7.1.2)

4.

Update the instances of a compound block (see paragraph 7.3)

5. Restart the simulation (see paragraph 9.5)

6. Simulate one loop (see paragraph 9.5)

7. Simulate several loops (see paragraph 9.5)

8. Stop the simulation (see paragraph 9.5)

9.

Set the number of loops to simulate (see paragraph 9.5)

lO.Display the number of loops that have been simulated (see paragraph 9.5)

11. Show/Hide the block toolbar (see paragraph 4.4.2)

12.Show/Hide the execution order (see paragraph 8.2)

13.Set a probe (see paragraph 9.1)

14.Create a monitor window (see paragraph 9.1)

15.Create a trace window {see paragraph 9.1)
IdBlock

help (see paragraph 4.4.10)

11

GEL100340

4.4.3 Block

Selection Bar

The block selection bar provides quick access to the building blocks of the schematics. It is divided into two
parts: the left part is used for selecting a group. The members of the selected group are displayed on the right
half of the bar. Placing of a block is done by dragging and dropping a block into the schematic.

The block selection bar can be made hidden or visible by the menu item Block Toolbar of the View menu.

;J CtB fTJ Zag CM GasB&y c&j ah emwmf!

Figure 4.4.3.1: Block Selection Bar

4.4.4 Status Bar

5z$iMse ‘& i$e#atlFnr

,

I

,

lg,,d-

Figure 4.4.4.1: Status Bar

The status bar is located at the bottom of the main window and gives information about the schematic being
edited On the left side the following items are displayed:

-

if the mouse pointer is on a button of the toolbar an explanation of the button is given

-

if the mouse pointer is on a button of the block selection bar, its name is displayed

-

if the mouse is within the schematic during editing the name of the block it is pointing to is displayed

-

in all other cases this part is left empty

The right part of the status bar displays information about the status of the project:

-

saved ufrer

-

changed

-

run if simulation is active.

saving to disk,

after editing changes,

12

WintDrive

4.4.5 Windows

Within the main window of Win+Drive several child windows can be placed. Each child window can be

maximized, minimized, resized and closed with the standard Wrndows actions. Within the Window menu
there are some items for arranging the open windows (tiling and cascading) and for arranging the the icons of
the closed windows. Another menu item is provided for closing all windows.

The window menu also includes the list of the open windows. Selecting one of these items will change the
focus to the corresponding window.

Within Wm+Drive there are four different types of child windows:

-

schematic windows for the main scheme and for the compound blocks

-

the output window of the code generation and compilation process

-

monitor and trace windows for displaying dam during simulation.

. . . . _ . . . . . . . . . . .

.

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

.

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

Figure 4.451: Schematic Window

4.46

Schemafics

The schematic windows are the main part of a Win+Drive application. They display the structure of the
program to generate and allow graphical editing of this structure.

The title bar of the main scheme always is
bar The schematics windows have scroll bars for changing the actual view within the total schematic. They
can be minimized, maximized and resized.

Within the client area of a schematic window there are the following elements:

-

the blocks of the schematics. These can be basic blocks or compound blocks

-

connections between the ports of the blocks

-

input and output ports within compound blocks for connecting them to the next

-

texts and labels as comments.

AU blocks and connection lines are placed on a grid. Within the page setup dialog (called from the File menu)
the grid can be sized and made visible and printable.

Schematics can be printed on many pages. The boundaries of the pages for print out are visible within the
schematics as fine lines.

Windows

k;=A+B-251:::::::::::::::::

Scheme

while the compound blocks have their names in the title

hierachical

layer

13

GEL100340

4.4.7 Output Window

Output windows are used to display the messages and errors of the code generation and the compilation. Also

source files can be displayed.
Output windows allow no editing. Only after double-clicking an error

message

the appropriate schematic or

source file that caused this error will be opened.

+*ff******

~Qutput files G:~PROJEKTE\WPDll4~moclel)TEST2.cpp, G:jPROJEKTEjWPD114jmode

i

iCheck tags for Scheme
$Generate code for Scheme

$Code

$Compile
s

i

!

. f IG:\PROJEKTE~WPD114~wpdinc: f IG:\PROJEKTE\WPD114\basicinc /?G:\PROJEKTE

I

,test2.cpp

TESTZ.i(46) : aarnlng C4051: type conversion: possible loss of data

is
1

I
;

$Hlcrosoft
!Copyright

$

I

i

Tue Jul 09

has been generated,

and

G:\PROJEKTEjWPD1141bin\gnucpp.exe -P -IG:jPROJEKTEjWPD114\basicinc
g:jmsvc\bln\cl /batch {nologo /GZ /W3

echo >NUL @TESTZ.CRF

g:\msvc\bin!llnk /batch /NOLOGO /NOD /NOE /PAcKc:61440 faIm:l6 foN

g:\msvc)binjre !nologo TESTP.DLL

g:\msvc!blnjlmplib fnowep TEST2.LIB TESTZ.DLL

link TEST2 for PC

[R]

(C]

Figure 4.4.7.1: Output window

15':37:12

Import Library Hanager Version 1.50

EIicrosoft

Corp 1984-1993.

1996

0 error(s)D warning(s)

fZi fALw fOd

ill rights reserved.

i'D rr

DEBUG"

-

/D

14

4.4.8 Monitor Windows

Wintllrive

Figure 4.4.8.1: Monitor Window

Monitor windows display simulation results graphically, similar to oscilloscopes. They are used only for
display; no editing is possible.

4.4.9

Trace

Windows

Trace windows display simulation results in tabular form-The contents of trace files can be written to text
files. Editing is not possible.

Figure 4.4.9.1: Trace Window

15

GEI-100340

4.4.10 Getting Help

Within the

Help

menu there are items to open the help file and to get help from it. The

Contents

help topic
can be opened directly. Alternatively a dialog for searching help on a specific topic can be opened. Another
menu item is provided for getting help on how to use help.

Context-sensitive help is implemented in Win+Drive. Key ~1

can be used to open a help topic that corre-

sponds to the actual situation of the user.

To get help on the basic blocks the item

Block Help

in the

Help

menu is provided. Also the help button of the

toolbar can be used. After pressing one of these a cursor will be opened with a help symbol. After clicking on

a block the appropriate help page
Selecting

the About

item from

will

be opened.

the Help

menu will open a dialog with general information about Win+Drive
(Version etc.). Clicking on the logo will display different information about the program (version, build date
etc.) in the box.

4.5

For exiting Win+Drive the menu item

kiting Win+Drive

Exit

from the

File

menu has to be selected. If a project is loaded and

modified it is asked whether it should be saved.

WindI

rive

5.

Creating

Software

Schematics

Building programs using Win+Drive is very similar to creating electrical circuit descriptions. It consists

mainly of two actions:

-

selecting and placing blocks of code onto the schematic

-

and connecting these blocks.

5.1 Placing Software Blocks

Figure 5.1: Block

A block is always the representation of a specific function that is performed by a piece of code. This software
function evaluates input values which are represented by input ports and calculates output values which are
represented by output ports. If the input port of a block is connected to the output port of another then this
block will read the results of this preceding block.

There are two different types of blocks:

-

basic blocks

-

compound blocks.

Basic blocks are the atomic building parts and always represent software code. Compound blocks are repre-

sentations of schematics and are used for dividing the total project into several schematics within a hierachy.

Compound blocks will be described in detail in Chapter 7.
Basic blocks are organized in groups. Since there can be a large number of different basic blocks its easier to

select them if there is this kind of organization and ordering. Groups are normally organized in a way that
basic blocks with similar functions are grouped together (for example arithmetic blocks, logical blocks,
function generators).

For placing blocks onto the schematic two different methods are implemented:

-

placing by drag&drop from the block toolbar

-

and selecting from the insert menu.

5.1. ITooibar

Placing Blocks by Drag&Drop from

the

Block

To place a block from the Block Toolbar perform the following actions:

-

first select the appropriate group by clicking an icon of the left side of the Block Toolbar. Now the right

half of this

-

select a block from the toolbar by moving the mouse onto its icon and pressing the left mouse button. The

toolbar

will display the members of this group

mouse cursor will change to a symbol representing a block

-

hold down the left mouse button and

move

the mouse to the place within the schematic the block should

be placed (Drag action)

-

At this point release the mouse button. The block will be placed at this point (Drop action).

If the mouse is positioned on a point where the block cannot be placed (outside the client area of a schematics
window) the mouse cnrsor changes to a symbol showing that no drop action is possible.

17

GEI-100340

5

1.2 Placing Blocks using the

To select a block from the

-

first open

the Insert

Insert

Menu and select the appropriate group. Now a submenu is opened showing the

lnserf

Menu

menu act as follows:

members of this group.

-

select one of them by clicking the menu item. The cursor changes to a symbol representing a basic block.

-

move the mouse to the place the block shall be inserted

-

then click the left mouse key. The block is now inserted at this place,

If you want to stop this action after you have selected a block press the

EST

key.
The groups and blocks that can be selected are defined by definition files which are read and evaluated during
the startup of Win+Drive. To load during a

Basic Block

from the

File

menu can be selected. This basic block will only be available during this session.

W&Drive

session an additional basic block the menu item

Load

To make it generally available it has to be added to the define directory.

5.2 Connecting

S&ware

Blocks

Connection lines between blocks are the graphical representation that one block is evaluating the results of
another one for its own calculation. Therefore connections are always done between the output port of a block
and the input of the next one. One output can be connected to several inputs.

For drawing a connection perform the following actions:

-

place the mouse onto the port of one block

-

press together the

-

while pressing

CXXL

key and the left mouse button

CTRI,

and the left mouse key move the mouse to the port

that

shall be connected. During

this movement a direct line is drawn from the starting point to the actual mouse position

-

after the mouse pointer has arrived at the port that shall be connected release the left mouse button. Now a
rectangular connection line that doesn’t overlay blocks is drawn between the two ports.

If an output shall be connected to several inputs, first draw the connection from this output to one input. Then
start a new connection from a point of this existing connection line to the next input. The starting point will
get the junction of the two connection lines.

Connection lines can also be created between blocks (instead of the ports of blocks). This is used for changing
the execution order (see chapter 8). Creating these lines is done by pressing the left mouse button within the
block center of the block that should be executed first. After holding down the mouse button and moving the
mouse to the block that has to be executed after the first one, the button is released. Now a connection line
between the two blocks is drawn. A virtual output and virtual input are created for this purpose.

WintDrive

5.3 Placing Text and labels

In order to have comments on a schematic for explanation texts and labels can be placed. Both have no
function for the code generation and are provided only for readability. Texts and labels are nearly identical;
the only difference is that labels are linked to blocks while texts are not.

53.1

Placing a Text

For placing a text perform the following actions:

-

select the menu item

Text

from the

Insert

menu. The cursor changes to four arrows pointing to the

middle.

-

move the mouse to the point within the schematic the text should be placed

-

click the left mouse button at this point. Now a text “Comment on scheme“ is inserted

-

to change the

initial

string of the text you have to modify it as decribed below.

To cancel this action, press the ESC key.

53.2 Placing a label

To insert a label the following actions have to be performed:

-

select the menu item

-

move the mouse over the block the label should be linked to.

-

click the left mouse over this block. Now a label with the text “Comment on Block [blockname]“ is

Label

from

the Insert

menu. The cursor changes.

inserted below this block.

-

to change the initial string you have to modify it.

To cancel this action press the

5.3.3 Modif’jGng

the Text

ESC

key.

To change a text or label, the appropriate item has to be selected by clicking the left mouse button on it. The
color of the selected item changes to red. By double-clicking or by pressing the right mouse button, a dialog is
opened for entering the new string.

Figure 5.3.3.1: Change Text Dialog

Enter the new text in the

Cancel

leaves it unchanged.

text

field. Closing the dialog by the

OK

button will change its value, while pressing

A text can consist of several lines. The font cannot be changed.

5.3.4 Moving Texts or Labels

To move a text or label to a new position, first it has to be selected by clicking the left mouse button. Then by
holding down the left mouse button while moving the mouse it can be moved to a new position. The move­ment is finished by releasing the left mouse button.

19

GEL100340

5.4 Editing the

Ports

of Blocks

Section 5.2 above explained that the ports of blocks represent input and output variables of the underlying
piece of code and that these ports can be connected together. Drawing a connection line is the most common
operation on the ports of blocks. Other operations are available by opening the ports dialog.

5.4.1 Opening the Ports Editor Dialog

The ports dialog for a block is opened by double-clicking a block or by selecting a block, pressing the right
mouse button to open the context sensitive menu and selecting

Ports..

from this menu. The ports dialog is

used for changing properties of all ports of one block

Figure

5.4.1.1: Ports

Editor Dialog

Within the Ports Editor dialog there are two lists that include all input and output ports. After selecting one of
the ports its properties can be changed by the control elements in the middle of the dialog window. The port
that is selected immediately after opening this dialog is determined by the mouse position at the time the

block was double-clicked or the right mouse button was pressed. Thus the user can determine the initial

selection by double-clicking a port of the block.

5.42 Setting the

Putt

Connection

For each port the type of connection can be changed by selecting an item of the drop down list box. The
following selections are available:

-

None: the port has no connections. Output ports can be left open (if the result is not used). Input ports
have always to be connected to something.

-

Variable: a variable is used for connecting the schematic to the embedding program of the target system.
Variables are described in detail in Chapter 6.

-

Tag: a tag is a connection that is done by setting the same tag on different ports within one schematic.
Tags are useful for connections to many ports. All ports that share the same tag string are connected.

-

Connection line: this choice is selected if a connection line was drawn. Setting the combo box to this
value will cause an error after closing the dialog.

-

Constant: the input of a block will be set to a constant value. Setting an output port to a constant will

cause an error message after closing this dialog.

20