Symbian3/PDK/Source/GUID-789214C3-FAE2-5588-A662-7F0DE17F84F9.dita
author Graeme Price <GRAEME.PRICE@NOKIA.COM>
Fri, 15 Oct 2010 14:32:18 +0100
changeset 15 307f4279f433
parent 14 578be2adaf3e
permissions -rw-r--r--
Initial contribution of the Adaptation Documentation.
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
14
578be2adaf3e Week 32 contribution of PDK documentation content. See release notes for details. Fixes bug Bug 3582
Dominic Pinkman <dominic.pinkman@nokia.com>
parents: 5
diff changeset
     1
<?xml version="1.0" encoding="utf-8"?>
578be2adaf3e Week 32 contribution of PDK documentation content. See release notes for details. Fixes bug Bug 3582
Dominic Pinkman <dominic.pinkman@nokia.com>
parents: 5
diff changeset
     2
<!-- Copyright (c) 2007-2010 Nokia Corporation and/or its subsidiary(-ies) All rights reserved. -->
578be2adaf3e Week 32 contribution of PDK documentation content. See release notes for details. Fixes bug Bug 3582
Dominic Pinkman <dominic.pinkman@nokia.com>
parents: 5
diff changeset
     3
<!-- This component and the accompanying materials are made available under the terms of the License 
578be2adaf3e Week 32 contribution of PDK documentation content. See release notes for details. Fixes bug Bug 3582
Dominic Pinkman <dominic.pinkman@nokia.com>
parents: 5
diff changeset
     4
"Eclipse Public License v1.0" which accompanies this distribution, 
578be2adaf3e Week 32 contribution of PDK documentation content. See release notes for details. Fixes bug Bug 3582
Dominic Pinkman <dominic.pinkman@nokia.com>
parents: 5
diff changeset
     5
and is available at the URL "http://www.eclipse.org/legal/epl-v10.html". -->
578be2adaf3e Week 32 contribution of PDK documentation content. See release notes for details. Fixes bug Bug 3582
Dominic Pinkman <dominic.pinkman@nokia.com>
parents: 5
diff changeset
     6
<!-- Initial Contributors:
578be2adaf3e Week 32 contribution of PDK documentation content. See release notes for details. Fixes bug Bug 3582
Dominic Pinkman <dominic.pinkman@nokia.com>
parents: 5
diff changeset
     7
    Nokia Corporation - initial contribution.
578be2adaf3e Week 32 contribution of PDK documentation content. See release notes for details. Fixes bug Bug 3582
Dominic Pinkman <dominic.pinkman@nokia.com>
parents: 5
diff changeset
     8
Contributors: 
578be2adaf3e Week 32 contribution of PDK documentation content. See release notes for details. Fixes bug Bug 3582
Dominic Pinkman <dominic.pinkman@nokia.com>
parents: 5
diff changeset
     9
-->
578be2adaf3e Week 32 contribution of PDK documentation content. See release notes for details. Fixes bug Bug 3582
Dominic Pinkman <dominic.pinkman@nokia.com>
parents: 5
diff changeset
    10
<!DOCTYPE concept
578be2adaf3e Week 32 contribution of PDK documentation content. See release notes for details. Fixes bug Bug 3582
Dominic Pinkman <dominic.pinkman@nokia.com>
parents: 5
diff changeset
    11
  PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd">
578be2adaf3e Week 32 contribution of PDK documentation content. See release notes for details. Fixes bug Bug 3582
Dominic Pinkman <dominic.pinkman@nokia.com>
parents: 5
diff changeset
    12
<concept id="GUID-789214C3-FAE2-5588-A662-7F0DE17F84F9" xml:lang="en"><title>High
578be2adaf3e Week 32 contribution of PDK documentation content. See release notes for details. Fixes bug Bug 3582
Dominic Pinkman <dominic.pinkman@nokia.com>
parents: 5
diff changeset
    13
