Users Manual - Instabus EIB Visualization Software

Users 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 (Programmers 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. Users Manual Visualisation Siemens instabus EIB Version 1.1 December 2000
Visualisation
Table of contents
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
Siemens instabus EIB
Table of contents
Visualisation
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
ii
Visualisation
Table of contents
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
iii
Table of contents
Visualisation
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
iv
Visualisation
Table of contents
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
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 represented 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 parameters: ? ? 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.
1-1
General advantages
Visualisation ? The individual elements of the picture can be accessed and edited at any time. ?? The size of the picture can be readily modified proportionally. ?? Relatively little memory space is required for one picture. ? 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. 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 representation the colour e.g. as an 8 bit value). Common pixel graphic formats are e.g.: ? ? *.tif (= Tag Image File) ? ? *.bmp (= Windows Bitmaps) ? ? *.pcx (= PC Paintbrush) ? ? etc. ? Photos and other graphics having without defined structures can be represented very exactly. ?? The speed of synthesising the image is independent of the content of the graphic. ? 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.
disadvantages
pixel graphics
formats
advantages
disadvantages
1-2
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. ? 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. ? 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 (softfonts) must be installed by using the installation programme delivered with these fonts.
printer fonts
true type fonts
download fonts
1-3
General
Visualisation
1.3 Screen Output

Todays 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 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). 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). 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. The size of a monitor is the screen diagonal in inches. Common sizes are 14 up to 21 inches.
colour/ monochrome
digital/ analogue
synchronisation
size
1-4
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. 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. 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.
refresh rate
low radiation
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
1-5
General
Visualisation controls the graphic card and gives full access to the graphic cards capabilities.
Short description Name Available since Origin Graphic resolution Operation modes Max no. of colours Text resolution Video signal Line frequency Refresh rate HGC Hercules Graphics Card 1982 Hercules 720x350 EGA Enhanced Graphics Adapter 1984 IBM 640x350 VGA Video Graphics Array 1987 IBM 640x480 Super VGA 1988 Vesa Group 800x600 8514/A 1989 IBM 1024x768
text/graphics text/graphics text/graphics text/graphics text/graphics none 80x25 9x14 matrix digital 18.43 kHz 50 Hz 16 o.of 64 80x25 8x14 matrix digital 21.85 kHz 60 Hz 256 o.of 262t 16 o.of 256 80x25 8x14 matrix analog 31.5 kHz 60 Hz 132x44 6x12 matrix analog 31.5 kHz 70 Hz 256 o.of 262t 80x34 12x20 matrix analog 35.5 kHz 43 Hz
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. 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 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.
colour graphic cards
CGA standard
1-6
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. 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. 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. 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.
VGA standard
Super VGA
8514/A adapter
the intelligentsia The so called intelligent graphic cards have their own processor and reduce the workload of the processor of the central unit.
1-7
General
Visualisation
1.5 Printer Output

general Today, printers are the most important output device. They can basically be subdivided in impact printers and nonimpact printers.
printers impact non-impact
fully formed char. daisy wheel golf ball type basket
needle matrix
dot matrix laser ink jet thermo transfer
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 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.
non-impact printers
1-8
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 data type Visualisation means the indication of states (monitoring) and the input of setpoints (controlling, operation). 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 The process item is the interface between the information 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 ,...)
process item
1-9
General static images
Visualisation 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 representation of a room, for example. Current states cannot be represented by the static background images. 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 ? ? bar variable ? ? diagram variable ? ? picture variable ? ? meter variable ? ? symbol variable ? ? text variable ? ? state variable ? ? switch variable ? ? counter variable ? ? week variable for the presetting of values for the display as bar chart for the display in the form of a diagram to switch to any screen for the display as an analogue meter for the display of states as symbols for the display of states as text for the display of multi state messages/commands as text to perform various switching procedures for the display of counting values for time-controlled switching
dynamic image elements
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.
1-10
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 installation. 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.
1-11
General
Visualisation 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 important 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.
1-12
Visualisation
1.9 Hardware and Software Requirements

operating system This software can be run on a commercial PC with the MSDOS 6.2 operating system and MS-Windows 3.1 (or MSWindows for Workgroups 3.11). 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. The memory capacity must be 8 MB at least to guarantee perfect working for all functions. The internal bus system may be of the VL, ISA, or EISA type. Please follow the notes on the PCI bus in file:
processor
memory capacity internal bus
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. The colour monitor should have a screen diagonal of at least 17 inches. The Visualisation PC is connected to the instabus EIB via an RS232, N148 or UP147/148 interface. A list containing recommended hardware configurations is available by Siemens
monitor bus connection recommended hardware
1-13
General config.sys
Visualisation The following config.sys file shows an operational configuration on a standard PC. If necessary, further entries are required for additional peripheral units (e.g. sound card, CDROM, 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.
1-14
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-15
General
Visualisation
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. 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 actuators output. The assignment of group addresses to sensors and actuator outputs is made during the project planning and configuration 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
process item
1-16
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 Visualisation 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-17
General
Visualisation
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 between 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).
1-18
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). 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.
state variables
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-19
General
Visualisation
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.
1-20
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 processing 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-21
General
Visualisation
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.
1-22
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
1-23
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. 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:
status objects
2-1
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 information. 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 attributes As in the manual for EIB 0 to 15, 0 R W C group readable group writeable group is cyclically read (has to be set by the user)
2-2
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 of a ADDGRPS.TXT file: (group address=data type; attributes; possible commentaries) 0/1 0/2 0/3 0/4 0/5 0/6 0/7 0/8 0/9 1/1 15/12 edit =0, RC =0, R =0, RWC =7, R =8, R =8, R =0, RWC =0, RW =0, RWC =0, R =8, RWC ;setting: read cyclically ;setting: read ;setting: read cyclically, write ;setting: read ;setting: read ;setting: read ;setting: read cyclically, write ;setting: read write ;setting: read cyclically, write ;setting: read ;setting: internal visualisation address
Example
The content of the ADDGRPS.TXT will be used for generating 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 supplemented 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. 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.
REMGRPS.TXT
2-3
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:
2-4
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 command has been sent: ?? Write, no mirror, reread: 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.
read back new status
2-5
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 mirror groups Write, mirror, reread 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: 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! Mirror none readable group addresses Note: If non-readable group addresses are used in the process item, the Mirror ... setting must be used.
do not mirror the status
Default setting
2-6
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). unknown group addresses are not transmitted, even if they have been set to sending.
do not write
no:
Attention: If unknown group addresses have been defined 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.
2-7
Visualisation
2.3 Notes on the Start-Up Performance of the Visualisation

general start-up The Visualisation gets its information from the bus devices by monitoring the appropriate telegrams on the bus. When the Visualisation is restarted, e.g. after power breakdown, it must request the current states from the bus devices. Otherwise they are only updated in the Visualisation after a corresponding telegram on the bus. 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.
updating
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! 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!
attention
2-8
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 Visualisation, 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. 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). 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.
binary output
temperature sensor
2-9
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 N 5WG1 148-1AB02 Programming LED
SIEMENS
5 W G1 14 8 1A B02 ins tabus EIB
RS232 UP 5WG1 148-2AB11 Labelling field Sub D sockets

9-pole
Learn key Sub D sockets

9-pole
R S 232
70 mm
Strain relief for round cable

