Nokia 12 GSM MODULE User Manual

NOKIA 12 GSM MODULE
REMOTE I/O CONTROL GUIDE
Copyright © 2002-2004 Nokia. All rights reserved. Issue 2.0 9231722
Contents
ACRONYMS AND TERMS ......................................................................................................1
1. ABOUT THIS DOCUMENT ................................................................................................2
2. INTRODUCTION ................................................................................................................3
3. SECURITY.......................................................................................................................... 5
4. GETTING STARTED ..........................................................................................................7
5. OPTIONAL CONFIGURATIONS ......................................................................................13
5.2.1 Authorised numbers.............................................................................................15
6. INPUT/OUTPUT PIN DESCRIPTIONS ............................................................................22
7. SUPPORTED CHARACTERS.......................................................................................... 25
8. COMMAND SYNTAX .......................................................................................................26
9. REMOTE I/O CONTROL SMS COMMANDS................................................................... 27
9.3.1 Changing the Password.......................................................................................29
9.3.2 Reading Inputs..................................................................................................... 30
9.3.3 Subscribing to Input Alarms................................................................................. 32
9.3.4 Reading Outputs.................................................................................................. 34
9.3.5 Writing Outputs ....................................................................................................35
9.3.6 Inverting Outputs ................................................................................................. 37
9.3.7 Output Pulses ......................................................................................................38
9.3.8 Cancelling Output Pulses .................................................................................... 40
9.3.9 Location information ............................................................................................43
10. SAFETY INFORMATION..................................................................................................46
Legal Notice
Copyright © 2002-2004 Nokia. All rights reserved.
Reproduction, transfer, distribution or storage of part or all of the contents in this document in any form without the prior written permission of Nokia is prohibited.
Nokia and Nokia Connecting People are registered trademarks of Nokia Corporation. <Java and all Java-based marks are trademarks or registered trademarks of Sun Microsystems, Inc.> Other product and company names mentioned herein may be trademarks or trade names of their respective owners.
Nokia operates a policy of continuous development. Nokia reserves the right to make changes and improvements to any of the products described in this document without prior notice.
Under no circumstances shall Nokia be responsible for any loss of data or income or any special, incidental, consequential or indirect damages howsoever caused.
The contents of this document are provided "as is". Except as required by applicable law, no warranties of any kind, either express or implied, including, but not limited to, the implied warranties of merchantability and fitness for a particular purpose, are made in relation to the accuracy, reliability or contents of this document. Nokia reserves the right to revise this document or withdraw it at any time without prior notice.

ACRONYMS AND TERMS

Acronym/term Description
ASCII American Standard Code for Information
Interchange
AT Attention
CORBA Common Object Request Broker Architecture
CSD Circuit Switched Data
GPRS General Packet Radio Service
GPS Global Positioning System
GSM Global System for Mobile Communications
I/O Input/Output
M2M Machine-to-Machine, Mobile-to-Machine,
Machine-to-Mobile
NITZ Network Indication and Time zone
SMS Short Message Service
SW Software
1/49
1. ABOUT THIS DOCUMENT
This document describes how the Nokia 12 GSM module can be used in Remote I/O control mode. The methods for controlling a module in this operation mode are described, as well as how to increase security.
Before using the product, it is important to read the safety instructions and notifications at the end of this document, see chapter 10.
For more information about the Nokia 12, other Nokia M2M products, and application development for M2M, please visit Forum Nokia and M2M links at
http://www.forum.nokia.com
or http://www.americas.forum.nokia.com.
2/49
2. INTRODUCTION
2.1 GENERAL
The Nokia 12 GSM Module provides wireless connectivity and remote management possibilities for machine-to-machine (M2M) applications and other wireless solutions. The Nokia 12 GSM Module has two variants:
RX-2 is dual band EGSM900/GSM1800 product
RX-9 dual band GSM850/GSM1900 product.
The Nokia 12 GSM Module supports EGPRS, GPRS, HSCSD (not supported in RX-9), CSD, and SMS.
Simple I/O applications can be easily implemented using the Nokia 12 GSM Module in the Remote I/O control, which offers message personalising, secure messaging, and timing functionality for SMS controlled I/O applications.
Additional intelligence for I/O applications can easily be implemented with Java. Java technology enables upgrading the application software, IMlet, also remotely.
The Nokia 12 GSM Module enables also location service in the Remote I/O control. Location coordinates can be easily queried by SMS.
The Remote I/O control is explained in this document.
Note: Some services described or mentioned in this document, such as GPRS, are network dependent. Please contact your network service provider for details.

2.2 REMOTE I/O CONTROL