Speed Uplink Packet Access (HSUPA) </title><shortdesc>Explains the HSUPA functionality supported by Symbian platform.</shortdesc><prolog><metadata><keywords/></metadata></prolog><conbody>
578be2adaf3e Week 32 contribution of PDK documentation content. See release notes for details. Fixes bug Bug 3582
Dominic Pinkman <dominic.pinkman@nokia.com>
parents: 5
diff changeset
    14
<section id="GUID-0FFFAB4D-AEE9-4DC8-89AF-45D3EB39926E"><title>Introduction</title> <p> The HSUPA functionality is supported
578be2adaf3e Week 32 contribution of PDK documentation content. See release notes for details. Fixes bug Bug 3582
Dominic Pinkman <dominic.pinkman@nokia.com>
parents: 5
diff changeset
    15
by extending the <xref href="GUID-BBF6E33F-2E9C-5BB1-8404-87289EC73BFF.dita">multimode
578be2adaf3e Week 32 contribution of PDK documentation content. See release notes for details. Fixes bug Bug 3582
Dominic Pinkman <dominic.pinkman@nokia.com>
parents: 5
diff changeset
    16
telephony</xref> API and the <xref href="GUID-8F565241-149E-5AF7-972E-A06B6DDC1B9F.dita">packet
578be2adaf3e Week 32 contribution of PDK documentation content. See release notes for details. Fixes bug Bug 3582
Dominic Pinkman <dominic.pinkman@nokia.com>
parents: 5
diff changeset
    17
data telephony</xref> API. HSUPA is defined in 3GPP R6 specifications. </p> <p>HSUPA
578be2adaf3e Week 32 contribution of PDK documentation content. See release notes for details. Fixes bug Bug 3582
Dominic Pinkman <dominic.pinkman@nokia.com>
parents: 5
diff changeset
    18
provides users with a high speed uplink, which allows network operators to
578be2adaf3e Week 32 contribution of PDK documentation content. See release notes for details. Fixes bug Bug 3582
Dominic Pinkman <dominic.pinkman@nokia.com>
parents: 5
diff changeset
    19
provide more interactive value-added data services. HSUPA improves data throughput
578be2adaf3e Week 32 contribution of PDK documentation content. See release notes for details. Fixes bug Bug 3582
Dominic Pinkman <dominic.pinkman@nokia.com>
parents: 5
diff changeset
    20
and reduces delays by using technologies such as adaptive modulation and hybrid
578be2adaf3e Week 32 contribution of PDK documentation content. See release notes for details. Fixes bug Bug 3582
Dominic Pinkman <dominic.pinkman@nokia.com>
parents: 5
diff changeset
    21
ARQ. The main advantages of using HSUPA is that it does not require any hardware
578be2adaf3e Week 32 contribution of PDK documentation content. See release notes for details. Fixes bug Bug 3582
Dominic Pinkman <dominic.pinkman@nokia.com>
parents: 5
diff changeset
    22
modifications to existing network and phones that already supports 3G. </p> <p>Developers
578be2adaf3e Week 32 contribution of PDK documentation content. See release notes for details. Fixes bug Bug 3582
Dominic Pinkman <dominic.pinkman@nokia.com>
parents: 5
diff changeset
    23
who wish to use HSUPA functionality should include <filepath>etelmm.dll</filepath><i/> and <filepath>etelpckt.dll</filepath> in
578be2adaf3e Week 32 contribution of PDK documentation content. See release notes for details. Fixes bug Bug 3582
Dominic Pinkman <dominic.pinkman@nokia.com>
parents: 5
diff changeset
    24
their MMP files. </p> </section>
578be2adaf3e Week 32 contribution of PDK documentation content. See release notes for details. Fixes bug Bug 3582
Dominic Pinkman <dominic.pinkman@nokia.com>
parents: 5
diff changeset
    25
<section id="GUID-161DEBEA-BEA3-453F-A3E1-FA7A68A22F3D"><title>HSUPA support by the phone</title> <p>The following steps
578be2adaf3e Week 32 contribution of PDK documentation content. See release notes for details. Fixes bug Bug 3582
Dominic Pinkman <dominic.pinkman@nokia.com>
parents: 5
diff changeset
    26
