Nokia 12 GSM MODULE REMOTE I/O manual

Copyright © 2002-2004 Nokia. All rights reser ved. Issue 2.0 9231722 NOKIA 12 GSM MODULE REMOTE I/O CONTROL GUIDE[...]

Contents ACRONYMS AND TERMS ...................................................................................................... 1 1. ABOUT THIS DOCUMENT ................................................................................................ 2 2. INTRODUCTION ...............................................................................[...]

9.3.4 Reading Outputs .................................................................................................. 34 9.3.5 Writing Outputs .................................................................................................... 35 9.3.6 Inverting Outputs ............................................................................[...]

Legal Notice Copyright © 2002-2004 Noki a. All rights reserved. Reproduction, transfer, distribution or storage of part or a ll of the contents in this docume nt in any form without the prior written permission of Nokia is prohibite d. Nokia and Nokia Connecti ng People are registered tradem ar ks of Nokia Corporation. < Java and all Java-base [...]

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-Mac[...]

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 se curity. Before using the product, it is important to read the safety instructions and notifications at the end of this document, s[...]

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 supp[...]

Monitor a device Find out if a device is already on or off Receive alarm messages if a device has b een switched on or off Receive alarm messages if a specif i ed alarm limit has been crossed Personalize Define your own device comm ands (aliases) Disable acknowledgem ents for device commands Select the frequency of alarm messages (alarm once/contin[...]

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 f or 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 [...]

6/49[...]

4. GETTING ST ARTED 4.1 SETTING UP THE CO NFIGURATOR 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 sa[...]

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 in[...]

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[...]

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 han dled as normal messages and the inputs/outputs cannot be controlled in the Remote I/O control. Note: The me[...]

4.6 SETTING THE SMS CENTRE ADDRESS A dialog for setting the SMS centre address with the Nokia 1 2 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 [...]

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[...]

5. OPTIONAL CONFIGURA TIONS 5.1 DISABLING ACKNOWLEDGEMENTS The Nokia 12 GSM Module acknowledges whether or not a text message has successfully commanded a device. The Nokia 12 GSM Module sends a response as a text message back to the phone number that sent the control message. It is also possible to disable this feature to decrease the amount of co[...]

Figure 4. General settings If you select the Disable acknowledgements option, only response messages to acknowledgement messages are disabled. The following will not be disabled: • Status messages; responses to input state or value queries • Indication messages, for example, responses to timed commands (see Chapter 9.3.7) • Alarm messages; re[...]

• Response messages to password change messages (see Chapter 9.3.1) • Response messages to pulse cancel messages (see Cha pter 9.3.8) 5.2 SECURITY SETTINGS Figure 5 shows a dialog ( User Control Mode -> Settings -> Security ) where security settings can be configured with Nokia 12 Configurator. 5.2.1 Authorised numbers Authorised number s[...]

Figure 5. Security settings Authentication A user-specified password can further secure the communication between a mobile handset and the Nokia 12 GSM Module. The password must be entered when a control message is sent to the Nokia 12 GSM Module. When this feature has been set on, but the password is missing or incorrect, the message received is d[...]

The length of the password is 1- 8 characters, and it is case sensitive. It accepts characters defined in Chapter 7, except space chara cters. The password is case sensitive. Note: If the password is changed, an indication message is only sent to the phone number that requested the change. 5.3 ALIASING Figure 6 shows a dialog ( User Control Mode -&[...]

Figure 6. Setting aliases for device commands In the Aliasing dialog, you can replace the predefined commands with user- specified commands (aliases). The defined alias replaces the initial command or previous alias configured for the command. If an alias has been configured, the original command is no longer accepted. Defining an empty alias for a[...]

Characters accepted in aliases are defined in chapter 7 . Note: If an alias is defined, the default command will be disabled. There can be only one effective command or alias for each function at a time. An alias must not be equal to a default command. Empty aliases cannot be used. If an empty alias is set, the default command will remain effective[...]

Note: In digital input, an alarm can be triggered when the state of the digital input changes. See chapter 9.3.3 for more information. Figure 7. Input settings Note: In Figure 7 the Input 1 and 3 cannot be used for alarming because they are configured as Normal. 5.5 DEFAULT OUTPUT VALUE SETTING Set the initial state of each output pin and the devic[...]

values set here will take effect the next time the Nokia 12 GSM Module is powered up. Check the box in the Default Output Settings window to set the output to 1. If you leave the box empty, the output is 0. Note: The number of available digital outputs depends on the port config urations. 21/49[...]

6. INPUT/OUTPUT PIN DESCRIPTIONS The Nokia 12 GSM Module has input and output pins on the M2M system connector, which can be controlled using the services of the Remote I/O control. Pin descriptions are shown in Table 2. 22/49[...]

Table 2. PIN descriptions Name Analog/Digital R/W Pin Number (*) Input 1 Analog Read 36 Input 2 Analog Read 20 Input 3 Analog Read 19 Input 4 Digital Read 54 Input 5 Digital Read 35 Input 6 Digital Read 34 Input 7 Digital Read 56 Input 8 Digital Read 43 Input 9 Digital Read 59 Input 10 Digital Read 55 Input 11 Digital Read 46 Output 1 Digital Read/[...]

Figure 8. Port settings in Configurator Note: You can see the available I/O pins in the Module Configuration dialog when you change the settings. See Figure 8. 24/49[...]

7. SUPPORTED CHARACTERS The characters listed in Table 4 are supported fo r: • Message identifier • Password • Aliasing The list is derived from the Default Alphabet table of a GSM technical specification (see Digital cellular telecommunications system (Phase 2+); Alphabets and language-specific information (GSM 03.38)). CR, LF and Escape cha[...]

8. COMMAND SYNT AX The command syntax of control messages varies according to the activated options. There may also be spaces in aliases defined for commands as seen in the example below. However, only one space character is accepted between words. The message identifier and password are case sensitive. Note: A control message always begins with a [...]

9. REMOTE I/O CONTROL SMS COMMANDS The following chapter describes the commands and status messages a vailable in the Remote I/O control. Status messages are sent in response to device status queries. You can define an alias for each of the commands and status messages described here with Configurator. The first part of the chapter lists commands t[...]

OUTPUT_SET ALL OFF Set all outputs OFF OUTPUT_INVERT ALL Inverts all outputs OUTPUT PULSE ALL ON * All outputs pulse ON * OUTPUT _ PULSE ALL OFF * All outputs pulse OFF * INPUT_GET x Return a voltage of input x, x = pin number 1-11 INPUT_GET ALL Return states of all inputs INPUT_GET_CHANGE x Subscribe a vo ltage limit alarm of input x, x = pin numb[...]

Note: If an alias is defined, the default command will be disabled. There can be only one effective command or alias for each function at a time. An alias must not be equal to a default command. Empty aliases cannot be used. If an empty alias is set, the default command will remain effective. Note: The alias string must be unique and the maximum le[...]

Table 6. Commands for the password control. Command Type Command Comments Changing Password term123 passWORD Change_PWord wordPASS OK Response: CHANGE_PWORD wordPASS: OK Fail Response: CHANGE_PWORD: FAILED The example changes the password from ‘passWORD’ to ‘wordPASS’ Activating Password Property term123 Change_PWord wordPASS OK Response: C[...]

Table 7. The Input_Get X commands Command Type Command Comments Input_Get All term123 Input_Get All Response: INPUT_GET ALL: OK INPUT1: Y INPUT2: Y INPUT3: Y INPUT4: Y INPUT5: Y INPUT6: Y INPUT7: Y INPUT8: Y INPUT9: Y INPUT10: Y INPUT11: Y The Y varies according to the input pin state and it can be: xxxx mV if the input analog (pins 1-3), xxxx = va[...]

9.3.3 Subscribing to Input Alarms To subscribe to input state changes, that is, alarms, use the Input_Get_Change X commands. All example control messages in this chapter use the “term123” identifier string and the password property is set off (see Table 9). When you subscribe to this service, and an input state changes, you will receive an alar[...]

Table 8. Input_Get_Change commands for alarm functionality Command Type Command Comments Input_Get_Change All Term123 Input Get Change All Response: INPUT_GET_CHANGE ALL: INPUT 1: Y INPUT 2: Y INPUT 3: Y INPUT 4: Y INPUT 5: Y INPUT 6: Y INPUT 7: Y INPUT 8: Y INPUT 9: Y INPUT 10: Y INPUT 11: Y The Y refers to success state and it can be: OK or CHECK[...]

INPUT 11: Y The Y varies according to the input pin state and it can be: xxxx mV if the input is in analog mode (pins 1-3) (xxxx=value between 0-2800) ON or OFF if the input is in digital mode (pi ns 4-11) Input_Get_Change X term123 Input Get Change X Response: INPUT_GET_CHANGE Z: INPUT X: Y The X refers to input pin number, X=1,2,3,4,5,6, 7 ,8,9,1[...]

Table 9. Output_Get X commands Command Type Command Comments Output_Get All term123 Output_Get All Response: OUTPUT_GET ALL: OK OUTPUT 1: Y OUTPUT 2: Y OUTPUT 3: Y OUTPUT 4: Y OUTPUT 5: Y OUTPUT 6: Y OUTPUT 7: Y OUTPUT 8: Y OUTPUT 9: Y The Y refers to either ON or OFF The command reads all outputs and the response returns the state of them Output_G[...]

Table 10. Output_Set X commands Command Type Command Comments Output_Set X On term123 Output_Set X On Response: OUTPUT_SET Z ON: OK OUTPUT Z: ON The X refers to output pin number, X=1,2,3, 4,5,6,7,8,9. The command sets output pin X to ON state and the response returns the state of it Output_Set X Off term123 Output_Set X Off Response: OUTPUT_SET X [...]

OUTPUT 3: OFF OUTPUT 4: OFF OUTPUT 5: OFF OUTPUT 6: OFF OUTPUT 7: OFF OUTPUT 8: OFF OUTPUT 9: OFF 9.3.6 Inverting Outputs Use the Output_Invert X commands to invert digital output states. The state of an output can be changed without knowing its previous state. Note that all example control messages in this chapter use the “ term123 ” identifie[...]

OUTPUT 7: X OUTPUT 8: X OUTPUT 9: X The X refers to either ON or OFF 9.3.7 Output Pulses Use the Output_Pulse X Y commands to set digital output states to requested state for a specified time. Note that all example control messages in this chapter use the “ term123 ” identifier string and the password property is set off (see Table 12). While t[...]

Table 12. Output_Pulse X commands Command Type Command Comments Output_Pulse X On term123 Output_Pulse X On <time> Response: OUTPUT_PULSE X ON <time>: OK Response, when pulse time expires: OUTPUT X: Y The X refers to output pin number, X= 1,2,3,4,5,6,7, 8,9,all. The Y refers to either ON or OFF. Response, if another pulse command has a [...]

ERROR( Unknown Command ) Fail response, if NITZ net work service is not supported and <time> value was more than 23 hours 59 minutes and 59 seconds: OUTPUT PULSE OFF <time>: ERROR( Network Time Missing ) The X refers to output pin number, X=1,2,3,4,5,6, 7 ,8,9,all. The Y refers to either ON or OFF Command syntax for <time> paramet[...]

X ” command. Note that all example control messages in this chapter use the “term123” identifier string and the password property is set off (see Table 13). The command cancels the timing of the pulse operation and informs the original pulse originator about it. The state of the cancelled output remains the same, as was set with Output_Pulse [...]

Case Initial state Control message Control message sent when 3s passed a) ON Term123 Output_pulse 1 ON 5s b) ON Term123 Output_pulse 1 OFF 5s c) OFF Term123 Output_pulse 1 ON 5s d) OFF Term123 Output_pulse 1 OFF 5s Term123 Output_Pulse_Cancel 1 Figure 10. Effects of cancelling an output pulse in different initial stages and for different commands 4[...]

