Contents ACRONYMS AND TERMS ... 1 1. ABOUT THIS DOCUMENT ... 2 2. INTRODUCTION ... 3 2.1 GENERAL... 3 2.2 REMOTE I/O CONTROL ... 3 3. SECURITY... 5 4. GETTING STARTED ... 7 4.1 SETTING UP THE CONFIGURATOR ENVIRONMENT ... 7 4.2 CONNECTING A DEVICE OR A MACHINE ...
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.
ACRONYMS AND TERMS Acronym/term Description ASCII American Standard Code for Information Interchange Attention CORBA Common Object Request Broker Architecture Circuit Switched Data GPRS General Packet Radio Service Global Positioning System Global System for Mobile Communications Input/Output Machine-to-Machine, Mobile-to-Machine, Machine-to-Mobile NITZ Network Indication and Time zone Short Message Service Software...
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.
Please contact your network service provider for details. 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.
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.
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.
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.
Configurator is started. 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.
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.
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: 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.
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.
OPTIONAL CONFIGURATIONS 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.
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) •...
Note: The phone numbers in the authorised number list should be defined in international format with a plus sign, country codes, etc. Note that the Nokia 12 GSM Module needs to receive and identify the number to recognise it as authorised.
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.
Note: If the password is changed, an indication message is only sent to the phone number that requested the change. 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...
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.
Figure 7 shows a dialog (File -> Module Configuration -> Input Settings) where you can configure analog input settings with Configurator. The Nokia 12 GSM Module has separate digital and analog inputs. You can set high and low limits to the analog input pins. The pin can be in the normal or alarm mode.
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.
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.
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...
For more information on the electrical characteristics of the M2M system connector, see Nokia 12 GSM Module Hardware Integration Manual. Note: Depending on the Nokia 12 GSM Module configuration, some pins are used as serial ports (TxD, RxD, CTS and so on). GPS support can be configured to some pins.
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...
SUPPORTED CHARACTERS The characters listed in Table 4 are supported for: • 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 characters are not supported.
Note: A control message always begins with a message identifier. Otherwise the message is not interpreted 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>...
The Nokia 12 GSM Module supports the SMS commands listed in Table 4. These commands are for controlling or monitoring purposes (to query the state of a device attached to the Nokia 12 GSM Module). An alias can be defined for each of the commands.
Output_Pulse 1 On 5m30s For more information about pulse commands, see Chapter 9.3.7. ** The location support needs external GPS device to be connected to the Nokia 12 GSM Module. The Nokia 12 GSM Module supports NMEA-0183 protocol.
Note: If a command or the alias defined for it is not identified, but the identifier and the optional password are correct, the Nokia 12 GSM Module will send an error message as a response to the command originator, for example:...
“term123” identifier string and the password property is set off (see Table 7) A response depends on the pin. There are three analog inputs (1-3) and nine digital inputs (4-11) in the Nokia 12 GSM Module M2M system interface. You can also specify an alias for the response (see chapter 9.2).
Table 7. The Input_Get X commands Command Type Command Input_Get All Response: The Y varies according to the input pin state and it can be: xxxx mV if the input analog (pins 1-3), xxxx = value between 0-2800 ON or OFF if the input is digital (pins 4 -11) Input_Get X Response: The X refers to input pin number,...
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 alarm message.
Table 8. Input_Get_Change commands for alarm functionality Command Type Command Input_Get_Change All Response: 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: Term123 Input Get Change INPUT_GET_CHANGE ALL: INPUT 1: Y INPUT 2: Y...
The Y varies according to the input pin state and it can xxxx mV (xxxx=value between 0-2800) ON or OFF if the input is in digital mode (pins 4-11) Input_Get_Change X Response: The X refers to input pin number, X=1,2,3,4,5,6,7,8,9,10,11. The Y refers to success state and it can be: Event data, when input state has changed, contains the following information:...
Table 9. Output_Get X commands Command Type Command Output_Get All Response: The Y refers to either ON or OFF Output_Get X Response: 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 9.3.5 Writing Outputs Use the Output_Set X commands to set digital output states.
Table 10. Output_Set X commands Command Type Command Output_Set X On Response: The X refers to output pin number, X=1,2,3,4,5,6,7,8,9. Output_Set X Off Response: The X refers to output pin number, X=1,2,3,4,5,6,7,8,9. Output_Set All On Response: Output_Set All Off Response: term123 Output_Set X On OUTPUT_SET Z ON: OK OUTPUT Z: ON...
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” identifier string and the password property is set off (see Table 11).
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).
Table 12. Output_Pulse X commands Command Type Command Output_Pulse X On Response: Response, when pulse time expires: 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 already been issued: Fail response, if invalid <time>...
Fail response, if NITZ network service is not supported and <time> value was more than 23 hours 59 minutes and 59 seconds: 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> parameter: <days>d<hours>h<minutes>m<seconds>s for example, Output_Pulse 1 On 5m30s Value ranges for <time>...
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 X command.
Case Initial Control message state Term123 Output_pulse 1 ON 5s Term123 Output_pulse 1 OFF 5s Term123 Output_pulse 1 ON 5s Term123 Output_pulse 1 OFF 5s Figure 10. Effects of cancelling an output pulse in different initial stages and for different commands Control message sent when 3s passed Term123 Output_Pulse_Cancel 1...
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 serial port used has to be configured with Nokia 12 Configurator, see Figure 11.
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).
Table 14. Location_get Command Type Command Location_get Response: Example response: term123 Location_get LOCATION: LATITUDE: AA, BBBBBBBBB, LONGITUDE: DDD, EEEEEEEEE, F SPEED: GGGG, HHHH SATELLITES: II ALTITUDE: JJJJJJJJ, K TIME: LL, MM, NNNN DATE: OO, PP, QQQQ LOCATION: LATITUDE: 66,12.2907,N LONGITUDE: 025,30.7094,E SPEED:173.3,21.7 SATELLITES: 04...
SAFETY INFORMATION 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 not cause interference or danger.
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.
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 the 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.
• 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. •...