users manual - instabus eib visualization software

User’s Manual

instabus EIB Visualisation Software

The information contained in this manual is subject to change without notice. SIEMENS AG reserves the right to make changes without notification to its users. The software described in this document and/or the libraries resp. data bases used are provided under a licensing agreement and an obligation to maintain secrecy. Software and/or libraries and data bases may only be used and copied according to the licensing agreement. Copying the software to another medium is not permitted except if explicitly authorised by the licensing agreement or the obligation to maintain secrecy. The customer is allowed to make one backup copy of the software. No part of this manual and/or the data bases may be reproduced, stored in a retrieval system, or transmitted in any form or by any means, electronic, mechanical, photocopying, recording or otherwise, without the prior written consent of SIEMENS AG. © Copyright 2000 SIEMENS AG. All rights reserved. PP (Programmer’s Platform) is licensed by Schlaps & Partner GmbH. All rights reserved. MGX-Lib is licensed by Micrografx, INC. Copyright 1987-1995 by Micrografx, INC. All rights reserved. Btrieve is licensed by Novell, Digital Research System Group. Copyright 1990-1995 by Novell, Digital Research System Group. All rights reserved. Novell is a registered trademark of Novell, INC. Microsoft is a registered trademark and Windows is a mark of Microsoft Corporation Adobe, Adobe Type Manager are registered trademarks of Adobe Systems, INC. Micrografx is a registered trademark and Micrografx Draw Plus and Micrografx Designer are registered trademarks of Micrografx, INC. PaintBrush is a registered trademark of the Z-Soft Corporation.

® is a registered trademark of the European Installation Bus Association, Brussels. instabus® is a registered trademark of Siemens AG, for which the members of the “Insta Community” have the right of joint use. User’s Manual Visualisation Siemens instabus EIB Version 1.1 December 2000

Visualisation Table of contents

Siemens instabus EIB i

Table of contents

1 General.................................................................................................... 1-1

1.1 Graphic Formats .................................................................................1-1 1.2 Fonts...................................................................................................1-3 1.3 Screen Output ....................................................................................1-4 1.4 The Graphic Card of a PC ...................................................................1-5 1.5 Printer Output.....................................................................................1-8 1.6 Principles of Visualisation ...................................................................1-9 1.7 Performance Characteristics of the Visualisation .............................1-11 1.8 Features of the Visualisation Software.............................................1-12 1.9 Hardware and Software Requirements............................................1-13 1.10 Operator Input Release and Operator Process Communications 1-15 1.11 Parameterisation of the Process Items ..........................................1-16 1.12 Static Images ..................................................................................1-17 1.13 Dynamic Image Elements ..............................................................1-18 1.14 Image Display and Image Updating................................................1-20 1.15 Printing out Logs and Event Messages..........................................1-21 1.16 Available Versions...........................................................................1-22 1.17 Additional Functions .......................................................................1-23

2 Notes on the Visualisation.................................................................... 2-1

2.1 Notes on Status Recording with the Visualisation .............................2-1 2.2 Notes on Command Output with the Visualisation ............................2-4 2.3 Notes on the Start-Up Performance of the Visualisation....................2-8 2.4 Notes on ETS Project Planning...........................................................2-9 2.5 Connecting the Visualisation to the Bus System .............................2-10 2.6 Location Inside the Bus System.......................................................2-11 2.7 Line and Zone Overlapping Telegrams.............................................2-13

3 Preparation ............................................................................................. 3-1

3.1 Installation of the Visualisation ...........................................................3-1 3.2 Generating a new Project ...................................................................3-5 3.3 Importing a Project from Disk.............................................................3-6

4 Taking Over Bus Device Data ............................................................... 4-1

4.1 Read In Bus Device Data – General....................................................4-1 4.2 Read In Bus Device Data – from Bus Devices ...................................4-2 4.3 Read In Bus Device Data – from the ETS Data Base .........................4-8 4.4 Verification of the Bus Device Data..................................................4-12

Table of contents Visualisation

ii Siemens instabus EIB

5 Creating Project Data............................................................................. 5-1

5.1 Structural Principles of Projection...................................................... 5-1 5.2 Using the Toolbox.............................................................................. 5-3 5.3 Defining of Units ................................................................................ 5-4 5.4 Defining of Status Texts .................................................................... 5-5 5.5 Defining of Hint Texts........................................................................ 5-7 5.6 Defining of Conversion Functions...................................................... 5-7 5.7 Defining of Data Types .................................................................... 5-10 5.8 Single-State Messages/Commands................................................. 5-12 5.9 Multi-State Messages/Commands .................................................. 5-14 5.10 Measurement Values/Set Commands/Counters ........................... 5-18 5.11 System Values ............................................................................... 5-21 5.12 User Defined Counters .................................................................. 5-22 5.13 Defining of Process Items ............................................................. 5-26

6 Creating Pictures .................................................................................... 6-1

6.1 Working with Pictures........................................................................ 6-1 6.2 Using Existing Pictures and Drawings ............................................... 6-3 6.3 Creating Static Background Pictures ................................................. 6-4 6.4 Working with the Drawing Tools ....................................................... 6-6 6.5 Settings with Graphical Elements...................................................... 6-8 6.6 Moving/Modifying an Element........................................................... 6-9 6.7 Marking Multiple Elements.............................................................. 6-10 6.8 Copying Elements............................................................................ 6-11 6.9 Deleting/Cutting Element................................................................. 6-13 6.10 Combining/Splitting Block.............................................................. 6-13 6.11 Rotating/Mirroring Elements.......................................................... 6-14 6.12 Objects – Auxiliary Functions......................................................... 6-15

7 Define Dynamical Picture Elements..................................................... 7-1

7.1 Image Variables – General ................................................................. 7-1 7.2 Output Variable (EIB Library).............................................................. 7-3 7.3 Bar Variable (EIB Library) ................................................................... 7-6 7.4 Diagram Variable (EIB Library) ........................................................... 7-8 7.5 Picture Variable (EIB Library)............................................................ 7-10 7.6 Meter Variable (EIB Library) ............................................................. 7-12 7.7 Symbol Variable (EIB Library) ........................................................... 7-14 7.8 Text Variable (EIB Library) ................................................................ 7-16 7.9 State Variable (EIB Library) .............................................................. 7-17 7.10 Switch Variable (EIB2 Library)........................................................ 7-19 7.11 Counter Variable (EIB2 Library) ...................................................... 7-22 7.12 Week Variable (EIB2 Library, Time Manager Required)................. 7-25


Siemens instabus EIB iii

7.13 Video Variables (VIDEO Library, Option).........................................7-27 7.14 Loading/Saving Variables from the Project Library .........................7-38 7.15 Assignment of Image Variable ? Process Item .............................7-38

8 Other Functions...................................................................................... 8-1

8.1 Starting the Visualisation ....................................................................8-1 8.2 Simulating the Visualisation................................................................8-2 8.3 Password Protection of Project ..........................................................8-4 8.4 Changing User Names........................................................................8-7 8.5 Automatic User Log-Off .....................................................................8-7 8.6 Automatic Start of Programme/Project/Picture ..................................8-8 8.7 Programme protection......................................................................8-10 8.8 Logging Event Messages .................................................................8-11 8.9 Event Messages on the Screen .......................................................8-12 8.10 Storing Event Messages in File ......................................................8-14 8.11 Printing Event Messages................................................................8-15 8.12 Audible Signal .................................................................................8-20 8.13 Status Display in the Message Window ........................................8-21 8.14 Keyboard Operation Only ...............................................................8-22 8.15 General System Settings................................................................8-24 8.16 Acknowledging Events...................................................................8-25

9 Completion of Project Planning ........................................................... 9-1

9.1 Exporting a Project to Disk .................................................................9-1 9.2 Exporting/Importing Individual Data....................................................9-2 9.3 Printing the Project Data.....................................................................9-3

10 Installation of Options....................................................................... 10-1

10.1 Activating the Options During a New Installation...........................10-1 10.2 Activating Options Later .................................................................10-1 10.3 Checking of Released Options .......................................................10-2

11 The “Device Monitoring” Option ..................................................... 11-1

11.1 Features..........................................................................................11-1

12 The “Event Programme” Option...................................................... 12-1

12.1 Features..........................................................................................12-1 12.2 Programme Editor ..........................................................................12-2 12.3 Structure of an Event Programme..................................................12-3 12.4 Deactivation of the Event Programme ...........................................12-5 12.5 Notes on Programming ..................................................................12-6 12.6 Completion of Project Design.........................................................12-7

13 The “Calculations/Logic Operations” Option ................................. 13-1

Table of contents Visualisation

iv Siemens instabus EIB

13.1 Instruction Set................................................................................ 13-2 13.2 Event Programme Monitoring ....................................................... 13-8 13.3 Incorrect Programming ................................................................ 13-11

14 The “Time Manager” Option ............................................................ 14-1

14.1 Features ......................................................................................... 14-1 14.2 Structure ........................................................................................ 14-2 14.3 Editing Day Programmes ............................................................... 14-3 14.4 Setting Day Programme .............................................................. 14-13 14.5 Display ......................................................................................... 14-21 14.6 Parameterisation of Week Variable.............................................. 14-24 14.7 Exiting the Time Manager............................................................ 14-27 14.8 Deactivating the Time Manager................................................... 14-27 14.9 How to Follow up Jobs................................................................ 14-28

15 The “Value Recorder” Option........................................................... 15-1

15.1 Structure ........................................................................................ 15-3 15.2 Creating New Groups .................................................................... 15-4 15.3 Editing Existing Groups.................................................................. 15-5 15.4 Deleting Existing Groups ............................................................... 15-6 15.5 Exporting Existing Group/Importing Groups .................................. 15-6 15.6 Defining Tracks .............................................................................. 15-7 15.7 Correcting Existing Tracks ............................................................. 15-8 15.8 Deleting Existing Tracks................................................................. 15-9 15.9 Parameterise Display ................................................................... 15-10 15.10 Type of Display .......................................................................... 15-12 15.11 Saving/Loading Display Parameters........................................... 15-18 15.12 Displaying of Data ...................................................................... 15-21 15.13 Exporting Data in EXCEL V Format............................................ 15-28 15.14 Printing Recorded Data.............................................................. 15-29 15.15 Settings for Tool Bar .................................................................. 15-29 15.16 Closing Value Recorder.............................................................. 15-29

16 The “Event Monitoring” Option ....................................................... 16-1

16.1 Features ......................................................................................... 16-1 16.2 Displaying and Processing Events................................................. 16-2 16.3 Storing Events in a Data Base ....................................................... 16-4 16.4 Deleting Events from the Current Data Base ................................ 16-6 16.5 Selecting of the Desired Data Base............................................... 16-7 16.6 Defining Display Filters .................................................................. 16-9 16.7 Graphical Analysis of the Event Data Base.................................. 16-11 16.8 Parameterise Display ................................................................... 16-14 16.9 Exporting Data into EXCEL V Format .......................................... 16-15


Siemens instabus EIB v

16.10 Printing the Event Data Base......................................................16-16 16.11 Exporting/Importing/Deleting Event Files...................................16-17 16.12 Settings for Tool Bar...................................................................16-20 16.13 Closing Event Monitoring ...........................................................16-20

17 The “Network” Option...................................................................... 17-1

17.1 Introduction.....................................................................................17-1 17.2 TCP/IP .............................................................................................17-2 17.3 Requirements .................................................................................17-5 17.4 Installation of the Server.................................................................17-6 17.5 Editing Box .....................................................................................17-8 17.6 List of the Registered Visualisation Servers...................................17-8 17.7 Local Parameter..............................................................................17-9 17.8 Conclusion of the Parameterisation................................................17-9 17.9 Process Items...............................................................................17-10 17.10 Installation of a Client .................................................................17-11 17.11 NU Tool.......................................................................................17-12 17.12 Network Configuration ...............................................................17-14 17.13 Converting a Project ...................................................................17-17

18 Option „Counter/Consumption Statistics" ..................................... 18-1

18.1 Counter Variable .............................................................................18-1 18.2 Features..........................................................................................18-2 18.3 Consumption Statistic ....................................................................18-4 18.4 Control Buttons ..............................................................................18-6 18.5 Activating the Statistics ................................................................18-11 18.6 Operating the Statistics ................................................................18-12 18.7 Printing or Saving Statistics automatically (time-controlled)........18-13

19 Auxiliary Programmes ....................................................................... 19-1

19.1 EIBTOOL.........................................................................................19-1 19.2 Version Display ...............................................................................19-6 19.3 System Configuration .....................................................................19-8

20 Predefined Texts ................................................................................ 20-1

20.1 Unit Texts .......................................................................................20-1 20.2 Status Texts....................................................................................20-2 20.3 Status Lists.....................................................................................20-4

21 Index.................................................................................................... 21-1

Visualisation

Siemens instabus EIB 1-1

1 General

1.1 Graphic Formats Graphics generated or edited on a PC can be subdivided into two categories:

vector graphics In vector graphics the individual graphic elements are repre-

sented by a graphical description of the element. That is to say the picture is stored in a file in form of a list of individual elements or the list data is represented on a screen or printer. For example, a line is described by the following parame-ters:

?? code for the line ?? co-ordinates of the starting point of the line (x1/y1) ?? co-ordinates of the ending point of the line (x2/y2) ?? line width, line type, line colour ?? representation of the starting and ending point ?? additional information

The contents of the parameters and the coding of this data depend on the vector graphic format used.

formats Common vector graphic formats are e.g.: ?? *.drw (= Micrografx Designer/Draw) ?? *.cdr (= Microsoft Corel Draw) ?? *.dxf (= AutoCAD dxf) ?? etc.

General Visualisation

1-2 Siemens instabus EIB

advantages ? The individual elements of the picture can be accessed

and edited at any time. ?? The size of the picture can be readily modified propor-

tionally. ?? Relatively little memory space is required for one picture.

disadvantages ? Highly complex pictures with lack of structure such as

e.g. photographs can only be represented relatively inexactly by using several individual elements.

?? Long display building time with complex graphics. pixel graphics Each picture is represented by a number of individual dots

(=pixel). The more pixels are used for the representation of the picture the sharper and more detailed the picture will be. Unlike the vector graphics in pixel graphics the whole picture is represented or stored as information in form of a pixel matrix. Each pixel represents the state of this graphic display element (in b&w representation light/dark, in colour repre-sentation the colour e.g. as an 8 bit value).

formats Common pixel graphic formats are e.g.:

?? *.tif (= Tag Image File) ?? *.bmp (= Windows Bitmaps) ?? *.pcx (= PC Paintbrush) ?? etc.

advantages ? Photos and other graphics having without defined struc-

tures can be represented very exactly. ?? The speed of synthesising the image is independent of

the content of the graphic. disadvantages ? Changes as to the size of the graphics may lead to an

incorrect representation of the details of the picture. ?? A lot of memory space is required for one picture.

Visualisation


1.2 Fonts The font represents the graphical design of the numbers, symbols and characters of the alphabet. Each font has its own individual outline. Fonts are available in different sizes and types. The font size is measured in points, one point representing 1/72 inch (approx. 0.4 mm). Font styles are e.g. “bold” or “italic”. Windows supplies different fonts which are available as soon as Windows is installed on a PC. Among these fonts are the following:

vector fonts ? Vector fonts can be scaled up or down to any size

?? Vector fonts are often used in connection with plotters, sometimes with matrix printers.

printer fonts ? Dot matrix and laser printers have one or two built-in

printer fonts, while postscript printers have several fonts. When a printer has been installed, the printer fonts appear in the font list of the Windows application.

true type fonts ? They can be scaled up or down to any size and they

appear on the screen exactly as in the printout (WYSIWYG =„What you see is what you get”). ?? If you use true type fonts, the transfer of your

applications is better and their printouts look identical on different printers.

download fonts ? Download fonts (softfonts) must be installed by using the

installation programme delivered with these fonts.



1.3 Screen Output Today’s screens (monitors, terminals) have a cathode ray tube for the display of the image similar to the common TV set. Especially with laptops, plasma displays or LCDs (LCD = Liquid Crystal Display) are used instead of the CRT, which allow the construction of flat displays.

features The following features have to be considered with a

monitor: ?? colour or monochrome ?? digital or analogue ?? fixed or variable synchronisation ?? size ?? resolution ?? refresh rate ?? low radiation

colour/ monochrome Monochrome means the monitor can display information

only with one colour or in grey-scale values (e.g. with the Hercules graphic card). Colour monitors require the use of a corresponding graphic card (e.g. EGA or VGA).

digital/ analogue Depending on the graphic card, information is transmitted

from the graphic card to the monitor in digital mode (e.g. EGA) or in analogue mode (e.g. VGA).

synchronisation Monitors with a fixed frequency work only with one fixed

readjusted frequency. Multisync monitors, however, can adjust themselves to frequencies and resolutions and can work both in digital and analogue mode. Therefore it is not necessary to buy a new monitor when a new graphic card is used.

size The size of a monitor is the screen diagonal in inches.

Common sizes are 14 up to 21 inches.

Visualisation


resolution Each monitor generates its image from individual dots

(pixels). The more dots are used, the clearer the image is represented on the screen. For a high resolution, of course, the suitable graphic card must be used.

refresh rate In order to keep the image visible on the screen, it must be

rewritten in short time intervals. The refresh rate indicates how often per second the image is rewritten. For screens exerting little strain on the eyes (no flickering of the screen) the refresh rate should be 70Hz at least.

low radiation The following radiation is emitted during operation of a

cathode ray tube: The so called “soft” X-rays are absorbed by the glass surface. On the other hand, electrostatic and magnetic emissions occur more often. How intensively the CRT generates such fields can be checked by running your hand over the surface of the screen some minutes after switching it on. If it crackles or if there is a spark discharge, it is no low radiation monitor. In addition, a monitor emits low frequency electric fields which are generated during display change and horizontal flyback. If a new monitor is purchased attention should be paid to the fact that it is a “low radiation” one.

1.4 The Graphic Card of a PC function The screen and the graphic card plugged into the system

unit form an integrated whole and must be adjusted to each other. The monitor must be able to interpret and display the incoming signals of the graphic card. This is why graphic cards must process the information from the computer and turn it into a form which can be displayed on the screen. The screen driver is software which



controls the graphic card and gives full access to the graphic card’s capabilities.

HerculesGraphicsCard

EnhancedGraphicsAdapter

VideoGraphicsArray

— —

80x259x14 matrix

80x258x14 matrix

80x258x14 matrix

132x446x12 matrix

80x3412x20 matrix

1982Available since

Name

Graphic resolution

Refresh rate

Short description HGC EGA VGA Super VGA 8514/A

Origin

Operation modes

Max no. of colours

Text resolution

Video signal

Line frequency

Hercules

720x350 640x350 640x480 800x600 1024x768

text/graphics text/graphics text/graphics text/graphics text/graphics

none

digital

18.43 kHz 21.85 kHz 31.5 kHz 31.5 kHz 35.5 kHz

50 Hz 60 Hz 60 Hz 70 Hz 43 Hz

digital analog analog analog

1984

IBM

16 o.of 64

1987

IBM

256 o.of 262t

1988

Vesa Group

16 o.of 256

1989

IBM

256 o.of 262t

Hercules Graphic Card The best-known and by far the most widely used

monochrome graphic card is the Hercules Graphic Card (HGC). For word-processing or for data base programmes the Hercules Graphic Card is sufficient even today because colour display is not needed here. The Hercules Graphic Card cannot be recommended for professional use.

colour graphic cards In principle there are three different standard modes with

colour graphic cards today: CGA = Colour Graphic Adapter EGA = Enhanced Graphic Adapter VGA = Video Graphic Array

CGA standard The CGA standard (obsolete) was designed by IBM for their

own PCs. In the simple version 320 x 200 pixel can be addressed, and four colours – out of 16 possible colours – can be displayed. If the number of colours is limited to two, even 620 x 200 pixels can be displayed.

Visualisation


EGA standard The EGA standard (also obsolete) has a lot more features

than the CGA standard. Besides a higher resolution of 640x350 pixels it is able to display 16 colours out of 64 shades of colour.

VGA standard Unlike CGA and EGA (digital) the VGA card controls the

screen in analogue mode. Therefore this card can display up to 256 colours from a range of 262.144 shades of colour. To use the VGA card with its total variety of colours not only an analogue monitor is required but the graphic card must also have 1 Mbyte memory of its own.

Super VGA The Super VGA card is becoming more and more popular, It

has a resolution of 800 x 600 pixels, but is only able to display 16 out of 256 shades of colour.

8514/A adapter The IBM de luxe model consists of the 8514/A adapter and

the 8514 monitor with 1024 x 768 pixels and 256 possible colours. In the meantime other manufacturers also offer 8514/A compatible cards.

the intelligentsia The so called intelligent graphic cards have their own

processor and reduce the workload of the processor of the central unit.



1.5 Printer Output general Today, printers are the most important output device. They

can basically be subdivided in impact printers and non-impact printers.

printers

impact non-impact

dot matrix

laser

ink jet

thermo transfer

needle matrixfully formed char.

daisy wheel

golf ball

type basket

impact printers Impact printers carry the character to be printed as a

complete element on the writing device (fully formed character printer) or the characters are combined from single dots (needle matrix). Representatives of this group are:

?? daisy-wheel printers ?? golf-ball printers (of no importance in the PC

sector) ?? type-basket printers (of no importance in the PC

sector) ?? needle printers

non-impact printers Non-impact printers combine the characters to be printed

from single dots (dot matrix). Representatives of this group are:

?? thermal printers ?? ink-jet printers ?? laser printers

In the b&w section the laser printer has become as a standard. In the colour section the most frequently used type is the ink-jet printer.

Visualisation


resolution A quality feature of this kind of printers is the number of

dots per inch, called dpi. The normal resolution of modern printers today is 300 dpi in both the x and y directions. This resolution is sufficient for the most applications. In the DTP section (DTP = Desktop Publishing) often higher resolutions, e.g. up to 1200 dpi, are required.

1.6 Principles of Visualisation Visualisation Visualisation means the indication of states (monitoring) and

the input of setpoints (controlling, operation). data type With the data type the kind of the data to be displayed (i.e.

EIS type) is defined. In addition, units and status texts are selected. In general these states can be subdivided into the following data types (i.e. kinds of information):

?? single-state messages/commands: on/off, upwards/downwd., open/closed, up/down, ...

?? multi-state messages/commands: fan off/stage1/stage2/stage3/stage4, ...

?? measurement values/set commands/counter: temperature, lux values, wind velocity, current, ...

?? system values date, time

?? user defined counters: 8, 16 ,32 bit counter

process item The process item is the “interface” between the informa-

tion to be monitored/controlled and the graphical display on the screen. For each item of data to be displayed/controlled a process item has to be defined. The following parameters have to be assigned to this process item:

?? data type ?? hint texts ?? interface with the bus (group addresses) ?? additional information (e.g. automatic display

selection ,...)



static images As a visual help for the operator, static background images

can be generated or imported. These images can show the ground plan of the area to be visualised or a 3D represen-tation of a room, for example. Current states cannot be represented by the static background images.

dynamic image elements With the help of dynamic image elements or variables the

information/states desired are displayed on the screen or set by the user. For this purpose you can choose from the following variable types:

?? output variable for the presetting of values ?? bar variable for the display as bar chart ?? diagram variable for the display in the form of a

diagram ?? picture variable to switch to any screen ?? meter variable for the display as an

“analogue meter” ?? symbol variable for the display of states as

symbols ?? text variable for the display of states as

text ?? state variable for the display of multi

state messages/commands as text ?? switch variable to perform various switching

procedures ?? counter variable for the display of counting values ?? week variable for time-controlled switching

The individual types of variables can be placed on any screen position and always cover existing static background images. With the parameterisation the appearance, colour, function, etc. are adjusted. The size can be modified in the usual way by dragging an item with the mouse. Each variable must be assigned to a process item which is given to the variable via “drag and drop” from the process item list.

Visualisation


1.7 Performance Characteristics of the Visualisation

Building Services Management System In common electrical installations a power cable is first carried from the counter module or from the distribution box to a switch and then to the actual load, such as a lamp, a shutter driving mechanism, a radiator, a fan motor etc. In a building services management system, however, all control devices and loads are networked via the EIB installation bus to a system suited to the electrical instal-lation. Via the instabus EIB, both the direct interchange of information between the stations and the power supply of the control devices (sensors and actuators) are performed. The power cables are directly carried to the loads or to the remote control switches (actuators) installed close to the loads. Besides the control of the electrical energy the instabus EIB also supports the monitoring of the building services systems, the annunciation of operating conditions, malfunctions and an automatic reaction on changes of operating conditions.

Central Display Requirements With conventional electrical installations a central display of operating conditions and a central remote control of all loads can only be realised with high expenditure of technology and money. If, however, all control devices and remote control switches are networked via the instabus EIB, in addition to the decentralised switching also a central display and remote control switching is possible. Once an electrical installation in a building is performed on the base of the instabus EIB, additional requests and requirements are to be expected soon. The owner would like to monitor from a central location e.g.:

?? whether the lights are still on somewhere in the building

?? whether a window shade is still closed somewhere,

?? whether a window or a door is still open somewhere.



He further wants to know exactly in which building, floor, room the lights are still on, and he wants to be able to switch it off from the central location. When building services systems are monitored, the user would like to know:

?? which installation has been witched off due to a malfunction,

?? in which part of the building the defective installation is located,

?? when the malfunction occurred. The user requires all this information not only as textual information but also as graphical information which can be checked at a glance, e.g. represented as building, floor or room ground plans with overlaid symbols and texts. The flashing of a display element identifies especially impor-tant information.

1.8 Features of the Visualisation Software Some of the features of the Visualisation software are:

?? one central Visualisation/operating station or several stations in a network,

?? generation and parameterisation of the process items to be displayed,

?? reading in of images as pixel or vector graphics, ?? an integrated image editor for vector graphics, including a

macro library, ?? various dynamic image elements (image variables) for

displaying current states, values, information, ?? printing out of event logs, overview logs, parameter logs

and colour screen dumps, ?? display, operation, logging in several languages, ?? powerful additional functions.

Visualisation


1.9 Hardware and Software Requirements operating system This software can be run on a commercial PC with the MS-

DOS 6.2 operating system and MS-Windows 3.1 (or MS-Windows for Workgroups 3.11).

processor It is recommended to use a PC as powerful as possible (at

least a PC 486DX – for CAD/CAM) to be able to fully benefit from the features of the software.

memory capacity The memory capacity must be 8 MB at least to guarantee

perfect working for all functions. internal bus The internal bus system may be of the VL, ISA, or EISA

type. Please follow the notes on the PCI bus in file:

interface To connect the PC to the instabus EIB a serial interface is

required. If your computer is equipped with so-called FIFO interface modules, please refer to the notes in file:

graphic card For a graphic card a Windows accelerator card with at least

256 colours at 1024x768 pixels is recommended. Minimum resolution: 800x600 pixels.

monitor The colour monitor should have a screen diagonal of at least

17 inches. bus connection The Visualisation PC is connected to the instabus EIB via an

RS232, N148 or UP147/148 interface. recommended hardware A list containing recommended hardware configurations is

available by Siemens



config.sys The following config.sys file shows an operational configu-

ration on a standard PC. If necessary, further entries are required for additional peripheral units (e.g. sound card, CD-ROM, etc.):

DEVICE=C:\DOS\HIMEM.SYS FILES=60 BUFFERS=60 STACKS=9,128 COUNTRY=49,,C:\DOS\COUNTRY.SYS DOS=HIGH

autoexec.bat The following autoexec.bat file shows an operational

configuration on a standard PC. If necessary, further entries are required for additional peripheral units. After switching on the Visualisation PC and processing the following autoexec.bat file, Windows can be called immediately (try it first, add the “WIN” entry only if the configuration is working):

SET TEMP=C:\DOS PATH=C:\WINDOWS;C:\DOS;C:\; KEYB.COM GR 437 C:\DOS\KEYBOARD.SYS C:\VISUALIS\SD-EYE.COM WIN

To automatically start the Visualisation software see “Automatic Start of Programme/Project/Picture” in Chapter 8 “Other Functions”

topical information A “Read me” file is generated in the programme group

“Visualisation instabus” during installation. It contains recent notes on hardware and software. The file is initiated by double clicking on the icon.

Visualisation


1.10 Operator Input Release and Operator Process Communications

Anybody who wants to work with the Visualisation software has to log in with his password first. According to the assigned operator priority he gets access to all functions or only to some functions in the language assigned to him. If the Visualisation software is loaded in a new installation and is started for the first time, the following steps are to be carried out until images with dynamic image elements are available, which finally can be activated and updated automatically by process events:

?? open a new project, ?? parameterise the interface to the instabus EIB, ?? determine the bus devices and parameterise the

process items, ?? read in or generate static background images, ?? generate and enter dynamic image elements into

the static images, ?? assign the dynamic image elements to the process

items, ?? store the completed images in the project library, ?? activate the automatic image switching triggered

by event information. If a user logs off the system or if he has not made any operator entries during a definable time interval, operator inputs to the Visualisation software are blocked again. This function may also be deactivated (see Chapter 8: “Automatically User Log-Off”).



1.11 Parameterisation of the Process Items group address With the instabus EIB the control devices (sensors) normally

transmit the change of state by giving one single group address. The remote switches (actuators), however, may be addressed via multiple group addresses.

process item All group addresses assigned to the output of an actuator

are therefore summarised to one “process item” whose state always corresponds to the current state of the actuator’s output. The assignment of group addresses to sensors and actuator outputs is made during the project planning and configu-ration of an installation using the EIBTool Software (ETS). The ETS data configured can directly be taken over by the Visualisation. The following data is taken over:

?? existing bus devices and their commentaries ?? existing objects and their settings ?? projected group addresses and their commentaries

Additionally the Visualisation software has been completed with its own tool software. This tool software detects independently which devices are connected to which bus lines and reads out their physical addresses and group addresses. Then the determined data can be completed by the user with explanatory notes and control information and be assigned to the process items with the help of clearly structured menus.

data type An important parameter for each process item is the related

data type. Here we distinguish between:

?? single-state messages/commands, ?? multi-state messages/commands, ?? measurement values/set commands/counter, ?? system values, ?? user defined counters

Visualisation


The data type determines to which dynamic image element (image variable) a process item can be assigned and how changes of states or changes of values can be displayed on the screen.

simulation The tool software also contains the simulation of changes of

states of process items. Therefore completed images with dynamic image elements can be tested even if no EIB network is connected.

1.12 Static Images Static images are images or parts of images which cannot be modified by process events. An image represented on the screen of a Visualisation station can be combined from components of three overlapping image levels:

?? a static background image, ?? static image components lying in front of the

background image. These static image components were generated by the drawing programme integrated in the Visualisation software (image editor) and cover parts of the background image,

?? the dynamic image elements (image variables) which can be changed depending on the process item states. They cover all image elements lying underneath them, provided if their current state is not “invisible”.

As background images pixel graphics (e.g. scanned photos or drawings) with the “BMP” extension or vector graphics with “DRW” extension can be imported into the Visualisa-tion software. Image files with other extensions can be converted with the help of conversion programmes (which are included in e.g. PAINTBRUSH or DESIGNER) into files with one of the permitted extensions. Static images like building or floor ground plans can also be generated by the user himself by using the integrated drawing programme (image editor) for vector graphics. Images or parts of images which will used several times can be stored in a “macro library” as image macros and can be reloaded and do not have to be redrawn.



1.13 Dynamic Image Elements Dynamically varying elements (image variables) may be inserted into static images. Depending on the state of the process, the representation of an image variable changes (shape, colour, text, flashing, etc.). The following image variables are available:

?? output variable, ?? bar variable, ?? diagram variable, ?? picture variable, ?? meter variable, ?? symbol variable ?? text variable ?? state variable ?? switch variable ?? counter variable ?? week variable (only useful in combination with a

timetable programme) output variables With output variables switching commands and control

commands or setpoints and limiting values can be activated, or counter values (digital values) can be set or reset.

bar variables Bar variables make a fast visual comparison possible be-

tween multiple measured values or digital values. Length, width, colour, and alignment of the bars/graph can be preset.

diagram variables Diagram variables show the characteristics of states or

values as a function of time. As with a continuous-line recorder the time characteristics of up to 8 process items can be represented by lines with different colours.

picture variables Picture variables are used for switching to a particular

(preset) screen by the operator. meter variables Meter variables are used for displaying analogue and digital

values on a “pointer-type instrument” (e.g. volt meter, ampere meter, watt meter, thermometer).

Visualisation


symbol variables With symbol variables, the symbol displayed is replaced by

another symbol depending on the state of a process item. (e.g. an off-state switch by an on-state switch).

text variables Text variables are used to display text showing the current

state or value of a process item (e.g. OPEN, CLOSED, OFF, 13.5 C).

state variables The state variables make it possible to display texts which

are related to the current state or value of a group of bits in a multi-state message.

switch variables Switch variables can be used in many different ways such

as screen switching, starting of event programmes, starting of extensions (options), and for the output of control commands. The different states of the switching variable can be assigned to different bitmap graphics. When a new image is generated, the last step is selecting the image variables from the variables’ library, inserting them into the image at the desired position, and adjusting the size and appearance, if necessary. Finally, the variable is assigned to a process item.

Counter variables The counter variables make the display of counter variables

possible. week variables The week variables make the display of the text possible

which equal the current state or value of a bit group in a multistage message.



1.14 Image Display and Image Updating The completed dynamic images stored in the project library can then be displayed and updated on the screen of the Visualisation station in various types:

?? you can define which “start-up image” shall be displayed on the screen after booting the PC;

?? the user may select the image to be displayed from a list box;

?? by selecting a screen switching variable in a current displayed image the user may trigger the display of the corresponding image;

?? the automatic display of images by process events may be released.