9.3.9 Location information Figure 11. GPS support configured to serial port 1 You can query location information from the Nokia 12 GSM Module if an external GPS device is connected to either the serial port 1 or 3. The se rial port used has to be configured with Nokia 12 Configurator, see Figure 11. Note: If you have selected serial port 3 for GPS [...]

Note: You cannot connect a GPS device to serial port 2. It is always in the M2M system protocol use. Note: You can connect only one GPS device to the Nokia 12 GSM Module (PORT1 or PORT3). To use GPS support, configure the GPS settings (baud rate and used NMEA parameters). See your GPS device m anual for information about parameters used. Query the [...]

Table 14. Location_get Command Type Command Comments Location_get term123 Location_get Response: LOCATION: LATITUDE: AA, BBBBBBBBB, C LONGITUDE: DDD, EEEEEEEEE, F SPEED: GGGG, HHHH SATELLITES: II ALTITUDE: JJJJJJJJ, K TIME: LL, MM, NNNN DATE: OO, PP, QQQQ Example response: LOCATION: LATITUDE: 66,12.2907,N LONGITUDE: 025,30.7094,E SPEED:173.3,21.7 S[...]

10. SAFETY INFORMA TION Read these simple guidelines as they contain important safety information. Breaking the rules may be dangerous or illegal and may also invalidate the service terms that may apply to this device. Read the complete documentation for further information. The device should only be installed to places where it does n ot cause int[...]

you can utilize Network Services. Your service provider may need to give you additional instructions for their use and explain what charges will apply. Some networks may have limitations that affect how you can use Network Services. This device operates using radio signals, wireless networks, landline networks, and user-programmed functions. Becaus[...]

systems. For more information, check with the manufacturer or it’s representative of your vehicle or any equipment that has been added. Only qualified personnel should service t he device, or install the device in a vehicle. Faulty installation or service may be dangerous and may invalidate any warranty that may apply to the device. Check regular[...]

49/49 • Do not drop, knock, or shake the device. Rough handling can break internal circuit boards and fine mechanics. • Do not use harsh chemicals, cleaning solvents, or strong detergents to clean the device. • Do not paint the device. • Use only with properly authorized antennas. Unauthorised antennas, modifications, or attachments could d[...]