I124 GB 1207

RGK60 RGK50 RGAM20 RGAM4 GENERATOR SET CONTROL UNITS REMOTE CONTROL SOFTWARE MANUAL LIST OF CONTENTS
Introduction ................................................................................................................................................................................................. 2 Minimum PC hardware requirements....................................................................................................................................................... 2 Installation ................................................................................................................................................................................................... 2 Activating the PC-RGK connection........................................................................................................................................................... 3 Direct connection via RS-232................................................................................................................................................................... 3 Connection via RS-485 ............................................................................................................................................................................ 3 Connection via modem............................................................................................................................................................................. 3 Connection via GSM modem ................................................................................................................................................................... 3 Connection via Ethernet-to-serial gateways............................................................................................................................................. 4 Basic principles .......................................................................................................................................................................................... 5 Main window................................................................................................................................................................................................ 6 System configuration ................................................................................................................................................................................. 7 View Menu ................................................................................................................................................................................................. 11 Data log .................................................................................................................................................................................................. 11 Alarms .................................................................................................................................................................................................... 12 Events .................................................................................................................................................................................................... 12 Events .................................................................................................................................................................................................... 13 Graphs.................................................................................................................................................................................................... 14 I/O Status ............................................................................................................................................................................................... 15 Password ................................................................................................................................................................................................... 16 Application password ............................................................................................................................................................................. 16 Unit Password ........................................................................................................................................................................................ 17 Communication menu .............................................................................................................................................................................. 18 Online ..................................................................................................................................................................................................... 18 Offline ..................................................................................................................................................................................................... 18 Modem call ............................................................................................................................................................................................. 18 Wait for incoming calls ........................................................................................................................................................................... 19 Hang up .................................................................................................................................................................................................. 19 Parameters menu...................................................................................................................................................................................... 20 Setup ...................................................................................................................................................................................................... 20 Access to the parameters....................................................................................................................................................................... 21 Alarm table ............................................................................................................................................................................................. 22 Save on file............................................................................................................................................................................................. 22 Load from file.......................................................................................................................................................................................... 22 Print ........................................................................................................................................................................................................ 22 Modem parameters ................................................................................................................................................................................ 23 Page editor ................................................................................................................................................................................................ 23 Page editor ................................................................................................................................................................................................ 24 Types of Indicators ................................................................................................................................................................................. 28 Types of Objects .................................................................................................................................................................................... 37 Initial page generation ............................................................................................................................................................................ 40 APPENDIX A Connection modes.......................................................................................................................................................... 41 Direct RS-232 connection.................................................................................................................................................................. 41 PC-RGK connection via RS-485 (RGK without internal RS-485 interface) ....................................................................................... 42 PC-RGK connection via RS-485 interface (RGK with internal interface)........................................................................................... 43 Connection via standard modem ....................................................................................................................................................... 44 Connection via GSM modem............................................................................................................................................................. 46 Connection via Ethernet-to-serial gateways ...................................................................................................................................... 48 Appendix B Commands with SMS messages ..................................................................................................................................... 49

Doc. MSGB203921.doc

21 December 2007

P. 1 / 51

Introduction
With the remote control software for RGK units it is possible to:

View the status of the equipment, with the current measurements, operating mode, engine parameters etc. on a PC in graphic form. View any active alarms View the events recorded by the equipment View and modify the equipment setting parameters, with the possibility to save on disk, call up and print the settings. Sample certain user-defined measurements and save them on disk in different formats (MS-Access, ASCII text, MS-Excel). Trace graphs of the sampled measurements. Possibility for the user to personalise the pages according to preference, inserting indicators associated with the measurements, background images, wordings and control buttons. Change the language of the menus and of the program commands choosing between Italian, English, French, German and Spanish.

Minimum PC hardware requirements

Windows 95/98/2000/XP operative system. Graphic card with minimum resolution of 800x600, 1024x768 or more recommended. One free serial interface port (COM:) 64Mb of RAM Pentium-like processor or faster CD-ROM drive for installation

Installation
To proceed with the installation, it is necessary that the PC is already working with the operative system and to have the CD ROM for the software setup. It is also recommended that the user has at least a minimum experience with PCs and Windows environment. To install the software: 1. 2. 3. 4. Close all active applications Insert the CD in the drive and wait for its recognition. Launch Rgk_setup.exe A dialog box will appear asking for the directory where to install the program. State the new name, if any, in the space. 5. Follow the step-by-step instructions 6. If at the end of setup process the installation program asks to reboot the Pc, execute this procedure.

Doc. MSGB203921.doc

21 December 2007

P. 2 / 51

Activating the PC-RGK connection

For the function remote control program to be able to work, the PC and the RGK must be able to converse via serial interface. The serial connection can be made in different ways depending on the distance between the PC and the RGK and the modes required by the user, but in any case, it will be necessary to use a serial port of the PC. Therefore, the first thing to do is make sure that the PC you intend to use has an available and free RS-232 serial interface. Serial ports are commonly marked with the code COM and usually go from COM1: up to COM4:, even if most PCs in commerce only have two serial ports (COM1: and COM2:) , identifiable by the 9-pin male connector. To be able to use the program, it is firstly necessary to identify the PC port you want to use, remembering that in some cases a serial port may already be occupied by the mouse. The software will then have to be configured to use the port chosen. This may be done either during set-up or later through the Configuration-Options-General menu (see the associated paragraph).

Direct connection via RS-232

This type of connection is the simplest, and it involves the direct connection between the serial port of the PC and that of the RGK (telephone connector with RJ6/6 pin, on the back of the equipment) made through the specific cable supplied by Lovato (code 51C2). This connection mode should be used during set-up, finetuning or maintenance of the RGK, but it is not suitable for a permanent connection because by nature the RS232 interface is unable to reach long distances and may be affected by the disturbances present in an industrial environment. In the event of problems, or for further information, see Appendix A.

Connection via RS-485

This type of connection allows permanent connection according to industrial standard RS-485, with the possibility of multipoint connection of up to a maximum of 99 RGKs connected to a personal computer. This solution enables a reliable and permanent connection, suitable for an industrial environment and makes it possible to reach distances in the region of 1Km. To make a connection of this type, an RS-232 / RS-485 converter for the PC plus a converter for each piece of equipment are necessary (if they are not fitted with an internal RS-485 interface). For the connection layouts, refer to the wiring diagrams in appendix A at the end of this manual.

Connection via modem

When the PC and the RGK are located at a considerable distance from one another, it is possible to establish remote control through a pair of modems. In this case the PC Must be connected to the modem through the cable supplied with the modem. While on the other end the RGK must be connected to the modem through the cable supplied by Lovato. This type of connection may entail some difficulty for users who are not familiar with the use and programming of modems, as certain programming is necessary depending on the type of modem used, the type of telephone line, etc. For further information see Appendix A.

Connection via GSM modem

The remote control software also includes the possibility of using a GSM modem connected to the RGK. This is a device which combines a modem and a cell phone, allowing data transmission also from places that do not have the normal telephone line. In addition to performing the normal functions of a modem, this device also offers the possibility of sending SMS messages (Short Message Service) to other GSM mobile phones, making it possible to signal alarms with this innovative system. Through an extension of the SMS provided by some operators, this also makes it possible to send e-mail messages. Both the RGK and the remote control software have been adapted for the use of these possibilities. In this case, too, the installation of this kind of system requires a certain amount of experience with modems.

Doc. MSGB203921.doc

21 December 2007

P. 3 / 51

Connection via Ethernet-to-serial gateways

