Summary of the content on the page No. 1
NOKIA 30
GSM CONNECTIVITY TERMINAL
GUIDE FOR USER CONTROL MODE
Copyright © Nokia Corporation 2002. All rights reserved. Issue 1.0
Summary of the content on the page No. 2
Contents DEFINITIONS AND TERMINOLOGY..................................................................................... 2 REFERENCES ......................................................................................................................3 1. DOCUMENT SCOPE..................................................................................................... 3 2. PRODUCT CONCEPT AND USAGE ............................................................................. 3 2.1 GENE
Summary of the content on the page No. 3
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
Summary of the content on the page No. 4
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
Summary of the content on the page No. 5
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. For more detailed information
Summary of the content on the page No. 6
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. The input
Summary of the content on the page No. 7
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. its empty), the service is switched off and commands cannot be exe
Summary of the content on the page No. 8
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.2 INPUT MODE AND INITIAL OUTPUT STATE Input modes and initial output states can be configured with the Nokia 30 Confi
Summary of the content on the page No. 9
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. 7/18
Summary of the content on the page No. 10
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.4 CONNECTING A DEVICE OR A MACHINE A device to be contr
Summary of the content on the page No. 11
5. INPUT/OUTPUT PIN DESCRIPTIONS The Nokia 30 GSM Connectivity Terminal has the following input and output pins that can be controlled using the services of the User Control mode (see Table 1): Table 1 Nokia 30 GSM Connectivity Terminal inputs and outputs and available modes Name Analog / Digital R/W Pin Number (*) Input 1 Analog / Digital R 31 Input 2 Analog / Digital R 33 Input 3 Analog / Digital R 36 Output 1 Digital R/W 37 Output 2 Digital R/W 39 Output 3 Digital R/W 40 Output 4
Summary of the content on the page No. 12
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: X Y X=Terminal Name, Y=Command. E.g. Nokia30 Output_Set All On Command with a Password: X Y Z X=Terminal Name, Y=Password, Z=Command E.g. Nokia30 password Output_Set All On 10/18
Summary of the content on the page No. 13
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). Table 2 Nokia 30 GSM Connectivity Terminal User control mode command list Command Description Change password Change_Pword Input_Get All Return states of all inputs Input_Get 1 Return a state of input 1 Input_Get 2 Return a state of input 2 Return a state of input 3 Input_Get 3 Input_Get_Change All Su
Summary of the content on the page No. 14
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 7.2 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. Note: If a command string is not identified but the Identifier and the optional Password are ok, the terminal will send
Summary of the content on the page No. 15
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). Table 4 The Input_Get X commands Command type Command template Comments Input_Get All Nokia30 Input_Get All The command reads all inputs and the Response: response returns the INPUT_GET ALL: OK state of those according to input INPUT1: X pin configuration INPUT2: X INPUT3: X The X
Summary of the content on the page No. 16
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. Input configuration for receiving events 14/18
Summary of the content on the page No. 17
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 Response: for all inputs at once INPUT_GET_CHANGE ALL: and the response returns the state of INPUT 1: X those according to input pin INPUT 2: X configuration INPUT 3: X The X refers to success state and it can be: OK or CHECK CONFIG. Event data, when input state has changed, contains the following infor
Summary of the content on the page No. 18
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 Response: state of those 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. Output_
Summary of the content on the page No. 19
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 Response e.g. when Z = 1: 5) to ON state and the , Z = 1,2,3,4 or 5 OUTPUT_SET Z ON: response returns the state of all outputs 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 The command sets output Z (Z = 1,2,3,4 or Response e.g. when Z = 1
Summary of the content on the page No. 20
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 Response: returns the state of it SUPPLY_PWR_GET: X The X refers to either ON or OFF. Nokia30 Supply_Pwr
