Nokia 30 User Manual
NOKIA 30 GSM CO NNECTIVITY TERMINAL GUIDE FOR USER CONTROL MODE Copyright é No kia Corpora tion 2002. All righ ts reserved . Issue 1.0
Contents DEF INITI ONS AND TER M INOL OGY..................................................................................... 2 REF ERE NCES ..................................................................................................................... .3 1. DOCU M ENT SC OPE ..................................................................................................... 3 2. PRODUCT CONCEPT AND USAGE ............................................................................. 3 2.1 GENE RAL ............................................................................................................... 3 2.2 USE R CON TROL MOD E......................................................................................... 3 3. SECURITY ..................................................................................................................... 4 4. GET TING S TAR TED ..................................................................................................... 5 4.1 SECURITY SET TING .............................................................................................. 5 4.1.1 MESSAGE IDENTIFIER ....................................................................................... 5 4.1.2 AUTH ORIZA TI ON N UMB ER ................................................................................ 5 4.1.3 PASS W ORD ........................................................................................................ 6 4.2 INPU T M ODE AND INITI AL OU TPU T S TATE ......................................................... 6 4.3 SMS CE NTER N UM BER ......................................................................................... 8 4.4 CONN ECTIN G A DEV ICE OR A MA CH INE ............................................................ 8 5. INPU T/OU TPU T PIN DE SC RIPTI ONS .......................................................................... 9 6. COMM AN D SY NTAX ................................................................................................... 10 7. COMM AN D TEM P LATE S ............................................................................................ 11 7.1 COMM AN D LIS T ................................................................................................... 11 7.2 DETA ILED COM M AND IN FORM A TION AN D RE SP ONSE S ................................ 12 7.2.1 CHA NGE_ P W ORD ............................................................................................ 12 7.2.2 REA DING IN PU TS ............................................................................................. 13 7.2.3 SUB SCR IBING IN PU T E VEN TS ........................................................................ 13 7.2.4 REA DING OUTPU TS ......................................................................................... 16 7.2.5 WRITIN G OUTP UTS.......................................................................................... 16 7.2.6 CONTR OLLIN G P O W E R S UPP LY TO THE D EV ICE ........................................ 18
Copyright é No kia Corpora tion 2002. All r ights reserved . Reproduction, tr ansfer, d istrib ution or stora ge of part or all o f the cont ents in this do cument in any for m without the prior w ritten permi ssion of Nokia is prohibi ted. Nokia and Noki a Connecting People are register ed trade marks of Nokia Cor poration. Other product and company names m entioned her ein may be trad emarks or tradena mes of t heir resp ecti ve owners. Nokia oper ates a poli cy of con tinuous developme nt. Nokia reserves t he right t o make c hanges and improvement s to any of the pr oducts d escribed i n this document w ithout pr ior noti ce. Under no cir cumst ances sha ll Nokia be resp onsible for any l oss of data or inco me or any s pecial, incidental, conse quentia l or indirec t damages howsoev er ca used. The contents of this document are provided "as is". Except as required by applicable law, no warranties of any kind, either express or implied, inclu ding, but not limited to, the implied warranties of merchantabil ity and fitness for a p articular pur pose, are made in relat ion to the accuracy , reliability or contents of this doc ument. Noki a reserv es the right to r evise this document or withdraw it at any time without prior notice The availab ility of particular produc ts may v ary by regio n. Please check w ith the N okia dea ler nearest to you.
2/18 DEFINITI ONS AND TERMINOLOGY ASCII American Standard Code for Inf ormation Interchange AT Attention CORBA Common Ob ject R eques t Bro ker A rchitec ture CSD Circuit Switched Data GSM Group Speci al M obile, Global System for M obile communica tions GPRS General Packet Radio Service I/O Input/output M2M Machine-to-Machine, Man-to-Machine, Machine-to-Man SM Short M e ssage, tex t mes sage SMS Short Message Service S W Softw are
3/18 REFERENCES 1. Nokia 30 G SM Connectiv ity T erminal Product Guide 2. Nokia 30 G SM Connectiv ity T erminal Technical Specif ication 3. M2M System Connector Electr ical 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. T he way s of controlling the terminal in this operation mode is described as well as how this can be done in a m ore secure way. For more detailed information about the Nokia 30 GSM Connectivity T erminal, other Nokia M2M products and application development f or M2M, please visit Forum Nokia and M2M lin ks at h ttp:/ /ww w.fo rum.no kia.co m . 2. PRODUCT CONCEPT AND USAGE 2.1 GENERA L Nokia 30 is a G SM Connectivity Terminal for EGSM 900/GSM 1800 networks. It includes a GSM transceiver with built -in data capabilit ies, a SIM card reader, an inter nal antenna, an external antenna connector, and an M2M system connector. The Nokia 30 G SM Connectivity Terminal has three diff erent operation modes: ç User control m ode ç AT command mode and ç M2M system mode In AT command mode the Nokia 30 GSM Connectivity Terminal is used as a GSM data modem using AT commands. In M2M system m ode the Nokia 30 is used as a part of Nokia M2M Platfor m usin g COR BA messa gin g. 2.2 USER CONTROL MODE In the user control mode the Nokia 30 GSM Connectivity Ter minal is controlled with e.g. a mobile handset. T ext message (short message serv ice = SM) templates that are sent from the mo bil e to th e N okia 3 0 i nstru ct the te rminal , wh ich in turn contro ls a dev ice or machi ne, attache d to it throu gh the M 2M sy stem conn ecto r.
4/18 The Nokia 30 processes the SM and sends a response back to the command originator. Finally, a r eceived and recognized command will be delet ed by the service. Unrecognised commands would be stored to terminal or SIM as normal messages. The control or monitoring is through g eneral-purpose inputs and outputs of the M2M System Connector. Thus, t here are three general- purpose inputs and five gener al-purpose outputs on the M 2M sy stem connector o f the No kia 30 G SM Connecti vity Terminal . The inputs can be used in either dig ital (on/off) or analog (continuous signal) mode. T he outputs can be used in digit al mode only ( set something on/ off). 3. SECURITY There are three levels of access control for User control mode: messag e identifier, password and authorization number. A m essage identifier has to be used i. e. the terminal has to be named in o rder to be able to use the Use r control mode of the Nokia 30 GSM Connectiv ity Terminal. T he identifier initiat es every text messag e template aimed to contr ol the Nokia 30 GSM Connectivity Terminal and t he application attached to it. The identifier is entered with the Nokia 30 Configurator software when t he terminal is used for th e first time . A user specified password could be used to further secure the communication between the handset and the terminal. T he password is entered whenever a text message template is sent to the Nokia 30. The password is activated and/ or changed with the Nokia 30 Configurator s oftware or a text message ( SM). Access can be secured by specifying from which phone number the requests for control are allowed, thus determining an authorization num ber. The number specification is done with Nokia 30 Configurator software. Only one number can be specified as authoriz ation number.
5/18 4. GETTING ST A RTED 4.1 SECURITY SETTING The following setting s 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 m enu option Remote I/O Co ntrol -> User con trol mode (see Figu re 1 ). 4.1.1 Message ident ifier Message identifier is a mandatory paramet er that has to be set in order to use t he service. If this parame ter is not set (i.e. its emp ty), the servi ce is sw itched off and commands cannot be executed by the service. The paramet er accepts 0-8 characters (ASCII charact er range 0x20-0x7E) e.g. Nokia30. A command always start s with the Ident ifier. Note that t he Identifier parameter is case sensitive (see Figure 1). 4.1.2 Authorization number Authorized Number is an opt ional parameter that could be used if a user wants to secure the system e.g. in case commands will be accepted only fr om one phone number. The most secure system will be achieved if both, the Authorized Number and the Password, optional properties are activated. The parameter accepts numbers 0-9 and â â characte r (ASCII rang e 0x30-0x39 and 0x2B) e.g. 1234567890 and t he maximum length of it 32 (see Figure 1). If Author ized Number property is activated and a terminal receives a command from some other phone number, it will send a f ollowing indication m essage to the Authorized Number: Inv alid Or igina tor : Number: X Command: Y W here X refers to an invalid command or iginator phone number, and Y refers to a "command". The command ma y or may not be a valid comm and. If a command lengt h is too long to be shown in one message, the Y refer s to a text "T oo Long". In this case, t he indi cation message lo oks l ike th is ( X as desc ribe d ab ove ): Inv alid Or igina tor : Number: X Command: Too Long
6/18 4.1.3 Password Password is an optional par ameter that could be used if a user wants to secure system e.g. in case that commands will be accept ed from several phone numbers. T he parameter accepts 0-8 ch aracte rs (ASC II cha racter range 0 x20 -0x7 E) e.g. pa ssw ord. The passw ord i s case sensitive (see Figure 1). Figure 1 U ser Cont rol mode d ialo g in the Nok ia 3 0 Co nfigu rato r. 4.2 INPUT MODE AND INITIAL OUTPUT STATE Input modes and initial output states can be configured with the Nokia 30 Conf igurator by opening menu option Remote I/O control - > General. Each of the inputs can b e configured as digital or analog depending on th e nature o f the dev ice b ein g moni tored . I f the in formati on a vai lab le from the dev ice is on -off i nfo rmati on, the input should be configured as digital. If in turn the informat ion is of a continuous nature, t he input should be analog. (See Figure 4 for a view of t he Nokia 30 Conf igurator for I nput settin gs). It is possible to subscribe events as alarms to a specific phone number. In the case of digital input an alarm can be triggered when the state of the digital input changes. In t he case of analog input low and high limits and a period for checking the input state can be set. For more information about subscribing input events, see chapter 7.2.3.
7/18 The initial state of each output pin and thus the device being contr olled can also be set using the Nokia 30 Conf igurator. See Figure 2 for a view of the Nokia 30 Conf igurator for setting initial output states. Figure 2 Setti ng initial output values with t he Nokia 30 Configurat or.
8/18 4.3 SMS CENTER NUMBER SMS Cen tre Nu mber must b e set . I f it i s no t set, th e serv ice i s in o ff mo de . The SM S Ce ntre number can be set with the Nokia 30 Configurator software by opening m enu option GSM Settings -> Advanced -> Short messages (see Figure 3): Figure 3 Setting SM S centre number wit h the Nokia 30 Configurator Note that it is recommen ded that the ter minal sho uld be sw itched off and on ev ery ti me parameters are changed. 4.4 CONNECTING A DEVICE OR A MACHINE A dev ice to be co ntrol led w ith the Use cont rol mo de o f the No kia 30 i s con necte d phy sical ly to it t hrough the M2M System Connector. The general- purpose inputs and outputs of the M2M System Connector described in Chapter 5 are connected to the device. For more information about how to connect a device electrically to t he Nokia 30, please see reference 3. For information about the mechanical characteristics and r ecommended connector types for the M2M System Connector, please see Reference 1.
9/18 5. INPUT/O UTPUT PIN DESCRI PTIONS The Nokia 30 G SM Connectivity Terminal has the f ollowing input and output pins that can be control led u sin g the serv ice s of th e U ser C ont rol mode (see Table 1) : Table 1 Nokia 30 GSM Connect ivity Terminal inputs and outputs and avail able modes Name A nalog / Digital R/W Pin Numbe r (*) Input 1 Analog / D igita l R 31 Input 2 Analog / D igita l R 33 Input 3 Analog / D igita l R 36 Output 1 Digita l R/W 37 Output 2 Digita l R/W 39 Output 3 Digita l R/W 40 Output 4 Digita l R/W 42 Output 5 Digita l R/W 43 Suppl y Pwr Analog R/W 11 (*) Pin num ber on M2M S ystem Connector
10/18 6. COMM AND SYNT A X The command syntax v aries 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=Termin al Na me, Y=C omman d. E.g. Nokia30 Output_Set All On Command with a Pass word: X Y Z X=Terminal Name, Y=Password, Z=Command E.g. Nokia30 password Output_Set All On
11/18 7. COMM AND TEMPL A TES 7.1 COMMAND LIST The Nokia 30 G SM Connectivity Terminal supports t he following te xt message templates as commands and they are not case sensit ive (see Table 2). Table 2 Nokia 30 GSM Connect ivity Terminal User cont rol mode command list Command Description Change_P word Change pas sword Input_Get All Return states of all inputs Input_Get 1 Return a s tate of in put 1 Input_Get 2 Return a s tate of in put 2 Input_Get 3 Return a s tate of in put 3 Input_Get_ Change All Subscrib e a inp ut stat e change of all inputs Input_Get_ Change 1 Subscrib e a sta te chang e of in put 1 Input_Get_ Change 2 Subscrib e a sta te chang e of in put 2 Input_Get_ Change 3 Subscrib e a sta te chang e of in put 3 Output_G et All Return a state of al l outputs Output_G et 1 Return a state of outp ut 1. Output_G et 2 Return a state of outp ut 2 Output_G et 3 Return a state of outp ut 3 Output_G et 4 Return a state of outp ut 4 Output_G et 5 Return a state of outp ut 5 Output_Se t 1 On Set output 1 ON Output_Se t 1 Off Set output 1 OFF Output_Se t 2 On Set output 2 ON Output_Se t 2 Off Set output 2 OFF Output_Se t 3 On Set output 3 ON Output_Se t 3 Off Set output 3 OFF Output_Se t 4 On Set output 4 ON Output_Se t 4 Off Set output 4 OFF Output_Se t 5 On Set output 5 ON Output_Se t 5 Off Set output 5 OFF
12/18 Output_Se t All On Set all ou tputs ON Output_Se t All Of f Set all ou tputs OF F Su pply _Pwr_ Get Return a state of supp ly power Su pply _Pwr On Set supply pow er ON Su pply _Pwr OFF Set supply power OFF 7.2 DETAILED COMMAND INFORMATION AND RESPONSE S Note that all example commands use the Nokia 30 identifier string and the password property i s set off i n all followi ng chapters. Note: If a command string is not identified but t he Identifier and the opt ional Password are ok, the term inal will send a following response to the comm and originator: E.g. Nokia30 passWORD ResetAll -> ERROR (Unknown Command) 7.2.1 Change_Pword The Change_Pword command is used to control password propert y (see Table 3). Table 3 Command templates for the password Comm and type Comm and tem plate Comm ents Changing Passw ord Nokia30 pas sWORD Ch ange_PW ord w ordP ASS OK R esponse : CHANGE_PWORD: OK Fail Respon se: CH ANGE_PWORD: F AILED (In valid new passw ord) The ex ample changes t he password f rom âÂÂpassW ORDâ to âÂÂwo rdPASS â Activat ing Pass word Propert y Nokia30 Chan ge_PW ord w ordP ASS OK R esponse : CHANGE_PWORD: OK Fail Respon se: CH ANGE_PWORD: F AILED (In valid new passw ord) The ex ample changes an empt y password to âÂÂwo rdPASS â Deactivat ing Passwor d Proper ty Nokia30 w ordP ASS Chang e_PWord OK R esponse : CHANGE_PWORD: OK Fail Respon se: CH ANGE_PWORD: F AILED (In valid new passw ord) The ex ample changes t he password f rom âÂÂwordPAS Sâ to a n empt y
13/18 7.2.2 Reading Inputs The Inpu t_Ge t 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 T able 4). Table 4 The Input_Get X commands Comm and type Comm and tem plate Comm ents Input_Get All Nokia30 Input _Get All Response: IN PU T_G ET A LL: O K INPUT 1: X INPUT 2: X INPUT3: X The X var ies accor ding to the inpu t pin s tate and it can be: ON or OFF if the input is in dig ital m ode xxxx mV if the input is in a nalog m ode (xxxx=value between 0-5400). The comm and r eads all inputs and t he response r eturns the state of thos e according to inp ut pin conf igurat ion Input_Get Z , Z = 1,2 or 3 Nokia30 Input _Get Z Response: IN PU T_GE T Z : X The X var ies accor ding to the inpu t pin s tate and it can be: ON or OFF if the input is in dig ital m ode xxxx mV if the input is in a nalog m ode (xxxx=value between 0-5400). The comm and r eads input Z (Z = 1,2 or 3) and the res ponse returns the state of it according to inp ut pin conf igurat ion 7.2.3 Subscribing Input Events The I nput_Get_Change X commands are used for subscribing input state changes (see Table 5). A subscription will cause a sending of one event per input s tate change to t he subscriber phone number. The user can subscribe events of all input state changes at once or each input can be subscribed separately. Note that an input has to be configured properly in ord er to get eve nts w ith thi s se rvi ce. An input can be conf igured in two ways to operate with event sending: ç Digital input ç Analog input Alarming Input High Limit Input Low Limit Input Per iod When the Input mode is set to digital, an event is sent when the state of th e digital input changes from 0 -> 1 or 1 -> 0.
14/18 When the Input mode is set to analo g alarmin g, an event is sent i f the value is equal or exceeds the high lim it or is equal or get s 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 select ing menu option Remote I/O Control -> G eneral (see Figure 4). Figure 4. Input c onfiguration for receiving events
15/18 Table 5 Input_Get_Change commands for alarm functionality Comm and type Comm and tem plate Comm ents Input_Get_ Change All Nokia30 Input _Get_Chan ge All Response: IN PU T_GE T_C HA NG E A LL: INPUT 1: X INPUT 2: X INPUT 3: X The X ref ers to s uccess state and i t can be: OK or CHECK CONFIG . Event data , when input s tate has c hanged, c ontains the follo wing inf orm ation: INPUT 1: Y INPUT 2: Y INPUT 3: Y The Y varies accor ding to the inpu t pin s tate and it can be: ON or OFF if the input is in dig ital m ode xxxx mV if the input is in a nalog m ode (xxxx=value between 0-5400). The comm and subscr ibes events for all i nputs at o nce and the res ponse returns the state of those accor ding to input p in configur ation Input_Get_ Change Z , Z = 1,2 or 3 Nokia30 Input _Get_Chan ge Z Response: IN PU T_GE T_C HA NG E Z: INPUT Z: X The X ref ers to s uccess state and i t can be: OK or CHECK CONFIG . Event data , when input s tate has c hanged, c ontains the follo wing inf orm ation: INPUT Z: Y The Y varies accor ding to the inpu t pin s tate and it can be: ON or OFF if the input is in dig ital m ode xxxx mV if the input is in a nalog m ode (xxxx=value between 0-5400). The comm and subscr ibes the e vent for input Z (Z = 1, 2 or 3) and th e response r eturns the state of it acc ording to input pi n configur ation
16/18 7.2.4 Reading Outputs The Output_Get X commands are used to read digital output states. Note that password property i s set off i n follo wing example co mmands (see Table 6). Table 6 Output_Get X commands Comm and type Comm and tem plate Comm ents Output_G et All Nokia30 Out put_Get All Response: OUTPUT_GET ALL: OK OUTPUT 1: X OUTPUT 2: X OUTPUT 3: X OUTPUT 4: X OUTPUT 5: X The X ref ers to eit her ON or OFF. The comm and r eads all out puts and the res ponse ret urns th e state of thos e Output_G et Z , Z = 1,2,3,4 or 5 Nokia30 Out put_Get Z Response: OUTPUT_GET Z: X The X ref ers to eit her ON or OFF. The comm and r eads output Z (Z = 1,2,3, 4 or 5) and the r espons e returns the state of it 7.2.5 Writing Outputs The Output_S et X commands ar e used to write digit al output states. Note that password property i s set off i n follo wing example co mmands (see Table 7).
17/18 Table 7 Output_Set X commands Comm and type Comm and tem plate Comm ents Output_Se t Z On , Z = 1,2,3,4 or 5 Nokia30 Out put_Set Z On Response e.g. when Z = 1: OUTPUT _SET Z ON: OUTPUT 1: ON OUTPUT 2: X OUTPUT 3: X OUTPUT 4: X OUTPUT 5: X , The X ref ers to eith er ON or OFF . The comm and s ets output Z (Z = 1,2,3,4 or 5) to ON state and the response r eturns the state of al l outputs Output_Se t Z Off , Z = 1,2,3,4 or 5 Nokia30 Out put_Set Z Of f Response e.g. when Z = 1: OUTPUT _SET 1 O FF: OUTPUT 1: OFF OUTPUT 2: X OUTPUT 3: X OUTPUT 4: X OUTPUT 5: X , The X ref ers to eith er ON or OFF . The comm and s ets output Z (Z = 1,2,3,4 or 5) to OFF state an d the response r eturns the state of al l outputs Output_Se t All On Nokia30 Out put_Set All On Response: OUTPUT_SET ALL ON: OUTPUT 1: ON OUTPUT 2: ON OUTPUT 3: ON OUTPUT 4: ON OUTPUT 5: ON The c ommand s ets all outputs to ON st ate and the respons e retur ns the state of all outp uts Output_Se t All Of f Nokia30 Out put_Set All Off Response: OUTPUT_SET ALL OFF: OUTPUT 1: OFF OUTPUT 2: OFF OUTPUT 3: OFF OUTPUT 4: OFF OUTPUT 5: OFF The c ommand s ets all outputs to OFF state and the res ponse returns the state of all outputs
18/18 7.2.6 Controlling Power supply to the device Power output can be used to supply power t hrough the Nokia 30 t o the application. T he Supply_Pwr commands are used t o read/write power supply line states (see T able 8). Table 8 Supply_Pwr commands Comm and type Comm and tem plate Comm ents Su pply _Pwr_ Get Nokia30 Supp ly_ Pwr_G et Response: SUPPLY _PWR _GET : X The X ref ers to eit her ON or OFF. The comm and r eads the po wer suppl y line stat e and th e res ponse returns the state of it Su pply _Pwr On Nokia30 Supp ly_ Pwr On Response: SUPPLY_PWR O N: OK The comm and s ets the po wer suppl y line to ON state an d a response r eturns the conf irm ation of it Su pply _Pwr Off Nokia30 Supp ly_ Pwr Of f Response: SUPPLY_P WR OFF: OK The comm and s ets the po wer suppl y line to OFF state and a response r eturns the conf irm ation of it
Contents DEF INITI ONS AND TER M INOL OGY..................................................................................... 2 REF ERE NCES ..................................................................................................................... .3 1. DOCU M ENT SC OPE ..................................................................................................... 3 2. PRODUCT CONCEPT AND USAGE ............................................................................. 3 2.1 GENE RAL ............................................................................................................... 3 2.2 USE R CON TROL MOD E......................................................................................... 3 3. SECURITY ..................................................................................................................... 4 4. GET TING S TAR TED ..................................................................................................... 5 4.1 SECURITY SET TING .............................................................................................. 5 4.1.1 MESSAGE IDENTIFIER ....................................................................................... 5 4.1.2 AUTH ORIZA TI ON N UMB ER ................................................................................ 5 4.1.3 PASS W ORD ........................................................................................................ 6 4.2 INPU T M ODE AND INITI AL OU TPU T S TATE ......................................................... 6 4.3 SMS CE NTER N UM BER ......................................................................................... 8 4.4 CONN ECTIN G A DEV ICE OR A MA CH INE ............................................................ 8 5. INPU T/OU TPU T PIN DE SC RIPTI ONS .......................................................................... 9 6. COMM AN D SY NTAX ................................................................................................... 10 7. COMM AN D TEM P LATE S ............................................................................................ 11 7.1 COMM AN D LIS T ................................................................................................... 11 7.2 DETA ILED COM M AND IN FORM A TION AN D RE SP ONSE S ................................ 12 7.2.1 CHA NGE_ P W ORD ............................................................................................ 12 7.2.2 REA DING IN PU TS ............................................................................................. 13 7.2.3 SUB SCR IBING IN PU T E VEN TS ........................................................................ 13 7.2.4 REA DING OUTPU TS ......................................................................................... 16 7.2.5 WRITIN G OUTP UTS.......................................................................................... 16 7.2.6 CONTR OLLIN G P O W E R S UPP LY TO THE D EV ICE ........................................ 18
Copyright é No kia Corpora tion 2002. All r ights reserved . Reproduction, tr ansfer, d istrib ution or stora ge of part or all o f the cont ents in this do cument in any for m without the prior w ritten permi ssion of Nokia is prohibi ted. Nokia and Noki a Connecting People are register ed trade marks of Nokia Cor poration. Other product and company names m entioned her ein may be trad emarks or tradena mes of t heir resp ecti ve owners. Nokia oper ates a poli cy of con tinuous developme nt. Nokia reserves t he right t o make c hanges and improvement s to any of the pr oducts d escribed i n this document w ithout pr ior noti ce. Under no cir cumst ances sha ll Nokia be resp onsible for any l oss of data or inco me or any s pecial, incidental, conse quentia l or indirec t damages howsoev er ca used. The contents of this document are provided "as is". Except as required by applicable law, no warranties of any kind, either express or implied, inclu ding, but not limited to, the implied warranties of merchantabil ity and fitness for a p articular pur pose, are made in relat ion to the accuracy , reliability or contents of this doc ument. Noki a reserv es the right to r evise this document or withdraw it at any time without prior notice The availab ility of particular produc ts may v ary by regio n. Please check w ith the N okia dea ler nearest to you.
2/18 DEFINITI ONS AND TERMINOLOGY ASCII American Standard Code for Inf ormation Interchange AT Attention CORBA Common Ob ject R eques t Bro ker A rchitec ture CSD Circuit Switched Data GSM Group Speci al M obile, Global System for M obile communica tions GPRS General Packet Radio Service I/O Input/output M2M Machine-to-Machine, Man-to-Machine, Machine-to-Man SM Short M e ssage, tex t mes sage SMS Short Message Service S W Softw are
3/18 REFERENCES 1. Nokia 30 G SM Connectiv ity T erminal Product Guide 2. Nokia 30 G SM Connectiv ity T erminal Technical Specif ication 3. M2M System Connector Electr ical 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. T he way s of controlling the terminal in this operation mode is described as well as how this can be done in a m ore secure way. For more detailed information about the Nokia 30 GSM Connectivity T erminal, other Nokia M2M products and application development f or M2M, please visit Forum Nokia and M2M lin ks at h ttp:/ /ww w.fo rum.no kia.co m . 2. PRODUCT CONCEPT AND USAGE 2.1 GENERA L Nokia 30 is a G SM Connectivity Terminal for EGSM 900/GSM 1800 networks. It includes a GSM transceiver with built -in data capabilit ies, a SIM card reader, an inter nal antenna, an external antenna connector, and an M2M system connector. The Nokia 30 G SM Connectivity Terminal has three diff erent operation modes: ç User control m ode ç AT command mode and ç M2M system mode In AT command mode the Nokia 30 GSM Connectivity Terminal is used as a GSM data modem using AT commands. In M2M system m ode the Nokia 30 is used as a part of Nokia M2M Platfor m usin g COR BA messa gin g. 2.2 USER CONTROL MODE In the user control mode the Nokia 30 GSM Connectivity Ter minal is controlled with e.g. a mobile handset. T ext message (short message serv ice = SM) templates that are sent from the mo bil e to th e N okia 3 0 i nstru ct the te rminal , wh ich in turn contro ls a dev ice or machi ne, attache d to it throu gh the M 2M sy stem conn ecto r.
4/18 The Nokia 30 processes the SM and sends a response back to the command originator. Finally, a r eceived and recognized command will be delet ed by the service. Unrecognised commands would be stored to terminal or SIM as normal messages. The control or monitoring is through g eneral-purpose inputs and outputs of the M2M System Connector. Thus, t here are three general- purpose inputs and five gener al-purpose outputs on the M 2M sy stem connector o f the No kia 30 G SM Connecti vity Terminal . The inputs can be used in either dig ital (on/off) or analog (continuous signal) mode. T he outputs can be used in digit al mode only ( set something on/ off). 3. SECURITY There are three levels of access control for User control mode: messag e identifier, password and authorization number. A m essage identifier has to be used i. e. the terminal has to be named in o rder to be able to use the Use r control mode of the Nokia 30 GSM Connectiv ity Terminal. T he identifier initiat es every text messag e template aimed to contr ol the Nokia 30 GSM Connectivity Terminal and t he application attached to it. The identifier is entered with the Nokia 30 Configurator software when t he terminal is used for th e first time . A user specified password could be used to further secure the communication between the handset and the terminal. T he password is entered whenever a text message template is sent to the Nokia 30. The password is activated and/ or changed with the Nokia 30 Configurator s oftware or a text message ( SM). Access can be secured by specifying from which phone number the requests for control are allowed, thus determining an authorization num ber. The number specification is done with Nokia 30 Configurator software. Only one number can be specified as authoriz ation number.
5/18 4. GETTING ST A RTED 4.1 SECURITY SETTING The following setting s 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 m enu option Remote I/O Co ntrol -> User con trol mode (see Figu re 1 ). 4.1.1 Message ident ifier Message identifier is a mandatory paramet er that has to be set in order to use t he service. If this parame ter is not set (i.e. its emp ty), the servi ce is sw itched off and commands cannot be executed by the service. The paramet er accepts 0-8 characters (ASCII charact er range 0x20-0x7E) e.g. Nokia30. A command always start s with the Ident ifier. Note that t he Identifier parameter is case sensitive (see Figure 1). 4.1.2 Authorization number Authorized Number is an opt ional parameter that could be used if a user wants to secure the system e.g. in case commands will be accepted only fr om one phone number. The most secure system will be achieved if both, the Authorized Number and the Password, optional properties are activated. The parameter accepts numbers 0-9 and â â characte r (ASCII rang e 0x30-0x39 and 0x2B) e.g. 1234567890 and t he maximum length of it 32 (see Figure 1). If Author ized Number property is activated and a terminal receives a command from some other phone number, it will send a f ollowing indication m essage to the Authorized Number: Inv alid Or igina tor : Number: X Command: Y W here X refers to an invalid command or iginator phone number, and Y refers to a "command". The command ma y or may not be a valid comm and. If a command lengt h is too long to be shown in one message, the Y refer s to a text "T oo Long". In this case, t he indi cation message lo oks l ike th is ( X as desc ribe d ab ove ): Inv alid Or igina tor : Number: X Command: Too Long
6/18 4.1.3 Password Password is an optional par ameter that could be used if a user wants to secure system e.g. in case that commands will be accept ed from several phone numbers. T he parameter accepts 0-8 ch aracte rs (ASC II cha racter range 0 x20 -0x7 E) e.g. pa ssw ord. The passw ord i s case sensitive (see Figure 1). Figure 1 U ser Cont rol mode d ialo g in the Nok ia 3 0 Co nfigu rato r. 4.2 INPUT MODE AND INITIAL OUTPUT STATE Input modes and initial output states can be configured with the Nokia 30 Conf igurator by opening menu option Remote I/O control - > General. Each of the inputs can b e configured as digital or analog depending on th e nature o f the dev ice b ein g moni tored . I f the in formati on a vai lab le from the dev ice is on -off i nfo rmati on, the input should be configured as digital. If in turn the informat ion is of a continuous nature, t he input should be analog. (See Figure 4 for a view of t he Nokia 30 Conf igurator for I nput settin gs). It is possible to subscribe events as alarms to a specific phone number. In the case of digital input an alarm can be triggered when the state of the digital input changes. In t he case of analog input low and high limits and a period for checking the input state can be set. For more information about subscribing input events, see chapter 7.2.3.
7/18 The initial state of each output pin and thus the device being contr olled can also be set using the Nokia 30 Conf igurator. See Figure 2 for a view of the Nokia 30 Conf igurator for setting initial output states. Figure 2 Setti ng initial output values with t he Nokia 30 Configurat or.
8/18 4.3 SMS CENTER NUMBER SMS Cen tre Nu mber must b e set . I f it i s no t set, th e serv ice i s in o ff mo de . The SM S Ce ntre number can be set with the Nokia 30 Configurator software by opening m enu option GSM Settings -> Advanced -> Short messages (see Figure 3): Figure 3 Setting SM S centre number wit h the Nokia 30 Configurator Note that it is recommen ded that the ter minal sho uld be sw itched off and on ev ery ti me parameters are changed. 4.4 CONNECTING A DEVICE OR A MACHINE A dev ice to be co ntrol led w ith the Use cont rol mo de o f the No kia 30 i s con necte d phy sical ly to it t hrough the M2M System Connector. The general- purpose inputs and outputs of the M2M System Connector described in Chapter 5 are connected to the device. For more information about how to connect a device electrically to t he Nokia 30, please see reference 3. For information about the mechanical characteristics and r ecommended connector types for the M2M System Connector, please see Reference 1.
9/18 5. INPUT/O UTPUT PIN DESCRI PTIONS The Nokia 30 G SM Connectivity Terminal has the f ollowing input and output pins that can be control led u sin g the serv ice s of th e U ser C ont rol mode (see Table 1) : Table 1 Nokia 30 GSM Connect ivity Terminal inputs and outputs and avail able modes Name A nalog / Digital R/W Pin Numbe r (*) Input 1 Analog / D igita l R 31 Input 2 Analog / D igita l R 33 Input 3 Analog / D igita l R 36 Output 1 Digita l R/W 37 Output 2 Digita l R/W 39 Output 3 Digita l R/W 40 Output 4 Digita l R/W 42 Output 5 Digita l R/W 43 Suppl y Pwr Analog R/W 11 (*) Pin num ber on M2M S ystem Connector
10/18 6. COMM AND SYNT A X The command syntax v aries 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=Termin al Na me, Y=C omman d. E.g. Nokia30 Output_Set All On Command with a Pass word: X Y Z X=Terminal Name, Y=Password, Z=Command E.g. Nokia30 password Output_Set All On
11/18 7. COMM AND TEMPL A TES 7.1 COMMAND LIST The Nokia 30 G SM Connectivity Terminal supports t he following te xt message templates as commands and they are not case sensit ive (see Table 2). Table 2 Nokia 30 GSM Connect ivity Terminal User cont rol mode command list Command Description Change_P word Change pas sword Input_Get All Return states of all inputs Input_Get 1 Return a s tate of in put 1 Input_Get 2 Return a s tate of in put 2 Input_Get 3 Return a s tate of in put 3 Input_Get_ Change All Subscrib e a inp ut stat e change of all inputs Input_Get_ Change 1 Subscrib e a sta te chang e of in put 1 Input_Get_ Change 2 Subscrib e a sta te chang e of in put 2 Input_Get_ Change 3 Subscrib e a sta te chang e of in put 3 Output_G et All Return a state of al l outputs Output_G et 1 Return a state of outp ut 1. Output_G et 2 Return a state of outp ut 2 Output_G et 3 Return a state of outp ut 3 Output_G et 4 Return a state of outp ut 4 Output_G et 5 Return a state of outp ut 5 Output_Se t 1 On Set output 1 ON Output_Se t 1 Off Set output 1 OFF Output_Se t 2 On Set output 2 ON Output_Se t 2 Off Set output 2 OFF Output_Se t 3 On Set output 3 ON Output_Se t 3 Off Set output 3 OFF Output_Se t 4 On Set output 4 ON Output_Se t 4 Off Set output 4 OFF Output_Se t 5 On Set output 5 ON Output_Se t 5 Off Set output 5 OFF
12/18 Output_Se t All On Set all ou tputs ON Output_Se t All Of f Set all ou tputs OF F Su pply _Pwr_ Get Return a state of supp ly power Su pply _Pwr On Set supply pow er ON Su pply _Pwr OFF Set supply power OFF 7.2 DETAILED COMMAND INFORMATION AND RESPONSE S Note that all example commands use the Nokia 30 identifier string and the password property i s set off i n all followi ng chapters. Note: If a command string is not identified but t he Identifier and the opt ional Password are ok, the term inal will send a following response to the comm and originator: E.g. Nokia30 passWORD ResetAll -> ERROR (Unknown Command) 7.2.1 Change_Pword The Change_Pword command is used to control password propert y (see Table 3). Table 3 Command templates for the password Comm and type Comm and tem plate Comm ents Changing Passw ord Nokia30 pas sWORD Ch ange_PW ord w ordP ASS OK R esponse : CHANGE_PWORD: OK Fail Respon se: CH ANGE_PWORD: F AILED (In valid new passw ord) The ex ample changes t he password f rom âÂÂpassW ORDâ to âÂÂwo rdPASS â Activat ing Pass word Propert y Nokia30 Chan ge_PW ord w ordP ASS OK R esponse : CHANGE_PWORD: OK Fail Respon se: CH ANGE_PWORD: F AILED (In valid new passw ord) The ex ample changes an empt y password to âÂÂwo rdPASS â Deactivat ing Passwor d Proper ty Nokia30 w ordP ASS Chang e_PWord OK R esponse : CHANGE_PWORD: OK Fail Respon se: CH ANGE_PWORD: F AILED (In valid new passw ord) The ex ample changes t he password f rom âÂÂwordPAS Sâ to a n empt y
13/18 7.2.2 Reading Inputs The Inpu t_Ge t 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 T able 4). Table 4 The Input_Get X commands Comm and type Comm and tem plate Comm ents Input_Get All Nokia30 Input _Get All Response: IN PU T_G ET A LL: O K INPUT 1: X INPUT 2: X INPUT3: X The X var ies accor ding to the inpu t pin s tate and it can be: ON or OFF if the input is in dig ital m ode xxxx mV if the input is in a nalog m ode (xxxx=value between 0-5400). The comm and r eads all inputs and t he response r eturns the state of thos e according to inp ut pin conf igurat ion Input_Get Z , Z = 1,2 or 3 Nokia30 Input _Get Z Response: IN PU T_GE T Z : X The X var ies accor ding to the inpu t pin s tate and it can be: ON or OFF if the input is in dig ital m ode xxxx mV if the input is in a nalog m ode (xxxx=value between 0-5400). The comm and r eads input Z (Z = 1,2 or 3) and the res ponse returns the state of it according to inp ut pin conf igurat ion 7.2.3 Subscribing Input Events The I nput_Get_Change X commands are used for subscribing input state changes (see Table 5). A subscription will cause a sending of one event per input s tate change to t he subscriber phone number. The user can subscribe events of all input state changes at once or each input can be subscribed separately. Note that an input has to be configured properly in ord er to get eve nts w ith thi s se rvi ce. An input can be conf igured in two ways to operate with event sending: ç Digital input ç Analog input Alarming Input High Limit Input Low Limit Input Per iod When the Input mode is set to digital, an event is sent when the state of th e digital input changes from 0 -> 1 or 1 -> 0.
14/18 When the Input mode is set to analo g alarmin g, an event is sent i f the value is equal or exceeds the high lim it or is equal or get s 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 select ing menu option Remote I/O Control -> G eneral (see Figure 4). Figure 4. Input c onfiguration for receiving events
15/18 Table 5 Input_Get_Change commands for alarm functionality Comm and type Comm and tem plate Comm ents Input_Get_ Change All Nokia30 Input _Get_Chan ge All Response: IN PU T_GE T_C HA NG E A LL: INPUT 1: X INPUT 2: X INPUT 3: X The X ref ers to s uccess state and i t can be: OK or CHECK CONFIG . Event data , when input s tate has c hanged, c ontains the follo wing inf orm ation: INPUT 1: Y INPUT 2: Y INPUT 3: Y The Y varies accor ding to the inpu t pin s tate and it can be: ON or OFF if the input is in dig ital m ode xxxx mV if the input is in a nalog m ode (xxxx=value between 0-5400). The comm and subscr ibes events for all i nputs at o nce and the res ponse returns the state of those accor ding to input p in configur ation Input_Get_ Change Z , Z = 1,2 or 3 Nokia30 Input _Get_Chan ge Z Response: IN PU T_GE T_C HA NG E Z: INPUT Z: X The X ref ers to s uccess state and i t can be: OK or CHECK CONFIG . Event data , when input s tate has c hanged, c ontains the follo wing inf orm ation: INPUT Z: Y The Y varies accor ding to the inpu t pin s tate and it can be: ON or OFF if the input is in dig ital m ode xxxx mV if the input is in a nalog m ode (xxxx=value between 0-5400). The comm and subscr ibes the e vent for input Z (Z = 1, 2 or 3) and th e response r eturns the state of it acc ording to input pi n configur ation
16/18 7.2.4 Reading Outputs The Output_Get X commands are used to read digital output states. Note that password property i s set off i n follo wing example co mmands (see Table 6). Table 6 Output_Get X commands Comm and type Comm and tem plate Comm ents Output_G et All Nokia30 Out put_Get All Response: OUTPUT_GET ALL: OK OUTPUT 1: X OUTPUT 2: X OUTPUT 3: X OUTPUT 4: X OUTPUT 5: X The X ref ers to eit her ON or OFF. The comm and r eads all out puts and the res ponse ret urns th e state of thos e Output_G et Z , Z = 1,2,3,4 or 5 Nokia30 Out put_Get Z Response: OUTPUT_GET Z: X The X ref ers to eit her ON or OFF. The comm and r eads output Z (Z = 1,2,3, 4 or 5) and the r espons e returns the state of it 7.2.5 Writing Outputs The Output_S et X commands ar e used to write digit al output states. Note that password property i s set off i n follo wing example co mmands (see Table 7).
17/18 Table 7 Output_Set X commands Comm and type Comm and tem plate Comm ents Output_Se t Z On , Z = 1,2,3,4 or 5 Nokia30 Out put_Set Z On Response e.g. when Z = 1: OUTPUT _SET Z ON: OUTPUT 1: ON OUTPUT 2: X OUTPUT 3: X OUTPUT 4: X OUTPUT 5: X , The X ref ers to eith er ON or OFF . The comm and s ets output Z (Z = 1,2,3,4 or 5) to ON state and the response r eturns the state of al l outputs Output_Se t Z Off , Z = 1,2,3,4 or 5 Nokia30 Out put_Set Z Of f Response e.g. when Z = 1: OUTPUT _SET 1 O FF: OUTPUT 1: OFF OUTPUT 2: X OUTPUT 3: X OUTPUT 4: X OUTPUT 5: X , The X ref ers to eith er ON or OFF . The comm and s ets output Z (Z = 1,2,3,4 or 5) to OFF state an d the response r eturns the state of al l outputs Output_Se t All On Nokia30 Out put_Set All On Response: OUTPUT_SET ALL ON: OUTPUT 1: ON OUTPUT 2: ON OUTPUT 3: ON OUTPUT 4: ON OUTPUT 5: ON The c ommand s ets all outputs to ON st ate and the respons e retur ns the state of all outp uts Output_Se t All Of f Nokia30 Out put_Set All Off Response: OUTPUT_SET ALL OFF: OUTPUT 1: OFF OUTPUT 2: OFF OUTPUT 3: OFF OUTPUT 4: OFF OUTPUT 5: OFF The c ommand s ets all outputs to OFF state and the res ponse returns the state of all outputs
18/18 7.2.6 Controlling Power supply to the device Power output can be used to supply power t hrough the Nokia 30 t o the application. T he Supply_Pwr commands are used t o read/write power supply line states (see T able 8). Table 8 Supply_Pwr commands Comm and type Comm and tem plate Comm ents Su pply _Pwr_ Get Nokia30 Supp ly_ Pwr_G et Response: SUPPLY _PWR _GET : X The X ref ers to eit her ON or OFF. The comm and r eads the po wer suppl y line stat e and th e res ponse returns the state of it Su pply _Pwr On Nokia30 Supp ly_ Pwr On Response: SUPPLY_PWR O N: OK The comm and s ets the po wer suppl y line to ON state an d a response r eturns the conf irm ation of it Su pply _Pwr Off Nokia30 Supp ly_ Pwr Of f Response: SUPPLY_P WR OFF: OK The comm and s ets the po wer suppl y line to OFF state and a response r eturns the conf irm ation of it