It is possible to configure the software to establish the PC-RGK connection through Ethernet-to-serial gateways. This devices are able to use the Ethernet LAN network to realize a link between serial devices, and can be used in two different ways: 1. Using a dedicated driver in the PC, one virtual COM port is created. This COM port s visible by any application running on the PC. It works logically exactly as a standard serial port, the only difference is that it is physically placed on the gateway, that is it can be placed far away from the PC. This allows to use an existing LAN to cover the major part of the distance between the PC and the place where the RGK are installed. In this case the use of the Ethernet converter is transparent, that is both the configuration of the PC and the wiring of the RGK interface to the serial port are to be done as usual (see the previous chapter Activation of PC-RGK connection). The only difference is that the PC serial port has to be substituted by the gateway converter serial port. This operation mode allows to use only one gateway. 2. The second possible connection mode works with a direct communication between PC and gateways without the need for a virtual COM driver, allowing to use several Ethernet-to-serial devices at the same time. This provides more flexibility in placing the converters in different points of the network and reaching RGKs that are far one from the other. In this case, for every unit the user must specify the IP address and IP port of the Ethernet converter where the RGK is connected (see Configure-Options window in the following pages). It is also possible to connect several RGKs to the same port of the converter. The market offers many different brands and models of Ethernet/serial converters, and their characteristics and product codes are continuously evolving. For this reason this manual does not indicate a specific model, even if the major part of these devices is compatible with our application. To have help in selecting the right model, ask the producer of the gateway for technical support. To set-up the system and correctly configure the gateways, refer to their user manual and eventually ask for the help of an expert of LAN networks (IT system administrator). As a general indication, respect the following points:

The serial gateways have to be configured to work directly in TCP/IP, not through a virtual COM driver. The IP addresses used for the converters must be free, that is they have not to be in conflict with other devices operating on the LAN. If necessary, ask for the IT system administrator help. The serial port settings of the converters (baudrate, parity, data bits etc) must match what is set into the RGKs. All RGKs must have a different serial address.

Concerning the physical connection between RGK and converter:

If the Ethernet-to serial converter has a RS-232 interface port, then use the same wiring diagrams suggested for the COM port of the PC.

For additional details about this type of connection, see Appendix A at the end of the manual.

Doc. MSGB203921.doc

21 December 2007

P. 4 / 51

Basic principles
The program operating criteria consists in reading the measurements made by the RGKs connected and showing them in the form of indicators on the PC monitor. The information is grouped into pages that can be selected by the user during connection. When the program is installed some already ready pages are provided. If the user requires, it will be possible to create new pages or modify the existing ones. The pages can be of two types: Pages with indicators not associated with a particular RGK, where the user chooses the unit from which to take the data to be viewed. In this case, it is possible to concentrate many measurements all leading from the RGK selected at that time, on the same page. With a simple click the user can move to another unit, and all the indicators will be updated with the measurements coming from it. Pages that group data coming from different RGKs, for example to view the status of two or more generating sets at the same time, each controlled by an RGK. In this case, each indicator viewed takes the measurements of a particular RGK.

The more common pages are those of the first type: When the program is viewing one of these pages, a drop-down box is enabled where the user can choose from which RGK to read the measurements. In this case a series of functions are also enabled that are addressed to the RGK selected, such as for example access to the set-up parameters, the I/O status etc.
Example of page with measurements coming from the same RGK

Example of page with measurements coming from different RGKs

Doc. MSGB203921.doc

21 December 2007

P. 5 / 51

Main window
The main window of the program contains all the menus and toolbars that allow access to the various functions available. Some of these functions which may alter the software configuration are protected by a password, and are therefore disabled when the program is started. The figure below shows the main window with the more frequently used controls.
Toolbar with the most common functions and commands Box for choosing the page Box for choosing the unit

D A B E F G H C C L M

Fig 1.1 Main window

Page updating time

Communication status: ONLINE OFFLINE

Number of active alarms

The page shown above, called MAIN is one of the ready pages provided with the program. The indicators on this page are not associated, therefore the measures viewed refer each time to the unit selected in the box for choosing the RGK at the top right. It groups together many of the most important measurements provided by the RGK, namely the following: A) B) C) D) E) F) G) H) I) J) K) L) M) Mains, phase-neutral and between line voltages. Generator, phase-neutral and between line voltages. Status of mains / generator contactors Choosing and setting the RGK operating mode (OFF-MAN-AUT-TEST) Engine started indicator Alarms on indicator RGK alarm indicator Battery voltage Status of analogue fuel temperature pressure sensors (if available) Engine operating hours meter and Hours to go before scheduled maintenance interval Pushbuttons to reset the above meters Attempted starts counter Percentage of successful attempted starts.

Doc. MSGB203921.doc

21 December 2007

P. 6 / 51

System configuration
To be able to access the configuration, it is necessary to enter the password which after program set-up is by default, LOVATO. Click on the password menu, type Lovato and then confirm with OK. Then select the Configuration-Options menu or click on the symbol on the toolbar. System configuration is a highly important phase for the definition of how the software works. So, before explaining the various program functions we are going to dwell a while on the configuration window, listing the function of all the settings. The more detailed explanation about the purpose of each setting will be dealt with more extensively in the chapters that follow. Fig. 2.1 - Configuration-Options-General This window groups the configurations of a general nature. It is possible to call this window at any time and act on the configuration.

PC serial port settings Choice of programme language.

Choice of default colours of pages and indicators

Choice of direct/modem connection. If a modem connected to the PC is used, select the box

Any initialisation command to be sent to the modem. Normally not necessary

Defines the behaviour in case of an alarm. It is possibile to make the PC emit a beep and/or to open automatically the alarm window.

Selects the TCP-IP communication. The TCP/IP addresses and ports are defined in the Units window.

Sets the TCP/IP communication timeout

Sets the TCP/IP re-connection time delay

Doc. MSGB203921.doc

21 December 2007

P. 7 / 51

Fig. 2.2 - Configuration-Options-Units Through this window it is possible to define how many RGK units are connected to the PC. Clearly, if we use a direct connection via RS-232, it will be possible to connect to only one unit. Conversely, if an RS-485 network is used, which allows a multipoint connection, it will be necessary to specify how many units are to be controlled by the PC. A free name can be defined for each unit (for example GROUP1), which will be used every time that particular RGK is to be selected. The list of the RGKs defined in this configuration page will then be viewed on the main page, in the unit choice box. This window is enabled only in case of direct connection, that is when the modem is NOT used. See next chapter for more details on the operating mode in case of modem connection.

Number of RGK units connected.

Adds a unit

Unit currently selected. Corresponds to the serial address programmed on the RGK.

Eliminates a unit. Warning: If data log has been enabled, the elimination of a unit from the network involves the loss of any data stored. See Data Log chapter.

Enables communication with the chosen unit. If deactivated the unit is ignored (helpful for example when the unit is momentarily out of service).

Device model (RGK-60, RGK-50 etc.) of the selected unit

Free name associated with this unit.

IP address of the gateway to which the unit is connected. Used only when working in with TCP/IP connection.

Port number of the gateway to which the unit is connected. Used only when working in with TCP/IP connection.

Doc. MSGB203921.doc

21 December 2007

P. 8 / 51

Fig. 2.3 - Configuration-Options-Modem phone book If the program is configured for connecting via modem, it is possible to store a list of the various installations, defining a code, a name and the corresponding phone number of the modem on the field. This way, when wanting to connect with a particular group, it will be possible to dial it directly from this list. For each installation it is possible to define if one or more units are installed and associate an initial page to be downloaded every time connection is made to that particular installation. When the user executes a modem call to one of the installations stored in this list, the program scans the connected units (the total number of units is to be specified in Units column) and, for each of them, extracts one name that will be used to identify it. This name is read from the internal memory of the RGK (see RGK identification field in the Modem parameters window). These data are used in place of the ones stored in the Unit window explained in the previous chapter. For further information see the Modem call chapter.

Installation code. They must all be different.

Description of installation

To enter a new record, first click on New, fill the fields and then click on Add.

Phone number of modem to be called

Number of RGK units connected to the modem (if in 485). To eliminate a record, first select it in the table, then click Remove button.

Name of page to be loaded when connecting.

To modify an existing record, first select it from the table, then do your modification in the field above, finally click on Update.

Doc. MSGB203921.doc

21 December 2007

P. 9 / 51

Fig. 2.4 - Configuration-Options-Data log Through this page it is possible to define whether the program has to collect data or not from the RGK unit or units connected. Data log means reading the value of certain measures which takes place at regular intervals. Note: When using modem connection the data log function is disabled, since this type of connection is temporarily.

