sms-text message 4.00 technical instructions 7 microscada sms-text message 4.00 technical...

MicroSCADA SMS-Text Message 4.00

Technical Instructions

MicroSCADASMS-Text Message 4.00Technical instructions

1MRS755367

Issued: 29.11.2001Version: A/08.10.2004

Contents1. Copyrights .................................................................................52. General .......................................................................................7

2.1. Programs .......................................................................................72.2. WD functions .................................................................................8

3. User interface ............................................................................94. Application examples .............................................................115. Equipment ................................................................................13

Change history of the document

Document version Date Change

A 08.10.2004 Document translated in English from the Finnish original version C (03.05.2004).

©Copyright 2004 ABB Oy, Substation Automation Products, Vaasa, FINLAND 3

1MRS755367 MicroSCADASMS-Text Message 4.00Technical instructions

1. Copyrights

The information in this document is subject to change without notice and should not be construed as a commitment by ABB Oy. ABB Oy assumes no responsibility for any errors that may appear in this document.

In no event shall ABB Oy be liable for direct, indirect, special, incidental or consequential damages of any nature or kind arising from the use of this document, nor shall ABB Oy be liable for incidental or consequential damages arising from use of any software or hardware described in this document.

This document and parts thereof must not be reproduced or copied without written permission from ABB Oy, and the contents thereof must not be imparted to a third party nor used for any unauthorized purpose.

The software or hardware described in this document is furnished under a license and may be used, copied, or disclosed only in accordance with the terms of such license.

Copyright © 2004 ABB Oy All rights reserved.

5


2. General

This document covers SMS alarms and SMS commands transmitted via GSM modems in the MicroSCADA remote control system.

To transmit SMS text messages, programs that work as transmitters of SMS text messages between MicroSCADA and the transmission modem have been developed. A GSM telephone with data transfer capability or a GSM modem can be used as a transmission modem.

In order for the system to function, a computer with a serial port and a data cable for the GSM telephone or for the GSM modem are needed. The transmission modem can be connected to a workstation or to a separate communication computer from which the messages are forwarded to SYS computers. From the SYS computers the messages are transmitted to MicroSCADA if the main application in the computer in question is �HOT�.

2.1. ProgramsPrograms for transferring data:

SMSServ.exe. runs with the modem and directly with MicroSCADA in single computer systems.

SMSClient.exe transfer program in the MicroSCADA computer when the modem is in a different computer.

SMSSend.exe with this program MicroSCADA sends messages to the SMSserv.exe program.

SMSCall.exe performs wake-up calls.

All the above programs have their own *.ini files that contain the basic settings of the programs. The programs interact with each other via the TCP/IP protocol.

SMSServ.exe, and also SMSClient.exe if needed, is started up at the same time as the operating system.

The alarm transfer in MicroSCADA starts with APL_ALARM:E event channel, which starts up any time an alarm is generated in the system. The APL_ALARM:E event channel runs the SMS_ALARM:C procedure in which the actual transfer starts.

Acknowledgements are handled with the SMS_ACK:C command procedure. The transfer programs start up the procedure when they receive an acknowledgement message.

SMS_CALL1:C, SMS_CALL2:C, SMS_CALL3:c and SMS_CALL4:C perform wake-up calls.

Application specific inquiries are handled with the SMS_USER:C procedure.

7

1MRS755367MicroSCADASMS-Text Message 4.00Technical instructions

2.2. WD functionsWhen the MicroSCADA is started up or shut down, C:\Hotorcold.bat is run in the APL_INIT2:C procedure. The state of the desired application is asked and it is written to the root of the C:\ drive, to a text file named SMSSTATUS.TXT. By reading this file, the SMSServ and SMSClient programs find out the state of the main application. The state can be �HOT� or �COLD�.

When the program finds a �HOT� state, it runs the SMS_WD:C procedure with the WD cycle set in the SMSServ.ini file. This function is used to ensure that MicroSCADA is running. In addition, the programs always send MicroSCADA �state information� on the changes in �HOT� and �COLD� states as a message to the person on duty. These messages are defined in the SMSServ.ini file.

The SMSServ program communicates with the GSM modem and, if the connection to the modem is lost, the SMSServ runs the SMS_ERROR:C command procedure. The desired actions in an error situation can be programmed to the SMS_ERROR:C command procedure. The error can, for example, generate an event and an alarm to MicroSCADA, and if another modem is available, it can be used to send the alarm to a certain telephone number.

When two modems are used, the second modem can be used as a spare modem in case the serial port or the modem in use should fail. SMSServ monitors the status messages of the modem and the GSM network. In error situations, SMSServ runs SMS_CME:C and SMS_CMS:C command procedures and brings them the error code number in the %code variable.

Error code descriptions can be found for different modems; for example, the document TC35-SP-01-v2.00-at command.pdf contains the error codes for the Siemens TC35 modem on pages 131 and 132. The error codes comply with the standard and are therefore universal.

The software package includes CME_ERROR.TXT and CMS_ERROR.TXT files.

With the help of the programs, versatile information on the states of the MicroSCADA application and on the states of the alarm transfer equipment is received. However, since a usual terminal device cannot independently detect, for example, the removal of a modem cable, the transfer of alarms to the person on duty can be interrupted if the equipment is disconnected.