If images are automatically displayed by process events, an event received by the Visualisation station automatically triggers the display of the image defined in the process item. If the user does not want each event to trigger the display of a new screen, s/he may define from which priority level on an event will trigger the display of a new screen. The display building time of a static image is approximately 2 seconds. This time period depends on the contents of the image and the graphics type. Pixel graphics generally have a shorter display building time than vector graphics. More complex images take longer to build the display than e.g. simple line drawings of ground plans. Afterwards all dynamic image elements (image variables) are updated. This process may take several seconds up to approx. 30 seconds. The time interval depends on the number of image variables contained in the image currently displayed (a max. of 256 variables per image is possible) and on whether the current process information is available in the Visualisation software or whether it has to be scanned from the sensor or actuator first. After the initial update of a screen it will be cyclically updated every 30 seconds for the duration of its display. If events messages of process items – contained in the currently displayed screen – are received, they will be updated immediately.

Visualisation


1.15 Printing out Logs and Event Messages A colour printer on which a dump of the currently displayed screen may be printed out can be connected to the parallel interface.

note This printer must be configured as standard printer. Additionally, this printer can be used for overviews and parameter logs concerning the process items and process-ing functions managed by the system. Additional printers for the event-information printout can be connected. All the changes of states of the process items whose event logging have been released will be logged on these printers. Information for one event requires at least one printed line (80 characters). It contains the date and time, the plain-text identification of the corresponding process item, the new state or value together with the indication whether it is an incoming alarm or malfunction, or whether the alarm or malfunction no longer exists. Following the event information a hint text, optionally projected, can be printed out (up to 4 lines). It may contain information on the steps to be taken by the operator concerning, e.g. who is to be informed and which measures are to be taken to control the situation. The two most recent events are always displayed on the screen in the bottom lines. Additionally, the operator may switch from the image window to a full-screen event window displaying the current event information including hint texts.



1.16 Available Versions For order and delivery we differentiate between:

?? the base version with basic functions and ?? the optional additional functions.

Further we differentiate between the

?? mini version (limited to 100 process items) ?? midi version (limited to 500 process items) ?? maxi version (no limitation of the number of

process items). ?? projection version ?? network compatible version ?? redundancy version

The mini, midi and maxi versions do not differ in their functionality. The mini and midi versions can only manage a limited number of process items (100 or 500). These limitations were introduced to be able to offer the Visualisation software at different price levels, e.g. for training purposes in training locations or for the use in smaller buildings. For reasons of software protection all versions are delivered with a special dongle for the corresponding version.

Visualisation


1.17 Additional Functions In addition to the display of updated images and to the logging of event messages a variety of additional functions for the Visualisation software are offered. They are:

?? dropout monitoring of all bus devices, ?? scheduler programme, ?? event programmes, ?? logic operations and arithmetic calculations, ?? event monitoring with interface to MS-EXCEL, ?? historical value monitoring with diagram

representation, ?? redundant Visualisation stations, ?? overlay and recording of images of video cameras, ?? remote monitoring and remote control. ?? general counters ?? consumption statistics

Visualisation


2 Notes on the Visualisation

2.1 Notes on Status Recording with the Visualisation general The states of an instabus EIB installation to be recorded are

sensed by the Visualisation by „listening” to the bus telegrams. In some bus devices there is the possibility not only to perform, for example, a switching command, but also to start timers which trigger switching commands via a delay or via logic operations with other states.

status objects Therefore an increasing number of applications have their

own „status objects” in which the current control state is represented. However, these objects do not generate telegrams by themselves but must be “read out” cyclically by a read request of the Visualisation. In order to let the Visualisation know which objects are to be read out from which applications, this information can be entered in the „EIBTool” programme. The dialogue box “Define Status Applications” will be displayed by the “Services” ? “Status applications” menu item:

Visualisation


Now the manufacturer of the application is to be selected and the application number, the version number and the object number of the object should be entered which is to be read out cyclically by the Visualisation. The data is taken over via the “Add” button. After all applications have been entered, close the “Define Status Applications” dialogue box via “OK” and generate the system files via “Services” ? “Create system files”. The data entered will now be active, i.e. the Visualisation will read out cyclically the corresponding object from all bus devices which are using one of the indicated applications.

Description of ADDGRPS.TXT If the PPEIBO finds a new device (mask >0x200 or

programme style !=0) while importing ETS2, an already existing ADDGRPS.txt file will probably be read in. The group addresses of the devices will be added to the information gained that way. Information on already existing group addresses will not be changed during this process.

After importing, the cumulated information will be written back into the ADDGRPS.TXT. This way, definitions of the user can be transparently connected with the ETS infor-mation.

Structure of the ADDGRPS.TXT Group address=data type, attributes; commentary group addresses Group address n/m

10/1270 (for a two-level display in the visualisation) Group address n/m/o 10/4/246 (for a three-level display in the visualisation)

data type As in the manual for EIB 0 to 15, 0 attributes R group readable

W group writeable C group is cyclically read (has to be set by the user)

Visualisation


Commentary User text which comprises 64 sign maximally.

It serves the commentary on user actions regarding the file ADDGRPS.TXT and is not related to any ETS commentaries. Also, it will not be displayed as a commentary field for the group address in the visualisation as it is the case with the ETS Commentaries

Example Example of a ADDGRPS.TXT file:

(group address=data type; attributes; possible commentaries)

0/1 =0, RC ;setting: read cyclically 0/2 =0, R ;setting: read 0/3 =0, RWC ;setting: read cyclically, write 0/4 =7, R ;setting: read 0/5 =8, R ;setting: read 0/6 =8, R ;setting: read 0/7 =0, RWC ;setting: read cyclically, write 0/8 =0, RW ;setting: read write 0/9 =0, RWC ;setting: read cyclically, write 1/1 =0, R ;setting: read 15/12 =8, RWC ;setting: internal visualisation address

edit The content of the ADDGRPS.TXT will be used for generat-

ing system files. Thus, changes of features by the projector are still possible after the ETS importation. These features can only be changed manually. The list will only be supple-mented with one new group address when being read in again. Old values will not be changed. In case there are existing pieces of group information from standard appliances, these will be lost through the new settings in the new settings in the ADDGRPS.TXT.

REMGRPS.TXT Description of REMGRPS.TXT:

Optional file, generated by the projector This file will be read by the system while generating the system files after processing the ADDGRP.TXT It writes a group address entry pro line as it does with the ADDGRP.TXT. The entered group addresses will not be taken over into the data basis of the visualisation.

Visualisation


status group address In the process item for this information the same group

address has to be projected which has been entered in the corresponding status object as a “sending” group address.

Note: To make the bus device answer a read request the reading flag must be set in the status object.

2.2 Notes on Command Output with the Visualisation general If the Visualisation is used not only for the display of states,

but also for the output of switching and control commands, the following items are to be considered:

command output If the same process item is used for status display and

switching or control command output, it is always the group address which has been defined as sending (SE) in the process item which is transmitted for the output of switching or control commands. If more than one group address has been set to “sending”, the group addresses are transmitted in the same sequence as they have been entered in the process item.

status display The type of status update after the output of a

switching command or control command is selected in the “Systemconfig.” programme:

Visualisation


EIB parameters In the “EIB parameters” topic the following subtopics are

used to set the parameters:

driver write mode If the group addresses assigned to the process item are

marked as “readable”, the method of updating the new status can be selected, after a switching or control com-mand has been sent:

?? Write, no mirror, reread:

read back new status After a switching or control command has been sent, the

new status is read back by a read request to the “readable” group address of the bus device in question. Then this status is given to the process item. Thus it makes certain that the process item represents the real value from the corresponding bus device and not the set value of the output variable.

Visualisation


?? Write, mirror, reread:

mirror new state and read back The new state or value of the process item is both mirrored

directly from the switching or control command and read back from the corresponding bus device.

?? Write, mirror, no reread:

mirror new state After a switching or control command has been sent, the

state or value output is directly mirrored into the process item. The actual value of the bus device is not read back.

Default setting Write, mirror, reread mirror groups If the group addresses assigned to a process item are

marked as “non-readable”, the method of updating the new status can be selected after a switching or control command has been sent:

?? Mirror none readable groups:

mirror status After a control or switching command has been sent, the status or value is directly mirrored into the process item.

?? Not mirror none readable groups:

do not mirror the status The new status or value is not mirrored into the process

item after a switching or control command has been put out, i.e. the process item does not display the current value!

Default setting Mirror none readable group addresses

Note: If “non-readable” group addresses are used in the process item, the “Mirror ...” setting must be used.

Visualisation


write to unknown group addresses While defining process items you can define group

addresses manually which have not been read in from the bus devices or the ETS project, and are therefore not used in the bus system. These group addresses can be used to start event programmes manually (via an output variable) or to link more than 15 group addresses with an OR function (see Chapter 5 “Define Process Items”). It is, however, required for the Visualisation to send these “unknown” group addresses.

write yes: “unknown” group addresses are transmitted like

normal group addresses (if they are set to “sending” in the process item).

do not write no: “unknown” group addresses are not transmitted,

even if they have been set to “sending”. Attention: If “unknown” group addresses have been de-fined to realise internal functions of the Visualisation, and the parameter “Write to unknown group addresses” is set to “yes”, it must be made certain that these group addresses are not unintentionally used later in the bus system. Therefore it is useful to define such group addresses in the main groups 14 and 15, because they cannot be used in the bus system.

Visualisation


2.3 Notes on the Start-Up Performance of the Visualisation

general The Visualisation gets its information from the bus devices by “monitoring” the appropriate telegrams on the bus.

start-up When the Visualisation is restarted, e.g. after power break-

down, it must “request” the current states from the bus devices. Otherwise they are only updated in the Visuali-sation after a corresponding telegram on the bus.

updating “Requesting” the actual states is done automatically after

the start-up of the Visualisation, i.e. the states of all bus devices are read step by step.

“sending” group addresses For that purpose the “reading” flag must have been set in

the appropriate object of the bus device and the group address entered in the process item must have been set in the object as a “sending” group address (not enclosed in brackets). Thus this group address becomes a “readable” group address and the Visualisation knows which object in which bus device must be read out for the update of the process item.

note If multiple group addresses have been assigned to the

process item, the states of the “readable” group addresses are read out in the according sequence and assigned to the process item. This means the process item always takes over the status of the “readable” group address last in the list, if the processing rule “Equate” is valid!

attention In the objects on the bus devices a central group address or

a group address used by multiple bus devices may never be used as a sending group address, because as response telegram a normal telegram is generated by the bus device with the group address set to “sending” as the target address!

Visualisation


2.4 Notes on ETS Project Planning general If you use ETS (= EIBTOOL SOFTWARE) for the project

planning of an installation bus containing the Visualisation or if the Visualisation is to be added later, the following items should already be taken into account in the planning phase of the installation bus:

“sending” group addresses During the start-up of the Visualisation and when switching

or control commands are being sent, the appropriate process items are updated by reading the object states in the bus devices. Therefore it is required to set the “reading” flag in the appropriate objects (usually the actuators) and define the “local” group address (i.e. the group address for the local control of this object) as “sending”.

S/D actuator If switching/dimming actuators are included in the Visuali-

sation, the application 01610104 or a greater one should always be used. This application offers, in addition to the switching, dimming object and value-setting objects, the object #3 in which the current status is represented by an 8 bit value, irrespective of whether this value has been set by switching, dimming or value setting. In this object the “reading” flag is set by default.

binary output If binary outputs in which logic operations have been

projected are to be visualised, you should also pay attention to the fact that applications with their own status objects are to be used. Via these status objects the result of the logic operation can be recorded (see descriptions of the applications).

temperature sensor If the actual temperature is to be recorded by the

Visualisation, the application #01210502 must be used for the UP 250 temperature sensor, because this application sends the current temperature cyclically as a 2-byte value via its own object.

Visualisation


2.5 Connecting the Visualisation to the Bus System The Visualisation or the PC the Visualisation is installed on is connected to the instabus EIB via an RS232 interface. The following RS232 interfaces are available:

RS232 N5WG1 148-1AB02

RS232 UP5WG1 148-2AB11

70 mm

70 mm

Labelling field

Sub DsocketsSub D

sockets

Strain relief forround cable

35 mm high

3 TE

Learn keySIEMENS5W G1 148-1A B 02

R S 232

ins tabus EIB

Programming LED

9-pole9-pole

(ø 8 mm max.)

The connection between the PC’s serial interface and the RS232 interface is established via a commercial serial interface cable:

S u b Ds oc k e ts9-p o le

S u b Ds oc k e ts25-p o le

S u b Dp in s9-po le

S u b Dp in s9-po le

bus R S 232COM 1/2PC

1

8

2

3

3

2

4

20

5

7

6

6

7

4

8

5

9

22

1

1

2

2

3

3

4

4

5

5

6

6

7

7

8

8

9

9

Pin as s ig n m e n t

w ire d 1:1

Visualisation


2.6 Location Inside the Bus System general The Visualisation can principally be connected to any point

inside the bus system. However, for good bus performance – especially with more extensive bus systems – it is recommended to use the suggested bus locations.

one line If the bus system consists of one line only, the Visualisation

is connected to the bus system at this line via an RS232 interface.

line 1

dev 1 dev 63

RS 232

visualisation

multiple lines If the bus system consists of multiple lines, it is useful to

connect the Visualisation to the main line to make easy access to all lines possible:

R S 232main line

LC 12LC 1

visualisation

dev 1

line 1 line 12

dev 1

dev 64dev 64

Visualisation


multiple zones If multiple zones are used, the Visualisation should be

connected to the zone line. Thus it makes certain that the information from the individual zones and lines can reach the Visualisation via the easiest way.

R S 232

visualisation

dev 1

dev 64 dev 64line 1 line 12

ZCLCdev

= zone coupler= line coupler= device

LC 1 LC 12

ZC 1

dev 1

zone line

main line

Visualisation


2.7 Line and Zone Overlapping Telegrams general If line or zone overlapping information is to be evaluated by

the Visualisation, or if the Visualisation is to generate commands for bus devices on other lines or zones, the performance of the couplers has to be considered:

coupler Each of the line/zone couplers has a filter table containing

information on whether a global telegram is needed in its line (its zone) or a local telegram is also needed outside its line (its zone).

filter table This filter table is generated by the ETS based on the project

planning. However, the Visualisation itself is not taken into considera-tion by the ETS, and so this information is missing. Therefore there are two possibilities to prepare the couplers for the application of the ETS:

Release filter table description The features of the filter table of each coupler can be

selected via the parameter list: Direction primary line ? secondary line:

lock (no telegrams are redirected) release (all telegrams are redirected) normal (filter table determines whether a telegram is redirected or not)

Direction secondary line ? primary line : lock (no telegrams are redirected) release (all telegrams are redirected) normal (filter table determines whether a telegram is redirected or not)

telegram course First the exact route of each telegram to be received from or

to be sent to the bus device by the Visualisation must be considered.

Visualisation


parameterise couplers Afterwards the filter tables for the corresponding direction

are to be released by the ETS in the couplers concerned, and the programme must be reloaded.

note Releasing the filter tables in the appropriate direction redi-

rects all telegrams. This may affect the bus performance in a negative way in more extensive installations. Therefore this possibility is recommended only for installations where no overloading of individual lines is to be expected, when the filter table is released.

Correct filter table via dummy devices description In order to enable the ETS to consider the Visualisation

during generation of the filter tables on the line where the Visualisation accesses the bus, “dummy devices” are to be projected. In these dummy devices all group addresses the Visualisation is receiving from, or sending to, must be entered.

dummy devices As dummy devices e.g. 4-way switches or 4-way binary

outputs would be suitable, for example, because they can hold several group addresses. The objects should only have the communication flag and the write flag set.

load filter table new After the project has been expanded by the dummy devices

with the help of the ETS, the filter tables of all couplers in question must be reloaded.

note The dummy devices are only required by the Visualisation

while the filter tables are generated. It is not necessary to put these devices into operation! If none of these possibilities has been realised, it may happen that telegrams needed for status display in the Visualisation are not redirected to the line the Visualisation is connected to, or a command telegram of the Visualisation is not redirected to the line the addressed actuator is connected to.

Visualisation


3 Preparation

3.1 Installation of the Visualisation general The installation programme of Visualisation instabus is

located in the root directory of the Visualisation instabus disk 1. This programme installs the Visualisation instabus programme on your computer so that it is ready to run. All other files are compressed and cannot run directly.

attention If an old version of Visualisation instabus already exists on your computer, please first refer to the readme.wri file on installation disk 1.

read readme.wri For this purpose start the Windows file manager, switch to

drive A: (or B:) and double click on the file named readme.wri.

installation Installation with SETUP.EXE :

?? Insert disk 1 into your disk drive. ?? Open the <File> menu of the programme

manager. ?? Select menu item <Run>. ?? enter the following:

if the disk is in drive A: A:\SETUP if the disk is in drive B: B:\SETUP

Press the “OK” button or press the enter key. language First select the national language in which the Visualisation

instabus is to be installed on your computer:

Visualisation


directory Enter the drive and directory in which Visualisation instabus

is to be installed in the next dialogue box. Default is C:\VISUALIS. Confirm your entry with the “Continue” but-ton.

note The following two dialogue boxes only appear during the

first installation of the programme. name, company In the next dialogue box enter the name and company

Visualisation instabus is to be licensed to.

confirmation In the following dialogue box you may continue the

installation with the “Continue” button or correct your entries with the “Change” button.

Visualisation


language selection In the following dialogue the languages to be installed can

be defined. Normally this is your national language. Up to five languages may be defined, which can be switched during runtime via the system menu.

note The number of available languages may change in future

versions.

insert disk During installation you are asked to successivly insert the

disks of Visualisation instabus.

read info file The info file contains important news and notes.

Visualisation


restart When Visualisation instabus has been installed successfully,

confirm the displayed dialogue box with button “Restart Windows”. Windows will now be restarted.

programme group During installation a new programme group Visualisation

instabus is generated.

You can now work with Visualisation instabus. dongle Attention: before Visualisation instabus is started the

dongle delivered with the software must be plugged into a parallel printer interface. This interface must not be used for data transmission programmes as long as the dongle is plugged in.

Visualisation


3.2 Generating a new Project call the visualisation software Call the Visualisation software by double clicking on the

icon:

new project Select menu item “Project” ? “New project”.

project name Enter the name of the new project under Project Name

(max. 8 characters, no special characters) and confirm with “OK”. Confirm the displayed “Initialisation failure” message with “OK”.

project access Confirm the dialogue box “Project Access” with “OK”. Now

the new project can be accessed by the “SYSTEM” user (i.e. all functions are available).

Visualisation


3.3 Importing a Project from Disk general You can import all project data from disk any project of the

Visualisation. import project Select menu item “Project” ? “Import project”.

Insert the project disk into drive A:. press the “Read contents” button: the project names of the disk projects are displayed. Select the desired source project and the desired project the project data are to be imported to from disk under “Import to project”. If “Automatic” is selected, a new project with the same name as the project to be imported will be generated. “Import” starts the reading in of the project. When the whole project is imported, confirm the “Initiali-sation failure” message with “OK”. Attention: If the project selected under “Import to project” is not empty, already existing data in this project is written over when data from the disk is imported!

Visualisation


4 Taking Over Bus Device Data

4.1 Read In Bus Device Data – General general So-called process item defined by the planner are assigned

to image variables. These process items in turn are assigned to group ad-dresses the process item is to receive or transmit.

methods There are two alternatives to make these group addresses

available to the Visualisation: ?? Read out the devices connected to the bus system and

thus use the current status of the installation to be visualised as a basis for the definition of the process items, or

?? Take over the existing project from the data base generated by the planning programme part of the ETS (EIBTool Software) into the Visualisation. Thus all com-mentaries entered for the devices and all group ad-dresses are also available.

the EIBTOOL programme Reading in of the bus device data is performed using the

EIBTOOL programme which is also included – besides the actual Visualisation programme – in the Visualisation instabus programme group.

attention Before starting the EIBTOOL programme for reading in bus

device data, the project which uses this data must already have been generated by the Visualisation programme via the menu item “Project” ? “New project”, because the data read in is stored as project related! Exit the Visualisation programme via: “Picture” ? “Close picture” “Project” ? “Close project” “Project” ? “Exit programme”

Visualisation


starting EIBTOOL Start the EIBTOOL programme:

select project After the programme has been started you may select the

project in which the data are to be used:

Mark appropriate project and confirm with “OK”.

4.2 Read In Bus Device Data – from Bus Devices general If the instabus EIB installation is already in operation the bus

device data can be read directly from the individual bus devices.

establish bus connection To do this, the connection to the bus has to be established,

if the data cannot be taken over from the ETS (EIBTool Software) : To do this, connect the interface cable to the PC (COM1 or COM2) and to the RS 232 interface of the bus (N148 or UP148).

Visualisation


The interface parameters are set by using the menu item “Interface” ? “Parameters”.

Select the COM1 or COM2 PC interface used. The physical address of the RS232 interface used (bus coupler) has also to be defined. The entry of the physical address serves as an access key. In conjunction with future versions of instabus devices the “Password” field shall facilitate a real protection against unauthorised access. Via menu item “Interface” ? “open” the connection bet-ween bus and PC is established. If the interface has been opened successfully, it will be indicated by a corresponding message. If this is not the case, there is no connection to the bus. Check the physical address of the RS 232 interface, if necessary.

attention While reading in the bus device data, the EIB simulation

mode must be switched off. If necessary the setting in the system configuration has to be verified and corrected (ref. to Chapter 8 “Other Functions”: “Simulation of the Visuali-sation”).

Visualisation


define scan range In the menu item “Services” ? “Device” ? “Setup scan

range” the appropriate lines of all zones to be scanned for bus devices are defined. Note: (ETS 1 12 lines ETS 2 15 lines)

The entered data is incorporated via “OK”.

scan for devices / direct With the menu item “Services” ? “Device” ? “Scan

direct” all the lines specified are scanned for existing bus devices (device 0 up to 255) and the result is stored. The following keys can be used to control the scan:

N ..................................... next line R...................................... scan current line again ESC ................................. stop scanning

scan for devices / via couplers With “Services” ? “Device” ? “Scan via couplers” only

lines with existing couplers are scanned. The scan can be monitored on the screen by displaying the physical addresses found. Note: At this moment the connection to the bus should have already been established (i.e. check mark in front of menu item “Interface” ? “open”).

Visualisation


device list With menu item “Services” ? “Device” ? “Edit list” a

device list containing all devices of the scanned lines is displayed:

edit device list After entering zone and line and pressing the “Read” button

all device numbers found are indicated in the left list and all missing device numbers are indicated in the right list.. By marking “known” devices and pressing the “–>“ button or “unknown” devices and pressing the “<–“ button, known devices can be declared as unknown and vice versa. Changes have to be stored with the “Write” button. Note: the list on the left side (known devices) is the basis for reading out the data of the devices and generation of the system files. Note: the left list is also used for monitoring the bus devices (see also chapter 11).

Visualisation


read out device data There are 3 methods of reading out the contents of the

devices: read device list The menu item “Services” ? “Device” ? “Read device

list” starts the reading of group addresses, using the device list. All previously read data will be erased.

read additional device list The menu item “Services” ? “Device” ? “Read additional

device list” starts the reading of group addresses using the device list. However, previously read data will not be erased.

read single device To read out one individual device later, e.g. because it has

been added, it is possible to define the physical address and read it out via the “OK” button with the menu item “Services” ? “Device” ? “Read single device”. However, this device must first be manually declared as known in the device list (“Services” ? “Device” ? “Edit list”). By no means may the device list be generated anew by “Services” ? “Device” ? “Scan direct”!

If reading via “Read device list”, “Read additional list” or “Read single device”, the following keys can be used for control:

N ..................................... next device R...................................... read current device again ESC ................................. stop reading out

Visualisation


The read-out procedure can be monitored on the screen by “dots” indicating the progress.

If no progress is visible, the read-out procedure for this device can be restarted via the “R” key. Note : Reading out the group addresses takes some time.

generate system files After all devices have been read out (from the list or

individually) the system files have to be generated. The generation of raw data, group data and system files is started via the menu item “Services” ? “Create system files”.

Note : The generation of the system files takes some time. Attention : After bus device data has been read out additionally or anew, the function “Services” ? “Create system files” must be carried out.

Visualisation


exit program Now the reading in of the bus devices is completed and the

EIBTOOL programme can be exited via “File”? “Exit pro-gram”.

4.3 Read In Bus Device Data – from the ETS Data Base general The second possibility to read bus device data for the

Visualisation works directly with the data base generated by the EIBTool Software (ETS).

ETS 1.xx The following settings are to be paid attention to!

(see chapter 19/20) Path-entry in the “autoexec.bat” Setting of group address on two levels (SYSTEMCONFIG) Switching over to the ETS 1.xx in the (SYSTEMCONFIG)

ETS 2.xx The following settings in the SYSTEMCONFIG are to be paid

attention to! (see chapter 19/20) Path entry Set the group addresses, select 2 or 3 columns Switch to ETS 2.xx

project access Note : The Visualisation software has only access to project

data generated by the planning programme part of the ETS or data available as “Local project” in the Start-up program-ming part of the ETS (EIBUSER.DBS data base). The Visualisation cannot access “Imported projects” (PRJUSER.DBS data base)!

autoexec.bat The Visualisation detects on which drive the ETS is installed

by the “path” entry in the “autoexec.bat” file. Note: Not relevant for ETS 2! If the ETS is installed on the C: drive, the entry: PATH=.......;C:\ETS;.......... must exist in the “autoexec.bat” file.

Visualisation


If this entry does not exist, it must be added: ?? Exit the “EIBTOOL” programme via “File” ? “Exit

programme”. ?? Start the file manager in the “Main group” programme

group. ?? Call the “sysedit.exe” file in the c:\windows\system

directory. ?? Search the “PATH=“... entry in the “AUTOEXEC.BAT”

editor window displayed ?? and add the following entry to the end of the line:

PATH=.................;C:\ETS ?? Store the modification via “File” ? “Save” and close the

editor windows. ?? Exit WINDOWS. ?? Afterwards perform a “warm boot” or a “reset” to

activate the changes in the PC. ?? Now the “EIBTOOL” programme in the “Visualisation

instabus” programme group can be called again.

ETS project selection With the menu item “ETS” ? ?“Project selection” the

selection dialogue box listing all existing ETS projects contained in the “EIBUSER.DBS” is displayed. Select the project whose data you need in your Visualisation and confirm with “OK”.

Visualisation


data types After the desired ETS project has been selected you can

choose, via the “ETS” menu, the following data types which can be read in: ?? read group texts ?? read device texts ?? read device data

read group texts The commentaries entered in ETS for the planned group

addresses are read in. If a group address is selected in the Visualisation, the related commentary is displayed automatically.

read device texts The commentaries entered via ETS for the devices (location,

...), are read in. If a bus device is selected in the Visualisation, the related commentary is displayed automatically.

read device data All the relevant data the Visualisation needs are directly

taken over from the planned bus devices of the ETS data base. The resulting data is similar to the data received via the first method – the reading in of the device data directly from the bus devices. Note : Reading in the device data is mandatory. Reading in group texts or device texts is optional but recommended to make the planning of the Visualisation easier. It is also possible to read only the group texts and device texts from the ETS data base and read out the actual device data directly from the bus devices on site (see 4.2). In addition, the complete project can be read in with all data.

Visualisation


read data Selecting the desired menu item starts the according action. note During reading in of the ETS device data, all devices

projected in the ETS will be included in the device list. After the desired data has been read out, the system files have to be generated.

note Possibly projected “dummy devices” must first be removed

from the device list. generate system files The generation of raw data, group data and system files is

started via menu item “Services” ? “Create system files”.

Note : The generation of the system files takes some time. Attention : When the ETS project has been read out anew owing to expansions or modifications, the function “Services” ? “Create system files” has to be also be performed anew.

Visualisation


exit program Now the reading in of the bus devices is completed and the

EIBTOOL programme can be exited via “File”? “Exit program”.

4.4 Verification of the Bus Device Data general The “Create system files” function also generates a text file

named “grps.log”. In this file all group addresses which have been read in are listed together with a note whether the group address is “readable” and, if so, from which bus device and object it can be read. Additionally it is noted whether a group address can be read out from more than one object (the group address is defined as “transmitting” address in multiple objects and the reading flag is set).

“grps.log” file This text file can be displayed with any common editor (e.g.

the “Write” programme). It is stored in the “visualis” directory and the according project subdirectory in the “EIB” subdirectory. e.g. c:\visualis\project1\eib\grps.log

Visualisation


group address not readable If group addresses are displayed together with the comment

“not readable”, process items containing only this specific group address are not updated automatically during the start-up procedure (see Section “Notes on the Start-up Performance of the Visualisation” in Chapter 2). Additionally, the operating mode “switch, do not mirror, read-back” cannot be used for the output of control commands to indicate the current state of the actuator (see Section “Notes on Command Output with the Visualisation” in Chapter 2).

more than 1 dev. answering If group addresses are indicated with the comment “More

than 1 dev. answering!”, this group address can be read out from more than one object of the bus devices, i.e. the group address is entered as a “transmitting” group address in multiple objects and the reading flag is also set. However, the status is read only from the object or device which is indicated in the group address.

group address readable If the group address is indicated only with the comment

“Answered by dev:....”, the group address is “readable” in one device. Note : In order to use the whole variety of functions of the Visualisation, in each process item one “readable” group address must be defined (except with central functions). Which group address is to be readable must be considered and defined during the planning of the installation (see Section “Notes on ETS Project Planning” in Chapter 2)!

group address not received If the group address is indicated with the comment “Not

received by any device”, the group address is not received by any actuator.

Visualisation


group address is read logically If the comment “Setting to log read” or “... is read logically”

is indicated, the value of the group address is read from a defined status object.

group address is read cyclically If the comment “... is read cyclically” is indicated, the value

of the group address is read cyclically from a defined status object.

Visualisation Creating Project Data


5 Creating Project Data

5.1 Structural Principles of Projection The planning of a Visualisation project is subdivided into the following items:

1. Read out bus device data read out bus device data The Visualisation is informed about the existing bus devices

and the group addresses used.

2. Define texts define texts The following texts are available:

?? units: for the automatic display of units with analogue values.

?? status texts: text used for the display of the current state („0”, „1”).

?? hint texts : for the display of additional information, e.g. when an alarm occurs.

3. Define data types define data types For each type of information, e.g. “Lighting on/off”,

“Window shutter up/down”, “Temperature”, a data type is defined here which can be used by any number of process items. In a data type the type of information, the units and status texts to be used, and additional information, are preset.

4. Define process items define process items Now for any kind of information to be displayed a process

item is to be defined. This process item accesses the data of the data type used. Here the group addresses are entered which are to be received or transmitted. Also the hint texts to be used are selected. Additionally some special functions for process items can be activated.

Creating Project Data Visualisation


5. Draw static background pictures static background picture Now the static backgrounds must be determined.

6. Insert image variables insert image variables The image variables have to be inserted on the static back-

ground. With their help you can switch to other screens, display bus information or output commands and set values. Each image variable is assigned to a process item the information of which is to be displayed or to be output. Schematic representation of the project planning:

Units Status texts

Data type

Process item

Image variable

Hint texts

Parameters



5.2 Using the Toolbox description With the “Toolbox” function you can represent frequently

needed functions and menus on the screen as icons. The according function or dialogue is called simply by clicking on the related icon. The toolbox can be displayed or hidden via “Picture” ? “Toolbox”.

application All functions having an icon in their dialogue box can

be inserted into the toolbox:

insert function Click on the icon and move to the “TB” symbol holding the

mouse key, then release the mouse key (“drag and drop”). Thus the icon is added to the already existing toolbox and can be worked with now.

remove function To remove a function, the appropriate icon inside the tool-

box must be clicked on while keeping the shift key pressed. The function will be removed from the toolbox



5.3 Defining of Units general Some image variables require units allocated during data