Time interval between one reading and the next

Defines how many days the data collected remain in storage in the data collection database before being eliminated

Chooses the RGK from which to sample

Selects the datum to be sampled

Adds an item to the list of the data to be sampled entering the unit and measurement chosen in the pulldown boxes.

Eliminates the item selected from the list. Note: Eliminating a field from the Data Log database structure involves the loss of the records currently stored.

List of the data to be collected. These data can be used to be displayed in graphic form, to be exported in other formats.

Doc. MSGB203921.doc

21 December 2007

P. 10 / 51

View Menu
Data log
The variables defined in the Data log configuration page (Fig. 2.4) are sampled cyclically by the program, with an acquisition speed defined by the user with the Sampling period setting, and then saved in the database with the date and time. When defining the Sampling period, pay attention to the amount of space available on the disk. For example, setting a sampling period of 5 seconds, as many as 17280 records a day would be saved, each with the date, time and value of every variable included in the Data log list. In order to limit the occupation of storage of the files on the disk it is possible to automatically eliminate from the database samples older than a required number of days. Setting for example Keep data of last days at 7, the samples of the last week will be kept in the database. The Data log database resides in the rgk.mdb file, in the program set-up directory. It is a normal Ms-Access file, that can also be read from other applications. The Data log is stored in the DataLog table. The data collected can be displayed in table form with the View-Data log menu, or clicking the corresponding icon on the toolbar. Fig. 3.1 View-Data log
Date and time of sampling Number of records chosen Values of variables sampled

Period chosen for viewing. It takes the values included in a certain interval of time from the database.

Opens the window with which it is possible to specify the interval of time to be chosen

Views all the records of the database

Allows the data selected to be exported in ASCII or Excel text format files

Deletes the data selected from the database.

Doc. MSGB203921.doc

21 December 2007

P. 11 / 51

Alarms
Selecting the View-Alarms menu it is possible to call up the window shown below, which displays any active alarms on the devices connected. The table viewed can be exported in a file text or printed using the buttons provided. The total number of active alarms is always viewed also on the main page status bar.
Name of RGK unit on which the alarm has occurred. Total number of active alarms Description of alarm

If the option to automatically open the alarm window has been selected, after acknowledge of the alarms the window can be closed.

Saves the table contents in a text file

Prints the table.

Closes the Alarms window

Doc. MSGB203921.doc

21 December 2007

P. 12 / 51

Events
With the View-Events menu it is possible to view the list of events recorded by the RGK selected, in the same form in which they would be viewed from the front panel of the apparatus.
Name of the unit to which the events refer

Saves the table contents in a text file

Prints the table.

Closes the Events window

Doc. MSGB203921.doc

21 December 2007

P. 13 / 51

Graphs
The data collected in the Data log database can be viewed in the form of graphs (trend). This way it is possible to obtain a clear impression of the trend of the more important measurements, or compare on the same graph the magnitudes coming from several different parts of the system. To open the graph window, choose the View-Graph menu or click on the corresponding icon on the toolbar. The operating criterion of this type of graph is very similar to that of an oscilloscope. The time is shown on the abscissa axis (horizontal). The horizontal time scale is common to all the measurements viewed, and it is represented with the indication of the date and time of sampling. It is possible to view up to 4 overlaid graphs choosing the measures to be traced among those available in the Data log database and using the four pull-down boxes, each matched with a colour of the tracing. For each measurement it is then possible to modify the vertical scale using the + and buttons. To establish the value of the measure in a given moment, an indication is available that says the equivalent of a vertical square (division). For example if 50V / div is shown and the graph is 8 squares in height, the measure is approximately 400V. The graph occupies an area of 240 horizontal divisions by 10 vertical ones. When it is opened, the window is set to display the data of the current day, i.e. from 00:00:00 of the current day to 00:00:00 of the next day. Through the special Choose period button it is possible to choose the start and end period of the display. If the data for a certain period of time are not available in the database (for example because the program has been inactive) a line is traced with a darker colour than normal. Fig. 5.1 View-Graph
Dark colour = data not available Bright colour = data sampled Graph horizontal scroll

Chooses the measure to be associated with the red tracing

Chooses the start / end of viewing

Increases / lowers the vertical scale

Vertical scale red tracing = 4 V / square

Prints the window viewed

Doc. MSGB203921.doc

21 December 2007

P. 14 / 51

I/O Status
The input/output status of the RGK can be viewed through the View-I/O Status menu which calls up the window illustrated. This shows the digital inputs (i.e. the ON-OFF signals leading from the generator set that are read by the board) and the outputs (i.e. the internal board relays, for controlling the generator set). Since the RGK makes it possible to associate each terminal with a user-selectable function, the present Input / Output functions are read from the device the moment the window is opened. The active status is shown in red, while the rest condition is shown in the neutral background colour.

Shows the function and status of the expansion Input / outputs.

Doc. MSGB203921.doc

21 December 2007

P. 15 / 51

Password
Application password
When the program is started some of the functions are deactivated. Using the menu Password-Password for remote control application it is possible to enter the password that allows access to all the functions, i.e.:

Modifying the settings of the remote control Modifying the password Eliminating records from the Data log database Accessing the page editor Modifying the set-up parameters of the RGKs connected

Fig. 8.1 Password

At the time of first set-up the password is LOVATO. The user can then record a new personalised password, clicking on the New password button and entering the newly chosen password twice consecutively. Fig. 8.2 New password

Doc. MSGB203921.doc

21 December 2007

P. 16 / 51

Unit Password
Starting from RGK internal software revision 28, it is available a protection system based on passwords that are stored into the RGK units, that allows to lock unauthorized access from the serial interface ports. These passwords are called Unit passwords, because they are stored into the devices memory and must not be confused with the Application password described in the previous chapter, that locks some of the function of the remote control software at PC-level. The protection system is based on 3-levels passwords:

Guest Password- Allows to read the status of the RGK but not to send commands or settings. User Password - Allows to read the status (like Guest password) and to send command and settings, that is to change operating mode, clear meters, modify setup settings etc. Administrator Password Allows to read the status, send commands and settings (like user password) and to define/modify/delete the password themselves.

Each password is made by a string of max 8 alphanumeric characters. If a password is lost, it will not be possible to access to the RGK unless a higher level password is available. Warning: After losing all the passwords, remote access to the RGK will no longer be possible and the device will have to be sent back to the technical service. All the devices are shipped from the factory without passwords, thus without any active protection. This allows free use of the RGK to users that are not interested in activating the protection system. To enable the protection system on a new RGK, the first thing to do is define the administrator password. Select menu Password-Define unit password. The window in picture will be shown, where it is possible to define the administrator password. During password definition, each new password must be entered twice, in order to avoid possible keystroke errors, since the password is shown like a series of asterisks.

Enter two time the desired administrator password and click OK. This stores the new password in the RGK. If more than one RGK unit are connected, it is possible to define or enter the same password for all the units at the same time. At this point, if it is necessary to define the lower-level passwords, select again Password Define unit passwords and define the Guest and /or the User passwords. When trying to connect to a device that has the password system enabled, the following window is automatically opened, asking to enter the password for login.

Enter the password correspondent to the desired level (guest, user or administrator). If the password is correct, the access will be allowed with the functionality of the correspondent level. If instead the password is not correct, access will be denied. If the user wants to retry the login, it is possible to recall the password entry window by selecting menu Password Enter device password or by clicking on the toolbar icon correspondent to the desired password level. If there are more than one unit connected, it will be possible to enter a single password for all the units, selecting the dedicated checkbox.

Doc. MSGB203921.doc

21 December 2007

P. 17 / 51

Communication menu
Online
With the Communication-Online menu it is possible to resume the serial connection when it has been paused by the operator through the Offline command. When choosing to reactivate serial communication, the program runs a scan of all the RGKs configured in the network to check their status.