In the Remote I/O control the Nokia 12 GSM Module is controlled with, for example, a compatible mobile phone. Control messages are sent as text messages from the mobile phone to the Nokia 12 GSM Module. Based on the information in the text message, the Nokia 12 GSM Module in turn controls a device or machine attached to it through the M2M system connector.
Table 1. Functions in the Remote I/O control
Function Details
Control a device Switch devices on or off
Switch devices on or off for a period of time
3/49
Monitor a device Find out if a device is already on or off
Receive alarm messages if a device has been switched on or off
Receive alarm messages if a specified alarm limit has been crossed
Personalize Define your own device commands (aliases)
Disable acknowledgements for device commands
Select the frequency of alarm messages (alarm once/continuously)
Identify the calling party and give permissions for device control
Position Get position information through the Nokia 12 GSM Module when connected to a
GPS device
The Nokia 12 GSM Module processes the control message it receives, and sends the response as a text message back to the originator. Received and recognised control messages are not stored in the Nokia 12 GSM Module memory. If a text message is not recognised as a control message, it is stored on the SIM card or Nokia 12 GSM Module memory as a normal text message.
Before you can send control messages to the Nokia 12 GSM Module in order to control or monitor the device attached to it, you must configure the Nokia 12 GSM Module. Use the Nokia 12 Configurator software, which can be downloaded at http://www.forum.nokia.com
http://www.americas.forum.Nokia.com
or
. Some configurations are also possible
with control messages; others require that Configurator is used.
Note: To use Configurator, you need the Nokia 12 GSM Module and a test board. The Nokia 12 GSM Module is connected to a compatible PC and Configurator with the test board. A power supply, data cable, antenna adapter, antenna, and SIM card are also needed. All these items are included in the Nokia 12 GSM Module test board sales package.
Attach the device to be controlled or monitored with control messages to the general-purpose inputs and outputs of the M2M system connector of the Nokia 12 GSM Module. There are 11 inputs of which the first three (1-3) are analog and the rest (4-11) are digital. The Nokia 12 GSM Module has also 9 digital output pins on the M2M system connector. If the information available from the device is continuous, select one of the three analog input pins. If the information is on/off information, use the inputs 4-11. The nine outputs can be used in digital mode only (set something on/off).
4/49
3. SECURITY
There are different levels of access control for the Remote I/O control: message identifier, password, and authorised numbers. Also the aliases defined for commands increase security.
You must use a message identifier, which means that you must name the Nokia 12 GSM Module to be able to use the Remote I/O control. Each control message begins with an identifier, which enables the Nokia 12 GSM Module recognise it as a Remote I/O control message. Enter the identifier with the Nokia 12 Configurator software when using the Nokia 12 GSM Module for the first time (see chapter 4.5). Only users who know the correct message identifier can control and monitor the device attached to the Nokia 12 GSM Module. The message identifier is case sensitive.
You can use a password to further secure the communication between the mobile phone and the Nokia 12 GSM Module. You must enter the password when sending a control message to the Nokia 12 GSM Module. Set the password with Configurator or with a control message (see chapter 5.2). Only users who know the correct password can control and monitor the device attached to the Nokia 12 GSM Module. The password is case sensitive.
You can also determine a closed user group of up to 16 authorised phone numbers. The Nokia 12 GSM Module only accepts control messages from these phone numbers. Specify the numbers with Configurator. The first number on the authorised phone number list is in bold and it identifies the main user of the Nokia 12 GSM Module. The main user is notified of any unauthorised control attempts.
You can use user-defined commands (aliases) instead of the default commands of the Nokia 12 GSM Module (see chapter 5.3). If an alias has been defined, the default command can no longer be used and is not accepted as part of a control message. While default commands are generally known, an alias is only known by the one who defined it. Only users who know the correct alias can control and monitor the device attached to the Nokia 12 GSM Module.
Note: The message identifier and password are case sensitive, whereas commands and aliases are not.
5/49
6/49
4. GETTING STARTED

4.1 SETTING UP THE CONFIGURATOR ENVIRONMENT

To use Configurator, the following tools are needed:
Nokia 12 GSM Module (RX-2 or RX-9)
Nokia 12 test board
Power supply ACW-6
Data cable AXS-3
Antenna adapter cable
Antenna
SIM card
All items listed above, except the SIM card, are included in Test board sales package. Configurator can be used with a SIM card inserted to the test board SIM card holder. To use Configurator:
1. Mount the Nokia 12 GSM Module on the 60-pin connector of the test board.
2. Insert the SIM card into the test board SIM card holder.
3. Connect the antenna to the Nokia 12 GSM Module with the antenna adapter cable.
4. Connect the data cable AXS-3 to a compatible PC and to the test board. Use the D9 connector port 2 in the test board. To enable the connection, select the M2M system protocol in the preferences dialog (File -> Preferences) as the communication type.
5. Turn the switch on the test board in the following way:
6. Connect the power supply ACW-6 to the test board and to an AC wall outlet.
Note: The connection settings in the preferences dialog must be correct.
For more information on the Nokia 12 test board, refer to the Nokia 12 Test Board Specification.
7/49
When you have completed the above steps, Configurator automatically establishes a connection between the PC and the Nokia 12 GSM Module when Configurator is started.

