LevelSET S GSM Functionalities Instructions for Commissioning and Use

Transcription

1 Labkotec Oy Myllyhaantie 6 FI Pirkkala, Finland Tel: Fax: Internet: LevelSET S GSM Functionalities Instructions for Commissioning and Use Copyright 2010 Labkotec Oy 1/33 Labkotec reserves the right to any changes

2 CONTENTS 1 GENERAL Copyright Target group Symbols Safety instructions Ambient conditions INTRODUCTION GSM modem operation LevelSET S and LabkoNet Mobile phone numbers COMMISSIONING LEVELSET S GSM Placing the SIM card Commissioning the GSM modem SETTING AND READING THE PHONE NUMBERS Command syntax Mobile phone numbers for end users and administrators Setting an end-user phone number Reading an end-user phone number Setting an administrator phone number Reading an administrator phone number Deleting an end-user phone number Deleting an administrator phone number BASIC SETTINGS AFTER COMMISSIONING Setting the device or target name Reading the device or target name Specifying the probe input Reading the probe input Setting the time and date Querying the signal strength ALARM SETTINGS Setting the alarm texts Reading the alarm texts Setting the interval for the maintenance alarm Reading the maintenance alarm interval Setting the measurement interval for a battery-operated device Reading the measurement interval of a battery-operated device Querying the alarm status FEATURE SETTINGS OF THE DEVICE Setting the operating voltage alarm limit Reading the operating voltage alarm limit Querying the battery voltage Querying the software version Resetting the message counter MESSAGES TO END USERS SENT BY THE DEVICE Alarm message Test alarm TROUBLESHOOTING Device responses in error situations Changing the device settings in problem situations Changing the device PIN code Resetting an administrator phone number Copyright 2010 Labkotec Oy 2/33 Labkotec reserves the right to any changes

3 1 GENERAL 1.1 Copyright Copyright 2010 Labkotec Oy. All rights reserved. Copying, distributing, or saving this document entirely or partly is prohibited without the written authorisation of Labkotec. Labkotec develops their products continuously and, therefore, reserves the right to make changes and improvements to any product mentioned in this document without any prior notice. Labkotec is not liable for direct or indirect damages, including the loss of information or income. The contents of this document are provided "as is". No direct or indirect guarantee is given for its accuracy, reliability, or the contents, or a specific guarantee for its marketability or suitability to a specific purpose, unless otherwise stipulated by law. Labkotec reserves the right to modify this document or remove it from distribution without any prior notice. LabkoNet is a registered trademark of Labkotec Oy. 1.2 Target group In regards to commissioning GSM functionalities and their use, this document provides additional instructions to the LevelSET S Operation and Installation Manual. 1.3 Symbols The following symbols are used to warn the user of a possible hazardous situation, or to remind the user of an important aspect. Symbol Warning / Note To be carefully considered especially when installing in potentially explosive atmospheres. The device is protected with either double insulation or reinforced insulation. 1.4 Safety instructions The LevelSET S measurement centre must not be installed in potentially explosive atmospheres, but a probe connected to it may be installed in potentially explosive atmosphere zones 0, 1, or 2. In potentially explosive atmosphere installations, the national regulations and the appropriate standards IEC/EN Intrinsically safe electrical systems i and/or IEC/EN Explosive atmospheres - Electrical installations must be observed. In case static electricity can cause hazards in the measurement environment, the equipotential bonding must be attended according to the regula- Copyright 2010 Labkotec Oy 3/33 Labkotec reserves the right to any changes

4 tions concerning potentially explosive atmospheres. Equipotential bonding is done by connecting all conductive parts to the same potential, for example, in a junction box. The equipotential bonding system must be grounded. The device is not equipped with a mains switch of its own and, therefore, the supply voltage wires, near the device, should be fitted with a disconnecting coupler (250 VAC/1 A), which disconnects both wires (L1, N) to facilitate maintenance and repair actions. The switch is to be marked as the disconnecting coupler of the device. When performing maintenance, inspections or repairs in potentially explosive atmospheres, standards IEC/EN and IEC/EN in regards to Ex devices inspection and maintenance should be observed. 1.5 Ambient conditions LevelSET S GSM Dimensions Enclosure Operating temperature Supply voltage Power consumption Probes Data communication (only with LevelSET S GSM) 175 mm x 125 mm x 75 mm (w x h x d) IP 65, material: polycarbonate -30ºC +50ºC 230 VAC ± 10%, 50/60 Hz Fuse 5 x 20 mm 160 mat (EN /3) The device is not equipped with a mains switch 4.5 VA Digital Labkotec SET probes GSM text messages (SMS) Built-in GSM modem 900/1800 MHz LevelSET S is suitable to be used as a power source for probes located in potentially explosive atmosphere zones 0, 1, and 2. The inputs of the device are naturally intrinsic safety structures. LevelSET S must be installed to a safe area. Copyright 2010 Labkotec Oy 4/33 Labkotec reserves the right to any changes

