nokia 12 gsm module - hmangas.com 12/docs_nokia… · gprs always online ... this document...
TRANSCRIPT
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
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
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_38400,
MAP27_BAUD_RATE_BPS_57600,
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
Possible values Notes Default value
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.
Members Possible values Notes Default value
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
Members Possible values
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.
Members Possible values Notes
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.
Members Possible values Notes
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.
Members Possible values Notes Default value
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.
Members Possible values Notes
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
3.2. EVENTS The table below lists the events related to the parameters described in Chapter 3.1.
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.
Possible values Notes Default value
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.
Possible values Notes Default value
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.
Possible values Notes
18/53
Possible values Notes
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.
Possible values Notes
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.
4.2. EVENTS The table below lists the events related to the parameters described in Chapter 4.1.
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
Event Notes Member Possible values Notes
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
Event Notes Member Possible values Notes
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.
Possible values Notes Default value
(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.
Possible values Notes Default value
24/53
Possible values Notes Default value True/False - False
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.
Possible values Notes Default value
SMS_VALIDITY_PERIOD_1_HOUR,
SMS_VALIDITY_PERIOD_6_HOURS,
SMS_VALIDITY_PERIOD_24_HOURS,
SMS_VALIDITY_PERIOD_72_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.
Possible values Notes Default value True/False - False
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.
5.2. EVENTS The table below lists the events related to the parameters described in Chapter 5.1.
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.
Members Possible values Notes
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.
Possible values Notes Default value
28/53
Possible values Notes Default value True/False Automatic answer for incoming
calls. False
6.2. EVENTS The table below lists the events related to the parameters described in Chapter 6.1.
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,
Note! Nokia 12 module does not support CALL_MODE_ALT_VOICE_FAX.
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.
Note! Nokia 12 module does not support CALL_MODE_ALT_VOICE_FAX.
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
Possible values Notes Default value
connectionIndex (unsigned short) 0 - 4 (5 - 9 reserved for dynamic connections)
Identifies the index of the parameter settings.
-
34/53
Members
Possible values Notes Default value
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
Possible values Notes Default value
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
Possible values Notes Default value
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
Possible values Notes Default value
destinationNumber (string) USSDC Application number.
Empty
36/53
7.1.3. Wireless bearer information SMS The parameter name in the Properties Interface Definition: WAPBearerInformationSMS.
This parameter cannot be set or get directly. Instead, it is used via the WAPParameters parameter.
Members
Possible values Notes Default value
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.
This parameter cannot be set or get directly. Instead, it is used via the WAPParameters parameter.
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
Possible values Notes Default value
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,
NONTRANSP_ISDN_14400,
NONTRANSP_ISDN_19200,
NONTRANSP_ISDN_28800,
Possible data call bitrate.
AUTOBAUD
37/53
Members
Possible values Notes Default value
NONTRANSP_ISDN_38400,
NONTRANSP_ISDN_43200,
NONTRANSP_ISDN_57600,
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.
This parameter cannot be set or get directly. Instead, it is used via the WAPParameters parameter.
38/53
Members
Possible values Notes Default value
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.
Members Possible values
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.
Members Possible values
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.
Possible values Notes Default value
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.
Possible values Notes Default value
(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.
Possible values Notes Default value
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.
Members Possible values Notes Default value
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.
Possible values Notes Default value
(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.
Members Possible values Notes Default value
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.
Possible values Notes Default value
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.
Members Possible values Notes Default values
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
Members Possible values Notes Default values
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.
Members Possible values Notes Default values
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.)
- -