4.2 CONNECTING A DEVICE OR A MACHINE

Connect the device to be controlled with the Remote I/O control to the Nokia 12 GSM Module through the M2M system interface. The general-purpose inputs and outputs of the M2M system connector that are described in Chapter 6 are connected to the device.
More information about how to connect a device electrically to the Nokia 12 GSM Module and about the recommended connector types is provided in Nokia 12 GSM Module HW Integration Manual.
4.3 MANDATORY SETTINGS
To use the Remote I/O control of the Nokia 12 GSM Module, you have to configure these settings:
Message identifier
SMS centre address
You can also configure the following optional settings (described in Chapter
5):
Disabling acknowledgements
Security settings
Input settings
Defining aliases for text messages
Initial output value settings
GPS port settings
Use Nokia 12 Configurator to configure the settings of the Nokia 12 GSM Module. Download Configurator at http://www.forum.nokia.com
http://www.americas.forum.nokia.com
(short message) for the optional settings.
or
. You can also use a control message
The following sections describe the process of getting started with the Remote I/O control.
Note: To use Configurator, you need the Nokia 12 GSM Module and a test board. The Nokia 12 GSM Module is connected to a compatible PC and Configurator with the test board. A power supply, data cable, antenna adapter, antenna, and SIM card are also needed. All these items are included in the Nokia 12 GSM Module test board sales package.
8/49

4.4 READING AND WRITING PARAMETERS

To read parameter values from the Nokia 12 GSM Module and write parameter values to it, use Configurator. Each Configurator dialog has “Read parameters” and “Write parameters” button for this purpose. Data is transferred between Configurator and the Nokia 12 GSM Module only after you have clicked either of these buttons.
Note: To apply the configured settings, click either the Read parameters or Write parameters button.
Some of the settings require that you reset the Nokia 12 GSM Module before they take effect. Either click the Reset button on the test board or remove and plug in the power cord on the test board. You can also use Configurator to reset the Nokia 12 GSM Module (File -> Reboot Module).
Note: The Nokia 12 GSM Module should be reset after you have configured all parameter values.
After a parameter value has been successfully configured to the Nokia 12 GSM Module, the dialog in Figure 1 appears.
Figure 1. Dialog for successful parameter configuration

4.5 DEFINING THE MESSAGE IDENTIFIER

The message identifier is a mandatory setting that must be configured in order to use the Remote I/O control. Figure 2 shows a dialog (User Control Mode -> Settings -> Initialize) where you can set the identifier in Configurator. To define the message identifier, press Change. See Figure 2.
Note: Press the Write parameters button to activate the new identifier.
After you have set the message identifier, more parameters become available. If a message identifier has been previously defined to the Nokia 12 GSM Module, press the Read parameters button to enable the additional parameters.
9/49
Characters accepted for the message identifier are defined in Chapter 7, except the space characters.
Note: You cannot use the Remote I/O control if there is no message identifier defined. In this case, all received short messages will be handled as normal messages and the inputs/outputs cannot be controlled in the Remote I/O control.
Note: The message identifier is 1-8 characters long and case sensitive.
Figure 2. User Control Mode dialog
10/49

4.6 SETTING THE SMS CENTRE ADDRESS

A dialog for setting the SMS centre address with the Nokia 12 Configurator (GSM Settings -> Advanced -> Short Messages) is shown in Figure 3.
To check whether the SMS centre address is available on the network service provider SIM card, press the Read parameters button shown in Figure 3. If the SMS centre address is not available, specify it in the Short Messages dialog in order to be able to use the Remote I/O control.
Note: Contact your network service provider for the SMS centre address.
Figure 3. Short Messages dialog
Short messages can be stored in the SIM card or the Nokia 12 GSM Module memory. If both of these short message storages are full, new messages cannot reach the Nokia 12 GSM Module. If the “Remove oldest message” option is selected in the short message dialog, the oldest message will be removed from the SIM card memory when a new message arrives, if both the
11/49
SIM card and the Nokia 12 GSM Module memory are full. It is recommended to select the option “Remove oldest message when new arrives” for the Remote I/O control, because then the control messages have a better chance of reaching their destination and fulfilling their purpose.
12/49
Loading...
+ 37 hidden pages