background image

 

 

 

 

 

 

 

 

 

 

Copyri

ght ©

 

20

02-2

004 N

oki

a. All rights reser

ved.    Issue 2.0    92317

22 

 

 

 

 

NOKIA 12 GSM MODULE   

 REMOTE I/O CONTROL GUIDE

  

 

 

Summary of Contents for 12 GSM MODULE REMOTE I/O

Page 1: ...Copyright 2002 2004 Nokia All rights reserved Issue 2 0 9231722 NOKIA 12 GSM MODULE REMOTE I O CONTROL GUIDE ...

Page 2: ...9 4 6 SETTING THE SMS CENTRE ADDRESS 11 5 OPTIONAL CONFIGURATIONS 13 5 1 DISABLING ACKNOWLEDGEMENTS 13 5 2 SECURITY SETTINGS 15 5 2 1 Authorised numbers 15 5 3 ALIASING 17 5 4 INPUT SETTINGS 19 5 5 DEFAULT OUTPUT VALUE SETTING 20 6 INPUT OUTPUT PIN DESCRIPTIONS 22 7 SUPPORTED CHARACTERS 25 8 COMMAND SYNTAX 26 9 REMOTE I O CONTROL SMS COMMANDS 27 9 1 COMMANDS 27 9 2 STATUS MESSAGES 28 9 3 DETAILED ...

Page 3: ...uts 37 9 3 7 Output Pulses 38 9 3 8 Cancelling Output Pulses 40 9 3 9 Location information 43 10 SAFETY INFORMATION 46 10 1 NETWORK SUPPORT 46 10 2 ANTENNA 47 10 3 MEDICAL DEVICES 47 10 4 VEHICLES 47 10 5 POTENTIALLY EXPLOSIVE ENVIRONMENTS 48 10 6 CARE AND MAINTENANCE 48 ...

Page 4: ... 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 ...

Page 5: ...n 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 ...

Page 6: ...ibed 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 ...

Page 7: ...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 ...

Page 8: ...hed 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 or http www americas forum Nokia com 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 c...

Page 9: ... 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 ...

Page 10: ...6 49 ...

Page 11: ...est 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 th...

Page 12: ...e 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...

Page 13: ...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 ord...

Page 14: ... 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 ...

Page 15: ...ble 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 messag...

Page 16: ...emory 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 ...

Page 17: ...nded 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 communication with the device for example Figure 4 displays a dialog User Control Mode Settings General for configuring acknowledgement messages 13 49 ...

Page 18: ...bled Status messages responses to input state or value queries Indication messages for example responses to timed commands see Chapter 9 3 7 Alarm messages responses to alarm subscriptions see Chapters 5 4 and 9 3 3 Error messages that are sent for example in response to a control message with the correct message identifier and password but with the wrong command 14 49 ...

Page 19: ... The main user will be notified of any unauthorised control attempts The following message will be sent to the main user if there is an unauthorised control attempt Unauthorized Number Number X Command Y X is the phone number of the originator of the control message and Y is the command that was attempted If the length of a command or alias is too long to be shown in one message more than 160 char...

Page 20: ...set 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 discarded Activate or change the password with Configurator or with a control message see Chapter 9 3 1 16 49 ...

Page 21: ...cept space characters 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 Settings Aliasing where aliases can be defined for commands with the Nokia 12 Configurator 17 49 ...

Page 22: ...s has been configured the original command is no longer accepted Defining an empty alias for a command can restore the original command Duplicate aliases are not allowed Aliases can also be defined for status messages sent in response to status queries Thus an alias can be defined for a command for controlling the device querying the status of the device see chapter 9 1 and for the message receive...

Page 23: ... from 1 to 60 seconds For control messages querying input states or values see Chapter 9 3 2 You can subscribe to text message alarms as response messages This is done using control messages described in Chapter 9 3 3 As a default the alarm message is sent once to the number where the alarm was subscribed Alternatively the alarm can be sent continuously In this case alarm messages are sent when al...

Page 24: ... 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 device being controlled with Configurator File Module Configuration Default Output Values The 20 49 ...

Page 25: ...ime 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 configurations 21 49 ...

Page 26: ...TPUT 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 ...