type definition, e.g. for measured values. 128 common units have already been predefined, but you may also define your own units (#129 up to #255). A list of the predefined unit texts can be found in chapter 20.

define units Open the desired project after the Visualisation has been

started. All units needed for the Visualisation can now be defined via the “Process items”? “Units” menu item.

Mark the appropriate line in the table, enter text (up to 7 characters) and click on the marked line with the mouse cursor or press enter. With the “OK” button both the definitions will be taken over and the function may be closed. The “Cancel” button cancels the function without taking over the data changed.



5.4 Defining of Status Texts general In order to display e.g. switching states not as “0” or “1”,

but as textual information, so-called status texts can be defined. 512 commonly used status texts have already been predefined, but you can also define your own status texts (#513 up to #2047) A list of the predefined status texts can be found in chapter 20.

define status texts Open the desired project after the Visualisation had been

started. All the status texts needed for the Visualisation can now be defined via the “Process items”? “Status texts” menu item.

Mark the appropriate line in the table, enter text (up to 15 characters) and click on the marked line with the mouse cursor.

status list Now these texts must be assigned to a status-list name

using the “Process items” ? “Status lists” menu item. Such a status list is assigned to a name, e.g. Lighting on/off. The list contains e.g. the text “OFF” for status 0 and “ON” for status 1.



The name of this list is used when planning the data types. Thus the status texts assigned to the list are used for the appropriate data type.

edit status list First enter the name under which the definitions can be

accessed into the “List” entry field. Mark the first line in the table “Current contents”, enter 0 into the “Value” entry field and select the text to be displayed for the value 0 in the table “Available texts”. The values entered are taken over into the marked line via the “Assign” button. Now mark the second line in the table “Current contents”, enter 1 into the “Value” entry field and select e.g. “ON” in the “Available texts” table. With the “Assign” button the entered values are taken over. The “Save” button stores the data and a new list can be edited (e.g. Window shutter: 0 UP, 1 DOWN) In the “Defaults” section a value/text may be defined which is to be used if none of the states defined in the status list occurs. Attention : Before a new name for a list is entered, the current setting must be stored via the “Save” button.

close dialogue After all lists have been defined, the dialogue box is closed

by the “Close” button.



5.5 Defining of Hint Texts general You have the possibility to display additional information for

the operator, e.g. in alarm messages. These texts are assigned to the appropriate process item for the desired state. The dialogue box is called via “Process items”? “Hint texts”:

enter texts Mark the desired list entry (lower table) and enter the hint

text into the upper table (up to 4 lines). The text is taken over into the list by the “Save” button. Mark the next list entry, enter text, etc.

close dialogue After all hint texts have been entered, the procedure is fini-

shed by pressing the “Close” button.

5.6 Defining of Conversion Functions general You can convert the value of a process item using a

definable function via “Conversion functions”. The con-verted value can then be used for display or further processing. The function defined by entering up to 20 pairs of values (process value and displayed value). If the process value lies between two defined points, an automatic interpolation will be performed.



application In the “Measurement values/Set commands/Counter” data

type such a conversion function can be selected. It is used in all process items assigned to this data type.

define function The function is called via “Process items”? “Conversion

functions”. Now enter the first pair of values into the “Process value” and “Display value” entry fields. This pair of values is taken over into the table above by the “Add” button. Add further pairs of values and take them over via the “Add” button.

note The pairs of values will only be taken over, if the resulting

function keeps rising or falling in all segments. The graph of the function made from your entries is displayed in the upper window.



correct a pair of values If a pair of values is to be corrected later, mark the pair of

values in the table by double clicking it with the mouse. Enter the new value into the “Display value” entry field and press the “Add” button.

delete pair of values If a pair of values is to be deleted from the table, mark the

pair of values by double clicking and delete it from the table via the “Remove” button.

save entries After all pairs of values have been entered (up to 20), the

conversion function can be saved under the name entered in the “Name” entry field by pressing the “Save” button.

modify conversion function If an existing conversion function is to be modified, select

the desired function from the “Name” list by double clicking. Now all pairs of values are listed in the table below; they can be modified as described above.

delete conversion function If an existing conversion function is to be deleted, select the

desired function from the “Name” list by double clicking and delete it via the “Delete” button. Note: If new conversion functions are defined or existing conversion functions are modified, the interface must after-wards be initialised anew via “Driver...”? “Initialise serial interface” to activate the changes.



5.7 Defining of Data Types description The data type defines the kind of data, the status texts and

additional specific settings. The data types have been supplemented or extended. The previous data type “Analogue Values/Commands” have been renamed into “Measurement values/Set commands/Counter...”. The previous data type “Digital Values/Commands have been renamed into “System values...”. The data type “User defined counters..” have been supplemented. For the definition of the data type open pictures must be closed via “Pictures”? “Close picture”. Call the following dialogue box via “Process items”? “Data types”:

data types The following data types are available:

?? Single-State Messages/Commands

EIS types: 10 switch 70 direction of rotation of a motor (currently not used) 71 motor step (currently not used)

?? Multi-State Messages/Commands

EIS types: 65000-8 x 1 bit 65001-1 x 8 bits 65002-n x m bits



?? Measurement values/Set commands/Counter

EIS types: 5001 temperature [°C] (e.g. temp. sensor UP250) 5002 difference of temperatures [K] 5003 temperature gradient [K/h] ....... 6001 light intensity relative [%] (e.g. S/D actuators) 6002 air humidity relative [%] 6003 wind direction [°] 10000-unsigned 16 bit counter 10001-sign 16 bit counter 11000-unsigned 32 bit counter 11001-sign 32 bit counter

without EIS-type: 8 bit counter sign and unsigned

?? System values

EIS-types: EIS-types:-30 time EIS-types:-40 date

?? User defined counters

Mark the desired data type and select it via the “Execute” button.



5.8 Single-State Messages/Commands description They are used for the processing of binary states, e.g.

ON/OFF, UP/DOWN. Select the menu item “Process items”? ”Data types” and choose the data type “Single-state messages/commands” under “Create or change data types”.

settings Define a name for the data type in the “Data subtype name“

entry field (e.g. “Lighting”). status text list Select the desired status text list from the “Status text list”

combo box. EIBus data type (EIS type) Here it is defined to which EIS type the data to be

processed belongs. The following EIS types are supported by this data type:

10 switch (normal setting) 70 direction of rotation of a motor (currently not used) 71 motor step (currently not used)

type of contact Possible settings: “Closed” or “Open”.



allow switching command Here the transmission of telegrams (i.e. command telegram)

can generally be released or blocked for this data type. monitor come/go It may be useful for alarm messages to extend the status

text to be logged for the “1” status (i.e. alarm) with the extension “coming” , if the status changes to “1”, or “going” if the status changes to “0”. Note: When “monitor come/go” is activated, only for the “1” status a picture or an event programme may be started in the process item.

acknowledge event If a change of state of the related process item is to be

acknowledged by the operator, this must be marked at the appropriate state (S=0 and/or S=1). The evaluation is per-formed via the “Event data base” option.

give acoustic signal For the indication of states via an internal audible signal or

via additional hardware (sound card), the according state (S=0 and/or S=1) has to be marked.

logging of events If the event in question is to be logged (see Section

“Logging Event Messages” in Chapter 8) the appropriate state (S=0 and/or S=1) has to be marked.

priority Here the priority of the event is set for logging (0...low,

7...high) (see Section “Logging Event Messages” in Chapter 8).

user flags So-called flags can be preset here. They can be processed

and modified in event programmes (optional). add The settings are taken over via the “Add” button. delete An existing definition of a data type can be deleted via the

“Delete button”. OK Close the dialogue box via “OK”.



5.9 Multi-State Messages/Commands description They are used for the processing of configurable bit groups

in an 8-bit field (byte). Select the menu item “Process items”? ”Data types” and choose the data type “Multi-state messages/commands” under “Create or change data types”.


entry field (e.g. “Temp. control”).

EIBus data type (EIS type) Here it is defined to which EIS type the data to be


65000 8 x 1 status 65001 1 x 8 status 65002 n x m status

main parameters The configuration to follow depends on the EIS type

selected: 8 x 1 status The bit field is subdivided into 8 individual 0/1 states. No

further individual parameterisation is required.



1 x 8 status The bit field is regarded as an 8 bit value. With this EIS type

the transmission of telegrams (command telegram) can be released:

allow writing If “Allow writing” is activated, a set value can be

transmitted to the device. n x m status The bit field can be subdivided into any bit groups you want.

If this data type has been selected, the “Configure bit groups” button is released.

configure bit groups When the button is pressed a dialogue for the setting of the

bit groups is displayed:

The definition of the bit groups starts at the least significant bit (20). Its length is defined by typing in the appropriate number of bits. The starting bit for the following bit group is calculated automatically. The resulting structure is indicated by a coloured highlighting of the bit groups.

OK Takes over the bit groups configured. common settings All EIS types (8 x 1, 1 x 8 and n x m) shown above allow

common settings:




and modified in the event-programme option. bit fields This list shows the individual bit fields (8 with 8 x 1 status, 1

with 1 x 8 status, individual number with n x m status). By double clicking on the desired field or by marking and pressing the “Change” button the dialogue for setting the bit group parameters is displayed:

status text list Select the desired state text list from the “Status text list”

combo box. The states according to the state text list and the related values are displayed in the right window. The question mark (“?”) indicates the set value with inconsistent data (e.g. all bits 0 with EIS type 1 x 8 and no collection type selected, see below).

priority Here the priority of the event to be logged is set (0...low,

7...high) (see “Logging Event Messages” in Chapter 8).. log events If a change of state is to be logged, “Log events” must be

marked. Then logging is performed at every change of state with 1-bit fields and at every change of the value of bit groups (e.g. 1 x 8 bits or bit groups with collection type).

collection type This function can only be activated with bit fields >> 1 bit. If

“Collection type” is activated, the bit field is interpreted as a value (range according to the field length).



no collection type If “Collection type” is not activated, the positions of the bits

in the bit field is evaluated. In this case exactly one bit must be set in the field, otherwise the field is considered as inconsistent.

For the definition of the status text lists the individual bit positions in the field refer to the following values:

bit position 0 1 “ 1 2 “ 2 4 “ 3 8 “ 4 16 “ 5 32 “ 6 64 “ 7 128

Each bit field starts with bit position 0 and value 1.



5.10 Measurement Values/Set Commands/Counters description This data type is used to record analogue information.

Select menu item “Process items”? ”Data types” and choose the data type “Measurement Values/Set Commands /Counters” under “Create or change data types”.


entry field (e.g. “Temperature”). status text list In order to use status text lists for the alarm conditions, the

following status values can be defined in the status text lists (see “Definition of Status Texts”):

-2 .............. text for “Alarm limit low” -1.............. text for “Warning limit low” 0.............. text for “Normal status” 1.............. text for “Warning limit high” 2.............. text for “Alarm limit high”



EIBus data type (EIS type) Here it is defined, to which EIS type the data to be


5001 temperature [°C] 5002 difference of temp. [K] 5003 temperature gradient [K/h] 5004 light intensity [lux] 5005 wind velocity [m/s] 5006 air pressure [Pa] 5010 time difference [s] 5011 time difference [ms] 5020 voltage [mV] 5021 current [mA] 6001 light intensity relative [%] 6002 rel. air humidity [%] (without EIS type) counter value 8 bit sign (without EIS type) counter value 8 bit unsigned 6003 wind direction [°] 10000-counter value 16 Bit sign 10001-counter value 16 Bit unsigned 11000-counter value 32 Bit sign 11001-counter value 32 Bit unsigned

measuring val. with fixed limits The limits set are absolute values. Other settings are

currently being developed. number of fractional digits For the display of the value e.g. in a text variable or in the

message window the number of fractional digits defined is used. Useful settings: 0,1,2

allow switching command Here the transmission of telegrams (i.e. command telegram)

can generally be released or blocked for this data type.



acknowledge event If a message triggered because the value is below or above

an allowed alarm or warning limit is to be acknowledged by the operator, the appropriate box (Al: alarm low, Wl: warning low,...) has to be checked. The evaluation is performed via the “Event data base” option.

give acoustic signal For the indication of states via an internal audible signal or

via an additional hardware (sound card), the according box (Al: alarm low, Wl: warning low,..) has to be marked.

logging of events If the alarm or warning state is to be logged, the according

box (Al: alarm low, Wl: warning low) has to be marked. priority Here the priority of the event to be logged is set (0...low,

7...high) (see “Logging Event Messages” in Chapter 8). unit The unit entered here is used for the display of the value

e.g. in a text variable or in the message window. If the desired unit is not available from the already predefined units, the user’s own units can be defined under “Process items”? “Units” (see “Definition of Units”).

conv. function The actual process value can be converted for display via a

conversion function. Here all the conversion functions de-fined under “Process items”? “Conversion functions” are available (see “Definition of Conversion Functions”). A function for the current data type can be selected from this list.

alarm/warning limits low/high Here the values for triggering the according alarms, or

warnings, are to be defined. hysteresis A hysteresis for the alarming or warning levels may be

entered here. user flags So-called flags can be preset here. They can be processed

and modified in the event-programme option.



save The settings are taken over via the “Save” button. delete An existing definition of a data type can be deleted via the

“Delete button”. print Will print the data item displayed. cancel With “Cancel” the changes will be ineffective. OK Close the dialogue box via “OK”.

5.11 System Values description This data type is used for receiving and representing

information in a 3 Byte telegram. These values can only read and displayed by the bus. They cannot be generated in the Visualisation or be sent on the bus. Select the data type “System values” via “Create or change data types” in the menu item “Process items”? ”data types”.

settings Enter the name of the data subtype (e.g. date or time) via

“Data subtype name:”. This data type serves the purpose of displaying time and date (e.g. text variables) in the Visualisation.

DCF 77 The time signal DCF 77 is received by a device suitable for

EIB and sends to the bus, if necessary. At the same time the internal PC-clock as well as the date will be set.



display Displaying time and date in a separate variable is not

mandatory because they are automatically shown in the Visualisation.

EIS type Here it will be determined which EIB type the processed

data belongs to. The following EIS types are supported by this data type:

30 time; 40date.

save With “Save” the settings will be taken over. delete An existing definition of a data type can be deleted via the

“Delete button”. print Will print the data item displayed. cancel With “Cancel” the changes will be ineffective. OK With “OK” you leave the dialogue.

5.12 User Defined Counters

After selecting the item “User defined counters...” and double clicking the line or clicking the “Enter“ button ,the following dialogue will appear.



Parameterisation

description Data subtype name: Displays the name of the selected/new

data subtype. Count Displays the name of the data subtype fields (Within the

range from 1-8)

The following fields have to be entered for each field: - function - EIBus data type - Parameter

function Displays the function (significance) for which the value is to

be evaluated by the Visualisation. The following functions are available: Value Counter value

LV Al. h limiting value for “Alarm limit high” (changeable) LF Al. h object for “Alarm limit high” (triggers the alarm) LV Wn. h object for “Warning limit high ” (changeable) LF Wn. h object for “Warning limit high ”(triggers the al.) LV Wn. l object for “Warning limit low ”(changeable) LF Wn. l object for “Warning limit low ”(triggers the al.) LV Al. l object for “Alarm limit low (changeable) LF Al. l object for “Alarm limit low (triggers the alarm)



EIBus data type Shows the “Interworking standard” which is being used for

this value by the EIB-devices. Various “Interworking stan-dard“ are offered according to the various functions. For all number values: Unsigned even number 8 bit wide Unsigned even number 16 bit wide Unsigned even number 32 bit wide For all bit values: switch

parameter When the button is pressed another dialogue will open up.

unit If you mark the field “Unit”, you will be able to select from the available unit text. If you do not mark that field, no scale will be assigned to the field.

scaling If you mark the field “Scaling”, you will be able to select

from the available scales. If you do not mark the field, no scale will be assigned to the field.

value If you mark the field “Value is writeable” the value may be

written.



Global values Global values: On clicking this button, another dialogue will

open up. It serves the purpose for entering global settings which refer to all fields.

GW-Alarm high If you mark the field ”GW-Alarm high” you can enter a fixed

limiting value for “high limit alarm” which will be controlled by the Visualisation.

GW-Warning High If you mark the field “GW-Warning high” you can enter a

fixed limiting value for “high limit warn” which will be con-trolled by the Visualisation.

GW-Warning low If you mark the field “GW-Warning low” you can enter a

fixed limiting value for “low limit warn” which will be con-trolled by the Visualisation.

GW-Alarm low If you mark the field ”GW-Alarm low” you can enter a fixed

limiting value for “low limit alarm” which will be controlled by the Visualisation.

Save With save the current data subtype will be taken over. Delete With delete the current data subtype will be cleared. OK Data subtypes will be taken over on the computer. Cancel All changes of the data subtype will be ineffective.



5.13 Defining of Process Items general A process item includes all settings and definitions an image

variable requires for its function. The following items belong to these settings: selection of the data type desired, hint texts and the definition of the group addresses from which values are to be received or to which values are to be transmitted. Each image variable is assigned to a process item.

define process items The following dialogue box is called via

“Process items”? “Process items”:

Select the item “Create or change process items” under “Available functions”. General notes on names of process items: While assigning names to process items the following notes are to be considered: ?? Names must not contain the following characters:

„@”, „\”, „/”, „:” and „.” ?? Names may not contain country specific characters

(e.g. umlauts) ?? The length of the names must not exceed 32 characters ?? If operating in a network the names of the process items

should have a maximum number of 16 characters.



The “Process item definition” window is displayed:

process item name Enter the name of the process item into the appropriate

entry field (e.g. Fl1/R1 Lamp 1 status). (See notes on names of process items above.) You may want to define whether you are dealing with a local or a network process item

data type/ data subtype Select “Single-state messages/commands” under “Data

type” and e.g. “Lighting” under “Data subtype”.

rule Equate: The process item reacts like a normal actuator on the given group address:

It always takes over the last state transmitted.

Or: All given group addresses are linked according to the OR function. Used for summarised messages.

And: All given group addresses are linked according to the AND function.



list of group addresses All group addresses which have been read out before are

listed by the “List of Grps...” button. Or:

list of physical addresses All devices with existing object numbers are listed by the

“List of Phys. Addr...” button. assign group address Depending on the representation you use, mark a group

address or an object of a bus device and press the “Add” button.

Or mark the group address or the object, drag it while keeping the mouse key pressed and release the mouse key in the “Assigned Group” table. Thus the group address marked or the contents of the object marked is transferred to the “Assigned Group” table. Up to 15 group addresses can be assigned to one process item.

create group addresses A group address can also be entered manually via “Create

Grp. Addr...”. So “virtual group addresses” can be defined which are only used internally by the Visualisation and not by the bus system.



remove/ remove all Incorrectly assigned group addresses can be removed with

the “Remove” or “Remove all” button. SE (sending) The group addresses to be transmitted e.g. by an output

variable are marked in their “SE” box (attention: modified function, if “and” or “or” has been selected, see under ZF).

ZF (central function) Only active, if “or” or “and” has been selected as a function

rule. Serves for isolating group addresses performing central functions from the logic operation to enable the “Equals” function. If e.g. a process item – in which all the local group ad-dresses of the individual actuators are connected by “OR” – is generated for a summarised message, the existing central group address all actuators are related to must be marked as “Central function”. At first the group addresses marked as “sending” are not included in the logic operation. Only after the logic operation has been performed is the result transmitted to the group address marked as “sending” (see also “Linking more than 15 group addresses”, next page).

assign With the “Assign” button all settings are stored under the

name entered, and the new process item is listed in the table.

replace If a process item is to be stored using another name, select

the according process item by double clicking, enter a new name, and take over the changed data via the “Replace” button.

selection Here up to 16 characters can be entered as a selection

mask. Only process items suitable for the mask are displayed.

change process item If an already existing process item is to be modified, mark it

in the process item list by double clicking. Its current settings are now displayed and may be changed. Take over the new settings via the “Assign” button.



delete The marked process item is deleted from the list via the

“Delete” button. Linking more than 15 group addresses:

If e.g. a summarised message (OR linkage) requires more group addresses than can be assigned to one process item (15 max.), it is possible to assign partial results to a virtual group address in a so-called auxiliary process item. These partial results are then linked in the actual status process item. ?? Define only a maximum number of 14 group addresses

in the first auxiliary process item. ?? Enter a virtual group address as the 15th address (via

“Create Grp. Addr.”) and set it to “sending”. Thus this group address is not included into the logic operation, but carries the result of the operation.

?? Now define further auxiliary process items until all group addresses are included and always set one virtual group address to “sending”.

?? Now all virtual group addresses are entered into one new process item using the according logic operation. This process item contains the final result of the complete linkage.

Note: The system is enabled to detect the status of “virtual group addresses” only if the parameter “Write on unknown groups” is set to “Yes” in the “System config.” programme (see “Notes on Command Output with the Visualisation” in Chapter 2). Thus it is achieved that also these bus addresses can be transmitted on the bus and can be recorded by the Visualisation. Attention: If the result of the linkage is “0” during the start-up phase of the Visualisation, the “question marks” in the image variables indicating this status are kept until a change of status occurs.

extra param. The “Extra parameters” dialogue box is displayed via the

“Extra param.” button.



Extra Parameters with Single-State Messages/Commands:

event programme Event programmes due to status change (optional):

It is possible to automatically start an event programme defined if a change of status occurs (1-0: S=0, 0-1: S=1) (see Chapter 12): Mark the desired change of status and double click on the event programme.

hints Here the hint text previously defined can be assigned to the

marked process item: Mark the desired state and double click on the desired hint text.

Picture change due to status change An automatic picture change triggered by a rising edge can

be activated: Select the desired picture via the “Picture” button and mark the state for which the picture is to be displayed.




and modified in the event monitoring option. If “Flags in use” is not marked, the settings of the according data type are used.

priority Here the priority of the event to be logged is set (0...low,

7...high) (see “Logging Event Messages” in Chapter 8). If “Priority” is not marked, the settings of the according data type are used.

take over settings The settings are taken over via the ”OK” button, and the

“Extra parameters” dialogue box is closed. Extra Parameters with Multi-State Messages/Commands:

programmes Bit group:

Selection of the bit group Val: Assign a value to the bit group selected



Programme list: Selection of a programme which is to be started when the defined value occurs. A programme is an event programme created with the event programme editor (see „Event Programme” option). A maximum number of 8 assignments of this kind is possible. To add an assignment to the list, mark a position the list and press the “Add programme” button. The assignment defined is taken over on the list entry marked. “Remove programme” removes the marked entry from the list.

hints Bit group:

Selection of the bit group Val: Assign a value to the bit group selected Hints: Selection of a hint text which is to be displayed when the defined value occurs (hint texts are defined via “Process items” ? “Hint texts”, see Section “Definition of Hint Texts”, current chapter). To add a “bit group”, “value” or “hint text” assignment to the list, mark a position of the list and press the “Add Hint” button. The assignment defined is taken over to the marked list entry. “Remove Hint” removes the marked entry from the list.

taking over settings The settings are taken over via the “OK” button, and the

“Extra parameters” dialogue box is closed.



Extra Parameters with Measurement Values/Set Commands/Counters :

event programme Event programmes due to status change (optional):

There are four possibilities of exceeding the limits: LV-AL l: limiting value alarm low LV-WA l: limiting value warning low LV-WA h: limiting value alarm high LV-AL h: limiting value warning high To any of these exceeding – if the range is entered (LV come) or left (LV gone) – an event programme can be assigned. The assignment is performed by marking the desired exceeding in the “LV come”/”LV gone” column and double clicking on the desired event programme in the list.

hints An additional hint text can be assigned to an exceeding of a

limit. The assignment is performed as described above.



picture change An automatic picture change triggered by the exceeding of a

limit can be activated: Select desired picture via the “Picture” button and mark the limit(s) for which the picture is to be displayed.

user flags So-called flags can be preset here. They can be processed and modified in event programmes (optional). If “Flags in use” is not marked, the settings of the according data type are used.

control value Reserved for future expansions. Currently not in use. units up to priority The settings defined in the data type can be overwritten

here for the current process item. If an entry is not activated (i.e. it is not marked by a cross), the settings of the data type used are taken.

taking over settings The settings are taken over via the “OK” button, and the

“Extra parameters” dialogue box is closed. OK Closing the dialogue box

After all process items required have been defined, the “Process item definition” dialogue box can be closed by the “OK” button.

initialise serial interface Now the new process items must be activated via the

function “Driver...”? “Initialise serial interface” ? “Exe-cute”.

Visualisation


6 Creating Pictures

6.1 Working with Pictures general A picture is a drawing sheet on which static background

pictures and dynamic variables can be placed. menu items If a project has been opened, the following items are

displayed in the “Pictures” menu: new picture An empty picture named “noname” is opened. open picture Serves for displaying an existing picture and starting the

visualisation.

In the selection dialogue box all existing pictures are listed. Mark the desired picture and confirm with “OK”. The picture is loaded and the Visualisation automatically starts ONLINE operation (editing not possible).

edit picture Unlike the “open picture” item this menu item loads the

pictures into the display for editing, i.e. the Visualisation remains in the OFFLINE mode. For the selection of the desired picture see above.

save picture The picture currently loaded is saved under its name.

Visualisation


save picture under This function must be selected to save an existing picture

under another name. It is also called automatically, if a new picture (“noname”) is saved.

The presetting (“Picture name” and the serial number) can be overwritten by any name (up to 40 characters). “OK” saves the picture under this name.

close picture The currently displayed picture is closed.

If the picture has not been save before, the following message will be displayed:

“Ignore” ignores the last changes and the most recently saved version of the picture remains unchanged. The “Close picture” function is cancelled via the “Cancel” button.

Visualisation


6.2 Using Existing Pictures and Drawings general When designing static background pictures or for the

representation of switching states with symbols; already created picture files or drawing files generated with other programmes can be accessed.

file formats The following file formats are supported by Visualisation

instabus: BMP RLE DIB DRW MAC PIC

import file In order to use the according files in your project, these files

must first be imported: Call function “Close picture”. Call the following dialogue box via “Project”? “Import...” ? “Files”:

Select the desired graphics format of the graphics file with “Format”.

Visualisation


note With the MAC file format the names defined when saving

the drawing macros are displayed instead of the file names. Select drive and subdirectory, mark the desired graphics file in the “Files” list and start importing with the “Execute” button. You may want to select several graphics at the same time. Now the graphics file is available in the current project.

6.3 Creating Static Background Pictures background colour The background colour is selected by

“Settings”? “Background colours”:

Additionally the “Focus setup” (i.e. marking of the most recently performed operation) can be set:

focus colour The focus frame will have a fixed colour. focus invert The focus frame will be displayed in the background colour

inverted. If this selection is made, the setting via the colour palette will be ignored.

focus flashing The focus frame will be displayed flashing.

OK “OK” takes over the settings.

Visualisation


use existing pictures Now already existing background pictures – available as

bitmap graphics (bmp format) or vector graphics (drw format) –can be used as background pictures. Select menu item “Services” ? “Background Picture”. The following dialogue box will be displayed:

mark Mark the according bitmap or vector graphics and click on

the preview picture. The background picture is loaded and displayed.

close Close the dialogue box with the “Close” button. drawing tools The following drawing tools can also be used to create a

background picture: Line Rectangle Rounded rectangle Ellipse Polyline Circle Arc Text A detailed description and how to work with these drawing tools can be found in the next section “Working with the Drawing Tools”.

Visualisation


6.4 Working with the Drawing Tools draw In the “Draw” menu the following tools are available: line Move drawing cursor to the starting point of the line to be

drawn. Press the left mouse button and move the drawing cursor to the ending point of the line. Keep the mouse button pressed. Release mouse button ? line is being drawn.

rectangle Move drawing cursor to the upper left edge of the rectangle

to be drawn. Press the left mouse button and move the drawing cursor to the lower right edge of the rectangle. Keep the mouse button pressed. Release mouse button ? rectangle is being drawn.

rounded rectangle Same procedure as described under rounded rectangle. ellipse Press left mouse button within the drawing area and move

drawing cursor with the mouse button pressed until the ellipse has the desired size. Release mouse button ? ellipse is being drawn.

polyline Move drawing cursor to the starting point of the polyline to

be drawn. Press the left mouse button and move the drawing cursor to the ending point of the first line of the polyline with the mouse button pressed. Release mouse button ? first line is being drawn. Press left mouse button and draw all further lines of the polyline as described above.

closed The polyline is finished by clicking on the starting point of

the polyline (? a closed figure is generated). open If you want to draw an open polyline, the function is

completed by pressing the enter key. Circle Same procedure as described under ellipse.

Visualisation


arc Same procedure as described under line. text Move drawing cursor to the desired text position.

Press left mouse button ? the text dialogue box is displayed:

Enter the desired text and adjust the desired text alignment. Accept the entries by pressing “OK”.

cancel Cancels text entry. font On pressing the button, the following dialogue box is

displayed:

Select desired font, style and size.

OK Take over settings with “OK”. cancel Cancels the current activity.

Note: If you want to cancel the selecting of the drawing tools, press the “ESC” button.

Visualisation


6.5 Settings with Graphical Elements settings If you double-click on an element drawn by the tools with

the left mouse button, the “draw” dialogue box is displayed. If multiple elements are selected, the settings will include all selected elements.

In this dialogue box line style, line width, line colour, fill type and colour of the filling can be set. The settings will only affects those elements which they are applicable for (e.g. filling cannot be used for lines.

execute The settings are performed on the selected elements or the

selected group of elements by pressing the “Execute” button. The dialogue box stays open for the correction of the settings, if necessary.

close “Close” closes the dialogue box. save The selected settings are used as defaults for new

drawings.

Visualisation


6.6 Moving/Modifying an Element mark element If an element is marked (by clicking on the element), the

element is displayed with marking symbols (i.e. small black filled rectangles). e.g. or

move element Move the mouse cursor within the frame

defined by the marking symbols. The mouse cursor is now displayed as a four-fold arrow. Press the left mouse button and keep it pressed. Now the element can be moved on the drawing sheet by moving the mouse cursor. When the left mouse button is released, the element is redrawn at its new location.

change size Move the mouse cursor on the border of the

frame defined by the marking symbols. The mouse cursor is now displayed as a two-fold arrow. Press the left mouse button and keep it pressed. Now the element can be resized by moving the mouse cursor. When the left mouse button is released, the element is redrawn with its new size.

move line points If a polyline or a line is marked, the individual line points can

be moved: move mouse cursor on a line point, the cursor is displayed as a hand. Press left mouse button, move point of the line to the new location and release the mouse button.

Visualisation


6.7 Marking Multiple Elements description It is often useful to mark multiple elements so they can be

deleted or moved together. For this purpose the programme offers three possibilities:

1. Multiple Selection with Selection Frame (“Lasso”) selection frame Move the mouse cursor to a position on the drawing sheet

where no element is located. Press the left mouse button, keep it pressed and drag a selection frame around the elements to be marked. When the left mouse button is released, all elements inside the frame, or overlapping it, are marked.

2. Multiple Selection with the CTRL key CTRL key Mark the first element.

Press the CTRL key and keep it pressed. Now mark all further elements with the CTRL key pressed. After marking all the desired elements, release the CTRL key. If an already selected element is marked again with the CTRL key pressed, the marking for this element is cancelled.

3. Multiple Selection with the “Select all” Function select all If all existing elements are to be marked, select menu item

“Edit”? “Select all”. All existing elements are marked.

note With the key combination “SHIFT+ESC” all selected ele-

ments will be deselected.

Visualisation


6.8 Copying Elements description For the generation of multiple elements of the same size

and the same type, it is useful to draw the element only once and then copy it. For this purpose you have three possibilities:

1. Via the “Edit” menu copy / insert Select the element to be copied.

Perform the “Copy” function in the “Edit” menu ? the selected element is copied into the clipboard. Perform the “Paste” function in the “Edit” menu ? the element from the clipboard is positioned inside the drawing area. The element also remains in the clipboard. Repeat the last step until you have the desired number of copies.

2. Via the Shift Key shift key Select the element to be copied.

Press the Shift key and keep it pressed. Position the mouse cursor inside the frame built by the marking symbols, press the left mouse button and move the cursor with the left mouse button pressed. Release first the mouse cursor at the desired location and then release the Shift key ? the copy is inserted at the current cursor position.

3. With the “Duplicate” Function duplicate Select the element to be copied.

Select the “Duplicate” function in the “Change” menu ? the selected element is duplicated. The settings for the duplication are defined in the “Settings”? “Duplicate” menu.

Visualisation


settings for “Duplicate” Select the “Duplicate” item in the “Settings” menu. The

following dialogue is displayed:

Here the parameters for the “Duplicate” function are selected.

count With the “Duplicate” function the copies are arranged in

rows and columns. With the settings above, two rows with two columns each are filled with the copies. Together with the original, four elements in total are created.

distance (pixels) Here the distance between the elements is defined.

If the distance is zero, the elements are arranged without gap.

example In this example the upper left circle has been duplicated with the settings shown above. Two rows and two columns are gen-erated, the circles are arranged without gaps. This function is very practical if you want to arrange multiple elements of the same type symmetrically on the screen.

Visualisation


6.9 Deleting/Cutting Element description In both cases the element is removed from the drawing

area. However, there is a difference in, how the element is handled:

delete Mark the element to be deleted.

Select the “Delete” item from the “Edit” menu ? the element is removed from the drawing area. The element is not copied into the clipboard.

cut Mark the element to be cut out.

Select the “Cut” item from the “Edit” menu ? the element is removed from the drawing area. However, the element is copied into the clipboard and can be redrawn on the drawing area by using “Edit”? “Paste”.

6.10 Combining/Splitting Block description Multiple elements can be combined to one single unit. In

this case the individual elements can no longer be handled separately, but only as a unit.

combine Mark the elements to be combined.

Select the “Combine” item from the “Change” menu. split Mark the desired block and select the item from the

“Change” menu.

Visualisation


6.11 Rotating/Mirroring Elements description There are two different functions in the “Change” menu to

modify elements later on: rotate Mark the element or the group of elements to be rotated.

Select the “Rotate” item and the direction of rotation (“Left” or “Right”) in the “Change” menu ? the element or the group of elements will be rotated in the selected direction by 15°. The angle of rotation is defined in the menu “Settings”? “Rotation”:

The standard setting is15°.

mirror Mark the element or the group of elements to be mirrored.

Select the “Mirror” item and the orientation (“Horizontal” or “Vertical”) in the “Change” menu ? the element or the group of elements will be mirrored in the selected direction.

Visualisation


6.12 Objects – Auxiliary Functions object alignment It is possible with this function to

align several objects. The programme offers the following functions: Centre horizontal Centre vertical Left Top Right Bottom Same Width Same Height Mark all elements to be aligned with the help of multiple selection.

reference element One element the object alignment is to be related to must

be declared as reference element by clicking on it again. Select the desired alignment in the menu “Change”? “Object alignment” ? the elements will be aligned.

sequence If an element overlaps another, the element overlapped

cannot be selected. In this case you have the possibility to put the element on top behind the element overlapped or vice versa. Mark the desired element. Select the desired function (“to back –“, “to front +”) in the menu “Change” ? “Order” ? the sequence will be changed accordingly.

object locks To work effectively with complex pictures, the individual

sorts of elements of the picture can be displayed or hidden or fixed (i.e. they can no longer be selected or changed). There are the following groups:

?? Variables (all dynamic picture elements) ?? Vectors (all vector format graphics) ?? Bitmaps (all bitmap format graphics)

Visualisation


Via “Change”? “Object locks” the following dialogue box is displayed:

settings Mark the sort of picture elements to be displayed on the

screen in the “Display” column. The groups to be additionally locked must be marked in the “Lock” column. The picture elements which are not displayed, will be locked automatically.

status line A status line can be displayed at the bottom part of the

screen. Here e.g. the co-ordinates of the element the cursor is currently located on can be displayed.

.......

The status line can be displayed or hidden via the menu “Change”? “Status line”. Width and position of the individual fields can be adjusted by pointing on a field limit with the mouse pointer. By pressing the left mouse button the appropriate field limit can be shifted. Pressing the “SHIFT” key simultaneously shifts all field limits starting with the selected one.

Grid A grid can be displayed in the drawing area.

Select the according function, “On” or “Off”, in the menu “Change”? “Grid”.

Visualisation


settings The grid settings are adjusted via the dialogue box

“Settings”? “Grid”.

The grid spacing is entered in the “Horizontal” and “Vertical” entry fields. If the “Snap to grid” function is activated, the elements always “snap” according to the grid spacing. If “Snap to grid” is not marked, the elements will not snap to the grid positions.

orthogonal Objects can only be moved horizontally and vertically,

connecting lines are drawn right-angled. show grid The grid markers are displayed on the working sheet. snap to grid All objects and intermediate points of connections can only

be moved according to the grid spacing.

Undo The “Undo” function in the “Edit” menu cancels the most

recently performed activity.

Visualisation


7 Define Dynamical Picture Elements

7.1 Image Variables – General general After a new working sheet has been defined and the static

background has been created, the dynamic image variables can be positioned.

insert variables The following dialogue box is displayed via

“Services”? “Insert variable”:

The variables are contained in libraries (EIB, EIB2). The according variable is positioned on the working sheet by marking the desired library and variable and clicking on the symbol. After all image variables have been positioned, the dialogue box is closed with the “Close” button.

display style dialogue The according style dialogue, which allows variable related

settings, is called by double clicking with the left mouse button on the image variable.

Visualisation


naming variable By marking the image variable and selecting “Change”? “Object...”? “Name” or pressing the F12 key, an image variable can be assigned to a name. This is useful if the variable is to be clearly recognised, e.g. in a list.

list variables Via “Change”? “Object...”? “List”, a list of all defined

variables is displayed including their names and co-ordinates.

help for finding variables To make “invisible” variables visible for planning, a help

function to find invisible variables can be activated. If you do this, all variables will be displayed with a frame which also helps to localise “invisible variables”. The function is activated or deactivated via The menu item “Change”? “Show invisible variables”? “On” or “Off”. The following image variables are available:

Visualisation


7.2 Output Variable (EIB Library)

normal text extra

description This type of variable serves for the output of commands or

set values. Various types of dialogues are possible. Double clicking on the variable:

type Here you can define whether the text is to be displayed

inside the switching area or in a separate field next to the switching area.

panel To select the panel size. frame To select the frame width of the variable.

key To define the type of representation of the switching area.

Visualisation


font To define the size and the type of the font for labelling the

output variable. text Definition of the text which is to be displayed in the output

variable. dialogue type The following dialogue types are available (i.e. ways of

entering the command value): ?? None (direct output)

The fixed value or the toggle value is transmitted immediately after the switching area is operated.

?? Edit field:

The value to be transmitted is entered via an edit field and will be transmitted by pressing the “OK” button. ?? Scroll bar:

The value to be transmitted is entered via a scroll bar and will be transmitted by pressing the “OK” button.

Visualisation


?? Combo box:

The value to be transmitted is selected from a combo box and will be transmitted by pressing the “OK” button.

border An extra frame for the symbol can be activated. invisible The output variable can be made invisible to realise so-called

“hidden switches”. Thus it is possible to trigger an activity by covering any symbol by an invisible output variable.

fixed value With dialogue type “None” you can select whether a fixed

value (e.g. always 0 for “Central Off”) or a toggle value (0 and 1alternatingly) is to be transmitted.

colour By selecting the according object (text, background) and the

desired colour the symbol’s colour can be changed. privilege level Indicates from which user’s privilege level on this output

variable can be used.

Note: After the control command has been transmitted, the status of the objects containing the group addresses of the process item (and having the reading flags set) can be read out from the bus device. This status is then assigned to the process item (see Section “Notes on Command Output with the Visualisation” in chapter 2).

Visualisation


7.3 Bar Variable (EIB Library)

description With this type of variable measuring values, counter values etc. can be displayed as a bar chart. Multiple values put side by side can easily be compared with each other this way.

type Here the representation of the bar graphic is selected: from the left, from the top, from the right or from the bottom Additionally the display of the numeric value inside the bar can be activated. A slave pointer or non-return pointer is used to indicate the peak value.

panel To select the panel size.

Visualisation


frame To select the frame width of the variable. filling Setting of the graphic display mode of the bar. font To select the size and the type of the font for labelling the

bar variable. indication area Definition of the range of values for minimum and maximum

bar size. border An extra frame for the symbol can be activated. colour By selecting the according object (background, max, ...) and

the desired colour, the colour of the symbol can be changed.

Visualisation


7.4 Diagram Variable (EIB Library)

description With this variable up to eight individual measuring values, counter values etc. can be displayed as a line chart. Each of the eight tracks (channels) can be assigned to an individual process item.

frame Serves for selecting the frame width of the variable. axis Here the desired legend for the vertical axis can be entered.

Visualisation


curve feature selection For each of the eight available tracks the following features

can be selected: Colour of the curve representation Minimum value in per cent and related value display Maximum value in per cent and related value display

title Here the text for the title of the diagram can be entered. line If this item is activated, a ruler can be moved horizontally

across the diagram with the mouse. At the left margin of the diagram the related vertical values of the individual tracks are displayed as numeric values.

sampling rate Indicates the sampling rate at which the values are to be

displayed (minimum time interval: 5 seconds). display length Here the number of measuring points which can be

displayed in the diagram simultaneously is entered (15 up to 300). If the diagram is complete, it is scrolled automatically (shifted to the left).

Visualisation


7.5 Picture Variable (EIB Library)

normal text extra

description With this type of variable the operator can switch to other

screens. If the picture variable is operated, the defined screen is displayed. Double clicking on the variable:

type Here you can define, whether you wish the text to be displayed inside the switching area or in a separate field next to the switching area.

panel To select the panel size. frame To select the frame width of the variable. height Here the type of representation of the switching area can be

selected. font To define the size and the type of the font for labelling the

picture variable.

Visualisation


text Definition of the text which is to be displayed in the picture

variable. switch to picture no. The following dialogue box is displayed:

Selection of the picture which is to be displayed, if the picture variable is operated.

invisible The picture variable can be made invisible to realise so-

called “hidden switches”. Thus it is possible to switch to another screen when you click on any symbol covered by an invisible picture variable.

colour By selecting the according object (text, background colour)

and the desired colour, the colour of the symbol can be changed.

privilege level Indicates from which user’s privilege level on this picture


Visualisation


7.6 Meter Variable (EIB Library)

with zone LEDs without zone LEDs description This variable serves for the display of measuring values,

counter values, e.g. the actual value of the temperature in an analogue meter display. Double clicking on the variable:

panel To select the panel size. frame To select the frame width of the variable. font To define the size and the type of the font for labelling

(scaling, text) the meter variable.

Visualisation


minimum, maximum These entries define the range of values to be displayed.

Minimum: pointer at the left side, maximum: pointer at the right side.

text Entry of text which is to be displayed in the meter variable. scale lines Here the number of scale markings must be entered. The

minimum number is 2. scale text Here the scale text can be entered.

A “semicolon” indicates a scale marking. After the “semicolon” a scale value for this scale marking can be entered, For instance ;0;;20;;40;;60;;80;;100 means that the first scale marking has the value 0, the second has no value, the third has the value 20, etc. (see example on the previous page). In the “Scale lines” entry field“11” would have to be entered in this case.

border An extra frame for the symbol can be activated. zone LEDs When this item is activated, three LEDs indicate, whether

there is an exceeding of the range or not:

left LED smaller than minimum middle LED normal right LED greater than maximum

colour By selecting the relevant object (text, background,...) and

the desired colour, the colour of the symbol can be changed.

Visualisation


7.7 Symbol Variable (EIB Library)

Window shade: open closed description This type of variable serves for displaying states, messages

etc. as graphic symbols. An individual symbol can be assigned to each status.

state For each state a graphic symbol can be selected.

The following graphic symbols are available: Colour field: filled area Symbol macro: created via picture editor Pixel graphic: *.bmp, *.rle Vector graphic: *.pic, *.drw

Visualisation


graphic selection After the type of the desired graphics has been selected,

the desired graphic can be selected via the “Graphic selection” button. The following dialogue is displayed:

The desired graphics file is selected from the file list and loaded via “OK”.

invisible The symbol variable can be made invisible for a certain state

(e.g. “OFF”). So for this state the static background picture lying behind the variable will be visible.

flashing The symbol or the colour field can be displayed as flashing

in order to draw the operator’s attention to a certain state (e.g. “OPEN”).

variation of graphics size If a vector graphics is used, the size of the graphics is

adjusted to the size of the symbol variable, if this item is activated.

variation of size If pixel graphics is used, the size of the graphics is adjusted

to the size of the symbol variable, if this item is activated. If it is not activated, there will be no adjustment. For vector graphics this setting is not possible.

Visualisation


7.8 Text Variable (EIB Library)

description This type of variable is used for the display of status texts, counter values, e.g. “ON”, “OFF”, 1000 lux, etc.

panel To select the panel size. frame To select the frame width of the variable. font To define the size and the type of the font for labelling the

text variable. alignment Definition whether the text inside the text variable shall be

left-justified, centred or right-justified. border An extra frame for the symbol can be activated. flashing The text variable is displayed as flashing in order to draw the

operator’s attention to a certain state. colour By selecting the relevant object (text, background,...) and

the desired colour the colour of the text variable can be changed.

Visualisation


7.9 State Variable (EIB Library)

description This type of variable supports the “Multi-state messages/command” data type. In its function it corresponds in its main features to the text variable. However, their own display field is automatically assigned to the individual bit groups of the data type.


state variable.

selecting fields The number of possible fields (bit groups) is taken from the

data type. The start and end bit of the relevant field will displayed as well.

Visualisation


field The desired bit group is selected from the “Field” combo

box. The colour selection for text and background or a flash-ing representation (see below) is always related to the bit group selected here.

show field If a certain field is not to be displayed in the variable, it can

be deactivated or activated via the “Show field” item. border An extra frame for the symbol can be activated. flashing The state variable can be displayed as flashing in order to

draw the operator’s attention to a certain state (flashing is always related to the bit group selected under “Field”, but not to the variable as a whole).

colour By selecting the relevant object (text, background) and the

desired colour the field colour in the variable can be changed (the colour is always related to the bit group selected under “Field”, but not to the variable as a whole).

Visualisation


7.10 Switch Variable (EIB2 Library)

description The switch variable offers parts of the functions of the

output, picture and symbol variables. It can be used for screen switching, command output, but also for starting an event programme or an extension. Like the symbol variable, the switch variable can display bitmap graphics for individual states (see figure above).

panel To select the panel size. frame To select the frame width of the variable.

font To define the size and the type of the font for labelling the switch variable

.

Visualisation


settings Here the graphics for the individual states are selected. As

the switch variable can also be used without linkage to a process item (e.g. for screen switching), there are several possibilities: ?? variable is not linked to a process item:

0 up (button appears) 1 down (button appears as pressed)

?? variable is linked to a process item: the status texts defined in the data type are valid

choose graphics When the “Choose graphics” button is pressed, a dialogue

for the selection of the graphics to be assigned to the selected state is displayed (see selection of graphics with symbol variable).

text For the selected state a text which will be displayed centred

(above the graphics, for instance) can be entered in addition to the graphics.

flashing The variable will be displayed flashing for the selected state. adjust graphic The variable will be adjusted to the dimensions of the

graphic for the selected state. adjust variable The graphic will be adjusted to the dimensions of the

variable for the selected state. button mode In this section the function of the switch variable is adjusted. switchbutton If pressed down, the switch variable puts out a 1 to the

related process item, if not, a 0 is put out. If operated, the switch button remains pressed and returns to its starting position only after it is operated again.

pushbutton The following activities are performed if the switch variable

is operated: toggle value A toggle value (0 - 1) is put out to the process item, i.e.

when operated first, the output is 1, if operated again, the output is 0, then 1 again, etc.

Visualisation


fixed value The variable puts out a definable fixed value to the process

item if operated (e.g. 100). Releasing the pushbutton does not reset the output value.

on key pressed on key released If the button is pressed, the value defined for on key pressed is

put out to the process item. If the button is released, the value defined for on key released is put out to the process item.

Start: pic A definable picture can be started when the pushbutton is

operated. If the function is activated, a dialogue for the selection of the picture is displayed (see picture variable).

programme A definable event programme (optional) can be started by

operating the pushbutton. If the function is activated, a dialogue window for the selection of the programme is displayed. In this one you can select desired event programme in the list of the translated event programmes. Confirm your choice with the “OK” button.

add-on An add-on programme (optional) can be started by operating

the push-button. If the function is activated, a dialogue window for the selection of the extension to be started is displayed. Here the desired additional function can be selected from the list of the available additional functions. Confirm your choice with the “OK” button.

colour Here the colour of the text (see “text”) is defined.

“Transparent” is for the selection of a transparent colour, if “Transparent” is marked in the “Extras” section: the back-ground shows through all parts of the pixel graphics having the transparent colour defined.

extras: invisible The switch variable can be made invisible to realise so-called

“invisible switches”. transparent If this function is activated, the graphics in the switch

variable is displayed in transparent mode. For setting the transparent colour see “colour”.

border An extra frame for the symbol can be activated.

Visualisation


7.11 Counter Variable (EIB2 Library)

description The counter variable is available in the EIB2 library. It is able to visualise process items of the data type "User defined counters". In the features for the variables you can set what they are to indicate:

For each field of the process item you can parameterise whether the relevant value should be shown. For each field of the process item you can parameterise whether the relevant value should be changed.

Visualisation


For each field of the process item you can parameterise the differing text colours (according to their state). In the option Extras the following functions can be activated:

Blinking (Alarm) At the alarm crossing the limit, the variable will flash up Blinking (Warning) At the warning crossing the limit, the variable will flash up. Border A black outline will frame the variable. Privilege The Privilege level determines whether the user can get into

the window for setting the values. In the menu you can, as it is possible with most variables, adjust the panel and the frame as well as the font Units as well as conversions are taken over from the data item subtype. Changes in a data item subtype will be reflected in the variables that are connected with it. A general background colour can be defined.


text.

Visualisation


With a sufficient high privilege level, the user will be able to reset designated values of the process items for that purpose (on clicking the variable, a window, in which the new values can be entered will appear).

In order to do that, you mark into the option for the changed value and enter the new value. By clicking "OK", the new values will be shown. "Cancel" will undo all possible changes.

Visualisation


7.12 Week Variable (EIB2 Library, Time Manager Required)

description In combination with the time manager option the week

variable serves for the time-dependent switching of process items. It can be defined for each day of the week at which time a process item shall change its value. Only process items of the “single state/messages” data type can be used. They have to be parameterised in the time manager (option) earlier. The variable displays the days of the week and the time in a table. If one field of the table is selected with the mouse, its value will be displayed below the table.

By pressing the “Set value” button of the variable, a dialogue window appears. Here you may change the value of the variable.

Visualisation


By selecting multiple fields (draw a box around the desired fields by simultaneously pressing the left mouse button) you may also change bigger areas in their values.

In the variable state “1” is indicated by a coloured bar, state “0” is indicated by an empty field.

If values have been set, a symbol will appear in the upper left corner of the variable.

This indicates that the currently displayed values do not correspond with the values of the time manager. To take over the new values into the time manager, the “Save” button of the variable must be pressed. By pressing the “Load” button, the changes made will be discarded.


frame To select the frame width of the variable.

font To define the size and the type of the font for labelling the week variable.

colour Here the colours for text, background, etc. are selected.

Extras: Rand (border) An extra border of the variable can be activated.

Visualisation


7.13 Video Variables (VIDEO Library, Option) description With the video variables “Player”, “Observer” and

“Recorder” pictures from video cameras can be displayed, Windows film files (so called AVI files) can be displayed and recorded. The video variables are not included in the basis version of the Visualisation software, but can be acquired as an option. If the “video” option is installed, the familiar dialogue box appears when you select “Services” -> “Insert variable”, but now also the video variables are listed:

requirements For the usage of the video variables also a video capture

card is required in addition to the hardware and software requirements as listed in chapter 1. If sound is desired, a sound card is also required. For the installation of video capture cards and sounds card see the manufacturers’ manuals.

Visualisation


Observer

description The observer is used for the display of the current image the

video capture card is receiving from a connected video source (e.g. video recorder, video camera).


video variable.

Visualisation


video source In this section the available video sources are listed and the

settings of the driver are defined. In the combo box all the installed video capture cards are listed. For the selected card you can call the setting dialogue boxes of the corresponding driver with the buttons , and

. These dialogue boxes are not represented here because they differ depending on the manufacturer of the video capture card. In general, you can adjust the dimensions of the image, the compression method, etc.

global frame rate Here you can adjust the time interval (in ms) for the refresh

of the picture. The smaller this interval, the smoother the playback, but the bigger the load for the PC and the Visualisation on the other hand. The optimised setting should be determined by tests.

extras In this section individual features of the variable can be

adjusted: ON/OFF switch If this function is activated, an ON/OFF button is included in

the variable which can be used for switching the playback on or off at runtime. This function should be used if the variable is not assigned to a process item (see below). If both the ON/OFF switch and the process connection are parameterised, switching on or off can be carried out by the process item or with the switch.

border An extra border of the observer can be activated. privilege level Indicates from which user’s privilege level on this observer

variable can be used. colour By selecting the according object (text, background) and the

desired colour, the display of the variable can be changed.

Visualisation


process connection The variable can be assigned to a process item of the

“single state/messages” data type. If the value of the process item is “1”, the image of the video source will be switched to the active mode, if the value is “0”, the image will be switched off.

Recorder

description The recorder is used for recording the current image the

video capture card is receiving from a connected video source (e.g. video recorder, video camera).


Visualisation


frame To select the frame width of the variable. video file The data to be recorded can be recorded as a single file (AVI

file) or can be included into a data base. This data base may contain several films (AVI files).

font To define the size and the type of the font for labelling the

video variable. video source In this section the available video sources are listed and the

settings of the driver are defined (cf. explanations under “observer”).


adjusted: ON/OFF switch If this function is activated, an ON button is included in the

variable which can be used for switching the recording on at runtime. After the predefined video length it will be stopped automatically (see below). The texts for the ON and OFF states can be entered into the entry fields below (default: On/Off). This function should be used if the variable is not assigned to a process item (see below). If both the ON/OFF switch and the process connection are parameterised, switching on can be carried out by the process item or with the switch.

invisible With this function a “hidden” switch can be realised. border An extra border of the recorder can be activated. sound If a sound card is installed, the sound source connected to

the input of the sound card will also be included into the film file if this function is activated.

record status display If this function is activated, a record status display will be

displayed beside the switch button. Active or non-active status is indicated by change of colour.

privilege level Indicates from which user’s privilege level on this recorder


Visualisation


colours By selecting the according object (text, background) and the

desired colour, the display of the variable can be changed. video file/ video data base If the “AVI file” menu item under “video file” is activated

(see above) the recorded data will be stored in one single AVI file which will be overwritten at every start of recording. If “video data base” is activated, the individual films will be stored in separate files; the number of files to be generated can be preset.

video name/ data base name Name of the video file or the video data base. video number Selectable only if “video data base” is activated: definition

of the maximum number of videos to be stored in the video data base. At each start of recording the next position in the data base is used for a film until the maximum number is reached. Then the first position is used again.

directory Definition of the directory the video file or the files of the

video data base are to be stored in. Attention: Please make sure that sufficient amount of hard disk storage is available. Details about the size cannot be given here, because the length of an AVI file depends not only on its recording time and frame rate but also on the dimensions of the image and the compressing algorithm of the driver. Please refer to the video capture card’s manual for detailed information.

video length Here the length of the video to be recorded is defined (in seconds).

frames per second Here the frame rate is defined. The more frames per second

are recorded, the better the recording quality but the bigger the system load. A good compromise are 15 frames per second.

process connection The variable can be assigned to a process item of the

“single state/messages” data type. If the value of the process item is “1”, recording will be started.

Visualisation


Player

description The player can be used for playback of recorded video files

and video files from the video data base. The video capture card is not required for the player (except if the data to be displayed were recorded using a special video card compression algorithm). However, the Video for Windows runtime version must be installed.

Visualisation


panel To select the panel size. frame To select the frame width of the variable. video file The data to be displayed can be single video files (AVI files)

or films from a video data base. This data base may contain several films (AVI files).


adjusted: playback buttons If this function is activated, the playback buttons for the

control of the playback will be displayed. Depending on the playback mode (single video file or video data base) they have the following functions:

AVI file data base

playback of the film from current position

start of the selected film of the video data base

playback of the film from the start

play all films of the database in sequence

stop playback stop playback

fast forward from current position

load next film of the video data base

rewind from current position

load previous film of the video data base

delete buttons This function can only be activated if the “video data base”

is selected as playback mode. Then two additional buttons with the following functions will be displayed:

delete selected film from video data base

delete all films from video data base

border An extra border of the recorder can be activated.

Visualisation


sound If a sound card is installed, the sound of the film will also be

the played if this function is activated. adjust video If this function is activated, the image size of the video will

be adjusted to the size of the variable. frame by frame display Can only be activated if the “sound” function is switched

off. In this mode a frame by frame display is activated, i.e. each individual video image will be displayed separately, the change of the images is carried out after the preset refresh time (see below). Depending on the refresh time selected, the film is displayed in slow motion.

exclusive mode In the exclusive mode the playback is as smooth as

possible. However, in the exclusive mode only one player variable per picture can be used. With slow computers or AVI files with disadvantageous compression algorithms the system performance can dramatically be decreased (slow reactions). In this case the exclusive mode should not be used.

refresh after If the exclusive mode is deactivated, the playback of the film

is controlled by the refresh rate. In this case, in one picture several players can simultaneously be active. However, if the sound is activated, only the sound of the movie started first will be played. With a setting of 500ms the frames are refreshed every half second. The longer the time interval, the more computer time remains for other processes, but the less smoothly the movie will be displayed. If sound is activated it will be played without interruptions in any case. The optimal value should be determined by tests. A refresh rate of 0ms is the same as the exclusive mode and therefore has the same restrictions,

video file/ video data base Depending on the mode selected (video file or video data

base) under “video name” or “data base name” the name of the AVI file or the name of the video data base is to be entered.

Visualisation


directory Here the directory containing the AVI file or the video data

base to be played is to be entered. process connection Each control function of the player (see description of

playback buttons and delete buttons) can be controlled by process items. Process items of the “single state/messages” data type are used. If the value of the process item is “1”, the function is carried out. To assign process items to the player, the player is to be parameterised with activated playback buttons and delete buttons. Using the Menu item “Services” ->> “insert variables” the process items are assigned to the corresponding buttons via “drag & drop”. Then the buttons can be deactivated in the style dialogue box of the player.

Event-Programme Commands

Independent of the active picture the recorder can be started by an event programme. Therefore the options “Event Programme” and “Logic Operations/Arithmetic Calculations” must be installed. Then the “recorder” command is available. With this command a recording can be controlled independent of the active picture, and with the “Time Manager” option even a cyclic monitoring with the video camera is possible (e.g. store a movie in the video data base every 15 minutes).

command syntax recorder(“driver name”, “file name”, iStartStop, iMaxTime

iFramesPerSec, iSound);

Description of the command parameters:

“driver name” Name of the driver enclosed in quotes. This is the same name which appears also in the style dialogue box of the recorder and can be seen there. The parameterisation of the driver should also be made via the style dialogue box of a recorder variable.

Visualisation


“file name” Name of the complete path and file name

of the AVI file. Example: “C:\\videos\\video.avi” (as the character “\” is also used in the event pro-gramme in other ways, it must be typed in twice). The video data base can also be accessed this way, but name and length of the database must be defined once in the style dialogue box of the recorder variable. The extension is “.INI”. (e.g.: “d:\\dbank\\video.ini”)

iStartStop To start recording, “1” must be entered here or an integer variable with value “1”. With “0” a recording in progress will be stopped. This is normally not required because the recording stops automatically when the recording time expires.

iMaxTime Definition of the recording time in seconds (default: 5).

iFramesPerSec Number of frames per second to be recorded (default: 15).

iSound Activation of sound recording with “1”. With “0” no sound will be recorded.

Visualisation


7.14 Loading/Saving Variables from the Project Library load/save variables In the style dialogue box of any variable (displayed by double

clicking with the left mouse button) the settings of the current variable can be stored in the so-called project library under any name (max. 12 characters).

The settings stored before can be recalled for any further variable of the same type.

7.15 Assignment of Image Variable ? Process Item general A process item must now be assigned to the image variable. display process items Available process items are listed via the menu item

“Services”? “Assign process items”:

Visualisation


assign process items The Visualisation must be in STOP mode.

The process item is assigned to the image variable by marking the desired process item, then dragging it with the mouse button pressed to the according image variable and releasing the mouse button (“drag and drop”). A beep indicates the successful assignment.

display in the status line The status line serves for verification. In the status line, the

assigned process item of the variable the cursor is currently on will be displayed.

display all items If this box is activated, all process items are displayed in the

selection list. selection If you only want to select from a group of process items

having the same characteristics, the selection can be limited: Entering “O*” and confirming with the enter key e.g. shows only process items starting with “O”. Note: If a process item is not accepted by the variable, either the serial interface has not been initialised by the user after the definition of a new process item or the data type cannot be represented or used by this variable. The week variable supports only process items which have also been parameterised in the time manager (option). Remedial action if the initialisation is missing: First close current picture, then perform the initialisation function via “Driver...” ? “Initialise serial interface” ? “Execute”. Now assign the process item to the variable once more (see also Chapter 5 “Create Project Data”: “Define Process items”).

Visualisation


8 Other Functions

8.1 Starting the Visualisation procedure The ONLINE mode is started by clicking on “Start” in the

menu bar.

This means that telegrams are received or sent, if a switching element is operated.

no bus connection If an error message indicates a missing bus connection

when the online mode is started, first close the current picture via “Pictures”? “Close picture” and call the “EIBus Configuration” dialogue via “Driver...”? “Configure serial interface”. Check the settings of the COM1 or COM2 interfaces and enter the physical address of the RS 232 interface used. Confirm with „OK“. Open your picture again and try once more to start the ONLINE mode via “Start”.

Visualisation


8.2 Simulating the Visualisation general If you are not on site and therefore the bus system is

unavailable to you, you can simulate your project. system configuration Simulation is enabled or disabled with the

auxiliary programme “Systemconfig.”. This programme is located in the “Visualisation instabus” programme group and is started by double clicking with the mouse.

procedure select topic “EIB Parameters” and subtopic “Simulation mode”.

enable simulation Select “Yes” from the combo box and take it over via the

“Set” button. disable simulation Select “No” from the combo box and take it over via the

“Set” button.

Visualisation


simulation settings The following additional settings can be made for the

simulation: simul. telegram rate Cycle time in seconds. Within this time interval the number

of telegrams defined under “Simul. Telegram Count” is simulated. Input range: 2 up to 10 seconds.

simul. telegram count Number of telegrams which are to be simulated within one

cycle. Input range: 0 up to 10 telegrams.

With the help of these settings it is possible to simulate different real bus loads.

terminate The programme is terminated via “Close” in the system

menu ( ).

Visualisation


8.3 Password Protection of Project define password Close all pictures and the project itself.

Call menu item “System administration”? “User profile set-up”.

password, name A password consists of “Name” (max. 11 characters) and

“Password” (max. 16 characters), each of them having 4 characters as a minimum.

Note: Several passwords with different priorities can be defined.

privilege level As privilege level a value between 0 and 99 can be defined.

The higher the user’s privilege level, the more rights to access he has:

?? Privilege level equal to or greater than 50 : “Exit programme” is possible.

?? Privilege level equal to or greater than 60 : “Import/export file” is possible.

?? Privilege level equal to or greater than 70 : “Import/export pictures” is possible.

Visualisation


?? Privilege level equal to or greater than 90 :

“Delete picture” is possible. ?? Privilege level equal to or greater than 99 :

“Edit/change password” is possible. The privilege will be checked by various variables as well.

project menu/ picture menu With “Project menu” and “Pic. menu” single menu items –

which will be available for the operator at a later stage – can be selected individually by using the “Add” and “Remove” buttons. At least one menu item of the project menu and the picture menu has to be released. If the operator is to have complete access to all items, the “All menu items” is to be selected in “Project menu” and “Pic. menu”.

menu preview The “Menu preview” button allows checking of the selected

menu items. The “End preview” button restores the normal status.

standard settings With menu item “Standard settings” the default grid

settings and the default background colour can be set. These standard settings are assigned to the specific user.

standard switches With the menu item “Standard switches” you can define

whether the status line is automatically switched on or off. setup The “Setup” button stores the settings.

Note: The “Setup” button is only released after the two menu items “Project menu” and “Picture menu” have been assigned.

Visualisation


Activating the password:

project access Select the “Project access” menu item; select the desired projects from the “Available projects” list and assign them to the “Projects with access” list. Confirm with „OK“.

Press the “Setup” button again. Close the “User profile setup” dialogue box with the “Close” button.

adjust pp.ini Now the password query must be activated in the pp.ini file. This file is located in the same directory under which Visualisation instabus has been installed (normally C:\VISUALIS).

[USER] U=GST-training-center C=SIEMENS DEF=

password query Change the entry in the “DEF=...” line from “DEF=SYSTEM“ to “DEF= “ ? During start-up the password and the name must be entered.

autom. selection Change the entry in the “DEF=...” line from “DEF=SYSTEM“ to “DEF=User“ ? The user “User” (i.e. password) is selected automatically

Visualisation


8.4 Changing User Names description When the Visualisation is started, you will automatically be

asked for the password and the user name under which you want to use the Visualisation, or a user is selected automatically. If you want to change the user name while operating the Visualisation, because functions are required which can only be accessed by another user name, this can be done without closing the Visualisation.

Call the menu item “User” in the system menu ( ).

log-on Enter the user name and the password and start the log-on

procedure with the “Log-on” button.

8.5 Automatic User Log-Off description If the Visualisation is not operated by the operator for a

certain period of time, the user currently logged on is automatically logged off. This function can also be deactivated:

attention, only for specialists To do this, in the “PP.INI” file in the “VISUALIS” subdirec-

tory the entry “WATCHDOG=nnnn” in the [CONTROL] section has to be added or modified. “WATCHDOG=1800” e.g. sets the time-out to 1800 s, which is the maximum value possible.

Visualisation


8.6 Automatic Start of Programme/Project/Picture general In order to automatically start Windows, the Visualisation,

the desired project and the “Starting picture” after the PC has booted, the following settings must be considered:

automatic start of WINDOWS Before the Visualisation can be operated, Windows must be

started. To do this automatically after the booting of the PC, the following entry must be added in the last line of the “autoexec.bat” file (in the root directory of the C: drive): ....... ....... win

automatic programme start The automatic start of a Windows programme is achieved

by simply copying the “Visualisation” programme icon from the “Visualisation instabus” programme group into the “Autostart” programme group. Click on the programme icon with the left mouse button and keep the Ctrl key pressed; drag the icon with the mouse button pressed into the “ Autostart” programme group. When the mouse button is released, the icon will be in the “Autostart” group and the programme will be started automatically after Windows has been started.

Visualisation


automatic start

of a project If the Visualisation is terminated via the system menu ( ), but not via the “Close project” menu item, the latest active project will automatically be loaded once the Visualisation is started again.

automatic start of a picture The automatic start of a picture is selected

with the “Systemconfig.” programme. This programme is located in the “Visualisation instabus” programme group and is started by double clicking on it with the left mouse button.

start-up picture selection Select “Start-up Picture Selection” from the “Topics” list

and the desired project from the “Project list”. Select the number of the picture to be started automatically under “Actual setting”. Take over the new setting with “Set” and exit the programme via its system menu.

Visualisation


8.7 Programme protection description To prohibit the user from changing the active programme

(task switching), it is possible to lock the “Task switch” function (via the “ALT”+”TAB” keys).

setting The task switching feature is selected in the

“Systemconfig.” programme. This programme is located in the “Visualisation instabus” programme group and is started by double clicking on it with the left mouse button.

system parameters Select the “System parameters” topics and the

“Programme protection” subtopics. Now choose the desired setting from the “Actual settings” dialogue (yes = active, no = not active) and take over the new setting with “Set”. The programme is terminated via its system menu.

Visualisation


8.8 Logging Event Messages description With the Visualisation you have several possibilities for

logging: ?? Output onto the message window on the screen (always

active) ?? Output into a file (can be switched on or off) ?? Output to one ore more printers (can be switched on or

off) priority of the event Which events or messages are to be logged depends on the

priority of the event assigned during data type definition or process item definition.

priority level 7: highest priority priority level 1: lowest priority priority level 0 suppresses message

logging which events? Now it can be defined from which priority level on the

events or messages are to be logged. Close picture via “Close picture” and project via “Close project”. Select item “Logging Settings” from the „System administration” menu:

Set a priority level in the “Monitor priority” combo box. Events or messages must have at least the priority level entered here to be logged.

OK The setting is taken over via the “OK” button.

With the setting above, for instance, all events or messages having a priority level of 5, 6 or 7 will be logged. All other events update the image variables, but do not appear in the message box, are not archived in a file (if active) and are not put out on a printer (if active).

Visualisation


8.9 Event Messages on the Screen description Events can be displayed in a message window (at the

bottom of the screen).

message window all over the screen If you click inside the message window, it will be enlarged

so that it covers the whole screen.

By clicking on the “Arrow down” button ( ) the message window is reduced to its original size. Note: Only events or messages having a priority level equal to or greater than the setting in “Logging Settings” and having the “Logging on event” flag set in their data type are displayed.

Visualisation


font size in the message window The font size in the message window is

selected via the “Systemconfig.” programme. This programme is located in the “Visualisation instabus” programme group and is started by double clicking on it with the left mouse button:

Font sizes between 12 and 32 can be selected with the scroll bar.

Set “Set” takes over the adjusted value. default The default value (= 12) can be recalled via the “Default”

button. The programme is terminated via “Close” in the system

menu ( ).

Visualisation


8.10 Storing Event Messages in File description In addition to the display on the screen all events and

messages can be stored in the files “pp1.log” and “pp2.log” (in the “C:\WINDOWS” directory). For this purpose the system parameter switch “Save messages in file” must be set via the “System config.” programme. See also chapter A.3. In principle, the latest messages are stored in the “pp2.log” file. If this file reaches the size of 1Mbyte, the contents of the file will be copied into the “pp1.log” file. Then the “pp2.log” file is deleted. The files “pp1.log” and “pp2.log” can be evaluated with any word processing programme. Note: When logging is enabled, only events or messages having a priority level equal to or greater than the setting in “Logging Settings” and having the “Logging on event” flag set in their data type are displayed.

Visualisation


8.11 Printing Event Messages description In addition to the display on the screen all events and

messages can be printed (e.g. SIEMENS PT88). It is possible to define from which priority level on the events or messages are to be printed out. The control of the printer can additionally be enabled or disabled via the one-day time programme of the “Scheduler” option.

selecting the printer interface The “Logging printer defaults” dialogue is called via the

“Project”? “Print...”? “Logging printer defaults” from the project menu (close picture before).

The following interfaces are available: ?? Parallel interfaces: LPT1 up to LPT4 ?? Serial interfaces: COM1 up to COM4 Enter the printer identification (31 characters max.) at the interfaces used, select the desired number of lines and columns and enable the interface with Active.

OK “OK” takes over the settings.

Visualisation


enable printer Now define via which of the active interfaces the events or

messages are to be printed. The “Logging printer activation” dialogue box is displayed by selecting the “Project”? “Print...”? “Logging printer activation” dialogue box:

All the printer identifications are listed which have been activated in “Logging printer defaults”. Enable the desired printer with Active. When the “OK” button is pressed the setting becomes active and the printer starts its output. Note: Only events or messages having a priority level equal to or greater than the setting in “Logging Settings” and having the “Logging on event” flag set in their data type are printed.

disable printer If no event messages are to be printed out in the “Logging

printer activation” all active printers must be deactivated. “OK” takes over the new settings, and there will be no further output onto the printer.

Visualisation


parameterise printer output The printer output can be parameterised via the

“Systemconfig.” programme. This programme is located in the “Visualisation instabus” programme group and is started by double clicking on it with the left mouse button:

system parameters The following settings can be performed in the “System

parameter” topic:

?? Page header format:

page header The first line of each page is used for the page header. The following entries are possible: fixed text: e.g. SIEMENS AG variables: &P = current page number &N = line number && = & character &K = name of the computer &D = date &T = time

Visualisation


control: &L = print out following text left justified &C = print out following text centred &R = print out following text right justified The default setting is: SIEMENS AG &R page: &P (i.e. text “SIEMENS AG” left justified, “page:” page # right justified) ?? Message text format

message text format Here it is defined how the event messages are to be printed

out:

fixed text: enclosed in “...”, e.g. “: “ variables: && = & character

&K = name of the computer &B = name of the user &P = data type: process item &F = error number &D11 = represent date e.g. with

11 chars &U8 = represent time e.g. with 8

chars &P27 = represent process item

name with 27 characters &V10 = represent value of the

process item with 10 digits

&Z20 = represent the status text of the process item with 20 characters

The default setting is: &D11&U8„: “&P27&V10&Z20 (i.e. date time : name_of_process_item value status_text)

Visualisation


?? Other text format

text format Here it is defined how general messages and system

messages are to be printed:

fixed text: enclosed in “...”, e.g. “: “ variables : &D11 =represent date e.g. with 11 chars &U8 = represent time e.g. with 8 chars &T59 = represent system messages with 59 characters The default setting is: &D11&U8„: “&T59 (i.e. date time : system_message)

?? Maximum message text width

message text width

Here the number of characters per line is defined :

minimum number: 40 characters maximum number: 128 characters default value: 80 characters

?? Maximum number of message lines per page:

messages per page

Here the number of lines per page is defined:

minimum number: 20 lines maximum number: 255 lines default value: 66 lines Note: As log printer a needle matrix printer or an ink jet printer with line oriented output is recommended (e.g. SIEMENS PT88). When using page oriented printers (like e.g. laser printers) the line feeds or form feeds are partially generated by the printer itself. Therefore it may happen that the parameters set are not used.

Visualisation


8.12 Audible Signal description The audible signal is activated in the data type definition.

The following events can be announced by an audible signal: With the “Single-State Messages/Commands” data type:

Single-State Messages/Com- mands The audible signal can be started both by the rising edge

and the falling edge. It will then remain active until it is acknowledged by the user. With the “Measurement values/Set commands/Coun??ter” data type:

Measurement Values/Set commands/Counter An audible alarm can be generated if the warning or alarm

limits are exceeded. It will remain active until it is acknowledged by the user and the state of warning or alarm is no longer valid.

sound card If additional hardware (sound card) is used for

the output of the audible signal, the desired alarm sound file can be selected via the “Systemconfig.” programme:

Visualisation


System parameters Select the desired sound file via the “System parameters”

topic and the “Alarm sound file” sub-topic. When an audible alarm is generated, the selected sound file will be put out via the sound card.

acknowledge The audible alarm can be acknowledged via the system

menu ( ) “signal off” or via the button in the lower right corner of the screen.

8.13 Status Display in the Message Window description In the message window there are several status displays

with the following meanings:

acknowledge the audible alarm

sending to bus

follow up time jobs

receiving from bus

event monitor

receiving from network

scheduler programme running

sending to networkevent programme running

“Loudspeaker” button Audible signal:

An audible signal can be acknowledged with this button (same function as “Signal off” in the system menu).

“Time” button Follow up time jobs (optional):

With this button time jobs of the current day which are already over can be followed up after the Visualisation has been switched on.

“exclamation mark” button Start event monitor (optional):

The event monitor is started for acknowledging events. Current events to be acknowledged are indicated by the flashing button. Flashing stops, if the event monitor is called and exited again.

Visualisation


LED “SB” SB - sending to bus:

Visual check whether the Visualisation is sending telegrams to the bus.

LED “RB” RB - receiving from bus:

Visual check whether the Visualisation is receiving telegrams from the bus.

LED “SN” SN - sending to network (optional):

Visual check whether the Visualisation is sending information via the PC network.

LED “RN” RN - receiving from network (optional):

Visual check whether the Visualisation is receiving information via the PC network.

LED “EP” EP - event programme running:

Visual check whether an event programme has been started triggered by an event.

LED „TP” TP - scheduler programme running (optional):

Visual check whether an event programme has been started by the scheduler.

8.14 Keyboard Operation Only description If the user is to operate the Visualisation only via keyboard

(i.e. without mouse), he can select the image variables by the tab key and carry out the command by the space bar (corresponds to the left mouse key). Here it is useful to define during planning which image variables can be selected via the tab key and in which sequence the image variables are to be selected.

Visualisation


The sequence is defined in the “Change tab order” dialogue box from the “Change”? “Object...”? “Tab order” menu item:

All picture variables, output variables, diagram variables and switch variables contained in the current picture are listed. In order to identify the variables they should be given a name. The names defined are also displayed in this list (see Chapter 7 “Define Dynamical Picture Elements”).

TS on An asterisk in the “TS” (i.e. tab stop) column means that

this variable can be selected via the tab key in the given sequence.

TS off If a variable is to be made non-selectable, mark the desired

variable and press the “TS off” button ? the asterisk in front of the variable disappears.

sequence If the sequence is to be changed, mark the according

variable and position the cursor between the two other variables the marked one is to be inserted (the mouse cursor changes its shape). Now press the left mouse button ? the marked variable will be shifted accordingly. You can also move whole blocks by marking more than one variable.

Visualisation


8.15 General System Settings description Via the “Systemconfig” auxiliary programme,

settings can be made which describe the general performance of the Visualisation. Also a fine tuning is possible to adjust the Visualisation optimally on the appropriate PC. The auxiliary programme and its setting possibilities is described in detail in Chapter 19.3. The “open pictures manually” system setting is not included in the auxiliary programme and is described below.

opening pictures manually The operator of the Visualisation may switch from one

picture to another with the help of the “picture variables”. If you want to provide the facility to open a picture also from the “Pictures” menu, there are the following possibilities:

Via the “Open picture” item (if this menu item is available for this user)

or : Via the names of the pictures displayed in the bottom part of the menu. The pictures can be opened by simply clicking on the name, but will be opened for editing and will not automatically switch to online operation by default.

Visualisation


parameterisation This feature can be changed in the “pp.ini” file in the

“visualis” directory: [CONTROL] PRNHEADER=SIEMENS AG &R page: &S ... MRU=1 ... The MRU entry can be parameterised as follows: MRU=0 the picture names are not displayed in the menu for direct opening MRU=1 names are displayed, but pictures are opened for edit mode when clicking on the name MRU=2 names are displayed, pictures are automatically switched to online mode after opening MRU=4 the picture names are not displayed in the “Projects” menu. In the “Services” menu the display of the current picture is also hidden (last line of the menu)

8.16 Acknowledging Events description If the “Event Monitoring” is installed and activated, the

event monitor can be started wit the “!” button in the lower line of the screen.

The button indicates by flashing whether events — parameterised as “to be acknowledged” — have been occurred or not. In this case the event monitor should be started and the events should be acknowledged there. When the event monitor is exited, flashing goes off.

Visualisation


9 Completion of Project Planning

9.1 Exporting a Project to Disk description In order to make a backup copy of the whole project on disk

or install a project on another computer, the project is to be exported (compressed).

call An open picture must first be closed, if necessary via the

menu item “Pictures”? “Close Picture”, and the current project must also be closed via the menu item “Project”? “Close project”. Now the “Project - Export” dialogue box is called via “Project”? “Export project”.

project to be exported Selection of the project to be exported. export to Selection of the drive:

DISK1: drive A DISK2: drive B

compress When this option is selected, data is stored on disk in a

compressed form. The “Action” and “Export process” bars indicate the exporting process.

Visualisation


9.2 Exporting/Importing Individual Data description If you want to use individual data from an existing project in

a new project, there is the possibility to export or import the following data:

pictures Individual pictures with their complete contents and the

related files (static background pictures, image variables, vector graphics, bitmaps etc.) can be exported or imported. When exported, the data e.g. of picture 1 are stored in the file “AF001.WRK” (and if necessary + AF001.VEC + *.BMP + *.MAC). Note: Exporting picture does not work additional.

files Individual graphics files of all graphics formats supported

can be exported/imported. call The functions are called with the project open via

“Project”? “Import...” (“Export...”)? “Pictures” (“Files”, “Texts”).

Visualisation


9.3 Printing the Project Data The Visualisation distinguishes four kinds of printouts:

current display You can print out the current picture as a graphical

representation: The printout is started by the “Pictures”? “Print”? “Screen F2” menu item.

picture related lists Different lists can be printed out for the current picture:

?? bitmaps (listing of all the bitmap graphics used in the current picture)

?? vectors (listing of all the vector graphics used in the current picture)

?? referenced files (variables and their related files) ?? variables (listing of the variables used in the current

picture) ?? settings of variables The dialogue box is called via “Pictures”? “Print”? “Lists...” with the picture open:

Select the desired lists and start printout procedure via „OK“.

Visualisation


project related lists/data The following lists can be printed out for the current project:

?? pictures (listing of all the pictures of the current project) ?? bitmap files (listing of all the bitmap graphics used) ?? vector files (listing of all the vector graphics used) ?? variable libraries (listing of the contents of the libraries of

variables) The dialogue box is called via “Project”? “Print”? “Project reports”:

Additionally it is possible to print out all the texts defined in the current project via “Project”? “Print”? “Project data”:

Select desired lists or data and start printout procedure via „OK“.

Visualisation


interface related data Now the interface related data can be printed out for the

current project: ?? interface parameters (COM interface, physical

address,...) ?? data types (settings of the data types defined) ?? process items (settings of the process item defined)

The dialogue box is called via “Driver...” :

serial interface parameters By marking the “Serial interface parameters” item and

pressing the “Execute” button the desired data is printed out. The printout can alternatively be started by double clicking on the “Serial interface parameters” item.

print data types By marking the “Data types” item and pressing the

“Execute” button (or double clicking on “Data types”) a dialogue box for additional selections is displayed:

Visualisation


selection In the “Selection” section the data types to be printed out

are selected. Print “All” is activated by default.

name mask If only data types with a special feature in their name are to

be printed, this may be entered here with the commonly used notation, e.g. “OG*” ? prints all data types starting with “OG”, or “L?FAULT” ? prints all L_FAULT data types with any character at the second position

changes since If only data types changed after a certain date are to be

printed out, this date can be entered here. The format of the entry must correspond to the data format defined in the control panel under country settings (in the Great Britain normally DD.MM.YYYY).

print includes, sort order The contents of the list is sorted according to the selected

feature (type, date, name). Default setting: name. detail If this function is selected, a separate page is printed out for

each data type containing all details. prepare After all print-out features have been selected, the

“Prepare” button must be operated. Data types are filtered The number of the data types found is displayed in the dialogue box as follows: “... entries found”. Now the “Print” button can be accessed.

print Printout of the data types. The button can only be accessed

if the “Prepare” button has been pressed before. configure printer Setting of the desired default printer. The dialogue box is

printer related and corresponds to the dialogue box displayed in the Windows control panel under “Printer” ? “Settings”.

done Closes the dialogue box.

Visualisation


process items By marking the “Process items” item and pressing the

“Execute” button (or double clicking on “Process items”) a dialogue box for additional selections is displayed:

selection Selection of the process items to be printed out (as in “Print

data types”, see above) name mask As in “Print data types”, see above. changes since As in “Print data types”, see above. list of groups If only process items of special group addresses are to be

printed, the desired group address can be entered here. Form of entry: zone/line, e.g.: 3/4. Multiple indications are separated by semicolons, e.g. 3/4;1/1;1/2.

list includes, sort order As in “Print data types”, see above.

Visualisation


further features If desired further features of the process item can be printed

in the list. They are:

groups ETS comment data type creation date latest change picture (picture number and description)

detail A separate page with all details is printed out for each

process item. prepare As in “Print data types”, see above. print As in “Print data types”, see above. configure printer As in “Print data types”, see above. done Closes the dialogue box.

Visualisation


10 Installation of Options description The additional functions are released via a separate option

disk. Note: The Option disk is related to the dongle number. If another dongle is used, you need another option disk for this dongle.

10.1 Activating the Options During a New Installation activation at new installation The Visualisation is to be newly installed and the options are

to be activated. After the installation is completed successfully, the option disk has to be inserted and the option must be added via the option installation programme (disk 1 : “setup.exe”).

10.2 Activating Options Later activate options later The Visualisation has already been installed. You will receive

further option disks for your dongle if you purchase additional options later. The options can be installed as described in chapter 10.1 and will then be available.

Visualisation


10.3 Checking of Released Options If you want to know which options are available in the Visualisation installed, proceed as follows: Call the “System information” box via the “Help”? “Info about...”? “More...”. The following information window is displayed:

Here the number of the dongle used, the 20-digits serial number, the version and all available options are listed. If an option has been released, this is indicated by “yes”. If an option is not released, “no” is displayed.

Visualisation


11 The “Device Monitoring” Option

11.1 Features description This option is used for the monitoring of bus devices

connected to the instabus EIB and for announcing defective devices. It is possible to detect and announce a defective bus device within a time period of six hours (even in the maximum configuration). The monitoring is achieved by cyclically addressing all bus devices known by the Visualisation. In order not to cause a high load of the bus by polling, every 15 seconds one or several bus devices are addressed until all bus devices have been addressed once. Then the polling cycle starts anew. The exact number of devices to be addressed within these 15 seconds depends on the number of existing bus devices and is automatically calculated by the monitoring programme.

activation The option is automatically activated when it is installed by

an option disk. However, it may be deactivated (If, for instance, parts of a building complex normally monitored are switched off, the monitoring instrument will consider these as defect.) manually for diagnostic reasons. In the tools.ini file, in the [PPEIBDLL] section, the following entry has to be made: BKOFF=1 (deactivate) delete entry or: BKOFF=0 (activate) If only some of devices should be exempt from the monitoring, you may want to set it in the EIB-Tool after the system files have been processed. For this matter, you simple have to remove the physical address of the relevant devices from the list of the known devices via “Services”? ”Devices”? ”Edit list”; the system files do “not” have to generated again after that.

Visualisation


announcement of defective bus devices If a bus device is detected as defective (it does not respond

after it has been addressed), the following message is displayed in the message window: Device failure: 1.1.23 (= physical address) Of course, this message is also printed out by the log printer (if connected). The messages can also happen with an audible signal (e.g. via a speaker for the P.C. or directly via active speakers by using a sound card). This acoustic messages at a failure of the implement may be activated or deactivated in the EIBTool via EIB parameter? audible signal for failure of implement. Running in the standard mode the Visualisation is able to display up to 10 defective devices at a time. These devices are polled very quickly to display the return of a defective device as fast as possible. This behavior may be changed to work as follows: The Visualisation may display up to 6000 defective devices at a time, but without the quick polling algorithm! As a matter of principle all devices are polled in turn, and a status change of a device will be displayed in the message window. To adjust the announcement mode, you have to do the following steps: - Close the Visualisation - Open the file Tools.ini inside your Visualisation folder

(e.g. C:\Visualis) with a normal ASCII-editor (e.g. Notepad)

- In the section [PPEIBDLL] insert the line: MAXOUT=nnnn If you set nnnn to a value between 0 and 10, the Visualisation will work in the standard mode (the default mode). If nnnn is between 11 and 6000 all devices are checked in turn, and up to nnnn defective devices are displayed at a time

Store the file and start the Visualisation again

Visualisation


12 The “Event Programme” Option

12.1 Features features With the event programme option you can create macros. It

is possible, for example, to use such event programmes for the control of devices whose group address is not contained in the triggering telegram when the status of an actuator or sensor changes. With the “Calculations/Logic Operations” option the features of the event programme option can be extended by further functions. In the “Extra parameters” window of the “Process item definition” it can be defined which event programme is to be started at which change of status of the process item. For the creation or modification of event programmes a “Programme editor” window can be opened from the project menu under “Add-Ons” by selecting the “Event programme” item. A maximum of 2048 event programmes can be defined.

Visualisation


12.2 Programme Editor description The programme editor is used to create event programmes

which can be started via an event or via the scheduler. call The programme editor is called via the “Add-Ons”? “Event

programme” menu item of the project menu.

description of the menu The editor contains:

?? a large entry field for the creation of the event programme,

?? a window of its own where all available process items are listed,

?? a window of its own where all available commands are listed (these two windows can be displayed or hidden by the “Windows” menu item)

?? a status field ?? an information field ?? a menu with a related tool bar

Visualisation


The menu bar offers the following functions (the most important items are also available directly via the symbol buttons):

file Here programmes created can be saved, loaded, imported,

exported, deleted or printed. edit Here the most recent change during editing can be undone,

marked items can be copied, pasted, deleted etc. Also search and replace functions can be found here.

options Here the desired font can be selected. windows Here the additional windows can be displayed:

?? a list of all process items ?? a list of all available commands ?? a find function including all programmes defined

compile Starts the compiler procedure. After the programme has

been successfully compiled, it can be started for a test. Only successfully compiled programmes can be used.

start A compiled programme can be started manually here.

If a compiled and stored programme is assigned to a process item, the assigned programme is started by the according change of the status of the process item.

12.3 Structure of an Event Programme description of syntax An event programme can consist of only one line or a

sequence of programme lines. A statement must always be terminated by the “semicolon” character. Statements must always be written in lower-case letters (e.g.: delay ).

Visualisation


commentaries Commentaries (for better understanding of the programme)

must be enclosed in /* */ (e.g.: /*commentary*/).

process items All process items listed in the listbox can be used. To

identify of a process item it must be enclosed in quotation marks and a $ sign must be put in front of it (e.g.: $"name"). The $ sign is used to mark names of process items; the quotation marks are necessary to mark start and end of the name, because a name of a process item may also contain blanks.

drag & drop The process items can also be copied from the process

items window into the editor window by “drag&drop”. A programme line may contain:

assignment: process item= value 1) the assignment of a certain status or value to a process item (example: $"Lighting1"=1; or $"Lighting2"=40;

(explanation: the first statement switches on lighting1, the second dims lighting2 down to 40%)

assignment: process item 1 = process item 2 2) the assignment of the status or value of one process item

to another process item. (example: $"Lighting3"=$"Lighting4"; )

delay 3) the definition of a delay in tenths of seconds (integer

number between 1 and 3000, i.e. the max. delay is 5 minutes). The delay is running before the next statement is executed.

(example: delay(15); ) (explanation: the statement above causes a delay of 1.5 seconds)

Visualisation


start statement 4) the start statement for another event programme

(example: start(“name”); ) (explanation: the name of the programme to be started must be enclosed in quotation marks and brackets directly behind the statement. It must be terminated by a semicolon.

commentary 5) a commentary text

(example: /*lighting conference room ON*/).

12.4 Deactivation of the Event Programme deactivation It may be useful for diagnostic reasons to disable the

processing of event programmes for a certain time interval: With the help of the “Systemconfig.” pro-gramme the event programme option can be disabled by setting the “Event programmes” subtopic under the “Add-Ons” topic to “no”. It is released again by setting this parameter to “yes”.

Attention: the activation of the event programmes is only possible, if this option has been enabled via the 20-digit serial number.

Visualisation


12.5 Notes on Programming sequence of processing If more than one event programme is started at the same

time by process related events, only the one triggered first is processed. All other event programmes are stored in a buffer. If an event programme is finished, the next one from the buffer will be processed (first in, first out, i.e. strictly sequential processing of the event programmes).

endless loops If the START statement is used to start another event

programme, you should pay attention to the fact that no endless loops are generated by event programmes calling one another (e.g. event programme 1 starts event programme 2, which in turn starts event programme 1)! This causes the buffer to fill up, and thus other event programmes cannot be processed!

delay If an event programme processes a delay statement, it

stops as long as has been defined in the delay statement’s parameter. Thus multiple delay statements can substantially slow down the processing of other event programmes! Therefore the maximum delay time per statement has been limited to 5 minutes!

accuracy of delay times When defining a delay time in a statement it is to be

considered that the time defined is a minimum delay time. It may, however, be longer due to the software!

reaction time If the bus load with telegrams is about 100%, it can take

theoretically up to 30 seconds until the first command of the started event programme is sent, after the triggering event has occurred. Normally it takes 0.5 seconds.

display: event prog. running The message line displays whether an event programme

has been started and is still in process and if further event programmes have been entered into the queue.

Visualisation


12.6 Completion of Project Design If the desired event programmes are defined, it is possible to print out the programmes and lists containing the process items used by the programmes for documentation on the standard printer.

Printout of a programme The programme to be printed out is to be loaded into the

editor. When menu item “File”->“Print”->“Programme” is selected, a dialogue box appears where the header line of the printout (normally the name of the programme) can be entered. The “OK” button starts printing, the “Cancel” button cancels the procedure.

printing of cross- reference lists Via the menu item “File”->“Print”->“Cross Reference” a

dialogue box appears, where two different kinds of lists can be selected and printed out: first a list of programmes containing process items (“Programme - Process item list”) and second a list of Process items used in programmes (“Process item - Programme list”). For both, the programme name and the process item name masks can be entered as a filter. Default is “*” in both cases, i.e. all process items in all programmes. When the desired setting is made, the “Prepare” button is to be pressed. Now the list will be generated. If the list contains at least one entry, the “Print” button will be released, pressing it will start the printout.

Visualisation


13 The “Calculations/Logic Operations” Option

description This option extends the instruction set of the event programme editor by logic, comparing, arithmetic and trigonometric commands and operators and statements for the programme flow.

applications With the new features it is e.g. possible to check whether

the lights are still on in a building, or a window shade is still closed, or a window or a door is still open. The result of this check can then be assigned to a process item, so that this information may be displayed on the screen or printed out. Furthermore e.g. the power can be calculated from voltage and current, the result can be assigned to a process item and be displayed on the screen or printed out.

programming language The programmes entered in a special programming

language must be compiled before saving. The compiler detects and displays syntactical errors (logic errors in the programme cannot be detected). Note: The “Calculations/Logic Operations” option requires the “Event Programme” option!

Visualisation


13.1 Instruction Set

Variables description Within an event programme variables can be used in order

to simplify the programme and to reduce telegram traffic. names of variables The name of a variable may be up to 32 characters long and

must start with a character or an “underscore” sign. types of variables The following two variable types can be used: “int” (integer

number) and “real” (floating point number), each variable is to be assigned to one of these data types.

example int Lamp1; (defines Lamp1 as integer variable)

real Lamp2; (defines Lamp2 as floating point variable). INT variables INT variables (integer numbers) have a range of values from

0 up to +-2147483647. REAL variables REAL variables (floating point numbers) have a range of

values from +-2.2250738585072014 E-308 up to +-1.7976931348623158 E+308. Instead of a comma (as in Germany) the period is used to mark decimal places (e.g. 100.45). Besides this notation also the exponential notation can be used for very large or very small numbers. Here it is to be noted that there must be no blank before and behind the “E” character.

Visualisation


In addition to this there are predefined variables which can only be read:

day of the week weekday current number of the day of the week

(1-7, 1=Monday) day of the month monthday current day of the current month (1-31) month month current month (1-12) year year current year (e.g.: 1994) calendar week week current week of the year (1-52) time time current time (e.g.: 1309, first the hours, then

the minutes without separating character) error ERROR number of error after accessing a process

item (0-not error)

Constants PI, e constants PI ................ the value 3.141592654

E ................. the value 2.718281828

Labels description Labels can be addressed by goto or gosub commands. The

structure of a label is as follows: syntax L.any characters or numbers: (remember termination by

colon!) example of a little loop:

i=0; L.Start: i=i+1; if (i<<10) goto L.Start;

Visualisation


Logic Operators logic operators AND and operation

OR or operation NOT negation

Comparison Operators comparison operators > greater

< smaller >= greater or equal to <= smaller or equal to == equal to != not equal to

Arithmetic Operators arithmetic Operators = assignment (of a new status or value to a

variable or process item) + addition - subtraction * multiplication / division abs (x) delivers the absolute value of x pow (x1,x2) delivers x1 to the power of x2 exp (x) delivers e to the power of x log (x) delivers the logarithm to the base 10 of x ln (x) delivers the logarithm to the base e of x sqrt (x) delivers the square root of x

Trigonometric Functions trigonometric functions rad (d) converts degrees (d) into radians

deg (r) converts radians (r) into degrees sin (r) calculates the sine of r (radians) cos (r) calculates the cosine of r (radians)

Visualisation


Conditions/Control Commands while loop while (cond) command;

as long the condition “cond” is fulfilled, the command is executed example: while (a) { a=a+1; b=b+2; };

if statement if (cond) command 1; else command 2;

if the condition “cond” is fulfilled, command 1 is executed. If it is not fulfilled, command 2 is executed example: if (a==1) a=2; else {a=3;b=4;} Note: If the “else” statement is omitted, the programme continues with the next statement.

Jump Instruction goto goto L.JumpingLabel;

Jump to the defined jumping label. Jumps to the location for which the jumping label has been defined.

Subroutine Call gosub gosub L.JumpingLabel;

Jump to a subroutine. Jumps to the defined jumping label and returns due to a return statement. example: gosub L.label; . . L.label: . . return

Visualisation


Set/Read User Flags setflag setflag($"ProcessItem",FlagNumber,Status);

Sets the addressed user flag of a process item to the desired status.

getflag Status=getflag($"ProcessItem",FlagNumber);

Reads the status of the according user flag of the process item.

Initialise Process Item / Process Item Status Check initstate initstate($"ProcessItem")

When a picture is started the process items used in it are automatically initialised. However, in a start programme this is not the case. Process items needed may not be available. By using “initstate” the required process items can be initialised as privileged. Whether the process item has successfully been initialised can be checked via “getstate” (cf. below). This command is only useful in start programmes.

getstate status=getstate($"ProcessItem", StatusNumber)

Reads the status information of a process item. Only the “0” (zero) parameter of the status number is supported at the moment (i.e. online status). Values fed back to the “status” variable for the online status: 0 offline < 0 process item does not exist > 0 online, process item has been initialised

Load Picture picture picture (x); Loads the picture with the number x

Play Wave File play play (“ding.wav”);

Plays a wave file (.WAV), only possible with a sound card!

Visualisation


Audible Signal beep beep; Starts the PC beeper. It beeps until it is

acknowledged by the operator.

Printing Texts/Variables print print (Variable, HintTextNumber);

or print (“Text”, hintTextNumber); Prints the contents of a variable and/or a hint text If the hintTextNumber is 0, no text will be output. If any text is to be printed out, this text – enclosed in quotation marks in the print statement – may also contain the following: \n (line feed) \f (form feed) \\ (print “\” character)

End of Programme end end; Terminates the programme (the statement is not

required at the end of the programme; it can e.g. be used to terminate the programme in an if statement, if the condition is not fulfilled).

Bracket Terms application Bracket terms can be used to clearly define and indicate the

sequence of processing of complex operations and calculations. example: "RELEASE"=($"LAMP1" AND $"LAMP2") OR (NOT $"LAMP3");

Visualisation


13.2 Event Programme Monitoring description When event programmes are started it is distinguished –

depending on how they are started – between ?? Event programme calls via the scheduler and ?? Event programme calls by events. If an event programme is called although the previous event programme of the same calling type is still running, the new call is not performed immediately, but is entered into a queue, sorted according to its priority. After the previous event programme has been terminated, the next call is taken from the queue and is performed.

queue Consequently, there are two queues:

?? A queue for event programmes called via the scheduler. ?? A queue for event programmes called by an event. This means two event programmes can be performed at the same time, one called by the scheduler and one called by an event on the bus. In order to have a monitoring possibility in projects calling a lot of event programmes in order to see which programmes are currently being performed and which event programmes are still in the queue, the “Programme Manager” function may be used and evaluated.

call The function is called via the “Add-Ons”? “Programme

Manager” menu item:

Visualisation


Display of the Active Event Programmes – Called by Events

event programme via an event In the upper part of the dialogue box all event programmes

called by an event are listed in a bar display: line A : Here the event programme currently running is represented. lines 1 - 7 : Here all event programmes which are currently in the queue are displayed, sorted according to the defined priority. By clicking on the corresponding bar the name of the event programme concerned is displayed in the “Programme name” field, and the hint text which has been assigned to the programme is displayed in the “Programme hint” field. The event programme marked (the corresponding bar) can be removed from the queue by pressing the “Remove” button.

Visualisation


Display of the Active Event Programmes – Called by the Scheduler

event programmes via scheduler In the middle part of the dialogue box all event programmes

called by the scheduler are listed in a bar display: line A : Here the event programme currently running is represented. lines 1 - 7 : Here all event programmes which are currently in the queue, are displayed, sorted according to the defined priority. By clicking on the corresponding bar the name of the according event programme is displayed in the “Programme name” field, and the hint text which has been assigned to the programme is displayed in the “Programme hint” field. The event programme marked (the corresponding bar) can be removed from the queue by pressing the “Remove” button.

Display of the Workload by Event Programmes

display of the workload In the lower part of the dialogue box there is a graphic

display for the workload of ?? event programmes called by an event, and ?? event programmes called by the scheduler. A third bar represents the capacity still available for the call of event programmes.

Visualisation


13.3 Incorrect Programming notes Due to incorrect use of the statements

while goto gosub programme loops can be generated which lead to a locking of event programmes or scheduler programmes. As such errors cannot be detected by the compiler, the use of these statements should be avoided. Services of the maintenance staff due to such errors are fully charged. It is also to be noted that the “Calculations/Logic Operations” Option is primarily used to extend the display capabilities and not to replace a PLC for process control.

Visualisation


14 The “Time Manager” Option

14.1 Features description The Time Manager of the “Visualisation instabus” is a

multifunctional time switch on PC base. system clock The PC internal system clock is the basis for date and time. day / time settings With the help of an annual calendar, up to 99 time settings

per day can be entered. Up to 99 jobs can be assigned to one time setting. These day programmes then can be distributed over the year.

kinds of jobs A job may be:

?? starting pictures ?? displaying hint texts ?? enabling/disabling printer ?? starting event programmes ?? executing process-item commands

week variable With the week variable, process-item commands can be

parameterised which are time-dependent on the day of the week. The time jobs for all week variables are defined and managed in the “Time Manager” add-on. Note: The “Time Manager” option requires the “event programme” option. If the previous version of the time manager was used to define time jobs in an existing project, they are still carried out until the new time manager is started. However, in order to edit these old day-related programmes they must then be imported into the new time manager (the appropriate function is included).

Visualisation


14.2 Structure calling the time manager The time manager is called from the project menu (no

picture opened) via the “Add-Ons”? “Time Manager” menu item.

principle of function After starting the time manager you are in the “Display”

mode. In this mode all jobs of the current day are displayed. There are four modes:

mode 1: edit day programmes

mode 2: set day programmes

mode 3: display

mode 4: parameterise week variables

The appropriate mode is called by pressing the buttons at the top line of the screen.

Visualisation


14.3 Editing Day Programmes

description A day programme is a list of times of day. Up to 99 jobs can

be assigned to each time. A maximum number of 32 time/ jobs lists can be defined and each day programme has its own number (1 to 32) and a freely definable name. In the upper half of the screen the 32 possible day programmes are displayed as a list. Each field of the table corresponds to a day programme. If the field is displayed with a yellow background, the corresponding day programme contains one or more time jobs. If a field is selected by the mouse, it will be displayed with a border and in the lower left part of the screen its name and its related time/job list will be displayed.

Visualisation


14.3.1 Changing the Name of a Day Programme First the day programme to be changed must be selected from the table of day programmes

Now the name of the day programme can be entered into the entry field.

Name and time/jobs list will automatically be stored when the edit mode is quit or another day programme is selected from the list.

14.3.2 Definition of Time Jobs description In the time/job list on a day programme jobs are assigned to

times of day. This assignment is displayed in the lower left part of the screen as a table containing two columns.

The first column contains the time, the second column contains the related jobs. If more than one job is assigned to a time, normally only the first item is displayed. However, the corresponding job field can be selected with the mouse, and now the list with the jobs is displayed.

Visualisation


adding/changing times If a new time is to be defined, an empty field in the time list

is to be selected. If an existing time is to be modified, the appropriate field is to be selected. Then the desired time can be entered. The time can also be adjusted with the two arrow symbols which appear after selection.

adding jobs If a time has been entered into the time column, the jobs can be defined in the corresponding line of the job column. Beside the time/job list of the day programme a list of job types is displayed.

If one of these types is selected with the mouse, a list with the available elements is displayed to its right. Now one of the elements of this list can be selected with the mouse and can be dragged into the desired job field while keeping the left mouse button pressed. When the mouse button is released, the marked job is dropped and appears in the job field next to the time. The following types of jobs are available:

Start Prg. Here all event programmes available are listed which can be

called via the time manager. Start Pic Here all the pictures of the Visualisation are listed which can

be called via the time manager.

Visualisation


Send Text Here all hint texts defined in the current project are listed.

When a job for sending a text is defined, a dialogue box appears where you define to which PCs the text is to be sent to.

change printer There are two possible jobs: “Printer on” and “Printer off”.

If a printer job is assigned, a dialogue box appears where the corresponding printer is to be selected.

process items Here all available process items are listed which can be

changed via a command. Currently only process items of the “single state messages/commands” data type can be controlled by the time manager. When a process-item related job is assigned, a dialogue box appears where the desired value is to be entered (0 or 1).

Visualisation


14.3.3 Copying/Deleting Time or Jobs description Times and jobs within one day can be copied or deleted

using the following functions: duplicate time / jobs You have the possibility to automatically define the jobs

which remain unchanged within one day and which are to be performed repeatedly within a certain time interval. To do this, move the mouse pointer to the time to be duplicated and press the left mouse button. Keep the mouse button pressed, while the mouse pointer is moved to the related job field. Now extend the selected area by moving the mouse pointer (keep the button pressed) for as many time fields as you want to define new times. Now the mouse button can be released, and the selected area is displayed with coloured background:

If the “Dupl. Time/Jobs” button is pressed, the first job entry will be copied to all selected fields, and the related times will automatically be entered into the corresponding time fields. The entered times are computed from the first time entry plus the time increment (adjustable in the options section, default: 60 minutes).

delete time / jobs If all jobs of a time entry or all time entries with related jobs

are to be deleted, you can use the “Delete Time/Jobs” button. To do this, select the job to be deleted with the mouse pointer and press the left mouse button and, if required, move the mouse to the related time field by keeping the mouse button pressed. By keeping the mouse button pressed, additional time/job fields can be selected. Now the mouse button can be released, and the selected area is displayed with coloured background:

Visualisation


If the “Delete Time/Jobs” button is pressed, all selected fields will be deleted.

delete individual jobs You can also delete individual jobs of a defined time.

To do this, select the according job field. If the job to be deleted is not displayed, it must first be selected from the job list.

This job will then be deleted by pressing the “Remove Job” button.

14.3.4 Copying/Deleting Day Programmes description As programmes for individual days often have similar

settings in most time manager applications – e.g. there are only small differences between programmes for Mondays and Tuesdays – you have the possibility to copy or duplicate already defined day programmes.

copy/insert day programmes The jobs are copied into the desired day programmes by

using the clipboard. First the day programme to be copied is selected with the mouse. If multiple day programmes are to be copied, they are also to be selected by keeping the mouse button pressed. The selected area is now displayed with coloured background.

Visualisation


All selected day programmes are copied into the clipboard by pressing the “Copy” button. Now the field for the day programme where the copied programmes are to be inserted is to be selected by the mouse. The action is carried out by pressing the “Paste” button.

duplicate day programme If you want to copy a day programme repeatedly, this can

easily be performed by the “Duplicate” function. Select the day programme to be duplicated by the mouse and select the area where the programme is to be copied by keeping the mouse button pressed.

If the “Duplicate” button is pressed now, the day programme first selected is copied into all selected fields.

delete day programme This function is used to delete all times and jobs of one or

more day programmes. Select the day programme to be deleted or mark an area to be deleted by keeping the mouse button pressed. If the “Delete” button is pressed now, all selected day programmes will be deleted.

Visualisation


14.3.5 Editing Day Programmes – Options In the “Options” section (press “Options” button with the mouse) edit settings can be changed, day programmes can be stored in a data base and can be loaded again, event programmes used in day programmes can be searched for texts and day programmes can be printed out.

time step The time increment which is used for the “Dupl. Time/Jobs” function in edit mode can be adjusted here. After entering the new value (in minutes), press the “Take step” button to activate the new setting.

save day programmes For archiving purposes day programmes selected before by

the mouse can be stored under a name in a data base by pressing the “Save” button.

Visualisation


load day programmes Day programmes archived before can be loaded again by

pressing the “Load” button. The programmes will be inserted at the position selected before by the mouse. Archived day configurations can be deleted from the data base using the load or the delete dialogue box.

import day programmes Day programmes generated by the former calendar time

manager can be loaded by using the “Import” button. The old programmes are located in the project directory as individual files named “DayMonthYear.CAL”. The file to be imported can be selected from the combo box, and a name is to be defined for the loaded programme. The programme will be inserted at the position which has been selected by the mouse before. To save hard disk storage we recommend deleting all old day programmes no longer used with the “Delete” button.

make list of event programmes If the “Start Prg.” jobs were used in the day programmes it

may be required to know whether a certain process item is used in these programmes. The name of this process item can be entered into the entry field.

Visualisation


By pressing the “Start search” button, all day programmes selected before are searched for event programmes. In the event programmes found the search text will be searched. If the search text is contained at least once in an event programme, the name of the programme is included into the list below.

print The jobs of the selected day programmes or the result of

the search for event programmes can be printed out. The printout is started with the “Print” button

14.3.6 Editing Event Programme description In order to generate new event programmes or to edit

existing programmes, the editor for event programmes can directly be called from the time manager:

calling the editor The editor for event programmes is called by pressing the

“Event prog.” button: For generating and editing event programmes see Chapter 12: “The Event Programme Option”.

Visualisation


14.4 Setting Day Programme description After day programmes have been defined, it is required to

define the days on which the day programmes have to be carried out. This assignment is made in mode 2: “Set Day Programme”.

14.4.1 Sorts of Days There are three sorts of days:

every day The day programme assigned to the “every day” sort of day

will be carried out on every day of the year.

week day There are seven days of the week (Monday to Sunday)

which can be related to a day programme. For instance the day programme assigned to “Wednesday” will be carried out every Wednesday.

Visualisation


special day The first two sorts of days allow to handle most of the jobs

to be done repeatedly. However, for special time periods of the year (e.g. holidays) some jobs are not to be valid. Therefore it is possible to define up to 128 periods of special days to which day programmes can be assigned. These special days may be individual single days (e.g. December 24th of each year) or longer periods (e.g. from June 1st, 1996, until July 1st, 1996). Also general definitions of a day such as the first day of the 30th week of the year are possible.

14.4.2 Assign Day Programmes description In the second mode a list with the available days and the

related day programmes is displayed on the left of the screen. On the right all day programmes defined in mode 1 are listed. If a day programme is to be assigned to a day, the day programme is to be selected by the mouse. The day programme can now be dragged on the desired day by keeping the mouse button pressed. By releasing the mouse button the assignment is made. If a day programme is to be deleted from a day, the day programme “00:Delete” is to be dragged on the day programme to be deleted.

Visualisation


14.4.3 Defining / Changing Special Days description If an entry is deleted from the list of special days by double

clicking with the mouse, the dialogue box “Define Date” is displayed. Here the special day can be changed, deleted or checked.

define special day First a descriptive name for the special day should be

entered. Now there is a choice between a normal date or a general description of a date. With a normal date only day and month and, if necessary, the year is to be entered. If the date is not to be assigned to a certain year, the checkmark in the “Year” checkbox is to be removed. The date will then be valid for every year. If a time period is to be defined, the checkbox “until date” is to be checked and the second date is also to be entered. With a general description at a date the period can be defined corresponding to the checkmarks set at “Day”, “Week”, “Month” and “Year”. If only the day is selected, the number entered defines the absolute number of the day in a year (e.g. the 214th day of a year).

Visualisation


If day and week are selected, the number of day represents the day of the week (1 up to 7) and the number of week represents the week of the year (1 up to 52). If day, week and month are selected, the day represents the day of week, the week represents the week of month (1 up to 5) and the month represents the month of year (1 up to 12). It can also be defined – as with the normal date – whether the general date is to be assigned to a certain year or not and whether a time period is to be defined or not.

Independent of the kind of date (normal or general) a number of days can be added to the date (setting “Add days to definition”) to be able to realise a definition such as: “40 days after February 1, 1996.

Visualisation


check definition After completing the definition of the date, the setting

should be verified by pressing the “Check” button. A dialogue box will be displayed where a complete year is graphically displayed. Each box in the display represents a day. Blue boxes represent days not included in the definition and red boxes represent days included in the definition. The year can be changed by pressing the +/– buttons.

delete special day If a definition for a special day is to be deleted completely,

the special day is to be selected by double clicking and the “Delete” button of the dialogue box is to be pressed.

Visualisation


14.4.4 Editing Assigned Day Programmes description If you want to edit an assigned day programme, you can

switch to mode 1 by pressing the graphic button, select the appropriate day programme and edit it. However, as a shortcut, you can select the corresponding day to which the day programme is assigned and press the “Edit Day Prg.” button. It will automatically be switched to mode 1 and the according day programme will automatically be selected.

14.4.5 Assign Day Programme – Options description The number of special days available can be defined and the

list of assignments can be printed out via the assignment options. The corresponding dialogue box is displayed by the “Set Options” button.

settings Here the number of special days available (1 up to 128) can

be entered. Take over the new setting by the “Take” button.

print After the “Print” button has been pressed, the current list of

assignments is being printed via the standard printer.

Visualisation


14.4.6 Order description The corresponding dialogue box is displayed by pressing the

“Order” button. Here the basic evaluation logic of the time manager can be defined.

priorities In general jobs of special days have a higher priority than

jobs of week days, and these have a higher priority than jobs of the “every day” section. The time manager is preset in a way that always only the jobs of one sort of day are executed: If there is a day programme of a special day, it will be executed, if not, the programme of a week day – if there is one – will be executed, and if there is none, the programme from the every day section will be executed.

For instance, if there is a day programme “A” which is assigned to Wednesday and a day programme “B” which is assigned to every day, the “A” programme has higher priority. Therefore “B” will not be executed on Wednesdays. However, if in “A” there are only a few jobs to be executed in addition to the normal daily programme “B”, the setting “Week day + handle daily jobs additionally” is to be selected. Now the jobs of both day programmes will be executed.

Visualisation


In this way you can mix day programmes, if this should be required. It may, however, become confusing if inadequately programmed. In every case you should use mode 3 (“Display”) to check a certain number of days, if you enable mixing.

Jobs of week variables If time jobs of week variables are to be suppressed (see

chapter 14.6), this can be defined in the “Order” dialogue box. Otherwise these jobs are mixed with the jobs of the day programmes.

Jobs of the old time manager If day programmes were defined before using the old time

manager, they are still valid and will be executed as long as the new time manager described here is not be started. After the new time manager is started for the first time, these old day programmes will be switched off. These programmes can then be imported in mode 1 and integrated into the new time manager. However, it is possible to select “Handle only jobs from old calendar time manager”, if you want to continue using the old definitions for some time until the change to the new time manager is completed. All new definitions and settings will be ignored for this time, the new definitions and settings will take place after the old jobs have been switched off again.

Visualisation


14.5 Display description With mode 3 “Display” it is possible to check in detail for

every day of the year, at which time jobs are to be executed. It can also be seen from which day programmes and assignments these jobs are coming from.

operation The display consists of three sections: in the upper half of

the screen there is a calendar which is used to select the desired day. In the lower half of the screen there is a detailed list containing the jobs to be executed on the selected day. If a time job is selected by the mouse, the status line at the bottom of the screen displays the day programme and the assignment the job is coming from.

Visualisation


14.5.1 Editing Corresponding Day Programmes description If an assigned day programme is to be edited, you can

switch to mode 1 by pressing the graphic button, select the appropriate day programme and edit it. However, as a shortcut you can select the corresponding day to which the day programme is assigned and press the “Edit Day Prg.” button. It will automatically be switched to mode 1 and the according day programme will automatically be selected. If the job is coming from a week variable, it will automatically be switched to mode 4 “Parameterise week variable”.

14.5.2 Order description Via the “Order” button the according dialogue box will be

displayed. Here the general evaluation logic of the time programmes can be set. For the description of the dialogue box see chapter 14.4.6.

14.5.3 Display–Options description Via the display options, the setting for the help for using the

graphic buttons can be changed and the assignment of jobs to a date or time period can be printed. The corresponding dialogue box is displayed by pressing the “Display Options” button.

Visualisation


settings for toolbar As a programme feature you may display a short help text

(tool tip) for each of the graphic buttons. According to your requirements It can be displayed if the mouse cursor touches the button or by pressing the right mouse button. This help can also be disabled. The new settings are taken over by the “Take” button.

print Here the range of date can be entered which is to be printed

out. If only a certain date is to be printed, the same date is to be entered as start date and end date When the “Print” button is pressed, the according lists containing the time jobs will be printed out via the standard printer.

Visualisation


14.6 Parameterisation of Week Variable description In mode 4 (“Week variable”) it is possible to enable process

items for the use in week variables. Currently only process items of the “Single state messages/commands” can be used for the week variable. In addition, here the settings for all week variables can be managed and checked without the need to open the according pictures containing the week variables.

operation The dialogue box for the parameterisation of the week

variable consists of two sections: in the upper half of the screen there is a list containing all process items available for week variables. The list can be modified via the “Add”, “Delete” and “Delete all” buttons.

Visualisation


When the “Add” button is pressed, a dialogue box containing all process items of the “Single state messages/commands” data type will appears. The desired process item can now be selected from the dialogue box and dragged into the list by keeping the mouse button pressed. When the mouse button is released, the process item will be taken over into the list of process items for the week variable and will be evaluated by the time manager.

If a process item shall no longer be evaluated by the time manager, it is to be selected from the list and the “Delete” button is to be pressed. ATTENTION: all week variables containing this process item will automatically be switched off! By pressing the “Delete all” button, all process items for the week variable will be removed from the list.

Visualisation


In the lower half of the screen the setting of the week variable for a certain process item is displayed.

There are three time grids: 1 hour, 30 minutes and 15 minutes. The desired grid can be selected from the combo box. You can select one of two evaluation modes: “Job on changing values” generates jobs only if the value changes in the corresponding day. “Job every time” generates a command for each of the time grids set (e.g. for every hour). The value settings of the variable can be changed as described in chapter 7. After all settings have been made, the “Save” button in the variable is to be pressed. If this is omitted, the programme asks whether the changes are to be stored or not when the process item is changed or the dialogue box is closed.

The jobs of the week variables are only evaluated, if the corresponding item in the “Order” dialogue box is activated. In mode 3 (“Display”) also the jobs of the week variables are displayed. Generally, a process item of a week variable generates a command at the beginning of a day (at 0:01), in order to start each day with the value set.

Visualisation


14.7 Exiting the Time Manager description After all settings in the time manager have been made and

the documentation has been printed out, the project planning with the time manager is terminated.

close All the data entered will be saved and the time manager will

be exited by pressing the “Close” button. You have returned to the project menu of the Visualisation. The jobs you have defined are now being performed in the background at the configured times.

14.8 Deactivating the Time Manager deactivation It may be useful for diagnostic reasons to deactivate the

time manager for a certain period of time:

Call the “Systemconfig.” programme: the time manager can be disabled with the setting “No” of the “time manager” subtopic from the “Extensions” topic for a certain project. The setting “Yes” will enable the time manager again. Note: The activation of the time manager is only possible, if this option has been released via the according option disk.

Visualisation


14.9 How to Follow up Jobs description If the PC is started for the first time or restarted after a

power failure, the time manager will synchronise itself automatically to the current time. For this purpose all the jobs of the current day starting at midnight are checked whether they have already been performed or not, and therefore have an according marking. If jobs are found which have not yet been performed, these jobs are stored in a buffer.

calling the jobs to be followed-up Now these jobs can be called via the “Clock” symbol button

in the lower right corner of the screen:

When this button is operated, the “Run time jobs” window will be displayed. Here all jobs are listed which have not been performed on this day, because they should have been performed before the computer was switched on.

Visualisation


cancel / follow-up jobs You can now decide whether these jobs are to be cancelled

or followed up:

1.) Mark the relevant job. 2.) If the job is to be followed up, press the “Start”