Offline
With Communication-Offline the user has the possibility to temporarily suspend serial communication between the PC and the RGKs. When the program is in this mode, the indicators are shown in the rest condition and Data log is suspended. This command is to be used for example when wanting to temporarily disconnect the RS232 communication cable, or if wanting to cut off the supply to the devices connected. The Offline system status is shown by a panel on the main window status bar (at the bottom of the screen). The system passes automatically to the offline mode when the Options or Page editor configuration is accessed.

Modem call
This option is available only if the program has been configured for connecting via modem (see the Configuration-Options-General window). This choice brings up a window in which it is possible to make a call via modem from the PC to a station with an RGK fitted with modem. Once the window illustrated has been opened, from the pull-down box choose the name of the installation with which you want to be connected. The names entered in the Modem phone book during configuration will be displayed. Once the choice has been made, the corresponding phone number appears in the box below. Click the Dial button to start the connection procedure.

At this point the program will instruct the modem to make the call. While waiting, the sliding blue bar of the maximum time allowed for making the connection will be seen (1 minute). The modem called will take the line and exchange the usual handshaking messages with the calling modem. At the end of this procedure, if everything has been carried out correctly, the PC monitor will show a window informing the user that connection has taken place and the program will switch automatically to the Online mode. If any errors occur, carefully check the connections and if necessary follow the Guide to solving connection problems given in appendix B of this manual. Normally connection is not critical since very common and absolutely standard procedures are used. With the Break button it is possible to block the calling procedure, while Hang up ends a communication already in progress.

Doc. MSGB203921.doc

21 December 2007

P. 18 / 51

Wait for incoming calls

Choosing this option the program sets to the call standby mode, in which the PC answers incoming calls on the modem. In this case, it is presumed that there are one or more RGKs on the field programmed for making an autonomous call to the PC in the case of alarm or at periodical intervals (on this subject see the Modem parameters paragraph). When an RGK calls, the PC connects and records the date, time and identity of the caller in a text file that can be viewed using the View calls log button. If the user is in front of the PC at the time of the call, there will be the possibility to remain connected and check the nature of the problems. Conversely, if the PC station is unattended, after a few seconds the PC will close the connection automatically, recording in the file that the call has not been controlled by the user. Later the user may check how many and which calls were received during his absence and possibly connect manually with the RGK under alarm. In fact these calls will be highlighted in blue and they will have the User Ack set at No. Selecting a recorded call, it is possible to change its status to Controlled Call through the Checked button or eliminate it definitively from the list through the Delete button. The list of calls is stored on disk in the ASCII text file Modemcal.txt, located in the same directory as the RGK.exe application.

When a call from a device is stored in the incoming calls table, the following fields are available: Date / time Incoming call from User ack Call back phone number RGK status Time stamp Date and time of the incoming call (when the call reached the PC) Name of the device that made the call The user acknowledged the call from the PC The number to dial to call back the device Status of the device that called (Operating mode, engine status, voltage status, load status) Date and time of the event (available only for some device models)

Hang up
This command interrupts a modem connection, closing the telephone line. It is the equivalent of hanging up the handset in an ordinary phone call. It is carried out automatically every time you exit the program.

Doc. MSGB203921.doc

21 December 2007

P. 19 / 51

Parameters menu
Setup
Access to the RGK set-up parameters is gained through the Parameters menu. Clicking Parameters-Setup views the window shown below, with the tree that represents the structure of the menu of the device.

The menu structure gathers all the information concerning the parameters, for example code, description, minimum, maximum, default values etc. These pieces of information are stored in special files on the disk. When the software is installed, the files that refer to the currently used parameter structure are copied. This normally allows immediate access to parameter setting. If however changes are made to the software inside the device which involve modification of the structure of the parameters (for example a parameter is added or the setting range of an existing parameter is modified), once connected to a board with new revision, the program will automatically indicate the need to create the file with the new structure, downloading it from the device.

Answering Yes the downloading procedure will be started. At the end of this operation, which may take a few minutes, it will be possible to access the parameters of the new board. The downloaded data will be stored in the special file and afterwards it will no longer be necessary to repeat this operation.

Doc. MSGB203921.doc

21 December 2007

P. 20 / 51

Access to the parameters

To view one of the Set-up menus, double click on the corresponding item of the tree in the Set-Up Parameters window. The window below is shown which views the values set currently in the RGK. It is possible to carry out modifications and transmit them immediately to the device through the Transmit button.

Parameter code

Description of menu selected

The yellow boxes indicate the parameters that differ from the default values

Drag with the mouse to set the value

Parameter description

Double click to enter a new value with the numerical keyboard

Transmits and stores in the device only this menu

Re-reads the values from the board and views them

Resets the factory values for this menu

If the parameters are altered on the screen without being transmitted to the RGK, when the window is closed a message will be shown asking whether to lose the changes or leave the possibility of transmitting them to the device.

Doc. MSGB203921.doc

21 December 2007

P. 21 / 51

Alarm table
Unlike all the others, the menu with the alarm table is presented with boxes through which it is possible to activate or deactivate the single properties, in the same way as can be done acting directly on the RGK front panel.
Alarm code and description Boxes for enablingdisabling properties Alarm properties Slide the bar to access the following alarms

Transmits and stores this menu only in the device

Re-reads the properties of the alarms from the board and displays them

Resets the factory values for this menu

Save on file
The values of the set-up parameters can be saved on the PC disk in an ASCII text file, in order to be able to reload them in another device in an extremely convenient and quick manner. When this command is performed the values of all the menus are saved in the file. This function is useful when needing to program a series of devices with the same settings, or when wanting to keep a file of the original settings of a board. To save the parameters on disk, choose the Setup-Save on file menu from the Setup Parameters window and enter the required name. The extension associated with this type of file is .PAR.

Load from file

To carry out the reverse operation, i.e. transfer a file from the PC to the RGK, use the Setup-Load from file menu. In this case the parameters are read from the file and transmitted and stored in the RGK. During this operation a re-reading cycle is performed of the parameters that have just been transmitted to check that the operation has been performed correctly.

Print
It is also possible to obtain a printout of the settings which can be useful to file together with the system documents, using the Setup-Print menu.

Doc. MSGB203921.doc

21 December 2007

P. 22 / 51

Modem parameters
If modems are used for remote control, it is necessary to program certain parameters in the RGK needed to control the modem connected to the RGK itself. Due to their particular structure, these parameters are not available on the keyboard-display of the device, and may therefore only be set through a PC and remote control software. As it is necessary to program these parameters before being able to use the modem, this programming is usually carried out connecting the PC and the RGK directly with the RS-232 serial cable. When a modem is used it is possible to configure the RGK so that it answers only calls from the PC or so that it can autonomously call the PC in the case of particular events (call against alarms or at fixed intervals). It is also possible to connect the RGK to a GSM modem, i.e. to a device that combines a conventional modem and a cell phone, to be able to make calls also from stations with no telephone line. In this case it will also be possible to make the RGK send SMS messages or send electronic mail messages, still as a result of an alarm or when a fixed interval of time has elapsed (note that sending E-mails through an SMS is a service supplied only by some phone companies). The window shown below contains all the parameters needed to perform the above-mentioned functions:

Modem general enable

Description needed to identify the caller

phone number RGK end

Any modem initialization command (normally not necessary)

Type of telephone line (normally Tone)

Enable SMS commands

Password for SMS commands

AutoCall enable Choice of type of modem standard / GSM

Enable calls to PC x2

PC telephone no. x2 SMS messages address autocall x 3

Call enable in case of alarm Periodical call enable Call enable in case of gen-set intervention

Enable sending SMS x3

Autocall E-mail address

Call enable when load is switched back to mains Call when operating mode changed to non-AUT Disables calls when the RGK is not in the AUT mode Call enable after each automatic test Time of the day for periodic calls Telephone number for sending e-mail via SMS. Depends on the service operator. Transmits and stores the parameters in the RGK Reads the parameters from the RGK and views them in this page

Code needed to direct an SMS to an email box. Depends on the service operator.

Doc. MSGB203921.doc

21 December 2007

P. 23 / 51

