Services +Provided

The telephony API for application allows client applications to access +information about:

Phone
Call
Network

Phone Information

The +phone information available is:

Device identification

The +device identity provides the details about the manufacturer, device model +and the serial number. The serial number is the International Mobile Equipment +Identity (IMEI) which is a unique 15-digit serial number. The serial number +is unique to the device and not the subscriber.

Subscriber identification

A +string of up to 15 characters that identifies the subscriber. It is the information +of the Subscriber Identity Module (SIM) card on the GSM networks and WCDMA +networks or the Removable User Identity Module (R-UIM) on the CDMA networks.

Flight +mode status

The phone can be put into a state with the network +related operations disabled. This state is known as the flight mode. You cannot +make or receive calls when the flight mode is enabled. The client applications +cannot access the information about call, line and other supplementary services.

Battery +information

The client application can access the battery charge +level and the battery status. The three states of a battery are:

Powered
No battery
Faulty battery

Battery charger information

The client application +can find out if the charger is connected or not.

Lock information

The +phones allow the users to lock them to prevent unauthorised access. A code +must be entered to unlock the phone. The client applications can access the +lock information. This information does not concern the keypad locks, nor +the lock that the networks use to prevent a phone from being used on other +networks. A phone can have up to two locks. The client applications must specify +the lock to access their information.

Call Information

The +call information available is:

Call-in-progress indicator

The +client applications can retrieve information about when a call is in progress +and the type of call. The calls can be data, voice or fax calls. The client +applications can also get the information about the status of a call.

Fax +line status

Status information is available for the fax line +and the different states include:

idle
notify an inbound call
dialling a number
answering an inbound +call
call on hold.

Data line status

Status information is available +for the data line and the different states include:

idle
notify an inbound call
dialling a number
answering an inbound +call
call on hold.

Voice call status

Status information is available +for the voice line and the different states include:

idle
notify an inbound call
dialling a number
answering an inbound +call
call on hold.

The client applications can get detailed voice call information such +as:

call status
date and time that the +call started
current duration of +the call in seconds
dialled phone number

This +is only valid for outgoing calls. It includes any DTMF tones that have been +sent.
ciphering status

This +is only valid on GSM and WCDMA networks
Call ID

Remote party information

The client applications +can retrieve the information of the remote party when details are available. +The information is available for the voice line. It is not available for the +fax or data lines. When the voice line is making more than one call, for example +one call is active and another is on hold, then you can read this information +for individual calls. You do not need to have dialled or answered the call +in order to read this information. However, the remote party may not allow +you to know this information.

The remote party information available +is:

remote identity status
remote party number
remote party name
call direction.

Dynamic call capabilities

The client application +can get the information about call hold, call resume and all swap functions +of the device.

Network Information

Network +signal indicator

The client applications can get the notification +of the network signal availability. The network information available is:

Signal +strength

Signal strength is measured in dBm. For example, "-51" +is a signal strength of -51dBm. A value of zero indicates that the signal +strength cannot be measured. The signal bars represent number of bars to display +to the user. A value of '-1' indicates that the number of bars is not available.

Registration +status

The registration status indicates the service that the +current network provides to the phone. For example, No Service, Emergency +Only, Busy and Roaming.

Current network information

The +information available for all types of network include:

network mode
mobile country code
network identity
network display tag

The network information available for GSM and WCDMA networks include: +

network short name
network long name
access technology
location area code
cell ID of the base station