Copyright © Nokia Corporation 2002. All rights reserved. Issue 1.
Contents DEFINITIONS AND TERMINOLOGY..................................................................................... 2 REFERENCES ...................................................................................................................... 3 1. DOCUMENT SCOPE..................................................................................................... 3 2. PRODUCT CONCEPT AND USAGE ............................................................................. 3 2.1 GENERAL ..........
Copyright © Nokia Corporation 2002. 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. Other product and company names mentioned herein may be trademarks or tradenames of their respective owners. Nokia operates a policy of continuous development.
DEFINITIONS AND TERMINOLOGY ASCII American Standard Code for Information Interchange AT Attention CORBA Common Object Request Broker Architecture CSD Circuit Switched Data GSM Group Special Mobile, Global System for Mobile communications GPRS General Packet Radio Service I/O Input/output M2M Machine-to-Machine, Man-to-Machine, Machine-to-Man SM Short Message, text message SMS Short Message Service SW Software 2/18
REFERENCES 1. Nokia 30 GSM Connectivity Terminal Product Guide 2. Nokia 30 GSM Connectivity Terminal Technical Specification 3. M2M System Connector Electrical Specification for Nokia 30 GSM Connectivity Terminal 1. DOCUMENT SCOPE This document describes how the Nokia 30 GSM Connectivity Terminal can be used in User control mode. The ways of controlling the terminal in this operation mode is described as well as how this can be done in a more secure way.
The Nokia 30 processes the SM and sends a response back to the command originator. Finally, a received and recognized command will be deleted by the service. Unrecognised commands would be stored to terminal or SIM as normal messages. The control or monitoring is through general-purpose inputs and outputs of the M2M System Connector. Thus, there are three general-purpose inputs and five general-purpose outputs on the M2M system connector of the Nokia 30 GSM Connectivity Terminal.
4. GETTING STARTED 4.1 SECURITY SETTING The following settings must be made first before the User Controlled I/O service can be used. All settings can be made with Nokia 30 Configurator software by opening menu option Remote I/O Control -> User control mode (see Figure 1). 4.1.1 Message identifier Message identifier is a mandatory parameter that has to be set in order to use the service. If this parameter is not set (i.e.
4.1.3 Password Password is an optional parameter that could be used if a user wants to secure system e.g. in case that commands will be accepted from several phone numbers. The parameter accepts 0-8 characters (ASCII character range 0x20-0x7E) e.g. password. The password is case sensitive (see Figure 1). Figure 1 User Control mode dialog in the Nokia 30 Configurator. 4.
The initial state of each output pin and thus the device being controlled can also be set using the Nokia 30 Configurator. See Figure 2 for a view of the Nokia 30 Configurator for setting initial output states. Figure 2 Setting initial output values with the Nokia 30 Configurator.
4.3 SMS CENTER NUMBER SMS Centre Number must be set. If it is not set, the service is in off mode. The SMS Centre number can be set with the Nokia 30 Configurator software by opening menu option GSM Settings -> Advanced -> Short messages (see Figure 3): Figure 3 Setting SMS centre number with the Nokia 30 Configurator Note that it is recommended that the terminal should be switched off and on every time parameters are changed. 4.
5.
6. COMMAND SYNTAX The command syntax varies according to activated options. Only one space character is accepted between between words. There may also be spaces in commands as seen on the example below. Password is case sensitive. Command without a Password: XY X=Terminal Name, Y=Command. E.g. Nokia30 Output_Set All On Command with a Password: XYZ X=Terminal Name, Y=Password, Z=Command E.g.
7. COMMAND TEMPLATES 7.1 COMMAND LIST The Nokia 30 GSM Connectivity Terminal supports the following text message templates as commands and they are not case sensitive (see Table 2).
7.2 Output_Set All On Set all outputs ON Output_Set All Off Set all outputs OFF Supply_Pwr_Get Return a state of supply power Supply_Pwr On Set supply power ON Supply_Pwr OFF Set supply power OFF DETAILED COMMAND INFORMATION AND RESPONSES Note that all example commands use the Nokia 30 identifier string and the password property is set off in all following chapters.
7.2.2 Reading Inputs The Input_Get X commands are used to read inputs. A response depends on how each input has been configured. Each input can be configured either as digital or analog (see Table 4).
When the Input mode is set to analog + alarming, an event is sent if the value is equal or exceeds the high limit or is equal or gets lower than the low limit. The state of the input is queried in a frequency defined in the period box. The subscription of events can be used by configuring the correct settings with Nokia 30 Configurator software by selecting menu option Remote I/O Control -> General (see Figure 4). Figure 4.
Table 5 Input_Get_Change commands for alarm functionality Command type Command template Comments Input_Get_Change All Nokia30 Input_Get_Change All The command subscribes events for all inputs at once and the response returns the state of those according to input pin configuration Response: INPUT_GET_CHANGE ALL: INPUT 1: X INPUT 2: X INPUT 3: X The X refers to success state and it can be: OK or CHECK CONFIG.
7.2.4 Reading Outputs The Output_Get X commands are used to read digital output states. Note that password property is set off in following example commands (see Table 6). Table 6 Output_Get X commands Command type Command template Comments Output_Get All Nokia30 Output_Get All The command reads all outputs and the response returns the state of those Response: OUTPUT_GET ALL: OK OUTPUT 1: X OUTPUT 2: X OUTPUT 3: X OUTPUT 4: X OUTPUT 5: X The X refers to either ON or OFF.
Table 7 Output_Set X commands Command type Command template Comments Output_Set Z On Nokia30 Output_Set Z On The command sets output Z (Z = 1,2,3,4 or 5) to ON state and the response returns the state of all outputs Response e.g. when Z = 1: , Z = 1,2,3,4 or 5 OUTPUT_SET Z ON: OUTPUT 1: ON OUTPUT 2: X OUTPUT 3: X OUTPUT 4: X OUTPUT 5: X, The X refers to either ON or OFF. Output_Set Z Off Nokia30 Output_Set Z Off Response e.g.
7.2.6 Controlling Power supply to the device Power output can be used to supply power through the Nokia 30 to the application. The Supply_Pwr commands are used to read/write power supply line states (see Table 8). Table 8 Supply_Pwr commands Command type Command template Comments Supply_Pwr_Get Nokia30 Supply_Pwr_Get The command reads the power supply line state and the response returns the state of it Response: SUPPLY_PWR_GET: X The X refers to either ON or OFF.