5 2 INTRODUCTION LevelSET S is a versatile measurement and control centre for monitoring liquid levels. The most common applications are: alarms for oil and sand separators high level and low level alarms for tanks alarms for condensation water level control These instructions provide information on commissioning and using the GSM version of the LevelSET S measurement centre. The instructions also describe the GSM functionalities. The device sends the alarms as text messages either directly to the GSM phone of the user, or to the LabkoNet server to be stored and shared with other appropriate parties. The user settings of the GSM version can be changed using the user's own mobile phone. The indicator lights, buttons, and interfaces of the device are illustrated in figure 1. Figure 1. LevelSET S level switch features Copyright 2010 Labkotec Oy 5/33 Labkotec reserves the right to any changes

6 Figure 2. Application example: Separator system 2.1 GSM modem operation LevelSET S GSM sends the alarm data as text messages either directly to the GSM phone of the user, or to the LabkoNet server. The device continuously reads the status of the digital SET probes connected to it and, if the alarm status changes, sends a notification. Also a probe fault creates an alarm of its own. With the help of the GSM modem, the user can: specify the time when the alarm data is sent to the server. order the data using a text message. change the device settings using a text message. Figure 3 illustrates the message exchange between the user and the LevelSET S central unit. Copyright 2010 Labkotec Oy 6/33 Labkotec reserves the right to any changes

7 Figure 3. Message exchange between the user and LevelSET S GSM All messages are sent as text messages. These are detailed later on in chapters 4, 5, 6, and 7 of this document. 2.2 LevelSET S and LabkoNet LevelSET S can be connected to the web-based LabkoNet monitoring system. Using the LabkoNet system alongside mobile phones brings various advantages, including constant connection monitoring as well as storing alarm data and providing visual presentations. The alarm and measurement data sent from measurement points is transferred to the LabkoNet server through a communication unit via GSM network. The server receives the data sent by the communication unit and stores the data into a database, from which it can be later accessed, for example, for reporting purposes. In addition to checking the probe-specific data sent by the device, it checks for possible alarm threshold violations. If the server detects any violations, it sens alarms to the predefined addresses as messages and phone numbers as text messages. Using their user credentials, end users can also view the alarm data in numerical or graphical format at Mobile phone numbers You can store two types of phone numbers into the LevelSET S GSM device: 1. End-user phone numbers to which messages regarding changes in alarm status are sent. Using these phone numbers, you can also request for the alarm status but not change the settings. 2. Administrator phone numbers can be used to change the device settings. No alarm data is sent to these numbers, but they can be used for sending alarm status queries. NOTE: If you wish to receive the alarm data to the same phone number from which the device settings are also changed, you must specify the phone number in question both as an end-user and administrator number. Copyright 2010 Labkotec Oy 7/33 Labkotec reserves the right to any changes

8 3 COMMISSIONING LevelSET S GSM NOTE: To commission the GSM feature, the device needs a SIM card. 3.1 Placing the SIM card Make sure that the device is not energized. 1. Open the front panel of the device. 2. Slide the SIM card holder of the device, and the holder opens up. Figure 4: Placing the SIM card into the LevelSET S GSM device 3.2 Commissioning the GSM modem 3. Place the SIM card into the holder with the metal contact surface pointing downwards. 4. Press the holder down. 5. Re-attach the front panel. Commissioning the GSM modem takes place by mere text messages, if the modem has been first selected into use with the S4 switch of the top card of the device (see chapter 5.7 Commissioning the GSM modem of the LevelSET S Level Switch for Separator Systems manual). If the device has been delivered with a modem, the modem is activated by default. After this, commissioning a new device takes place in the following order: 1. Set the end-user phone numbers. 2. Set the administrator phone numbers. 3. Set a name for the device and the parameters for the probe inputs. 4. Set the time (clock). 5. Set the alarm texts. The commissioning-related functions are described in chapters 4, 5, and 6. Copyright 2010 Labkotec Oy 8/33 Labkotec reserves the right to any changes