Page editor
The page editor is the part of the remote control software that allows the user to make personalised screens, inserting animated indicators and fixed objects to view the information from the RGK in the most appropriate form for representing the status of the generator set. This subject, which would be an integrating part of the configuration, has been left as the last subject of this manual as it is intended for users who are highly familiar with the use of the PC and with the problems involved in serial communication. To access the page editor, enter the password and call the Configuration-Page editor menu. It should be noted that during the construction of pages and when modifying the Options window, the program sets to the Offline mode, i.e. communication with the RGK is interrupted. As soon as it is activated, the page editor shows an empty page. Through the File menu it is possible to carry out the usual load, save and create new page operations, It should be noted that the pages handled by the program are all located in a folder (called \PAGES\ENG when the program is set in English) and that the page loading and saving operations are only carried out in that folder. For this reason the loading and saving windows are not the usual Windows ones but in a simpler form.

Pages of non-associated type can assume different aspects according to what model of RGK is momentarily selected. The same page-file stores all the page versions correspondent to the various RGK models. For instance there is a version of the MAIN page that is displayed when connected to a RGK-60, and a different version of the same MAIN page that is displayed when connected to a RGK-50, that does not support the Mains voltage controls. If the user wants to edit a page, it will therefore be necessary to specify which version he wants to work on. When opening a page, a window will ask for the device model sub-page to be edited.

Doc. MSGB203921.doc

21 December 2007

P. 24 / 51

The paragraphs that follow describe the page editor functions and guide the user in the creation of a trial page. Step 1 The first operation the user has to do is to define some general properties of the new page, such as the header, background color and any background image. To do this, click on the Page-Properties menu and call the window shown below: Fig. 10.1 Page-Properties

Text that will appear on the header bar

Page background colour.

If necessary, specify here the name of any graphic file that will act as background for the page. The sizes of the original file must be compatible with those of the page. Allows the choice of any background graphic file. BMP, GIF and JPG formats are supported.

Interval between successive refresh of the page data. Setting this field to 0 (default), the page will be refreshed at the maximum rate allowed by the communication line, while setting for instance 5 sec, will cause the page data to be updated once every 5 sec, reducing when necessary the traffic on the communication network.

Chooses the background colour

Step 2 At this point, let us suppose that in our page we want to insert an indicator of the dial gauge type showing the mains L1 phase voltage. We choose the Indicator-Add menu or we click with the right mouse button on an empty point of the page and choose Add indicator from the pop-up menu. The window below will be shown: Fig. 10.2 Indicator-Add-Indicator type

Choose one of the indicators available

Click this button to enter a new indicator of the type required.

Doc. MSGB203921.doc

21 December 2007

P. 25 / 51

We choose the button with the dial indicator and then click on the Insert new indicator button. At this point, the required indicator will appear on our page, with the standard position and dimensions. At the same time the window proposes the base indicator settings: Fig. 10.3 Indicator -Properties
Indicator position. The coordinates 0,0 represent the page top left corner. The objects can also be moved using the Move tool on the toolbar and dragging them with the mouse Definition of the size to be viewed. Choose from which RGK and which measurement to be associated with the indicator that has just been inserted. Warning! Not all the Indicator-size combinations are possible. If the size is not compatible with the indicator, it will be notified with a message.

Indicator dimensions. Some indicators have fixed proportions, in this case the dimensions are changed with the width parameter

The window of Fig. 10.3 is shared by all the types of indicators. When specifying the device from which to take the measurement, bear in mind that:

If an RGK is selected from the Select unit box among those defined during configuration, the measurement shown by the indicator will always be taken from the same RGK. This solution should be adopted when wanting to insert measurements from different RGKs in the same page (see the Basic principles chapter). If the Select unit box is left on the Default unit setting, the indicator will show the measurement coming from the RGK selected at that moment in the main window (see Fig. 1.1). Making a page with all the indicators not associated with a particular RGK, this page will be able to show the measurements from the RGK selected each time.

We set the position and dimensions of our dial indicator, then we specify that the measurement is to be taken from the default RGK and lastly we choose the measurement we are interested in among the possible ones, which in our example is Mains voltage L1.

Doc. MSGB203921.doc

21 December 2007

P. 26 / 51

At this point we can move to the Options page of the Indicator window and complete some general options of the Gauge indicator. These options vary depending on the type of indicator chosen. In our case, for instance, we disable the Use default description box and we complete a personalised description to be shown on the dial indicator. Fig. 10.4 Indicator-Options (for Gauge 1 type indicator)
Chooses whether to show the standard description or a personalised description of the measurement on the indicator

Text of personalised description

Chooses whether the full scale value of the indicator is adapted automatically to the RGK setting or whether to specify a personalised full scale value.

Space for specifying any personalised full scale value

Clicking on OK the settings are applied to the dial indicator and the window is closed. Following the same procedure it is possible to add other indicators to our page. If we want to modify the settings of an already entered indicator, click on it to select (the indicator is highlighted by a frame) and then use the Indicator-Modify menu or use the mouse right button to call the Modify pop-up menu. In the same way, after selecting an indicator it can be eliminated using Delete. Step 3 At this point we have made a very simple page which can however be loaded and displayed. Then we save through the File-Save As menu and we use the name MYPAGE. This command will create an ASCII file called MYPAGE.PGD located in the \PAGES\ENG directory together with other pages. For anyone concerned, the contents of the file can be analysed and if necessary modified with a normal text editor. Step 4 We close the page editor with the File-Exit page editor menu. The program loads the main page again (Fig. 1.1) or the page with the RGK stations (in this case choose one of the stations to open the main page). This time the pull-down box for choosing the pages (Fig. 1.1) will also contain our MYPAGE page. Choosing it, the page will be loaded and the indicator will show the required equivalent voltage. At this point, we have concluded the minimum indispensable sequence for making a personalised page. In order to allow the user to exploit the potential of the program we are now going to describe the characteristics and options of all the indicators available.

Doc. MSGB203921.doc

21 December 2007

P. 27 / 51

Types of Indicators
Label indicator The Label indicator shows a measurement leading from the RGK in numerical form.

Description. It can be the default one or the personalised one of the measurement. It is possible not to display it.

Numerical value of the measurement

Unit of measurement. It is possible not to display it. It changes scale automatically depending on the value displayed (e.g. W, kW, MW)

Fig. 10.5 Indicator-Options (for Label type indicator)

Doc. MSGB203921.doc

21 December 2007

P. 28 / 51

Gauge 1 Indicator
Unit of measurement.

Scale. It can be the maximum one of the RGK (see fig. 2.2) or personalised

Description. It can be the default one or the personalised one of the measurement..

Numerical value of the measurement

Fig. 10.6 Indicator-Options (for Gauge 1 type indicator)

Doc. MSGB203921.doc

21 December 2007

P. 29 / 51

Gauge 2 indicator

It is possible to use the default scale or personalise the minimum and the maximum

Fig. 10.7 Indicator-Options (for gauge 2 type indicator)

Doc. MSGB203921.doc

21 December 2007

P. 30 / 51

7-segment Indicator This works in the same way as the Label type indicator, but the value is shown with 7 LED segments.

3 digit display with seven segments

The unit of measurement changes automatically depending on the value displayed (e.g. W, kW, MW)

Fig. 10.8 Indicator-Options (for 7-segment type indicator)

Doc. MSGB203921.doc

21 December 2007

P. 31 / 51

Bar graph indicator

The full scale value corresponds to the maximum value foreseen in the RGK or it can be specified manually

Numerical value

Unit of measurement

Fig. 10.9 Indicator-Options (for bar graph type indicator)

Doc. MSGB203921.doc

21 December 2007

P. 32 / 51

Meter indicator
The digits after the decimal point are on a white background

Meter value

Unit of measurement

Fig. 10.10 Indicator-Options (for meter type indicator)

Number of meter digits. It must equal or be higher than those of the measurement to be shown

Doc. MSGB203921.doc

21 December 2007

P. 33 / 51

On-Off indicator The on-off indicator serves for displaying a digital status leading from the RGK. It may be of two different kinds:

Normal: A rectangle with a description that changes the color of the background depending on the status of the variable. The color for OFF and the one for ON can be chosen freely.