button ? the job will be performed. If the job is not to be followed up, i.e. is to be cancelled, press the “Remove” button ? the job will be cancelled.

3.) Repeat items 1.) up to 3.), until all jobs are removed from the list.

The dialogue box is closed via the “Close” button.

notes The time manager uses the internal PC system clock as a

basis for the processing of the time jobs! set system clock This means that the summer or winter time has to be

adjusted manually. In order not to forget this procedure it is useful to display a text containing the according request for the operator the day before or the day of the time shift.

attention Please check whether date and time of the PC are set

correctly. Adjust it, if necessary! type of processor The time manager requires a PC with an INTEL 486 or later

processor type. In a hardware configuration with a 386 processor the Visualisation may be run, but not the time manager!

Visualisation


15 The “Value Recorder” Option

description The “value recorder” option is a replacement for a dotted-line recording instrument. It provides the possibility to cyclically record states (e.g. installation on or off, window open or closed) and values (e.g. temperature, brightness, consumption) and to store recorded data on hard disk.

evaluation The data stored on the hard disk can be displayed on the

screen as diagrams (lines, bars, two-dimensional, three-dimensional), and the current picture can be printed out as a hardcopy. In the value recorder up to 32 groups can be defined:

groups / tracks Group 1 can have up to 8 tracks (i.e. cyclically recorded

process items) with a minimum cycle time of 15 seconds. ?? Group 2 can have up to 16 tracks with a minimum cycle