( 8 mm max.)
35 mm high
70 mm
3 TE
The connection between the PCs serial interface and the RS232 interface is established via a commercial serial interface cable:
Pin as s ig n m e n t 1 2 3 4 5 6 7 8 9 1 2 3 4 5 6 7 8 9
S ub D s o c k e ts 9-p o le
w ire d 1:1
S ub D p in s 9-p o le
PC
CO M 1/2
bus
R S 232
8 3 2 S ub D 20 s o c k e ts 7 25-p o le 6 4 5 22
1 2 3 4 5 6 7 8 9
S ub D p in s 9-p o le
2-10
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. 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
one line
RS 232
dev 1 dev 63
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:
main line R S 232 LC 1 LC 12
visualisation
dev 1
dev 1
dev 64 line 1
dev 64 line 12
2-11
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.
zone line R S 232
ZC 1
visualisation
main line LC 1 dev 1 LC 12 dev 1
line 1
dev 64
line 12
dev 64
ZC = zone coupler LC = line coupler dev = device
2-12
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: 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). This filter table is generated by the ETS based on the project planning. However, the Visualisation itself is not taken into consideration 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 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.
coupler
filter table
description
2-13
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. Releasing the filter tables in the appropriate direction redirects 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 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. 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. 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. 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.
note
description
dummy devices
load filter table new
note
2-14
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. If an old version of Visualisation instabus already exists on your computer, please first refer to the readme.wri file on installation disk 1. For this purpose start the Windows file manager, switch to drive A: (or B:) and double click on the file named readme.wri. 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. First select the national language in which the Visualisation instabus is to be installed on your computer:
attention
read readme.wri
installation
language
3-1
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 button.
note name, company
The following two dialogue boxes only appear during the first installation of the programme. 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.
3-2
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. The number of available languages may change in future versions.
note
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.
3-3
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.
3-4
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).
3-5
Visualisation
3.3 Importing a Project from Disk

general import project You can import all project data from disk any project of the Visualisation. 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 Initialisation 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!
3-6
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 addresses the process item is to receive or transmit. 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 commentaries entered for the devices and all group addresses are also available. 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. 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
methods
the EIBTOOL programme
attention
4-1
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. 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).
establish bus connection
4-2
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 between 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 Visualisation).
4-3
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).
4-4
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).
4-5
Visualisation read out device data read device list
There are 3 methods of reading out the contents of the devices: 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. 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. 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!
read additional device list
read single device
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
4-6
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.
4-7
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.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). 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) 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 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 programming part of the ETS (EIBUSER.DBS data base). The Visualisation cannot access Imported projects (PRJUSER.DBS data base)! 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.
ETS 1.xx
ETS 2.xx
project access
autoexec.bat
4-8
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.
4-9
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. 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. 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.
read device texts
read device data
4-10
Visualisation
read data note
Selecting the desired menu item starts the according action. 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 generate system files
Possibly projected dummy devices must first be removed from the device list. 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.
4-11
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). 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
grps.log file
4-12
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). 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. 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)!
more than 1 dev. answering
group address readable
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.
4-13
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.
4-14
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.
5-1
Creating Project Data 5. Draw static background pictures static background picture insert image variables
Visualisation
Now the static backgrounds must be determined. 6. Insert image variables The image variables have to be inserted on the static background. 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
Parameters
Data type
Process item
Hint texts
Image variable
5-2
Visualisation
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. To remove a function, the appropriate icon inside the toolbox must be clicked on while keeping the shift key pressed. The function will be removed from the toolbox
remove function
5-3
Visualisation
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. 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.
define units
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
Visualisation
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. 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.
define status texts
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.
5-5
Visualisation
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. After all lists have been defined, the dialogue box is closed by the Close button.
close dialogue
5-6
Visualisation
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. After all hint texts have been entered, the procedure is finished by pressing the Close button.
close dialogue
5.6 Defining of Conversion Functions

general You can convert the value of a process item using a definable function via Conversion functions. The converted 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.
5-7
Creating Project Data application
Visualisation
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. 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.
note
5-8
Visualisation 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. 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. 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.
delete pair of values
save entries
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 afterwards be initialised anew via Driver...? Initialise serial interface to activate the changes.
5-9
Visualisation
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
5-10
Visualisation
Creating Project Data ?? 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 8 bit counter sign and unsigned
without EIS-type: ?? 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-11
Visualisation
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 status text list EIBus data type (EIS type)
Define a name for the data type in the Data subtype name entry field (e.g. Lighting). Select the desired status text list from the Status text list combo box. 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.
5-12
Visualisation allow switching command monitor come/go
Here the transmission of telegrams (i.e. command telegram) can generally be released or blocked for this data type. 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. 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 performed via the Event data base option. 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. 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. Here the priority of the event is set for logging (0...low, 7...high) (see Section Logging Event Messages in Chapter 8). So-called flags can be preset here. They can be processed and modified in event programmes (optional). The settings are taken over via the Add button. An existing definition of a data type can be deleted via the Delete button. Close the dialogue box via OK.
acknowledge event
give acoustic signal
logging of events
priority
user flags add delete OK
5-13
Visualisation
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.
settings
Define a name for the data type in the Data subtype name entry field (e.g. Temp. control).
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: 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.
5-14
Visualisation 1 x 8 status
Creating Project Data The bit field is regarded as an 8 bit value. With this EIS type the transmission of telegrams (command telegram) can be released: If Allow writing is activated, a set value can be transmitted to the device. 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. When the button is pressed a dialogue for the setting of the bit groups is displayed:
allow writing n x m status
configure bit groups
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 common settings Takes over the bit groups configured. All EIS types (8 x 1, 1 x 8 and n x m) shown above allow common settings:
5-15
Creating Project Data user flags bit fields
Visualisation
So-called flags can be preset here. They can be processed and modified in the event-programme option. 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). Here the priority of the event to be logged is set (0...low, 7...high) (see Logging Event Messages in Chapter 8).. 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). 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).
priority log events
collection type
5-16
Visualisation 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-17
Visualisation
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.
settings status text list
Define a name for the data type in the Data subtype name entry field (e.g. Temperature). 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
5-18
Visualisation 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: 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 The limits set are absolute values. Other settings are currently being developed. 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 Here the transmission of telegrams (i.e. command telegram) can generally be released or blocked for this data type.
measuring val. with fixed limits number of fractional digits
allow switching command
5-19
Creating Project Data acknowledge event
Visualisation
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. 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. If the alarm or warning state is to be logged, the according box (Al: alarm low, Wl: warning low) has to be marked. Here the priority of the event to be logged is set (0...low, 7...high) (see Logging Event Messages in Chapter 8). 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 users own units can be defined under Process items? Units (see Definition of Units). The actual process value can be converted for display via a conversion function. Here all the conversion functions defined 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. Here the values for triggering the according alarms, or warnings, are to be defined. A hysteresis for the alarming or warning levels may be entered here. So-called flags can be preset here. They can be processed and modified in the event-programme option.
give acoustic signal
logging of events priority unit
conv. function
alarm/warning limits low/high hysteresis user flags
5-20
Visualisation save delete print cancel OK
Creating Project Data The settings are taken over via the Save button. An existing definition of a data type can be deleted via the Delete button. Will print the data item displayed. With Cancel the changes will be ineffective. 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.
5-21
Creating Project Data display
Visualisation
Displaying time and date in a separate variable is not mandatory because they are automatically shown in the Visualisation. 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. With Save the settings will be taken over. An existing definition of a data type can be deleted via the Delete button. Will print the data item displayed. With Cancel the changes will be ineffective. With OK you leave the dialogue.
EIS type
save delete print cancel OK
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.
5-22
Visualisation
Parameterisation
description Count
Data subtype name: Displays the name of the selected/new data subtype. 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 LV Al. LF Al. LV Wn. LF Wn. LV Wn. LF Wn. LV Al. LF Al. Counter value limiting value for Alarm limit high (changeable) object for Alarm limit high (triggers the alarm) object for Warning limit high (changeable) object for Warning limit high (triggers the al.) object for Warning limit low (changeable) object for Warning limit low (triggers the al.) object for Alarm limit low (changeable) object for Alarm limit low (triggers the alarm)
h h h h l l l l
5-23
Creating Project Data EIBus data type
Visualisation
Shows the Interworking standard which is being used for this value by the EIB-devices. Various Interworking standard 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. 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. If you mark the field Value is writeable the value may be written.
scaling
value
5-24
Visualisation Global values
Creating Project Data 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. If you mark the field GW-Warning high you can enter a fixed limiting value for high limit warn which will be controlled by the Visualisation. If you mark the field GW-Warning low you can enter a fixed limiting value for low limit warn which will be controlled by the Visualisation. 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. With save the current data subtype will be taken over. With delete the current data subtype will be cleared. Data subtypes will be taken over on the computer. All changes of the data subtype will be ineffective.
GW-Warning High
GW-Warning low
GW-Alarm low
Save Delete OK Cancel
5-25
Visualisation
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. The following dialogue box is called via Process items? Process items:
define 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.
5-26
Visualisation
Creating Project Data 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 Select Single-state messages/commands under Data type and e.g. Lighting under Data subtype. Equate: The process item reacts like a normal actuator on the given group address: It always takes over the last state transmitted. All given group addresses are linked according to the OR function. Used for summarised messages. All given group addresses are linked according to the AND function.
data type/ data subtype rule
Or:
And:
5-27
Creating Project Data list of group addresses
Visualisation
All group addresses which have been read out before are listed by the List of Grps... button. Or: All devices with existing object numbers are listed by the List of Phys. Addr... button. Depending on the representation you use, mark a group address or an object of a bus device and press the Add button.
list of physical addresses assign group address
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.
5-28
Visualisation remove/ remove all SE (sending)
Incorrectly assigned group addresses can be removed with the Remove or Remove all button. 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 addresses 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. 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. Here up to 16 characters can be entered as a selection mask. Only process items suitable for the mask are displayed. 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.
replace
selection
change process item
5-29
Creating Project Data delete
Visualisation
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 startup 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.
5-30
Visualisation 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.
5-31
Creating Project Data user flags
Visualisation
So-called flags can be preset here. They can be processed and modified in the event monitoring option. If Flags in use is not marked, the settings of the according data type are used. 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. The settings are taken over via the OK button, and the Extra parameters dialogue box is closed. Extra Parameters with Multi-State Messages/Commands:
priority
take over settings
programmes
Bit group: Selection of the bit group Val: Assign a value to the bit group selected
5-32
Visualisation
Creating Project Data 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. The settings are taken over via the OK button, and the Extra parameters dialogue box is closed.
taking over settings
5-33
Visualisation
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. An additional hint text can be assigned to an exceeding of a limit. The assignment is performed as described above.
hints
5-34
Visualisation picture change
Creating Project Data 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. 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. Reserved for future expansions. Currently not in use. 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. The settings are taken over via the OK button, and the Extra parameters dialogue box is closed. 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. Now the new process items must be activated via the function Driver...? Initialise serial interface ? Execute.
user flags
control value units up to priority
taking over settings OK
initialise serial interface
5-35
Visualisation
6 Creating Pictures
6.1 Working with Pictures
general menu items new picture open picture A picture is a drawing sheet on which static background pictures and dynamic variables can be placed. If a project has been opened, the following items are displayed in the Pictures menu: An empty picture named noname is opened. 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. The picture currently loaded is saved under its name.
save picture
6-1
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.
6-2
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. The following file formats are supported by Visualisation instabus: BMP RLE DIB DRW MAC PIC 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:
file formats
import file
Select the desired graphics format of the graphics file with Format.
6-3
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 Settings? Background colours: selected by
Additionally the Focus setup (i.e. marking of the most recently performed operation) can be set: focus colour focus invert The focus frame will have a fixed colour. 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. The focus frame will be displayed flashing. OK takes over the settings.
focus flashing OK
6-4
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 the dialogue box with the Close button. 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.
close drawing tools
6-5
Visualisation
6.4 Working with the Drawing Tools