Graphic: Two graphic figures read from bitmap files of the same size. The first is displayed when the status is off and the second when it is on.

Fig. 10.11 Indicator-Options (for on-off type indicator)

Defines whether the indicator has to have a 3D border around the coloured part or not. Chooses the colour for on (normal indicator) Chooses the colour for off (normal indicator) Chooses the file name for on. The file must be in the same directory as the page

Chooses the file name for off.

Chooses the graphic indicator type

Doc. MSGB203921.doc

21 December 2007

P. 34 / 51

Circular indicator This type of indicator is devoted to displaying the parameters of the engine, in particular of the following measurements: Battery voltage Fuel level Oil pressure Water temperature

Fig. 10.12 Indicator-Options (for circular indicator)

Doc. MSGB203921.doc

21 December 2007

P. 35 / 51

Unit status indicator This indicator differs from the previous ones because it is not associated with a particular measurement, but with a whole unit, i.e. with an RGK among those connected to the PC. It is used when there are more than one RGKs connected at the same time in the RS-485 network. This indicator groups together all the main information, described in the figure below:
Operating mode: may be OFF, MAN, AUT, TEST. Background colour: Red = alarm Neutral = OK

Engine status: RUN = running STOP = stopped

MV = Mains Voltage Mains voltage status. Green = Voltage OK Grey = beyond limits

GV = Generator Voltage Generator voltage status Green = Voltage OK Grey = beyond limits

Network contactor status Green = Closed Grey = Open

Generator contactor status Green = Closed Grey = Open Code for identifying the RGK unit

Examples of indication:

Unit under alarm, RESET mode, engine stopped, voltages not present, contactors open.

No alarms, RESET mode, Engine stopped, Mains voltage present, mains contactor closed.

No alarms, MAN mode, Engine stopped, Mains voltage present, mains contactor closed.

Doc. MSGB203921.doc

21 December 2007

P. 36 / 51

Types of Objects
Besides the indicators, other objects can be inserted in the page, some of which are fixed (for example fixed wordings, lines, images, etc.) and others with an active function (for example control buttons). These objects are inserted and handled in a way very much like the one described previously for the indicators. Through the Object-Add menu it is possible to open the window that allows you to choose the type of object and specify its properties. Fig. 11.1 Object-Add

The types of objects available are the following:

Fixed text Rectangle (line) Picture 3D panel Control button

Fixed wording with variable color and dimensions Coloured rectangle. Lines can be obtained changing the height and width. Rectangle containing a graphic file Fixed wording on a 3D panel. Button with which determinate actions can be associated

Like the indicators, also the objects have different properties depending on the type of object. In the following pages we are going to explain the function of these properties.

Doc. MSGB203921.doc

21 December 2007

P. 37 / 51

Text Object This enters a fixed wording on the page background. Fig. 11.2 Object-Text-Properties

Wording text

Character format

Defines whether the wording background has to have its own colour (the one defined in this window) or if it has to be transparent

Rectangle Object This allows you to draw a coloured rectangle. Changing the dimensions it is possible to obtain horizontal or vertical lines of variable thickness.

Image Obect Inserts a square containing an image in BMP, JPG or GIF format. Fig. 11.2 Object-Image-Properties

File name

Defines whether the image has to keep its original dimensions or deform to follow those set for the object

3D Panel Object This works in a similar way to the text object, with the only difference that the wording is overlaid on a panel with a relief effect.

Doc. MSGB203921.doc

21 December 2007

P. 38 / 51

Pushbutton Object The pushbutton object is an active object. Pressing it with the mouse can be associated with a series of user-selectable commands. Therefore, in the properties window, besides defining the usual settings such as position, dimensions, text etc. it will also be necessary to define the associated action and any parameter. The actions that can be associated are the following:

COMMAND Sends a command to the RGK. In this case the operand defines which type of command to send. The possible commands are the following: Change operating mode OFF-MAN-AUT-RESET Manual Start-Stop of the engine Manual changeover of the mains and generator contactors Meters resetting : Energy, engine hour counter, maintenance interval, crank counter, rent hours. Reset of alarms without changing operating mode. END Exits the program

NEWPAGE Loads a new page. In this case the operand must be chosen among the names of the pages available. NEWNODE Selects a new RGK. In this case the operand must be chosen among the list of the units configured. MODEMCALL Makes a call to the number of the modem whose code is specified in the operand field.

Fig. 11.3 Object-Button-Properties

Text shown inside the button

Box for choosing the action to be associated with the button

Operand linked with the action chosen.

Defines whether the button is always enabled or only after entering the password.

Doc. MSGB203921.doc

21 December 2007

P. 39 / 51

Initial page generation

When the program is started, a page is loaded automatically with the following criterion:

If only one RGK has been configured, the page named MAIN is loaded. Conversely, if more than one unit have been configured, the page named START is loaded.

The above-mentioned names are valid when the software is configured in English. If required, the user can personalize these pages too, using the page editor, but the MAIN.PGD and START.PGD files must not be eliminated. The possibility exists of automatically creating the START page with a panel for every RGK configured in the network (see fig. 2.2). This operation may be carried out after completing configuration, opening the page editor and choosing the Page-Generate initial page menu. This way the program automatically generates the START.PGD page, entering a status indicator for every RGK, i.e. a panel that supplies all the main information about the status of the unit. Double clicking on one of these panels, it is possible to immediately open the main page with the information about the station selected. After generating the page, the user has the possibility to personalize it according to preference using the usual editor commands. The window below shows an example of an initial page generated automatically starting from a network with four RGKs configured:

At this point a background image could be added with, for example, the layout or diagram of a system. When the program is installed for the first time an initial page is supplied with only one RGK. It can be overwritten by the one personalized by the user and it will be loaded automatically the next time the program is started or selecting the View Initial Page menu.

Doc. MSGB203921.doc

21 December 2007

P. 40 / 51

APPENDIX A Connection modes

Direct RS-232 connection For direct RS-232 connection use the Lovato cable code 51C2. The cable can be connected also with the RGK and PC already powered. If everything is correct, starting the program it will be possible to switch directly to the Online mode. Please be reminded that this connection mode, which, due to its immediacy, is the one more frequently used, should be used during RGK installation, set-up or maintenance, but it is not suitable for a permanent type of connection, because by nature the RS232 interface cannot reach long distances and may be affected by interference in an industrial environment.

In the event of problems If the connection does not work (attempting to switch Online the program beeps and switches automatically to the Offline mode) carefully check the following points:

The number of the COM: port of the PC used must correspond with that programmed in the Configuration-Options-General-Serial port menu. The PC serial port must not be already used by another application. The serial address set on the RGK (in the Communication port menu) must be 01. The speed of the PC serial port (selectable with the Configuration-Options-General menu, default 9600 baud) must correspond with the one set in the device (in the Communication port menu, default 9600 baud) The cable must be intact and correctly connected (from the RGK end it must be connected to the 6-pin RJ connector on the back of the device). The RGK must be powered and working.

Doc. MSGB203921.doc

21 December 2007

P. 41 / 51

PC-RGK connection via RS-485 (RGK without internal RS-485 interface) Connection via the RS-485 interface involves the use of an RS232/RS485 converter for every node, i.e. one converter for the PC plus one converter for each RGK to be connected (from a minimum of 1 up to a maximum of 99 RGKs). The connection from the PC to the converter is through the Lovato cable code 51C4, while the one between the RGK and the converter is with cable code 51C6. The RS-485 outputs of the converters should then be connected in parallel on Bus 485, formed of a screened duplex cable. Refer to the manual supplied with the converters for further details.

In the event of problems If the connection does not work (attempting to switch to Online the program beeps and switches automatically to Offline) carefully check the following points:

