<?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-F0C47F37-354B-51BD-B607-D4575C249DC8" xml:lang="en"><title>DVB-H
Receiver Library Overview</title><prolog><metadata><keywords/></metadata></prolog><conbody>
<p>This document introduces you to the DVB-H Receiver library. </p>
<section><title>Purpose</title> <p>The DVB-H Receiver library provides you
space to access hardware control for broadcasting TV service. This library
gives some services like signal scanning, signal strength monitoring, IP platform
selection, IP filter creation to mobile TV middleware. </p> </section>
<section><title>DVB-H Receiver Library Library Details</title><p>In order
to use this library, you must obtain necessary binaries in the form of DLL
file to implement <xref href="GUID-617CD367-CF68-3932-8E77-669820A7B9AF.dita"><apiname>RDvbhReceiver</apiname></xref> class. The DLL file must
be available to the build system if dvbhreceiver.h or dvbhreceiver.lib are
to be referenced in any source code. </p> <table id="GUID-43069104-FF3E-513F-A70C-65B94902DC00">
<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> <b>You must create your own *.dll file, we do not supply one. </b>  </p> </entry>
<entry><p> <filepath>dvbhreceiver.lib</filepath>  </p> </entry>
<entry><p>These files are used for implementing <xref href="GUID-617CD367-CF68-3932-8E77-669820A7B9AF.dita"><apiname>RDvbhReceiver</apiname></xref> class. </p> </entry>
</row>
</tbody>
</tgroup>
</table></section>
<section><title>Architectural Relationship</title> <p>This library is part
of the Mobile TV DVB-H Receiver HAI component. </p> </section>
<section><title>Description</title> <p>The DVB-H Receiver library is the main
library for interacting with hardware. It performs function such as: </p> <ul>
<li id="GUID-1D4A1942-4581-579F-B773-2F0D9E75F2F4"><p>Opening sessions to
the DVB-H Hardware Adaptation Layer (HAL) </p> </li>
<li id="GUID-C6BFB233-A72E-58BC-AC79-B7118B5093E6"><p>Scanning for DVB-H signals </p> </li>
<li id="GUID-2D33B235-192E-574E-848C-250BF2016F38"><p>Setting IP platforms </p> </li>
<li id="GUID-5386FD76-07C3-5ED9-B25E-884F52D42D94"><p>Creating IP filters
in order to filter out certain IP streams from a DVB-H broadcast </p> </li>
<li id="GUID-D750A108-F880-53A9-B9F3-556BBD58FEB3"><p>Receiving filtered IP
streams </p> </li>
<li id="GUID-DDF0E17F-8937-5135-AC2B-0E60208FC8D1"><p>Requesting the network
time. </p> </li>
</ul> </section>
<section><title>Key DVB-H Receiver Llibrary Classes</title> <p>The key class
is: </p> <ul>
<li id="GUID-5D07536C-3AC9-57C7-9491-DC5F2F90BFAA"><p> <xref href="GUID-617CD367-CF68-3932-8E77-669820A7B9AF.dita"><apiname>RDvbhReceiver</apiname></xref>  </p> <p>It
provides an interface to DVB-H reception hardware. It grants a hardware control
and data reception interface for you to operate the receiver hardware. </p> </li>
</ul> <p>The enhanced functionality of <xref href="GUID-617CD367-CF68-3932-8E77-669820A7B9AF.dita"><apiname>RDvbhReceiver</apiname></xref> llibrary
is provided by a number of additional utilty classes that are accessed through
it, such as: </p> <ul>
<li id="GUID-F30B5BB4-9E2E-5174-BA05-212F16E8AE20"><p> <xref href="GUID-A02A8090-2D79-3BDC-9B97-91CEA6472C60.dita"><apiname>MDvbhDataObserver</apiname></xref>  </p> <p>Provides
notification of received IP data packets. </p> </li>
<li id="GUID-3114D3AB-22FA-52FC-A097-427C639BE066"><p> <xref href="GUID-7A97A0BE-1EDA-380F-B5BB-630E3E0614C4.dita"><apiname>MDvbhScanObserver</apiname></xref>  </p> <p>Provides
notification of scan operations. </p> </li>
</ul> <p>The Class diagram of <xref href="GUID-617CD367-CF68-3932-8E77-669820A7B9AF.dita"><apiname>RDvbhReceiver</apiname></xref> is shown below: </p> <fig id="GUID-5124410C-180C-5DF5-BB13-DECD361AF1F5">
<image href="GUID-6E5625BF-88E0-579A-B2CA-32F3EBDD83CB_d0e533170_href.png" placement="inline"/>
</fig> <p> </p> </section>
<section><title>Using DVB-H Receiver Library</title> <ul>
<li id="GUID-A899FDD6-B1FD-5B9F-A1C7-C67DED8249AA"><p>A receiver hardware
session is opened by <xref href="GUID-617CD367-CF68-3932-8E77-669820A7B9AF.dita#GUID-617CD367-CF68-3932-8E77-669820A7B9AF/GUID-44B80593-8400-3084-AC33-B8E4F00DFE8F"><apiname>RDvbhReceiver::Open()</apiname></xref>  </p> </li>
<li id="GUID-14B9BD98-4BB1-5162-893D-9B49E4753444"><p>The receiver hardware
is powered on by <xref href="GUID-617CD367-CF68-3932-8E77-669820A7B9AF.dita#GUID-617CD367-CF68-3932-8E77-669820A7B9AF/GUID-3C48A641-C307-37D6-9931-D627363C8942"><apiname>RDvbhReceiver::PowerOn()</apiname></xref>  </p> </li>
<li id="GUID-86415409-9E44-5C9E-B566-FC9E48846A96"><p>Data reception preparation
is made by implementing <xref href="GUID-617CD367-CF68-3932-8E77-669820A7B9AF.dita#GUID-617CD367-CF68-3932-8E77-669820A7B9AF/GUID-B0D7B27B-7952-3212-90CA-67B08D52AB7B"><apiname>RDvbhReceiver::ReceiveIPData()</apiname></xref>  </p> </li>
<li id="GUID-065A28AC-53CD-5DBC-BE1C-FC035EBF4E61"><p>Signal scanning is prepared
by <xref href="GUID-617CD367-CF68-3932-8E77-669820A7B9AF.dita#GUID-617CD367-CF68-3932-8E77-669820A7B9AF/GUID-742B86CD-4F94-3290-94C5-8BA38A679503"><apiname>RDvbhReceiver::Scan()</apiname></xref>  </p> </li>
<li id="GUID-347347E7-9094-591A-A1D6-C65A937436EC"><p>IP platform is set by <xref href="GUID-617CD367-CF68-3932-8E77-669820A7B9AF.dita#GUID-617CD367-CF68-3932-8E77-669820A7B9AF/GUID-63CE38E1-247D-3363-9D34-2CF5072D063B"><apiname>RDvbhReceiver::SetPlatform()</apiname></xref>  </p> </li>
<li id="GUID-B5DEECE1-94B6-5A5F-A655-73CA37C9C736"><p>IP filter is created
by <xref href="GUID-617CD367-CF68-3932-8E77-669820A7B9AF.dita#GUID-617CD367-CF68-3932-8E77-669820A7B9AF/GUID-8C4EBEA3-59A7-3738-98CC-FE40D3DAEF91"><apiname>RDvbhReceiver::CreateFilter()</apiname></xref>. </p> </li>
<li id="GUID-B88939D4-4341-5DFC-A0DC-7BAFEA7859D0"><p>Network time is updated
by <xref href="GUID-617CD367-CF68-3932-8E77-669820A7B9AF.dita#GUID-617CD367-CF68-3932-8E77-669820A7B9AF/GUID-F2B7A84B-C7A8-3F65-A464-08B0FE50C433"><apiname>RDvbhReceiver::UpdateNetworkTime()</apiname></xref>  </p> </li>
<li id="GUID-2C825DF5-8346-5348-A950-907C258B2E5D"><p>The receiver hardware
is powered down by<xref href="GUID-617CD367-CF68-3932-8E77-669820A7B9AF.dita#GUID-617CD367-CF68-3932-8E77-669820A7B9AF/GUID-67BCF315-6BA2-3968-8E9B-091099B839A6"><apiname>RDvbhReceiver::PowerOff()</apiname></xref>  </p> </li>
<li id="GUID-BA4AC3A0-E3D2-50F0-81A6-D1EA12693710"><p>The session of receiver
hardware is closed by <xref href="GUID-617CD367-CF68-3932-8E77-669820A7B9AF.dita#GUID-617CD367-CF68-3932-8E77-669820A7B9AF/GUID-FFE19627-4B07-3246-BCB2-957122BD1FBD"><apiname>RDvbhReceiver::Close()</apiname></xref>  </p> </li>
</ul> </section>
</conbody><related-links>
<link href="GUID-3C9BE2FF-8D5C-51D0-8BC1-BED7BC1288BA.dita"><linktext>Turn On Broadcast
Receiver Tutorial</linktext></link>
<link href="GUID-2C8BE998-BCCE-5A06-AFC1-4B611D9233AB.dita"><linktext>Turn Off
Broadcast Receiver Tutorial</linktext></link>
<link href="GUID-0297CAF5-4EB7-5E84-8A8C-8758D6F3B75F.dita"><linktext>Setting Data
Reception Tutorial</linktext></link>
<link href="GUID-567585CC-26EC-553D-99D5-D3C178C455F6.dita"><linktext>DVB-H Signal
Scanning Tutorial</linktext></link>
<link href="GUID-743D3117-095B-58D5-947D-A8713475C9A5.dita"><linktext>Tuning IP
Platform Tutorial</linktext></link>
<link href="GUID-F5FE22F3-B7C4-50B3-9B36-5CB8BC1BA18A.dita"><linktext>Receiving
Broadcast Data Tutorial</linktext></link>
</related-links></concept>