time of 30 seconds. ?? Groups 3 up to 32 can have up to 64 tracks with a

minimum cycle time of 1 minute. cycle time Depending on the group, the cycle time can be selected as

15s, 30s, 1min, 5min, 15min, 30 min, 1h, 3h, 6h, 12h, 24h. The preselected time is valid for all tracks of the according group.

record length The record length can be selected from 50, 100, 150, 250,

500, 1000, 2000, 5000, 10000 entries per track for all tracks of the according group.

Visualisation


storage The storage per group is organised as a ring buffer for max.

10,000 entries per track. If the buffer is full, the oldest data will be overwritten by the new data. Thus each of the groups 3 up to 32 may occupy 6.5 MB on the hard disk. As the record length per group can be preset in the range from 50 up to 10,000 entries per track, the amount of storage required by the value recorder may be reduced. If a new group is defined (“New”), the required amount of storage will immediately be reserved on the hard disk. If there is insufficient hard disk storage, an error message will be generated.

group Each group can be stored and addressed under a certain

name (identifier). Each group can be parameterised before and then be set to active mode or can remain inactive.

track Each track of a group can be assigned to a name (identifier),

and each track can be set to active or passive mode. If an active group is selected for parameterisation, the cyclic recording for this group will immediately be stopped. Before the dialogue is exited, this group must first be switched to the active mode again by pressing the “OK” button.