9 4 SETTING AND READING THE PHONE NUMBERS 4.1 Command syntax The following message descriptions apply the following syntax: A parameter marked with <> suggests that the user or the device enters the value to that specific field. Between the marks <> there is a short description of the setting. The text given in bold is an example message entered by the user. In terms of commands, the protocol recognises both upper and lower case letters. Example: Fields TEL <number1> <number5> Command End-user phone number in international format 4.2 Mobile phone numbers for end users and administrators The device can be programmed to five end-user phone numbers (TEL), to which the device sends alarm messages and from which alarm status queries can be made. These phone numbers cannot be used for changing the device settings. The device also includes five memory slots for administrator phone numbers (OPTEL), from which it is possible to change the settings, but to which alarm messages are not sent. However, administrator phone numbers can be used for requesting the alarm status data of the device. In terms of setting administrator numbers for the first time, the numbers can be set from any phone number. Once administrator phone numbers have been stored into the memory of the device, adding and deleting is possible only from those stored phone numbers. NOTE: If you wish to receive the alarm data to the same phone number from which the device settings are also changed, you must specify the phone number in question both as an end-user and administrator number Setting an end-user phone number NOTE: The maximum number of administrator/enduser phone numbers is 5, and 1-5 numbers can be set at a time. The number is always stored to the first available memory slot. Copyright 2010 Labkotec Oy 9/33 Labkotec reserves the right to any changes

10 TEL <number1> <number2> <number3> <number4> <number5> Fields TEL <number1> <number5> Command End-user phone number in international format For example: TEL <device name if specified> TEL 1: <phone number of memory slot 1>.. n: <phone number of memory slot n> TEL The response is the phone numbers set to the device. The response is only TEL, if no number has been stored. Example 1: No name has yet been specified for the device, and the following command is given: TEL TEL 1: : : Example 2: Copyright 2010 Labkotec Oy 10/33 Labkotec reserves the right to any changes

11 The memory already contains the phone numbers set in the previous example 1, and the following command is given: TEL TEL 1: : : : Reading an end-user phone number TEL <device name if specified> TEL 1: <phone number of memory slot 1>. n: <phone number of memory slot n> TEL The response is the phone numbers set to the device. The response is only TEL, if no number has been stored Setting an administrator phone number NOTE: The maximum number of administrator/enduser phone numbers is 5, and 1-5 numbers can be set at a time. The number is always stored to the first available memory slot. OPTEL <number1> <number2> <number3> <number4> <number5> Fields OPTEL Command Copyright 2010 Labkotec Oy 11/33 Labkotec reserves the right to any changes

12 <number1> <number5> End-user phone number in international format For example: OPTEL <device name if specified> OPTEL 1: <phone number of memory slot 1>.. n: <phone number of memory slot n> OPTEL The response is the phone numbers set to the device. The response is only OPTEL, if no number has been stored. Example 1: No name has yet been specified for the device, and the following command is given: OPTEL OPTEL 1: : : Example 2: The memory already contains the phone numbers set in the previous example 1, and the following command is given: OPTEL OPTEL 1: : Copyright 2010 Labkotec Oy 12/33 Labkotec reserves the right to any changes

13 3: : NOTE: After setting administrator numbers, the device settings can only be changed from the numbers in question. Remember to add your own phone number to the administrator phone number list, if you continue making device settings even after this phase Reading an administrator phone number OPTEL <device name if specified> OPTEL 1: <phone number of memory slot 1>.. n: <phone number of memory slot n> OPTEL The response is the phone numbers set to the device. The response is only OPTEL, if no number has been stored Deleting an end-user phone number NOTE: Administrator/end-user phone numbers can be deleted 1-5 at a time. DELTEL <n1> <n2> <n3> <n4> <n5> Fields DELTEL <n1> <n5> Command Memory slot number to be deleted Copyright 2010 Labkotec Oy 13/33 Labkotec reserves the right to any changes

