nokia 12 gsm module - hmangas.com 12/docs_nokia… · gprs always online ... this document...

C

opyr

ight

© 2

004

Nok

ia. A

ll rig

hts

rese

rved

. I

ssue

1.0

923

1721

NOKIA 12 GSM MODULE

PROPERTIES REFERENCE GUIDE

Contents

ACRONYMS AND TERMS ......................................................................................................1 1. ABOUT THIS DOCUMENT ..............................................................................................3 2. COMMON PROPERTIES.................................................................................................5

2.1. PARAMETERS ..........................................................................................................5 2.1.1. Activity status .......................................................................................................5 2.1.2. Lock status ...........................................................................................................5 2.1.3. Power class ..........................................................................................................6 2.1.4. Auto PIN ...............................................................................................................7 2.1.5. M2M System Protocol properties .........................................................................7 2.1.6. RS-232 mode .......................................................................................................8 2.1.7. RS-232 port mode list.........................................................................................10 2.1.8. Time ...................................................................................................................10 2.1.9. Date....................................................................................................................11

2.2. EVENTS...................................................................................................................12 3. NETWORK RELATED PROPERTIES ...........................................................................13

3.1. PARAMETERS ........................................................................................................13 3.1.1. Network registration ...........................................................................................13 3.1.2. Operator selection ..............................................................................................14 3.1.3. Operator list........................................................................................................14 3.1.4. Signal quality ......................................................................................................15

3.2. EVENTS...................................................................................................................15 4. SUPPLEMENTARY SERVICE PROPERTIES...............................................................17

4.1. PARAMETERS ........................................................................................................17 4.1.1. Calling line identification presentation network status........................................17 4.1.2. Calling line identification restriction ....................................................................17 4.1.3. Calling line identification restriction network status ............................................18 4.1.4. Connected line identification presentation network status .................................18 4.1.5. Connected line identification restriction network status......................................19 4.1.6. Call waiting .........................................................................................................19

4.2. EVENTS...................................................................................................................20

5. SHORT MESSAGE PROPERTIES................................................................................24 5.1. PARAMETERS ........................................................................................................24

5.1.1. Remove oldest message....................................................................................24 5.1.2. Service center address.......................................................................................24 5.1.3. Message delivery reports ...................................................................................24 5.1.4. Message validity period......................................................................................25 5.1.5. Message reply path ............................................................................................25

5.2. EVENTS...................................................................................................................25 6. CALL RELATED PROPERTIES.....................................................................................27

6.1. PARAMETERS ........................................................................................................27 6.1.1. Current calls list..................................................................................................27 6.1.2. Auto answer .......................................................................................................28

6.2. EVENTS...................................................................................................................29 6.3. COUNTERS.............................................................................................................32

7. WIRELESS BEARERS PROPERTIES...........................................................................34 7.1. PARAMETERS ........................................................................................................34

7.1.1. WAP parameters ................................................................................................34 7.1.2. Wireless bearer information USSD ....................................................................35 7.1.3. Wireless bearer information SMS.......................................................................37 7.1.4. Wireless bearer information CSD.......................................................................37 7.1.5. Wireless bearer information GPRS ....................................................................38 7.1.6. GPRS always online...........................................................................................39 7.1.7. Default connection..............................................................................................39 7.1.8. Authentication.....................................................................................................40

8. AUDIO PROPERTIES....................................................................................................41 8.1. PARAMETERS ........................................................................................................41

8.1.1. Audio parameters ...............................................................................................41 9. USER CONTROL MODE PROPERTIES.......................................................................42

9.1. PARAMETERS ........................................................................................................42 9.1.1. Message identifier ..............................................................................................42 9.1.2. Password............................................................................................................42 9.1.3. Authorized phone number ..................................................................................42 9.1.4. Authorized phone number list.............................................................................43 9.1.5. Alias list ..............................................................................................................43

9.1.6. Alarm mode ........................................................................................................44 9.1.7. Response messages..........................................................................................44

10. PPP PROPERTIES ........................................................................................................46 10.1. PARAMETERS ........................................................................................................46

10.1.1. PPP negotiation IP address ...............................................................................46 11. HLA PROPERTIES ........................................................................................................47

11.1. PARAMETERS ........................................................................................................47 11.1.1. HLA Information .................................................................................................47

12. GPS PROPERTIES........................................................................................................48 12.1. PARAMETERS ........................................................................................................48

12.1.1. GPS information .................................................................................................48 13. MODULE ORB PROPERTIES .......................................................................................49

13.1. PARAMETERS ........................................................................................................49 13.1.1. Module ORB mode.............................................................................................49 13.1.2. Module ORB port................................................................................................49

14. HTTP PROPERTIES......................................................................................................51 14.1. PARAMETERS ........................................................................................................51

14.1.1. HTTP bearer information CSD ...........................................................................51 14.1.2. HTTP bearer information GPRS.........................................................................52 14.1.3. HTTP proxy information .....................................................................................52 14.1.4. HTTP information ...............................................................................................53

Legal Notice

Copyright © 2004 Nokia. 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. Java and all Java-based marks are trademarks or registered trademarks of Sun Microsystems. Other product and company names mentioned herein may be trademarks or trade names of their respective owners.

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.

The contents of this document are provided "as is". Except as required by applicable law, no warranties of any kind, either express or implied, including, but not limited to, the implied warranties of merchantability and fitness for a particular purpose, are made in relation to the accuracy, reliability or contents of this document. Nokia reserves the right to revise this document or withdraw it at any time without prior notice.

ACRONYMS AND TERMS

Acronym/term Description

AM Application Module

AT ATtention

BPS Bits per second

CHAP Challenge Handshake Authentication Protocol

CORBA Common Object Request Broker Architecture

CSD Circuit Switched Data

CLI Calling Line Identification

CLIP Calling Line Identification Presentation

CLIR Calling Line Identification Restriction

COL Connected Line Identity

COLP Connected Line Identification Presentation

COLR Connected Line Identification Restriction

CUG Closed User Group

DAI Digital Audio Interface

FAX Facsimile transmission

GGA Global Positioning System Fix Data

GLL Geographic Position – Latitude/Longitude

GPRS General Radio Packet Service

GPS Global Positioning System

GSM Global System for Mobile, Global Standard for Mobile

HLA Home Location Agent

HSCSD High Speed Circuit Switched Data

IDL Interface Definition Language

IIOP Internet Inter-ORB Protocol

I/O Input/Output

IOR Interoperable Object Reference

IP Internet Protocol

ISDN Integrated Services Digital Network

M2M Machine-to-machine, Man-to-machine, Machine-to-man

1/53

Acronym/term Description

NMEA National Marine Electronics Association

PDP Packet Data Protocol

PIN Personal Identification Number

PPP Point-to-Point Protocol

PUK Personal Unblocking Key

RMC Recommended minimum specific GPS/transit data

RSSI Received Signal Strength Indicator

SIM Subscriber Identity Module

SMS Short Message Service

SMSC Short Message Service Centre

USSD Unstructured Supplementary Services Data

USSDC Unstructured Supplementary Services Data Centre

VTG Course Over Ground and Ground Speed

WAP Wireless Access Protocol

WTP Wireless Transaction Protocol

2/53

1. ABOUT THIS DOCUMENT

This document describes the Nokia 12 GSM module (hereafter Nokia 12 module) parameters, events, and counters.