There is, for example, a Sony Ericsson modem available in the market, to which it might be possible to order additional programs from the importer. With these programs it would be possible to send a WD alarm also when the device is disconnected from the host computer. There is no specific information about programming these functions.

8


3. User interface

smscontrol

Fig. 3.-1 One window for using the system is available. The SMS text message transfer can be activated in this window.

The alarms are transmitted to a mobile phone one at a time. If several alarms have been activated, they are transmitted to the mobile phone after the first alarm has been acknowledged. Information on the number of alarms in queue is delivered along with the alarm text. The user can interrupt the transfer by sending a control message to the system and by restarting the system; thus, all active alarms are acknowledged.

If the �Wakeup call in use without waiting for acknowledge� box is checked, a wake-up call is made straight after the alarm message has been sent. If the wake-up call option is not selected, the system waits for an acknowledgement until the time specified in the window is up and then makes the wake-up call. The length of the wake-up call is given in seconds and it must be significantly shorter than the waiting time of the acknowledgement.

The persons on duty and their GSM numbers are written on the �Users� field.

9


The phone number is read from this list also when investigating whether the sender of a message has user authorisation to the system.

There can be seven alarm groups. A primary person on duty and a substitute is selected for each group. An alarm class or any other condition regarding the alarms sent to these numbers can be set on the �SCIL-filter� row.

An alarm is acknowledged by sending the original message back to the same number from which it came. If the person on duty does not answer by acknowledging the alarm, he/she will receive a wake-up call, and if there still is no answer, the message is delivered to the substitute. If the substitute does not send an acknowledgement after the wake-up call, the system makes wake-up calls in turns to both numbers until one of them acknowledges the alarm. If there are still more alarms in the system, they are sent to the number that acknowledged the last alarm and the last number that answered is set as the default number. The primary person on duty can, however, at any time set him/herself as the default by sending an old message to the system.

If only one person is on duty, the same person is named the person on duty and the substitute.

The inquiry functions are always in use, and inquiries can be made by the persons on duty marked on the list. At the end of the inquiry there must be number in brackets indicating which application to ask. An application number is not needed in a so called master application, because an inquiry that does not contain any application number is always directed to the master application.

The person on duty can easily send an SMS text message from a dialog box opening inside the MicroSCADA window. In the dialog box the receiver can be selected by name or by entering the phone number.

When a regular phone call is made to the system, SMSServ disconnects the call and transmits the phone number of the caller to MicroSCADA. With this feature, it is possible, for example, to perform a control or a function of any kind. This is done by programming the desired function by using SCIL language in MicroSCADA.

Customer specific issuesThere is a text file named �sms_user.dat� in the PICT directory. The users can make their own inquiries and control programs to this file. The file must return vectors named a, u, and l that can have about 10 elements. See the file for an example.

The Sms_user:c procedure generates one or two text messages from these vectors, depending on whether the length of the answer message exceeds 150 characters. The answer messages must be in variables named �@viesti1� and �@viesti2�.

As examples, there are the inquiries �Alarms� and �Weather� as well as the messages �Off� and �On� for controlling the usage of the program. With �Off and �On� messages it is possible to set the data transference on and off.

10


4. Application examples

� The control of manually operated disconnectors in the field:

The electrician changes the position of the disconnector and after that sends a text message to MicroSCADA that reads, for example, AE201.

The disconnector 201 changes its position in the database and the network topology etc. are updated immediately.

� The person on duty at the district heating plant receives an alarm on a mobile phone, acknowledges the alarm, and sends an inquiry to the system, for example: PRESSURES.

As a response, he/she receives a text message that contains the values of pre-selected pressure measurements.

� A fault detector in the medium voltage distribution network sends an error message to MicroSCADA as a text message.

� A remote-controlled disconnector is controlled with text messages:

TeleControl, or a corresponding substation, receives a control message from MicroSCADA forcing the disconnector to operate.

Information about the time when the alarm was generated is received together with the control message and the substation rejects the old messages.

Thus, delays in the message centre do not disturb the control functions.

� The plant is surrounded with wire-netting fence and there are electronically operated gates at the passages:

A person arrives by car and, just before reaching the gate, makes a regular phone call to the system and MicroSCADA opens the gate.

� The program can also act as a receiver and as a transmitter to MicroSCADA of, for example, such messages that update information on the states and on the measurements of a substation.

11


5. Equipment

The transmission works at least with the following equipment:

- terminal modems:

Nokia 30, Siemens M20 and Siemens TC35

Communicators or GSM phones, with easy to use menus for returning messages to the sender are suitable for receiving messages.

The SMSserv program can be called with the following syntaxes:

smssend ClearSMS 0 = Clears all application queues in the SMS buffer.smssend ClearSMS 1 = Clears 1 application queue in the SMS buffer, etc.smssend Show = Opens the SMSserv console.smssend Hide = Hides the SMSserv console.smssend Kill = Shuts down the SMSserv program.

A command can be given from MicroSCADA, for example, in the following way:

@abb = ops_process(“smssend Show”)

Note: the first letter of the word �Show� is a capital letter!

13


16

ABB OySubstation Automation ProductsP.O. Box 699FI-65101 VaasaFINLANDTel. +358 10 22 11Fax. +358 10 224 1094www.abb.com/substationautomation

1MR

S75

5367

EN

10.

2004

sms-text message 4.00 technical instructions 7 microscada sms-text message 4.00 technical...

Documents