<?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-AB0A3E87-6725-5E83-B462-1219CE205187" xml:lang="en"><title>Bluetooth
Notifiers Support Overview</title><shortdesc>The Bluetooth Notifiers Support component enables you to create
dialogs to interact with device users about Bluetooth interactions. </shortdesc><prolog><metadata><keywords/></metadata></prolog><conbody>
<section id="GUID-54214036-18F9-4CBD-8BFE-47949757F7B7"><title>Purpose</title> <p>The Bluetooth Notifiers component enables
you to create dialogs for interacting with device users about Bluetooth interactions.
You can offer Bluetooth dialogs for several purposes, but the main purpose
is to provide security for Bluetooth interactions. </p> </section>
<section id="GUID-098A9B42-C063-401E-AEAC-1EF8138577F7"><title>Required background</title> <p>You need to be familiar with
the core Bluetooth concepts. </p> </section>
<section id="GUID-4DBBEDCA-748B-4510-A30A-7D0E41E91978"><title>Key concepts and terms</title> <dl>
<dlentry>
<dt>Pairing</dt>
<dd><p>Pairing takes place when two devices establish a trusted relationship
with each other for secure communication. </p> </dd>
</dlentry>
<dlentry>
<dt>Passkey</dt>
<dd><p>A passkey is a piece of data known only to the two parties involved
in the communication. It is also known as a shared secret. In the Symbian
Bluetooth context, a Passkey Display notifier is a dialog that uses a 6-digit
number, which is generated by Symbian platform and then manually entered on
a peer device. </p> </dd>
</dlentry>
<dlentry>
<dt>Secure Simple Pairing (SSP)</dt>
<dd><p>Secure Simple Pairing is pairing that takes place with an automatically
generated PIN. The user does not create a PIN. </p> </dd>
</dlentry>
</dl> </section>
<section id="GUID-29FB501A-81B5-403C-98E7-734E8E94C5DE"><title>Architecture</title> </section>
<section id="GUID-1B3F6608-274E-44E8-B325-64CDA1F6C3E9"><title>APIs</title> <p>The key classes of Symbian's implementation
of Bluetooth Notifiers are as follows: </p> <table id="GUID-8DD9C644-EE92-5CA6-B9E0-97833F4675EA">
<tgroup cols="2"><colspec colname="col0"/><colspec colname="col1"/>
<thead>
<row>
<entry>API</entry>
<entry>Description</entry>
</row>
</thead>
<tbody>
<row>
<entry><p> <xref href="GUID-848C1394-A007-3B4A-84FF-C790EC2FECAD.dita"><apiname>CPinCodeEntryNotifier</apiname></xref>  </p> </entry>
<entry><p>The class to provide a PIN-code entry notifier. </p> </entry>
</row>
<row>
<entry><p> <xref href="GUID-1D32697F-4A33-3B9B-9A53-B3ADCA8A215A.dita"><apiname>CNumericComparisonNotifier</apiname></xref>  </p> </entry>
<entry><p>The class to provide a numeric comparison notifier. </p> </entry>
</row>
<row>
<entry><p> <xref href="GUID-CA141385-E969-359A-9706-42451962CE0F.dita"><apiname>CPasskeyNotifier</apiname></xref>  </p> </entry>
<entry><p>The class to provide a passkey display notifier. </p> </entry>
</row>
<row>
<entry><p> <xref href="GUID-986EFB63-1F05-35AF-87DB-3FED6B8E4588.dita"><apiname>CPasskeyDisplayNotifier</apiname></xref>  </p> </entry>
<entry><p>The class to provide a passkey display notifier. The passkey entry
display notifier can currently receive two types of updates: </p> <ul>
<li id="GUID-5A532F95-97D6-5687-96F9-A583CF5C0EA7"><p>Updates to the remote
device name (the same as the other notifiers). </p> <p>Updates to provide
the notification of a key press by the remote keyboard. </p> </li>
</ul> <p>As a Symbian platform device will be the display part of the pairing
method, the remote device will be keyboard only and so not feature a display.
It is highly recommended that the key press notifications provide a visual
representation of keys being registered to help the device user. </p> </entry>
</row>
</tbody>
</tgroup>
</table> </section>
<section id="GUID-E34A48B1-3A23-4B0E-A151-45784C5592E8"><title>Text notifiers library details</title> <p>The Bluetooth Notifiers
component has one published library. The DLL that provides the functionality
and the library to which your code must link is identified below. </p> <table id="GUID-C6EC280C-A748-55CE-8C82-34289E9F0B99">
<tgroup cols="3"><colspec colname="col0"/><colspec colname="col1"/><colspec colname="col2"/>
<thead>
<row>
<entry>DLL</entry>
<entry>LIB</entry>
<entry>Short description</entry>
</row>
</thead>
<tbody>
<row>
<entry><p> <filepath>textnotifiers.dll </filepath>  </p> </entry>
<entry><p> <filepath>textnotifiers.lib</filepath>  </p> </entry>
<entry><p>Basic types used to allow interactions with standard Bluetooth notifiers. </p> </entry>
</row>
</tbody>
</tgroup>
</table> </section>
<section id="GUID-47B2A688-40B4-4441-B1D1-E55F75531E85"><title>Typical uses</title> <p>The key purpose of Bluetooth Notifiers
is to create dialogs to enable secure pairing. The Bluetooth Notifier provides
the following types of authentication dialog to enable secure pairing: </p> <ul>
<li id="GUID-E2DE8A0B-33A7-5863-BE2C-28C0C2AA44AE"><p> <b>Authorisation dialog</b>  </p> <p>Authorisation
dialogs offer device users the choice to accept or reject connections. </p> </li>
<li id="GUID-B1940F8D-12E5-50E7-9109-2CAB7758B774"><p> <b>PIN-code entry notifier</b>  </p> <p>A
user creates a PIN and sends it to the peer. </p> </li>
<li id="GUID-07996989-0294-5CDD-8018-3450415F30D4"><p> <b>Numeric comparison
notifier</b>  </p> <p>Numeric Comparison involves the user comparing 6-digit
numbers displayed on both devices that are authenticating. Authentication
is completed by the users of both devices signalling a confirmation that the
displayed numbers are identical – if one device is unable to input a confirmation
then only the other device needs to signal confirmation </p> </li>
<li id="GUID-0BC7AA7C-7539-510D-8D0B-179A69D43200"><p> <b>Passkey display
notifier </b>  </p> <p>Authentication by Passkey Entry involves the Symbian
platform device displaying a 6-digit number which is manually entered on a
device without a display (but with a numeric keypad). This is similar to PIN
Code Entry except in this case the number is chosen for the user, and it need
only be entered on the peer device. </p> </li>
</ul> <p>In addition to the authentication notifiers, it is possible to use
Bluetooth Notifiers for device selection dialogs. Device selection dialogs
are for use by applications and profiles to decide which device the user wishes
to connect to. Device selection dialogs do not need to be Bluetooth notifiers.
Whereas the authentication notifiers are not associated with an application,
device selection notifiers are. Therefore it is best to get the relevant application,
for example a camera, to create the dialog. </p> </section>
</conbody></concept>