14 For example: DELTEL 2 <device name if specified> TEL 1: <phone number of memory slot 1>... Command presents the remaining memory slots. n: <phone number of memory slot n> <device name>tel Response, if no number has been stored. Example 1: A phone number has been stored in every memory slot, but the device name has not yet been specified. The following command is given: DELTEL 2 TEL 1: : : : Example 2: The remaining phone numbers from example 1 are in the memory, and the following command is given: DELTEL TEL 4: In this case, only the phone number in memory slot 4 is an end-user phone number and other memory slots are empty. Copyright 2010 Labkotec Oy 14/33 Labkotec reserves the right to any changes

15 4.2.6 Deleting an administrator phone number NOTE: Administrator/end-user phone numbers can be deleted 1-5 at a time. DELOPTEL <n1> <n2> <n3> <n4> <n5> Fields DELOPTEL <n1> <n5> Command Memory slot number to be deleted For example: DELOPTEL 2 <device name if specified> TEL 1: <phone number of memory slot 1>... Command presents the remaining memory slots. n: <phone number of memory slot n> <device name> TEL Response, if no number has been stored. Example 1: A phone number has been stored in every memory slot, but the device name has not yet been specified. The following command is given: DELOPTEL 2 TEL 1: : Copyright 2010 Labkotec Oy 15/33 Labkotec reserves the right to any changes

16 4: : Example 2: The remaining phone numbers from example 1 are in the memory, and the following command is given: DELOPTEL TEL 4: In this case, only the phone number in memory slot 4 is an end-user phone number and other memory slots are empty. Copyright 2010 Labkotec Oy 16/33 Labkotec reserves the right to any changes

17 5 BASIC SETTINGS AFTER COMMISSIONING 5.1 Setting the device or target name It is recommended to specify a unique name for the device/target, as this gives direct indication of the device from which the alarm has been sent. NAME <device/target name> Fields NAME Command <device/target name> Name selected by the user. Max. 25 characters. Can also include spaces. For example: NAME Pirkkala Asematie1 NAME <device/target name> Command presents the device name. NAME Response is only NAME, if no name has been specified. Example 1: The following command is given: NAME Pirkkala Asematie1 5.2 Reading the device or target name NAME Pirkkala Asematie1 Copyright 2010 Labkotec Oy 17/33 Labkotec reserves the right to any changes

18 NAME NAME <device/target name> Command presents the device name. NAME Response is only NAME, if no name has been specified. 5.3 Specifying the probe input You can give descriptive names for the probes to facilitate understanding of alarm messages. NOTE: The factory settings of probe inputs are: Probe1, Probe2 and Probe3. DI <x>: <name of probe x>. <y>: <name of probe y>. <z>: <name of probe z> NOTE: In commands, dots between the probe names separate the names. NOTE: You can also specify only one or two probe inputs if, for example, you later wish to change the name of an already specified probe input. Fields DI Command <x/y/z> Probe input number 1 3 <name of probe x/y/z> Probe input must be specified, max. 20 characters. Note: In case one command is used to specify more than one probe input, the names must be separated by a dot. Copyright 2010 Labkotec Oy 18/33 Labkotec reserves the right to any changes

19 For example: DI 1: backwater probe. 2: grease probe. 3: sludge probe <device name> DI <x>: <name of probe input x> <y>: <name of probe input y> Command presents the probe input names. <z>: <name of probe input z> Example 1: The following command is given: DI 1: backwater probe. 2: grease probe. 3: sludge probe Pirkkala Asematie1 DI 1: backwater probe 2: grease probe 3: sludge probe Example 2: The name of probe input 2 should be changed, and the following command is given: DI 2: oil probe Pirkkala Asematie1 DI 1: backwater probe 2: oil probe 3: sludge probe 5.4 Reading the probe input DI Copyright 2010 Labkotec Oy 19/33 Labkotec reserves the right to any changes

20 <device name> DI <x>: <name of probe input x> <y>: <name of probe input y> Command presents the probe input names and the device name. <z>: <name of probe input z> 5.5 Setting the time and date NOTE: The time must be set only if the device sends messages to the Labkonet server. CLOCK <dd.mm.yyyy> <hh:mm> Fields CLOCK <dd.mm.yyyy > <hh:mm> Command Day, month and year, separated by dots. Hours and minutes separated by a colon. <device name> CLOCK <dd.mm.yyyy> <hh:mm> Command presents the device name and the time and date. Example 1: The following command is given: CLOCK :00 Copyright 2010 Labkotec Oy 20/33 Labkotec reserves the right to any changes

