<?xml version="1.0" encoding="utf-8"?>

<!-- Copyright (c) 2007-2010 Nokia Corporation and/or its subsidiary(-ies) All rights reserved. -->

<!-- This component and the accompanying materials are made available under the terms of the License 

"Eclipse Public License v1.0" which accompanies this distribution, 

and is available at the URL "http://www.eclipse.org/legal/epl-v10.html". -->

<!-- Initial Contributors:

    Nokia Corporation - initial contribution.

Contributors: 

-->

<!DOCTYPE concept

  PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd">

<concept id="GUID-83676985-070A-5CE9-BF36-D7C56C5025F9" xml:lang="en"><title> Services

Provided</title><shortdesc>This section provides details on the information that an application

can access about basic services. The basic services are phone, network and

call information that are accessed by the applications. </shortdesc><prolog><metadata><keywords/></metadata></prolog><conbody>

<p>The telephony API for application allows client applications to access

information about: </p>

<ul>

<li id="GUID-FB929DCD-DB6F-5DAD-8DAE-7151B776E203"><p> <xref href="GUID-83676985-070A-5CE9-BF36-D7C56C5025F9.dita#GUID-83676985-070A-5CE9-BF36-D7C56C5025F9/GUID-D863BBC8-1391-5BCA-A5B8-DB23471A385B">Phone</xref>  </p> </li>

<li id="GUID-CBA13E00-AE97-5AF5-927D-07EBD22D97E0"><p> <xref href="GUID-83676985-070A-5CE9-BF36-D7C56C5025F9.dita#GUID-83676985-070A-5CE9-BF36-D7C56C5025F9/GUID-B9CD50FF-28BF-5247-885C-710697EBA539">Call</xref>  </p> </li>

<li id="GUID-547FF098-8F01-5553-BFE0-DB1F5D7E923C"><p> <xref href="GUID-83676985-070A-5CE9-BF36-D7C56C5025F9.dita#GUID-83676985-070A-5CE9-BF36-D7C56C5025F9/GUID-A68352BE-5980-5F66-B04B-C2FFC44FB409">Network</xref>  </p> </li>

</ul>

<section id="GUID-D863BBC8-1391-5BCA-A5B8-DB23471A385B"><title>Phone Information</title> <p>The

phone information available is: </p> <p><b>Device identification </b> </p> <p>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. </p> <p><b>Subscriber identification </b> </p> <p>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. </p> <p><b>Flight

mode status </b> </p> <p>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. </p> <p><b>Battery

information </b> </p> <p>The client application can access the battery charge

level and the battery status. The three states of a battery are: </p> <ul>

<li id="GUID-2E5D8E44-0B52-57EC-9690-F4B3AD846CA0"><p>Powered </p> </li>

<li id="GUID-04D411ED-A503-53E9-A177-1FAF28578C03"><p>No battery </p> </li>

<li id="GUID-8A71BBC7-45B4-5204-B986-66AB24AC9E69"><p>Faulty battery </p> </li>

</ul> <p><b>Battery charger information </b> </p> <p>The client application

can find out if the charger is connected or not. </p> <p><b>Lock information </b> </p> <p>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. </p> </section>

<section id="GUID-B9CD50FF-28BF-5247-885C-710697EBA539"><title>Call Information</title> <p>The

call information available is: </p> <p><b>Call-in-progress indicator </b> </p> <p>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. </p> <p><b>Fax

line status </b> </p> <p>Status information is available for the fax line

and the different states include: </p> <ul>

<li id="GUID-A8FE79DD-9651-5FBD-9CB8-7E80A8D89A3F"><p>idle </p> </li>

<li id="GUID-B0DC6A12-8016-5EE8-A4DB-75065919F96C"><p>notify an inbound call </p> </li>

<li id="GUID-F96EE593-E7C0-5519-B36D-BC50F8688844"><p>dialling a number </p> </li>

<li id="GUID-84567467-1B0D-5365-82A0-3739C434B587"><p>answering an inbound

call </p> </li>

<li id="GUID-FA43C558-21DE-5E04-848A-10BE200EA587"><p>call on hold. </p> </li>

</ul> <p><b>Data line status </b> </p> <p>Status information is available

for the data line and the different states include: </p> <ul>

<li id="GUID-AE8EFF6A-DA24-59A7-9BB1-50769EBC0F60"><p>idle </p> </li>