The PC COM: port number must correspond with the one programmed in the Configuration-OptionsGeneral-Serial port menu. The PC serial port speed (selectable with the Configuration-Options-General menu, default 9600 baud) must correspond with the one set in the devices (in the Communication port menu, default 9600 baud) If more than one RGKs are connected, they must be programmed with different serial communication addresses (01, 02, 03 etc). To set the RGK serial communication address, program the corresponding parameter in the device Communication port menu. The connection bias of the converters to the RS-485 bus must be correct (all the terminals marked A on one lead and all those marked B on the other). The maximum distance between the two farthest devices on the RS-485 bus may not exceed 1000m. All the converters must be powered and correctly configured (see the instructions provided with the devices). In particular, the converter at the PC end must be programmed in the automatic switching mode (date). If a converter supplied by Lovato is used, when there is communication on the RS-485 line, the yellow DATA led on the converter front panel flashes quickly.

Doc. MSGB203921.doc

21 December 2007

P. 42 / 51

PC-RGK connection via RS-485 interface (RGK with internal interface) The connection of RGK units requires only one converter for the PC end. To connect the PC to the converter use a Lovato cable code 51C4. The connection between the RGK Units and the RS-485 bus is made directly with duplex cable.

In the event of problems If the connection does not work (attempting to switch to Online the program beeps and switches automatically to Offline) carefully check the following points:

The COM: port number of the PC used must correspond with the one programmed in the ConfigurationOptions-General-Serial port menu. The PC serial port speed (selectable with the Configuration-Options-General menu, default 9600 baud) must correspond with the one set in the devices (in the Communication port menu, default 9600 baud) If more than one RGKs are connected, they must be programmed with different serial communication addresses (01, 02, 03 etc). To set the RGK serial communication address, program the corresponding parameter in the Communication port menu. For correct connection bias, terminals A11 of the RGK are to be connected to terminal A of the converter, and terminals A12 with terminal B. The maximum distance between the two farthest devices on the RS-485 bus may not exceed 1000m. The converter at the PC end must be powered and correctly programmed in the automatic switching mode (date). If a converter supplied by Lovato is used, when there is communication on the RS-485 line, the yellow DATA led on the converter front panel flashes quickly.

Doc. MSGB203921.doc

21 December 2007

P. 43 / 51

Connection via standard modem To make a remote connection via a switched telephone line the use of a pair of modems is necessary. Lovato guarantees correct operation of the connection using modems of the following type:

3-Com U.S. Robotics 56K model 5630

Though correct operation is possible also with modems of other types, in this manual all the configuration commands (variables depending on the manufacturer) and the connection diagrams will refer to the abovementioned modem model. Though very simple in conception, connection via modem requires that the installer have a minimum of experience concerning the problems connected with serial communication, modem programming, types of telephone lines, etc. In an attempt to simplify the configuration procedure as far as possible, we have subdivided the operations to be carried out in the following steps: 1. Modem configuration at the RGK end From the RGK end the modem must be configured before it can be used. Configuration serves to implement the following functions: Disable the echo Set a communication speed fixed at 9600 baud Permanently store the two previous settings as default at switch on To make these configurations, the modem to be connected to the RGK will have to be momentarily connected to the PC with its standard cable. Then start the PM.EXE program (supplied together with this software) and press the Program modem button. Wait for the confirmation message and then disconnect the modem from the PC and connect it to the RGK. The PM.EXE program transmits the following configuration string to the modem: AT E0 &N6 &U6 &W0 <CR> (commands valid for modem model 5630)

If the user is familiar with terminal emulation programs (such as Windows Hyperterminal) this programming can be done manually without the aid of the PM.EXE program. In this case, it will be necessary to set the serial interface at 9600 Baud, 8 bit, No parity, 1 stop bit and type in the above string from the keyboard. On pressing return the modem will answer with OK confirming that programming has taken place. 2. RGK configuration Also the RGK needs a configuration to be able to converse with the modem. Connect the PC to the RGK with the direct RS232 cable code 51C2. Check that the software revision in the RGK is 11 or higher Set the password From the Online mode, choose Modem parameters from the Parameters menu (see description on previous pages). Activate the general modem enable (first option at top left). If you want the RGK to call the PC on its own initiative, activate the enable calls from RGK and Connect to PC boxes, specifying the PC modem telephone number and the conditions that will determine the call (against alarm, periodical, etc.) Transmit and store the settings with the Transmit button 3. System connection Connect the modem programmed at point 1 with the RGK using the cable code 51C5 Connect the second modem to the PC with the standard cable provided with the modem. The PC-side modem does not require any particular programming (it must be left at factory defaults). Connect both modems to the respective telephone lines. For the first tests you are advised to use two internal lines in the same office to keep the call under control.

Doc. MSGB203921.doc

21 December 2007

P. 44 / 51