The application (which may be a JavaTM IMlet running in a Nokia 12 module or a server application communicating with the Nokia 12 module wirelessly) can read and/or modify the parameters, events, and counters. The parameters and events are formally defined in the Properties interface definition (in a properties.idl file included in the Nokia 12 SDK)

The Properties interface definition does not contain any methods for getting or setting parameters, events, or counters. Instead, they are used with methods (such as getParam and setParam) that are generated from the Wireless Device interface definition. For more information, see the Nokia 12 Module Interface Definition Reference Guide.

The parameters of the Nokia 12 module are used, for example, for operator selection, wireless connection settings and for viewing time and date settings. This document describes the purpose and possible values of each parameter. The parameter name with which each parameter is to be called in CORBA method calls is mentioned in the beginning of each chapter. The document also lists the existing default parameter values. Some of the parameters include more than one member and these members are described in the parameter tables. Some of the parameters are read-only, some can be both read and modified. If a parameter is read-only, it is mentioned separately.

Note: Some parameters require that the Nokia 12 module is restarted before the value changes become valid. The reset can be initiated with the Reset method call. For more information on the Reset method call, see the Nokia 12 Module Interface Definition Reference Guide.

If a parameter belongs to a data structure together with other parameters, it is not possible to modify one of the parameters separately. Instead, all the parameters in a data structure must be initialized before the data structure is set to the Nokia module. In case you want to modify only one parameter, you can first get all the parameters of a data structure from the Nokia 12 module, then modify the desired parameter to the data structure, and then set the complete data structure.

Note: Some of the parameters can also be set with the Nokia 12 Configurator (hereafter Configurator). The Configurator can be downloaded free of charge from www.forum.nokia.com/m2m or www.americas.forum.nokia.com/m2m.

The Nokia 12 module uses events to notify an application about, for example, a necessary task (for example, enter PIN code). To be able to receive events, the

3/53

http://www.forum.nokia.com/

http://www.americas.forum.nokia.com/m2mm

application must have an observer, which is registered in the Nokia 12 module to listen to some event. All events are read-only.

Similarly to observing events, a change in parameters can also be observed using a parameter observer. Unlike events, parameters can also be read at any time. If an event has occurred and no observer has been set to listen to that event, it cannot be read any more. However, some events change the state of some parameters and thus the outcome of the event is readable afterwards by reading the corresponding parameter. For example, the events SERV-ON and SERV-OFF change the state of the ActivityStatus parameter.

The counters include data collected by the Nokia 12 module. This document lists the minimum and maximum values for each counter (a counter stops when it reaches its maximum value). The counters can only be read.

All the referenced documents can be found in Forum Nokia web pages at www.forum.nokia.com/m2m or www.americas.forum.nokia.com/m2m.

4/53

http://www.forum.nokia.com/

http://www.americas.forum.nokia.com/m2mm

2. COMMON PROPERTIES

2.1. PARAMETERS

2.1.1. Activity status The parameter name to be called in a CORBA method call: ActivityStatus.

Possible values Notes ACTIVITY_STATUS_READY,

ACTIVITY_STATUS_RINGING,

ACTIVITY_STATUS_CALL_IN_PROGRESS,

ACTIVITY_STATUS_UNAVAILABLE

Activity status that indicates the current call state of the Nokia 12 module.

Read-only

Defined values:

ACTIVITY_STATUS_READY The Nokia 12 module is in service.

ACTIVITY_STATUS_RINGING There is an incoming voice / data call.

ACTIVITY_STATUS_CALL_IN_PROGRESS Voice/data call in progress. ACTIVITY_STATUS_UNAVAILABLE The Nokia 12 module is not in

service.

Note: When READY is given as a value for ActivityStatus, the Nokia 12 module may still be locked. For more information, see the LockStatus parameter.

2.1.2. Lock status The parameter name to be called in a CORBA method call: LockStatus.

Possible values Notes LOCK_STATUS_PIN_REQUIRED,

LOCK_STATUS_PIN2_REQUIRED,

LOCK_STATUS_PUK_REQUIRED,

LOCK_STATUS_PUK2_REQUIRED,

Indicates security code locking status.

Read-only

5/53

Possible values Notes LOCK_STATUS_SECURITYCODE_REQUIRED,

LOCK_STATUS_NO_CODE_REQUIRED,

LOCK_STATUS_NO_SIM,

LOCK_STATUS_SIM_NOT_READY

Defined values:

LOCK_STATUS_PIN_REQUIRED Personal Identification Number (PIN) code required.

LOCK_STATUS_PIN2_REQUIRED PIN2 code required. LOCK_STATUS_PUK_REQUIRED Personal Unblocking Key (PUK)

code required. LOCK_STATUS_PUK2_REQUIRED PUK2 code required. LOCK_STATUS_SECURITYCODE_REQUIRED Security code required. LOCK_STATUS_NO_CODE_REQUIRED No code required. LOCK_STATUS_NO_SIM No SIM card exists. LOCK_STATUS_SIM_NOT_READY SIM is not ready.

Note: A PIN code can be inserted by using, for example, the setSecurityCode method call. Please see Nokia 12 GSM Module Interface Definition Reference Guide for more information.

2.1.3. Power class The parameter name to be called in a CORBA method call: PowerClass.

A PowerClass contains a sequence of PowerClassElement structs, which in turn contain a pair of band and usedClass members.

Members Possible values Notes

band POWER_CLASS_GSM900,

POWER_CLASS_GSM1800,

POWER_CLASS_GSM1900,

POWER_CLASS_GSM850

Indicates the supported frequency band of the Nokia 12 module.

Read-only

usedClass 1 - 5 Indicates the maximum power used for a GSM connection. Indicated as a

6/53

Members Possible values Notes power class for each of the frequency bands.

Read-only

2.1.4. Auto PIN The parameter name to be called in a CORBA method call: AutoPIN.

Possible values Notes Default value True, False Indicates AutoPIN

activity status. False

When the AutoPIN parameter value is true, the PIN code is programmed in the memory of the Nokia 12 module the first time it is queried. In case something unexpected happens (for example a power failure), the PIN code is automatically relayed in the memory of the Nokia 12 module. When the AutoPIN is in use, the PIN code request on the SIM card can be enabled to maximize protection.

2.1.5. M2M System Protocol properties The parameter name to be called in a CORBA method call: MAP27Parameters.

A MAP27Parameters structure contains the N1, N3, and T3 members together with a baudrate enumeration.

Members Possible values Notes Default value

N1 0 - 255 N1 parameter stands for the maximum length parameter of LT packet, max length = 16*(N1 + 1).

Do not change the default value.

255

N3 0 - 255 N3 stands for the maximum number of activity timer timeouts (must be at least 2).

Do not change

10

7/53

Members Possible values Notes Default value the default value.

T3 0 - 255 Activity timer, maximum value 15.

Do not change the default value.

10

baudrate MAP27_BAUD_RATE_BPS_9600,

MAP27_BAUD_RATE_BPS_19200,



MAP27_BAUD_RATE_BPS_115200

- MAP27_BAUD_RATE_BPS_9600

For more detailed information about M2M System Protocol, see the Nokia M2M System Protocol 2 Specification.

Note: If the Configurator is used, it is strongly recommended not to change the default parameter values of N1, N3 and T3. Otherwise the connection between the Nokia 12 module and the Configurator might be lost.