21 NOTE: The command can also be given in the following format: CLOCK :00. Pirkkala Asematie1 CLOCK : Querying the signal strength You can also query for the signal strength of the GSM modem. The signal strength can vary between 0 and 31. NOTE: If the value is below 11, the connection may be insufficient for sending messages. CSQ <device name> CSQ <value> Command presents the device name and the signal strength as value between 0 and 31. Example 1: The device name was already specified as Pirkkala Asematie1, and the following command is given: CSQ Pirkkala Asematie1 CSQ 25 Copyright 2010 Labkotec Oy 21/33 Labkotec reserves the right to any changes

22 6 ALARM SETTINGS 6.1 Setting the alarm texts The device can also be specified with alarm texts, which it sends when an alarm is triggered and cleared. You can use a different text for both cases. NOTE: The factory settings of alarm texts are: Alarm on and Alarm off. NOTE: In a fault alarm situation, the texts are Fault on and Fault off. These texts cannot be changed. ALTXT <x>: <probe x alarm on txt>. <probe x alarm off txt>. <y>: <probe y alarm on txt>. <probe y alarm off txt>. <z>: <probe z alarm on txt>. <probe z alarm off txt>. NOTE: In commands, dots between the probe names separate the names. Fields ALTXT Command <x/y/z>: Probe input number 1 3 <alarm on txt>. <alarm off txt>. Message to be sent when an alarm is triggered, max. 20 characters. Message to be sent when the alarm is cleared, max. 20 characters. NOTE: You can also specify the alarm texts for only one or two inputs at a time if, for example, you later wish to change some already specified alarm text. For example: ALTXT 1: alarm on. alarm off. 2: alarm on. alarm off. 3: alarm on. alarm off. Copyright 2010 Labkotec Oy 22/33 Labkotec reserves the right to any changes

23 ALTXT <x>: <probe x alarm on txt>. <probe x alarm off txt>. <y>: <probe y alarm on txt>. <probe y alarm off txt>. Command presents the specified alarm texts by probe inputs. <z>: <probe z alarm on txt>. <probe z alarm off txt>. Example 1: The following command is given: ALTXT 1: alarm on. alarm off. 2: alarm on. alarm off. 3: alarm on. alarm off. ALTXT 1: alarm on. alarm off 2: alarm on. alarm off 3: alarm on. alarm off 6.2 Reading the alarm texts ALTXT ALTXT <x>: <probe x alarm on txt>. <probe x alarm off txt>. <y>: <probe y alarm on txt>. <probe y alarm off txt>. Command presents the specified alarm texts by probe inputs. <z>: <probe z alarm on txt>. <probe z alarm off txt>. Copyright 2010 Labkotec Oy 23/33 Labkotec reserves the right to any changes

24 6.3 Setting the interval for the maintenance alarm The device can be set with a maintenance alarm with certain intervals to remind the user of the required maintenance actions and inspections. Maintenance alarms are indicated by the MAINTENANCE indicator light on the cover of the device. To use this function, switch S7/6 must be in position ON. See chapter 5.6 of the LevelSET S Level Switch for Separator Systems manual. NOTE: The factory setting for the alarm limit is 180. NOTE: The maintenance interval counter is reset when setting the interval. SI <nnn> Fields SI <nnn> Command Interval for the maintenance alarm in days. Max. 3 digits. <device name> SI: <mmm>/<nnn> <position of switch S7/6> <mmm> = current value of counter <nnn> = counter value to alarm (interval) <position of switch S7/6> = maintenance alarm in use when SERVIVE ALARM ENABLED, not in use when SERVICE ALARM DISABLED. Command presents the device name, the current value of the counter, the counter value to an alarm, and information on whether the maintenance alarm is in use (SERVICE ALARM ENABLED = in use, SERVICE ALARM DISABLED = not in use). Example 1: The device name was already specified as Pirkkala Asematie1, and the following command is given: Copyright 2010 Labkotec Oy 24/33 Labkotec reserves the right to any changes

