SITRANS F M MAG 8000 GSM/GPRS add-on module

SITRANS F

Communication Modules

SITRANS F M MAG 8000 GSM/GPRS add-on module

Operating Instructions • 11/2011

1 Introduction

2

Safety notes

3

Description

SITRANS F

4

Installing/mounting

Communication ModulesSITRANS F M MAG 8000 GSM/GPRS add-on module

5

Connecting

6

Commissioning Operating Instructions

7

Operating

8

Functions

Alarm, error and system messages 9

10

OPC

11

Service and maintenance

12

Troubleshooting/FAQs

13

Technical data

A

Appendix A

B

Abbreviations Add-on module for use with flowmeter types SITRANS F M MAG 8000

11/2011 A5E03644134-01

Legal information Warning notice system

This manual contains notices you have to observe in order to ensure your personal safety, as well as to prevent damage to property. The notices referring to your personal safety are highlighted in the manual by a safety alert symbol, notices referring only to property damage have no safety alert symbol. These notices shown below are graded according to the degree of danger.

DANGER indicates that death or severe personal injury will result if proper precautions are not taken.

WARNING indicates that death or severe personal injury may result if proper precautions are not taken.

CAUTION with a safety alert symbol, indicates that minor personal injury can result if proper precautions are not taken.

CAUTION without a safety alert symbol, indicates that property damage can result if proper precautions are not taken.

NOTICE indicates that an unintended result or situation can occur if the relevant information is not taken into account.

If more than one degree of danger is present, the warning notice representing the highest degree of danger will be used. A notice warning of injury to persons with a safety alert symbol may also include a warning relating to property damage.

Qualified Personnel The product/system described in this documentation may be operated only by personnel qualified for the specific task in accordance with the relevant documentation, in particular its warning notices and safety instructions. Qualified personnel are those who, based on their training and experience, are capable of identifying risks and avoiding potential hazards when working with these products/systems.

Proper use of Siemens products Note the following:

WARNING Siemens products may only be used for the applications described in the catalog and in the relevant technical documentation. If products and components from other manufacturers are used, these must be recommended or approved by Siemens. Proper transport, storage, installation, assembly, commissioning, operation and maintenance are required to ensure that the products operate safely and without any problems. The permissible ambient conditions must be complied with. The information in the relevant documentation must be observed.

Trademarks All names identified by ® are registered trademarks of Siemens AG. The remaining trademarks in this publication may be trademarks whose use by third parties for their own purposes could violate the rights of the owner.

Disclaimer of Liability We have reviewed the contents of this publication to ensure consistency with the hardware and software described. Since variance cannot be precluded entirely, we cannot guarantee full consistency. However, the information in this publication is reviewed regularly and any necessary corrections are included in subsequent editions.

Siemens AG Order number: A5E03644134 Copyright © Siemens AG 2011. Industry Sector Ⓟ 11/2011 Technical data subject to change All rights reserved Postfach 48 48 90026 NÜRNBERG GERMANY

SITRANS F M MAG 8000 GSM/GPRS add-on module Operating Instructions, 11/2011, A5E03644134-01 3

Table of contents

1 Introduction................................................................................................................................................ 7

1.1 Items supplied................................................................................................................................7

1.2 Document history ...........................................................................................................................8

1.3 Further information.........................................................................................................................8

1.4 Notes on warranty..........................................................................................................................9

2 Safety notes............................................................................................................................................. 11

2.1 General safety instructions ..........................................................................................................11

2.2 Laws and directives .....................................................................................................................11

2.3 Application security precautions ..................................................................................................12

2.4 Lithium batteries...........................................................................................................................13

2.5 Rechargeable battery...................................................................................................................13

2.6 Installation in hazardous area......................................................................................................13

2.7 Certificates ...................................................................................................................................14

3 Description............................................................................................................................................... 15

3.1 OPC software application ............................................................................................................15

3.2 GSM/GPRS information transmission .........................................................................................15

3.3 Features .......................................................................................................................................16

4 Installing/mounting................................................................................................................................... 19

4.1 SIM card.......................................................................................................................................19

4.2 GSM/GPRS module.....................................................................................................................19

4.3 Battery..........................................................................................................................................21

4.4 Antenna........................................................................................................................................21

5 Connecting .............................................................................................................................................. 23

5.1 Prepare MAG 8000 ......................................................................................................................23

5.2 Connect cable(s) ..........................................................................................................................24 5.2.1 Connect antenna cable ................................................................................................................24 5.2.2 Connect antenna cable and analog inputs cable.........................................................................25

5.3 Connect to GSM module..............................................................................................................29

6 Commissioning ........................................................................................................................................ 31

6.1 System integration .......................................................................................................................31

6.2 Start-up ........................................................................................................................................31

6.3 Analog inputs ...............................................................................................................................32

Table of contents

SITRANS F M MAG 8000 GSM/GPRS add-on module 4 Operating Instructions, 11/2011, A5E03644134-01

6.4 Configuring.................................................................................................................................. 32 6.4.1 White list...................................................................................................................................... 32 6.4.2 Configuration commands ............................................................................................................ 33 6.4.3 Response SMS for changed parameters.................................................................................... 35 6.4.4 Alarm configuration ..................................................................................................................... 36 6.4.5 Initial configuration ...................................................................................................................... 36 6.4.6 Manual network registration........................................................................................................ 38 6.4.7 Test email settings ...................................................................................................................... 39

7 Operating................................................................................................................................................. 41

7.1 Change PIN code........................................................................................................................ 41

7.2 Retrieve messages ..................................................................................................................... 41 7.2.1 Configuration............................................................................................................................... 41 7.2.2 Battery capacity........................................................................................................................... 42 7.2.3 Current measurement data ......................................................................................................... 42 7.2.4 Measurement history via SMS .................................................................................................... 43

7.3 Clear white list ............................................................................................................................. 43

7.4 Perform factory reset................................................................................................................... 44

8 Functions ................................................................................................................................................. 45

8.1 Push button ................................................................................................................................. 45

8.2 SMS and email functionality........................................................................................................ 45

8.3 Email interface ............................................................................................................................ 46 8.3.1 Email format ................................................................................................................................ 46 8.3.2 Measurement data email............................................................................................................. 46 8.3.3 Attached csv file .......................................................................................................................... 47

8.4 SMS notifications ........................................................................................................................ 48 8.4.1 White list cleared......................................................................................................................... 48 8.4.2 PIN code changed....................................................................................................................... 48 8.4.3 Phone number unsubscribed ...................................................................................................... 49

8.5 SMS interface.............................................................................................................................. 49 8.5.1 SMS format ................................................................................................................................. 49

9 Alarm, error and system messages ......................................................................................................... 51

9.1 Alarms ......................................................................................................................................... 51

9.2 Clear alarms................................................................................................................................ 52

10 OPC......................................................................................................................................................... 53

10.1 Introduction ................................................................................................................................. 53

10.2 OPC server.................................................................................................................................. 54

10.3 OPC server installation ............................................................................................................... 54

10.4 Email settings.............................................................................................................................. 55

10.5 List of devices ............................................................................................................................. 58 10.5.1 Configure list of devices .............................................................................................................. 58 10.5.2 Copy device properties ............................................................................................................... 60 10.5.3 Delete devices............................................................................................................................. 61

Table of contents


10.6 Help..............................................................................................................................................61

10.7 Connection status ........................................................................................................................61

10.8 Log files........................................................................................................................................62

11 Service and maintenance ........................................................................................................................ 63

11.1 Rechargeable battery...................................................................................................................63

11.2 Technical support.........................................................................................................................63

11.3 Return procedures .......................................................................................................................64

11.4 Battery disposal ...........................................................................................................................65

12 Troubleshooting/FAQs............................................................................................................................. 67

12.1 Check list......................................................................................................................................67

12.2 Troubleshooting ...........................................................................................................................67

13 Technical data ......................................................................................................................................... 71

A Appendix A .............................................................................................................................................. 73

A.1 Ordering .......................................................................................................................................73

B Abbreviations........................................................................................................................................... 75

Index........................................................................................................................................................ 81

Table of contents



Introduction 1

Purpose The operating instructions provide all information necessary for the installation and use of the GSM/GPRS module (A5E03412758) intended for use with the electromagnetic flowmeters type SITRANS F M MAG 8000.