draw line In the Draw menu the following tools are available: 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. 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. Same procedure as described under rounded rectangle. 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. 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. The polyline is finished by clicking on the starting point of the polyline (? a closed figure is generated). If you want to draw an open polyline, the function is completed by pressing the enter key. Same procedure as described under ellipse.
rectangle
rounded rectangle ellipse
polyline
closed open Circle
6-6
Visualisation arc text Same procedure as described under line. 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 font Cancels text entry. On pressing the button, the following dialogue box is displayed:
Select desired font, style and size. OK cancel Take over settings with OK. Cancels the current activity. Note: If you want to cancel the selecting of the drawing tools, press the ESC button.
6-7
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 closes the dialogue box. The selected settings are used as defaults for new drawings.
close save
6-8
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 fourfold 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. 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.
move line points
6-9
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: selection frame 1. Multiple Selection with Selection Frame (Lasso) 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 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 If all existing elements are to be marked, select menu item Edit? Select all. All existing elements are marked. With the key combination SHIFT+ESC all selected elements will be deselected.
CTRL key
select all
note
6-10
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: copy / insert 1. Via the Edit menu 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 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 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.
shift key
duplicate
6-11
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 generated, 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.
6-12
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: Mark the element to be deleted. Select the Delete item from the Edit menu ? element is removed from the drawing area. The element is not copied into the clipboard. the
delete
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. Mark the elements to be combined. Select the Combine item from the Change menu. Mark the desired block and select the item from the Change menu.
combine split
6-13
Visualisation
6.11 Rotating/Mirroring Elements

description rotate There are two different functions in the Change menu to modify elements later on: 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 Settings? Rotation: is defined in the menu
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.
6-14
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. 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. 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)
sequence
object locks
6-15
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. 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.
status line
.......
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.
6-16
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 show grid snap to grid Objects can only be moved horizontally and vertically, connecting lines are drawn right-angled. The grid markers are displayed on the working sheet. All objects and intermediate points of connections can only be moved according to the grid spacing. The Undo function in the Edit menu cancels the most recently performed activity.
Undo
6-17
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. The following dialogue box Services? Insert variable: is displayed via
insert variables
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.
7-1
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 coordinates.
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:
7-2
Visualisation
7.2 Output Variable (EIB Library)
normal description
text extra
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. To select the panel size. To select the frame width of the variable. To define the type of representation of the switching area.
panel frame key
7-3
Visualisation font text dialogue type To define the size and the type of the font for labelling the output variable. Definition of the text which is to be displayed in the output variable. 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.
7-4
Visualisation ?? Combo box:
The value to be transmitted is selected from a combo box and will be transmitted by pressing the OK button. border invisible An extra frame for the symbol can be activated. 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. 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. By selecting the according object (text, background) and the desired colour the symbols colour can be changed. Indicates from which users 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).
fixed value
colour privilege level
7-5
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.
7-6
Visualisation frame filling font indication area border colour To select the frame width of the variable. Setting of the graphic display mode of the bar. To select the size and the type of the font for labelling the bar variable. Definition of the range of values for minimum and maximum bar size. An extra frame for the symbol can be activated. By selecting the according object (background, max, ...) and the desired colour, the colour of the symbol can be changed.
7-7
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 axis
Serves for selecting the frame width of the variable. Here the desired legend for the vertical axis can be entered.
7-8
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 Here the text for the title of the diagram can be entered. 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. Indicates the sampling rate at which the values are to be displayed (minimum time interval: 5 seconds). 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).
title line
sampling rate display length
7-9
Visualisation
7.5 Picture Variable (EIB Library)
normal description
text extra
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. To select the panel size. To select the frame width of the variable. Here the type of representation of the switching area can be selected. To define the size and the type of the font for labelling the picture variable.
panel frame height font
7-10
Visualisation text switch to picture no. Definition of the text which is to be displayed in the picture variable. 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 socalled hidden switches. Thus it is possible to switch to another screen when you click on any symbol covered by an invisible picture variable. By selecting the according object (text, background colour) and the desired colour, the colour of the symbol can be changed. Indicates from which users privilege level on this picture variable can be used.
colour
privilege level
7-11
Visualisation
7.6 Meter Variable (EIB Library)
with zone LEDs description
without zone LEDs
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 frame font
To select the panel size. To select the frame width of the variable. To define the size and the type of the font for labelling (scaling, text) the meter variable.
7-12
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. Entry of text which is to be displayed in the meter variable. Here the number of scale markings must be entered. The minimum number is 2. 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 field11 would have to be entered in this case. An extra frame for the symbol can be activated. When this item is activated, three LEDs indicate, whether there is an exceeding of the range or not: left LED middle LED right LED smaller than minimum normal greater than maximum
text scale lines scale text
border zone LEDs
colour
By selecting the relevant object (text, background,...) and the desired colour, the colour of the symbol can be changed.
7-13
Visualisation
7.7 Symbol Variable (EIB Library)
Window shade: description
open
closed
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
7-14
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. The symbol or the colour field can be displayed as flashing in order to draw the operators attention to a certain state (e.g. OPEN). 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. 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.
flashing
variation of graphics size
variation of size
7-15
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 frame font alignment border flashing colour
To select the panel size. To select the frame width of the variable. To define the size and the type of the font for labelling the text variable. Definition whether the text inside the text variable shall be left-justified, centred or right-justified. An extra frame for the symbol can be activated. The text variable is displayed as flashing in order to draw the operators attention to a certain state. By selecting the relevant object (text, background,...) and the desired colour the colour of the text variable can be changed.
7-16
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.
panel frame font selecting fields
To select the panel size. To select the frame width of the variable. To define the size and the type of the font for labelling the state variable. 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.
7-17
Visualisation field The desired bit group is selected from the Field combo box. The colour selection for text and background or a flashing representation (see below) is always related to the bit group selected here. If a certain field is not to be displayed in the variable, it can be deactivated or activated via the Show field item. An extra frame for the symbol can be activated. The state variable can be displayed as flashing in order to draw the operators attention to a certain state (flashing is always related to the bit group selected under Field, but not to the variable as a whole). 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).
show field border flashing
colour
7-18
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 frame font