25 SI Reading the maintenance alarm interval Pirkkala Asematie1 SI 0/150. SERVICE ALARM ENABLED SI <device name> SI: <mmm>/<nnn> <position of switch S7/6> <mmm> = current value of counter <nnn> = counter value to alarm (interval) <position of switch S7/6> = maintenance alarm in use when SERVIVE ALARM ENABLED, not in use when SERVICE ALARM DISABLED. Command presents the device name, the current value of the counter, the counter value to an alarm, and information on whether the maintenance alarm is in use (SERVICE ALARM ENABLED = in use, SERVICE ALARM DISABLED = not in use). 6.5 Setting the measurement interval for a battery-operated device A measurement interval can be specified for the device. When the interval limit is reached, the device reads the probes and sends the alarm data, if necessary. The device also starts the GSM modem and reads the possible set messages and queries sent to it. After this, it returns back to sleep mode. NOTE: The factory setting for the measurement interval is 60. MI <nnn> Fields MI Command Copyright 2010 Labkotec Oy 25/33 Labkotec reserves the right to any changes

26 <nnn> Measurement interval in minutes. Max. 3 digits. <device name> MI: <nnn> <position of switch S4/5> <nnn> = measurement interval in minutes <position of switch S4/5> = sleep mode in use when SLEEP MODE ENABLED, not in use when SLEEP MODE DISABLED. Command presents the device name, the position of switch S4/5, the measurement interval in minutes, and information on whether the sleep mode is in use (SLEEP MODE ENABLED = in use, SLEEP MODE DISABLED = not in use). Example 1: The device name was already specified as Pirkkala Asematie1, and the following command is given: MI 60 Pirkkala Asemati1 MI 30. SLEEP MODE ENABLED 6.6 Reading the measurement interval of a battery-operated device MI <device name> MI: <nnn> <position of switch S4/5> <nnn> = measurement interval in minutes <position of switch S4/5> = sleep mode in use when SLEEP MODE ENABLED, not in use when Command presents the device name, the position of switch S4/5, the measurement interval in minutes, and information on whether the sleep mode is in use (SLEEP MODE ENABLED = in use, SLEEP MODE DISABLED = not in Copyright 2010 Labkotec Oy 26/33 Labkotec reserves the right to any changes

27 SLEEP MODE DISABLED. use). 6.7 Querying the alarm status You can also query for the alarm status of probe inputs. M <device name> <name of probe x> <alarm or fault alarm text of probe x>.. Command presents the device name, the probe name, and the alarm and fault alarm text. In the response message, the status of each probe input is in its own row. s for the fields are given in the following table: Field <device name> <name of probe input> If you have specified a name for the device, it is written to the beginning of the message. User may have specified a descriptive name for the probe input. By default: probe 1/probe 2/probe 3 <alarm text> User may have specified alarm texts for the probe input. By default: Alarm on / Alarm off <fault alarm text> Alarm text for triggering or clearing a fault alarm. Cannot be changed. By default: Fault on / Fault off. Copyright 2010 Labkotec Oy 27/33 Labkotec reserves the right to any changes

28 NOTE: The information is not presented if the input in question has been disabled via central unit switch S4. By factory setting, all inputs are in use. Example 1: Pirkkala Asematie1 Oil probe Oil alarm 7 FEATURE SETTINGS OF THE DEVICE 7.1 Setting the operating voltage alarm limit The LevelSET S GSM device monitors its operating voltage. In the 12 VDC version, the device directly monitors the operating voltage received, for example, from the battery and, in the 230 VAC version, it monitors the voltage after the transformer. The device sends an alarm when the limit value for low voltage level is reached. NOTE: The factory setting for the alarm limit is 0.0 V (= alarm not in use). VLIM <xx.x> Fields VLIM <xx.x> Command Desired voltage value in volts and with one decimal. A dot separates the integer and the fraction. NOTE: There is a 1 V hysteresis for alarm off. In other words, the alarm is cleared 1 V higher from the limit. The hysteresis value cannot be changed. <device name> VLIM: <xx.x> V Command presents the set alarm limit for the operating Copyright 2010 Labkotec Oy 28/33 Labkotec reserves the right to any changes