enables the client applications to find out if the phone supports HSUPA or
578be2adaf3e Week 32 contribution of PDK documentation content. See release notes for details. Fixes bug Bug 3582
Dominic Pinkman <dominic.pinkman@nokia.com>
parents: 5
diff changeset
    27
not: </p> <ol id="GUID-16130593-BA39-5175-A704-3A69EA368D96">
578be2adaf3e Week 32 contribution of PDK documentation content. See release notes for details. Fixes bug Bug 3582
Dominic Pinkman <dominic.pinkman@nokia.com>
parents: 5
diff changeset
    28
<li id="GUID-7DDE5784-E775-5201-81E3-07E9E3E1FBBB"><p>Create an instance of <xref href="GUID-AA81AFA4-6FAC-3B0D-A082-BE0AEC58CCA8.dita"><apiname>RMobilePhone</apiname></xref>  </p> </li>
578be2adaf3e Week 32 contribution of PDK documentation content. See release notes for details. Fixes bug Bug 3582
Dominic Pinkman <dominic.pinkman@nokia.com>
parents: 5
diff changeset
    29
<li id="GUID-8C88E45D-A211-56B5-8EE0-B4B68D309A29"><p>Open a new <xref href="GUID-C20F4764-4DE4-336D-9785-3A232C9A2CC0.dita"><apiname>RPacketService</apiname></xref>  </p> </li>
578be2adaf3e Week 32 contribution of PDK documentation content. See release notes for details. Fixes bug Bug 3582
Dominic Pinkman <dominic.pinkman@nokia.com>
parents: 5
diff changeset
    30
<li id="GUID-32D7D26E-02FA-5726-A6F4-E2E50936322E"><p>Call <xref href="GUID-C20F4764-4DE4-336D-9785-3A232C9A2CC0.dita#GUID-C20F4764-4DE4-336D-9785-3A232C9A2CC0/GUID-FC6E5234-A805-3EB1-95C1-0FC016C30FD3"><apiname>RPacketService::GetStaticCaps()</apiname></xref> to
578be2adaf3e Week 32 contribution of PDK documentation content. See release notes for details. Fixes bug Bug 3582
Dominic Pinkman <dominic.pinkman@nokia.com>
parents: 5
diff changeset
    31
find out if HSUPA is supported by the phone </p> </li>
578be2adaf3e Week 32 contribution of PDK documentation content. See release notes for details. Fixes bug Bug 3582
Dominic Pinkman <dominic.pinkman@nokia.com>
parents: 5
diff changeset
    32
<li id="GUID-56A3DD52-1CFA-560F-A321-3E7F94C1333B"><p>The function returns
578be2adaf3e Week 32 contribution of PDK documentation content. See release notes for details. Fixes bug Bug 3582
Dominic Pinkman <dominic.pinkman@nokia.com>
parents: 5
diff changeset
    33
with information regarding the support for 3G network service, HSUPA and HSDPA </p> </li>
578be2adaf3e Week 32 contribution of PDK documentation content. See release notes for details. Fixes bug Bug 3582
Dominic Pinkman <dominic.pinkman@nokia.com>
parents: 5
diff changeset
    34
</ol> </section>
578be2adaf3e Week 32 contribution of PDK documentation content. See release notes for details. Fixes bug Bug 3582
Dominic Pinkman <dominic.pinkman@nokia.com>
parents: 5
diff changeset
    35
<section id="GUID-7D64C77D-90C2-4B84-BEB2-3F6363D53912"><title>HSUPA support by the network</title><p><b>Home network support </b> </p> <p>Clients
578be2adaf3e Week 32 contribution of PDK documentation content. See release notes for details. Fixes bug Bug 3582
Dominic Pinkman <dominic.pinkman@nokia.com>
parents: 5
diff changeset
    36
can verify if the home network supports HSUPA by calling <xref href="GUID-AA81AFA4-6FAC-3B0D-A082-BE0AEC58CCA8.dita#GUID-AA81AFA4-6FAC-3B0D-A082-BE0AEC58CCA8/GUID-959520A3-6AD8-3E28-BD09-FE718A6C7C32"><apiname>RMobilePhone::GetHomeNetwork()</apiname></xref>.
578be2adaf3e Week 32 contribution of PDK documentation content. See release notes for details. Fixes bug Bug 3582
Dominic Pinkman <dominic.pinkman@nokia.com>
parents: 5
diff changeset
    37