.
To select the panel size. To select the frame width of the variable. To define the size and the type of the font for labelling the switch variable 7-19
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. The variable will be displayed flashing for the selected state. The variable will be adjusted to the dimensions of the graphic for the selected state. The graphic will be adjusted to the dimensions of the variable for the selected state. In this section the function of the switch variable is adjusted. 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. The following activities are performed if the switch variable is operated: 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.
flashing adjust graphic adjust variable button mode switchbutton
pushbutton toggle value
7-20
Visualisation fixed value on key pressed on key released 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. 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. 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). 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. 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. 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 background shows through all parts of the pixel graphics having the transparent colour defined. The switch variable can be made invisible to realise so-called invisible switches. If this function is activated, the graphics in the switch variable is displayed in transparent mode. For setting the transparent colour see colour. An extra frame for the symbol can be activated.
Start: pic
programme
add-on
colour
extras: invisible transparent
border
7-21
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.
7-22
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) Blinking (Warning) Border Privilege At the alarm crossing the limit, the variable will flash up At the warning crossing the limit, the variable will flash up. A black outline will frame the variable. 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. panel frame font To select the panel size. To select the frame width of the variable. To define the size and the type of the font for labelling the text.
7-23
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.
7-24
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.
7-25
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.
panel frame font colour Extras: Rand (border)
To select the panel size. To select the frame width of the variable. To define the size and the type of the font for labelling the week variable. Here the colours for text, background, etc. are selected.
An extra border of the variable can be activated.
7-26
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.
7-27
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).
panel frame font
To select the panel size. To select the frame width of the variable. To define the size and the type of the font for labelling the video variable.
7-28
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. 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. In this section individual features of the variable can be adjusted: 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. An extra border of the observer can be activated. Indicates from which users privilege level on this observer variable can be used. By selecting the according object (text, background) and the desired colour, the display of the variable can be changed.
global frame rate
extras ON/OFF switch
border privilege level colour
7-29
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). To select the panel size.
panel
7-30
Visualisation frame video file To select the frame width of the variable. 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). To define the size and the type of the font for labelling the video variable. In this section the available video sources are listed and the settings of the driver are defined (cf. explanations under observer). In this section individual features of the variable can be adjusted: 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. With this function a hidden switch can be realised. An extra border of the recorder can be activated. 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. 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. Indicates from which users privilege level on this recorder variable can be used.
font video source
extras ON/OFF switch
invisible border sound
record status display
privilege level
7-31
Visualisation colours video file/ video data base By selecting the according object (text, background) and the desired colour, the display of the variable can be changed. 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. 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 cards manual for detailed information. Here the length of the video to be recorded is defined (in seconds). 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. 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.
directory
video length frames per second
process connection
7-32
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.
7-33
Visualisation panel frame video file To select the panel size. To select the frame width of the variable. 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). In this section individual features of the variable can be adjusted: 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 playback of the film from current position playback of the film from the start stop playback fast forward from current position rewind from current position delete buttons data base start of the selected film of the video data base play all films of the database in sequence stop playback load next film of the video data base load previous film of the video data base
extras playback 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.
7-34
Visualisation sound adjust video frame by frame display If a sound card is installed, the sound of the film will also be the played if this function is activated. If this function is activated, the image size of the video will be adjusted to the size of the variable. 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. 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. 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, 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.
exclusive mode
refresh after
video file/ video data base
7-35
Visualisation directory process connection Here the directory containing the AVI file or the video data base to be played is to be entered. 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.
7-36
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 programme 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) 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. Definition of the recording time in seconds (default: 5). Number of frames per second to be recorded (default: 15). Activation of sound recording with 1. With 0 no sound will be recorded.
iStartStop
iMaxTime iFramesPerSec iSound
7-37
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 display process items A process item must now be assigned to the image variable. Available process items are listed via the menu item Services? Assign process items:
7-38
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. 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 in the status line
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).
7-39
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.
8-1
Visualisation
8.2 Simulating the Visualisation

general system configuration If you are not on site and therefore the bus system is unavailable to you, you can simulate your project. 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 enable simulation disable simulation
select topic EIB Parameters and subtopic Simulation mode. Select Yes from the combo box and take it over via the Set button. Select No from the combo box and take it over via the Set button.
8-2
Visualisation simulation settings simul. telegram rate
The following additional settings can be made for the simulation: 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. Number of telegrams which are to be simulated within one cycle. Input range: 0 up to 10 telegrams.
simul. telegram count
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 ( ).
8-3
Visualisation
8.3 Password Protection of Project

define password Close all pictures and the project itself. Call menu item System administration? User profile setup.
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 users 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.
8-4
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. 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. With the menu item Standard switches you can define whether the status line is automatically switched on or off. 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.
standard settings
standard switches setup
8-5
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
8-6
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: To do this, in the PP.INI file in the VISUALIS subdirectory 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.
attention, only for specialists
8-7
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: 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 start of WINDOWS
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.
8-8
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. 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.
automatic start of a picture
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.
8-9
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). 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.
setting
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.
8-10
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) 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 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:
priority of the event
logging which events?
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).
8-11
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 ( window is reduced to its original size.
) the message
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.
8-12
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 default Set takes over the adjusted value. The default value (= 12) can be recalled via the Default button. The programme is terminated via Close in the system menu ( ).
8-13
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.
8-14
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 OK OK takes over the settings. Active.
8-15
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. 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.
disable printer
8-16
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
8-17
Visualisation control: &L &C &R = print out following text left justified = print out following text centred = 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: variables: && &K &B &P &F &D11 &U8 &P27 &V10 &Z20 enclosed in ..., e.g. : = & character = name of the computer = name of the user = data type: process item = error number = represent date e.g. with 11 chars = represent time e.g. with 8 chars = represent process item name with 27 characters = represent value of the process item with 10 digits = 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)
8-18
Visualisation ?? Other text format Here it is defined how general messages and system messages are to be printed: fixed text: variables : &D11 &U8 &T59 enclosed in ..., e.g. : =represent date e.g. with 11 chars = represent time e.g. with 8 chars = represent system messages with 59 characters
text format
The default setting is: &D11&U8: &T59 (i.e. date time : system_message) message text width ?? Maximum message text width Here the number of characters per line is defined : minimum number: maximum number: default value: messages per page 40 characters 128 characters 80 characters
?? Maximum number of message lines per page: Here the number of lines per page is defined: minimum number: maximum number: default value: 20 lines 255 lines 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.
8-19
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/Commands 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:
8-20
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. The audible alarm can be acknowledged via the system menu ( ) signal off or via the right corner of the screen. button in the lower
acknowledge
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 network event programme running
sending to bus
follow up time jobs event monitor
scheduler programme running receiving from bus receiving from network
Loudspeaker button
Audible signal: An audible signal can be acknowledged with this button (same function as Signal off in the system menu). 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. 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.
Time button
exclamation mark button
8-21
Visualisation LED SB SB - sending to bus: Visual check whether the Visualisation is sending telegrams to the bus. RB - receiving from bus: Visual check whether the Visualisation is receiving telegrams from the bus. SN - sending to network (optional): Visual check whether the Visualisation information via the PC network. RN - receiving from network (optional): Visual check whether the Visualisation information via the PC network. is sending
LED RB
LED SN
LED RN
is
receiving
LED EP
EP - event programme running: Visual check whether an event programme has been started triggered by an event. TP - scheduler programme running (optional): Visual check whether an event programme has been started by the scheduler.
LED TP
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.
8-22
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. 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. 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.
TS off
sequence
8-23
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.
8-24
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.
8-25
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). 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.
call
project to be exported export to
Selection of the project to be exported. Selection of the drive: DISK1: drive A DISK2: drive B When this option is selected, data is stored on disk in a compressed form. The Action and Export process bars indicate the exporting process.
compress
9-1
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: 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. Individual graphics files of all graphics formats supported can be exported/imported. The functions are called with the project open via Project? Import... (Export...)? Pictures (Files, Texts).
pictures
files call
9-2
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. 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:
picture related lists
Select the desired lists and start printout procedure via OK.
9-3
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.
9-4
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. 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:
print data types
9-5
Visualisation selection In the Selection section the data types to be printed out are selected. Print All is activated by default. 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 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). The contents of the list is sorted according to the selected feature (type, date, name). Default setting: name. If this function is selected, a separate page is printed out for each data type containing all details. 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. Printout of the data types. The button can only be accessed if the Prepare button has been pressed before. 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. Closes the dialogue box.
name mask
changes since
print includes, sort order detail prepare
print configure printer
done
9-6
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 name mask changes since list of groups
Selection of the process items to be printed out (as in Print data types, see above) As in Print data types, see above. As in Print data types, see above. 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. As in Print data types, see above.
list includes, sort order
9-7
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 prepare print configure printer done
A separate page with all details is printed out for each process item. As in Print data types, see above. As in Print data types, see above. As in Print data types, see above. Closes the dialogue box.
9-8
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.
10-1
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.
10-2
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.
11-1
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
11-2
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.
12-1
Visualisation
12.2 Programme Editor