29 voltage (in volts). Example 1: The device name was already specified as Pirkkala Asematie1, and the following command is given: VLIM 15.0 Pirkkala Asemati1 VLIM 15.0 V 7.2 Reading the operating voltage alarm limit VLIM <device name> VLIM: <xx.x> V Command presents the set alarm limit for the operating voltage (in volts). 7.3 Querying the battery voltage You can also use the LevelSET S GSM device for querying the battery voltage of the device. The return value of a mains supplied device is the rectified voltage after the transformer. BATVOLT 2. Send the text message command to the phone number of the device. <device name> BATVOLT: <value> V Command presents the battery voltage level in volts. Copyright 2010 Labkotec Oy 29/33 Labkotec reserves the right to any changes

30 7.4 Querying the software version Example 1: The device name was already specified as Pirkkala Asematie1, and the following command is given: BATVOLT Pirkkala Asematie1 BATVOLT 17.5 V You can also use the LevelSET S GSM device for querying the software version of the device. VER <device name> VER: <vx.xx> Command presents the software version of the device. Example 1: The device name was already specified as Pirkkala Asematie1, and the following command is given: VER Pirkkala Asematie1 VER V Resetting the message counter Per 24 hours, the number of messages sent by the device is limited to Reset the counter by sending the following text message command to the phone number of the device: rstc Copyright 2010 Labkotec Oy 30/33 Labkotec reserves the right to any changes

31 8 MESSAGES TO END USERS SENT BY THE DEVICE 8.1 Alarm message The LevelSET S GSM device sends an alarm message to the end-user phone numbers, when the alarm or fault status changes, and as a response to an alarm query message. Alarm messages contain the following fields, separated by a space: <device name> <probe name> <alarm text or fault alarm text> Data only for the used probe inputs is presented (see chapter 5.1 Selecting the probes in use of the LevelSET S Level Switch for Separator Systems manual). Field <device name> <name of probe input> If you have specified a name for the device, it is written to the beginning of the message. User may have specified a descriptive name for the probe input. By default: probe 1/probe 2/probe 3 <alarm text> User may have specified alarm texts for the probe input. By default: Alarm on / Alarm off <fault alarm text> Alarm text for triggering or clearing a fault alarm. Cannot be changed. By default: Fault on / Fault off. 8.2 Test alarm A test alarm can be triggered by continuously pressing the TEST button on the cover of the device for over 5 seconds until the device blinks all of the ACTIVE and ALARM indicator lights for a few seconds. In a test alarm, the device sends a message similar to the response for an alarm message query (querying alarm data), but the message includes the text "Test" after the device name. Copyright 2010 Labkotec Oy 31/33 Labkotec reserves the right to any changes

32 9 TROUBLESHOOTING 9.1 Device responses in error situations The LevelSET S GSM device sends a text message response to the queries received. Occasionally, the text message command sent by the user is incorrect, in which case the device responds by sending an error message to the mobile phone number of the user. Error situation/message No response COMMAND ERROR COMMAND SYNTAX ERROR Number from which the setting is made is not an OPTEL number. See chapter Setting an administrator phone number. Command was written incorrectly. Parameter error. The reason for the error varies command-specifically. The possible reasons are: a dot missing between the numbers too many numbers in respect to the available memory slots the number is too long (over 15), or letters are included too many characters a dot or a colon is missing the probe input number is not 1 3 the separator marks are missing or incorrect the entered date/time cannot exist a number with over 3 digits, letters included Solution: Write a new text message command and, before sending it, verify that it is written correctly. 9.2 Changing the device settings in problem situations In case the device does not respond in spite of messages sent to it, a so-called SOPTEL command must be given. Using this command, it is possible to change the device data. However, the PIN code of the device must be known. Copyright 2010 Labkotec Oy 32/33 Labkotec reserves the right to any changes

33 9.2.1 Changing the device PIN code The LevelSET S GSM device has a device-specific PIN code, which is not the same as the SIM card PIN code for the device. If you have forgotten the administrator phone number or specified an incorrect one, you can change it using the 4-digit PIN code of the device. NOTE: The factory setting for the PIN code is PIN <old PIN> <new PIN> Example message: PIN Resetting an administrator phone number changes the PIN code from the factory setting of 1234 to SOPTEL <PIN> <your phone number> This authorises your phone number to change the device data. Example message: SOPTEL grants the change rights to phone number Send the text message command to the phone number of the device. 3. Set the administrator phone number. Setting the administrator phone number takes place with a regular OPTEL message as described in chapter Setting an administrator phone number, by setting your phone number as an administrator phone number for the device. Copyright 2010 Labkotec Oy 33/33 Labkotec reserves the right to any changes

34