The function returns the network support details in a <xref href="GUID-B4B45692-9810-3AFF-829B-117EDEE28D75.dita"><apiname>TMobilePhoneNetworkInfoV8</apiname></xref> object. </p> <p><b>Current
578be2adaf3e Week 32 contribution of PDK documentation content. See release notes for details. Fixes bug Bug 3582
Dominic Pinkman <dominic.pinkman@nokia.com>
parents: 5
diff changeset
    38
network support </b> </p> <p>Clients can verify if the current network supports
578be2adaf3e Week 32 contribution of PDK documentation content. See release notes for details. Fixes bug Bug 3582
Dominic Pinkman <dominic.pinkman@nokia.com>
parents: 5
diff changeset
    39
HSUPA by calling <xref href="GUID-AA81AFA4-6FAC-3B0D-A082-BE0AEC58CCA8.dita#GUID-AA81AFA4-6FAC-3B0D-A082-BE0AEC58CCA8/GUID-8A2F43F8-4C7C-35C8-8629-11516750EFFA"><apiname>RMobilePhone::GetCurrentNetwork()</apiname></xref>. The
578be2adaf3e Week 32 contribution of PDK documentation content. See release notes for details. Fixes bug Bug 3582
Dominic Pinkman <dominic.pinkman@nokia.com>
parents: 5
diff changeset
    40
network support details are returned in a <xref href="GUID-B4B45692-9810-3AFF-829B-117EDEE28D75.dita"><apiname>TMobilePhoneNetworkInfoV8</apiname></xref> object.
578be2adaf3e Week 32 contribution of PDK documentation content. See release notes for details. Fixes bug Bug 3582
Dominic Pinkman <dominic.pinkman@nokia.com>
parents: 5
diff changeset
    41
Clients can be notified of the changes to the current network by <xref href="GUID-AA81AFA4-6FAC-3B0D-A082-BE0AEC58CCA8.dita#GUID-AA81AFA4-6FAC-3B0D-A082-BE0AEC58CCA8/GUID-EB048AFA-2794-3F68-B9D8-31E4FBA961BA"><apiname>RMobilePhone::NotifyCurrentNetworkChange()</apiname></xref>.
578be2adaf3e Week 32 contribution of PDK documentation content. See release notes for details. Fixes bug Bug 3582
Dominic Pinkman <dominic.pinkman@nokia.com>
parents: 5
diff changeset
    42
The change details are returned in a <xref href="GUID-B4B45692-9810-3AFF-829B-117EDEE28D75.dita"><apiname>TMobilePhoneNetworkInfoV8</apiname></xref> object. </p> <p><b>HSUPA
578be2adaf3e Week 32 contribution of PDK documentation content. See release notes for details. Fixes bug Bug 3582
Dominic Pinkman <dominic.pinkman@nokia.com>
parents: 5
diff changeset
    43
support by detected networks </b> </p> <p>Clients can verify if HSUPA is supported
578be2adaf3e Week 32 contribution of PDK documentation content. See release notes for details. Fixes bug Bug 3582
Dominic Pinkman <dominic.pinkman@nokia.com>
parents: 5
diff changeset
    44
by other detected networks by calling <xref href="GUID-D2533ED5-4659-3CC5-954E-9F5F34DF12C4.dita#GUID-D2533ED5-4659-3CC5-954E-9F5F34DF12C4/GUID-E86961F7-5193-3EDB-A1FE-2200244F8EE4"><apiname>CRetrieveMobilePhoneDetectedNetworks::StartV8()</apiname></xref>.
578be2adaf3e Week 32 contribution of PDK documentation content. See release notes for details. Fixes bug Bug 3582
Dominic Pinkman <dominic.pinkman@nokia.com>
parents: 5
diff changeset
    45