description call The programme editor is used to create event programmes which can be started via an event or via the scheduler. 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
12-2
Visualisation The menu bar offers the following functions (the most important items are also available directly via the symbol buttons): file edit Here programmes created can be saved, loaded, imported, exported, deleted or printed. 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. Here the desired font can be selected. 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 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. 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.
options windows
compile
start
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 ).
12-3
Visualisation commentaries Commentaries (for better understanding of the programme) must be enclosed in /* */ (e.g.: /*commentary*/). 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. 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)
process items
drag & drop
12-4
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. programme the event programme option can be disabled by setting the Event programmes subtopic under the AddOns 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. Siemens instabus EIB 12-5
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). 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! If an event programme processes a delay statement, it stops as long as has been defined in the delay statements 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! 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! 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. 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.
endless loops
delay
accuracy of delay times
reaction time
display: event prog. running
12-6
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 crossreference 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.
12-7
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. 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. 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! applications
programming language
13-1
Visualisation
13.1 Instruction Set

Variables description names of variables types of variables Within an event programme variables can be used in order to simplify the programme and to reduce telegram traffic. The name of a variable may be up to 32 characters long and must start with a character or an underscore sign. 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. int Lamp1; real Lamp2; (defines Lamp1 as integer variable) (defines Lamp2 as floating point variable).
example INT variables REAL variables
INT variables (integer numbers) have a range of values from 0 up to +-2147483647. 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.
13-2
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) current day of the current month (1-31) current month (1-12) current year (e.g.: 1994) current week of the year (1-52) current time (e.g.: 1309, first the hours, then the minutes without separating character) number of error after accessing a process item (0-not error)
day of the month monthday month year calendar week time error month year week time
ERROR
PI, e constants
Constants PI ................ the value 3.141592654 E ................. the value 2.718281828 Labels Labels can be addressed by goto or gosub commands. The structure of a label is as follows: L.any characters or numbers: (remember termination by colon!)
description syntax
example of a little loop: i=0; L.Start: i=i+1; if (i<<10) goto L.Start;
13-3
Visualisation Logic Operators logic operators AND OR NOT and operation or operation 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 deg sin cos (d) (r) (r) (r) converts degrees (d) into radians converts radians (r) into degrees calculates the sine of r (radians) calculates the cosine of r (radians)
13-4
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 (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;}
if statement
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 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
gosub
13-5
Visualisation Set/Read User Flags setflag($"ProcessItem",FlagNumber,Status); Sets the addressed user flag of a process item to the desired status. Status=getflag($"ProcessItem",FlagNumber); Reads the status of the according user flag of the process item. Initialise Process Item / Process Item Status Check 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. 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 (x); Loads the picture with the number x
setflag
getflag
initstate
getstate
picture play
Play Wave File play (ding.wav); Plays a wave file (.WAV), only possible with a sound card!
13-6
Visualisation Audible Signal beep; Starts the PC beeper. It beeps until it is acknowledged by the operator. Printing Texts/Variables 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; 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 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");
beep
print
end
application
13-7
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:
13-8
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.
13-9
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.
13-10
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.
13-11
Visualisation
14 The Time Manager Option

14.1 Features
description system clock day / time settings The Time Manager of the Visualisation instabus is a multifunctional time switch on PC base. The PC internal system clock is the basis for date and time. 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. A job may be: ?? starting pictures ?? displaying hint texts ?? enabling/disabling printer ?? starting event programmes ?? executing process-item commands 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).
kinds of jobs
week variable
14-1
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: mode 2: mode 3: mode 4: edit day programmes set day programmes display parameterise week variables
The appropriate mode is called by pressing the buttons at the top line of the screen. 14-2 Siemens instabus EIB
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.
14-3
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.
14-4
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. Start Pic Here all event programmes available are listed which can be called via the time manager. Here all the pictures of the Visualisation are listed which can be called via the time manager.
14-5
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).
14-6
Visualisation
14.3.3 Copying/Deleting Time or Jobs

description duplicate time / jobs Times and jobs within one day can be copied or deleted using the following functions: 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:
14-7
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.
14-8
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.
14-9
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. 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.
save day programmes
14-10
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.
14-11
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: 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.
calling the editor
14-12
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. 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.
week day
14-13
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.
14-14
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).
14-15
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.
14-16
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.
14-17
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. After the Print button has been pressed, the current list of assignments is being printed via the standard printer.
print
14-18
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.
14-19
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. 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.
Jobs of the old time manager
14-20
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.
14-21
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 DisplayOptions
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.
14-22
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. 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.
print
14-23
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.
14-24
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.
14-25
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.
14-26
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. 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.
close
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.
14-27
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.
14-28
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 set system clock
The time manager uses the internal PC system clock as a basis for the processing of the time jobs! 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. Please check whether date and time of the PC are set correctly. Adjust it, if necessary! 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!
attention type of processor
14-29
Visualisation
15 The Value Recorder Option

description The value recorder option is a replacement for a dottedline 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. The data stored on the hard disk can be displayed on the screen as diagrams (lines, bars, two-dimensional, threedimensional), 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. 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. 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.
evaluation
cycle time
record length
15-1
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. 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. 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. A stored group can also be completely exported to EXCEL V and can be processed and displayed there.
track
interrupts
EXCEL V
15-2
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 settings display options close
The different functions are called via the menu bar in the lower part of the screen. To parameterise the desired groups. To select the group to be displayed. To print the recorded data or to convert data to the EXCEL format. To close the value recorder window.
15-3
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: ?? ?? ?? ?? ?? procedure group name record length cycle time tracks total/used active/inactive
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)
15-4
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.
15-5
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.
15-6
Visualisation
15.6 Defining Tracks

description Now for all groups the tracks to be recorded are to be defined: max. number in group 1 : max. number in group 2 : max. number in groups 3 to 32: 8 tracks 16 tracks 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 ? 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. the Track parameters
15-7
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.
15-8
Visualisation
15.8 Deleting Existing Tracks