interrupts If cyclic recording of data has been interrupted for one or for

all groups (e.g. by a dialogue for parameterisation, power failure, PC switched off, etc.) there will be gaps in the recording which are also displayed as gaps in the diagrams.

EXCEL V A stored group can also be completely exported to EXCEL V

and can be processed and displayed there.

Visualisation


15.1 Structure call The main window of the value recorder is called from the

project menu (no picture open) by the “Add-Ons”? “value recorder” menu item.

menu bar The different functions are called via the menu bar in the

lower part of the screen. settings To parameterise the desired groups. display To select the group to be displayed. options To print the recorded data or to convert data to the EXCEL

format. close To close the value recorder window.

Visualisation


15.2 Creating New Groups description Via the “Settings” button the “Recording Settings” dialogue

box is displayed in which a group is assigned to a name the record length and cycle time may be selected and groups can be set to active or inactive.

In a table all group numbers are displayed (1 up to 32) and if there are groups already parameterised, the following information is also displayed: ?? group name ?? record length ?? cycle time ?? tracks total/used ?? active/inactive

procedure 1.) Mark the number of the group you want to use

2.) Enter a name for the group describing the information to

be displayed (max. 12 characters). 3.) Select the record length for the group (50, 100, 150, 250,

500, 1000, 2000, 5000 or 10000 items)

Visualisation


4.) Select the desired cycle time for the recording of the

new group: in group 1 : 15s, 30s, 1min, 5min, 15min,

30min, 1h, 3h, 6h, 12h or 24h in group 2 : 30s, 1min, 5min, 15min,

30min, 1h, 3h, 6h, 12h or 24h in groups 3 up to 32: 1min, 5min, 15min, 30min, 1h,

3h, 6h, 12h or 24h 5.) If the new group is to be active, i.e. data is to be

recorded after the setting has been terminated, “Active” is to be marked.

6.) The new group is drawn up under the marked number by

pressing the “new” button.

15.3 Editing Existing Groups description If e.g. the record length or the cycle time of an existing

group is to be changed, perform the following steps:

procedure 1.) In the “Recording Settings” dialogue box mark the group

to be corrected by double-clicking ? the data configured is displayed.

2.) Correct the settings of the group. 3.) The new settings are assigned to the marked group by

pressing the “change” button.

Visualisation


15.4 Deleting Existing Groups description To delete a complete group of the current project, perform

the following steps:

procedure 1.) In the “Recording Settings” dialogue box mark the group

to be corrected by double-clicking 2.) The marked group including its assigned tracks is deleted

and removed from the group overview window by pressing the “delete” button.

Note: The “delete” function cannot be undone.

15.5 Exporting Existing Group/Importing Groups If a group is marked in the “Recording Settings” dialogue box, the “export” button is offered (see figure above). If recorded data are available for this group, the according file can be exported. If an empty group entry is marked, the “import” button is offered. Thus recorded files from other projects can be imported.

Visualisation


15.6 Defining Tracks description Now for all groups the tracks to be recorded are to be

defined: max. number in group 1 : 8 tracks max. number in group 2 : 16 tracks max. number in groups 3 to 32: 64 tracks Each track is assigned to a process item whose status is to be recorded.

All tracks of the current group are displayed in a table.

procedure 1.) Mark the group in which you want to define tracks.

2.) Press the “edit” button ? the “Track parameters”

window will be called. 3.) Mark the desired track number. 4.) Enter a name for the track describing the information to

be recorded (max. 12 characters). 5.) In the list of process items mark the one whose status

you want to record with this track.

Visualisation


6.) If the track is to be active, i.e. cyclically recorded in the

current group, mark “Active”. 7.) The settings are taken over into the marked track by

pressing the “set” button. 8.) Repeat steps 3.) to 7.) until all tracks of this group have

been defined. 9.) The defined tracks are assigned to the current group by

pressing the “OK” button, and the menu is exited.

15.7 Correcting Existing Tracks description If another process item is to be assigned to an existing

group, perform the following steps:

procedure 1.) Mark the track to be changed by double-clicking on it ?

the current settings of the marked track are displayed. 2.) Make the new settings for this track. 3.) The new settings are assigned to the marked track by

pressing the “set” button. 4.) The tracks changed are assigned to the current group by

pressing the “OK” button.

Visualisation


15.8 Deleting Existing Tracks description If individual tracks or all tracks of a group are to be deleted,

perform the following steps: procedure 1.) Mark the group tracks which are to be deleted by double-

clicking on them in the “Recording Settings” menu. 2.) Press the “edit...” button ? the “Track parameters”

menu will be displayed.

3.) Now mark the track which is to be deleted. 4.) The marked track will be deleted and be removed from

the list by pressing the “delete” button. With the “delete all” button, all the existing tracks of the

current group are deleted, irrespective of the track marked.

Note: The “delete” and “delete all” functions are irrevocable, i.e. the deletion of one or all tracks cannot be undone.

Visualisation


15.9 Parameterise Display description The “Display Group” dialogue box for the parameterisation

of the display is opened via “Display”.

settings The following settings can be defined:

?? colour the axes and the background shall have, ?? into how many sections the y axis is to be subdivided, ?? which group and which tracks of this group are to be

displayed, ?? the range of values which is to be represented for the

individual tracks, ?? how the recorded data is to be represented on the

screen.

Visualisation


select group In the upper part of the dialogue box all defined groups are

listed (see “Create New Group”).

Mark the desired group. Now the number of measuring points to be displayed simultaneously can be changed via “Display max.”.

parameterise display of tracks Select the desired track of the current group under “Track”.

Select the colour in which the selected track is to be displayed.

Now the range of values which is to be represented must be defined for the selected track:

entry of the minimum value of the track (= 0% in the diagram) entry of the maximum value of the track (=100% in the diagram)

This procedure is to be repeated for all tracks of the current group. If a track is not to be displayed, deactivate it via “Display track”.

Visualisation


15.10 Type of Display description For the graphic representation of the recorded measuring

points you can choose from eight different types of display. Displaying the data as a table is also possible.

line diagram Display as a line diagram:

line diagram (filled) Display as a line diagram (filled) :

Visualisation


area diagram Display as an area diagram:

area diagram (filled) Display as an area diagram (filled):

Visualisation


bar diagram Display as a bar diagram:

bar diagram (overlapping) Display as a bar diagram (overlapping):

Visualisation


stack diagram Display as a stack diagram:

stack diagram (overlapping) Display as a stackdiagram (overlapping):

Visualisation


table Display as a table:

selection Select the desired type of display by marking the respective

item.

Note: Some types of display (areas, stacks) need some time building up if there are a lot of data. Therefore it is often useful to reduce the value in “Display max. : ...... values at a time”. Moreover it is possible to the building up of a picture by using the “ESC” button. Then there will be a change to the fastest type of display.

Visualisation


colour of axes, background Change display of axes

In this dialogue the colour of the diagram (i.e. colour of axes) and the background colour of the diagram can be selected.

scaling of axes Additionally the grid for the scaling of the Y axis can be

switched off via the “Show Y axis lines” function: Without Y axis lines:

Visualisation


With Y axis lines:

15.11 Saving/Loading Display Parameters description You have the possibility to save or load display parameters

under a name. Thus they can be recalled at any moment, and the individual parameters must not be entered anew. For this purpose there are the “Save” and “Load” buttons in the “Group Display” dialogue box:

Visualisation


save display parameters 1.) Set the display parameters according to your needs in

the “Group Display” dialogue box (see “Parameterise Display” section).

2.) Press the “Save” button” ? the “Save Settings” dialogue box will be displayed:

In this dialogue box all display parameters already saved are listed.

3.) Select an existing configuration via double-clicking (this configuration will then be overwritten) or enter a new name (max. 16 characters).

4.) Press the “Save” button ? the current display parameters will be saved under the name entered.

load display parameters With this function display settings already saved can be

recalled:

1.) Press the “Load” button” in the “Display Group” dialogue box ? the “Load Settings” dialogue box will be displayed”:

Visualisation


2.) Select the desired setting by double-clicking on it.

3.) Press the “Load” button to transfer the settings saved before into the “Display Group” dialogue box.

delete display parameters Display settings which have been saved but are no longer

needed can be selected via this function:

1.) Display the “Save Settings” or “Load Settings” dialogue box via the “Save” or “Load” buttons.

2.) Mark the display parameter item to be deleted.

3.) The “Delete” button deletes the marked display parameters.

default This function turns an already stored setting into the default

setting. This default setting will be loaded automatically when the programme is started. When the “Default” button in the “Display Group” dialogue is pressed, the following dialogue box will be displayed:

Selecting a setting from the combo box and confirming it with “OK” will turn the setting selected into the default setting.

Visualisation


15.12 Displaying of Data display of data If in the “Display Group” dialogue box the display settings

have been entered or the desired display settings have been loaded via “Load”. Pressing the “OK” button will display the diagram or the table on the screen:

When graphic representation has been selected, a table containing the represented tracks is additionally displayed in the lower part of the screen. The values displayed in this table correspond to the current position of the ruler line in the diagram.

Ruler line description In the diagram displayed a ruler line can be moved to areas

of special interest. The table below the diagram displays the values of the tracks where they are intersected by the ruler line.

Visualisation


move measuring cursor The measuring cursor can be moved via the mouse (click on

the desired position), via the keyboard (arrow left or arrow right) or via buttons (see above, in the upper right corner of the screen):

The representation of the values in the table can be switched from brief information to detailed representation:

detailed representation

brief information

If more tracks exist than can be displayed in the table, these two buttons serve for paging up or down.

Visualisation


shift diagram along time axis

If more data exist than can be displayed (the value in “Display max. ...” is smaller than “Record length” in the “Group Display” dialogue, or it has been zoomed manually), the display can be shifted to the left or to the right with the help of these two buttons.

With each pressing it is shifted to the according direction by one value.

If the button is pressed for a longer time, the number of values shifted by is doubled after each shifting.

Enlarging Graphics Display (Zooming) description In order to enlarge interesting details of the recording, it is

useful to stretch the time axis, i.e. display only a special period of time on the whole screen.

For this purpose there are the following possibilities: via parameters a.) Via the setting “Display max.: ... values at a time”:

In the “Display Group” dialogue box the defined “Record length” of this group is displayed. Next to it there is an entry field where the number of values which are to be displayed in the diagram simultaneously can be put in. If this value is smaller than the record length, only the defined number of values is displayed starting with the first value available.

via manual zooming b.) Via manual zooming:

Here a range of the time axis can be marked which is to be displayed across the total size of the diagram.

Visualisation


1.) Mark the desired range on the time axis with the mouse

by pressing the mouse button and dragging while keeping the mouse button pressed.

2.) Now press the button. The marked range will be displayed enlarged across the total display range of the diagram. The range displayed can be shifted to the left or

to the right with the help of the and buttons.

The representation above will be displayed as shown below after the “Zooming” button has been pressed:

Visualisation


The manual zooming procedure can now be repeated as often as you want to find out the perfect representation for the desired data step by step.

display all data By pressing the button, all data will be displayed again (no zooming).

Updating Display update display If the display is to be updated, e.g. because new values

have been recorded, you can build up the display anew by

pressing the button.

Representation as Text If the “Text” representation has been selected you can choose from two formats:

detailed

representation a) Detailed representation:

The individual tracks are displayed below each other with their values at the according times of recording. Additionally the minimum and maximum values which have been set before are displayed.

Visualisation


If the button is pressed, the minimum and maximum values are no longer displayed:

By using the button you can switch back to the original display.

brief information b) Brief information:

The tracks are displayed in columns next to each other for the according times of recording. Only the current values of the tracks are displayed.

If not all group tracks can be displayed on the screen simultaneously, the display of the tracks can be shifted

to the left or to the right by using the and

buttons. As the number of measuring points which can be displayed on the screen simultaneously is limited, you may have to

page up or page down with the help of the and buttons.

Visualisation


change display type If you want to switch between different types of display

(lines, bars, text etc.), this can be done without the “Display Group” dialogue via the number keys on the keyboard. During display of the data the keys have the following functions:

„1” lines „5” bars „2” lines (filled) „6” bars (overlapping) „3” areas „7” stack „4” areas (filled) „8” stack (overlapping) „9” text

Visualisation


15.13 Exporting Data in EXCEL V Format description There are a lot of possibilities for the graphic evaluation of

data recorded by “value recorder”. Additionally the programme has the feature of converting recorded data into EXCEL V format. Thus the converted data can be further processed by EXCEL.

procedure 1.) The options dialogue box is called via the “Options” menu

item:

2.) Enter the desired file name under which the current display is to be saved.

3.) Start the exporting procedure with the “Export” button.

Visualisation


15.14 Printing Recorded Data description The programme offers two possibilities to print out recorded

data: ?? as a hardcopy of the screen ?? as a textual listing

procedure Open the options dialogue with the “Options” menu item.

Mark the desired type of printout under “Print data”:

for a hardcopy of the screen ? Graphic display

for a textual listing ? Text The printout procedure is started via the “Print” button.

15.15 Settings for Tool Bar description As a programme feature you may display a short help text

(tool tip) for each of the graphic buttons. According to your requirements, it can be displayed if the mouse cursor touches the button or by pressing the right mouse button. This help can also be disabled.

procedure Open the “Options” dialogue box by pressing the

“Options” button. Check the desired mode under “Settings for tool bar”. The “Take” button saves the new setting.

15.16 Closing Value Recorder close value recorder The “value recorder” programme window is closed via the

“Close” button in the menu bar at the bottom of the screen.

You will be in the project menu of the Visualisation again.

Note: The parameterised tracks are still recorded after the “value recorder” window has been closed.

Visualisation


16 The “Event Monitoring” Option

16.1 Features description With event monitoring you can log all the events configured

in the Visualisation. evaluation The data monitored can be displayed as a textual list on the

screen of the PC. Events which have been acknowledged and those which have not been acknowledged yet are displayed separately. For statistical evaluation individual data (up to 16 groups) can be represented by a bar chart corresponding to the frequency of their occurrence. Events which have not been acknowledged can be acknowledged. The moment of acknowledgement is also logged. Selected events can be archived in their own data base on disk, e.g. a data base for the events of the year 1993, a data base for 1994, etc.

EXCEL V Recorded data can also be exported completely to EXCEL V

where they can be evaluated and displayed.

Visualisation


16.2 Displaying and Processing Events call In the project menu (no picture open) the main window is

displayed by the “Add-Ons”? “Event monitoring” menu item.

display of all events In the upper part of the screen all events logged are

displayed including date and time, a message text and a note as to when a message to be acknowledged was actually acknowledged. The flags of an event provide the following additional pieces of information: B=beeper-flag; Q=quit-flag; C=come-flag; G=go-flag

display of all messages still not acknowledged In the lower part of the screen all events are displayed

which have the entry “Acknowledge: yes” in their related data type and have not been acknowledged yet.

Visualisation


When clicking on one of these messages, the following window will be displayed:

All data of the marked event are displayed.

acknowledging one event If only the selected event is to be acknowledged, mark the

“Ack. chosen event” option, check the acknowledging text and acknowledge the selected event with the “OK” button. This event will now be removed from the lower table and will be added to the upper table with the remark “Acknowledged”.

acknowledging all events If all available events which have not been acknowledged

yet are to be acknowledged together, mark the “Ack. all events” option, check the acknowledging text and acknowledge all events together with the “OK” button. The events will now be removed from the lower table and will be added to the upper table with the remark “Acknowledged”.