This is a two-phase retrieval process. After calling the <xref href="GUID-D2533ED5-4659-3CC5-954E-9F5F34DF12C4.dita#GUID-D2533ED5-4659-3CC5-954E-9F5F34DF12C4/GUID-E86961F7-5193-3EDB-A1FE-2200244F8EE4"><apiname>CRetrieveMobilePhoneDetectedNetworks::StartV8()</apiname></xref>,
578be2adaf3e Week 32 contribution of PDK documentation content. See release notes for details. Fixes bug Bug 3582
Dominic Pinkman <dominic.pinkman@nokia.com>
parents: 5
diff changeset
    46
clients should call <xref href="GUID-1862DE39-6183-361E-AA61-7B1586EF0B1F.dita"><apiname>CMobilePhoneNetworkListV8</apiname></xref> * <xref href="GUID-D2533ED5-4659-3CC5-954E-9F5F34DF12C4.dita#GUID-D2533ED5-4659-3CC5-954E-9F5F34DF12C4/GUID-BC55210E-B636-3CDA-8A19-2FC79E5E1F26"><apiname>CRetrieveMobilePhoneDetectedNetworks::RetrieveListV8L()</apiname></xref>.
578be2adaf3e Week 32 contribution of PDK documentation content. See release notes for details. Fixes bug Bug 3582
Dominic Pinkman <dominic.pinkman@nokia.com>
parents: 5
diff changeset
    47
The network capabilities are returned in a <xref href="GUID-60B8BD21-A9FE-3DB1-ABEC-78AA8F9594F3.dita"><apiname>TMobilePhoneNetworkInfo</apiname></xref> object. </p> <p><b>Querying
578be2adaf3e Week 32 contribution of PDK documentation content. See release notes for details. Fixes bug Bug 3582
Dominic Pinkman <dominic.pinkman@nokia.com>
parents: 5
diff changeset
    48
the HSUPA connection state</b> </p> <p>When clients have verified HSUPA support
578be2adaf3e Week 32 contribution of PDK documentation content. See release notes for details. Fixes bug Bug 3582
Dominic Pinkman <dominic.pinkman@nokia.com>
parents: 5
diff changeset
    49
by the phone, they can query the state of a HSUPA connection by calling <xref href="GUID-C20F4764-4DE4-336D-9785-3A232C9A2CC0.dita#GUID-C20F4764-4DE4-336D-9785-3A232C9A2CC0/GUID-6E1B6088-3196-31DC-B1CD-11813FE6F68C"><apiname>RPacketService::GetDynamicCaps()</apiname></xref>. </p> </section>
578be2adaf3e Week 32 contribution of PDK documentation content. See release notes for details. Fixes bug Bug 3582
Dominic Pinkman <dominic.pinkman@nokia.com>
parents: 5
diff changeset
    50
</conbody><related-links>
578be2adaf3e Week 32 contribution of PDK documentation content. See release notes for details. Fixes bug Bug 3582
Dominic Pinkman <dominic.pinkman@nokia.com>
parents: 5
diff changeset
    51
<link href="GUID-BBF6E33F-2E9C-5BB1-8404-87289EC73BFF.dita"><linktext>Multimode
578be2adaf3e Week 32 contribution of PDK documentation content. See release notes for details. Fixes bug Bug 3582
Dominic Pinkman <dominic.pinkman@nokia.com>
parents: 5
diff changeset
    52
Telephony</linktext></link>
578be2adaf3e Week 32 contribution of PDK documentation content. See release notes for details. Fixes bug Bug 3582
Dominic Pinkman <dominic.pinkman@nokia.com>
parents: 5
diff changeset
    53
<link href="GUID-8F565241-149E-5AF7-972E-A06B6DDC1B9F.dita"><linktext>Packet Data
578be2adaf3e Week 32 contribution of PDK documentation content. See release notes for details. Fixes bug Bug 3582
Dominic Pinkman <dominic.pinkman@nokia.com>
parents: 5
diff changeset
    54
Telephony</linktext></link>
1
25a17d01db0c Addition of the PDK content and example code for Documentation_content according to Feature bug 1607 and bug 1608
Dominic Pinkman <Dominic.Pinkman@Nokia.com>
parents:
diff changeset
    55
</related-links></concept>