description procedure If individual tracks or all tracks of a group are to be deleted, perform the following steps: 1.) Mark the group tracks which are to be deleted by doubleclicking on them in the Recording Settings menu. 2.) Press the edit... button ? menu will be displayed. the Track parameters
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.
15-9
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.
15-10
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.
15-11
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. Display as a line diagram:
line diagram
line diagram (filled)
Display as a line diagram (filled) :
15-12
Visualisation area diagram Display as an area diagram:
area diagram (filled)
Display as an area diagram (filled):
15-13
Visualisation bar diagram Display as a bar diagram:
bar diagram (overlapping)
Display as a bar diagram (overlapping):
15-14
Visualisation stack diagram Display as a stack diagram:
stack diagram (overlapping)
Display as a stackdiagram (overlapping):
15-15
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.
15-16
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:
15-17
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:
15-18
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 ? dialogue box will be displayed: the Save Settings
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:
15-19
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.
15-20
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. description Ruler line 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.
15-21
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.
15-22
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) 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:
description
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.
15-23
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:
15-24
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 (no zooming). button, all data will be displayed again
update display
Updating 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.
15-25
Visualisation If the button is pressed, the minimum and maximum values are no longer displayed:
By using the original display. brief information b)
button you can switch back to the
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 buttons. and
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 buttons. and
15-26
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
15-27
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. 1.) The options dialogue box is called via the Options menu item:
procedure
2.) Enter the desired file name under which the current display is to be saved. 3.) Start the exporting procedure with the Export button.
15-28
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 Open the options dialogue with the Options menu item. Mark the desired type of printout under Print data: for a hardcopy of the screen for a textual listing
procedure
? ?
Graphic display 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. 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.
procedure
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.
15-29
Visualisation
16 The Event Monitoring Option

16.1 Features
description evaluation With event monitoring you can log all the events configured in the Visualisation. 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.
16-1
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.
16-2
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. 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.
acknowledging all events
16-3
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:
16-4
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.
16-5
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.
16-6
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.
16-7
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.
16-8
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:
16-9
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. The individual filters are activated by marking the box next to the appropriate filter.
activate filters
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.
16-10
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:
16-11
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:
16-12
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. 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:
table
switch over to text display
If you click on this icon, it will switch back to the normal textual display of the events.
16-13
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.
16-14
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:
16-15
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:
16-16
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 acknowledged are printed out as a text list (= lower table on the screen).
print Close
Pressing the Print button starts the printing process. 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:
16-17
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:
16-18
Visualisation event files export directory compress Under Event files all existing event files are listed. The data to be exported is defined by marking the desired file. Under Export directory it is selected to which drive and path the data is to be exported. If Compress is selected, the data are exported in a compressed form. This setting is recommended when you export to disk. Execute starts the exporting procedure. Pressing Delete deletes the marked event file. The window is closed by clicking on the Close button. If the Import event file button is pressed, a window will be displayed in which the data base to be imported can be selected:
execute delete close import data
16-19
Visualisation Import directory event files execute close
Under Import directory you can select the drive and path where the event file is located. Under Event files all event files of the selected directory and path are listed. Execute starts the importing procedure. 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. 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.
procedure
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.
16-20
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 NUInterface (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 available) Ask your network administrator about these values, if necessary.
17-1
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. 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 128..191 192..254 type A-network type B-network type C-network
addressing
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.
17-2
Visualisation
The Network Option 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 socalled 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 IPaddress. The DNS, if available, has to be mentioned while the network is being configured.
17-3
The Network Option
Visualisation
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 IPaddress. 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-4
Visualisation
The Network Option
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-5
The Network Option
Visualisation
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. Open the project in question. Select the menu option process items process items...
configuration
Select the network functions in the following dialogue:
17-6
Visualisation
The Network Option 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-7
The Network Option
Visualisation
17.5 Editing Box

display name unique server Id primary IP-address secondary IP-address Name which can be selected as a computer name for a process item in the process item dialogue. Number from 1..1024, which parameterised server. clearly identifies the
IP address or symbolic name of the server. IP address or symbolic name of an emergency server in case the primary one fails. Only possible with the option redundancy. Adds this parameterisation or changes an existing entry. Deletes the selected registration in the list of the registered visualisation servers.
add remove
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-8
Visualisation
The Network Option
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
The Network Option
Visualisation
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
Visualisation
The Network Option
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
The Network Option
Visualisation
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. Select the programme NU Tool from the start menu or the programme group "Visualisation instabus" and start it with a double click.
starting NU Tool
note:
The Siemens visualisation instabus EIB "must not be running" at that time.
17-12
Visualisation The opening screen appears next.
The Network Option
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 convert project merge projects about close See also chapter 17.12 ff. Converting an old project. Merges projects from different "partial worlds". Information on the system. Closes the programme.
17-13
The Network Option
Visualisation
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.
17-14
Visualisation
The Network Option 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 unique server Id. primary IP-address Secondary IP-address Name which can be selected as a computer name for a process item in the process item dialogue. Number from 1..1024, which parameterised server. clearly identifies the
IP address or symbolic name of the server. IP address or symbolic name of an emergency server in case the primary one fails. Only possible with the option redundancy. Adds this parameterisation or changes an existing entry. Deletes the selected registration in the list of the registered visualisation servers.
add remove
17-15
The Network Option
Visualisation
available visualisation server
List of the Registered Visualisation Servers

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... unique server Id... This computer is a server, i.e. it is connected with the instabus EIB and provides process items. Unique server Id or this computer. This number is listed in the list of the visualisation servers.
17-16
Visualisation
The Network Option
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.
17-17
The Network Option
Visualisation
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.
17-18
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.
18-1
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.
18-2
Visualisation
Option Counter/Consumption Statistics" In the option Extras the following functions can be activated:
blinking (alarm) blinking (warning) border privilege
Along with the alarm indication crossing the limit, the variable will flash up. Along with the warning indicating crossing the limit, the variable will flash up. A black outline will frame the variable. 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
Visualisation
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.
18-4
Visualisation
Option Counter/Consumption Statistics" 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. 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.
attention
18-5
Visualisation
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: A window opens up in which you determine which of the process items you generally want to select for the statistics.
management
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.
18-6
Visualisation
Option Counter/Consumption Statistics" 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 delete
By clicking the button "Save" on the right side you can save such a filtering list. By clicking the button "Delete" you can delete a chosen list.
18-7
Option Counter/Consumption Statistics" display
Visualisation
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 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.
week statistic
18-8
Visualisation month statistic year statistic
Month statistic display: Here you enter the numbers for the month and the year respectively. 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.
18-9
Option Counter/Consumption Statistics" options
Visualisation
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-10
Visualisation
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-11
Visualisation
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, soto-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-12
Visualisation
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. "STATISTIC" (type, "process item list", "resolution", "unit", "path"); number between 0 and 10 0: 1: 2: 3 4 5 6 7 8 9 10 process item list IP-Values (all process items with current values and limiting values) Day statistic - (current day) Day statistic IP-Values Week statistic - (current week) Week statistic - IP-Values Month statistic - (current day) Month statistic - IP-Values Year statistic - (current year in months) Year statistic - IP-Values (in months) Year statistic - (current years in days) Year statistic - IP-Values (in days)
command type
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 ("").
18-13
Option Counter/Consumption Statistics" resolution Number between 0 and 2 0: 1: 2: unit path Printing values without conversion Resolution by minutes (value/60) Resolution by hours (value/3600)
Visualisation
Additional unit text in quotation marks (e.g., "HELLO"). "" mean no unit. 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)
18-14
Visualisation 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.
18-15
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:
19-1
Auxiliary Programmes The File Menu Select project Exit programme About The Interface Menu Parameters Open Close The Services Menu Device-
Visualisation
Displays the window for project selection (as with programme start). Exits the programme. Displays name and version number of the programme. To set the interface parameters (see also Chapter 4 Take Over Bus Device Data). Establishes connection between PC and bus. Cancels bus connection. 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.
19-2
Visualisation Status applications Counter parameter
Auxiliary Programmes With this item the list of objects to be cyclically polled can be edited. 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 Start group address
In the menu you can select Counter, Counter limit, and Counter alarm. Here you enter the group address (e.g. 1/1/7).
19-3
Auxiliary Programmes Step size Example
Visualisation Is dependent on the setting of the group address. Step size 1 Channe1 9/1 9/4 9/7 Step size 3 Counter Counter limit Counter alarm Channel 1 9/1 9/2 9/3 Channel 2 9/4 9/5 9/6 Channel 3 9/7 9/8 9/9 Channel 2 9/2 9/5 9/8 Channel 3 9/3 9/6 9/9
Counter Counter limit Counter alarm
Object count Add Remove Create system files
The number of the objects equals the number of the counters. Via Add the settings are taken over into the list. Via Remove one or several settings can be removed. 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).
19-4
Visualisation 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. Takes over the complete project include all data. Takes over the ETS commentary for the individual group addresses. Takes over the ETS commentary for the individual devices. 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)
Read Complete project Read group texts Read device texts Read device data
19-5
Visualisation
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. Saves the programme versions read and, if necessary, the contents of the system files as a text file under a name to be entered. Prints out the programme versions read and, if necessary, the contents of the system files on the default printer. Exits the programme.
Save as
Print Exit The Options Menu Options
To select the system files to be added to the text file:
19-6
Visualisation
Scan versions
Reads the versions of the programmes installed of the Visualisation instabus and displays them in the programme window:
Copy Tool bar
Copies the contents of the programme window into the Windows clipboard. 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-7
Visualisation
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. The system configuration window is subdivided into three areas:
Programme structure
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. In the help area a short description of the topic selected is displayed.
help area
19-8
Visualisation setting area
Auxiliary Programmes 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. 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. 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. global, text entry Here the format for system messages is defined. For control characters and variables see Chapter 8 Other Functions: Print Event Messages.
Page header format
Message text format
Other text format
19-9
Auxiliary Programmes Maximum message text width
Visualisation
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. 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. global, range: yes / no, standard: yes Locking of the task switch possibility of Windows (e.g. Alt+Tab). project related, range: yes / no, default: yes Enable or disable display of the picture number in the picture selection dialogue. 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).
Save messages to file
Programme protection
Show picture numbers
Picture sorting
19-10
Visualisation Backup of system files
project related, range: yes/no, default: no Defines whether backup files are automatically to be generated. 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. 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.
Variables info window
Alarm sound file
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.
19-11
Auxiliary Programmes Picture redraw mode
Visualisation
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). 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.
Privilege (variables)
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 pictures 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.
19-12
Visualisation 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. 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 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
ETS 2.x
ETS version
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.
19-13
Auxiliary Programmes The Start-Up Programme Topic List of the startup programmes
Visualisation
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.
19-14
Visualisation 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. global, range: 0 up to 10, default: 3 with this parameter the number of telegrams per cycle can be set. 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 drivers write mode for groups which can be read back. Explanation see Chapter 2 Notes on the Visualisation. 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.
Simul. telegram count
Driver write mode
Mirror groups
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).
19-15
Auxiliary Programmes Picture update rate
Visualisation
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. 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.
Device failure beep
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 19-16 Siemens instabus EIB
Visualisation Event monitor save mode
Add-ons font
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. 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. project related, range: yes/no default: no setting With yes the counter values can be increased manually.
Enlargement of counter value
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.
19-17
Visualisation
Predefined Texts
20 Predefined Texts
20.1 Unit Texts
No. 1 3 5 7 9 11 13 15 17 19 21 23 25 27 29 31 33 35 37 39 41 43 45 47 49 51 Unit Km cm um t gr C K pas bar sqkm sqmm cdm h sec us day(s) year(s)) V KA mA KW mW KJ mJ % m/s No. 2 4 6 8 10 12 14 16 18 20 22 24 26 28 30 32 34 36 38 40 42 44 46 48 50 52 Unit m mm nm kg mg F hpas mpas mbar sqm cbm ccm min ms ns month(s) KV mV A MW W MJ J Lux K/h
20-1
Predefined Texts
Visualisation
20.2 Status Texts

