<?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-DEB6E162-B2AA-5DF6-B750-E833C7DE4902" xml:lang="en"><title>PAN
Profile Overview</title><shortdesc>The Bluetooth PAN Profile API supports standard IP-based network
services deployed over the Bluetooth transport layer. </shortdesc><prolog><metadata><keywords/></metadata></prolog><conbody>
<section id="GUID-0066861F-2219-55ED-8BCA-9E7FDB7B3B68"><title>Purpose</title> <p>The
Personal Area Network (PAN) profile is designed to make a Bluetooth network
simulate an ethernet, from an application's perspective. Symbian platform
supports only one active PAN at a time. Each remote device that connects to
the PAN device for networking purposes will be merged into the same active
PAN. </p> <p>Symbian platform provides support for a PAN agent to assume the
role of PANU (User), PAN-GN (Group ad hoc Network) or PAN-NAP (Network Access
Point). </p> <p>The Symbian PAN implementation is integrated into the Symbian
networking framework enabling IP applications to run on a Bluetooth network. </p> </section>
<section id="GUID-802A6EBB-F92C-4333-858C-2AFBEC1952E3"><title>Required background</title> <p>You need to be familiar with
the <xref href="http://www.bluetooth.com/NR/rdonlyres/279DC460-295E-42ED-8952-61B723620884/984/PAN_SPEC_V10.pdf" scope="external">PAN Profile specification</xref>. </p> </section>
<section id="GUID-55A48DCA-3D08-58F7-8243-BD7D9FC03987"><title>Key concepts
and terms</title> <dl>
<dlentry>
<dt>Personal Area Network (PAN)</dt>
<dd><p>A PAN is an ad-hoc network of devices communicating on a standard network
configuration, over a Bluetooth radio connection. A PAN may have anywhere
from 2 to 8 participating member devices. </p> <p>A PAN is not the same as
a piconet. Where a piconet is any ad-hoc networking of devices over a Bluetooth
connection for the purposes of sharing data or services, like when you pair
your phone to your Bluetooth hands-free kit, a PAN deals specifically with
networking resources. </p> </dd>
</dlentry>
<dlentry>
<dt>PAN Profile</dt>
<dd><p>The Bluetooth specification identifies several profiles including the
Bluetooth Personal Area Networking (PAN) profile. The PAN profile simplifies
the now deprecated Bluetooth LAN Access and Dial-up Networking profiles by
reducing the number of layers in a network Bluetooth connection. </p> <p>The
PAN profile identifies certain configuration and setup details of a participant
of the network, including the PAN host. If a device wants to join a PAN it
must support and be able to be configured according to the requirements of
the profile in use. For more general information about Bluetooth profiles
see <xref href="GUID-EA8038F6-8727-5ABE-805C-9FF095293EB7.dita#GUID-EA8038F6-8727-5ABE-805C-9FF095293EB7/GUID-D7338D15-E269-54A5-B4E1-D5F0AACA9F32">Introduction
to Bluetooth Profiles</xref>. </p> </dd>
</dlentry>
<dlentry>
<dt>PAN profile roles</dt>
<dd><p>Typical PAN profile roles include the following: </p> <ul>
<li id="GUID-DA4229AD-A8CA-57A8-99D6-4123B2D37668"><p>PANU </p> </li>
<li id="GUID-0E79426A-FA34-512D-BF93-6007D423FD04"><p>PAN-GN </p> </li>
<li id="GUID-E616B1D1-666D-5B34-8DF6-3534BBF63E02"><p>PAN-NAP </p> </li>
</ul> <p>PANU (User) acts as a client member of a PAN-GN (Group ad hoc Network)
or a PAN-NAP (Network Access Point). Any device in either the PAN-GN or the
PAN-NAP role acts as a server. </p> </dd>
</dlentry>
</dl> </section>
<section id="GUID-A0BFEBD0-C828-56E2-94FA-FE0C0AF3EB84"><title>PAN Roles</title> <p>The
PAN Profile roles are described below: </p> <p><b>PANU </b> </p> <p>A
Bluetooth enabled device seeking entry into a network or participating in
a peer-to-peer (one on one) connection assumes the PANU role, thus becoming
a client member of the piconet. </p> <fig id="GUID-985136FB-9E35-5DD4-99A6-AE7D8FDDF21C">
<title>                 PANU to PANU connection               </title>
<image href="GUID-C193535D-8756-5A2C-BD3A-280F7DDAF73E_d0e396840_href.jpg" placement="inline"/>
</fig> <p><b>PAN-GN</b> </p> <p>A
PAN-GN device assumes the role of a forwarding node or host and the attached
PANU devices act as clients, networking up to a maximum of seven PANUs. The
wireless network is formed without the need of additional hardware like a
hub or router as in the case of a conventional cabled network. </p> <p>Group
Ad-hoc Network (GN) is a temporary, ad hoc network of devices in proximity
for sharing information and services. It is called ad hoc because of its on-the-fly
or transient nature and can include up to eight (including the host) available
Bluetooth-enabled devices in the immediate vicinity, that are willing to participate. </p> <p>The
device that initiates the network - in this case the PAN-GN - becomes the
host or controller. Correspondence in a PAN between the clients is routed
through the PAN-GN device (host) in both one-to-one and one-to-many cases. </p> <p><b>PAN-NAP</b> </p> <p>A PAN-NAP device plays the role of a proxy, bridge,
or a router between an existing network say a LAN or the Internet and Bluetooth-enabled
devices. The PAN-NAP device takes up to seven active wireless clients. The
NAP device acts as a bridge between PANU devices or bluetooth networks and
other networks for routing ethernet packets. The Symbian platform PAN-NAP
role allows only a single PANU client access to the uplink for the external
network. </p> <fig id="GUID-6EC523C3-FD92-530E-A8F4-F19AB82419A0">
<title>                 PAN-NAP, bridging networks               </title>
<image href="GUID-8D51B706-6941-5043-B435-1CAFBAE5A8F2_d0e396870_href.jpg" placement="inline"/>
</fig> <p>The following image shows a Bluetooth-enabled laptop accessing the
Internet through a mobile handset that is acting as a PAN-NAP device. The
Bluetooth handset may provide the uplink via GPRS, WIFI, dial-up, or in some
other way. </p> <p>For more information about please see the <xref href="GUID-0DBB2379-6FCB-5D1D-AE5A-2DC7C498F479.dita">PAN
NAP Role Guide</xref>. </p> </section>
<section id="GUID-238F0831-514C-50DA-92D9-E2009580DA40"><title>Architecture</title> <p>The
PAN Profile specification fits in between the application and the hardware
abstraction layers. It is connected to and accessed through the Comms-Infras
socket by the application. </p> <p>Initially, the connection preferences are
set in CommDB through the code. The Bluetooth stack is then initialized. An <xref href="GUID-BED8A733-2ED7-31AD-A911-C1F4707C67FD.dita"><apiname>RConnection</apiname></xref> and <xref href="GUID-EF29C1D7-B1E5-370F-AE37-66231A6BE449.dita"><apiname>RSocketServ</apiname></xref> instance
are created as part of initiating an ESock session and the <xref href="GUID-BED8A733-2ED7-31AD-A911-C1F4707C67FD.dita"><apiname>RConnection</apiname></xref> object
opens the connection through the <codeph>RSocketServ</codeph> instance. <xref href="GUID-BED8A733-2ED7-31AD-A911-C1F4707C67FD.dita#GUID-BED8A733-2ED7-31AD-A911-C1F4707C67FD/GUID-28A35F19-1B05-3922-8E80-36F00DF3DB65"><apiname>RConnection::Control()</apiname></xref> allows
configuration of certain aspects of the PAN, for instance adding and deleting
devices to/from the PAN. </p> <p>Intact ethernet payloads are transported
with the BNEP (Bluetooth Network Encapsulation Protocol) underneath. The PAN
profile interacts with the Bluetooth BB (baseband) and conveys the various
roles that PAN network nodes would play. </p> </section>
<section id="GUID-4640FF39-2C8A-4241-B8EA-BF68CC7F1ABF"><title>Typical uses</title> <p>The following tutorials have been
provided to help give licensee developers guidance when writing applications
that make use of the PAN profile. </p> <ul>
<li id="GUID-747AB1CA-FD49-5451-86A3-49317DCDF951"><p> <xref href="GUID-91C4F00B-E241-57DC-8520-8C16A302C983.dita">Creating
a Personal Area Network</xref>  </p> </li>
<li id="GUID-25FA6A6C-1C7B-5BD9-AB67-E8DBFF438AA1"><p> <xref href="GUID-685AD682-10DC-553B-9C3A-04D0376138C4.dita">Adding
a device to the PAN</xref>  </p> </li>
<li id="GUID-2C74ECA0-469C-5701-AE89-D3BD9DA28957"><p> <xref href="GUID-197648C4-A42C-5769-82B7-F8BA510631D9.dita">Removing
a device from the PAN</xref>  </p> </li>
<li id="GUID-5E2ACA5F-84AD-5750-A550-E834E221C60E"><p> <xref href="GUID-50CDF6E0-C352-5771-8686-B551267C6BE6.dita">Closing
the PAN</xref>  </p> </li>
</ul> </section>
</conbody></concept>