Visualisation


16.3 Storing Events in a Data Base store events If you want to store a part of the current display in a data

base, e.g. all events of the year 1994, proceed as follows: Mark the most recent event to be archived in the display of all current events.

Now the following icon is displayed in the upper right part of the screen:

Using this icon, the marked events can be stored under any name. If clicked on, the following window will be displayed:

Visualisation


store events

Enter the desired data base name under which the selected data is to be saved in the “File name” entry field.

You can enter a commentary text for this data base into the “Comment” entry field.

In the “Info” field date and time of the first and the last event selected is displayed.

By pressing the “OK” button the selected events are stored under the name entered (the extension “.EVT” will be added to the file name and it will be stored in the project subdirectory of c:\visualis).

Note: Storing the selected events in a new data base takes some time. Events which have been stored are automatically removed from the current data base.

Storing of events is urgently required if the icon is displayed in the upper left corner of the screen. In this case the display buffer is flowing over, i.e. the current data base contains more than 8192 events. Thus only the “oldest” 8192 events are displayed. Storing a part of the events results in new space in the display buffer.

Visualisation


16.4 Deleting Events from the Current Data Base delete events If events are to be deleted from the current display proceed

as follows: In the display of all events mark the one which is to be deleted. In the upper right part of the screen the following icon is displayed:

Using this icon, the marked events can be deleted from the current display. If clicked on, the following window will be displayed:

Date and time of the first and the last event marked are displayed in the “Info” field. By pressing the “OK” button all marked events are deleted from the current display.

Visualisation


16.5 Selecting of the Desired Data Base select data base Whenever “Event monitoring” is called the <current> data

base will be loaded. In this data base the current events are displayed. If, however, an older data base which has already been stored is to be displayed (e.g. events of the year 1994), proceed as follows: Select the “Settings” button from the menu bar at the bottom of the screen.

The following window will be displayed:

Here you can select which data base is to be loaded. Current Event Messages: The current event messages are displayed. Saved Event Messages: A data base already stored can be displayed. If the “Saved event messages” option is marked, the “Choose Event File” button will be released.

Visualisation


select data base If the “Choose Event File” button is pressed, the following

window will appear:

Here the data base to be loaded can be selected. By pressing “OK” the selection is taken over and displayed in the “Settings” dialogue box. Pressing “OK” in the “settings” dialogue box loads and displays the data base.

load current events If you want to reload the current event data base, select the

“Current event messages” item of the “Settings” dialogue box and load it by pressing “OK”.

Visualisation


16.6 Defining Display Filters description If only certain events are to be displayed you have the

possibility to define priority filters, time filters and/or process item filters To do this, select the “Display” button from the menu bar at the bottom of the screen.

The following “Event messages display” window will be displayed:

The “Choose filter” window is called by pressing the “Global filter” button:

Visualisation


Define filters

Mark the “Use filter” selection.

Now you can select from the following filter types:

Priority filter:

priority filter Definition of the priority level from which on or up to which the events are to be displayed.

Time filter:

time filter Definition of date and time from which on or up to which events are to be displayed.

Process item filter:

process item filter In selection mask entry field the name of a process item or

the first character(s) of a process item whose events are to be displayed can be entered. The asterisk (*) is a wildcard, e.g. “L1*”: all the events of the process items starting with “L1.....” are displayed.

activate filters The individual filters are activated by marking the box next to the appropriate filter.

deactivate filters If filters are not to be used any longer, mark the “No filter” selection.

The settings are taken over by “OK”, and pressing “OK” in the “Event messages display” updates the display.

Visualisation


16.7 Graphical Analysis of the Event Data Base description For the statistical evaluation of certain events of the event

data base you can display the rate of occurrence of these events as a bar chart. Up to 16 ranges can be defined. The events assigned to each range can be selected by detail filters. These detail filters include the priority filter and the process item filter. Definition of the individual ranges:

define ranges By clicking on the “Display” button of the menu bar at the

bottom of the screen

the “Event messages display” window will be displayed:

Visualisation


In the “Graphical display” section of the window the desired number of ranges (1 up to 16) can be defined under “No. of ranges”. Now it has to be defined which information is to be displayed in the individual ranges.

detail filters Select the desired range under “Detail filter for range:” and

enter the desired detail filters:

Start priority: Enter the minimum priority level from which on events are to be displayed in the selected range.

to priority: Enter the maximum priority level up to which events are to be displayed in the selected range.

Process item mask: Enter the process item name or the first character(s) of the process item name from which events are to be displayed in the selected range. Here the asterisk (*) is used as wildcard, e.g. “L2*”: All events of process items whose names start with “L2...”. Helpful: the button “process items” which provides the dialogue for the selection of process items.

The data entered is taken over via the “OK” button, and the configuration of the graphical display is finished. Note: Of course, possibly defined and active “Global filters” are also valid for the graphical display (see “Define Display Filters”). Switch over to the “Graphical Display”:

graphical display In the upper right corner of the screen the following icon can be found:

By clicking on this icon the data base currently loaded is displayed as a bar chart using the detail filters entered:

Visualisation


bar chart Each bar represents a range. The height of the bar indicates

the rate of occurrence of the events of this range. The diagram is automatically scaled according to the maximum rate.

table Below the bar chart a table is displayed containing all the

settings of the detail filters of the defined ranges and the rate of occurrence of the events. Now the following icon is displayed in the upper right corner of the screen:

switch over to text display If you click on this icon, it will switch back to the normal

textual display of the events.

Visualisation


16.8 Parameterise Display description The individual colours of the screen display can be selected

according to your wishes. This is valid for both the textual display and the graphical display of the events. The “Event messages display” window is called by pressing the “Display” button:

select colours In the “Colours” section of the window all picture elements

and areas are listed whose colours can be changed. Mark the according selection for the area of the picture and select the colour via the colour selection menu.

You can also select the order of listing of the events.

Visualisation


set display order In the “Events” section of the window you may select:

Chronologically: The events are displayed in the order of their occurrence.

Come - Go assignment: If events have been parameterised as “Come / Go” messages in data type definition, the “Come” message and the “Go” message are always displayed immediately following each other, even if other events occur between the two messages.

save settings on exit If this box is activated, the selected colour and detail filter

settings are used immediately after the event monitoring has been started the next time. However, global filters will be reset.

“OK” takes over the settings and the display will be updated.

16.9 Exporting Data into EXCEL V Format description If the contents of the event data base is to be further

processed with the EXCEL programme, you can export the current data base as an EXCEL file.

generate EXCEL file By clicking on the “Options” button of the menu bar at the

bottom of the screen

the “Options” window will be displayed:

Visualisation


The file name of the EXCEL file to be generated is to be entered into the “File name” entry field at the lower part of the window. The “Export” button starts the exporting procedure. The file with the file name entered is stored in the current path. If the file is to be exported into a certain subdirectory, the complete path is to be entered, e.g. c:\excel5\excel.txt

Close By pressing the “Close” button, the “Options” window will

be closed. Note: Whenever an EXCEL file is generated, the complete contents of the currently loaded data base will be taken.

16.10 Printing the Event Data Base description If the contents of the event data base is to be documented,

you have the possibility to print out the complete data base or a part of it. By clicking on the “Options” button of the menu bar at the bottom of the screen

the “Options” window will be displayed:

Visualisation


select type of data In the upper part of the window you can select which data

of the currently loaded data base is to be printed: Current display:

the current content of the screen is printed as a hardcopy.

Acknowledged event messages:

all events which are not to be acknowledged and all events which have already been acknowledged are printed out in form of a text list (= upper table on the screen).

Not acknowledged event messages:

all events which have been defined as “to be acknow-ledged” are printed out as a text list (= lower table on the screen).

print Pressing the “Print” button starts the printing process. Close By pressing the “Close” button, the “Options” window will

be closed.

16.11 Exporting/Importing/Deleting Event Files description In order to backup e.g. already stored data bases (see

“Store Events in a Data Base”) on a disk or to evaluate the data on another PC you have the possibility to export existing data bases to disk or import data bases from disk. Select the “Settings” button of the menu bar at the bottom of the screen.

The following window will be displayed:

Visualisation


The “Data import/export” functions can be found in the lower part of the window. Note: Importing/exporting event data takes some time.

export data If the “Export event file” button is pressed, the “Export

event file” window is displayed in which the following steps can be performed:

Visualisation


event files Under “Event files” all existing event files are listed. The

data to be exported is defined by marking the desired file.

export directory Under “Export directory” it is selected to which drive and

path the data is to be exported. compress If “Compress” is selected, the data are exported in a

compressed form. This setting is recommended when you export to disk.

execute “Execute” starts the exporting procedure. delete Pressing “Delete” deletes the marked event file. close The window is closed by clicking on the “Close” button. import data If the “Import event file” button is pressed, a window will

be displayed in which the data base to be imported can be selected:

Visualisation


Import directory Under “Import directory” you can select the drive and path

where the event file is located. event files Under “Event files” all event files of the selected directory

and path are listed. execute “Execute” starts the importing procedure. close The “Import event files” window is closed by clicking on the

“Close” button.

16.12 Settings for Tool Bar description As a programme feature you may display a short help text

(tool tip) for each of the graphic buttons. According to your requirements It can be displayed if the mouse cursor touches the button or by pressing the right mouse button. This help can also be disabled.

procedure Open the “Options” dialogue box by pressing the

“Options” button. Check the desired mode under “Settings for tool bar”. The “Take” button saves the new setting.

16.13 Closing Event Monitoring close event monitoring The “Event monitoring” window is closed by pressing

“Close” in the menu bar at the bottom of the screen.

You are back in the project menu of the Visualisation. Note: The recording of events in the event data base is continued after the “Event monitoring” window has been closed.

Visualisation The “Network” Option


17 The “Network” Option

17.1 Introduction description The network interface of the Siemens Visualisation instabus

EIB is based on the network protocol TCP/IP. This widely used network protocol is available on the operating systems of Microsoft Windows 3.11, Microsoft Windows 95 and Microsoft Windows NT. Based on this network protocol the NU–Interface (NUI = Network Unlimited Interface ) has been integrated.

Before starting the visualisation system, you should check whether the TCP/IP network protocol is installed on your computer. If necessary, ask your network administrator for help. Furthermore, you should have the following data at hand: The IP-address of the PC which you want to configure (symbolic name or network address) IP-addresses of further visualisation servers (if avail-able) Ask your network administrator about these values, if necessary.

The “Network” Option Visualisation


17.2 TCP/IP TCP/IP Each computer is identified by an identifiable IP-address in a

TCP/IP network. This address has to be unique in the world, if the network has access to the internet. Such addresses are distributed and registered by the Network Information Centre (or NIC) or by various other providers. If the network is not connected with the public internet, one is free to choose basically any address one wants to.

addressing An IP-address is the combination of aaa.bbb.ccc.ddd, with

aaa to ddd ranging from the value 0...255. Your address, for instance, could read 193.2.1.1. In addition, the number aaa has a special function: 1..127 type A-network 128..191 type B-network 192..254 type C-network The IP-address consists of two parts, the so-called network address and the host address. In a type A-network the IP-address of the host 117.1.2.3 is divided into the network address 117 and the host address 1.2.3. So 127 networks, each connected with 16.7 million computers, can be installed with a type A-network. This configuration is only used by network organisations. In a type B-network the IP-address of the host 130.67.62.1 is divided into the network address 130.67 and the host address 62.1. So 65535 networks, each connected with 65535 computers, can be installed with a type B-network. This configuration is mostly used by large enterprises with widely scattered PCs.



In a type C-network, the IP-address of the host 193.2.1.1 is divided into the network address 193.2.1 and the host address 1. So 16.7 million networks, each connected with 253 computers, can be installed with a type C-network. This configuration is mostly used by providers of small and medium-sized firms. About particularities with net masks ask your network administrator. Computers with which you intend to communicate either have to have the same network address or you need a so-called router (Default gateway), which serves as a link between the separate networks. By using the PING help programme, you are able to check whether you can communicate from your computer to another one. Syntax: PING address, e.g.: PING 193.2.1.1 Since IP-addresses are difficult to memorise, symbolic names are generally distributed for each computer in the network. If your network has a DNS, the symbolic name and the IP-address which belong to it are deposited in a kind of table there. If a programme uses this symbolic name, it will first inquire the DNS and then receive an IP–address. The DNS, if available, has to be mentioned while the network is being configured.



With very small networks where a DNS is not profitable another method is often used. In this case, a file with the name HOST will be installed in each computer. In this file the symbolic name will be recorded along with each IP-address. If one address is changed in the network, all HOST-files have to be changed on all computers, too. The BOOTP and / or the DHCP can be used as a third method. Here, the computer will ask a network server for its IP-address by using one of the above-mentioned protocols. This IP-address will be taken either from a fixed (static) list or will be dynamically distributed from a pool with free and available addresses. Using the HOST-file will no longer be possible then. The network driver supports both the addressing via IP addresses as well as via symbolic names. The encoding of the name can be achieved with any of the above-mentioned methods.

ports Since it is possible for more than one network application to run on a computer, the incoming packages have to be sorted and allocated to the corresponding applications. Each application “receives” or "sends" on one or several ports. Special programmes, such as FTP programmes or WWW browsers, for example, use standardised ports, which have been agreed on permanently for these kinds of programmes. The port numbers 1024 ... 2048 are freely available. The Siemens Visualisation instabus EIB uses the port 1121.



17.3 Requirements general You require a dongle with network release.

If you have not yet installed the TCP/IP-protocol on the relevant computers, do it now. Please, test with the PING programme whether or not a connection exists between the computers concerned. Note for Windows 3.11: If you are using the network of a plain "Windows for work groups" (WfW), you have to install the TCP Stack Microsoft TCP/IP-32 3.11b, which you can obtain from Microsoft only. If you are using a Novell network, you have to install the client/32 interface and the Novell TCP/IP. Note for Windows 95: About the control panel - Click the network icon - select the protocol record card, - choose "add" in it, - choose Microsoft, - and in it TCP/IP. If necessary, ask your network administrator for advice on questions regarding the parameterisation.



17.4 Installation of the Server preparation Install the Siemens Visualisation instabus EIB with the

accompanying floppy disks on your computer. Plug the enclosed dongle into the parallel interface of your computer. Import, if necessary, an available project. Connect the computer with the instabus EIB.

configuration Open the project in question. Select the menu option

process items – process items...

Select the network functions in the following dialogue:



The following configuration dialogue appears:

In this dialogue window, the visualisation servers will be configured. The dialogue is subdivided into three sections: 1. Editing box with display name, unique server Id, primary

and, if need be, secondary IP-addresses, add and remove.

2. List of the entered visualisation servers.

3. Local parameters.



17.5 Editing Box display name Name which can be selected as a computer name for a

process item in the process item dialogue. unique server Id Number from 1..1024, which clearly identifies the

parameterised server. primary IP-address IP address or symbolic name of the server. secondary IP-address IP address or symbolic name of an emergency server in

case the primary one fails. Only possible with the option redundancy.

add Adds this parameterisation or changes an existing entry. remove Deletes the selected registration in the list of the registered

visualisation servers.

17.6 List of the Registered Visualisation Servers available visualisation servers Lists the currently projected visualisation servers.

The unique server Id is listed in square brackets. Next to it you will see the display name.



17.7 Local Parameter This computer is... This computer is a server, i.e. it is connected with the

instabus EIB and provides process items. Unique server Id or ... Unique server number of this computer. This number is

listed in the list of the visualisation servers.

17.8 Conclusion of the Parameterisation After entering all servers, leave the dialogue by clicking "OK" and set the driver back by using the option interface "Initialise Serial Interface".



17.9 Process Items In the dialogue process item definition, all local process items should be on "Local".

All entered servers will be listed in the list below the process item names (see 17.4). The process items of this computer are on "Local" because it functions as a server. If you export the project to another computer which has a different server number or none at all, the process items of this server will be loaded.



17.10 Installation of a Client Export the project of the server to this client. Start the dialogue network services and remove the cross in the option "This Computer is a Visualisation Server". After that, leave the dialogue by entering the key "OK" and set the printer driver back by clicking "Initialise Serial Interface" in the option field interface. In the dialogue process item definition, all process item names should refer to the server which provides the process items.



17.11 NU Tool introduction The visualisation instabus EIB with an NU interface uses in

part an altered data format compared with previous versions. To make the approach to NU technology as easy as possible, you can convert existing projects into the new format by using "NU Tool". NU Tool converts the process items into the new format and adapts scripts and image files, if necessary. To a large extent, all these steps happen automatically.

starting NU Tool Select the programme NU Tool from the start menu or the

programme group "Visualisation instabus" and start it with a double click.

note: The Siemens visualisation instabus EIB "must not be running" at that time.



The opening screen appears next.

On the left side there is a output data box which will draw your attention to errors or necessary conversions with plain type. Below you will find a progress display, which will show you the progress of your action. On the right side there are the command buttons which you can carry out commands with.

configure network See also chapter 17.12 ff. convert project Converting an old project. merge projects Merges projects from different "partial worlds". about Information on the system. close Closes the programme.



17.12 Network Configuration

First, you have to select the project you want to configure.

After clicking the button "OK", the following configuration dialogue appears.

In this dialogue box the visualisation servers will be configured. The dialogue is subdivided into three sections.



a) Editing box with display name, unique server Id., primary

and, if necessary, secondary IP address, add and remove.

b) List of the entered visualisation servers. c) Local parameter.

Editing Box

display name Name which can be selected as a computer name for a

process item in the process item dialogue. unique server Id. Number from 1..1024, which clearly identifies the

parameterised server. primary IP-address IP address or symbolic name of the server. Secondary IP-address IP address or symbolic name of an emergency server in

case the primary one fails. Only possible with the option redundancy.

add Adds this parameterisation or changes an existing entry. remove Deletes the selected registration in the list of the registered

visualisation servers.



List of the Registered Visualisation Servers

available visualisation server Lists the currently projected visualisation servers.

The "unique server number" is listed in square brackets. Next to it you will see the "Displayname". Local Parameter

This server is... This computer is a server, i.e. it is connected with the

instabus EIB and provides process items. unique server Id... Unique server Id or this computer. This number is listed in

the list of the visualisation servers.



17.13 Converting a Project The following dialogue appears:

On the left side, you have to choose the project that you want to convert. On the right side you choose the server you are on right now. If you have already registered servers at an entered point of time, as described in 17.4.1., they will appear in the list. You can also register a server "manually" by enter marking the option "Other" and entering the server number into the editing box. If you enter a server "other", you have to declare it later in 17.4.1.



If your project contains process items of several levels , the following readout appears once for each of the found worlds:

In this dialogue you relate a visualisation server to the present "world names". At this point, you do not have the option to interrupt the process. In the lower part, you decide on the server which provides the “world” shown above. If you have already entered servers at an earlier point, as described in 17.4.1., they will appear in the list. You can also register a server "manually" by putting a cross into the option "other" and entering the server number into the editing box. If you entered a server "manually", you have to declare it later in 17.4.1.

Visualisation Option „Counter/Consumption Statistics"


18 Option „Counter/Consumption Statistics"

18.1 Counter Variable description The counter variable is available in the EIB2 library.

It is able to visualise process items of the data type "User defined counters". With a sufficient high privilege level the user will be able to reset designated values of the process items for that purpose (on clicking the variable, a window will appear, in which the new values can be entered).

In order to do that, you mark the option for the value to be changed and enter the new value. By clicking "OK", the new values will be shown. "Cancel" will undo all possible changes.

Option „Counter/Consumption Statistics" Visualisation


18.2 Features In the properties for the variables you can set what they are to indicate:

For each field of the process item you can parameterise whether the relevant value should be shown. For each field of the process item you can parameterise whether the relevant value should be changed. For each field of the process item you can parameterise the differing text colours (according to their state). A general background colour can be defined.



In the option Extras the following functions can be activated:

blinking (alarm) Along with the alarm indication crossing the limit, the

variable will flash up. blinking (warning) Along with the warning indicating crossing the limit, the

variable will flash up. border A black outline will frame the variable. privilege The Privilege level determines whether the user can get into

the window for setting the values. In the menu you can, as it is possible with most variables, adjust the panel and the frame as well as the font. Units as well as conversions are taken over from the data item subtype. Changes in a data item subtype will be reflected in the variables that are connected with it.



18.3 Consumption Statistic Via the project menu add-ons (or the logic (switching) variable) you can access the additional function "Consumption statistic". On the one hand, it represents in a list (survey protocol) the current values of all process points of the data type "User defined counters" as well as 8,16 and 32 bit counters without signs. On the other hand, you can define in it which of the process items should go into the statistics, which you can call as well.

PI-Values (survey protocol) The survey protocol

After starting the consumption statistic, you get into the survey protocol <ACTUAL VALUES>. Here, all defined process item counters, their current values, the limiting values and the alarm are displayed.



With the scroll bar on the right side of the list you can move about in the list in case the screen cannot display all of it. On making a single "click" with the left button of the mouse on a process item in the list, a dialogue will appear in which you can change the values (see also changing values in the counter variable).

privilege The programme "system config." allows you to set the privilege level for changing counter values by the help of the consumption statistic. Every user who possesses a lesser privilege will not be able to change values in the IP-Values.

attention If you have problems with updating of e.g. counter values

from the counter device N 343, please refer to chapter 19.1 “EIBTOOL” and chapter 2.1 “Status Recording with the Visualisation” of this handbook, respectively.



18.4 Control Buttons general On the bottom of the screen there are four buttons

(Settings, Display, Options, Close), all of which serve for attaining the following functions:

management A window opens up in which you determine which of the

process items you generally want to select for the statistics.

In the upper part of the management window all known counting process items are listed ("available process items"). Those that you want to capture for the statistics should be marked with the mouse (multiple choice possible!). With the button "Add" the selected process items will be taken over to the list in the middle.



This means that all process items which you want to capture for statistical purposes are on this middle list. With the button "save" to the right of the list you can save this list; as of now, in a background process, these process items will be recorded cyclically. With the button "Remove", which is located above the list, you can remove process items from the list.

attention: If you remove process items from the list, all other values,

which have been recorded for these process items, will be removed from the protocol files as well.

Consequently, no statistical evaluation for these process items will be possible any more. However, all pieces of information on all the process items that remain in the list will be saved. In the lower part of the window you can now define further lists of process items ("Processitemlist") according to the procedure described above. These lists have to be given names (up to 8 digits, equals a DOS file name without a triple digit file extension) and serve as filters for the general statistical process items. This way you can define a list "switch" which contains only switching cycle counters, or a list "counter" with hours of operation counters, or various lists which equal the topology of the building (e.g.," first floor", "second floor", etc.).

save By clicking the button "Save" on the right side you can save

such a filtering list. delete By clicking the button "Delete" you can delete a chosen list.



display A window will appear in which the outline of the statistics

can be registered. In the upper part you can define various colours.

Below, there are four sections which define the display of the statistics:

day statistic Day statistic display: You have to select a process item filter

list indicating which process items are to be captured for the day statistic. Furthermore, you can select a range of time: for the day statistic a range from 0 to 24 hours is possible. If you want the optional totals to be indicated, you have to set whether a minute or hour control should be used. You can also set an additional unit.

week statistic Week statistic display: You can also select a process items

filter list, the control resolution, and a unit. You define the week with any date of day which must occur in this week.



month statistic Month statistic display: Here you enter the numbers for the

month and the year respectively. year statistic Year statistic display: Here you can enter the year and also

whether you want to make a statistic of the days of the year (day control) or of the month.

For each of the statistics you can set whether you wish to view the total of the process items which are in the list ("display sums"). This causes all process item values to be added up for the relevant statistic period so that, for example, also the consumption of a floor, etc., could be read off. This sum, as a matter of fact, only makes sense if all process items have the same base unit (calculating the switching cycles with consumption hours wrongly will not necessarily make sense). Otherwise, without total view, all units and conversions (hours, minutes) will be taken over from the process item definitions.



options Here you can, like with all add-ons, configure the tool tip

help. Furthermore, all print-outs and exports can be carried out as default text files.

The currently chosen statistic will mainly determine which files will be printed. If you have the week statistic running, the items "statistic detail protocol", “statistic overview protocol" and "statistic sums" will refer to the week dates which are displayed for the relevant time. Moreover, you can choose only one total sum statistic if it has been made for the current display.

close Closes the consumption statistic.



18.5 Activating the Statistics After configuring the management, in the background the chosen process items will be logged. Every fifths minute, the level of all controlled counters will be saved. If a new day or change of date is realised, a summary of the old day will be saved in a file for the year. In the upper right part of the additional function "consumption statistic" you will find five symbol buttons.

Button 1 equals the IP-Values, which will also be displayed when the add-ons is started. Buttons 2 to 5 equal the relevant statistics: from left to right, day statistic, week statistic, month statistic, and year statistic. By clicking one of these buttons the pieces of information are loaded and displayed. If there are no protocol entries for a period of time, nothing will be displayed, of course, but the values remain set on "0".



18.6 Operating the Statistics The statistic display is subdivided in three sections: on the very top is the head of the statistic. The type of statistic, the time period for the statistic and (if thought useful) the total sum will be displayed. Among them there is a list with all moments of time of the . Next to it, there are up to two value columns: in the first the detail values of the chosen process items are displayed; the total of all process items for this point of time is to the right of it, in case you want to read the total sum. In the lower part of the screen the survey protocol of the relevant statistic is shown. Here you will find the time period of the statistic broken down according to the single process items. The consumption sums (“PI Values-Sum”) of the process items will be shown next to each process item, so-to-speak. If you choose a process item in this list (by clicking the left mouse key), all their individual values at the separate points of time will be indicated in the upper half of the image.

With the "options" button the currently displayed statistic can be printed or exported to a file now, too.



18.7 Printing or Saving Statistics automatically (time-controlled) description In order to produce automatic or time-controlled print-outs or

export files, an additional command has been integrated in the script-language of the add-ons "event programmes". This way, simple event programmes can be produced, which can be activated via the add-ons "time programme" or also on an image via a switching variable.

command "STATISTIC" (type, "process item list", "resolution", "unit",

"path"); type number between 0 and 10

0: IP-Values (all process items with current values and limiting values)

1: Day statistic - (current day) 2: Day statistic – IP-Values 3 Week statistic - (current week) 4 Week statistic - IP-Values 5 Month statistic - (current day) 6 Month statistic - IP-Values 7 Year statistic - (current year in months) 8 Year statistic - IP-Values (in months) 9 Year statistic - (current years in days) 10 Year statistic - IP-Values (in days)

process item list The name of the process item list for the statistics is given

in quotation marks. This list has to be defined in the additional function "consumption statistic" at an earlier point of time. All types of statistic (1 - 10) require a valid list name. For type 0 (survey protocol) the list name can also be void ("").



resolution Number between 0 and 2

0: Printing values without conversion 1: Resolution by minutes (value/60) 2: Resolution by hours (value/3600)

unit Additional unit text in quotation marks (e.g., "HELLO"). ""

mean no unit. path Via this parameter you can set whether the statistic is only

to be printed or whether it is to be saved. In case no path is entered, a text file "STAT.TXT" will be produced in the project table. This text file will be transferred to a printer then. This file will be saved until the next "statistic"-command (at the same time it will be rewritten) and can be used for further processing (WinWord, EXCEL, etc.). If you enter an index, the statistic will be saved under an unique file name (the path has to be entered at an earlier point of time). Example: C:\VISU\EXCEL (see line 2 in the picture) The file name is made up of the following items: jjMTHmt for year / month / day / minute / type of statistic (lower-case letter: decimal; capital letter: encodes 012..ABC..) e.g.: 982IC301.TXT, for 98/02/18, 12:30, type 1 (day statistic)



Examples (See picture, line 1) Statistic (4, "TEST", 1 "minutes", "");

Prints the survey protocol of the week statistic (for list "TEST" in minutes) Statistic (9, "SWITCH", 0, "", ""); Yearly statistic for "SWITCH" in days (as a 32 bit value without unit)

