Symbian3/PDK/Source/GUID-789214C3-FAE2-5588-A662-7F0DE17F84F9.dita
author Dominic Pinkman <Dominic.Pinkman@Nokia.com>
Fri, 22 Jan 2010 18:26:19 +0000
changeset 1 25a17d01db0c
child 3 46218c8b8afa
permissions -rw-r--r--
Addition of the PDK content and example code for Documentation_content according to Feature bug 1607 and bug 1608
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
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
     1
<?xml version="1.0" encoding="utf-8"?>
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
     2
<!-- Copyright (c) 2007-2010 Nokia Corporation and/or its subsidiary(-ies) All rights reserved. -->
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
     3
<!-- This component and the accompanying materials are made available under the terms of the License 
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
     4
"Eclipse Public License v1.0" which accompanies this distribution, 
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
     5
and is available at the URL "http://www.eclipse.org/legal/epl-v10.html". -->
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
     6
<!-- Initial Contributors:
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
     7
    Nokia Corporation - initial contribution.
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
     8
Contributors: 
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
     9
-->
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
    10
<!DOCTYPE concept
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
    11
  PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd">
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
    12
<concept id="GUID-789214C3-FAE2-5588-A662-7F0DE17F84F9" xml:lang="en"><title>High
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
    13
Speed Uplink Packet Access (HSUPA) </title><shortdesc>Explains the HSUPA functionality supported by Symbian platform.</shortdesc><prolog><metadata><keywords/></metadata></prolog><conbody>
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
    14
<section id="GUID-0FFFAB4D-AEE9-4DC8-89AF-45D3EB39926E"><title>Introduction</title> <p> The HSUPA functionality is supported
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
    15
by extending the <xref href="GUID-BBF6E33F-2E9C-5BB1-8404-87289EC73BFF.dita">multimode
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
    16
telephony</xref> API and the <xref href="GUID-8F565241-149E-5AF7-972E-A06B6DDC1B9F.dita">packet
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
    17
data telephony</xref> API. HSUPA is defined in 3GPP R6 specifications. </p> <p>HSUPA
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
    18
provides users with a high speed uplink, which allows network operators to
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
    19
provide more interactive value-added data services. HSUPA improves data throughput
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
    20
and reduces delays by using technologies such as adaptive modulation and hybrid
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
    21
ARQ. The main advantages of using HSUPA is that it does not require any hardware
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
    22
modifications to existing network and phones that already supports 3G. </p> <p>Developers
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
    23
who wish to use HSUPA functionality should include <filepath>etelmm.dll</filepath><i/> and <filepath>etelpckt.dll</filepath> in
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
    24
their MMP files. </p> </section>
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
    25
<section id="GUID-161DEBEA-BEA3-453F-A3E1-FA7A68A22F3D"><title>HSUPA support by the phone</title> <p>The following steps
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
    26
enables the client applications to find out if the phone supports HSUPA or
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
    27
not: </p> <ol id="GUID-16130593-BA39-5175-A704-3A69EA368D96">
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
    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>
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
    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>
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
    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
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
    31
find out if HSUPA is supported by the phone </p> </li>
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
    32
<li id="GUID-56A3DD52-1CFA-560F-A321-3E7F94C1333B"><p>The function returns
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
    33
with information regarding the support for 3G network service, HSUPA and HSDPA </p> </li>
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
    34
</ol> </section>
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
    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
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
    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>.
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
    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
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
    38
network support </b> </p> <p>Clients can verify if the current network supports
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
    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
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
    40
network support details are returned in a <xref href="GUID-B4B45692-9810-3AFF-829B-117EDEE28D75.dita"><apiname>TMobilePhoneNetworkInfoV8</apiname></xref> object.
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
    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>.
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
    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
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
    43
support by detected networks </b> </p> <p>Clients can verify if HSUPA is supported
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
    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>.
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
    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>,
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
    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>.
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
    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
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
    48
the HSUPA connection state</b> </p> <p>When clients have verified HSUPA support
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
    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>
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
    50
</conbody><related-links>
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
    51
<link href="GUID-BBF6E33F-2E9C-5BB1-8404-87289EC73BFF.dita"><linktext>Multimode
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
    52
Telephony</linktext></link>
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
    53
<link href="GUID-8F565241-149E-5AF7-972E-A06B6DDC1B9F.dita"><linktext>Packet Data
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
    54
Telephony</linktext></link>
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>