2.1.6. RS-232 mode The parameter name to be called in a CORBA method call: RS232Mode.

Note: With the Nokia 12 module the RS232 port settings must be get or set through the RS232PortModeList parameter. The RS232Mode parameter is get or set also for Nokia 12 module, but since it has several configurable ports, the RS232Mode parameter must be given for each port separately.

Possible values Notes Default value

AUTO,

AT,

PHONET,

SYSTEM_PROTOCOL,

Sets the protocol used in the RS-232 port at the Nokia 12 module start-up.

For Nokia 12 module the default value for port 1 is AUTO and for port 3 the default value is JAVA.

8/53


GPS,

JAVA

The M2M System Connector of the Nokia 12 module has three serial ports, of which port 1 and port 3 are configurable. The port-specific protocols are set simultaneously for each port by using the RS232PortModeList parameter.

Note: Port 2 of the Nokia 12 module always uses the M2M System Protocol. If the M2M System Protocol is directed to some other port, then port 2 is disabled. It is recommended that port 2 is used for the M2M System Protocol when the Nokia 12 module is used.

Note: There are restrictions on port modes in the Nokia 12 module. For more information on the M2M System Connector and the port modes available, please see the Nokia 12 GSM Module Hardware Integration Manual.

Defined values:

AUTO When the parameter value is set to AUTO, the RS-232 mode is selected automatically according to the connected ID resistor.

AT When the parameter value is set to AT, the communication protocol of the port is AT commands and the Nokia 12 module can be used, for example, as a modem. Functionality is the same as with value AUTO with ID resistor connected.

PHONET When the parameter value is set to PHONET, the pins of the port are reserved for I/O usage.

SYSTEM_PROTOCOL When the parameter value is set to SYSTEM_PROTOCOL, the communication protocol of the port is set to M2M System Protocol (version 2 for Nokia 12 module).

GPS When the parameter value is set to GPS, the communication protocol is NMEA 0183.

JAVA When the parameter value is set to JAVA, the port is reserved for asynchronous serial communication (for an IMlet running inside the Nokia 12 module).

9/53

2.1.7. RS-232 port mode list The parameter name to be called in a CORBA method call: RS232PortModeList.

Note: With the Nokia 12 module the RS232PortModeList parameter must be used when getting or setting the RS-232 port mode.

An RS232PortModeList contains a sequence of RS232ModeInformation structures. The table below describes the contents of a RS232ModeInformation structure, which contains a port number identifying the port and mode member.


port 1-3 Number identifying the port.

-

mode AUTO,

AT,

PHONET,

SYSTEM_PROTOCOL,

GPS,

JAVA

See the RS-232 mode parameter.

Port 1: AUTO

Port 2: SYSTEM_PROTOCOL

Port 3: JAVA

2.1.8. Time The parameter name to be called in a CORBA method call: Time.

The Nokia 12 module retrieves the time values automatically from the GSM network using Network Indication and Time Zone (NITZ) network service, if it is available. The values are stored in the parameters mentioned below.

Note: If the NITZ service is not available in the network, the clock starts running from the default value every time the Nokia 12 module is restarted.

Members Possible values

Notes Default value

hours 0 … 23 Read-only -

minutes 0 … 59 Read-only -

seconds 0 … 59 Read-only -

10/53


Notes Default value

localTimeZone -127 - +128 Local time zone Example1: In Alaska TZ is -9. The Nokia 12 module returns TZ: -36.

(15min * 36 = 540 min, --> 540 / 60 = 9h)

Example 2: In Finland TZ is +2. The Nokia 12 module returns TZ: 8.

