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

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

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

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

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

     6 <!-- Initial Contributors:

     7     Nokia Corporation - initial contribution.

     8 Contributors: 

     9 -->

    10 <!DOCTYPE concept

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

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

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

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

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

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

    17 information about: </p>

    18 <ul>

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

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

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

    22 </ul>

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

    24 phone information available is: </p> <p><b>Device identification </b> </p> <p>The

    25 device identity provides the details about the manufacturer, device model

    26 and the serial number. The serial number is the International Mobile Equipment

    27 Identity (IMEI) which is a unique 15-digit serial number. The serial number

    28 is unique to the device and not the subscriber. </p> <p><b>Subscriber identification </b> </p> <p>A

    29 string of up to 15 characters that identifies the subscriber. It is the information

    30 of the Subscriber Identity Module (SIM) card on the GSM networks and WCDMA

    31 networks or the Removable User Identity Module (R-UIM) on the CDMA networks. </p> <p><b>Flight

    32 mode status </b> </p> <p>The phone can be put into a state with the network

    33 related operations disabled. This state is known as the flight mode. You cannot

    34 make or receive calls when the flight mode is enabled. The client applications

    35 cannot access the information about call, line and other supplementary services. </p> <p><b>Battery

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

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

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

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

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

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

    42 can find out if the charger is connected or not. </p> <p><b>Lock information </b> </p> <p>The

    43 phones allow the users to lock them to prevent unauthorised access. A code

    44 must be entered to unlock the phone. The client applications can access the

    45 lock information. This information does not concern the keypad locks, nor

    46 the lock that the networks use to prevent a phone from being used on other

    47 networks. A phone can have up to two locks. The client applications must specify

    48 the lock to access their information. </p> </section>

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

    50 call information available is: </p> <p><b>Call-in-progress indicator </b> </p> <p>The

    51 client applications can retrieve information about when a call is in progress

    52 and the type of call. The calls can be data, voice or fax calls. The client

    53 applications can also get the information about the status of a call. </p> <p><b>Fax

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

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

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

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

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

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

    60 call </p> </li>

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

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

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

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

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

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

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

    68 call </p> </li>

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

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

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

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

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

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

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

    76 call </p> </li>

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

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

    79 as: </p> <ul>

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

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

    82 call started </p> </li>

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

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

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

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

    87 sent. </p> </li>

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

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

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

    91 </ul> <p><b>Remote party information </b> </p> <p>The client applications

    92 can retrieve the information of the remote party when details are available.

    93 The information is available for the voice line. It is not available for the

    94 fax or data lines. When the voice line is making more than one call, for example

    95 one call is active and another is on hold, then you can read this information

    96 for individual calls. You do not need to have dialled or answered the call

    97 in order to read this information. However, the remote party may not allow

    98 you to know this information. </p> <p>The remote party information available

    99 is: </p> <ul>

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

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

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

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

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

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

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

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

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

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

   110 strength</b> </p><p>Signal strength is measured in dBm. For example, "-51"

   111 is a signal strength of -51dBm. A value of zero indicates that the signal

   112 strength cannot be measured. The signal bars represent number of bars to display

   113 to the user. A value of '-1' indicates that the number of bars is not available.</p><p><b>Registration

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

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

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

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

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

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

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

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

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

   123  </p><ul>

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

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

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

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

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

   129 </ul></section>

   130 </conbody><related-links>

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

   132 Services are Provided</linktext></link>

   133 </related-links></concept>