<?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>