Page 27: ...ead Write 30 Output 3 Digital Read Write 31 Output 4 Digital Read Write 32 Output 5 Digital Read Write 33 Output 6 Digital Read Write 57 Output 7 Digital Read Write 58 Output 8 Digital Read Write 42 Output 9 Digital Read Write 44 Pin number on M2M System Connector For more information on the electrical characteristics of the M2M system connector see Nokia 12 GSM Module Hardware Integration Manual ...

Page 28: ...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 ...

Page 29: ... specific information GSM 03 38 CR LF and Escape characters are not supported Note You cannot use a space in the message identifier or password However you can use it in aliases defined for commands Table 3 Characters supported by Configurator for Remote I O control SP 0 P p _ 1 A Q a q Φ 2 B R b r Γ 3 C S c s è Λ 4 D T d t é Ω 5 E U e u ù Π 6 F V f v ì Ψ 7 G W g w ò Σ 8 H X h x Ç Θ 9 I Y i y SP Ξ...

Page 30: ...rpreted as a Remote I O control message and is stored in the SIM card or the Nokia 12 GSM Module memory Control message without a password message identifier command alias term123 Output_Set All On Control message without a password with an alias defined message identifier command alias parameter term123 Output_Pulse All On 1h30m Control message with a password message identifier password command ...

Page 31: ...or each of the commands 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 length is 24 characters Neither comma...

Page 32: ...l output x pulse x pin number 1 9 OUTPUT PULSE CANCEL ALL Cancel all outputs LOCATION_GET Get location information The duration of the pulse will be added to the control message after the corresponding command The format is the following Output_Pulse 1 On days d hours h minutes m seconds s for example Output_Pulse 1 On 5m30s For more information about pulse commands see Chapter 9 3 7 The location ...

Page 33: ...input x on state x pin number 4 11 INPUT x OFF Alias for input x off state x pin number 4 11 The value of the sampled voltage will be added to the end of the response The value of the sampled voltage is between 0 2800 mV for example INPUT 1 10mV 9 3 DETAILED COMMAND INFORMATION AND RESPONSES All example commands in this chapter use the term123 identifier string and the password property is set off...

Page 34: ...PWord OK Response CHANGE_PWORD OK Fail Response CHANGE_PWORD FAILED The example changes the password from wordPASS to an empty password Note An indication of a password change is only sent to the phone number where the change was requested 9 3 2 Reading Inputs Use the Input_Get X commands for reading inputs that is the state or value of a device Note that all example control messages in this chapt...

Page 35: ...een 0 2800 ON or OFF if the input is digital pins 4 11 The command reads all inputs and the response returns the value and state Input_Get X term123 Input_Get X Response INPUT_GET X OK INPUT X Y The X refers to input pin number X 1 2 3 4 5 6 7 8 9 10 11 The Y varies according to the input pin state and it can be xxxx mV if the input is analog pins 1 3 xxxx value between 0 2800 ON or OFF if the inp...

Page 36: ...der to get the alarms For more information about alarm configurations see Chapter 5 4 There are two ways to configure an analog input to operate with alarm sending see Chapter 5 4 for configurations Alarming Input High Limit Input Low Limit Sampling Interval Once Continuously An alarm from the analog pin is sent if the value is equal to or higher than the high limit or equal to or lower than the l...

Page 37: ...NPUT 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 CONFIG Alarm message when input state has changed contains the following information 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 The command subscribes alarms for all inputs at once 33 49 ...

Page 38: ... 7 8 9 10 11 The Y varies according to the input pin state and it can be ON or OFF if the input is digital 4 11 xxxx mV if the input is analog 1 3 xxxx value between 0 2800 The command subscribes an alarm for input pin X and the response returns the state of it according to input pin configuration Input_Change_Cancel term123 Input_Change_Cancel X OK Response INPUT_CHANGE_CANCEL X OK The X refers t...

Page 39: ...the response returns the state of them Output_Get X term123 Output_Get X Response OUTPUT_GET X OK OUTPUT X Y The X refers to output pin number X 1 2 3 4 5 6 7 8 9 The Y refers to either ON or OFF The command reads output pin X and the response returns the state of it 9 3 5 Writing Outputs Use the Output_Set X commands to set digital output states Note that all example control messages in this chap...

Page 40: ...in number X 1 2 3 4 5 6 7 8 9 The command sets output pin X to OFF state and the response returns the state of it Output_Set All On term123 Output_Set All On Response OUTPUT_SET ALL ON OK OUTPUT 1 ON OUTPUT 2 ON OUTPUT 3 ON OUTPUT 4 ON OUTPUT 5 ON OUTPUT 6 ON OUTPUT 7 ON OUTPUT 8 ON OUTPUT 9 ON The command sets all outputs to ON state and the response returns the state of all outputs Output_Set Al...