4. Configuration of the RGK.exe program Start the RGK.exe program from the PC with the modem already connected and powered. Choose the Configuration-Options menu Set the Connection via modem box from the General table. If the Modem phonebook table is empty, enter a record with the name of the installation and the phone number corresponding with the telephone line of the modem connected to the RGK. Click on OK to close and save the Options window. 5. Online Connection Choose Call with modem from the Communication menu From the pull-down box choose the name of the installation to be called. The corresponding telephone number (previously loaded in the Modem phonebook) will be shown in the box below. Click on Dial At this point, the modem at the PC end calls the RGK modem. After a few rings the RGK modem and the program switch automatically to the online mode. To end the connection, choose Modem-Hang up from the Communication menu In the event of problems If during the attempted call the modem connected to the RGK does not ring, this means that the call fails to reach its destination. In this case, carry out the following checks: Try dialing the telephone number of the line to which the RGK is connected using a normal telephone. The modem called should give off sounds that ought to be heard in the handset. If this does not happen, there are problems on the telephone line or on the switchboard. Check that PC modem is powered and connected with the cable to the correct serial port (the one set in Communication-Serial port) If the modem called rings repeatedly but the connection fails to be established (the window with the wording Connection OK' is not shown): Check the RGK programming (see previous point 2) Check the RGK-modem 51C5 cable If the wording Connection OK is shown on the PC but then the program switches to Offline: Try connecting directly from the PC to the RGK with cable 51C2 and carry out all the checks described in the Direct RS-232 connection chapter Check that the modem is programmed correctly as described in the previous point 1

Doc. MSGB203921.doc

21 December 2007

P. 45 / 51

Connection via GSM modem To make a remote connection through the GSM cellular network a GSM modem needs to be connected to the RGK and a second, traditional or GSM modem has to be connected to the PC. Lovato guarantees correct operation of the connection using GSM modems of the following type:

Funkanlagen Falcom A-2

This type of modem is highly versatile and allows access to functions that are not normally possible with a traditional modem (SMS, E-mail). However, though taking place at 9600 bps, transmission via ether needs longer signal transfer times, to the disadvantage of communication speed. Though very simple in conception, connection via GSM modem requires that the installer have a minimum of experience concerning the problems connected with serial communication, modem programming, types of telephone lines, etc. In an attempt to simplify the configuration procedure as far as possible, we have subdivided the operations to be carried out in the following steps: 1. Configuration of the GSM modem at the RGK end From the RGK end the modem must be configured before it can be used. Configuration serves to implement the following functions:

Disable the echo Set a fixed communication speed at 9600 baud Disable the PIN request after switch on Set the SMS service provider number Set the SMS mode on Text mode Permanently store the two previous settings as default at switch on To make these configurations the GSM modem to be connected to the RGK should be momentarily connected to the PC with its standard cable. Then start the PM.EXE program (supplied together with this software) and press the GSM modem program button. Wait for the confirmation message and then disconnect the GSM modem from the PC. Important: A SIM-CARD enabled for data transmission is needed to make the GSM modem work. A normal SIM-CARD for cell phone does not work if used with the GSM modem. Contact the SIM-CARD Supplier to have it enabled. If the SIM card has different phone numbers for voice and data, use the phone number for data.

2. RGK configuration Also the RGK needs configuration to be able to converse with the modem. Connect the PC to the RGK with the direct cable RS232 (51C2). Check that the software revision in the RGK is 11 or over Set the password From the Online mode, choose Modem parameters from the Parameters menu (see description on previous pages). Activate the general modem enable (first option at top left). Activate the GSM Modem option If you want the RGK to call the PC on its own initiative, activate the enable calls from RGK and Connect to PC boxes, specifying the PC modem telephone number in the phone number box and the conditions that will determine the call (against alarm and/or periodical) If you want the RGK to send an SMS message in the occurrence of the above-mentioned conditions, activate one or more Send SMS options and specify the number of the cell phone to which the SMS is to be sent for each one of them. In the same way, if you want the RGK to send an electronic mail message, activate the Send E-mail option and specify the electronic mail address of the addressee in the special box. Transmit the settings with the Transmit button 3. System connection Connect the GSM modem programmed at point 1 with the RGK via cable code 51C7 Connect the second modem to the PC using the standard cable provided with the modem Power the GSM modem and wait 30 seconds for initialisation
Doc. MSGB203921.doc 21 December 2007 P. 46 / 51

4. Configuration of the RGK.exe program Start the RGK.exe program from the PC with the modem already connected and powered. Choose the Configuration-Options menu Set the Connection via modem box from the General table. If the Modem phonebook table is empty, enter a record with the name of the installation and the phone number corresponding with the telephone line of the modem connected to the RGK. Click on OK to close and save the Options window

5. Online Connection Choose Call with modem from the Communication menu From the drop-down box choose the name of the installation to be called. The corresponding telephone number (previously loaded in the Modem phonebook) will be shown in the box below. Click on Dial At this point, the modem at the PC end calls the RGK modem. After a few rings the RGK modem and the program switch automatically to the online mode. To end the connection, choose Modem-hang up from the Communication menu In the event of problems If during the attempted call the GSM modem connected to the RGK does not ring, this means that the call fails to reach its destination. In this case, carry out the following checks: Check that the signal near the GSM modem is strong enough ( > 40%). To do this, use the PM.EXE program. Check that the PC modem is powered and connected with the cable to the correct serial port (the one set in Configuration-Options-Serial port) If the modem called rings repeatedly but the connection fails to be established (the window with the wording Connection OK' is not shown): Check the RGK programming (see previous point 2) Check the RGK-modem cable 51C7 If you are using a phone line passing through a switchboard, try to use a direct line. Some switchboards alter the phone call and make it unrecognizable by the GSM modem. If the PC shows the wording 'Connection OK' but then the program goes Offline: Check the quality of the GSM signal Try connecting directly from the PC to the RGK with cable 51C2 and carry out all the checks described in the Direct RS-232 connection chapter Check that the GSM modem is programmed correctly as described in the previous point 1

Doc. MSGB203921.doc

21 December 2007

P. 47 / 51

Connection via Ethernet-to-serial gateways

The remote control software allows the connection of several devices through an Ethernet network using TCP-IP protocol and external Ethernet-to-serial gateways devices. The configuration window of the software allows to select between the standard connection (with one single serial port) or TCP-IP connection. Selecting TCP-IP, for every RGK unit, two fields become available, that allow to specify: o The IP address of the Ethernet/serial gateway device o The Port number where the RGK-60 is connected. The communication in the last segment of the network is done in the usual way, through RS-232 interface and the Lovato ASCII proprietary protocol. The maximum number of RGK-60 that can be connected is 64. The software can be run on different PCs, but not at the same time (it is possible to use only one PC at a time).

Example diagram: Ethernet (TCP-IP) RS-232 (ASCII) PC

Gateway 1 10.39.1.198
4001 4002

Gateway 2 10.39.1.199
4001 4002

Gateway n 10.39.1.xxx
4001

RGK 01

RGK 02

RGK 03

RGK 04

RGK nn

Gateway configuration Every gateway must be associated with a unique IP address on the LAN The gateway ports must be configured in TCP Server mode, without virtual COM port drivers. Gateways serial ports must be set with the same serial format set on the RGK-60 (for instance 9600bps, 8bits, 1 stop, no parity). To avoid having conflicts on the LAN, ask to the System Administrator for free IP addresses and the correct Netmask configuration. Configuration of the Remote control software In the Configuration-Options-General window, select TCP/IP connection. Without this selection, the software runs as usual with one single COM port. In the Configuration-Options-Units window, specify, for every RGK-60 unit, the IP address of the gateway and the Port number where the RGK is connected. The port number depends from which type of gateway is used. Check the gateway user manual for the correct setting.

Configuration of RGK-60 units For every RGK-60, open the M10 Communication port menu and set parameter P10.01 Serial address with a different address. The serial address of every RGK-60 must match what is set in the Configuration-Option-Units. For instance, considering the example in the previous page, the RGK-60 connected to the gateway 10.39.0.199, port 4001, must have the parameter P10.01 set to value 03. Set P10.02 to the same speed set on the gateways (ex. 9600bps) Set P10.05 with the same parity as the gateway (ex. none) Set P10.06 on Lovato Proprietary ASCII protocol.

Doc. MSGB203921.doc

21 December 2007

P. 48 / 51

Appendix B Commands with SMS messages

If a GSM modem is used it is possible to control the RGK from any cell phone sending SMS Messages. From the cell phone, the user has to send an SMS with the required commands and forward it to the phone number of the GSM modem connected to the RGK. The command syntax is very simple as most of it reflects the wording on the front panel buttons: sending for example MAN is the same as pressing the MAN button on the front panel. This way, it will be possible to control any RGK from any place that can be reached by the GSM signal. To prevent unauthorized access, the commands are to be preceded by a password defined by the user during installation. If the SMS message is not preceded by the correct password, it will be ignored. If however the message comes from one of the cell phones defined as addressees of alarm messages (see modem parameters window), the password will not be necessary. The following table lists the possible commands: COMMAND OFF MAN AUT TEST START STOP MAINS GEN PWD=<password> TIMExx INFO FUNCTION Switches to OFF mode Resets alarms Switches to MAN mode Switches to AUT mode Switches to TEST mode Simulates pressing the START button Simulates pressing the STOP button Simulates pressing the MAINS button Simulates pressing the GEN button Enters the access password Waits xx seconds before continuing to perform the commands Ask for a RGK status report

The commands can be chained and spaced by a pause: Example (assuming GENSET as access password) PWD=GENSET MAN TIME05 START Switch to manual, wait 5 sec and then attempt starting Example: PWD=GENSET OFF Switch to OFF

To enable the execution of SMS commands it is necessary to enable the corresponding box in the Modem Parameters window (see Modem Parameters chapter). In the same window the user has to specify the password intended to be used. As mentioned previously, if the cell phone used to send the commands is the same one designated as addressee of the alarm messages, it will not be necessary to enter the password. In this case the telephone number (under Send SMS..) will have to be stored in international format, for example +393359609600. Example: OFF TEST TIME90 OFF

Reset alarms, switch to TEST, wait 90sec and return to OFF

After performing a sequence of commands the RGK will answer with a status report message that will be sent to the cell phone that generated the command. The status report can also be requested by command INFO. The structure of the status report is the following: RGK Identification Operating mode Mains voltages Generator voltages Generator frequency Battery voltage Engine hour meter Engine status (running or stopped) Mains contactor status (open or closed) Generator contactor status (open or closed) RGK general status (starting, stopping, alarm, etc)

Doc. MSGB203921.doc

21 December 2007

P. 49 / 51

Example: PWD=GENSET MAN START RGK answers with: Info AIRPORT GEN-SET STATION Mode = MAN Mains = 400V,399V,400V Gen = 000V,000V,000V Freq = 00.0Hz Engine = Stop MC = On GC = Off Starting

Switch to MAN, attempt to start

RGK identification Operating mode Mains voltage Generator voltage Generator frequency Engine status Mains contactor Generator contactor General status

If the password in the SMS message does not correspond with the one stored in the RGK, the commands will not be performed and an invalid password answer will be sent. The SMS Commands function works with the same criterion and the same connection layout as the normal alarm signalling Autocall function. It is also possible to use the two functions at the same time. Refer to the Modem parameters and Connection via GSM modem chapters for the details and how to solve problems.

Doc. MSGB203921.doc

21 December 2007

P. 50 / 51

PENTIUM is a registered trademark of Intel Corporation WINDOWS is a registered trademark of Microsoft Corporation

Doc. MSGB203921.doc

21 December 2007

P. 51 / 51