No. 1 3 5 7 9 11 13 15 17 19 21 23 25 27 29 31 33 35 37 39 41 43 45 47 49 51 53 55 57 59 61 63 Text alarm fire alarm gas alarm techn. alarm danger warning phase loss low limit high limit alarm high limit warn off on 1 on 3 automatic full open unlocked start up forward next winter mode night operation cooler mode start position initialisation right normal present passive slow fast No. 2 4 6 8 10 12 14 16 18 20 22 24 26 28 30 32 34 36 38 40 42 44 46 48 50 52 54 56 58 60 62 64 Text break-in alarm frost alarm oil alarm water alarm failure maintenance power loss high limit low limit alarm low limit warn on on 2 manual empty closed locked stop down backwards previous summer mode day operation heating mode out of operation end position optimisation left abnormal not present active medium bottom
20-2
Visualisation No. 65 67 69 71 73 75 77 79 81 83 85 87 89 91 93 95 97 99 101 103 105 107 109 111 113 115 117 119 121 400 402 404 Text centre pause position middle position heating cooling normal operation power sav. oper stand-by oper. blind down blind up slats opened curtain stop roller bl. down roller bl. up screen stop stage 0 stage 2 stage 4 stage 6 stage 8 inconsistent in operation open deeper darker on STANDBY FROST PROT. controller off LV alarm low normal LV alarm high No. 66 68 70 72 74 76 78 80 82 84 86 88 90 92 94 96 98 100 102 104 106 108 110 112 114 116 118 120 122 401 403
Predefined Texts Text top start position end position neutral night depression heating oper. frost protection comfort oper. blind stop slats closed curtain closed curtain opened roller bl. stop screen down screen up stage 1 stage 3 stage 5 stage 7 stage 9 dew point alarm oper. position close higher lighter COMFORT NIGHT DEW POINT controller on LV warning low LV warning high
20-3
Predefined Texts
Visualisation
20.3 Status Lists