Basic knowledge required The instructions are not intended to be a complete tutorial on the GSM/GPRS and OPC protocol, and it is assumed the end user already has a general working knowledge of mobile communication and OPC usage. However, an overview is included in the following section to explain some fundamental aspects of the protocol.

See also For more information about SITRANS F M transmitters and sensors, refer to the appropriate operating instructions available on the flowdocumentation homepage (http://www.siemens.com/flowdocumentation) or on the SITRANS F M documentation CD-ROM.

1.1 Items supplied

Table 1- 1 GSM module without analog inputs cable

GSM module Rechargeable battery with holder Antenna with mounting bracket Operating instructions SITRANS F M literature CD

http://www.siemens.com/flowdocumentation

Introduction 1.2 Document history


Table 1- 2 GSM module with analog inputs cable

GSM module Rechargeable battery with holder Antenna with mounting bracket Analog nputs cable Operating instructions SITRANS F M literature CD

The scope of delivery may vary depending on selections at ordering.

1.2 Document history The contents of these instructions are regularly reviewed and corrections are included in subsequent editions. We welcome all suggestions for improvement.

The following table shows the most important changes in the documentation compared to each previous edition.

Edition Remarks 11/2011 First edition

1.3 Further information

Product information on the Internet The Operating Instructions are available on the CD-ROM shipped with the device, and on the Internet on the Siemens homepage, where further information on the range of SITRANS F flowmeters may also be found:

Product information on the internet (http://www.siemens.com/flowdocumentation)

http://www.siemens.com/flowdocumentation

Introduction 1.4 Notes on warranty


Worldwide contact person If you need more information or have particular problems not covered sufficiently by these Operating Instructions, get in touch with your contact person. You can find contact information for your local contact person on the Internet:

Local contact person (http://www.automation.siemens.com/aspa_app/contactmenu.aspx?ci=yes&regid=DEF&lang=en)

1.4 Notes on warranty The contents of this manual shall not become part of or modify any prior or existing agreement, commitment or legal relationship. The sales contract contains all obligations on the part of Siemens as well as the complete and solely applicable warranty conditions. Any statements regarding device versions described in the manual do not create new warranties or modify the existing warranty.

The content reflects the technical status at the time of publishing. Siemens reserves the right to make technical changes in the course of further development.

http://www.automation.siemens.com/aspa_app/contactmenu.aspx?ci=yes&regid=DEF&lang=en


Introduction 1.4 Notes on warranty



Safety notes 22.1 General safety instructions

CAUTION Correct, reliable operation of the product requires proper transportation, storage, positioning and assembly as well as careful operation and maintenance. Only qualified personnel should install or operate this instrument.

Note

Alterations to the product, including opening or improper modifications of the product, are not permitted.

If this requirement is not observed, the CE mark and the manufacturer's warranty will expire.

2.2 Laws and directives

General requirements Installation of the equipment must comply with national regulations; for example EN 60079-14 for the European Community.

Observe the test certification, provisions and laws applicable in your country during connection, assembly and operation.

Further provisions for hazardous area applications are, for example:

● IEC 60079-14 (international)

● EN 60079-14 (EC)

FCC/INDUSTRY CANADA NOTICE Your device may cause TV or radio interference (for example, when using a telephone in close proximity to receiving equipment).

The FCC or Industry Canada can require you to stop using your telephone if such interference cannot be eliminated. If you require assistance, contact your local service facility. This device complies with part 15 of the FCC rules. Operation is subject to the following two conditions: (1) This device may not cause harmful interference, and (2) this device must accept any interference received, including interference that may cause undesired operation. Any changes or modifications not expressly approved by Siemens could void the user's authority to operate this equipment.

Safety notes 2.3 Application security precautions


Instrument safety standards The device has been tested at the factory, based on the safety requirements. In order to maintain this condition over the expected life of the device the requirements described in these operating instructions must be observed.

CE-marked equipment The CE mark symbolizes the compliance of the device with the following directives:

Radio and telecommunications terminal equipment R&TTE 1999/5/EC

Directive of the European Parliament and of the Council on radio equipment and telecommunications terminal equipment and the mutual recognition of their conformity.

2.3 Application security precautions

CAUTION For units already installed the customer is expected to pot the system in order to obtain the IP68 protection degree.

In case this procedure is not followed, the manufacturer's warranty becomes void.

NOTICE Your device may cause TV or radio interference (for example, when using the module in close proximity to receiving equipment).

The FCC or Industry Canada can require you to stop using your telephone if such interference cannot be eliminated. If you require assistance, contact your local contact person, see "Further information" (Page 8).

CAUTION This device complies with part 15 of the FCC rules. Operation is subject to the following two conditions: 1. This device may not cause harmful interference. 2. This device must accept any interference received, including interference that may

cause undesired operation.

Safety notes 2.4 Lithium batteries


2.4 Lithium batteries Lithium batteries are primary power sources with high energy content designed to represent the highest possible degree of safety.

WARNING Potential hazard

Lithium batteries may present a potential hazard if they are abused electrically or mechanically. Observe the following precautions when handling and using lithium batteries:

– Do not short-circuit, recharge or connect with false polarity. – Do not expose to temperature beyond the specified temperature range or incinerate

the battery. – Do not crush, puncture or open cells or disassemble battery packs. – Do not weld or solder to the battery’s body. – Do not expose contents to water.

2.5 Rechargeable battery The GSM/GPRS module is supplied with a rechargeable battery as energy buffer. This battery is charged automatically. Allow the battery to be fully charged (up to five hours) before the first logon to the GSM network.

WARNING Risk of explosion

Do NOT expose the battery to fire or try to recharge it using an external power source.

2.6 Installation in hazardous area

WARNING NOT allowed for use in hazardous areas!

Equipment used in hazardous areas must be Ex-approved and marked accordingly!

This device is NOT approved for use in hazardous areas!

Safety notes 2.7 Certificates


2.7 Certificates Certificates are posted on the Internet and on the documentation CD-ROM shipped with the device.

See also Certificates on the Internet (http://www.siemens.com/processinstrumentation/certificates)

http://www.siemens.com/processinstrumentation/certificates


Description 33.1 OPC software application

An OPC server is a software application that acts as an API (Application Programming Interface) or protocol converter. When connected to a device (e.g. a PLC, DCS or an RTU) or a data source (e.g. a database or a user interface), the OPC server will transform the data into a standard-based OPC format.

OPC-compliant applications e.g. an HMI (Human Machine Interface), historical data spreadsheet, trending application, can connect to the OPC server and use it to read device data. The protocol interconnects field equipment such as sensors, actuators, and controllers and is widely used in both process and manufacturing automation.

OPC defines a common, high-performance interface that facilitates reuse of data via HMI, SCADA control, and custom applications.

3.2 GSM/GPRS information transmission The GSM/GPRS module transmits information using GSM or GPRS networks. Manual or automatic network selection is possible.

Communication with operators takes place via SMS or email.

SMS can be sent to and from predefined mobile phone numbers, whereas emails can be sent only from the GSM/GPRS module with a CSV file attachment to predefined email accounts.

The retrieved data are stored in the internal memory of the GSM/GPRS module until it is transmitted.

In case of power failure the collected data remains stored in the memory.

The GSM/GPRS module uses the unique power management program to measure the battery consumption ensuring very accurate values of the remaining battery lifetime.

Description 3.3 Features


Pos. Description ① MAG 8000 with GSM/GPRS module ② Mobile network ③ Internet service ④ Email with an attached csv file ⑤ OPC server solution ⑥ SMS with TOT1 data

Figure 3-1 Information transmission

NOTICE Use in a domestic environment

This is a Class A Group 1 equipment intended for use in industrial areas.

In a domestic environment this device may cause radio interference.

3.3 Features The GSM/GPRS module is a device that logs data coming from the MAG 8000 and transmits it into a system via email or SMS. The collected data can be retrieved using an OPC server.

Feature Benefit GPRS communication A higher amount of data can be sent via email

with a csv file as an attachment SMS configuration No on-site commissioning required



Feature Benefit Built-in solution Maintains the IP68 degree and integrated

solution Battery operation plus power management The module uses a calculation program which

ensures a very accurate calculation of the remaining battery lifetime

Additional benefits ● The module can be used as a retrofit on an existing MAG 8000 in the field (SW ver 3.02

or higher)

● Analog inputs enables the customer to connect an external sensor (4 ... 20 mA or 0 ... 5 V) into the GSM module

● Antenna with high gain ensures the best performance under challenging conditions such as concrete boxes or places with low signal

● Antenna is rated IP68

● Synchronization function ensures an accurate collection of the data independent of the sample rate used

● Minimum sample rate is 1 per minute




4Installing/mounting

The installation consists of the following steps:

1. SIM card

2. GSM/GPRS module (only retrofit systems)

3. Rechargeable battery

4. Antenna

4.1 SIM card 1. Insert SIM card in slot of GSM/GPRS module.

2. Ensure that SIM card is positioned as shown in figure below.

Figure 4-1 Installing the SIM card

Note

Before placing the SIM card in the module, change the PIN code of the card to 1000 using a mobile phone. During commissioning you can change the PIN code using an SMS command, see "Change PIN code" (Page 41).

4.2 GSM/GPRS module

Note Retrofit systems

The following procedure only applies to retrofit systems.

Installing/mounting 4.2 GSM/GPRS module


Pos. Connector ① Rechargeable battery ② Analog inputs cable ③ Antanna

Figure 4-2 GSM/GPRS add-on module

The installation procedure for an GSM/GPRS module to a MAG 8000 transmitter is as follows:

1. Insert SIM card.

2. Mount module on back of MAG 8000 electronics.

3. Snap module onto back of electronics.

4. Ensure module is fixed correctly to eight-pin connector and spacer.

5. Use the two 3 mm screws and washers to fix module to MAG 8000 electronics.

Figure 4-3 Mounting the module

Installing/mounting 4.3 Battery


4.3 Battery The GSM/GPRS module requires installation of an additional rechargeable battery. The battery must be installed in the bottom part of the MAG 8000 enclosure and connected as shown below.

Figure 4-4 Battery installation

It is also required to place the battery holder in the right position as shown below. Notice that the wide part must be below the SIM card to keep it in place (see the arrow in the figure below).

Figure 4-5 Battery holder installation

4.4 Antenna The antenna is designed for wall mounting or for mounting inside of concrete chambers with a low attenuation of the signal strength.

Installing/mounting 4.4 Antenna


The antenna must be installed vertically as shown below.

Figure 4-6 Wall mounting antenna installation

NOTICE The antenna must be placed where the optimal signal strength from the network is available to obtain long battery lifetime and permanently working GSM/GPRS communication. Avoid placing the antenna close to high-voltage units or high-power lines and metal plates.

The antenna is rated IP68 and will not be affected by flooding. However, the transmission cannot be guaranteed under flooding conditions.


5Connecting

NOTICE Follow the instructions in this chapter closely to maintain the protection degree of the flowmeter and ensure the correct operation of the module.

Connect cable(s) to the GSM module as follows:

1. Prepare MAG 8000.

2. Connect cable(s)

– Antenna cable (Page 24) or

– Antenna cable and analog inputs cable (Page 25)

3. Connect to GSM module

5.1 Prepare MAG 8000 Prepare MAG 8000 for connection as follows:

1. Remove blind plug from MAG 8000.

2. Loosen cable clamp.

Connecting 5.2 Connect cable(s)


5.2 Connect cable(s) Follow one of the instructions, below depending on the chosen solution, to prepare cable(s) for connection.

5.2.1 Connect antenna cable

Mount cable gland onto antenna Mount the cable gland onto the antenna as follows:

1. Connect antenna adapter cable to antenna SMA/M connector making sure the SMA connector is tightened, so that a good connection is guaranteed.

2. Mount the antenna into the cable gland, and connect antenna adapter cable.

3. Mount M20 to M16 reduction onto the MAG 8000, making sure the reduction is tightened

correctly to guarantee IP68 standard.



4. Mount M16 cable gland into M20 reduction. Make sure the gland is tightened to torque 10 Nm to guarantee IP68 standard

5. .Tighten the upper part to fix the antenna cable.

5.2.2 Connect antenna cable and analog inputs cable

Assemble analog inputs cable 1. Open 2-hole cable gland (M20).

2. Push the cable gland over the open end of the analog inputs cable.

3. Slide the M12 connector parts onto the cable in the order shown below. Make sure the

shield is bent the shield to the jacket.



Connect strip wire See pin numbers on plastic of M12 connector.

● P1 – white

● P2 – gray

● P3 – brown

● P4 – yellow

● P5 – green

1. Screw together the M12 connector parts, making sure the parts are tightened correctly to

guarantee IP68 standard.

2. Screw the protection cover onto the M12 Female connector, making sure it is done

correctly to guarantee IP67 standard. The plastic loop must be around the cable.



Mount cable gland with antenna and analog inputs cable 1. Push the antenna cable through the upper and cover parts of cable gland.

2. Using for example a screw driver, push through the rubber to open the side.

3. Carefully push the antenna cable into the rubber part from the side and remove the tool

(e.g. screw driver).

4. Check that the two cables are inserted correctly into the rubber part.

5. Insert cables into MAG 8000 hole.

6. Screw M20 cable gland into MAG 8000 housing

Make sure the gland is tightened to torque 10 Nm to guarantee IP68 standard.



7. Push rubber part into M20 cable gland, and adjust antenna cable and analog inputs cable making sure that the shield of the analog inputs cable and the left side metal of the SMA connector are below the cable clamp. After adjusting the cable, tighten the two screws of the cable gland making sure that the cables are not squeezed and that they have electrical connection on the metal.

8. Mount the M20 cable gland cover tightening it to torque 10 Nm to guarantee IP68

standard.

Connecting 5.3 Connect to GSM module


5.3 Connect to GSM module

NOTICE Shielding

At one end of each cable its shield must be connected to protective earth. If a connector is used at this end, the shell of the connector must be connected to the shield of the cable.

1. Snap small connector in GSM/GPRS module.

2. Prepare coupling cable for physical analog inputs, see "Technical data" for pin

description.

WARNING

Overvoltage

Overvoltage on both analog inputs may damage the internal electronic components!

Analog input 1 (current input) shall not be connected directly to a power supply source.

Analog input 2 (ratiometric) shall not exceed 6V DC.

Connecting 5.3 Connect to GSM module



Commissioning 66.1 System integration

This chapter provides information on how to integrate the flowmeter and the GSM/GPRS module considering the different hardware options (analog inputs and power supply sources).

NOTICE On the first power-up the LED on the GSM/GPRS module flashes during start-up. Then the module will automatically start charging the battery.

6.2 Start-up As part of the power-saving mode, the module is set to be awake for only three minutes. It is, however, possible to manually wake up the module in order to ensure that the configuration settings sent via SMS are received completely at the time required.

This is done by pressing the push button located in the top left corner of the module for five seconds until the LED flashes (see figure below). The microprocessor will start up the module, establish communication with the network, and ask for any pending commands

For details about the SMS configuration see "Configuration commands" (Page 33).

NOTICE Module replacement

If the GSM/GPRS module is replaced, all configuration settings must be loaded again.

Commissioning 6.3 Analog inputs


① Push button ② LED

6.3 Analog inputs The analog inputs do not require a particular set up. Prior to any data collection, the SMS command P53, see "Configuration commands" (Page 33), must be sent to activate the function.

6.4 Configuring The architecture of the add-on module allows remote configuration using SMS sent to the module via the mobile network from a mobile phone. These commands will be received when the unit wakes up at next transmission time or every 24 hours.

As standard the GSM/GPRS module has a basic configuration, but the settings can be modified to fit the application. SMS codes ensure a safe and easy configuration of the module.

For initial configuration the SIM card PIN code must be set to 1000.

6.4.1 White list The configuration is protected by a list of mobile phone numbers that are authorized to send configuration SMS to the GSM/GPRS module. This white list can be cleared with an SMS command which must include the PIN code, see "Clear white list" (Page 43).

Up to three mobile phone numbers are allowed to send configurations and commands.

An empty whitelist means no protection, i.e. configurations can be sent from any mobile phone.

Commissioning 6.4 Configuring


6.4.2 Configuration commands The configuration of the GSM/GPRS module is using SMS communication sending special commands with a clear and defined syntax that avoids wrong settings. These commands define the operation of the module, such as transmission set up, email accounts, sample rates, etc.

The table below lists the commands that can be sent to the GSM/GPRS module; either individually or combined taking into account the limit of 160 characters per SMS message.

Note

Unknown commands sent to the GSM/GPRS module are ignored. Commands containing invalid parameter values cause a configuration error that is recorded and an alarm SMS which is sent to the alarm recipients.

Table 6- 1 Configuration commands

Code Command description Possible write values P1 PIN code of the used SIM card 4 digits P2 GSM network 5 digits P3 Short message service center number Phone number P4 Mobile no. 1 to send SMS commands Phone number P5 Mobile no. 2 to send SMS commands Phone number P6 Mobile no. 3 to send SMS commands Phone number P7 Mobile no. 1 to receive alarm SMS from WCM Phone number P8 Mobile no. 2 to receive alarm SMS from WCM Phone number P9 Mobile no. 3 to receive measurement data SMS from WCM Phone number P10 GPRS network access point name Text string P11 User name for GPRS authentication Text string P12 User password for GPRS authentication Text string P13 DNS server IP address. (e.g. 10.0.0.138) IP address P14 SMTP server address (domain name or an IP address) Text string P15 User name for SMTP server authentication Text string P16 User password for SMTP server authentication. Text string P17 Own email address of the WCM Email address P18 Recipient 1 email address Email address P19 Recipient 2 email address Email address P20 Recipient 3 email address Email address P23 Threshold value for the signal strength alarm 0: no alarm

1: < -111 dB 2: < -96 dB 3: < -81 dB 4: < -66 dB 5: < -51 dB



Code Command description Possible write values P51 String Identifier selector 0 = SERIAL NUM

1 = APP_IDENT 2 = APP_LOCATION

P52 Transmission mode settings 0 = Email and SMS 1 = SMS only 2 = Email only

P53 Setting for analog inputs acquisition 0 = Off 1 = On

P55 Sample rate 1 ... 255min or 1 ... 255h P56 Transmission interval 1 ... 744h

1 ... 31d 1M

P58 WCM alarm mask See "Alarms" (Page 51) P61 Measurement synchronization time 00:00 - 23:59

Empty: no sync.

For reference information on the SMS and GPRS communication, refer to your local mobile provider or Mobile network code (http://en.wikipedia.org/wiki/Mobile_network_code).

Note P56=1M;

This configuration sets the transmission interval to one month but synchronizes the transmission with the first measurement of each month. Monthly transmission allows a measurement period of 31 minutes or longer.

This feature is especially useful for billing purposes.

Example:

Configuration;P55=15min; P56=24h;

Note Correct format

Every command must end with ";" in order to be accepted by the module.

Parameters:

configuration1 to "n" – configuration parameter

Example:

Settings to define the SMTP server, authentication account, server password, user email account, selection of the identifier, and GSM mode only active.

Configuration;P14=smtp.gmx.at;[email protected];

P16=test;[email protected];P51=0;P52=1;

http://en.wikipedia.org/wiki/Mobile_network_code



Example:

Settings: The sample rate is 15 minutes; transmission once a day and measurement synchronization at 6:00 a.m.

Configuration;P55=15min;P56=24h;P61=06:00;

Note

The standard syntax for the mobile numbers allows the use of " + ", "00" (e.g. +2855511223344or 002855511223344).

Check the configuration of your local network provider for details on any particular syntax used.

Transmission mode:

Network communication through GSM or GPRS is set up via parameter P52. The options are as follows:

Table 6- 2 P52 options

Option Description 0 If GPRS connection is available, the report will be delivered as email. If not, the report will

be delivered as SMS 1 SMS with only TOT1 values will be delivered. In case the network is not available, the

information will be stored until the next time the module is logged on to the GPRS network 2 The report will always be delivered as email

Example:

Configuration;P52=0;

Option = 0 An information email will be delivered via the GPRS network. In case the network fails, the data will be delivered as SMS with the TOT 1 information to the phone number configured.

Option = 1 Only an SMS with the TOT 1 values will be delivered.

Option = 2 Only an information email using the predefined settings will be delivered.

6.4.3 Response SMS for changed parameters This is the response SMS sent to the initiator notifying if the parameters were changed.

Example:

UNIT01 2011-02-07 13:25

Configuration: OK

Possible responses: OK or ERROR



6.4.4 Alarm configuration It is possible to define which alarms to be reported from the GSM/GPRS module and from the MAG 8000 using the configuration command P58. This command is sent via SMS as a 4 digit hexadecimal value (see table below).

Configuration syntax:

P58=0x[D1][D2][D3][D4]

Parameters:

0x: fixed text D1: Active alarms from 13 to 16 D2: Active alarms from 09 to 12 D3: Active alarms from 05 to 08 D4: Active alarms from 01 to 04

Example:

Configuration;P58=0x0008

This example shows a configuration reporting only alarm no. 4.

Table 6- 3 Alarm mask (hexadecimal)

16 15 14 13 D1 12 11 10 9 D2 8 7 6 5 D3 4 3 2 1 D4 0 0 0 0 x 1 x 1 x 1 x 1 x 2 x 2 x 2 x 2 x x 3 x x 3 x x 3 x x 3 x 4 x 4 x 4 x 4 x x 5 x x 5 x x 5 x x 5 x x 6 x x 6 x x 6 x x 6 x x x 7 x x x 7 x x x 7 x x x 7 x 8 x 8 x 8 x 8 x x 9 x x 9 x x 9 x x 9 x x A x x A x x A x x A x x x B x x x B x x x B x x x B x x C x x C x x C x x C x x x D x x x D x x x D x x x D x x x E x x x E x x x E x x x E x x x x F x x x x F x x x x F x x x x F

6.4.5 Initial configuration The factory settings of the module allow any mobile phone to send SMS with GSM/GPRS module configurations and email accounts information. But as soon as at least one mobile phone number is specified in the white list, communication between mobile phones and module is limited to these numbers.



Finally, the sample rate and the time for transmission must be defined.

1. Ensure that SIM card has PIN code 1000.

2. Ensure that network setting for SMS and GPRS are correct in order to secure communication. This information is normally available on the mobile supplier's web page.

3. Set mobile numbers for the persons authorized to configure the module and to receive alarms.

4. Check that the mobile numbers follow the correct local dialling format (i.e + or 00, country code, area code, phone number, etc).

5. Change the PIN code.

6. Ensure that all command instructions end with ";" in order to be accepted by the module.

Example:

1. Check that SIM card PIN code is 1000.

2. Send configuration via SMS:

– SMS 1 (Service center, whitelist and alarm lists): Configuration;P3=<PhoneNumberSMS_ServiceCenter>;P4=<PhoneNumberUser1>;P7=<PhoneNumberAlarmRecipient1>;

– SMS 2 (GPRS and email account settings): Configuration;P10=web.vodafone.de;[email protected];[email protected];P16=test123;P14=mail.gmx.net;[email protected];

– SMS 3 (Set sample rate, transmission time and measurement synchronization): Configuration;P55=5min;P56=24h;P61=06:00;

The module will answer "Configuration: OK" after receiving the correct settings.

3. Send a retrieve SMS command

– RetrieveConf;1000;<EmailAccount>

NOTICE

PIN code

It is recommended to change the SIM card PIN code after configuration to avoid unauthorized access to the GSM module.

Note

The time for the next module wake-up is relative to the time when the configuration via SMS was received by the module.

The parameter P61 will ensure the synchronization of the data collection at the time required.



6.4.6 Manual network registration

Network selection The GSM/GPRS module will automatically recognize the country network predefined in the SIM card so usually it is unnecessary to define the network provider.

If, however, the module is installed near a country border, it is highly recommended to use the manual mode when selecting the network provider. This prevents the module from using the foreign networks in case the signal from the local/domestic provider is weak avoiding high roaming cost.

Command syntax:

Configuration;P2=<PLMN>;

Parameters:

<PLMN>: The PLMN network number

Note

Only if the selected network is not available, the GSM/GPRS module will automatically switch to automatic network registration mode and choose the strongest network available.

The GSM/GPRS module sends out an SMS message to Recipient1 and Recipient2 to inform that the registration of the specified network was not possible and a new network was selected.

The SMS contains information on all available networks listed together with the following status information:

● whether the used SIM card is allowed to register to that network

● the chosen network

● the network signal strength

SMS syntax:

[IDENTIFIER] [TIMESTAMP] Cannot register to PLMN: [PLMN] Available Networks: [status], [available PLMN] [status], [available PLMN] SignalStrength: [signal strength]

Parameters:

<status>: 0 (unknown) 1 (PLMN available) 2 (PLMN currently registered to) 3 (not allowed to register to this PLMN)



<available PLMN>: the PLMN number of available networks

<signal strength>: the signal strength of the PLMN to which the WCM is currently registered. Value can be 0 to 5 or 99; 0 means the signal strength is too low; 5 means the signal strength is maximum; and 99 means that the signal strength is unknown.

Example:

UNIT01 2011-02-07 13:28 Cannot register to PLMN: 23203 Available Networks: 2,23201 3,23203 2,23205 SignalStrength: 3

To choose one of the currently available networks: send an SMS with the following syntax:

Command syntax:

Configuration;P2=<available PLMN>;

Note

The retrieved PLMN network references can be found here:

http://en.wikipedia.org/wiki/Mobile_network_code (http://en.wikipedia.org/wiki/Mobile_network_code)

6.4.7 Test email settings This command is used for testing if recipient email addresses are configured correctly.

An email with the subject "<ID>Test" will be sent to all configured recipient email addresses.

It is recommended to test the email settings each time they are changed.

Request syntax:

TestEmail;

No confirmation SMS is sent.

http://en.wikipedia.org/wiki/Mobile_network_code




Operating 77.1 Change PIN code

It is possible to change the SIM card PIN code during commissioning in order to avoid unauthorized configuration and data retrieval.

Syntax:

Pin;<oldpin>;<newpin>;

Parameters:

oldpin – the old SIM PIN newpin – the new SIM PIN to set

Example:

Pin;1000;1234;

7.2 Retrieve messages The GSM/GPRS module is capable of delivering messages to the defined users providing the information requested via the commands selected, or alarms, see "Alarms" (Page 51).

Note

All information requested is sent the next time the module logs on to the network.

7.2.1 Configuration Retrieve the complete configuration of the WCM via e-mail

Parameters:

PIN – SIM card PIN code email-address – the receiver of the configuration

Example:

RetrieveConf;1000;[email protected];

Note

Critical passwords are not included in the configuration email.

Configuration of the GSM/GPRS module can be sent via email only, even if the device is in GSM mode only.

Operating 7.2 Retrieve messages


7.2.2 Battery capacity This function will retrieve current battery status of the MAG 8000 system.

Request syntax:

GET_BAT_CAP;

Response syntax:

[IDENTIFIER] [TIMESTAMP] BT [BATTERY_CAPACITY%]

Example:

UNIT01 2009-09-16 15:50 BT 85%

7.2.3 Current measurement data This command is used for retrieving current MAG 8000 measurement data via SMS.

Request syntax:

GET_MEASUREMENT_DATA;

Response syntax:

[IDENTIFIER] [TIMESTAMP] FL [FLOWVALUE] [FLOWUNIT] T1 [TOT1] T2 [TOT2] T3 [TOT3] VU [TOTALIZER_UNIT] A1 [ANALOGINPUT1VALUE] A2 [ANALOGINPUT2VALUE] BT [BATTERY_CAPACITY%] AL [ALARM/WARNING INDEX] [ALARM/WARNING INDEX]

Example:

UNIT01 2010-12-06 12:21 FL 1 l/h T1 24 T2 32.34 T3 35.215 VU m3 A1 0.0 mA A2 0.0 V BT 90% AL 01 07

Operating 7.3 Clear white list


7.2.4 Measurement history via SMS GSM communication only provides SMS-based information retrieved from the module and the content is limited to maximum 160 characters per message. Thus, the module delivers only 12 totalizer values in each message, i.e. if the transmission time is every 24 hours, the values are collected every two hours.

SMS syntax:

[IDENTIFIER] [TIMESTAMP] [TOT1[n]] [TOT1[n-1]] ……… [TOT1[n-11]]

Example:

UNIT01 2009-09-20 09:20 1234560.1 1234560.2 1234560.3 1234560.4 1234560.5 1234560.6 1234560.7 1234560.8 1234560.9 1234561.0 1234561.1 1234561.2

Note

Measurement history is sent by SMS if no email communication is possible, or if P52 is set to 1 (SMS only), see "Configuration commands" (Page 33).

7.3 Clear white list This command will empty the list of mobile phone numbers (MSISDN) from which the module configuration can be modified. The command will be accepted from any mobile phone if the correct pin code is entered. This command is useful if the white list was misconfigured.

Request syntax:

RESETMSISDN;[PIN];

Example

RESETMSISDN;1000;

Note

This function will send an alarm SMS to the alarm recipients registered and record the mobile phone used for the modification.

In case of legal prosecution, the information can be tracked.

Operating 7.4 Perform factory reset


7.4 Perform factory reset This procedure resets the module to its factory settings.

CAUTION White list

The factory reset clears the white list and leaves the device unprotected.

Perform the factory reset as follows:

1. Press push button for 10 seconds to log off from network.

2. Stop operation of module.

3. Remove SIM card.

4. Set PIN code to 1000 using a mobile phone.

5. Reinsert SIM card.

6. Turn on module.

7. Press push button 20 to 25 seconds to perform factory reset.

Note

During factory reset the module will try to logon to the network using PIN code 1000. Set the PIN code to 1000 prior to factory reset; otherwise the SIM card will be locked and the PUK code must be entered to unlock the SIM card.


Functions 88.1 Push button

If the push button is pressed for 10 seconds, the module will log off from the network and stop the programmed transmission defined in the parameter P56, see "Configuration commands" (Page 33) for details.

To restart the module after the stop process, press the button for 5 seconds and test the communication by sending one of the retrieve commands, see "Configuration commands" (Page 33).

In case a factory reset is needed; press the button minimum 20 seconds and maximum 25 seconds. During this process the LED flashes four times and the device is reset to the factory settings.

8.2 SMS and email functionality The table below describes the functionality of SMS and email in the GSM/GPRS module. The term "Incoming" means that the module has received data from the user list, and the term "Outgoing" means that the module has sent information to the user list.

Table 8- 1 Information retrieved/sent

Interface Transmission Name SMS Incoming Change PIN code SMS Incoming Empty authorized MSISDN list SMS Incoming Retrieve configuration SMS Incoming Change configuration SMS Incoming Clear alarms SMS Incoming Get battery capacity SMS Incoming Get current measurement data EMAIL Outgoing Measurement history data EMAIL Outgoing Configuration SMS Outgoing Alarms SMS Outgoing Measurement history data SMS Outgoing Clear alarm response SMS Outgoing Network registration fallback

Functions 8.3 Email interface


8.3 Email interface This section describes how the GSM/GPRS module retrieves the information collected and delivers it to the email recipients. Emails are sent only if P51 is set to 0 or 2, see "Configuration commands" (Page 33). The default setting is 0.

Note

The GSM/GPRS module email account must be created on a server that accepts non-secure accounts using SMTP.

8.3.1 Email format Data recipient:

Based on the GSM/GPRS module configuration it supports up to three recipients.

Email subject:

MAG8000: [IDENTIFIER]

8.3.2 Measurement data email The measurement data is sent as an attached csv file via email. The data is separated by using a ";" as delimiter. The data format is listed in the table below.

The total number of lines (data sets) per transmission is limited to 1440, and the maximum sample rate to one minute.

Note

If the transmission is every 30 days and the user tries to select 1 minute as sample rate, this value is automatically reduced to 30 min to fit the maximum 1440 lines into one transmission file.

Functions 8.3 Email interface


Table 8- 2 Measurement data type and format

Parameter Description Format TIMESTAMP Date and time YYYY-MM-DD HH:MM FLOWVALUE Flow value Floating point value with a point as

decimal separator FLOWUNIT Flow unit Text (max. 12 characters) TOT1 Totalizer 1 Floating point value with a point as

decimal separator TOT2 Totalizer 2 Floating point value with a point as

decimal separator TOT3 Totalizer 3 Floating point value with a point as

decimal separator VOLUME UNIT Volume unit Text (max. 12 characters) ANALOGINPUT1VALUE 4-20 mA input Floating point value with a point as

decimal separator ANALOGINPUT2VALUE 0-5 V DC input Floating point value with a point as

decimal separator BATTERY_CAPACITY% Remaining battery lifetime

(%) Integer value from 0 to 100

ALARMS Alarm value Decimal representation of bit string value, see "Alarms" (Page 51)

Note

FLOWVALUE and TOT values are formatted by using an internal algorithm, which displays at least three decimals.

ALARMS: The binary representation of this number indicates the corresponding alarm setting.

8.3.3 Attached csv file The filename will be "MAG8000_[IDENTIFIER]_[TIMESTAMP].csv".

Examples:

MAG8000_UNIT01_2010-12-28_01:05.csv

The module will sample data from the MAG 8000 according to the customer requirements and transmit the information at a predefined time. The retrieved data contains the information shown below:

Functions 8.4 SMS notifications


Column Description A Timestamp B Flow value C Flow unit D Totalizer 1 E Totalizer 2 F Totalizer 3 G Totalizer unit H Analog input 1 I Analog input 2 J Remaining battery lifetime (%) K Alarms

8.4 SMS notifications

8.4.1 White list cleared This is a notification sent to alarm recipients that the list of allowed MSISDNs was emptied. The notification includes the phone number (MSISDN) from which the command to clear the white list was sent.

Example:

UNIT01 2011-02-07 13:23

MSISDN: +497895551212

RESETMSISDN: OK

8.4.2 PIN code changed This is a notification sent to alarm recipients that the PIN code was changed. The notification includes the phone number (MSISDN) from which the command to change the PIN code was sent.

Parameters:

Result: OK; ERROR

Example:

UNIT01 2011-02-07 13:23

MSISDN: +497895551212

PIN: OK

Functions 8.5 SMS interface


8.4.3 Phone number unsubscribed This SMS notification it is sent to the recipients when they are removed from the list of alarm recipients.

Example:

UNIT01 2011-02-07 14:25

UNSUBSCRIBED

See also Alarms (Page 51)

8.5 SMS interface

8.5.1 SMS format The various SMS data formats are listed in the table below.

Table 8- 3 SMS data type and format

Parameter Description Format IDENTIFIER Unit identification Text TIMESTAMP Date and time YYYY-MM-DD HH:MM FLOWVALUE Flow value Floating point value with a

point as decimal separator FLOWUNIT Flow unit Text TOT1 Totalizer 1 Floating point value with a

point as decimal separator TOT2 Totalizer 2 Floating point value with a

point as decimal separator TOT3 Totalizer 3 Floating point value with a

point as decimal separator VOLUME UNIT Volume unit Text TOT1[n] TOT1 (value 1) at TIMESTAMP Floating point value with a

point as decimal separator TOT1[n-x] TOT1 (values 2 to 12) equally collected

since the last transmission Floating point value with a point as decimal separator

ANALOGINPUT1VALUE 4-20 mA input Floating point value with a point as decimal separator plus unit

ANALOGINPUT2VALUE 0-5 V DC input Floating point value with a point as decimal separator plus unit

Functions 8.5 SMS interface


Parameter Description Format BATTERY_CAPACITY% Remaining battery lifetime Integer from 0 to 100 plus

% ALARMS List of active alarms List of two-digit integers

separated by a space PIN PIN code Four-digit number

Note SMS syntax

The SMS commands are case sensitive. Ensure to use the correct syntax including capital letters, spaces and characters.


Alarm, error and system messages 99.1 Alarms

The table below lists all GSM/GPRS and MAG 8000 alarms.

Table 9- 1 GSM/GPRS module and MAG 8000 alarms

Alarm no. GSM/GPRS module Alarm no. MAG 8000 1 GSM signal strength 17 Insulation error 2 GPRS availability problem 18 Coil current error 3 Memory allocation error 19 Preamplifier overload 4 Internal SW error 20 Checksum error 5 Problem with configuration 21 Low power 6 Problem with outgoing SMS transf. 22 Flow overload 7 Problem with outgoing email transf. 23 Pulse A overload 8 Unauthorized access 24 Pulse B overload 9 Remaining battery lifetime less than 10% 25 Consumption interval 10 Wrong configuration 26 Leakage 11 Internal communication error 27 Empty pipe 12 Power-up failure 28 Low impedance 13 Firmware error 29 Flow limit 14 Hardware error 30 Not used 15 Not used 31 Not used 16 Not used 32 Not used

The alarms are reported in two ways; via SMS and email.

Via SMS The alarms are reported as the actual alarm numbers.

Syntax:

[IDENTIFIER] [TIMESTAMP] [ALARM] [ALARM/WARNING INDEX] [ALARM/WARNING INDEX]

Example:

UNIT01 2009-09-20 09:20 ALARM 01 02 03 04

Note

The alarm/warning index is based on two digit numbers.

Alarm, error and system messages 9.2 Clear alarms


Via email The alarms are reported in an attached csv file in column "Alarms", see "Attached csv file" (Page 47).

1. Read the decimal value from the csv file.

2. Convert this value into a binary value.

3. Read off the position number of "1". The position number equals the alarm number.

Example:

Decimal value: 96 Binary value: 1 1 0 0 0 0 0 Position number: 7 6 5 4 3 2 1

This example shows that alarm numbers 06 and 07 are reported.

9.2 Clear alarms This command is used for resetting all pending MAG 8000 and GSM/GPRS module alarms.

SMS text for resetting alarms:

RESET_ALARMS;

Note

The user will receive an acknowledge SMS if the alarm was cleared successfully.


10OPC

10.1 Introduction The OPC server receives data from devices and stores ít in a database which makes it accessible for any standard or tailored OPC client.

Separate email accounts are needed; one for each device and one for the OPC server. Shared email accounts can cause malfunctions or delay in data transmissions.

In the example below two email accounts are needed: one for the device and one for the OPC server.

① GSM/GPRS module sends data from device as email with attached csv file ② OPC server receives data and stores it in a database ③ OPC client can retrieve data either in the format of OPC HDA data (several data sets) or OPC

DA format (only the latest data set)

Figure 10-1 OPC overview

OPC 10.2 OPC server


10.2 OPC server The OPC server application consists of two main modules:

● Data retrieval module:

– polls the POP3 mail account and retrieves the emails containing the attached csv files

– stores them in the SQL Lite database

● Data serving module:

– makes the data available for OPC clients by retrieving it from the database

Figure 10-2 OPC server application

Data retrieval module The purpose of the data retrieval module is to update the database file with the data collected by MAG 8000 and sent to an SMTP server by the GSM/GPRS module.

The module has two main tasks:

● To poll the POP3 account based on a time interval defined in the configuration and retrieve the email containing the data

● To store the data in the database file

The OPC server supports OPC DA (Data Access) and OPC HDA (Historical Data Access). For detailed information on how to use OPC clients check the following link:

opcfoundation.org (www.opcfoundation.org)

10.3 OPC server installation The name of the MAG 8000 OPC Server is "Siemens.MAG8000.1". Most OPC clients allow to browse for available OPC servers. Select "Siemens.MAG8000.1" in order to connect to the MAG 8000 OPC server.

All MAG 8000 devices are listed with the prefix "MAG8000_" and their identifier.

Example:

The device with the ID 0123456789 has the following name in the "Siemens.MAG8000.1" address space: MAG8000_0123456789

http://www.opcfoundation.org/

OPC 10.4 Email settings


Installation Install the OPC server application by executing "setup.exe" or by opening "MAG 8000 OPC Server.msi" and follow the instructions.

When the software is installed, run the application by selecting Start → Siemens MAG 8000 OPC Server → Open

Figure 10-3 Run the OPC server application

Once the application has been run, a shortcut is placed in the startup list. The application starts automatically on logon in order to receive data from the MAG 8000 devices.

Figure 10-4 OPC server application in startup menu

10.4 Email settings

Overview The server needs its own email account. The properties (email address, user name, password, server name, SSL) have to be configured in the application. These properties are provided by the email provider.

Note POP3 server

For some email providers it is necessary to activate POP3 access before the POP3 protocol can be used. Corporate firewalls might block POP3 traffic. If there are problems connecting to the email server try another internet connection.



Email Settings To configure the email account open the Settings dialog and enter the following data:

● Email Address

The email address assigned to the MAG 8000 OPC Server.

● User Name

The user name of the email account assigned to the OPC Server. The user name is normally the same as the email address.

● Password

The password of the email account assigned to the OPC Server.



● Server Name

The server name for incoming mails (POP3 protocol) of the email account assigned to the OPC Server. The server name usually starts with pop.

– Checkbox "This server requires a secure connection (SSL)"

Set this option if the email account requires a secure connection.

– Checkbox "Leave a copy of the emails on the server"

Emails that are handled (entered into the database) are deleted from the server the next time the application connects to the server.

In some rare cases (such as testing) it can be useful to leave the emails on the server.

In all other cases it is not recommended to leave the emails on the server because that decreases performance.

● Timezone

The timezone setting is an offset to UTC (Universal Time, Coordinated). The OPC server always reports timestamp as UTC+00:00.

NOTICE

Correct setting of the MAG 8000 internal clocks

The internal clocks of all MAG 8000 devices must be set to the same timezone, i.e. ignore daylight saving time and possible location in different timezones.

If devices are located in different timezones, it is highly recommended to set all clocks to UTC.

Note

The clocks can be set via the infrared port (IrDA) only and not via SMS. See SITRANS F M MAG 8000 & MAG 8000 CT Operating intructions for further details.

● Interval

The interval between two email synchronizations. It is recommended to set the interval to 30 minutes. In rare cases a longer or shorter interval would be appropriate.

● Checkbox "Use a separate database for each device":

Using separate databases for each device can increase the performance.

● Checkbox "Store received files also in filesystem":

If this option is checked, the application stores the received csv files from the devices in the filesystem.

– See the help file on the SW for details.

● Directory

This is the directory where the received csv files are stored if the checkbox "Store received files also in filesystem" is activated.

OPC 10.5 List of devices


10.5 List of devices The OPC server keeps a list of MAG 8000 devices. It processes incoming measurement data and configuration emails only for devices that are in this list.

10.5.1 Configure list of devices There are three possible ways to create and edit this list.

Figure 10-5 List of devices

Via the toolbar button "New" 1. Click on "New" and enter the following properties in the dialog box:

Figure 10-6 Insert new device



● Name

The name of the device is used to assign incoming data to the correct device.

● Email Address

Stating the email address of a device is optional but strongly recommended.

– If the email address is stated, only emails with this sender address are accepted.

– If the email address of a device is not stated, everybody can send data to the OPC server from any email address.

Via the "Edit" menu 1. Select "Insert Device" from the "Edit" menu.

2. Enter the properties of the device (for details see above).

Via the "Import" function File format: The file format is csv with two columns. The first column contains the name of the device. The second column contains the email address of the device. The first row contains the column headings ("Name" and "Email").

CSV files can be opened and generated using most spreadsheet applications. See the application help file for more details on the file format.

Import: This requires a csv file containing the name of the devices and the email addresses.

1. Select "Import" from the "File" menu.

2. Browse for the csv file and click "Open".

Export: The list of devices can be exported into a csv file as a backup.

1. Select "Export" from the "File" menu.

2. Browse for a destination and save the file.



Via the "Update" function 1. Click on the "Update" button.

2. Wait until warning messages appear in the information bar at the top of the window.

This might take some time since emails have to be received and processed.

A warning is displayed for devices that send data to the email account of the OPC server but are not in the list of devices.

By right-clicking on the message you can choose to delete the emails from the inbox or to add the device to the list of devices.

3. It is recommended to set up the devices to send their configuration to the email account that the OPC server uses.

The configuration of the devices can be viewed by selecting a device and choosing "Properties".

Note

The configuration shown might be outdated because it is updated only when the device is explicitly instructed to send its configuration to the OPC server.

10.5.2 Copy device properties The information shown in the figure below can be copied to the clipboard in order to be pasted into another document, e.g. a report.

Copying a specific property 1. Select a specific property.

2. Right-click and select copy.

3. Paste data into the other document.

Figure 10-7 Device properties

OPC 10.6 Help


Copying all configuration data 1. Click on an empty space in the list.

2. Right-click and select copy.

3. Paste data into the other document.

10.5.3 Delete devices

Delete button Any device can be deleted from the list of devices by clicking the "Delete" button.

Until the application is terminated, a device can be recovered by selecting "Undo" from the "Edit" menu in case it was deleted accidently.

As long as the device sends data to the OPC server, it will appear in the information bar at the top of the window, and the device can be added to the list again

10.6 Help From this menu you can get a short description of the various server topics.

10.7 Connection status

OPC connection status The OPC server is running continuously. The icon on the task bar shows different colors according to the connection status.

Figure 10-8 Task bar

OPC 10.8 Log files


Table 10- 1 Connection status indicated by the icon background color

Icon Background color Connection status None Application started.

No emails received yet

Green Application running. Emails received or receiving emails

Yellow Application warning Some emails might not have been received. Can occur when connection is interrupted during email reception

Red Application error Connection or login failed; emails were not received

The application is running until it is terminated by the user. To terminate the application right-click on the icon and select "Exit".

10.8 Log files The OPC server logs imporant events (such as connection open and close, processed emails).

There is a log file for each month. Those files can be accessed from the Start menu ("Siemens MAG 8000 OPC Server" - "Log Files").

Note

Log files are automatically deleted after one year.


Service and maintenance 1111.1 Rechargeable battery

The lifetime of the rechargeable lithium ion battery depends on the charge/recharge cycles and the operating temperature.

The battery should be replaced after approximately four years. If the battery is used for more than four years, a trouble-free operation cannot be guaranteed.

If the battery is used in hot areas, i.e. the surrounding temperature is close to the maximum of 60°C, the battery should be replaced after two years due to accelerated aging.

11.2 Technical support If you have any technical questions about the device described in these Operating Instructions and do not find the right answers, you can contact Customer Support:

● Via the Internet using the Support Request: Support request (http://www.siemens.com/automation/support-request)

● Via Phone:

– Europe: +49 (0)911 895 7222

– America: +1 423 262 5710

– Asia-Pacific: +86 10 6475 7575

Further information about our technical support is available on the Internet at Technical support (http://support.automation.siemens.com/WW/view/en/16604318)

Service & Support on the Internet In addition to our documentation, we offer a comprehensive knowledge base online on the Internet at:

Service and support (http://www.siemens.com/automation/service&support)

http://www.siemens.com/automation/support-request

http://support.automation.siemens.com/WW/view/en/16604318

http://www.siemens.com/automation/service&support

Service and maintenance 11.3 Return procedures


There you will find:

● The latest product information, FAQs, downloads, tips and tricks.

● Our newsletter, providing you with the latest information about your products.

● Our bulletin board, where users and specialists share their knowledge worldwide.

● You can find your local contact partner for Industry Automation and Drives Technologies in our partner database.

● Information about field service, repairs, spare parts and lots more under "Services."

Additional Support Please contact your local Siemens representative and offices if you have additional questions about the device.

Find your local contact partner at: http://www.automation.siemens.com/partner (http://www.automation.siemens.com/aspa_app/contactmenu.aspx?ci=yes&regid=DEF&lang=en)

11.3 Return procedures Enclose the delivery note, the cover note for return delivery together with the declaration of decontamination form on the outside of the package in a well-fastened clear document pouch.



Service and maintenance 11.4 Battery disposal


Required forms ● Delivery Note

● Cover Note for Return Delivery with the following information

Return delivery form (http://support.automation.siemens.com/WW/view/en/16604370)

– product (ordering number)

– number of devices or spare parts returned

– reason for the return

● Declaration of Decontamination

Decontamination declaration (http://pia.khe.siemens.com/efiles/feldg/files/Service/declaration_of_decontamination_en.pdf)

With this declaration you certify that the returned products/spare parts have been carefully cleaned and are free from any residues. If the device has been operated together with toxic, caustic, flammable or water-damaging products, clean the device before return by rinsing or neutralizing. Ensure that all cavities are free from dangerous substances. Then, double-check the device to ensure the cleaning is completed.

We will not service a device or spare part unless the declaration of decontamination confirms proper decontamination of the device or spare part. Shipments without a declaration of decontamination will be cleaned professionally at your expense before further proceeding.

You can find the forms on the Internet and on the CD delivered with the device.

Note Return of products with Lithium batteries

Lithium batteries are certified as dangerous goods according to the Regulation of Dangerous Goods, UN 3090 and UN 3091. Special transport documentation is required to observe these regulations.

Therefore it is recommended to remove lithium batteries prior to shipment

If the battery is important for the examination of the product and it cannot be removed, the product has to be returned according to the Regulation of Dangerous goods.

11.4 Battery disposal In accordance with EU directive 2006/66/EC, batteries are not to be disposed of using municipal waste disposal services.

Waste industrial batteries are accepted back by Siemens or by the local Siemens representative. Please talk to your local Siemens contact or follow the return procedures of Siemens Flow Instruments.

http://support.automation.siemens.com/WW/view/en/16604370

http://pia.khe.siemens.com/efiles/feldg/files/Service/declaration_of_decontamination_en.pdf

http://pia.khe.siemens.com/efiles/feldg/files/Service/declaration_of_decontamination_en.pdf

Service and maintenance 11.4 Battery disposal



Troubleshooting/FAQs 1212.1 Check list

This chapter describes the basic problems that can occur during the commissioning and operation of the module.

When checking the GSM/GPRS module, you must secure the installation of the unit and the basic settings, following the information in the check list.

Figure 12-1 Check list

12.2 Troubleshooting Symptom Alarm

Number Cause Remedy

Insufficient power in the rechargable battery

Check that the battery is connected correctly

Insufficient power in the rechargeable battery

If first time of charging, wait till the battery has been charged for the minimum required time (five hours)

No SMS confirmation

12 Module failure during power-up

Unplug the module and plug it in again. Check if the LED flashes three times

The antenna is not connected correctly

Check that the cable adapter is properly connected to the module. The adapter must "click" into place

Troubleshooting/FAQs 12.2 Troubleshooting


Symptom Alarm Number

Cause Remedy

Wrong service center number or wrong format

Check the number used in P3. Ensure that it corresponds with the information from the mobile provider. Check if the format is correct

1 2

Poor or no signal in the area

Please check the signal strength using your mobile phone. The signal strength must be indicated by minimum one bar

Wrong number on the alarm list

Check the settings of the parameters P7 and P8 via the retrieve function

Wrong format of mobile number due to network configuration

Check the format used by the network provider. Perform a factory reset

Wrong GPRS settings Check with the network provider. Ensure the data and service are available

Wrong email account Use the command TestEmail. Check the information

No emails received

Wrong email account Review the sent SMS and check that the instructions and information is correct

All information sent in one sms

Split the information into three or more SMS

Typing error Review the sent SMS and check that the instructions and information are correct

Wrong settings

The ";" is missing in one of the parameters

Review the sent SMS and check that the instructions and information are correct

Configuration rejected

8 The number is not on the white list

Check that the numbers used in P4 to P6 correspond to the format required by the mobile provider (e.g. international dialing format)

8 One of the authorized users deleted your number

Check the settings of parameters P4 to P6 via the retrieve function

Collected data show differences on date and time

3 Wrong time and date settings in the MAG 8000

Use SIMATIC PDM or Flow Tool and correct date and time in the MAG 8000

Email or SMS arrives outside of the defined time frame

The transmission time is wrong

Send a new value for P56 that fits the desired transmission time

The battery was removed during operation

SIM card blocked

The module was not stopped correctly

Move the SIM card to a mobile phone and enter the PUK code. Reinsert the unblocked SIM card into the module



Note Reset PIN code prior to factory reset

During factory reset the module will try to logon to the network using PIN code 1000. Set the PIN code to 1000 prior to factory reset; otherwise the SIM card will be locked and the PUK code must be entered to unlock the SIM.

1. Set PIN code to 1000 via SMS command.

2. Turn on module.

3. Wait for acceptance of new PIN code.

4. Perform factory reset.




Technical data 13

GSM/GPRS add-on module Transmission module AC 65i (Cinterion) Frequency bands Quad band (850/900/1800/1900 MHz) Email client/server system SMTP Power consumption ▫ Class 4 (2W) for EGSM850

▫ Class 4 (2W) for EGSM900 ▫ Class 1 (1W) for GSM1800 ▫ Class 1 (1W) for GSM1900

Supply voltage range 3.2 ... 4.2 V Charging control for Lithium batteries

Temperature range -20°C ... +60°C Rated operating conditions Air humidity: max. 80%

Altitude: max. 2000 m NN Supported interfaces SMS

Email OPC DA and OPC HDA

Antenna cable length 5 m (16.4 ft.) OPC versions supported HDA version 1.01, 1.02

DA version 2.0, 3.0 Hardware requirements X86 platform architecture

Minimum PIII processor 1.5 GB hard disk space 1GB RAM memory

Software requirements Windows XP SP 3

Antenna Frequency range 824 ... 1990 MHz /1900 ... 2170 GHz Enclosure rating IP68 Gain 2.2 dB Cable length 5 m Connector type SMA male Cable adapter SMP to SMA female

Technical data


Cable connectors M12 connector A-Coding Male Number of pins 5 Cable outlet 6 ... 8 mm

Analog inputs cable

Connector Wire color Function Pin 1 White 4-20 mA (+) Pin 2 Gray 4-20 mA (-/GND) Pin 3 Brown +5 V sensor supply Pin 4 Yellow +0-5 V sensor supply Pin 5 Green GND sensor

Figure 13-1 Analog inputs cable connectors

Table 13- 1 Female cable adaptor

Appendix A AA.1 Ordering

In order to ensure that the ordering data you are using is not outdated, the latest ordering data is always available on the Internet: Catalog process instrumentation (http://www.siemens.com/processinstrumentation/catalogs)


http://www.siemens.com/processinstrumentation/catalogs

Appendix A A.1 Ordering



Abbreviations BA/I 1

Analog input 1

A/I 2 Analog input 2

APOP Authenticated Post Office Protocol

ASCII American Standard Code for Information Interchange

CSV Comma Separated Values (pseudo file format used to store tabular data in plain text form)

DA Data access

dB Decibel

DCS Distributed Control System

DNS Domain Name System

DX Data exchange

Technical data


EU European Union

FAQ Frequently asked questions

FL Flow

FW Firmware

GB Giga bytes

GGSN Gateway GPRS Support Node

GND Ground

GPRS General Packet Radio Service

GSM Global System for Mobile communication

SF System failure

HDA Historical Data Access

HMI Human Machine Interface

Technical data


IP Internet Protocol (or Ingress Protection)

LED Light Emitting Diode

MCU Micro-Controller Unit

MSISDN Mobile Station International Subscriber Directory Number (mobile phone number)

OPC OLE for Process Control

OTAP Over-the-air programming

PIN Personal Identification Number

PLC Programmable Logic Control

PLMN Public Land Mobile Network

POP3 Post Office Protocol - Version 3

PUK Personal Unlocking Code

R&TTE Radio and Telecommunications Terminal Equipment

Technical data


RAM Random Access Memory

RG Coaxial connector type for radio signals

RTU Remote Terminal Unit

SCADA Supervisory Control and Data Acquisition

SDK Software Development Kit

SIM Subscriber Identity Module

SMA SubMiniature version A

SMP SubMiniature version P

SMTP Simple Mail Transfer Protocol

SQL Structured Query Language

SSL Secure Sockets Layer

SW Software

Technical data


UA Unified Architecture

UTC Universal Time, Coordinated

VU Volume Units

WCM Wireless Communication Module - module added to MAG 8000 unit to extend in with GSM/GPRS functionality

WinCC Windows Control Center

Technical data



Index

C Certificates, 11 Contact person, 9 Customer Support Hotline, 63

D Decontamination, 64 Document history, 8

E Ex Approval, 13

H Hardware requirements, 71 Hazardous area

Laws and directives, 11 Hazardous areas, 13 Hotline, 63

I Internet

Contact person, 8, 64 Flowdocumentation, 8 Support, 63

L Lithium batteries

Return, 65 Safety, 13

P Potting, 12

R Requirements

Hardware requirements, 71 Software requirements, 71

Return procedures, 64

S Safety, 11 Service, 63 Software requirements, 71 Support, 63 System integration, 31

T Test certificates, 11

Index


www.siemens.com/processautomation

Siemens A/S Flow InstrumentsNordborgvej 81DK-6430 Nordborg

Subject to change without prior noticeOrder No.: A5E03644134Lit. No.: A5E03644134-01© Siemens AG 11.2011

For more information

www.siemens.com/flow

*A5E03644134*

Documents

SITRANS F M MAG 8000 GSM/GPRS add-on module