B&B Electronics VFG3000 User Manual

REV 1
FIELDBUS GATEWAY MANAGER USER MANUAL
Phone: (815) 433-5100
www.bb-elec.com
VFG1000/2000/3000-0310M
Copyright © 2010 B&B Electronics.
All Rights Reserved Worldwide.
The information contained herein is provided in good faith, but is subject to change without notice. It is supplied with no warranty whatsoever, and does not represent a commitment on the part of B&B Electronics. Companies, names and data used as examples herein are fictitious unless otherwise stated. No part of this document may be reproduced or transmitted in any form or by any means, electronic or mechanical, without the express written permission of B&B Electronics
All trademarks are acknowledged as the property of their respective owners.
TABLE OF CONTENTS
TABLE OF CONTENTS
GETTING STARTED ..........................................................................................1
SYSTEM REQUIREMENTS .................................................................................... 1
INSTALLING THE SOFTWARE ............................................................................... 1
CHECKING FOR UPDATES ................................................................................... 1
INSTALLING THE USB DRIVERS ........................................................................... 2
FIELDBUS GATEWAY MANAGER BASICS ...............................................................3
MAIN SCREEN ICONS ........................................................................................ 3
COMMUNICATIONS ............................................................................................................................ 3
DATA TAGS ..................................................................................................................................... 3
USER INTERFACE .............................................................................................................................. 4
PROGRAMMING ................................................................................................................................ 4
DATA LOGGER ................................................................................................................................. 4
WEB SERVER ................................................................................................................................... 4
SECURITY MANAGER ......................................................................................................................... 5
SELECTING A MODEL ........................................................................................ 5
USING BALLOON HELP ...................................................................................... 5
WORKING WITH DATABASES............................................................................... 6
DOWNLOADING TO A VLINX FIELDBUS GATEWAY ...................................................... 6
CONFIGURING THE LINK ..................................................................................................................... 6
VERIFYING THE USB LINK .................................................................................................................. 7
SETTING THE IP ADDRESS .................................................................................................................. 7
SENDING THE DATABASE .................................................................................................................... 7
EXTRACTING DATABASES .................................................................................................................... 8
MOUNTING THE COMPACTFLASH .......................................................................................................... 8
FORMATTING THE COMPACTFLASH ........................................................................................................ 9
SENDING THE TIME AND DATE ............................................................................................................. 9
UPDATING VIA COMPACTFLASH ..........................................................................10
GURU MEDITATION CODES ...............................................................................10
CONFIGURING COMMUNICATIONS .................................................................... 13
SERIAL PORT USAGE .......................................................................................13
SELECTING A PROTOCOL ..................................................................................13
PROTOCOL OPTIONS .......................................................................................14
WORKING WITH DEVICES .................................................................................14
ETHERNET CONFIGURATION ..............................................................................15
IP PARAMETERS ............................................................................................................................. 15
IP ROUTING .................................................................................................................................. 15
PHYSICAL LAYER ............................................................................................................................ 16
REMOTE UPDATE ............................................................................................................................ 16
PROTOCOL SELECTION ..................................................................................................................... 16
SLAVE PROTOCOLS .........................................................................................17
SELECTING THE PROTOCOL ............................................................................................................... 17
ADDING GATEWAY BLOCKS ............................................................................................................... 18
ADDING ITEMS TO A BLOCK .............................................................................................................. 19
ACCESSING INDIVIDUAL BITS ............................................................................................................ 19
REVISION 1 PAGE I
TABLE OF CONTENTS VLINX FIELDBUS GATEWAY MANAGER USER MANUAL
PROTOCOL CONVERSION ................................................................................. 20
MASTER AND SLAVE ........................................................................................................................ 20
MASTER AND MASTER ...................................................................................................................... 20
WHICH WAY AROUND? .................................................................................................................... 21
DATA TRANSFORMATION ................................................................................. 21
ADVANCED COMMUNICATIONS ........................................................................ 23
USING EXPANSION CARDS ............................................................................... 23
SHARING SERIAL PORTS .................................................................................. 24
ENABLING TCP/IP .......................................................................................................................... 24
SHARING THE REQUIRED PORT .......................................................................................................... 24
CONNECTING VIA ANOTHER PORT ...................................................................................................... 24
CONNECTING VIA ETHERNET ............................................................................................................. 25
PURE VIRTUAL PORTS ..................................................................................................................... 26
LIMITATIONS ................................................................................................................................. 27
USING ELECTRONIC MAIL ................................................................................ 27
CONFIGURING SMTP ...................................................................................................................... 27
CONFIGURING SMS ........................................................................................................................ 29
THE ADDRESS BOOK ....................................................................................................................... 30
WORKING WITH MODEMS ................................................................................ 30
SOME TYPICAL APPLICATIONS ........................................................................................................... 31
ADDING A DIAL-IN CONNECTION ........................................................................................................ 32
ADDING A DIAL-OUT CONNECTION ..................................................................................................... 34
ADDING AN SMS CONNECTION .......................................................................................................... 35
SMS MESSAGE PROCESSING ............................................................................................................. 36
USING MULTIPLE INTERFACES ........................................................................................................... 36
CHECKING THE MODEM STATUS ......................................................................................................... 37
MODEM INITIALIZATION SEQUENCE .................................................................................................... 38
TROUBLESHOOTING MODEM COMMUNICATION ...................................................................................... 39
USING TIME MANAGEMENT .............................................................................. 40
CONFIGURING THE TIME MANAGER ..................................................................................................... 40
SELECTING AN SNTP SERVER ............................................................................................................ 42
TIME-ZONE CONFIGURATION ............................................................................................................ 43
CONFIGURING THE SYNCHRONIZATION MANAGER (FTP) .......................................... 43
SYNCHRONIZATION MANAGER SETTINGS .............................................................................................. 43
AUTOMATIC LOG SYNCHRONIZATION ................................................................................................... 44
ADVANCED FTP EXCHANGE FUNCTIONS ............................................................................................... 45
CONFIGURING THE FTP SERVER ........................................................................ 45
FTP SERVER SETTINGS .................................................................................................................... 46
FTP SECURITY............................................................................................................................... 46
ACCESSING THE SERVER ................................................................................................................... 47
CONFIGURING DATA TAGS .............................................................................. 49
ALL ABOUT TAGS .......................................................................................... 49
TYPES OF TAGS .............................................................................................................................. 49
TAGS? ......................................................................................................................................... 51
CREATING TAGS ............................................................................................ 52
EDITING TAGS .............................................................................................. 52
EDITING PROPERTIES ..................................................................................... 53
PAGE II
TABLE OF CONTENTS
EXPRESSION PROPERTIES ................................................................................................................. 53
TRANSLATABLE STRINGS .................................................................................................................. 54
COLOR PROPERTIES ........................................................................................................................ 54
EDITING FLAG TAGS .......................................................................................55
THE DATA TAB (VARIABLES) ............................................................................................................. 55
THE DATA TAB (FORMULAE) ............................................................................................................. 57
THE DATA TAB (ARRAYS) ................................................................................................................. 57
THE FORMAT TAB ........................................................................................................................... 58
THE COLORS TAB ........................................................................................................................... 59
THE ALARMS TAB ........................................................................................................................... 60
THE TRIGGERS TAB ........................................................................................................................ 61
EDITING INTEGER TAGS ...................................................................................62
THE DATA TAB (VARIABLES) ............................................................................................................. 62
THE DATA TAB (FORMULAE) ............................................................................................................. 63
THE DATA TAB (ARRAYS) ................................................................................................................. 64
THE FORMAT TAB ........................................................................................................................... 65
THE COLORS TAB ........................................................................................................................... 66
THE ALARM TABS ........................................................................................................................... 67
THE TRIGGERS TAB ........................................................................................................................ 68
EDITING MULTI TAGS ......................................................................................68
THE DATA TAB (VARIABLES) ............................................................................................................. 69
THE DATA TAB (FORMULAE) ............................................................................................................. 69
THE DATA TAB (ARRAYS) ................................................................................................................. 70
THE FORMAT TAB ........................................................................................................................... 70
THE COLORS TAB ........................................................................................................................... 72
THE ALARM TABS ........................................................................................................................... 72
THE TRIGGERS TAB ........................................................................................................................ 73
EDITING REAL TAGS .......................................................................................73
EDITING STRING TAGS ....................................................................................73
THE DATA TAB (VARIABLES) ............................................................................................................. 74
THE DATA TAB (FORMULAE) ............................................................................................................. 75
THE DATA TAB (ARRAYS) ................................................................................................................. 75
THE FORMAT TAB ........................................................................................................................... 76
THE COLORS TAB ........................................................................................................................... 77
MORE THAN TWO ALARMS ................................................................................77
VALIDATING TAGS ..........................................................................................77
EXPORTING TAG MAPPINGS ...............................................................................78
LOGGING EVENT MESSAGES ..............................................................................78
CONFIGURING A VIRTUAL HMI ........................................................................ 79
CONTROLLING THE VIEW ..................................................................................79
ZOOM FUNCTION ............................................................................................................................ 79
OTHER VIEW OPTIONS .................................................................................................................... 80
USING THE PAGE LIST .....................................................................................80
WORKING WITH THE GRID ................................................................................81
THE DRAWING TOOLBOX ..................................................................................81
ADDING DISPLAY PRIMITIVES ............................................................................81
SMART ALIGNMENT ......................................................................................................................... 82
REVISION 1 PAGE III
TABLE OF CONTENTS VLINX FIELDBUS GATEWAY MANAGER USER MANUAL
KEYBOARD OPTIONS ....................................................................................................................... 82
LOCK INSERT MODE ........................................................................................................................ 82
USING THE IMAGE LIBRARY .............................................................................. 83
SELECTING PRIMITIVES ................................................................................... 83
MOVING AND RESIZING ................................................................................... 83
ALIGNING PRIMITIVES .................................................................................... 84
SPACING PRIMITIVES ...................................................................................... 84
REORDERING PRIMITIVES ................................................................................ 85
GROUPING PRIMITIVES ................................................................................... 85
EDITING PRIMITIVES ...................................................................................... 85
DEFINING COLORS ......................................................................................... 86
DEFINING FILL PATTERNS ................................................................................ 87
DEFINING ACTIONS ........................................................................................ 87
ENABLING ACTIONS ....................................................................................... 87
ACTION DESCRIPTIONS ................................................................................... 88
THE GOTO PAGE ACTION ................................................................................................................. 88
THE PUSH BUTTON ACTION .............................................................................................................. 89
THE CHANGE INTEGER VALUE ACTION ................................................................................................. 90
THE RAMP INTEGER VALUE ACTION .................................................................................................... 90
THE USER DEFINED ACTION ............................................................................................................. 91
USING DEFAULT SETTINGS ............................................................................... 91
PRIMITIVE DESCRIPTIONS ................................................................................ 91
THE LINE PRIMITIVE ....................................................................................................................... 92
THE SIMPLE GEOMETRIC PRIMITIVES .................................................................................................. 92
THE TANK PRIMITIVES ..................................................................................................................... 92
THE SIMPLE BAR PRIMITIVES ............................................................................................................ 93
THE BAR-GRAPH PRIMITIVES ............................................................................................................ 93
THE SCATTER GRAPH PRIMITIVE ........................................................................................................ 94
THE SCALE PRIMITIVES .................................................................................................................... 97
THE FIXED TEXT PRIMITIVE .............................................................................................................. 98
THE AUTO TAG PRIMITIVE ................................................................................................................ 99
THE TAG TEXT PRIMITIVES ............................................................................................................. 100
EDITING THE UNDERLYING TAG ....................................................................................................... 104
THE MULTI-LINE TEXT PRIMITIVES ................................................................................................... 104
THE TIME AND DATE PRIMITIVE ....................................................................................................... 104
THE RICH BAR PRIMITIVES ............................................................................................................. 107
THE RICH SLIDER PRIMITIVES ......................................................................................................... 109
THE ALARM VIEWER PRIMITIVE ....................................................................................................... 111
THE ALARM TICKER PRIMITIVE ........................................................................................................ 116
THE EVENT VIEWER PRIMITIVE ........................................................................................................ 118
THE FILE VIEWER PRIMITIVE ........................................................................................................... 118
THE TRENDING PRIMITIVES ............................................................................................................ 119
THE GENERAL BUTTON PRIMITIVE .................................................................................................... 123
THE RICH BUTTON PRIMITIVE ......................................................................................................... 125
THE SELECTOR PRIMITIVES ............................................................................................................. 126
THE PICTURE PRIMITIVE ................................................................................................................ 128
THE CF IMAGE PRIMITIVE .............................................................................................................. 133
PAGE IV
TABLE OF CONTENTS
THE DIAL GAUGE PRIMITIVES .......................................................................................................... 134
DEFINING PAGE PROPERTIES ........................................................................... 137
DEFINING SYSTEM ACTIONS ............................................................................ 138
ADDITIONAL SYSTEM PROPERTIES .................................................................... 138
SELECTING LANGUAGES ................................................................................. 140
CHANGING THE LANGUAGE .............................................................................. 141
SIMULATING LANGUAGES IN FIELDBUS GATEWAY MANAGER ..................................... 141
DEFINING KEY BEHAVIOR ............................................................................... 141
BLOCKING DEFAULT ACTIONS .......................................................................... 142
DATA AVAILABILITY ...................................................................................... 142
CONFIGURING PROGRAMS ............................................................................ 143
USING THE PROGRAM LIST ............................................................................. 143
EDITING PROGRAMS...................................................................................... 143
PROGRAM PROPERTIES .................................................................................. 144
ADDING COMMENTS ...................................................................................... 145
RETURNING VALUES ...................................................................................... 146
HERE BE DRAGONS! ...................................................................................................................... 146
PASSING ARGUMENTS .................................................................................... 146
PROGRAMMING TIPS ..................................................................................... 147
MULTIPLE ACTIONS ....................................................................................................................... 147
IF STATEMENTS ........................................................................................................................... 147
SWITCH STATEMENTS .................................................................................................................... 148
LOCAL VARIABLES ......................................................................................................................... 149
LOOP CONSTRUCTS ....................................................................................................................... 149
CONFIGURING DATA LOGGING ....................................................................... 153
BATCH LOGGING .......................................................................................... 153
CONTROLLING A BATCH ................................................................................................................. 154
CREATING DATA LOGS ................................................................................... 154
USING THE LOG LIST..................................................................................... 154
DATA LOG PROPERTIES .................................................................................. 155
LOG FILE STORAGE ....................................................................................... 156
THE LOGGING PROCESS ................................................................................. 157
ACCESSING LOG FILES ................................................................................... 157
USING WEBSYNC ......................................................................................... 158
WEBSYNC SYNTAX ........................................................................................................................ 158
OPTIONAL SWITCHES .................................................................................................................... 158
EXAMPLE USAGE........................................................................................................................... 159
CONFIGURING THE WEB SERVER .................................................................... 161
WEB SERVER PROPERTIES .............................................................................. 161
ADDING WEB PAGES ..................................................................................... 163
USING A CUSTOM WEB SITE ........................................................................... 164
CREATING THE SITE ...................................................................................................................... 164
EMBEDDING DATA ........................................................................................................................ 164
DEPLOYING THE SITE .................................................................................................................... 164
REVISION 1 PAGE V
TABLE OF CONTENTS VLINX FIELDBUS GATEWAY MANAGER USER MANUAL
COMPACTFLASH ACCESS ................................................................................. 164
ACCESSING THE WEB SERVER .......................................................................... 165
USING ETHERNET ......................................................................................................................... 165
USING MODEMS ........................................................................................................................... 165
WEB SERVER SAMPLES................................................................................... 166
USING THE SECURITY SYSTEM ....................................................................... 169
SECURITY BASICS ......................................................................................... 169
OBJECT-BASED SECURITY ............................................................................................................... 169
NAMED USERS ............................................................................................................................. 169
USER RIGHTS .............................................................................................................................. 170
ACCESS CONTROL ......................................................................................................................... 170
WRITE LOGGING .......................................................................................................................... 170
DEFAULT ACCESS ......................................................................................................................... 171
ON-DEMAND LOGON ..................................................................................................................... 171
MAINTENANCE ACCESS .................................................................................................................. 171
SECURITY SETTINGS ..................................................................................... 171
CREATING USERS ......................................................................................... 172
SPECIFYING TAG SECURITY ............................................................................. 173
SPECIFYING PAGE SECURITY ............................................................................ 173
THE SECURITY MANAGER PRIMITIVE .................................................................. 173
SECURITY RELATED FUNCTIONS ....................................................................... 173
WRITING EXPRESSIONS ............................................................................... 174
DATA VALUES .............................................................................................. 174
CONSTANTS ................................................................................................................................ 174
TAG VALUES................................................................................................................................ 176
COMMUNICATIONS REFERENCES ....................................................................................................... 176
SIMPLE MATH.............................................................................................. 176
OPERATOR PRIORITY ..................................................................................... 176
TYPE CONVERSION ....................................................................................... 177
COMPARING VALUES...................................................................................... 177
TESTING BITS ............................................................................................. 178
MULTIPLE CONDITIONS .................................................................................. 178
CHOOSING VALUES ....................................................................................... 179
MANIPULATING BITS ..................................................................................... 179
AND, OR AND XOR ....................................................................................................................... 179
SHIFT OPERATORS ........................................................................................................................ 179
BITWISE NOT ............................................................................................................................. 180
INDEXING ARRAYS ........................................................................................ 180
INDEXING STRINGS ....................................................................................... 180
ADDING STRINGS ......................................................................................... 180
CALLING PROGRAMS ...................................................................................... 180
USING FUNCTIONS........................................................................................ 180
PRIORITY SUMMARY ...................................................................................... 181
WRITING ACTIONS ..................................................................................... 183
PAGE VI
TABLE OF CONTENTS
CHANGING PAGE .......................................................................................... 183
CHANGING NUMERIC VALUES ........................................................................... 183
SIMPLE ASSIGNMENT ..................................................................................................................... 183
COMPOUND ASSIGNMENT ............................................................................................................... 183
INCREMENT AND DECREMENT .......................................................................................................... 183
CHANGING BIT VALUES .................................................................................. 183
RUNNING PROGRAMS .................................................................................... 184
USING FUNCTIONS ....................................................................................... 184
OPERATOR PRIORITY .................................................................................... 184
USING RAW PORTS ..................................................................................... 185
CONFIGURING A SERIAL PORT .......................................................................... 185
CONFIGURING A TCP/IP SOCKET ..................................................................... 185
READING CHARACTERS .................................................................................. 186
READING ENTIRE FRAMES ............................................................................... 186
SENDING DATA ............................................................................................ 187
SYSTEM VARIABLE REFERENCE ...................................................................... 189
HOW ARE SYSTEM VARIABLES USED .................................................................. 189
ACTIVEALARMS ............................................................................................ 190
COMMSERROR ............................................................................................. 191
DISPBRIGHTNESS ......................................................................................... 192
DISPCONTRAST ........................................................................................... 193
DISPCOUNT ................................................................................................ 194
DISPUPDATES ............................................................................................. 195
ISSIRENON ................................................................................................ 196
PI ............................................................................................................ 197
TIMEZONE ................................................................................................. 198
TIMEZONEMINS ........................................................................................... 199
USEDST .................................................................................................... 200
PROGRAMMING REFERENCE .......................................................................... 201
EXPRESSION OPERATORS................................................................................ 201
ACTION OPERATORS ..................................................................................... 202
PROGRAMMING STATEMENTS ........................................................................... 203
FUNCTION REFERENCE ................................................................................. 205
ABS(
VALUE
) ................................................................................................ 206
ACOS(
VALUE
) .............................................................................................. 207
ALARMACCEPTALL() ...................................................................................... 208
ASIN(
VALUE
) ............................................................................................... 209
ATAN(
VALUE
) .............................................................................................. 210
ATAN2(
BEEP(
A, B
) ............................................................................................... 211
FREQ, PERIOD
) ..................................................................................... 212
CLEAREVENTS() ........................................................................................... 213
CLOSEFILE(
FILE
).......................................................................................... 214
REVISION 1 PAGE VII
TABLE OF CONTENTS VLINX FIELDBUS GATEWAY MANAGER USER MANUAL
COMMITANDRESET() .................................................................................... 215
COMPACTFLASHEJECT() ................................................................................. 216
COMPACTFLASHSTATUS() ............................................................................... 217
CONTROLDEVICE( COPY(
DEST, SRC, COUNT
COS(
THETA
CREATEDIRECTORY( CREATEFILE( DATATOTEXT( DATE(
Y, M, D
DECTOTEXT( DEG2RAD( DELETEDIRECTORY( DELETEFILE( DEVCTRL(
DEVICE, FUNCTION, DATA
DISABLEDEVICE(
DEVICE, ENABLE
) ................................................................... 218
) ............................................................................... 219
) ............................................................................................... 220
NAME
) ............................................................................. 221
NAME
) ...................................................................................... 222
DATA, LIMIT
) ............................................................................ 223
) ............................................................................................. 224
DATA, SIGNED, BEFORE, AFTER, LEADING, GROUP
THETA
) ........................................................................................ 226
NAME
) .............................................................................. 227
FILE
) ........................................................................................ 228
) ................................ 225
) ................................................................. 229
DEVICE
) ................................................................................ 230
DISPOFF() ................................................................................................. 231
DISPON() .................................................................................................. 232
DRVCTRL( EMPTYWRITEQUEUE ( ENABLEDEVICE(
PORT, FUNCTION, DATA OR VALUE???
DEV
) ............................................................................. 234
DEVICE
) ................................................................................. 235
) .................................................. 233
ENDBATCH() ............................................................................................... 236
EXP(
VALUE
) ................................................................................................ 237
EXP10(
VALUE
) ............................................................................................. 238
FILL(
ELEMENT, DATA, COUNT
FIND(
STRING,CHAR,SKIP
FINDFILEFIRST(
DIR
) ..................................................................................... 241
) ......................................................................... 239
) ............................................................................... 240
FINDFILENEXT() .......................................................................................... 242
FINDTAGINDEX(
LABEL
) .................................................................................. 243
FORCE(TAG, VALUE) ..................................................................................... 244
FORCECOPY(DEST, SRC, COUNT) ...................................................................... 245
FORMATCOMPACTFLASH() .............................................................................. 246
FTPGETFILE( FTPPUTFILE( GETALARMTAG(
SERVER, LOC, REM, DELETE
SERVER, LOC, REM, DELETE
INDEX
) .................................................................................. 249
) ........................................................... 247
) ............................................................ 248
GETBATCH() ............................................................................................... 250
GETCAMERADATA( GETDATE (
TIME
GETDISKFREEBYTES( GETDISKFREEPERCENT( GETDISKSIZEBYTES(
PORT, CAMERA, PARAM
) .......................................................... 251
) AND FAMILY .......................................................................... 252
DRIVE
) ........................................................................... 253
DRIVE
) ........................................................................ 254
DRIVE
) ............................................................................ 255
PAGE VIII
TABLE OF CONTENTS
GETFORMATTEDTAG( GETINTERFACESTATUS( GETINTTAG(
INDEX
INDEX
) ........................................................................... 256
PORT
) ......................................................................... 257
) ...................................................................................... 258
GETMAXTAGINT(INDEX) ................................................................................ 259
GETMAXTAGREAL(INDEX) .............................................................................. 260
GETMINTAGINT(INDEX) ................................................................................. 261
GETMINTAGREAL(INDEX) ............................................................................... 262
GETMONTHDAYS( GETNETGATE( GETNETID( GETNETIP( GETNETMASK(
Y, M
) ................................................................................. 263
PORT
) ..................................................................................... 264
PORT
) ........................................................................................ 265
PORT
) ......................................................................................... 266
PORT
) .................................................................................... 267
GETNOW() ................................................................................................. 268
GETNOWDATE() .......................................................................................... 269
GETNOWTIME() .......................................................................................... 270
GETPORTCONFIG( GETREALTAG( GETSTRINGTAG( GETTAGLABEL( GETUPDOWNDATA( GETUPDOWNSTEP( GOTOPAGE(
PORT, PARAM
INDEX
) .................................................................................... 272
INDEX
) ................................................................................. 273
INDEX
) ................................................................................... 274
DATA, LIMIT
DATA, LIMIT
NAME
) ....................................................................................... 277
) ...................................................................... 271
) ..................................................................... 275
) ...................................................................... 276
GOTOPREVIOUS() ........................................................................................ 278
HASACCESS (
RIGHTS
) ................................................................................... 279
HIDEPOPUP() ............................................................................................. 280
INTTOTEXT( ISDEVICEONLINE(
DATA, RADIX, COUNT
DEVICE
) .............................................................................. 282
) ................................................................... 281
ISPORTREMOTE(PORT) .................................................................................. 283
ISWRITEQUEUEEMPTY( LEFT(
STRING, COUNT
LEN(
STRING
) .............................................................................................. 286
LOADCAMERASETUP( LOG(
VALUE
) ............................................................................................... 288
LOG10(
VALUE
) ............................................................................................ 289
DEV
) ........................................................................... 284
) ................................................................................... 285
PORT, CAMERA, INDEX, FILE
) ................................................. 287
LOGSAVE()................................................................................................. 290
MAKEFLOAT( MAKEINT(
VALUE
) ..................................................................................... 291
VALUE
) ......................................................................................... 292
MAX(A, B) .................................................................................................. 293
MEAN(
ELEMENT, COUNT
MID(
STRING, POS, COUNT
) ................................................................................ 294
) ............................................................................. 295
MIN(A, B) .................................................................................................. 296
REVISION 1 PAGE IX
TABLE OF CONTENTS VLINX FIELDBUS GATEWAY MANAGER USER MANUAL
MULDIV(
A, B, C
) .......................................................................................... 297
MUTESIREN() ............................................................................................. 298
NEWBATCH(
NAME
) ....................................................................................... 299
NOP() ....................................................................................................... 300
OPENFILE(
NAME, MODE
) ................................................................................ 301
PI() ......................................................................................................... 302
PLAYRTTTL( POPDEV( PORTCLOSE( PORTGETCTS( PORTINPUT( PORTPRINT( PORTREAD( PORTSETRTS( PORTWRITE( POSTKEY( POWER( RAD2DEG( RANDOM( READDATA( READFILE( READFILELINE( RENAMEFILE( RIGHT( SAVECAMERASETUP( SCALE( SENDFILE( SENDMAIL( SET(
TAG, VALUE
SETINTTAG( SETLANGUAGE( SETNETCONFIG( SETNOW( SETPORTCONFIG( SETREALTAG(
TUNE
) ...................................................................................... 303
ELEMENT, COUNT
PORT
) ....................................................................................... 305
PORT
PORT, START, END, TIMEOUT, LENGTH PORT, STRING
PORT, PERIOD
PORT, STATE
PORT, DATA
CODE, TRANSITION
VALUE, POWER
THETA
) ........................................................................................ 314
RANGE
) ......................................................................................... 315
DATA, COUNT
FILE, CHARS
FILE
HANDLE, NAME
STRING, COUNT
DATA, R1, R2, E1, E2
RCPT, FILE
RCPT, SUBJECT, BODY
) ............................................................................. 304
) .................................................................................... 306
) ............................................................................ 308
) ............................................................................. 309
) ........................................................................... 310
) .............................................................................. 311
) ......................................................................... 312
) ................................................................................. 313
) .............................................................................. 316
) ................................................................................. 317
) ..................................................................................... 318
) .......................................................................... 319
) ................................................................................. 320
PORT, CAMERA, INDEX, FILE
) .......................................................................... 322
) ................................................................................... 323
) .................................................................... 324
) ......................................................................................... 325
INDEX, VALUE
CODE
PORT, ADDR, MASK, GATE
TIME
) ........................................................................................... 329
PORT, PARAM, VALUE
INDEX, VALUE
) ............................................................................. 326
) .................................................................................... 327
) ........................................................................... 332
) ............................................... 307
) ................................................. 321
) ......................................................... 328
) ............................................................. 330
SETSTRINGTAG(INDEX, VALUE) ........................................................................ 333
SGN(
VALUE
) ............................................................................................... 334
SHOWMENU( SHOWPOPUP(
SIN(
THETA
NAME
) ...................................................................................... 335
NAME
) ..................................................................................... 336
) ................................................................................................ 337
SIRENON() ................................................................................................. 338
PAGE X
TABLE OF CONTENTS
SLEEP(
PERIOD
) ........................................................................................... 339
SQRT(
VALUE
) .............................................................................................. 340
STDDEV(
ELEMENT, COUNT
)............................................................................. 341
STOPSYSTEM() ............................................................................................ 342
STRIP(
TEXT, TARGET
SUM(
ELEMENT, COUNT
TAN(
THETA
) ............................................................................................... 345
TESTACCESS( TEXTTOADDR( TEXTTOFLOAT( TEXTTOINT( TIME(
STRING, RADIX
H, M, S
) ............................................................................................. 350
USECAMERASETUP(
) ................................................................................... 343
) ................................................................................. 344
RIGHTS, PROMPT
ADDR
) .................................................................................... 347
STRING
) ................................................................................. 348
) ....................................................................... 346
) ........................................................................... 349
PORT, CAMERA, INDEX
) ......................................................... 351
USERLOGOFF() ........................................................................................... 352
USERLOGON() ............................................................................................ 353
WAITDATA( WRITEFILE( WRITEFILELINE(
DATA, COUNT, TIME FILE, TEXT
) ................................................................................. 355
FILE, TEXT
) ........................................................................... 356
) ...................................................................... 354
TROUBLESHOOTING ..................................................................................... 357
GENERAL ................................................................................................... 357
FIELDBUS GATEWAY MANAGER MESSAGES ........................................................... 360
SERIAL COMMUNICATION ............................................................................... 361
ETHERNET COMMUNICATION ........................................................................... 362
PROGRAMS ................................................................................................. 363
WEB SERVER .............................................................................................. 364
REVISION 1 PAGE XI
VLINX FIELDBUS GATEWAY MANAGER USER MANUAL
GETTING STARTED SYSTEM REQUIREMENTS
GETTING STARTED
Fieldbus Gateway Manager is designed to provide quick and easy access to the features of the Vlinx Fieldbus Gateway series, while still allowing the advanced user to take advantage of high-end features, such as Fieldbus Gateway Manager’s unique programming support.
SYSTEM REQUIREMENTS
Fieldbus Gateway Manager is designed to run on PCs with the following specifications…
A Pentium class processor as required by the chosen operating system.
RAM and free disk space as required by the chosen operating system.
An additional 50MB of disk space for software installation.
A display of at least 1024 by 768, with 256 or more colors.
An RS-232 or USB port for downloading to a Fieldbus Gateway.
Fieldbus Gateway Manager is designed to operate with all versions of Microsoft Windows from Windows 95 upwards. If you want to take advantage of the USB port provided by the Vlinx Fieldbus Gateways, you will need to use, as a minimum, Windows 98. If you intend to use the USB port to remotely access the Gateway’s CompactFlash card, we recommend that you use Windows 2000 or Windows XP. While Windows 98 is capable of accessing the card, the later versions of the operating system provide more robust operation, and are much better about when they choose to lock the card, thereby preventing the C2 runtime from writing data.
INSTALLING THE SOFTWARE
If you downloaded the Fieldbus Gateway Manager software from B&B Electronics’ website, simply execute the download file, and follow the instructions. If you received a copy of Fieldbus Gateway Manager on CD, place the CD in your system’s CDROM drive, and follow the instructions that will appear. If no instructions appear, you may have auto-run disabled. In that case, select the Run option from the Start menu, and enter letter of your CDROM drive. Again, follow the resulting instructions, and the software will be installed.
x:\setup, where x is the drive
CHECKING FOR UPDATES
If you have an Internet connection, you can use the Check for Update command in the Help menu to scan B&B Electronics’ web site for a new version of Fieldbus Gateway Manager. If a later version than the one you are using is found, Fieldbus Gateway Manager will ask if it should download the upgrade and update your software automatically. You may also manually download the upgrade from B&B Electronics’ website by visiting the Downloads page within the Support section. Either way, when the upgrade package executes, be sure to select the Repair option to update your installation.
REVISION 1 PAGE 1
INSTALLING THE USB DRIVERS VLINX FIELDBUS GATEWAY MANAGER USER MANUAL
INSTALLING THE USB DRIVERS
When you first connect a Vlinx Fieldbus Gateway to your PC using a USB cable, Windows Hardware Wizard will appear. Before continuing, make sure that the CD containing Vlinx Fieldbus Gateway Manager is in the CDROM drive of your PC.
If connected to the Internet, Windows will ask to connect to Windows Update. Select, No, not this time, and then select Install from a specific location (Advanced) on the subsequent dialog.
When the Hardware Wizard continues, choose the Browse option, and point the Wizard at your CDROM drive. Click OK to finish the USB driver installation.
Windows XP users should note that Fieldbus Gateway Manager’s USB drivers have not been digitally signed by Microsoft, and you will therefore see a dialog offering you the chance to stop the installation. You should be sure to select the Continue option to indicate that you do indeed wish to install the drivers.
If you do not have the CD that came with the Vlinx Fieldbus Gateway, but you have previously installed Vlinx Fieldbus Gateway Manager, follow the same steps shown above, but rather than pointing to the CDROM drive, browse and point to the following folder…
C:\Program Files\B&B Electronics\Vlinx\Vlinx Fieldbus Gateway Manager\Device.
PAGE 2
FIELDBUS GATEWAY MAN AGER BASICS MAIN SCREEN ICONS
FIELDBUS GATEWAY MANAGER BASICS
To run Fieldbus Gateway Manager, select the Fieldbus Gateway Manager icon from the B&B Electronics folder on the Programs section of your Start Menu. The main Fieldbus Gateway Manager screen will appear, showing the icons that are used to configure the various aspects of the gateway’s behavior…
The software is designed such that the first three icons are the only ones required for the majority of simple applications. The remainder of the icons provide access to the Gateway’s more advanced features, such as programming, data logging and the Gateway’s web server.
MAIN SCREEN ICONS
The sections below provide an overview of each icon in turn…
C
OMMUNICATIONS
This icon is used to specify which protocols are to be used on the Gateway’s serial ports and on the Ethernet port. Where master protocols are used (ie. protocols by which the Gateway initiates data transfer to and from a remote device) you can also use this icon to specify one or more devices to be
accessed. Where slave protocols are used (ie. protocols by which the Gateway receives and responds to requests from remote devices or computer systems) you can specify which data items are to be exposed for read or write access. You can also use this icon to move data between one remote device and another via Fieldbus Gateway Manager’s protocol converter.
ATA TAGS
D
This icon is used to define the data items to be accessed within the remote devices, or to define internal data items to store information within the terminal itself. Each tag has a variety of properties associated with it. The most basic property is formatting data, which is used to specify how the data
held within a tag is to be shown on the terminal’s display, and on such things as web pages. By specifying this information within the tag, Fieldbus Gateway Manager removes the need for you to re-enter formatting data each time a tag is displayed.
REVISION 1 PAGE 3
MAIN SCREEN ICONS VLINX FIELDBUS GATEWAY MANAGER USER MANUAL
More advanced tag properties include alarms that may activate when various conditions relating to the tag occur, or triggers, which perform programmable actions on similar conditions.
SER INTERFACE
U
This icon is used to create and edit display pages, and to specify what
actions should be taken when the Gateway’s keys are pressed, released or held down. The page editor allows you to display various graphical items known as primitives. These vary from simple items, such as rectangles and
lines, to more complex items that can be tied to the value of a particular tag or expression. By default, such primitives use the formatting information defined when the tag was created, but this information can be overridden if required.
ROGRAMMING
P
This icon is used to create and edit programs using the software’s unique C­like programming language. These programs can perform complex decision making or data manipulation operations based upon any data items within the system. They serve to extend the functionality of Fieldbus Gateway Manager beyond that of the standard functions included in the software,
thereby ensuring that even the most complex applications can be tackled with ease.
ATA LOGGER
D
This icon is used to create and manage data logs, each of which can record any number of variables to the Gateway’s CompactFlash card. Data may be recorded as quickly as once per second. The recorded values will be stored in CSV (comma separated variable) files that can easily be imported into
applications such as Microsoft Excel. The files can be accessed by swapping-out the CompactFlash card, by mounting the card as a drive on a PC connected on the Gateway’s USB port, or by accessing them via Fieldbus Gateway Manager’s web server via the Ethernet port.
EB SERVER
W
This icon is used to configure Fieldbus Gateway Manager’s web server and
to create and edit web pages. The web server is capable of providing remote
access to the Gateway via a number of mechanisms. First, you can use
Fieldbus Gateway Manager to create automatic web pages which contain
lists of tags, each formatted according to the tag’s properties. Second, you can create a custom site using a third party HTML editor such as Microsoft FrontPage, and then include special text to instruct Fieldbus Gateway Manager to insert live tag values. Finally, you can enable the software’s unique remote access and control feature, which allows a web browser to view the Gateway’s display and control its keyboard. The web server can also be used to access CSV files from the Data Logger.
PAGE 4
FIELDBUS GATEWAY MAN AGER BASICS SELECTING A MODEL
SECURITY MANAGER
This icon is used to create and manage the various users of the Gateway, as well as the access rights granted to them. Real names may also be given, which allows the security logger to record not only what data was changed and when, but also by whom the data was changed. The rights required to modify a particular tag, or to access a page, are set via the security
properties of the individual item.
SELECTING A MODEL
When Fieldbus Gateway Manager first starts, it will assume that you are continuing to work with the same model as was used by the last loaded database. If Fieldbus Gateway Manager has not been previously executed, it will assume you are working with a VFG1000. If you want to select a new model, select the New command from the File menu. The following dialog will appear…
The dialog lists the models supported by the current version of the software, providing a description of each terminal and the dimensions of its display. Selecting a terminal will create a blank database, and reconfigure Fieldbus Gateway Manager to work with that specific model.
USING BALLOON HELP
Fieldbus Gateway Manager provides a useful feature called Balloon Help...
REVISION 1 PAGE 5
WORKING WITH DATABASES VLINX FIELDBUS GATEWAY MANAGER USER MANUAL
This feature allows you to see help information for each icon in the main menu, or for each field in a dialog box or window. It is controlled via the icon at the right-hand edge of the toolbar, and can be configured to three modes, namely “Do Not Display”, in which case balloon help is disabled; “When Mouse Over”, in which case help is displayed when the mouse pointer is held over a particular field for a certain period of time; or “When Selected”, in which case help is always displayed for the currently selected field.
WORKING WITH DATABASES
Fieldbus Gateway Manager stores all the information about a particular Gateway’s configuration in what is called a database file. These files have the extension of
CD2, although
Windows Explorer will hide this extension if it is left in its default configuration. Fieldbus Gateway Manager database files differ from those used by previous B&B Electronics Fieldbus Gateways, in that they are text files which are thus far easier to recover in the case of accidental corruption. Databases are manipulated via the commands found on the File menu. These commands are standard for all Windows applications, and need no further explanation. The exception is Save Image, which will be covered later.
DOWNLOADING TO A VLINX FIELDBUS GATEWAY
Fieldbus Gateway Manager database files are downloaded to the Fieldbus Gateway by means of the Link menu. The download process typically takes only a few seconds, but can take somewhat longer on the first download if Fieldbus Gateway Manager has to update the firmware in the Fieldbus Gateway, or if the Gateway does not contain an older version of the current database. After this first download, however, Fieldbus Gateway Manager uses a process known as incremental download to ensure that only changes to the database are transferred. This means that changes can be made in seconds, thereby reducing your development cycle time and simplifying the debugging process.
ONFIGURING THE LINK
C
The programming link between the PC and the Gateway is made using an RS-232 serial port, a USB port or a TCP/IP connection. While TCP/IP connections are typically made via the Gateway’s Ethernet port, they may also be established via a dial-in link. Before downloading, you should use the Link-Options command to ensure that you have the method selected…
PAGE 6
FIELDBUS GATEWAY MAN AGER BASICS DOWNLOADING TO A VLINX FIELDBUS GATEWAY
VERIFYING THE USB LINK
If you are using USB, you might also want to ensure that the Gateway’s USB drivers have been correctly installed. To do this, connect the Fieldbus Gateway, and, if the drivers have not previously been installed, follow the instructions at the start of this manual. Then, open the Device Manager for your operating system, and expand the USB icon to show the icon for the Vlinx device. Ensure that this icon does not display a warning symbol. If it does, remove the device, unplug and reconnect the Fieldbus Gateway, and verify that you have correctly followed the driver installation procedure. The illustrations below show typical Device Manager views with the CompactFlash dismounted and mounted, respectively….
S
ETTING THE IP ADDRESS
If you are using a TCP/IP connection, you should enter the IP address of the target device in the appropriate field in the dialog box. If you leave the IP address as 0.0.0.0, Fieldbus Gateway Manager will examine the currently loaded database to see if the Gateway’s address can be determined from the configuration information. This feature removes the need to change the IP addresses when switching between databases intended for different terminals.
ENDING THE DATABASE
S
Once the link is configured, the database can be downloaded using either the Link-Send or Link-Update commands. The former will send the entire database, whether or not individual objects within the file have changed. The latter will only send changes, and will typically take a much shorter period of time to complete. The Update command is typically the only one that you will need, as Fieldbus Gateway Manager will automatically fall-back to a complete send if the incremental download fails for any reason. As a shortcut, note that you can access Link Update via the lightning-bolt symbol on the toolbar, or via the
F9 key on the PC.
Note that downloading via TCP/IP relies on a CompactFlash card being installed in the Gateway if the device’s firmware is to be upgraded. Since you may want to perform such
REVISION 1 PAGE 7
DOWNLOADING TO A VLINX FIELDBUS GATEWAY VLINX FIELDBUS GATEWAY MANAGER USER MANUAL
upgrades at some point in time, it is highly recommended that you install a CompactFlash card in any device to which TCP/IP downloads are likely to be performed.
XTRACTING DATABASES
E
The Link-Support Upload command can be used to instruct Fieldbus Gateway Manager whether or not it should include the information necessary to support database upload when sending a database to a Fieldbus Gateway. Supporting upload will slow the download process somewhat and may fail with extremely large databases containing many embedded images, but it will ensure that should you lose your database file, you will be able to extract an editable image from the terminal.
Note that if you lose your database file and you do not have upload support enabled, you will not be able to reconstruct your file without starting from scratch. To extract a database from a Gateway, use the Link-Extract command. This command will upload the database, and then prompt you for a name under which to save the file. The file will then be opened for editing.
OUNTING THE COMPACTFLASH
M
If you are connected to a Fieldbus Gateway via the USB port, you can instruct Fieldbus Gateway Manager to mount the Gateway’s CompactFlash card as a drive within Windows Explorer. You can use this functionality to save files to the card or to read information from the Data Logger. The drive is mounted and dismounted by sending commands using the Mount Flash and Dismount Flash options on the Link menu. Once a command has been sent, the Fieldbus Gateway will be reset, and Windows will refresh the appropriate Explorer windows to show or hide the CompactFlash drive.
PAGE 8
FIELDBUS GATEWAY MAN AGER BASICS DOWNLOADING TO A VLINX FIELDBUS GATEWAY
Note that some caution is required when mounting the CompactFlash card...
When the card is mounted, the Gateway will periodically inform the PC if data on the card has been modified. This means that both the PC and the Gateway will suffer performance hits if the card is mounted during data logging operations for longer than necessary.
If you write to the CompactFlash card from your PC, the Gateway will not be able to access the card until Windows releases its “lock” on the card’s contents. This may take up to a minute, and will restrict data logging operations during that time, and prevent access to custom web pages. Fieldbus Gateway Manager will use the Gateway’s RAM to ensure that no data is lost, but if too many writes are performed such that the card is kept locked for four minutes or more, data may discarded. Note that Windows 98 is particularly bad at keeping the card locked when there is no need for it. Windows 2000 or Windows XP is thus the operating system of choice when using this feature.
You should never
attempt to use Windows to format a CompactFlash card that you have mounted via the Gateway, whether it be via Explorer or from the command prompt. Windows does not correctly lock the card during format operations, and the format may thus be unreliable and lead to subsequent data loss. See below for details of how to format a card in a reliable manner.
ORMATTING THE COMPACTFLASH
F
The preferred method of formatting a card is via the Format Flash command on the Link menu. Selecting this command will explain that the formatting process will destroy all the data stored on the CompactFlash card and offer you a chance to cancel the operation. If you elect to continue, the Fieldbus Gateway will be instructed to format the card. Note that this process may take several minutes for a large card. Slow formats on Gateways that are performing data logging may therefore result in gaps in the recorded data.
A less attractive method of formatting a card is via a dedicated CompactFlash drive connected to your PC. If you use this method, be sure to instruct Windows to format the card using FAT16. For very small or very large cards, Windows will most likely choose the wrong format by default. Worse still, some versions of Windows Explorer will not allow you to override the default format, forcing you to use the command line version
ENDING THE TIME AND DATE
S
FORMAT instead.
The Link-Send Time command can be used to set the Gateway’s clock to match that of the PC on which Fieldbus Gateway Manager is executing. Obviously, make sure your clock is right before you do this!
REVISION 1 PAGE 9
UPDATING VIA COMPACTFLASH VLINX FIELDBUS GATEWAY MANAGER USER MANUAL
UPDATING VIA COMPACTFLASH
If you need to update the database within a unit that is already installed at a customer’s site, Fieldbus Gateway Manager allows you to save a copy of the database to a CompactFlash card, ship that card to your customer, and have the Gateway load the database from that card. The process is performed via the Save Image command on the File menu.
The Save Image command will create a Fieldbus Gateway Manager database image file with
CDI extension. It will also save a copy of the current Gateway firmware to a file with a BIN
a extension. The image file must be given the name must be placed in the root directory of a CompactFlash card. To update a Fieldbus Gateway, power down the unit, insert the CompactFlash card bearing the two files, and reapply power to the unit. The Gateway’s boot loader will first check whether it needs to upgrade the unit’s firmware, and once this process has been completed, the Fieldbus Gateway Manager runtime application will load the database stored on the card. The CompactFlash card can then be removed or left in place as required.
DBASE.CDI, and both it and the BIN file
GURU MEDITATION CODES
If a problem with the Fieldbus Gateway Manager runtime application within the Gateway results in it being reset, the condition that caused the fault will be logged. When the Gateway restarts, this information will be displayed in the form of a Guru Meditation Code on the virtual HMI. A typical code will have the format…
The message can be accepted by pressing the F1 key, at which point the Gateway will resume normal operation. Note that communications, data logging and the web server are still active when the GMC is displayed—only the user interface is interrupted. This means that system disruption is minimized, and functions such as protocol conversion continue to operate.
Before accepting the message, you may wish to write down the code. You may then email it to B&B Electronics technical support, so that one of our technical gurus can meditate on this information in order to track-down the cause of the problem. You may also want to email a copy of the Gateway’s database, and describe what you were doing when the terminal crashed.
03-2004-1BE4-205
PAGE 10
FIELDBUS GATEWAY MAN AGER BASICS GURU MEDITATION CODES
REVISION 1 PAGE 11
CONFIGURING COMMUNICATIONS SERIAL PORT USAGE
CONFIGURING COMMUNICATIONS
The first stage of creating a Fieldbus Gateway Manager database is to configure the communications ports of the Fieldbus Gateway to indicate which protocols you want to use, and which remote devices you want to access. These operations are performed from the Communications window, which is opened by selecting the first icon of the Fieldbus Gateway Manager main screen.
As can be seen, the Communications window lists the unit’s available ports in the form of a tree structure. Fieldbus Gateways have three primary serial ports, with the option to add a further two ports in the form of an expansion card. They also provide a single Ethernet port that is capable of running four communications protocols simultaneously.
SERIAL PORT USAGE
When deciding which of the Gateway’s serial ports to use for communications, note that…
The unit’s programming port may be used as an additional communications port, but it will obviously not be available for download if it is so employed. This is not an issue if the USB port is used for such purposes, and it is highly recommended that you use this method of download if you want to connect serial devices via the programming port.
SELECTING A PROTOCOL
To select a protocol for a particular port, click on that port’s icon in the left-hand pane of the Communications window, and press the Edit button next to the Driver field in the right-hand pane. The following dialog box will appear…
REVISION 1 PAGE 13
PROTOCOL OPTIONS VLINX FIELDBUS GATEWAY MANAGER USER MANUAL
Select the appropriate manufacturer and driver, and press the OK button to close the dialog box. The port will then be configured to use the appropriate protocol, and a single device icon will be created in the left-hand pane. If you are configuring a serial port, the various Port Settings fields (Baud Rate, Data Bits, Stop Bits and Parity) will be set to values appropriate to the protocol in question. You should obviously check these settings to make sure that they correspond to the settings for the device to be addressed.
PROTOCOL OPTIONS
Some protocols require additional configuration of parameters specific to that protocol. These appear in the right-hand pane of the Communications window when the corresponding port icon is selected. The example below shows the additional parameters for the Allen-Bradley DH-485 driver, which appear under the Driver Settings section of the window.
WORKING WITH DEVICES
As mentioned above, when a communications protocol is selected, a single device is created under the corresponding port icon. In the case of a master protocol, this represents the initial remote device to be addressed via the protocol. If the protocol supports access to more than one device, you can use the Add Additional Device button included with the port icon’s properties to add further target devices. Each device is represented via an icon in the left-hand pane of the Communications window, and, depending on the protocol in question, may have a number of properties to be configured…
PAGE 14
Loading...
+ 350 hidden pages