(15min * 8 =120min --> 120 / 60 = 2h

Signed magnitude representation, the highest bit tells the negativeness.

Read-only

-

2.1.9. Date The parameter name to be called in a CORBA method call: Date.

The Nokia 12 module retrieves the date values automatically from the GSM network using NITZ network service, if it is available. The values are stored in the parameters mentioned below.

Note: If the NITZ service is not available in the network, the clock starts running from the default value every time the Nokia 12 module is restarted.


year 2001 … 2099 Read-only

month 1 … 12 Read-only

day 1 … 31 Read-only

11/53

2.2. EVENTS The table below lists the events related to the parameters described in Chapter 2.1.

Event Notes SECURITYCODE_ACCEPTED One of the following security codes has been

accepted: PIN

PIN2

PUK

PUK2

SECURITYCODE

CALLBARRINGCODE

SECURITYCODE_REQUIRED One of the following security codes is required: PIN

PIN2

PUK

PUK2

SECURITYCODE

CALLBARRINGCODE

12/53

3. NETWORK RELATED PROPERTIES

3.1. PARAMETERS

3.1.1. Network registration The parameter name to be called in a CORBA method call: NetworkRegistration.


status NETWORK_REGISTRATION_NOT_REGISTERED_NOT_SEARCHING,

NETWORK_REGISTRATION_REGISTERED_HOME,

NETWORK_REGISTRATION_NOT_REGISTERED_SEARCHING,

NETWORK_REGISTRATION_DENIED,

NETWORK_REGISTRATION_UNKNOWN,

NETWORK_REGISTRATION_ROAMING

Read-only

areaCode (unsigned short) Two-byte location area code.

Read-only

cellID (unsigned short) Two-byte cell ID.

Read-only

The location area code and cell ID are returned only if registration is enabled and the mobile equipment is registered to the network. Please contact your service provider for registration.

Defined values:

NETWORK_REGISTRATION_NOT_REGISTERED_NOT_SEARCHING

Not searching new operator to register to.

NETWORK_REGISTRATION_REGISTERED_HOME Registered to home network. NETWORK_REGISTRATION_NOT_REGISTERED_SEARCHING

Searching a new operator to register to.

NETWORK_REGISTRATION_DENIED Registration to the network is denied.

NETWORK_REGISTRATION_UNKNOWN For example, no network.

13/53

NETWORK_REGISTRATION_ROAMING Registration to the network abroad.

3.1.2. Operator selection The parameter name to be called in a CORBA method call: OperatorSelection.


automatic True/False If the value of the member is True, then the operator is selected automatically. If the value is False, then the operator to be selected must be given as the areaNumber member.

True

areaNumber (unsigned long)

Numeric representation of the operator.

The operator number (GSM location area identification number) can be selected from the list of available operators. It is a 5-digit code, 3 digits for the country code and 2 digits for the network code. In USA network code is 3 digits (in 1900 networks).

-

To get a list of available operators, use the OperatorList parameter.

3.1.3. Operator list The parameter name to be called in a CORBA method call: OperatorList.

The OperatorList parameter contains a sequence of Operator structs, each of which contains the members of the table below.


areaNumber (unsigned long) Numeric representation of the operator.

The operator number (GSM location area identification number) can

14/53

Members Possible values Notes be selected from the list of available operators. It is a 5-digit code, 3 digits for the country code and 2 digits for the network code. In USA network code is 3 digits (in 1900 networks).

Read-only

name (string) Read-only

status OPERATOR_STATUS_UNKNOWN,

OPERATOR_STATUS_AVAILABLE,

OPERATOR_STATUS_CURRENT,

OPERATOR_STATUS_FORBIDDEN

Read-only

priority OPERATOR_PRIORITY_HOME_NETWORK,

OPERATOR_PRIORITY_REFERENCED_IN_SIM,

OPERATOR_PRIORITY_OTHER_NETWORKS

Read-only

3.1.4. Signal quality The parameter name to be called in a CORBA method call: SignalQuality.

Possible values Notes -101 dBm or less -> Unacceptable coverage

-100 dBm ... -91 dBm -> Weak coverage

-90 dBm ... -81 dBm -> Moderate coverage

-80 dBm or greater -> Good coverage

0 -> Not known or not detectable

Returns received signal strength indication (RSSI) in dBm.

Read-only


15/53

POWER_ON The power of the Nokia 12 module has been switched on.

SERV_ON The Nokia 12 module has registered to the GSM network.

SERV_OFF The Nokia 12 module has unregistered from the GSM network.

ROAM_ON The Nokia 12 module enters the roaming state.

ROAM_OFF The Nokia 12 module exits from the roaming state.

GPRS_OPENED Packet Data Protocol (PDP) context has been opened.

GPRS_CLOSED PDP context has been closed.

GPRS_SUSPENDED PDP context has been suspended.

GPRS_RESUMED PDP context is resumed.

16/53

4. SUPPLEMENTARY SERVICE PROPERTIES

4.1. PARAMETERS

4.1.1. Calling line identification presentation network status The parameter name to be called in a CORBA method call: CallingLineIdentificationPresentationNetworkStatus.


CLIP_PROVISIONED,

CLIP_NOT_PROVISIONED,

CLIP_UNKNOWN

Subscriber CLIP service status in the network.

Read-only

CLIP_PROVISIONED

Refers to the CLIP service that allows the called party to receive the phone number of the calling party.

Defined values:

CLIP_PROVISIONED Presentation of the calling number available. CLIP_NOT_PROVISIONED Presentation of the calling number not available. CLIP_UNKNOWN Calling number unknown.

4.1.2. Calling line identification restriction The parameter name to be called in a CORBA method call: CallingLineIdentificationRestriction.


CLIR_NO_SUBSCRIPTION,

CLIR_INVOCATION,

CLIR_SUPPRESSION

- CLIR_NO_SUBSCRIPTION

Refers to the CLIR service that allows a calling subscriber to enable or disable the presentation of the phone number to the called party when originating a call (CLIR adjustment for outgoing calls).

Defined values:

17/53

CLIR_NO_SUBSCRIPTION According to the subscription of the CLIR service. CLIR_INVOCATION CLIR invocation. CLIR_SUPPRESSION CLIR suppression.

Normally the Calling Line Identification (CLI ) is shown to the called party if the number of the calling party is not secret.

4.1.3. Calling line identification restriction network status The parameter name to be called in a CORBA method call: CallingLineIdentificationRestrictionNetworkStatus.

Possible values Notes

CLIR_NOT_PROVISIONED,

CLIR_PROVISIONED,

CLIR_UNKNOWN,

CLIR_TEMPORARILY_RESTRICTED,

CLIR_TEMPORARILY_ALLOWED

Interrogates the provision status of the CLIR service (subscriber status in the network).

Read-only

Defined values:

CLIR_NOT_PROVISIONED Presentation of the number of the calling party is restricted.

CLIR_PROVISIONED Presentation of the number of the calling party is allowed.

CLIR_UNKNOWN For example, no network. CLIR_TEMPORARILY_RESTRICTED Presentation of the number of the calling

party restricted during the current phone call.

CLIR_TEMPORARILY_ALLOWED Presentation of the number of the calling party allowed during the current phone call.

4.1.4. Connected line identification presentation network status The parameter name to be called in a CORBA method call: ConnectedLineIdentificationPresentationNetworkStatus.


18/53


COLP_PROVISIONED,

COLP_NOT_PROVISIONED,

COLP_UNKNOWN

Subscriber COLP service status in the network.

Read only

The COLP service enables a calling subscriber to get the Connected Line Identity (COL) of the called party after setting up a mobile-originated call.

Defined values:

COLP_PROVISIONED Identification available. COLP_NOT_PROVISIONED Identification not available. COLP_UNKNOWN For example, no network.

4.1.5. Connected line identification restriction network status The parameter name to be called in a CORBA method call: ConnectedLineIdentificationRestrictionNetworkStatus.


COLR_PROVISIONED,

COLR_NOT_PROVISIONED,

COLR_UNKNOWN

Subscriber COLR service status in the network.

Read-only

COLR_PROVISIONED Restriction available. COLR_NOT_PROVISIONED Restriction not available. COLR_UNKNOWN For example, no network.

4.1.6. Call waiting The parameter name to be called in a CORBA method call: CallWaiting.

Possible values Notes Default value True/False Status of the call waiting for

supplementary service. False

19/53

Refers to the service that allows the application to monitor that there is a new incoming call when there is an ongoing call.


Event Notes Member Possible values Notes

operation USSD_OPERATION_NOTIFY,

USSD_OPERATION_REQUEST,

USSD_OPERATION_REPLY

-

data (sequence of octets) -

SS_USSD_RECEIVED

Unsolicited supplementary service data message has been received.

dcs

(octet) Data coding scheme ID.

operation SS_ACTIVATION

SS_DEACTIVATION

SS_REGISTRATION

SS_ERASURE

SS_INTERROGATION

SS_PASSWORD_REGISTRATION

SS_NO_RETURN_RESULT

-

SSCode (unsigned short) Supplementany service code (for example, 43 for call waiting service).

SS_REQUEST_COMPLETED

Supplementary service request has been completed.

userBasicService

(octet) Requested basic service (for example, 13 for voice).

20/53


info Possible members for info (see the Properties Interface Definition for detailed information about the contents of the members):

forwardList (List of forwarding numbers)

status (General status of service)

basicServiceList (List of basic services)

CLIRInfo (Status of CLIR service)

password (Password string)

-

SS_REQUEST_FAILED

Supplementary service request has been failed.

Member can be one of these:

passwordError

error

problem

MMError

deviceError

Possible values for passwordError: SS_ENTER_PASSWORD,

SS_ENTER_NEW_PASSWORD,

SS_ENTER_NEW_PASSWORD_AGAIN

Possible values for error: SS_UNKNOWN_SUBSCRIBER, SS_BEARER_SERV_NOT_PROVISION,

SS_TELE_SERV_NOT_PROVISION,

SS_CUG_REJECT,

SS_ILLEGAL_SS_OPERATION,

SS_SS_ERROR_STATUS,

SS_SS_NOT_AVAILABLE,

SS_SS_SUBSCRIPTION_VIOLATION,

SS_SS_INCOMPATIBILITY,

SS_SS_SPECIFIC_ERROR,

SS_SYSTEM_FAILURE,

-

21/53


SS_DATA_MISSING,

SS_UNEXPECTED_DATA_VALUE,

SS_PASSWORD_REGISTRATION_FAILURE,

SS_NEGATIVE_PASSWORD_CHECK,

SS_FACILITY_NOT_SUPPORTED,

SS_RESOURCES_NOT_AVAILABLE,

SS_MAXNUM_OF_MULTIPARTY_PARTICIPANTS_EXCEED,

SS_CALL_BARRED,

SS_MAXNUM_OF_PASSWORD_ATTEMPTS_VIOLATION,

SS_ABSENT_SUBSCRIBER,

SS_USSD_BUSY,

SS_UNKNOWN_ALPHABET

Possible members for problem (see the Properties Interface Definition for detailed information about the contents of the members):

generalCode,

invokeCode,

resultCode,

returnErrorCode

Possible values for MMError: (octet) entityID,

(octet) cause

Possible values for deviceError: SS_DEVICE_ERROR_PIN_REQUIRED,

SS_DEVICE_ERROR_PUK_R

22/53

Event Notes Member Possible values Notes EQUIRED,

SS_DEVICE_ERROR_SECURITY_CODE_REQUIRED,

SS_DEVICE_ERROR_NO_SIM

Defined values for SS_REQUEST_FAILED event:

passwordError Specifies which supplementary service password failed. error Specifies the error type (illegal operation, data missing,

resources not available etc.). problem Includes problem type -specific information (general,

invoke, return result or return error). MMError Entity ID and cause. deviceError Specifies which device password failed.

23/53

5. SHORT MESSAGE PROPERTIES

5.1. PARAMETERS

5.1.1. Remove oldest message The parameter name to be called in a CORBA method call: RemoveOldestMessage.

Possible values Notes Default value True/False - False

Removes the oldest short message if message storage (both SIM and the memory of the Nokia 12 module) is filled up. If the parameter value is True, then there is at least one empty memory location for storing a received SMS message.

5.1.2. Service center address The parameter name to be called in a CORBA method call: ServiceCentreAddress.


(string) - -

Indicates the Short Message Service Center (SMSC) address (phone number) in the SIM card, through which mobile-originated short messages are transmitted. Can be changed any time. Please contact your service provider for an SMSC address.

Note: If there is no SMSC address stored in the SIM card, the short messages cannot be sent or received.

5.1.3. Message delivery reports The parameter name to be called in a CORBA method call: MessageDeliveryReports.


24/53


The operator sends a delivery report for short messages when this option is set.

5.1.4. Message validity period The parameter name to be called in a CORBA method call: MessageValidityPeriod.


SMS_VALIDITY_PERIOD_1_HOUR,

SMS_VALIDITY_PERIOD_6_HOURS,



SMS_VALIDITY_PERIOD_1_WEEK,

SMS_VALIDITY_PERIOD_MAXIMUM

- SMS_VALIDITY_PERIOD_MAXIMUM (GSM standard maximum is 63 weeks).

Indicates how long a short message is stored in the network (a maximum attempt time to deliver a message).

5.1.5. Message reply path The parameter name to be called in a CORBA method call: MessageReplyPath.


If the value of the MessageReplyPath parameter is True, the short message is marked so that the recipient of the message is able to send the reply message through the same SMSC.


25/53

Event Notes Members Possible values

Notes

storage SMS_STORAGE_SIM,

SMS_STORAGE_PHONE

Informs where the short message is stored.

SMS_RECEIVED_STORED

Received short message has been stored.

location (long) Index of the received message.

content (string ) Short message text.

SMS_RECEIVED_TEXT New short message has been received. phoneNumber (string ) Sender’s

phone number.

SMS_DELIVER_SUCCEEDED

Short message delivery succeeded.

Includes reference to the short message.

(long) 0 - 255

-

SMS_DELIVER_FAILED Short message delivery failed.

Includes reference to the short message.

(long) 0 - 255

-

SMS_STORAGE_FULL

SMS storage is full. If the RemoveOldestShortMessage parameter is set to True, this event never happens.

- - -

SMS_STORAGE_AVAILABLE

Memory available again in SMS storage.

- - -

content (sequence of octets)

Short message content.

SMS_RECEIVED_UNRESOLVED

New unresolved short message has been received.

phoneNumber (string) Sender’s phone number.

26/53

6. CALL RELATED PROPERTIES

6.1. PARAMETERS

6.1.1. Current calls list The parameter name to be called in a CORBA method call: CurrentCallsList.


mobileOriginated True/False Indicates whether the call is mobile-originated or mobile-terminated.

Read-only

state CALL_STATE_ACTIVE,

CALL_STATE_HELD,

CALL_STATE_DIALLING,

CALL_STATE_ALERTING,

CALL_STATE_INCOMING,

CALL_STATE_WAITING

Read-only

service CALL_MODE_VOICE,

CALL_MODE_DATA,

CALL_MODE_FAX,

CALL_MODE_VOICE_FOLLOWED_BY_DATA,

CALL_MODE_ALT_VOICE_DATA,

CALL_MODE_ALT_VOICE_FAX,

CALL_MODE_ALT_DATA_DATA,

CALL_MODE_ALT_DATA_VOICE,

CALL_MODE_ALT_FAX_VOICE,

CALL_MODE_UNKNOWN

Indicates the type of the bearer/ teleservice.

Note! Nokia 12 module does not support CALL_MODE_ALT_VOICE_FAX.

Read-only

multiparty True/False Indicates whether the call is a multiparty (conference) call.

Read-only

phoneNumber (string ) max. 20 h

Indicates the lli t h

27/53

Members Possible values Notes characters calling party phone

number.

Read-only

id (long) Call identification number.

Read-only

Defined values:

CALL_STATE_ACTIVE Call is active. CALL_STATE_HELD Call is on hold. CALL_STATE_DIALLING Mobile-originated call dialling. CALL_STATE_ALERTING Mobile-originated call alerting. CALL_STATE_INCOMING Mobile-terminated call incoming. CALL_STATE_WAITING Mobile-terminated call waiting.

CALL_MODE_VOICE Voice call. CALL_MODE_DATA Data call. CALL_MODE_FAX Fax call. CALL_MODE_VOICE_FOLLOWED_BY_DATA Voice followed by data and voice

(reserved for future use). CALL_MODE_ALT_VOICE_DATA Alternating voice/data (reserved for

future use). CALL_MODE_ALT_VOICE_FAX Alternating voice/fax. Nokia 12

module does not support CALL_MODE_ALT_VOICE_FAX.

CALL_MODE_ALT_DATA_DATA Voice followed by data (reserved for future use).

CALL_MODE_ALT_DATA_VOICE Alternating, data mode (reserved for future use).

CALL_MODE_ALT_FAX_VOICE Alternating, fax mode. CALL_MODE_UNKNOWN Unknown call.

6.1.2. Auto answer The parameter name to be called in a CORBA method call: AutoAnswer.


28/53

Possible values Notes Default value True/False Automatic answer for incoming

calls. False


Event Notes Members Possible values Notes CALL_CREATION_SUCCEEDED

Call has been answered.

- (long) 0 - 255 -

CALL_CREATION_STARTED

Call creation has been started.

- (long) 0 - 255 -

CALL_REMOTE_ALERTING

Remote end is alerting.

- (long) 0 - 255 -

id (long) 0 - 255 - CALL_REMOTE_NUMBER

Remote end number where the call has been answered.

phoneNumber (string) -

id (long) 0 – 255 Call identification number.

CALL_SS_NOTIFICATION_HOLD,

CALL_SS_NOTIFICATION_RETRIEVED,

CALL_SS_NOTIFICATION_MULTIPARTY,

CALL_SS_NOTIFICATION_TRANSFERRED,

CALL_SS_NOTIFICATION_FORWARDED,

CALL_SS_NOTIFICATION

Call related supplementary service notifications. code

CALL_SS_NOTIFICATION_INCOMING_FORWARDED,

Result code

29/53

Event Notes Members Possible values Notes CALL_SS_NOTIFICATION_INCOMING_BARRED,

CALL_SS_NOTIFICATION_CLIR_REJECTED

id (long) 0 - 255 -

CALL_DISCONNECTING_REASON_NORMAL_CALL_CLEARING,

CALL_DISCONNECTING_REASON_USER_BUSY,

CALL_DISCONNECTING_REASON_NO_USER_RESPONDING,

CALL_DISCONNECTING_REASON_ALERTING_NO_RESPONSE,

CALL_DISCONNECTING_REASON_CALL_REJECETED,

CALL_DISCONNECTING_REASON_NUMBER_CHANGED,

CALL_DISCONNECTED

Remote end has disconnected the call.

reason

CALL_DISCONNECTING_REASON_UNSPECIFIED_REASON

-

CALL_DROPPED

Call is dropped.

- (long) 0 - 255 -

CALL_MODE_VOICE,

CALL_MODE_DATA,

CALL_MODE_FAX,

CALL_MODE_VOICE_FOLLOWED_BY_DATA,

CALL_COMING Mobile-terminated call is alerting

mode

CALL_MODE_ALT_VOICE_DATA,


30/53

Event Notes Members Possible values Notes CALL_MODE_ALT_VOICE_FAX,

CALL_MODE_ALT_DATA_VOICE,

CALL_MODE_ALT_FAX_VOICE,

CALL_MODE_UNKNOWN

phoneNumber (string) Calling party phone number.

id (long) 0 - 255 Call identification number.

diverted True/False Call has or has not been diverted.

Defined values for CALL_SS_NOTIFICATION code member:

CALL_SS_NOTIFICATION_HOLD Call has been put on hold.

CALL_SS_NOTIFICATION_RETRIEVED Call has been retrieved. CALL_SS_NOTIFICATION_MULTIPARTY Multiparty call has been

entered. CALL_SS_NOTIFICATION_TRANSFERRED Call is transferred into

remote party. CALL_SS_NOTIFICATION_FORWARDED Call is forwarded. CALL_SS_NOTIFICATION_INCOMING_FORWARDED Incoming calls are

forwarded. CALL_SS_NOTIFICATION_INCOMING_BARRED Incoming calls are

barred. CALL_SS_NOTIFICATION_CLIR_REJECTED CLIR suppression

rejected.

Defined values for CALL_DISCONNECTED reason member:

CALL_DISCONNECTING_REASON_NORMAL_CALL_CLEARING Normal call clearing.

CALL_DISCONNECTING_REASON_USER_BUSY User is busy. CALL_DISCONNECTING_REASON_NO_USER_RESPONDING User is not

di

31/53

responding. CALL_DISCONNECTING_REASON_ALERTING_NO_RESPONSE User alerting

but no response.

CALL_DISCONNECTING_REASON_CALL_REJECETED Call is rejected.

CALL_DISCONNECTING_REASON_NUMBER_CHANGED Number has

changed. CALL_DISCONNECTING_REASON_UNSPECIFIED_REASON Reason cannot

be specified.

Defined values for CALL_COMING mode member:

CALL_MODE_VOICE Voice call. CALL_MODE_DATA Data call. CALL_MODE_FAX Fax call. CALL_MODE_VOICE_FOLLOWED_BY_DATA Voice followed by data. CALL_MODE_ALT_VOICE_DATA Alternating voice and data, voice

first. CALL_MODE_ALT_VOICE_FAX Alternating voice and fax, voice

first.


CALL_MODE_ALT_DATA_VOICE Alternating data and voice, data first.

CALL_MODE_ALT_FAX_VOICE Alternating fax and voice, fax first. CALL_MODE_UNKNOWN Unknown.

6.3. COUNTERS The table below lists the counters related to the parameters described in Chapter 6.1.

Counter Possible values Notes

LastCallTime 0 - 359999 s. (99 h, 59 min, 59 sec)

Last call time in seconds.

Counter resets when the maximum value is reached.

32/53

Counter Possible values Notes

TotalCallTime 0 - 359999 s. (99 h, 59 min, 59 sec)

Total call time in seconds.

Counter resets when the maximum value is exceeded.

IncomingCalls 0 - 2^32 -1 Number of network-originated calls.

IncomingCallTime 0 - 359999 s. (99 h, 59 min, 59 sec)

Incoming call time in seconds.

Counter resets when the maximum value is exceeded.

OutgoingCalls 0 -2^32 -1 Number of mobile-originated calls.

OutgoingCallTime 0 - 359999 s. (99 h, 59 min, 59 sec)

Outgoing (mobile-originated) call time in seconds.

Counter resets when maximum value is exceeded.

CumulativeCallTime 0 - 2^32 -1 Cumulative call time in minutes.

DroppedCalls 0 - 2^32 -1 Dropped calls.

33/53

7. WIRELESS BEARERS PROPERTIES

A remote connection has to be configured for each wireless bearer that is going to be used for communication between the Nokia 12 module and the server. For example, if you want to use GPRS and occasionally CSD, GPRS is set up as the default connection and CSD as the secondary connection.

There are five static connections that are stored in non-volatile memory. They can be configured, for example, when the Nokia 12 module is installed on the remote device. The static connections can be configured by modifying the parameters described in this chapter. They can be modified by using the Configurator or by using a customer application.

Note: After configuring the static connections, the Nokia 12 module must be reset to activate the changes.

In addition there are five dynamic connections that are stored in volatile memory. The dynamic connections cannot be configured with the wireless bearer properties of the Properties Interface. Instead, they are configured through the Embedded Terminal Interface.

7.1. PARAMETERS For more information on configuring remote connections between the Nokia 12 module, see the Nokia 12 GSM Module Software Developer's Guide.

7.1.1. WAP parameters

Note: For historical reasons these parameters are named as WAP parameters even though the Nokia 12 module does not use Wireless Access Protocol (WAP).

The parameter name to be called in a CORBA method call: WAPParameters.

The WAPParameters parameter contains a sequence of WAPBearerInformation structs, each of which contains the members listed in the table below.

Members


connectionIndex (unsigned short) 0 - 4 (5 - 9 reserved for dynamic connections)

Identifies the index of the parameter settings.

-

34/53

Members


ETPort (unsigned short) 1 - 65534

WTP port number that the Nokia 12 module listens to and to which the server sends data.

0

GWPort (unsigned short) 1 - 65534

If WAP bearer is used, the port number that the server listens to and to which the Nokia 12 module sends data.

If TCP bearer is used, the GWPort is not used.

0

WAPbearerInformationUnion

bearerInfoCSD,

bearerInfoSMS,

bearerInfoGPRS,

bearerInfoUSSD

The union consists of four alternative structures describing settings of the CSD, SMS, GPRS or USSD bearers. These structures are described in Chapters 7.1.2, 7.1.3, 7.1.4, and 7.1.5.

Note! The Nokia 12 module does not support Unstructured Supplementary Services Data (USSD) as an application level data bearer.

-

7.1.2. Wireless bearer information USSD

Note: The Nokia 12 module does not support USSD as an application level data bearer.

35/53

The parameter name in the Properties Interface Definition: WAPBearerInformationUSSD.

This parameter cannot be set or get directly. Instead, it is used via the WAPParameters parameter.

Members


GWNumber (string) This member describes the service code, which is used to route USSD messages from an operator to the server.

Empty

connectionAddress GWIPAddress,

destinationNumber The union consists of two alternative members (described below).

-

GWIPAddress

Members


GWIPAddress (string) If WAP bearer is used, this is the IP address of the server.

If TCP bearer is used, the GWIPAddress is not used.

Empty

destinationNumber

Members


destinationNumber (string) USSDC Application number.

Empty

36/53

7.1.3. Wireless bearer information SMS The parameter name in the Properties Interface Definition: WAPBearerInformationSMS.


Members


destinationNumber (string) SMSC application number of the server.

Empty

7.1.4. Wireless bearer information CSD The parameter name in the Properties Interface Definition: WAPBearerInformationCSD.


Note: To be able to receive incoming data calls, there has to be at least one CSD bearer configured to the Nokia 12 module.

Members


timeout (unsigned long) 0 - 300 seconds

If there has not been any data traffic, the Nokia 12 module drops the CSD connection after the specified timeout.

Empty

bitrate AUTOBAUD,

NONTRANSP_ISDN_9600,




Possible data call bitrate.

AUTOBAUD

37/53

Members





NONTRANSP_9600,

NONTRANSP_14400,

NONTRANSP_19200,

NONTRANSP_28800

GWNumber (string) Phone number to the server.

Empty

GWIPAddress (string) If WAP bearer is used, this is the IP address of the server.

If TCP bearer is used, the GWIPAddress is not used..

Empty

PPPUsername (string) The Nokia 12 module can be configured to authenticate the CSD/HSCSD connection during PPP negotiations.

Empty

PPPPassword (string) The Nokia 12 module can be configured to authenticate the CSD/HSCSD connection during PPP negotiations.

Empty

7.1.5. Wireless bearer information GPRS The parameter name in the Properties Interface Definition: WAPBearerInformationGPRS.


38/53

Members


timeout (unsigned long) 0 – 300 seconds

If there has not been any data traffic, the Nokia 12 module drops the PDP context of the GPRS connection after the specified timeout.

If the timeout value is 0 (zero), timeout is not used.

0

GWIPAddess (string) IP address of the server.

Empty

accessPointName (string) Host name of the GPRS access point.

Empty

PPPUsername (string) The Nokia 12 module can be configured to authenticate the GPRS connection during PPP negotiations.

Empty

PPPPassword (string) The Nokia 12 module can be configured to authenticate the GPRS connection during PPP negotiations.

Empty

7.1.6. GPRS always online The parameter name to be called in a CORBA method call: WAPParametersGPRSAlwaysOnline.

Possible values

Notes Default value

True/False If the WAPParametersGPRSAlwaysOnline parameter is set to True, the Nokia 12 module makes a GPRS attach to the GPRS network automatically after start-up.

False

7.1.7. Default connection The parameter name to be called in a CORBA method call: WAPParametersDefaultConnection.

39/53

Possible values

Notes Default value

0 - 9 The parameter that defines the default connection index used by the Nokia 12 module when establishing a connection.

Note! Do not set values 5 - 9 (for dynamic connections) as the default value because they will be lost if the Nokia 12 module is reset.

0 (Connection 1)

7.1.8. Authentication The parameter name to be called in a CORBA method call: WAPParametersAuthentication.


Notes Default value

CSDNumberAuthenticationEnabled

True/False If this parameter is set to True, then incoming calls are authenticated by using the phone number of the configured CSD connection.

Note that the format and visibility of the phone number may vary between different GSM networks.

False

incomingCHAPAuthenticationEnabled

True/False This parameter defines whether the incoming calls are authenticated using Challenge Handshake Authentication Protocol (CHAP).

False

incomingCHAPUserName

(string) The incoming CHAP user name.

-

incomingCHAPPassword

(string), max. 19 characters

The incoming CHAP password.

-

40/53

8. AUDIO PROPERTIES

8.1. PARAMETERS

8.1.1. Audio parameters The parameter name to be called in a CORBA method call: AudioParameters.


Notes Default value

audioMode AUDIO_MODE_ANALOG,

AUDIO_MODE_DIGITAL

Used for defining which of the audio options is used.

AUDIO_MODE_DIGITAL

echoMode ECHO_OFF,

ECHO_HF,

ECHO_HS

The echo cancellation selection is available only in the analog mode.

ECHO_OFF

Defined values:

AUDIO_MODE_DIGITAL The Nokia 12 module offers a digital audio functionality for GSM via the Digital Audio Interface (DAI). DAI support is found in the M2M System Connector.

AUDIO_MODE_ANALOG The M2M System Connector also supports analog audio functionality that is an alternative to the Digital Audio Interface. Microphones and headphones can be connected through the analog audio signal interface.

ECHO_OFF When the ECHO_OFF alternative is selected, no echo cancellation is used.

ECHO_HF The handsfree (ECHO_HF) echo cancellation alternative is optimized for a situation similar to when a mobile handset is attached to a handsfree system in a car.

ECHO_HS The headset (ECHO_HS) echo cancellation alternative is optimized for a situation similar to when a headset is used with a mobile handset.

For more information, please refer to the Nokia 12 GSM Module Hardware Integration Manual.

41/53

9. USER CONTROL MODE PROPERTIES

For more information about the user control mode functionality, please see the Nokia 12 GSM Module User Control Mode Guide.

9.1. PARAMETERS

9.1.1. Message identifier The parameter name to be called in a CORBA method call: UCIOTerminalName.

Possible values Notes Default value (string) Message identifier. Empty

This parameter contains the message identifier, which starts each control message sent to the Nokia 12 module. The control messages are recognized as user control mode commands by the Nokia 12 module based on the message identifier.

If the parameter value is empty, the user control mode is disabled.

9.1.2. Password The parameter name to be called in a CORBA method call: UCIOPassword.

Possible values Notes Default value (string) Password for the user control mode. Empty

A user-specified password can further secure the communication between a mobile handset and the Nokia 12 module in the user control mode. The password is entered whenever a control message is sent to the Nokia 12 module.

No password is required if the parameter value is empty.

9.1.3. Authorized phone number The parameter name to be called in a CORBA method call: UCIOAuthorizedPhoneNumber.


42/53

Possible values Notes Default value (string) The phone number that is able to

access the Nokia 12 module in the user control mode.

Empty

The UCIOAuthorizedPhoneNumber parameter makes it possible to limit access to one phone number in the user control mode. Only the control messages originating from the authorized number are allowed to control the Nokia 12 module and the device attached to it.

If the parameter is empty, no number verification is used.

9.1.4. Authorized phone number list The parameter name to be called in a CORBA method call: UCIOAuthorizedPhoneNumberList.

Possible values Notes Default value (sequence of strings)

The phone numbers that are able to access the Nokia 12 module in the user control mode.

Empty

The UCIOAuthorizedPhoneNumberList parameter makes it possible to limit access to specific phone numbers in the user control mode. Only the control messages originating from the authorized numbers are allowed to control the Nokia 12 module and the device attached to it.

If the first phone number is empty, no number verification is used.

9.1.5. Alias list The parameter name to be called in a CORBA method call: UCIOAliasList.


(sequence of strings)

List of user-specified commands. Empty

The UCIOAliasList parameter lists user-specified commands (that is, aliases) defined for the predefined commands. The defined alias replaces the initial command or previous alias configured for the same command. If an alias has been configured, the original command is no longer accepted. The original command can be restored by defining an empty alias for a command. Duplicate aliases are not allowed.

43/53

9.1.6. Alarm mode The parameter name to be called in a CORBA method call: UCIOAlarmMode.


ONCE,

CONTINUOUS

Controls how many times an alarm can occur.

Empty

Defined values:

ONCE After the alarm subscription, the alarm message is sent only once when the alarm conditions are met.

CONTINUOUS Alarm message is sent every time that the alarm conditions are met until the alarm subscription is cancelled.

9.1.7. Response messages The parameter name to be called in a CORBA method call: UCIOResponseMessages.


responseToOriginator True, False Defines whether acknowledgements to set-type commands are sent or not.

True

inputAlarms True, False Defines whether alarm messages sent in response to alarm subscriptions are sent or not.

True

unknownCommand True, False Defines whether error messages in case of an unknown command are sent or not.

True

illegalOriginator True, False Defines whether indication messages in case of an illegal command attempt are sent or not

True

44/53

The UCIOSendResponseMessage parameter controls which acknowledgement messages are sent to the user.

45/53

10. PPP PROPERTIES

10.1. PARAMETERS

10.1.1. PPP negotiation IP address The parameter name to be called in a CORBA method call: PPPNegotiationIPAddress.


(string) Used to define the address that the Nokia 12 module uses as its own IP address during Point-to-Point Protocol (PPP) negotiation.

Note! Using the IP address value 0.0.0.0 disables this feature.

0.0.0.0

46/53

11. HLA PROPERTIES

11.1. PARAMETERS

11.1.1. HLA Information The Home Location Agent (HLA) address. If the Nokia 12 module ORB is not in M2M mode, the Nokia 12 module does not use this value in communications. In this case the parameter value can be freely used by the customer application.

The parameter name to be called in a CORBA method call: HLAInformation.


HLAHostName (string) Host name of the computer where the HLA of the used server is located.

-

HLAPortNumber (unsigned short)

HLA port number of the used server.

-

47/53

12. GPS PROPERTIES

For more information about the Nokia 12 module location functionality, see the Nokia 12 Module Interface Definition Reference Guide.

12.1. PARAMETERS

12.1.1. GPS information The parameter name to be called in a CORBA method call: GPSInformation.

Members Possible values Default values

baudrate GPS_BAUDRATE_1200,

GPS_BAUDRATE_2400,

GPS_BAUDRATE_4800,

GPS_BAUDRATE_9600,

GPS_BAUDRATE_19200,

GPS_BAUDRATE_28800,

GPS_BAUDRATE_38400,

GPS_BAUDRATE_57600,

GPS_BAUDRATE_115200

GPS_BAUDRATE_4800

GPSParamGLL True, False True

GPSParamGGA True, False True

With the GPSParamGGA member the default value (True) is mandatory.

GPSParamRMC True, False True

With the GPSParamRMC member the default value (True) is mandatory.

GPSParamVTG True, False False

Global Positioning System (GPS) settings are stored in the Nokia 12 module with the GPSInformation parameter. For more information on the available National Marine Electronics Association (NMEA) parameters, see your GPS device manual.

48/53

13. MODULE ORB PROPERTIES

13.1. PARAMETERS

13.1.1. Module ORB mode This parameter is used to set and get the Module ORB mode. The Module ORB mode affects the behaviour of the module ORB and it can be set in two different modes: M2M mode and IIOP mode. The selected mode determines the object reference (IOR) creation in the module ORB and CORBA method calls created by the module ORB when it is generating events.

IIOP mode When the IIOP mode is used, the module ORB behaves as a standard IIOP ORB. The module ORB publishes object references according to the IIOP rules; it sets the module IP address in the IOR if a wireless network link is open. If the wireless network link is not open, the module ORB will publish the address 127.0.0.1.

When the module ORB creates a CORBA method invocation, it sends the invocation to the IP address given in the IOR.

M2M mode In the M2M mode the module ORB always communicates through a gateway. The module ORB publishes object references using a mobile IOR and HLA address, which points to the gateway in question. The IP address of the Nokia 12 module is not used. When the module ORB creates a method invocation, it always sends the invocation to the gateway address given in the wireless bearer configuration.

The parameter name to be called in a CORBA method call: ModuleORBMode.

Possible values Notes Default value M2M

IIOP The mode in which the ORB of the Nokia 12 module functions.

M2M

13.1.2. Module ORB port The parameter name to be called in a CORBA method call: ModuleORBPort.


49/53

Possible values Notes Default value (unsigned short)

The port number that the ORB of the Nokia 12 module listens to.

Note! It is not recommended to change the default value.

19740

50/53

14. HTTP PROPERTIES

14.1. PARAMETERS

14.1.1. HTTP bearer information CSD This parameter cannot be set or get directly, but is used through the HTTP Information parameter. Ask your service provider for HTTP connection parameters.

Members Possible values Notes Default values

authenticationType PAP, CHAP

Authentication protocol selection.

-

dataCallType ANALOG,

ISDN - ANALOG

analogDatacallSpeed HTTP_AUTOBAUD,

HTTP_ANALOG_9600,

HTTP_ANALOG_14400,

HTTP_ANALOG_19200,

HTTP_ANALOG_28800

- HTTP_AUTOBAUD

isdnDatacallSpeed ISDN_9600,

ISDN_14400,

ISDN_19200,

ISDN_28800,

ISDN_38400,

ISDN_43200

- ISDN_9600

loginType MANUAL,

AUTOMATIC In the Nokia 12 module the login type is selected automatically.

AUTOMATIC

destinationAddress (string) - -

GWIPAddress (string) Indicates the WAP gateway

-

51/53

Members Possible values Notes Default values IP address. Not used by the Nokia 12 module.

userName (string) - -

passWord (string) - -

14.1.2. HTTP bearer information GPRS This parameter cannot be set or get directly. Instead, it is used through the HTTP Information parameter. Ask your service provider for HTTP connection parameters.


authenticationType PAP, CHAP

Authentication protocol selection.

-

contextOpenType ON_POWER_UP,

ON_DEMAND Used to define when the Nokia 12 module makes a GPRS attach.

-

loginType MANUAL,

AUTOMATIC In the Nokia 12 module the login type is selected automatically.

AUTOMATIC

GPRSAccessPointName (string) - -

GWIPAddress (string) Indicates the WAP gateway IP address. Not used by the Nokia 12 module.

-

userName (string) - -

passWord (string) - -

14.1.3. HTTP proxy information This parameter cannot be set or get directly. Instead, it is used via the HTTP Information parameter. Ask your service provider for HTTP connection parameters.

52/53

53/53


proxyEnabled True/False - -

primaryProxyPort (unsigned short) - -

secondaryProxyPort (unsigned short) - -

primaryProxyAddress (string) - -

secondaryProxyAddress (string) - -

14.1.4. HTTP information The parameter name to be called in a CORBA method call: HTTPInformation.

Ask your service provider for HTTP connection parameters.


HTTPActiveSessionType CL,

CO Connectionless (CL) or Connection Oriented (CO) session selection.

CO

HTTPActiveBearerType HTTP_GPRS,

HTTP_CSD The bearer to be used during the HTTP session.

-

HTTPSessionSecurity SECURE,

UNSECURE The Nokia 12 module does not support the SECURE value.

UNSECURE

HTTPProxyInformation See HTTP Proxy Information parameter.

- -

HTTPBearerInformationUnion

bearerInfoCSD (See HTTP bearer information CSD parameter.)

or bearerInfoGPRS (See HTTP bearer information GPRS parameter.)

- -

nokia 12 gsm module - hmangas.com 12/docs_nokia… · gprs always online ... this document...

Documents