<li id="GUID-E9F357E7-2420-5F04-B780-2C880D69FDC6"><p>notify an inbound call </p> </li>

<li id="GUID-5E711492-C857-58F8-8D3D-4BF32486EAA4"><p>dialling a number </p> </li>

<li id="GUID-EFD4A32A-9460-5403-8404-79720AB5C2E7"><p>answering an inbound

call </p> </li>

<li id="GUID-2783707D-D151-5F6B-81CA-07907ECFC545"><p>call on hold. </p> </li>

</ul> <p><b>Voice call status </b> </p> <p>Status information is available

for the voice line and the different states include: </p> <ul>

<li id="GUID-E6E7F877-EFE7-54BD-A95C-301A88C606F7"><p>idle </p> </li>

<li id="GUID-8C5DE194-8CE1-5E7B-B226-CD497CCE67F8"><p>notify an inbound call </p> </li>

<li id="GUID-D671EBE6-C8A8-50B0-B223-D2DA568BB59B"><p>dialling a number </p> </li>

<li id="GUID-34E12E0B-0417-5418-B8BC-4272F6AD2187"><p>answering an inbound

call </p> </li>

<li id="GUID-7D9C89BE-CF40-5386-9CCA-D3600A3653B9"><p>call on hold. </p> </li>

</ul> <p>The client applications can get detailed voice call information such

as: </p> <ul>

<li id="GUID-6DD07BDD-04D5-54BA-B8B0-7928D0F70E22"><p>call status </p> </li>

<li id="GUID-B70A7958-DFC1-52DA-B07D-3B704058489E"><p>date and time that the

call started </p> </li>

<li id="GUID-3D3FC0AA-1319-536B-80CA-FAEA36B517A4"><p>current duration of

the call in seconds </p> </li>

<li id="GUID-40890DAA-1F43-5B52-A97C-2D9134885A04"><p>dialled phone number </p> <p>This

is only valid for outgoing calls. It includes any DTMF tones that have been

sent. </p> </li>

<li id="GUID-33E92A09-E559-5504-90E9-1A5098F50D3C"><p>ciphering status </p> <p>This

is only valid on GSM and WCDMA networks </p> </li>

<li id="GUID-A7BB8A56-1C6A-5647-B2F8-75941A181869"><p>Call ID </p> </li>

</ul> <p><b>Remote party information </b> </p> <p>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. </p> <p>The remote party information available

is: </p> <ul>

<li id="GUID-C24ED61D-D2C1-5038-84E4-F4F0AD65D4C9"><p>remote identity status </p> </li>

<li id="GUID-632BED79-5FA6-5FA5-B49B-32A9899A41F8"><p>remote party number </p> </li>

<li id="GUID-9923B9FC-EF8D-5891-B89C-D0308444B8EA"><p>remote party name </p> </li>

<li id="GUID-76C99712-2DF3-5B43-B247-A8EF144543D2"><p>call direction. </p> </li>

</ul> <p><b>Dynamic call capabilities </b> </p> <p>The client application

can get the information about call hold, call resume and all swap functions

of the device. </p> </section>

<section id="GUID-A68352BE-5980-5F66-B04B-C2FFC44FB409"><title>Network Information</title> <p><b>Network

signal indicator </b> </p><p>The client applications can get the notification

of the network signal availability. The network information available is: </p><p> <b>Signal

strength</b> </p><p>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.</p><p><b>Registration

status  </b></p><p>The registration status indicates the service that the

current network provides to the phone. For example, No Service, Emergency

Only, Busy and Roaming.  </p><p><b>Current network information  </b></p><p>The

information available for all types of network include: </p><ul>

<li><p>network mode </p></li>

<li><p>mobile country code </p></li>

<li><p>network identity  </p></li>

<li><p>network display tag  </p></li>

</ul> <p>The network information available for GSM and WCDMA networks include:

 </p><ul>

<li><p>network short name </p></li>

<li><p>network long name </p></li>

<li><p>access technology</p></li>

<li><p> location area code  </p></li>

<li><p>cell ID of the base station  </p></li>

</ul></section>

</conbody><related-links>

<link href="GUID-520F620F-03CE-5C4E-9783-745D2740F648.dita"><linktext>What Supplementary

Services are Provided</linktext></link>

</related-links></concept>