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
Страница 1: ...Copyright 2002 2004 Nokia All rights reserved Issue 2 0 9231722 NOKIA 12 GSM MODULE REMOTE I O CONTROL GUIDE ...
Страница 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 ...
Страница 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 ...
Страница 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 ...
Страница 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 ...
Страница 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 ...
Страница 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 ...
Страница 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...
Страница 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 ...
Страница 10: ...6 49 ...
Страница 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...
Страница 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...
Страница 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...
Страница 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 ...
Страница 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...
Страница 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 ...
Страница 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 ...
Страница 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 ...
Страница 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...
Страница 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 ...
Страница 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 ...
Страница 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...
Страница 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...
Страница 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 ...
Страница 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 ...
Страница 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 ...
Страница 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 ...
Страница 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 ...
Страница 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 Ξ...
Страница 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 ...
Страница 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...
Страница 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 ...
Страница 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...
Страница 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...
Страница 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...
Страница 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...
Страница 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 ...
Страница 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...
Страница 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...
Страница 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...
Страница 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...
Страница 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...
Страница 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...
Страница 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...
Страница 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...
Страница 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 ...
Страница 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 ...
Страница 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...
Страница 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 ...
Страница 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...
Страница 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...
Страница 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...
Страница 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 ...