A call could look like the following then: Statistic (1, "TEST", 1, "minutes", "C:\VISU\EXCEL) => save in a given path. Statistic (1, "TEST", 1, "minutes", 22) => read it out in file STAT.TXT and print it.

Visualisation Auxiliary Programmes


19 Auxiliary Programmes In the “Visualisation instabus” programme group there are further auxiliary programmes:

Individual functions of these auxiliary programmes have been explained in detail in the according chapters. Additionally, on the following pages you will find short descriptions of all the functions of the auxiliary programmes.

19.1 EIBTOOL description The “EIBTOOL” auxiliary programme serves for

reading in bus device data from a bus connected or from an existing data base which has been generated by the EIBTool Software (ETS). After the programme has been started first the project is to be selected for which the bus device data are to be used. Then the EIBTOOL programme window is displayed:

Auxiliary Programmes Visualisation


The “File” Menu

Select project Displays the window for project selection (as with programme start).

Exit programme Exits the programme.

About Displays name and version number of the programme.

The “Interface” Menu

Parameters To set the interface parameters (see also Chapter 4 “Take Over Bus Device Data”).

Open Establishes connection between PC and bus.

Close Cancels bus connection.

The “Services” Menu

Device- Setup scan range: Here the zones and lines can be defined which are to be scanned for bus devices. Scan using line couplers: First the bus is scanned for existing couplers and then only devices are scanned connected to these couplers. Scan direct: All possible addresses on the EIB are scanned for devices. Edit list: To edit the devices found. Read device list: Starts the reading of device data according to the device list. Data read in before will be deleted. Read additional device list: Starts the reading of device data according to the device list. Data read in before will not be deleted. Read single device: To read out single devices e.g. when the installation has been extended. Device must be declared as known before via “Edit list”.



Status applications With this item the list of objects to be

cyclically polled can be edited.

Counter parameter General: If a counter device with group addresses exist in the ETS, “Counter Parameters” can be ignored! Instead, the group addresses have to be set onto “C” in the ADDGRP.TXT-files. It serves for setting the cyclical reading of certain group address from the counter device N 343.

Object In the menu you can select “Counter”, “Counter limit”, and Counter alarm”.

Start group address Here you enter the group address

(e.g. 1/1/7).



Step size Is dependent on the setting of the group

address. Example Step size 1

Channe1 Channel 2 Channel 3 Counter 9/1 9/2 9/3

Counter limit

9/4 9/5 9/6

Counter alarm

9/7 9/8 9/9

Step size 3

Channel 1 Channel 2 Channel 3 Counter 9/1 9/4 9/7

Counter limit

9/2 9/5 9/8

Counter alarm

9/3

9/6 9/9

Object count The number of the objects equals the

number of the counters. Add Via “Add” the settings are taken over into

the list. Remove Via “Remove” one or several settings can

be removed.

Create system files After all devices have been read out (via list or single) or from the ETS this function starts the generation of the system files (raw data, group data and system files).



The “ETS” Menu

Project selection Selection of the ETS project. Note: only local ETS projects can be selected. Watch the setting of the path in the SYSTEMCONFIG if you are dealing with ETS 2.XX projects.

Read Complete project Takes over the complete project include all

data. Read group texts Takes over the ETS commentary for the

individual group addresses. Read device texts Takes over the ETS commentary for the

individual devices. Read device data Takes over the device data:

– device list – device data (corresponds to the “Scan direct” and “Read device list” of the “Services” menu, but here based on ETS only)



19.2 Version Display description The “Version display” auxiliary programme is

used for the display of the programme versions installed, but also for the automatically recording of the WIN.INI, SYSTEM.INI, CONFIG.SYS, AUTOEXEC.BAT and DRWATSON.LOG system files, if there are installation problems or other problems. This information can be stored as a text file or printed out and can be sent to SIEMENS for analysis.

The “File” Menu

Save Saves the programme versions read and, if necessary, the contents of the system files as a text file under the name entered under “Save as” before. If you save the first time, a name for the text file is requested at any rate.

Save as Saves the programme versions read and,

if necessary, the contents of the system files as a text file under a name to be entered.

Print Prints out the programme versions read

and, if necessary, the contents of the system files on the default printer.

Exit Exits the programme.

The “Options” Menu

Options To select the system files to be added to the text file:



Scan versions Reads the versions of the programmes installed of the “Visualisation instabus” and displays them in the programme window:

Copy Copies the contents of the programme window into the Windows clipboard.

Tool bar Optional display of a tool bar which contains buttons for most of the functions of the version display programme.

The “Info” Menu

REVTOOL Info Displays the copyright note.



19.3 System Configuration description With the system configuration programme

global and project related system parameters can be set. Some of the most important settings have been explained in the according chapters of the manual. The following summary gives an overview over all settings possible.

Programme structure The system configuration window is subdivided into three

areas:

selection area

help area

setting area

selection area In the selection area you can find the two combo boxes for the selection of the topic and the functions which are assigned to the topic (subtopics). If the parameters to be set are project related, an additional box for the project selection will also be displayed (see figure above). With global settings the box for the project selection is not displayed.

help area In the help area a short description of the topic selected is displayed.



setting area The setting area serves for the setting of the selected

parameter. The setting tool offered changes dynamically depending on the selected function: it may be – as in the example above – a selection box from which existing settings can be selected. For the setting e.g. of values a scroll bar is displayed or for a textual entry an entry field will be offered, etc.

The “Systemparameters” Topic Message font height global, range: 12 up to 32,

default: 12 Setting of the font size for the message display.

Page header format global, text entry

Here the header line for the printer output is defined. For control characters and variables see Chapter 8 “Other Functions”: “Print Event Messages”.

Message text format global, text entry

Here the format for the event messages and user messages (i.e. “print” command in event programmes) is defined. For control characters and variables see Chapter 8 “Other Functions”: “Print Event Messages”.

Other text format global, text entry

Here the format for system messages is defined. For control characters and variables see Chapter 8 “Other Functions”: “Print Event Messages”.



Maximum message text width global, range: 40 up to 128, default: 80

Definition of the maximum line length for the printout of the messages and event messages.

Maximum messages per page global, range: 20 up to 255,

default: 66 Definition of the lines per page for the printout of the messages and event messages.

Save messages to file project related, range: yes / no

For diagnostic reasons all messages will be stored in the files PP1.LOG and PP2.LOG in the Windows directory.

Programme protection global, range: yes / no,

standard: yes Locking of the task switch possibility of Windows (e.g. Alt+Tab).

Show picture numbers project related, range: yes / no,

default: yes Enable or disable display of the picture number in the picture selection dialogue.

Picture sorting project related, range: sort by picture name /picture number, default: sort by picture name Defines whether the working sheets are to be sorted by the name or by the number (see also “Open picture” dialogue in Chapter 6).



Backup of system files project related, range: yes/no,

default: no Defines whether backup files are automatically to be generated.

Variables info window project related, range: yes/no,

default: no. If you double-click on some variables (e.g. meter variable, bar variable) a window is displayed containing information on the process item. This function can be enabled or disabled here.

Alarm sound file global, range: no sound file - selection of the

Windows .WAV files. default: no sound file When using a sound card for the output of an audible signal a sound file can be assigned.

Project directory global, range: define path, default: no directory defined All projects are stored under the same directory in which the Visualisation is installed by default. If a project directory is defined here, the projects will be stored under this directory.

3-D Effects global, range: yes/no, default: no With this function the Windows display and operating elements (dialogue boxes, buttons etc.) can be switched into a 3-D mode.

Loading progress display global, range: yes/no,

default: yes The bar which indicates the progress during start-up and during changing of the pictures can be enabled or disabled by this item.



Picture redraw mode global, range: normal/fast,

default: normal normal: delete the current picture and then draw the new one fast: new picture is built up in the background and then the display is switched (Pentium processors only).

Privilege (variables) project related, range: 1-99,

default: 1 Here the default privilege level for newly generated variables can be defined. This assignment can be changed in the appropriate style dialogue of the variable.

Bitmaps scaling project related, range: yes / no, default: no Bitmaps used as background pictures normally cannot be adjusted in size. If this switch is set it is possible to change the size of the background pictures. Attention: Scaled bitmaps require more display building time.

Symbolvariable invisible project related, range: normal/fast,

default: normal If the symbol variable has the “invisible” display setting in one of the states, it will be displayed as a rectangle with coloured frame in the “normal” setting when in off-line mode. With the “fast” setting the coloured frame will not be displayed, but the picture’s background will be displayed inside the variable. Advantage: this results in a smoother picture display with slower graphic cards when in on-line mode and the state of the variable changes from “invisible” to “visible”.



Group address Displaymode project-related, 2 columns/3 columns

Default: 2 columns Here you can set the mode of the display of the group address in the visualisation: 2 or 3 columns.

ETS 2.x global, range: select ETS path, default: no path entry Here you enter the path in which the ETS 2.x is located. Without any entry, the visualisation is not able to access the data of the ETS 2.x. Example: C:\ETS2V11

ETS version global range: enter version default: ETS 2xx Here you get which ETS-version is to be accessed. You can select either ETS 1.xx, or ETS 2.xx. See also chapter 4.3

The “Backup Directories” Topic

DISK 1 DISK 2 global, assignment of names to drives.

When exporting or importing the according names will be displayed in the selection box. As a standard DISK 1 is assigned to drive A: and DISK 2 to drive B:. It is also possible to assign a name to a certain path on the hard disk or to a network drive.

The “Start-Up Picture” Topic

LOADPIC 1 - LOADPIC n project related, range: 1 - 999,

default: 1 Selection of the picture which is to be displayed automatically after the Visualisation has been started.



The “Start-Up Programme” Topic

List of the start- up programmes project related, text entry, default: no

programme in list To define a start-up programme which is to be started automatically after start-up of the Visualisation. “Add” opens an edit field in which the name of the programme is to be entered. “Set” takes over the according programme into the list. Event programmes or scheduler programmes can be used as start-up programmes.

The “Network Computer List” Topic

List of the network computers global, text entry, default: no computer in

list To define the network computers which are to be connected automatically after the start-up of the Visualisation. “Add” opens an edit field in which the name of the computer is to be entered. “Set” takes over the computer into the list.

The “Multicast List” Topic

List of the multicast computers Definition of the multicast computers in the

network. Enter the multicast computer name and the list of the computer IDs assigned to this multicast computer. Note: To be changed only by the network administrator!

The “EIB Parameters” Topic

Simulation mode global, range: yes/no, default: no switches the simulation mode on or off.



Simul. telegram rate global, range: 2 up to 10, default: 2

here the telegram rate can be set for the simulation mode, i.e. the time period (in seconds) after which new telegrams are to be generated.

Simul. telegram count global, range: 0 up to 10, default: 3

with this parameter the number of telegrams per cycle can be set.

Driver write mode global, range:

write, do not mirror, read back, write, mirror, read back, write, mirror, do not read back default: write, mirror, read back sets the driver’s write mode for groups which can be read back. Explanation see Chapter 2 “Notes on the Visualisation”.

Mirror groups global, range: do not mirror non-readable group addresses mirror non-readable group addresses default: mirror not readable group addresses sets the write mode of the driver for groups which cannot be read back. Explanation see Chapter 2 “Notes on the Visualisation”.

Write on unknown groups global, range: yes/no, default: no

manually defined group addresses which are not read out from an ETS project or from the bus can be used as virtual group addresses, if “yes” is entered here. If “no” is entered, writing to these group addresses is disabled (see also Chapter 2).



Picture update rate project related, range: 100 up to 2000,

default: 500 defines the update period in ms. This value defines the time interval for updating the contents of the pictures and is used to optimise display on slower computers. Note: The polling rate of the driver is independent from this reaction time and is not affected by it.

Device failure beep global, range: yes/no, default: no

If this switch is set to “yes” a repeating signal is generated via an installed <->sound card, if a device fails. The signal can be acknowledged by the loudspeaker symbol of the message window or via the “Signal off” menu item of the System menu.

Interface address display Yes/no

default: no display of the physical interface address (RS 232)

Internal limit Checking project related, off/on,

default: off If this switch is on, value limits can be overwritten during monitoring.

The “Add-Ons” Topic

List of the Installed add-ons project related, range: yes/no,

default: yes each add-on can be enabled or disabled project related. The following add-ons are available at the moment: Event monitor Time manager Event programmes Value recording



Event monitor save mode project related, range: yes/no,

default: no If this switch is set to “yes” the event monitor checks at each start whether there are more than 8192 entries (maximum number) in the current data base or not. If this is the case, the events will automatically be splitted and stored. These files (“AUTOxxxx”) can be loaded and evaluated via the event monitor as usual. However, it may happen that “come/go” events are stored in different files. If you want to avoid this, you should not use the automatic storage but store the selected events manually.

Add-ons font project related, range: icon font/standard font, default: icon font The event monitor, time manager and value recorder add-ons use the same font for text display Windows uses for the labelling of the icons. However, if you selected a large font for the icons, it may happen that several texts of the add-ons are clipped. As a remedy you can switch over to the integrated standard fond, but this is normally a little bit slower.

Enlargement of counter value project related, range: yes/no

default: no setting With “yes” the counter values can be increased manually.

Consumption statistic privilege project related, 1-99

default: 1 Via the scroll bar a value between 1 and 99 can be entered. Via “Set” the value entered will be activated. At the same time a value for the minimum privilege level of the value settings will be set.

Visualisation Predefined Texts


20 Predefined Texts

20.1 Unit Texts

No. Unit No. Unit

1 Km 2 m 3 cm 4 mm 5 um 6 nm 7 t 8 kg 9 gr 10 mg

11 °C 12 °F 13 °K 14 hpas 15 pas 16 mpas 17 bar 18 mbar 19 sqkm 20 sqm 21 sqmm 22 cbm 23 cdm 24 ccm 25 h 26 min 27 sec 28 ms 29 us 30 ns 31 day(s) 32 month(s) 33 year(s)) 34 KV 35 V 36 mV 37 KA 38 A 39 mA 40 MW 41 KW 42 W 43 mW 44 MJ 45 KJ 46 J 47 mJ 48 Lux 49 % 50 K/h 51 m/s 52 °

Predefined Texts Visualisation


20.2 Status Texts

No. Text No. Text

1 alarm 2 break-in alarm 3 fire alarm 4 frost alarm 5 gas alarm 6 oil alarm 7 techn. alarm 8 water alarm 9 danger 10 failure

11 warning 12 maintenance 13 phase loss 14 power loss 15 low limit 16 high limit 17 high limit alarm 18 low limit alarm 19 high limit warn 20 low limit warn 21 off 22 on 23 on 1 24 on 2 25 on 3 26 manual 27 automatic 28 empty 29 full 30 closed 31 open 32 locked 33 unlocked 34 stop 35 start 36 down 37 up 38 backwards 39 forward 40 previous 41 next 42 summer mode 43 winter mode 44 day operation 45 night operation 46 heating mode 47 cooler mode 48 out of operation 49 start position 50 end position 51 initialisation 52 optimisation 53 right 54 left 55 normal 56 abnormal 57 present 58 not present 59 passive 60 active 61 slow 62 medium 63 fast 64 bottom



No. Text No. Text 65 centre 66 top 67 pause position 68 start position 69 middle position 70 end position 71 heating 72 neutral 73 cooling 74 night depression 75 normal operation 76 heating oper. 77 power sav. oper 78 frost protection 79 stand-by oper. 80 comfort oper. 81 blind down 82 blind stop 83 blind up 84 slats closed 85 slats opened 86 curtain closed 87 curtain stop 88 curtain opened 89 roller bl. down 90 roller bl. stop 91 roller bl. up 92 screen down 93 screen stop 94 screen up 95 stage 0 96 stage 1 97 stage 2 98 stage 3 99 stage 4 100 stage 5 101 stage 6 102 stage 7 103 stage 8 104 stage 9 105 inconsistent 106 dew point alarm 107 in operation 108 oper. position 109 open 110 close 111 deeper 112 higher 113 darker 114 lighter 115 on 116 COMFORT 117 STANDBY 118 NIGHT 119 FROST PROT. 120 DEW POINT 121 controller off 122 controller on 400 LV alarm low 401 LV warning low 402 normal 403 LV warning high 404 LV alarm high



20.3 Status Lists

List : present/not pr Value : 0 text(0058): not present Value : 1 text(0057): present List : down-/upwards Value : 0 text(0036): downwards Value : 1 text(0037): upwards List : down/up Value : 0 text(0036): downwards Value : 1 text(0037): upwards List : down/stop/up Value : -1 text(0036): downwards Value : 0 text(0034): stop Value : 1 text(0037): upwards List : alarm Value : 1 text(0001): alarm List : on Value : 1 text(0115): on List : on/off Value : 0 text(0021): off Value : 1 text(0115): on List : start/end pos. Value : 0 text(0049): start position Value : 1 text(0050): end position List : start/mid/end pos. Value : -1 text(0068) start position Value : 0 text(0069): middle pos. Value : 1 text(0070): end position List : up-/downwards Value : 0 text(0037): upwards Value : 1 text(0036): downwards



List : up/down Value : 0 text(0037): upwards Value : 1 text(0036): downwards List : open/closed Value : 0 text(0031): open Value : 1 text(0030): closed List : off/stage 1/2 Value : 0 text(0021): off Value : 1 text(0096): stage 1 Value : 2 text(0097): stage 2 List : off/stage 1/2/3 Value : 0 text(0021): off Value : 1 text(0096): stage 1 Value : 2 text(0097): stage 2 Value : 3 text(0098): stage 3 List : off/stage 1 Value : 0 text(0021): off Value : 1 text(0096): stage 1 List : out of/in oper. Value : 0 text(0048): out of oper. Value : 1 text(0107): in operation List : 1 stage comm. Value : 0 text(0021): off Value : 1 text(0022): on List : 2 stage comm. Value : 0 text(0021): off Value : 1 text(0023): on 1 Value : 2 text(0024): on 2 List : 3 stage comm. Value : 0 text(0021): off Value : 1 text(0023): on 1 Value : 2 text(0024): on 2 Value : 3 text(0025): on 3



List : dark/stop/light Value : -1 text(0113): darker Value : 0 text(0034): stop Value : 1 text(0114): lighter List : darker Value : 1 text(0113): darker List : darker/lighter Value : 0 text(0113): darker Value : 1 text(0114): lighter List : break-in alarm Value : 1 text(0002): break-in alarm List : pow.-sav. oper. Value : 1 text(0077): pow.-sav. oper. List : fire alarm Value : 1 text(0003): fire alarm List : fr/nght/ps/co Value : 0 text(0078): frost prot. op. Value : 1 text(0045): night oper. Value : 2 text(0077): pow.-sav- oper. Value : 3 text(0080): comfort oper. List : fr/nght/sp/co/dp Value : 0 text(0078): frost prot. op. Value : 1 text(0045): night oper. Value : 2 text(0077): pow.-sav. oper. Value : 3 text(0080): comfort oper. Value : 4 text(0106): dew-point alarm List : frost alarm Value : 1 text(0004): frost alarm List : frost protect. Value : 1 text(0078): frost prot. op. List : gas alarm Value : 1 text(0005): gas alarm



List : danger Value : 1 text(0009): danger List : closed/open Value : 0 text(0032): closed Value : 1 text(0033): open List : high limit alarm Value : 1 text(0017): high limit alarm List : low limit alarm Value : 1 text(0018): low limit alarm List : limit alarm/warn Value : -2 text(0018): low limit alarm Value : -1 text(0020): low limit warn Value : 0 text(0055): normal Value : 1 text(0019): high limit warn Value : 2 text(0017): high limit alarm List : high limit warn Value : 1 text(0019): high limit warn List : low limit warn Value : 1 text(0020): low limit warn List : high limit Value : 1 text(0016): high limit List : low limit Value : 1 text(0015): low limit List : limit exceed. Value : -1 text(0015): low limit Value : 0 text(0055): normal Value : 1 text(0016): high limit List : man./auto Value : 0 text(0026): manual Value : 1 text(0027): automatic List : heating/cooling Value : 0 text(0046): heating mode Value : 1 text(0047): cooling mode



List : heat/neut/cool. Value : -1 text(0071): heating Value : 0 text(0072): neutral Value : 1 text(0073): cooling List : heating mode Value : 1 text(0046): heating mode List : heating Value : 1 text(0071): heating List : heating/cooling Value : 0 text(0071): heating Value : 1 text(0073): cooling List : lighter Value : 1 text(0114): lighter List : higher Value : 1 text(0112): higher List : initialisation Value : 1 text(0051): initialisation List : comfort oper. Value : 1 text(0080): comfort oper. List : cooling mode Value : 1 text(0047): cooling mode List : cooling Value : 1 text(0073): cooling List : slow/fast Value : 0 text(0061): slow Value : 1 text(0063): fast List : empty/full Value : 0 text(0028): empty Value : 1 text(0029): full List : left/right Value : 0 text(0054): left Value : 1 text(0053): right



List : slow/med/fast Value : -1 text(0061): slow Value : 0 text(0062): medium Value : 1 text(0063): fast List : night/day oper. Value : 0 text(0045): night operation Value : 1 text(0044): day operation List : night depress. Value : 1 text(0074): night depress. List : normal/abnormal Value : 0 text(0055): normal Value : 1 text(0056): abnormal List : normal/heat Value : 0 text(0075): normal oper. Value : 1 text(0076): heating oper. List : open/closed Value : 0 text(0033): open Value : 1 text(0032): closed List : open Value : 1 text(0109): open List : open/close Value : 0 text(0109): open Value : 1 text(0110): close List : oil alarm Value : 1 text(0006): oil alarm List : optimisation Value : 1 text(0052): optimisation List : passive/active Value : 0 text(0059): passive Value : 1 text(0060): active List : phase loss Value : 1 text(0013): phase loss



List : contr. on/off Value : 0 text(0121): controller off Value : 1 text(0122): controller on List : back-/forward Value : 0 text(0038): backwards Value : 1 text(0039): forward List : pause/oper Value : 0 text(0067): pause position Value : 1 text(0108): operating pos. List : close Value : 1 text(0110): close List : sum./wint. mode Value : 0 text(0042): summer mode Value : 1 text(0043): winter mode List : standby mode Value : 1 text(0079): standby mode List : stop/start Value : 0 text(0034): stop Value : 1 text(0035): start List : failure Value : 1 text(0010): failure List : power loss Value : 1 text(0014): power loss List : stage 0/1 Value : 0 text(0095): stage 0 Value : 1 text(0096): stage 1 List : stage 0/1/2 Value : 0 text(0095): stage 0 Value : 1 text(0096): stage 1 Value : 2 text(0097): stage 2



List : stage 0/1/2/3 Value : 0 text(0095): stage 0 Value : 1 text(0096): stage 1 Value : 2 text(0097): stage 2 Value : 3 text(0098): stage 3 List : T controller default: 0 default text(0105): inconsistent Value : 1 text(0116): COMFORT Value : 2 text(0117): STANDBY Value : 4 text(0118): NIGHT Value : 8 text(0119): FROST PROT. Value : 16 text(0120): DEW POINT List : day/night oper. Value : 0 text(0044): day operation Value : 1 text(0045): night operation List : dew-point alarm Value : 1 text(0106): dew-point alarm

List : techn. alarm Value : 1 text(0007): techn. alarm

List : deep/stop/high Value : -1 text(0111): deeper Value : 0 text(0034): stop Value : 1 text(0112): higher

List : deeper Value : 1 text(0111): deeper

List : deeper/higher Value : 0 text(0111): deeper Value : 1 text(0112): higher

List : bottom/top Value : 0 text(0064): bottom Value : 1 text(0066): top

List : bot./mid/top Value : -1 text(0064): bottom Value : 0 text(0065): middle Value : 1 text(0066): top

List : warning Value : 1 text(0011): warning



List : maintenance Value : 1 text(0012): maintenance

List : water alarm Value : 1 text(0008): water alarm

List : closed/opened Value : 0 text(0030): closed Value : 1 text(0031): opened

List : cl/stop/opened Value : -1 text(0030): closed Value : 0 text(0034): stop Value : 1 text(0031): opened

List : prev/next Value : 0 text(0040): previous Value : 1 text(0041): next

Visualisation Index


21 Index

A Acknowledging an event.......................................................................16-3 ACTUAL VALUES..................................................................................18-4 Additional Functions..............................................................................1-25 Add-Ons ..............................................................................................19-16 Addressing ............................................................................................17-4 Alignment..............................................................................................6-16 Annual calendar.....................................................................................14-1 Arc...........................................................................................................6-8 Area diagram .......................................................................................15-13 Area diagram (filled) ............................................................................15-13 Arithmetic operators .............................................................................13-4 Assign process items............................................................................7-40 Assignment variable - process item......................................................7-39 autoexec.bat..........................................................................................1-14 Automatic programme start ....................................................................8-9 Automatic start of WINDOWS................................................................8-9 Autostart .................................................................................................8-9 Auxiliary programmes ...........................................................................19-1

B Background colour ..................................................................................6-4 Background picture .................................................................................6-3 Backup copy............................................................................................9-1 Backup directories...............................................................................19-13 Bar diagram .........................................................................................15-15 Bar diagram (overlapping) ...................................................................15-15 Bar variable.....................................................................................1-19, 7-6 Bit groups..............................................................................................5-15 BOOTP ..................................................................................................17-4 Bus connection .......................................................................................8-1 Bus system ...........................................................................................2-11

C Calculations/logic operations.................................................................13-1 Call the visualisation software.................................................................3-5

Index Visualisation


Central function .................................................................................... 5-29 Change size .......................................................................................... 6-10 Changing user name .............................................................................. 8-8 Circle....................................................................................................... 6-7 Client .................................................................................................. 17-11 Client/32 interface ................................................................................ 17-5 Combine ............................................................................................... 6-14 Command output ................................................................................... 2-4 Commands of the programme editor................................................... 12-2 Commands of the Recorder................................................................. 7-37 Comparison operators .......................................................................... 13-4 Computer name ................................................................................... 17-8 Conditions/control commands.............................................................. 13-5 config.sys ............................................................................................. 1-14 Connection to the bus system ............................................................. 2-10 Constants ............................................................................................. 13-3 Consumption hours .............................................................................. 18-9 Consumption statistic..................................................... 18-4, 18-10, 18-11 Control commands ................................................................................. 2-4 Conversion functions..................................................................... 5-7, 5-20 Copy ..................................................................................................... 6-12 Copying day programmes .................................................................... 14-9 Copying time jobs................................................................................. 14-8 Counter...................................................................................... 18-7, 18-11 Counter variable ................................................................. 1-21, 7-23, 18-1 Coupler ................................................................................................. 2-13 Creating new group (val. monitoring) ................................................... 15-4 Creating pictures .................................................................................... 6-1 Cut ........................................................................................................ 6-14

D Data sub-type name ............................................................................. 5-12 Data type .............................................................................. 1-9, 1-16, 5-10 Day statistic ........................................................................................ 18-11 Day statistic display.............................................................................. 18-8 Deactivating event programme............................................................ 12-5 Deactivating the Time Manager ......................................................... 14-28 Default gateway ................................................................................... 17-3 Define process items ........................................................................... 5-26 Defining tracks...................................................................................... 15-7 Delete ................................................................................................... 6-14 Delete group (val. monitoring) .............................................................. 15-6 Deleting day programmes.................................................................. 14-10

Visualisation Index


Deleting events .....................................................................................16-6 Deleting individual jobs .........................................................................14-9 Detail values........................................................................................18-12 Device list................................................................................................4-5 Device monitoring .................................................................................11-1 Device texts ..........................................................................................4-10 DHCP ....................................................................................................17-4 Diagram variable.............................................................................1-19, 7-9 Disable printer .......................................................................................8-18 Displaying events ..................................................................................16-2 Displaying filter (events)........................................................................16-9 Displaying time manager.....................................................................14-22 DNS..............................................................................................17-3, 17-4 Dongle.................................................................1-24, 3-5, 10-1, 17-5, 17-6 Drawing tools ..........................................................................................6-6 Driver write mode ...................................................................................2-5 Dummy devices ....................................................................................2-14 Duplicate ...............................................................................................6-12 Dynamic image elements .....................................................................1-19

E Editing box ............................................................................................17-8 Editing day programmes .......................................................................14-4 Editing event programmes..................................................................14-13 EIB 2.............................................................................................7-23, 18-1 EIB installation bus................................................................................1-11 EIB Parameters ............................................................................2-5, 19-14 EIB simulation mode ...............................................................................4-3 EIBTOOL .................................................................................4-1, 4-9, 19-1 EIBTool Software (ETS)..................................................................1-16, 4-1 EIBus data type .....................................................................................5-23 EIS types ...............................................................................................5-10 Ellipse......................................................................................................6-6 Enable printer ........................................................................................8-18 ETS data base .........................................................................................4-8 ETS project planning ...............................................................................2-9 Event messages on the screen ............................................................8-13 Event monitoring...................................................................................16-1 Event programme .................................................................................12-1 Event programme monitoring ...............................................................13-8 Event programmes..............................................................................18-14 Events ...................................................................................................16-1 EXCEL ..........................................................................................15-2, 16-1

Index Visualisation


Export data ............................................................................................. 9-2 Export project ......................................................................................... 9-1 Export to EXCEL................................................................................. 15-30 Exporting event data to EXCEL .......................................................... 16-15 Exporting/importing event files .......................................................... 16-18 Extra parameters .................................................................................. 5-30

F File formats ............................................................................................ 6-3 Filter table............................................................................................. 2-13 Filtering list ........................................................................................... 18-7 Follow-up time jobs ............................................................................ 14-29 Fonts ............................................................................................... 1-3, 6-8 FTP programme.................................................................................... 17-4

G Global value .......................................................................................... 5-25 Graphic symbol..................................................................................... 7-15 Graphical analysis of the event data base .......................................... 16-11 Grid ....................................................................................................... 6-18 Group address ...................................................................................... 1-16 Group texts........................................................................................... 4-10

H Hardware requirements ....................................................................... 1-13 Hidden switches............................................................................ 7-5, 7-12 Hint texts ................................................................................................ 5-7 HOST.................................................................................................... 17-4 Host address ........................................................................................ 17-2 Hours of operation counters................................................................. 18-7

I Image variables....................................................................................... 7-1 Import data ............................................................................................. 9-2 Import files ............................................................................................. 6-3 Importing a project ................................................................................. 3-6 Installation .............................................................................................. 3-1 Installation of the options ..................................................................... 10-1 Interworking standard .......................................................................... 5-24 Invisible........................................................................ 7-5, 7-12, 7-16, 7-22

Visualisation Index


Invisible switch......................................................................................7-22 IP-address ..................................................................17-2, 17-3, 17-4, 17-8

J Jobs.......................................................................................................14-1 Jump instruction ...................................................................................13-5

K Keyboard operation only .......................................................................8-24

L Library .....................................................................................................7-1 Line .........................................................................................................6-6 Line (bus system)..................................................................................2-11 Line chart ................................................................................................7-9 Line coupler...........................................................................................2-13 Line diagram........................................................................................15-12 Line diagram (filled) .............................................................................15-12 Location inside the bus system ............................................................2-11 Log event messages.............................................................................8-12 Logic operators .....................................................................................13-4 Log-on .....................................................................................................8-8

M Main line................................................................................................2-11 Mark ......................................................................................................6-10 Marking multiple elements ...................................................................6-11 Measurement Values/Set Commands /Counters .................................5-18 Message window..................................................................................8-13 Meter variable ..............................................................................1-19, 7-13 Mirror ....................................................................................................6-15 Moments of time ................................................................................18-12 Month statistic ....................................................................................18-11 Month statistic display ..........................................................................18-9 Move .....................................................................................................6-10 Move measuring cursor ......................................................................15-24 Multicast list ........................................................................................19-14 Multi-state messages/commands.........................................................5-14

Index Visualisation


N Naming variable ...................................................................................... 7-2 Network................................................................................................ 17-2 Network address ................................................................ 17-1, 17-2, 17-3 Network administrator.......................................................................... 17-1 Network application.............................................................................. 17-4 Network computer list........................................................................ 19-14 Network driver...................................................................................... 17-4 Network interface................................................................................. 17-1 Network organisation ........................................................................... 17-2 Network protocol.................................................................................. 17-1 Network server..................................................................................... 17-4 Non-return pointer .................................................................................. 7-6 Novell network ..................................................................................... 17-5 Novell TCP/IP........................................................................................ 17-5 NU technology.................................................................................... 17-12 NU Tool............................................................................................... 17-12 NUI = Network Unlimited Interface ..................................................... 17-1 NU–Interface ........................................................................................ 17-1

O Object locks.......................................................................................... 6-16 Observer............................................................................................... 7-29 Opening pictures manually................................................................... 8-26 Operation designation ................................................................. 5-14, 5-18 Output variable .............................................................................. 1-19, 7-3

P Parallel interface ................................................................................... 17-6 Parameterisation of week variable ..................................................... 14-25 Parameterise display .......................................................................... 15-10 Parameterise printer output ................................................................. 8-19 Partial worlds...................................................................................... 17-13 Password................................................................................................ 8-4 Period of the statistic ......................................................................... 18-12 PI Values-Sum .................................................................................... 18-12 Picture menu .......................................................................................... 8-5 Picture variable ............................................................................ 1-19, 7-11 Ping....................................................................................................... 17-5 PING ..................................................................................................... 17-3 PI-Values............................................................................................... 18-4

Visualisation Index


Pixel graphics ..........................................................................................1-2 Player ....................................................................................................7-34 Points ..................................................................................................18-12 Polyline....................................................................................................6-6 Pool .......................................................................................................17-4 pp.ini...............................................................................................8-6, 8-27 Primary network address ....................................................................17-15 Printer.............................................................................................1-8, 1-23 Printing ..................................................................................................13-7 Printing event messages in file .............................................................8-17 Printing project data ................................................................................9-3 Printing recorded data.........................................................................15-31 Printing the event data base ...............................................................16-17 Priority ..........................................................................................5-32, 8-12 Privilege level ..........................................................................................8-4 Process item ....................................................................................1-9, 4-1 Processitemlist......................................................................................18-7 Programme editor .................................................................................12-2 Programme protection ..........................................................................8-11 Project access ..................................................................................3-6, 8-6 Project library ........................................................................................7-39 Project menu...........................................................................................8-5 Project name ...........................................................................................3-5 Protocol file ...........................................................................................18-7 Provider ........................................................................................17-2, 17-3

R Read in bus device data ..........................................................................4-2 Read out bus devices..............................................................................4-1 readme.wri ..............................................................................................3-1 Record length........................................................................................15-1 Recorder.......................................................................................7-31, 18-7 Rectangle ................................................................................................6-6 Reference element ...............................................................................6-16 Resolution by hours ............................................................................18-15 Resolution by minutes ........................................................................18-15 Rotate....................................................................................................6-15 Rounded rectangle ..................................................................................6-6 Router ...................................................................................................17-3

S Saving/loading display parameters......................................................15-20

Index Visualisation


Scaling .................................................................................................. 5-24 Scaling of axes.................................................................................... 15-19 Scheduler.............................................................................................. 14-1 Screen ........................................................................................... 1-4, 7-11 Script-language................................................................................... 18-14 Scroll bar................................................................................................. 7-4 Secondary network address............................................................... 17-15 Sequence.............................................................................................. 8-25 Sequence of objects............................................................................. 6-16 Server ................................................ 17-6, 17-8, 17-9, 17-11, 17-15, 17-18 Server number......................................................................... 17-10, 17-17 Set system clock ................................................................................ 14-30 Setting day programme...................................................................... 14-14 Settings .................................................................................................. 6-9 Simulated telegram count ...................................................................... 8-3 Simulated telegram rate ......................................................................... 8-3 Simulation............................................................................................... 8-2 Single-State Messages/Commands ..................................................... 5-12 Slave pointer........................................................................................... 7-6 Software requirements ........................................................................ 1-13 Sound file.............................................................................................. 8-23 Split....................................................................................................... 6-14 Stack diagram..................................................................................... 15-16 Stack diagram (overlapping) ............................................................... 15-16 Standard settings ................................................................................... 8-5 Standard switches.................................................................................. 8-5 Start menu.......................................................................................... 17-12 Starting the Visualisation ........................................................................ 8-1 Start-up................................................................................................... 2-8 Start-up picture................................................................................... 19-13 Start-up programme ........................................................................... 19-14 State variable............................................................................... 1-21, 7-18 Static images........................................................................................ 1-18 Static Images........................................................................................ 1-19 Statistic............................................................................................... 18-12 Statistic display................................................................................... 18-12 Statistic period...................................................................................... 18-9 Statistics ............................................................................................... 18-8 Statistics ............................................................................................... 18-9 Statistics (events) ............................................................................... 16-11 Status applications ................................................................................. 2-1 Status display ................................................................................ 2-4, 8-23 Status line............................................................................................. 6-18 Status list....................................................................................... 5-6, 20-4

Visualisation Index


Status object ...........................................................................................2-1 Status text .............................................................................................20-2 Status texts .............................................................................................5-5 Storing event messages in file..............................................................8-16 Storing events .......................................................................................16-4 Structure of an event programme.........................................................12-3 Style dialogue..........................................................................................7-1 survey protocol......................................................................................18-4 Survey protocol ...................................................................................18-12 Switch variable .............................................................................1-21, 7-20 Switching commands..............................................................................2-4 Switching cycle counters ......................................................................18-7 Switching cycles ...................................................................................18-9 Symbol variable ............................................................................1-21, 7-15 symbolic name......................................................................................17-8 Symbolic name......................................................................................17-3 Syntax event programme......................................................................13-3 Syntax PING address ............................................................................17-3 System clock.........................................................................................14-1 System configuration ............................................................................19-8 System parameters...............................................................................19-9 System values.......................................................................................5-21

T Table....................................................................................................15-18 TCP Stack Microsoft .............................................................................17-5 TCP/IP....................................................................................................17-1 TCP/IP network .....................................................................................17-2 TCP/IP-protocol .....................................................................................17-5 Telegram course ...................................................................................2-13 Text .........................................................................................................6-8 Text file ...............................................................................................18-15 Text variable .................................................................................1-21, 7-17 Time manager .......................................................................................14-2 Time programme.................................................................................18-14 Tool tip help.........................................................................................18-10 Toolbox....................................................................................................5-3 Trigonometric functions ........................................................................13-4 Type A-network.....................................................................................17-2 Type B-network.....................................................................................17-2 Type C-network.....................................................................................17-3 Type of display ....................................................................................15-12

Index Visualisation


U Unique server Id ...................................................................... 17-15, 17-16 Unit text....................................................................................... 5-24, 20-1 Units ....................................................................................................... 5-4 Unknown group addresses .................................................................... 2-7 Unsigned even number 16 bit wide ..................................................... 5-24 Unsigned even number 32 bit wide ..................................................... 5-24 Unsigned even number 8 bit wide ....................................................... 5-24 Updating display ................................................................................. 15-27 User ........................................................................................................ 3-6 User defined counters........................................................ 5-22, 7-23, 18-1 User flags ...............................................................................5-32, 5-35, 13-6

V Value monitoring................................................................................... 15-1 Variable Types ...................................................................................... 1-10 Variables in event programmes............................................................ 13-2 Vector graphics....................................................................................... 1-1 Version display ..................................................................................... 19-6 Versions available ................................................................................. 1-24 VGA ........................................................................................................ 1-7 Video variables ..................................................................................... 7-28 Virtual group addresses........................................................ 2-7, 5-28, 5-30 Visualisation server........................................................... 17-1, 17-9, 17-18 visualisation servers ........................................................................... 17-16 Visualisation servers.................................................................. 17-8, 17-15

W Week statistic.......................................................................... 18-10, 18-11 Week statistic display........................................................................... 18-8 Week variable.............................................................................. 1-21, 7-26 Workload by event programmes........................................................ 13-10 WWW browsers................................................................................... 17-4

Y Year statistic ....................................................................................... 18-11 Year statistic display............................................................................. 18-9

Visualisation Index


Z Zone coupler .........................................................................................2-13 Zone line................................................................................................2-12 Zones ....................................................................................................2-12 Zooming ..............................................................................................15-25

users manual - instabus eib visualization software

Documents