List : present/not pr Value : 0 text(0058): Value : 1 text(0057): List : down-/upwards Value : 0 text(0036): Value : 1 text(0037): List : down/up Value : Value : 0 text(0036): 1 text(0037): not present present downwards upwards downwards upwards downwards stop upwards alarm on off on start position end position start position middle pos. end position upwards downwards
List : down/stop/up Value : -1 text(0036): Value : 0 text(0034): Value : 1 text(0037): List : alarm Value : List : on Value : List : on/off Value : Value : 1 text(0001): 1 text(0115): 0 text(0021): 1 text(0115):
List : start/end pos. Value : 0 text(0049): Value : 1 text(0050): List : start/mid/end pos. Value : -1 text(0068) Value : 0 text(0069): Value : 1 text(0070): List : up-/downwards Value : 0 text(0037): Value : 1 text(0036):
20-4
Visualisation List : up/down Value : Value :
Predefined Texts
0 text(0037): 1 text(0036):
upwards downwards open closed off stage 1 stage 2 off stage 1 stage 2 stage 3 off stage 1 out of oper. in operation off on off on 1 on 2 off on 1 on 2 on 3
List : open/closed Value : 0 text(0031): Value : 1 text(0030): List : off/stage 1/2 Value : 0 text(0021): Value : 1 text(0096): Value : 2 text(0097): List : off/stage 1/2/3 Value : 0 text(0021): Value : 1 text(0096): Value : 2 text(0097): Value : 3 text(0098): List : off/stage 1 Value : 0 text(0021): Value : 1 text(0096): List : out of/in oper. Value : 0 text(0048): Value : 1 text(0107): List : 1 stage comm. Value : 0 text(0021): Value : 1 text(0022): List : 2 stage comm. Value : 0 text(0021): Value : 1 text(0023): Value : 2 text(0024): List : 3 stage comm. Value : 0 text(0021): Value : 1 text(0023): Value : 2 text(0024): Value : 3 text(0025):
20-5
Predefined Texts List : dark/stop/light Value : -1 text(0113): Value : 0 text(0034): Value : 1 text(0114): List : darker Value : 1 text(0113):
Visualisation
darker stop lighter darker darker lighter break-in alarm pow.-sav. oper. fire alarm frost prot. op. night oper. pow.-sav- oper. comfort oper. frost prot. op. night oper. pow.-sav. oper. comfort oper. dew-point alarm frost alarm frost prot. op. gas alarm
List : darker/lighter Value : 0 text(0113): Value : 1 text(0114): List : break-in alarm Value : 1 text(0002): List : pow.-sav. oper. Value : 1 text(0077): List : fire alarm Value : 1 text(0003): List : fr/nght/ps/co Value : 0 text(0078): Value : 1 text(0045): Value : 2 text(0077): Value : 3 text(0080): List : fr/nght/sp/co/dp Value : 0 text(0078): Value : 1 text(0045): Value : 2 text(0077): Value : 3 text(0080): Value : 4 text(0106): List : frost alarm Value : 1 text(0004): List : frost protect. Value : 1 text(0078): List : gas alarm Value : 1 text(0005):
20-6
Visualisation List : danger Value :
Predefined Texts
1 text(0009):
danger closed open high limit alarm low limit alarm low limit alarm low limit warn normal high limit warn high limit alarm high limit warn low limit warn high limit low limit low limit normal high limit manual automatic heating mode cooling mode
List : closed/open Value : 0 text(0032): Value : 1 text(0033): List : high limit alarm Value : 1 text(0017): List : low limit alarm Value : 1 text(0018): List : limit alarm/warn Value : -2 text(0018): Value : -1 text(0020): Value : 0 text(0055): Value : 1 text(0019): Value : 2 text(0017): List : high limit warn Value : 1 text(0019): List : low limit warn Value : 1 text(0020): List : high limit Value : 1 text(0016): List : low limit Value : 1 text(0015):
List : limit exceed. Value : -1 text(0015): Value : 0 text(0055): Value : 1 text(0016): List : man./auto Value : 0 text(0026): Value : 1 text(0027): List : heating/cooling Value : 0 text(0046): Value : 1 text(0047):
20-7
Predefined Texts List : heat/neut/cool. Value : -1 text(0071): Value : 0 text(0072): Value : 1 text(0073): List : heating mode Value : 1 text(0046): List : heating Value : 1 text(0071):
Visualisation
heating neutral cooling heating mode heating heating cooling lighter higher initialisation comfort oper. cooling mode cooling slow fast empty full left right
List : heating/cooling Value : 0 text(0071): Value : 1 text(0073): List : lighter Value : List : higher Value : 1 text(0114): 1 text(0112):
List : initialisation Value : 1 text(0051): List : comfort oper. Value : 1 text(0080): List : cooling mode Value : 1 text(0047): List : cooling Value : 1 text(0073):
List : slow/fast Value : 0 text(0061): Value : 1 text(0063): List : empty/full Value : 0 text(0028): Value : 1 text(0029): List : left/right Value : Value : 0 text(0054): 1 text(0053):
20-8
Visualisation List : slow/med/fast Value : -1 text(0061): Value : 0 text(0062): Value : 1 text(0063): List : night/day oper. Value : 0 text(0045): Value : 1 text(0044): List : night depress. Value : 1 text(0074): List : normal/abnormal Value : 0 text(0055): Value : 1 text(0056): List : normal/heat Value : 0 text(0075): Value : 1 text(0076): List : open/closed Value : 0 text(0033): Value : 1 text(0032): List : open Value : 1 text(0109):
Predefined Texts
slow medium fast night operation day operation
night depress. normal abnormal normal oper. heating oper. open closed open open close oil alarm optimisation passive active phase loss
List : open/close Value : 0 text(0109): Value : 1 text(0110): List : oil alarm Value : 1 text(0006):
List : optimisation Value : 1 text(0052): List : passive/active Value : 0 text(0059): Value : 1 text(0060): List : phase loss Value : 1 text(0013):
20-9
Predefined Texts List : contr. on/off Value : 0 text(0121): Value : 1 text(0122): List : back-/forward Value : 0 text(0038): Value : 1 text(0039): List : pause/oper Value : 0 text(0067): Value : 1 text(0108): List : close Value : 1 text(0110):
Visualisation
controller off controller on backwards forward pause position operating pos. close summer mode winter mode standby mode stop start failure power loss stage 0 stage 1 stage 0 stage 1 stage 2
List : sum./wint. mode Value : 0 text(0042): Value : 1 text(0043): List : standby mode Value : 1 text(0079): List : stop/start Value : 0 text(0034): Value : 1 text(0035): List : failure Value : 1 text(0010):
List : power loss Value : 1 text(0014): List : stage 0/1 Value : 0 text(0095): Value : 1 text(0096): List : stage 0/1/2 Value : 0 text(0095): Value : 1 text(0096): Value : 2 text(0097):
20-10
Visualisation List : stage 0/1/2/3 Value : 0 text(0095): Value : 1 text(0096): Value : 2 text(0097): Value : 3 text(0098):
Predefined Texts
stage 0 stage 1 stage 2 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): Value : 1 text(0045): List : dew-point alarm Value : 1 text(0106): List : techn. alarm Value : 1 text(0007): List : deep/stop/high Value : -1 text(0111): Value : 0 text(0034): Value : 1 text(0112): List : deeper Value : 1 text(0111): day operation night operation dew-point alarm techn. alarm deeper stop higher deeper deeper higher bottom top bottom middle top warning
List : deeper/higher Value : 0 text(0111): Value : 1 text(0112): List : bottom/top Value : 0 text(0064): Value : 1 text(0066): List : bot./mid/top Value : -1 text(0064): Value : 0 text(0065): Value : 1 text(0066): List : warning Value : 1 text(0011):
20-11
Predefined Texts List : maintenance Value : 1 text(0012): List : water alarm Value : 1 text(0008): List : closed/opened Value : 0 text(0030): Value : 1 text(0031): List : cl/stop/opened Value : -1 text(0030): Value : 0 text(0034): Value : 1 text(0031): List : prev/next Value : 0 text(0040): Value : 1 text(0041):
Visualisation
maintenance water alarm closed opened closed stop opened previous next
20-12
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 Siemens instabus EIB 21-1
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
21-2
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
21-3
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
21-4
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
21-5
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 NUInterface ........................................................................................ 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
21-6
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
21-7
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 21-8 Siemens instabus EIB
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
21-9
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
21-10
Visualisation
Index
Z
Zone coupler .........................................................................................2-13 Zone line................................................................................................2-12 Zones ....................................................................................................2-12 Zooming ..............................................................................................15-25
21-11

Users Manual - Instabus EIB Visualization Software

Uploaded by

Document Information

Original Description:

Copyright

Available Formats

Share this document

Share or Embed Document

Sharing Options

Did you find this document useful?

Is this content inappropriate?

Copyright:

Available Formats

Users Manual - Instabus EIB Visualization Software

Uploaded by

Copyright:

Available Formats

Users Manual instabus EIB Visualisation Software

Siemens instabus EIB

Siemens instabus EIB

Siemens instabus EIB

Siemens instabus EIB

Siemens instabus EIB

Siemens instabus EIB

Siemens instabus EIB

true type fonts

Siemens instabus EIB

1.3 Screen Output

Siemens instabus EIB

1.4 The Graphic Card of a PC

Siemens instabus EIB

Hercules Graphic Card

colour graphic cards

Siemens instabus EIB

Siemens instabus EIB

1.5 Printer Output

printers impact non-impact

fully formed char. daisy wheel golf ball type basket

dot matrix laser ink jet thermo transfer

Siemens instabus EIB

1.6 Principles of Visualisation

Siemens instabus EIB

General static images

dynamic image elements

Siemens instabus EIB

1.7 Performance Characteristics of the Visualisation Building Services Management System

Central Display Requirements

Siemens instabus EIB

1.8 Features of the Visualisation Software

Siemens instabus EIB

1.9 Hardware and Software Requirements

memory capacity internal bus

monitor bus connection recommended hardware

Siemens instabus EIB

Siemens instabus EIB

1.10 Operator Input Release and Operator Process Communications

Siemens instabus EIB

1.11 Parameterisation of the Process Items

Siemens instabus EIB

1.12 Static Images

Siemens instabus EIB

1.13 Dynamic Image Elements

Siemens instabus EIB

Siemens instabus EIB

1.14 Image Display and Image Updating

Siemens instabus EIB

1.15 Printing out Logs and Event Messages

Siemens instabus EIB

1.16 Available Versions

Siemens instabus EIB

1.17 Additional Functions

Siemens instabus EIB

2 Notes on the Visualisation

Siemens instabus EIB

Siemens instabus EIB

Siemens instabus EIB

Visualisation status group address

2.2 Notes on Command Output with the Visualisation

Siemens instabus EIB

driver write mode