Page 41: ...string and the password property is set off see Table 11 Table 11 Output_Invert X commands Command Type Command Comments Output_Invert X term123 Output_Invert X Response OUTPUT_INVERT X OK OUTPUT X Y The X refers to output pin number X 1 2 3 4 5 6 7 8 9 The Y refers to either ON or OFF The command inverts output pin X to opposite state Output_Invert All term123 Output_Invert All Response OUTPUT_IN...

Page 42: ...h the Output_Pulse_Cancel command described in Chapter 9 3 8 After the requested time has passed the output state is returned to the opposite value of that requested The final state of the output is independent of the initial state of the output The behavior of the output pins when the Output_pulse X command is used is depicted in Figure 9 d c b a Case Initial state Control message to be sent a ON...

Page 43: ...ROR Unknown Command Fail response if NITZ network service is not supported and time value was more than 23 hours 59 minutes and 59 seconds OUTPUT_PULSE ON time ERROR Network Time Missing The command sets to output pin X on for a requested time interval that is pulse Output_Pulse X Off term123 Output_Pulse X Off time Response OUTPUT_PULSE X OFF time OK Response when pulse time expires OUTPUT X Y Re...

Page 44: ...1 second to 7 days If NITZ network service is not supported the range is from 1 second to 23 hours 59 minutes and 59 seconds days If NITZ network service is supported the range is from 1 7 days hours 1 23 minutes 1 59 seconds 1 59 Value examples for valid time 7d 6d23h59m59s 45m 59s 4h25s 30m45s etc Value examples for invalid time 7d1s Maximum time 7 days exceeded 3m3m There cannot be two unit fie...

Page 45: ...lse_Cancel X commands Command Type Command Comments Output_Pulse_Cancel X term123 Output_Pulse_Cancel X Response OUTPUT_PULSE_CANCEL X OK Indication to original pulse originator OUTPUT X PULSE CANCELLED The X refers to output pin number X 1 2 3 4 5 6 7 8 9 all The command cancels the pulse of output pin X Note When canceling a pulse the state of the output does not revert to the same as it was bef...

Page 46: ...N 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 42 49 ...

Page 47: ...ation information from the Nokia 12 GSM Module if an external GPS device is connected to either the serial port 1 or 3 The serial port used has to be configured with Nokia 12 Configurator see Figure 11 Note If you have selected serial port 3 for GPS support Java cannot use the serial port 43 49 ...

Page 48: ...this chapter use the term123 identifier string and the password property is set off see Table 14 Response parameters of Location_get command are AA Latitude degrees 0 90 BBBBBBBBB Latitude minutes 0 59 999999 C Latitude type N or S DDD Longitude degrees 0 180 EEEEEEEEE Longitude minutes 0 59 999999 F Longitude type E or W GGGG Angle geological 0 359 9 HHHH Speed in knots 0 999 9 II Number of visib...

Page 49: ...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 SATELLITES 04 ALTITUDE 0022 M TIME 13 36 15 44 DATE 15 09 2003 Response is packed to one reply message 45 49 ...

Page 50: ...d be placed as close to the terminals of the power supply as possible Do not connect to incompatible products or components The device and antenna may be damaged if either come into contact with ground potentials other than the one in your applications 10 1 NETWORK SUPPORT The wireless device described in this guide is approved for use on the EGSM 900 GSM 1800 network RX 2 or on the GSM 850 GSM 19...

Page 51: ... against radio emission and the disturbances it might cause In any event you should contact your local antenna manufacturer for additional information concerning antenna types cables connectors antenna placement and the surrounding area You should also determine whether the antenna needs to be grounded or not Your local antenna manufacturer might be able to design a special antenna suitable for th...

Page 52: ...hicle engine Sparks in such areas could cause an explosion or fire resulting in bodily injury or even death Observe restrictions on the use of radio equipment in fuel depots storage and distribution areas chemical plants or where blasting operations are in progress Areas with a potentially explosive atmosphere are often but not always clearly marked They include below deck on boats chemical transf...

Page 53: ...ng 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 damage the device and may violate regulations governing radio devices If the device is not working properly take it to the nearest authorized service facility for service ...

Reviews: